To import your posts from your Blogger,
-you first have to export the blog
-to a XML file (blog-MM-DD-YYYY.xml),
-and run:
-
-
$ ruby -r rubygems -e'require "jekyll-import";
- JekyllImport::Importers::Blogger.run({
- "source" => "/path/to/blog-MM-DD-YYYY.xml",
- "no-blogger-info" => false, # not to leave blogger-URL info (id and old URL) in the front matter
- "replace-internal-link" => false, # replace internal links using the post_url liquid tag.
- })'
-
-
The only required field is source.
-The other fields default to their above values.
+
+
+
Invocation
+
+
To import your posts from Blogger, you have to first export the blog
+to an XML file (blog-MM-DD-YYYY.xml).
+
+
+
+
+
+ Sample snippet to invoke the importer:
+
jekyll import blogger --source NAME --no-blogger-info --replace-internal-link --comments
+
+
+
+
+
Option <PARAM>
Description
+
+
+
--source NAME
+
The XML file (blog-MM-DD-YYYY.xml) path to import
+
+
+
+
+
+
--no-blogger-info
+
not to leave blogger-URL info (id and old URL) in the front matter.
+
+
Default: false
+
+
+
+
--replace-internal-link
+
replace internal links using the post_url liquid tag.
+
+
Default: false
+
+
+
+
--comments
+
import comments to _comments collection.
+
+
Default: false
+
+
+
+
+
Highlighted row(s) in table above indicate required options.
Do not add the default front matter to the post body.
+
+
Default: false
+
+
+
+
+
Your CSV file will be read in with the following columns:
@@ -265,15 +290,9 @@
CSV
filter (e.g. markdown, textile)
-
If you wish to specify custom front matter for each of your posts, you
-can use the no-front-matter option to prevent the default front matter
-from being written to the imported files:
If you wish to specify custom front matter for each of your posts, you can use
+the --no-front-matter option to prevent the default front matter from being
+written to the imported files.
jekyll import drupal6 --dbname DB --user USER --engine [mysql|postgresql] --password PW --host HOST --port PORT --prefix PREFIX --types TYPE1[,TYPE2[,TYPE3...]]
+
-
The only required fields are dbname and user. password defaults to "",
-host defaults to "localhost", and prefix defaults to "".
+
+
+
Option <PARAM>
Description
+
+
+
--dbname DB
+
Database name
+
+
+
+
+
+
--user USER
+
Database user name
+
+
+
+
+
+
--engine [mysql|postgresql]
+
Database engine
+
+
Default: "mysql"
+
+
+
+
--password PW
+
Database user’s password
+
+
Default: ""
+
+
+
+
--host HOST
+
Database host name
+
+
Default: "localhost"
+
+
+
+
--port PORT
+
Database port name
+
+
Default: "3306"
+
+
+
+
--prefix PREFIX
+
Table prefix name
+
+
Default: ""
+
+
+
+
--types TYPE1[,TYPE2[,TYPE3...]]
+
The Drupal content types to be imported
+
+
Default: blog,story,article
+
+
+
+
+
Highlighted row(s) in table above indicate required options.
+
+
By default, this will pull in nodes of type blog, story, and article.
To specify custom types, you can use the types option when you run the
-importer:
jekyll import drupal7 --dbname DB --user USER --engine [mysql|postgresql] --password PW --host HOST --port PORT --prefix PREFIX --types TYPE1[,TYPE2[,TYPE3...]]
+
-
The only required fields are dbname and user. password defaults to "",
-host defaults to "localhost", and prefix defaults to "".
+
+
+
Option <PARAM>
Description
+
+
+
--dbname DB
+
Database name
+
+
+
+
+
+
--user USER
+
Database user name
+
+
+
+
+
+
--engine [mysql|postgresql]
+
Database engine
+
+
Default: "mysql"
+
+
+
+
--password PW
+
Database user’s password
+
+
Default: ""
+
+
+
+
--host HOST
+
Database host name
+
+
Default: "localhost"
+
+
+
+
--port PORT
+
Database port name
+
+
Default: "3306"
+
+
+
+
--prefix PREFIX
+
Table prefix name
+
+
Default: ""
+
+
+
+
--types TYPE1[,TYPE2[,TYPE3...]]
+
The Drupal content types to be imported
+
+
Default: blog,story,article
+
+
+
+
+
Highlighted row(s) in table above indicate required options.
+
+
By default, this will pull in nodes of type blog, story, and article.
To specify custom types, you can use the types option when you run the
-importer:
That will import nodes of type blog and post only.
-
-
The default Drupal 7 expects database to be MySQL. If you want to import posts
-from Drupal 7 installation with PostgreSQL define "engine" as "postgresql":
jekyll import drupal8 --dbname DB --user USER --engine [mysql|postgresql] --password PW --host HOST --port PORT --prefix PREFIX --types TYPE1[,TYPE2[,TYPE3...]]
+
-
The only required fields are dbname and user. password defaults to "",
-host defaults to "localhost", and prefix defaults to "".
+
+
+
Option <PARAM>
Description
+
+
+
--dbname DB
+
Database name
+
+
+
+
+
+
--user USER
+
Database user name
+
+
+
+
+
+
--engine [mysql|postgresql]
+
Database engine
+
+
Default: "mysql"
+
+
+
+
--password PW
+
Database user’s password
+
+
Default: ""
+
+
+
+
--host HOST
+
Database host name
+
+
Default: "localhost"
+
+
+
+
--port PORT
+
Database port name
+
+
Default: "3306"
+
+
+
+
--prefix PREFIX
+
Table prefix name
+
+
Default: ""
+
+
+
+
--types TYPE1[,TYPE2[,TYPE3...]]
+
The Drupal content types to be imported
+
+
Default: blog,story,article
+
+
+
+
+
Highlighted row(s) in table above indicate required options.
+
+
By default, this will pull in nodes of type blog, story, and article.
To specify custom types, you can use the types option when you run the
-importer:
That will import nodes of type blog and post only.
-
-
The default Drupal 8 expects database to be MySQL. If you want to import posts
-from Drupal 8 installation with PostgreSQL define "engine" as "postgresql":
The only required fields are dbname and user. password defaults to "",
-host defaults to "localhost"
-prefix defaults to "jos_". This will export all articles (in any state). Category and tags will be included in export.
There are no required fields. dbfile defaults to "ghost.db".
+
If you have a Ghost backup file, consider using another tool called
+jekyll_ghost_importer to
+import your content. It is a separate gem and docs can be found at the link
+provided.
-
If you have a Ghost backup file, consider using another tool called jekyll_ghost_importer to import your content. It is a separate gem and docs can be found at the link provided.
The only required fields are dbname and user. password defaults to "",
-host defaults to "localhost", portnumber defaults to 3306, section
-defaults to "1" and prefix defaults to "jos_".
The only required fields are dbname, prefix and user. password defaults to "",
-host defaults to "localhost", portnumber defaults to 3306 and prefix defaults to
-"jos_".
$ ruby -r rubygems -e'require "jekyll-import";
- JekyllImport::Importers::MT.run({
- "engine" => "mysql", # "postgres" is also supported
- "dbname" => "name",
- "user" => "myuser",
- "password" => "mypassword",
- "host" => "myhost",
- "blog_id" => nil, # Set to specific ID to import just one blog
- "categories" => true, # Set to false to not save categories to front matter
- "src_encoding" => "UTF-8",
- "dest_encoding" => "UTF-8",
- "comments" => true
+
Invocation
- })'
-
Posts will be generated and placed in _posts directory.
+
+ Sample snippet to invoke the importer:
+
jekyll import mt --dbname DB --user USER --engine ENGINE --password PW --host HOST --port PORT --blog_id ID --categories --src_encoding ENCODING --dest_encoding ENCODING --comments
+
-
The only required fields are dbname and user. password defaults to ""
-and host defaults to "localhost".
+
+
+
Option <PARAM>
Description
+
+
+
--dbname DB
+
Database name.
+
+
+
+
+
+
--user USER
+
Database user name.
+
+
+
+
+
+
--engine ENGINE
+
Database engine (‘mysql’ or ‘postgres’).
+
+
Default: 'mysql'
+
+
+
+
--password PW
+
Database user’s password.
+
+
Default: ''
+
+
+
+
--host HOST
+
Database host name.
+
+
Default: 'localhost'
+
+
+
+
--port PORT
+
Custom database port connect to.
+
+
Default: null
+
+
+
+
--blog_id ID
+
Specify a single Movable Type blog ID to import.
+
+
Default: null (all blogs)
+
+
+
+
--categories
+
When true, save post’s categories in its YAML front matter.
+
+
Default: true
+
+
+
+
--src_encoding ENCODING
+
Encoding of strings from database.
+
+
Default: UTF-8
+
+
+
+
--dest_encoding ENCODING
+
Encoding of output strings.
+
+
Default: UTF-8
+
+
+
+
--comments
+
When true, output comments in _comments directory.
+
+
Default: false
+
+
+
+
+
Highlighted row(s) in table above indicate required options.
+
+
comments, which defaults to false, control the generation of
comment. If comments set to true, posts will be generated and placed
@@ -332,6 +407,7 @@
Additional Dependencies
to include statically generate comments in your post. Fork and provide
feedback if necessary.
+
The layout field is optional, it will set the layout in each post and draft imported.
+
+ Sample snippet to invoke the importer:
+
jekyll import pluxml --source NAME --layout NAME --avoid_liquid
+
+
+
+
+
Option <PARAM>
Description
+
+
+
--source NAME
+
The PluXml data directory to import.
+
+
+
+
+
+
--layout NAME
+
The layout to apply.
+
+
Default: 'post'
+
+
+
+
--avoid_liquid
+
Will add render_with_liquid: false in front matter.
+
+
Default: false
+
+
+
+
+
Highlighted row(s) in table above indicate required options.
+
+
The avoid_liquid field is optional, it will add render_with_liquid: false option in the header of each file. Usefull if you have à lot of source code to show to your visitors.
- To use this importer, you need to install these additional gems:
- `gem install unidecode sequel mysql2 htmlentities`
+ This importer only converts your posts and creates YAML front-matter.
+ It does not import any layouts, styling, or external files (images, CSS, etc).
-
To import your posts from a self-hosted RollerBlog
-installation, run:
Only the variables “dbname”, “user” and “password” are required, the rest are optional and default to what is shown above. Currently this importer assumes a MySQL database.
-
-
This only imports post content
-
- This importer only converts your posts and creates YAML front-matter.
- It does not import any layouts, styling, or external files
- (images, CSS, etc.).
-
+
Invocation
+
+
+
+ Sample snippet to invoke the importer:
+
jekyll import roller --dbname DB --user USER --password PW --socket SOCKET --host HOST --port PORT --clean_entities --comments --categories --tags --status STATUS,STATUS2
+
+
+
+
+
Option <PARAM>
Description
+
+
+
--dbname DB
+
Database name.
+
+
+
+
+
+
--user USER
+
Database user name.
+
+
+
+
+
+
--password PW
+
Database user’s password.
+
+
+
+
+
+
--socket SOCKET
+
Database socket.
+
+
Default: null
+
+
+
+
--host HOST
+
Database host name.
+
+
Default: 'localhost'
+
+
+
+
--port PORT
+
Database port number.
+
+
Default: '3306'
+
+
+
+
--clean_entities
+
Whether to clean entities.
+
+
Default: true
+
+
+
+
--comments
+
Whether to import comments.
+
+
Default: true
+
+
+
+
--categories
+
Whether to import categories.
+
+
Default: true
+
+
+
+
--tags
+
Whether to import tags.
+
+
Default: true
+
+
+
+
--status STATUS,STATUS2
+
Array of allowed statuses (either [‘PUBLISHED’] or [‘DRAFT’]).
+
+
Default: ['PUBLISHED']
+
+
+
+
+
Highlighted row(s) in table above indicate required options.
This importer only converts your posts and creates YAML front-matter.
- It does not import any layouts, styling, or external files
- (images, CSS, etc.).
+ It does not import any layouts, styling, or external files (images, CSS, etc).
+
+
Invocation
+
+
+
+ Sample snippet to invoke the importer:
+
jekyll import s9ydatabase --dbname DB --socket SOCKET --user USER --password PW --host HOST --port PORT --table_prefix PREFIX --clean_entities --comments --categories --tags --drafts --markdown --permalinks --excerpt_separator --includeentry --imgfig --linebreak --relative
+
+
+
+
+
Option <PARAM>
Description
+
+
+
--dbname DB
+
Database name.
+
+
Default: ''
+
+
+
+
--socket SOCKET
+
Database socket.
+
+
Default: ''
+
+
+
+
--user USER
+
Database user name.
+
+
Default: ''
+
+
+
+
--password PW
+
Database user’s password.
+
+
Default: ''
+
+
+
+
--host HOST
+
Database host name.
+
+
Default: 'localhost'
+
+
+
+
--port PORT
+
Custom database port connect to.
+
+
Default: 3306
+
+
+
+
--table_prefix PREFIX
+
Table prefix name.
+
+
Default: 'serendipity_'
+
+
+
+
--clean_entities
+
Whether to clean entities.
+
+
Default: true
+
+
+
+
--comments
+
Whether to import comments.
+
+
Default: true
+
+
+
+
--categories
+
Whether to import categories.
+
+
Default: true
+
+
+
+
--tags
+
Whether to import tags.
+
+
Default: true
+
+
+
+
--drafts
+
Whether to export drafts as well.
+
+
Default: true
+
+
+
+
--markdown
+
convert into markdown format.
+
+
Default: false
+
+
+
+
--permalinks
+
preserve S9Y permalinks.
+
+
Default: false
+
+
+
+
--excerpt_separator
+
Demarkation for excerpts.
+
+
Default: ''
+
+
+
+
--includeentry
+
Replace macros from the includeentry plugin.
+
+
Default: false
+
+
+
+
--imgfig
+
Replace nested img and youtube divs with HTML figure tags.
The only required fields are dbname and user. password defaults to ""
-and host defaults to "localhost".
+
+ Sample snippet to invoke the importer:
+
jekyll import textpattern --dbname DB --user USER --password PW --host HOST
+
+
+
+
+
Option <PARAM>
Description
+
+
+
--dbname DB
+
Database name.
+
+
+
+
+
+
--user USER
+
Database user name.
+
+
+
+
+
+
--password PW
+
Database user’s password.
+
+
Default: ''
+
+
+
+
--host HOST
+
Database host name.
+
+
Default: 'localhost'
+
+
+
+
+
Highlighted row(s) in table above indicate required options.
+
+
You will need to run the above from the parent directory of your _import
folder. For example, if _import is located in /path/source/_import, you will
-need to run this code from /path/source. The hostname defaults to localhost,
-all other variables are required. You may need to adjust the code used to filter
-entries. Left alone, it will attempt to pull all entries that are live or
-sticky.
+need to run this code from /path/source. This importer will attempt to pull
+all entries that are live or sticky.
+
jekyll import tumblr --url URL --format FORMAT --grab_images --add_highlights --rewrite_urls
+
-
$ ruby -r rubygems -e'require "jekyll-import";
- JekyllImport::Importers::Tumblr.run({
- "url" => "http://myblog.tumblr.com",
- "format" => "html", # or "md"
- "grab_images" => false, # whether to download images as well.
- "add_highlights" => false, # whether to wrap code blocks (indented 4 spaces) in a Liquid "highlight" tag
- "rewrite_urls" => false # whether to write pages that redirect from the old Tumblr paths to the new Jekyll paths
- })'
+
+
+
Option <PARAM>
Description
+
+
+
--url URL
+
Tumblr URL.
+
+
+
+
+
+
--format FORMAT
+
Output format.
+
+
Default: 'html'
+
+
+
+
--grab_images
+
Whether to grab images.
+
+
Default: false
+
+
+
+
--add_highlights
+
Whether to add highlights.
+
+
Default: false
+
+
+
+
--rewrite_urls
+
Whether to rewrite URLs.
+
+
Default: false
+
+
+
+
+
Highlighted row(s) in table above indicate required options.
None of the fields are required. Their defaults are as you see above.
-
+
-
This only imports post & page data & content
This importer only converts your posts and creates YAML front-matter.
- It does not import any layouts, styling, or external files
- (images, CSS, etc.).
+ It does not import any layouts, styling, or external files (images, CSS, etc).
+
+
Invocation
+
+
+
+ Sample snippet to invoke the importer:
+
jekyll import wordpress --dbname DB --socket SOCKET --user USER --password PW --host HOST --port PORT --table_prefix PREFIX --site_prefix PREFIX --clean_entities --comments --categories --tags --more_excerpt --more_anchor --status STATUS,STATUS2
+
+
+
+
+
Option <PARAM>
Description
+
+
+
--dbname DB
+
Database name.
+
+
Default: ''
+
+
+
+
--socket SOCKET
+
Database socket.
+
+
Default: ''
+
+
+
+
--user USER
+
Database user name.
+
+
Default: ''
+
+
+
+
--password PW
+
Database user’s password.
+
+
Default: ''
+
+
+
+
--host HOST
+
Database host name.
+
+
Default: 'localhost'
+
+
+
+
--port PORT
+
Database port number.
+
+
Default: ''
+
+
+
+
--table_prefix PREFIX
+
Table prefix name.
+
+
Default: 'wp_'
+
+
+
+
--site_prefix PREFIX
+
Site prefix name.
+
+
Default: ''
+
+
+
+
--clean_entities
+
Whether to clean entities.
+
+
Default: true
+
+
+
+
--comments
+
Whether to import comments.
+
+
Default: true
+
+
+
+
--categories
+
Whether to import categories.
+
+
Default: true
+
+
+
+
--tags
+
Whether to import tags.
+
+
Default: true
+
+
+
+
--more_excerpt
+
Whether to use more excerpt.
+
+
Default: true
+
+
+
+
--more_anchor
+
Whether to use more anchor.
+
+
Default: true
+
+
+
+
--status STATUS,STATUS2
+
Array of allowed statuses (‘publish’, ‘draft’, ‘private’, ‘revision’).
Folder where assets such as images will be downloaded to
+
+
Default: 'assets'
+
+
+
+
+
The source, no_fetch_images, and assets_folder fields are not required.
Their default values are what you see above.
@@ -331,6 +353,7 @@
Further WordPress migration al
windows application for creating Markdown posts from your WordPress XML file.
+
diff --git a/feed.xml b/feed.xml
index dee7765e..34accb41 100644
--- a/feed.xml
+++ b/feed.xml
@@ -11,8 +11,8 @@
jekyll-import • Import your old & busted site to Jekyll
http://import.jekyllrb.com
- Thu, 15 Dec 2022 21:46:20 +0000
- Thu, 15 Dec 2022 21:46:20 +0000
+ Sun, 18 Dec 2022 09:27:42 +0000
+ Sun, 18 Dec 2022 09:27:42 +0000en-USImport your old & busted site to Jekyll, a blog-aware static site generator.