spress / spress-import
A plugin for importing from various blog platform to Spress
Installs: 64
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 3
Forks: 0
Type:spress-plugin
Requires
- php: >=5.5
- league/csv: ^8.0
- spress/spress-installer: 2.0.*
- symfony/filesystem: 2.7.*
- symfony/yaml: 2.7.*
This package is auto-updated.
Last update: 2024-10-13 04:31:22 UTC
README
This plugin let you import posts and pages from others platforms to a Spress site.
Platforms supported
Requirements
How to install?
- Go to
your-spress-site/
folder. - Run
composer require spress/spress-import
. - When you run
spress
command, import commands will be displayed underimport
namespace.
How to use?
See the concrete provider.
Source permalinks
Import plugin tries to preserve the source permalink of each item. To reach that
goal, this plugin adds the attributes: permalink
and no_html_extension
.
e.g: for an item with the following permalink at source: http://acme.com/what-is-new-this-time
the front matter block generated will be:
--- permalink: '/what-is-new-this-time' no_html_extension: true ---
CSV files
This command imports posts from a CSV file.
The sign of import:csv
command is the following:
import:csv [--dry-run] [--post-layout POST-LAYOUT] [--not-replace-urls] [--not-header] [--delimiter-character DELIMITER-CHARACTER] [--enclosure-character ENCLOSURE-CHARACTER] [--terms_delimiter_character TERMS-DELIMITER-CHARACTER] [--] <file>
Example of use:
$ spress import:csv /path-to/post.csv --post-layout=post
Options
--dry-run
: This option displays the items imported without actually modifying your site.--post-layout
: Layout applied to posts. e.g:--post-layout=post
.--not-replace-urls
: Avoids to replace URLs in posts by local Spress URLs.--not-header
: First row won't be treated as header.--delimiter-character
: Sets the delimiter character. character,
by default.--enclosure-character
: Sets the enclousure character. character"
by default.--terms_delimiter_character
: Sets the delimiter character applied to terms in categories and tags columns.
CSV structure
Your CSV file will be read in with the following columns:
- title
- permalink
- content
- published_at
- categories (optional): a list of terms separated by semicolon. e.g: "news;events".
- tags (optional): a list of terms separated by semicolon.
- markup (optional) markup language used in content. e.g: "md", "html". "md" by default. This value will be used as filename's extension of the imported item.
Item attributes
List of attributes added by this provider to each item:
categories
: list of terms that represents the categories.tags
: lists of terms that represents the tags.
WXR files from Wordpress
This command imports posts from a WXR file generated by Wordpress (community and dot com).
The sign of import:wordpress
command is the following:
import:wordpress [--dry-run] [--post-layout POST-LAYOUT] [--fetch-images] [--not-replace-urls] [--assets-dir ASSETS-DIR] [--] <file>
Example of use:
$ spress import:wordpress /path-to/my-wxr-file.xml --post-layout=post
Options
--dry-run
: This option displays the items imported without actually modifying your site.--post-layout
: Layout applied to posts. e.g:--post-layout=post
.--fetch-images
: Fetch images used in the Wordpress blog.--not-replace-urls
: Avoids to replace Wordpress URLs in posts by local Spress URLs.--assets-dir
: Relative folder tosrc
directory.content/assets
by default.
Item attributes
List of attributes added by this provider to each item:
author
: The author of the post.excerpt
: The snippet of the post.categories
: list of terms that represents the categories.tags
: lists of terms that represents the tags.