Roller Importer

This importer depends on the following third-party gems:

  • safe_yaml
  • sequel
  • unidecode
You may either install the gem(s) individually by running a command with syntax gem install GEM_NAME or install the required gems in a batch by running the following snippet: 
gem install safe_yaml sequel unidecode

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.

Currently this importer assumes a MySQL database.