Drupal Migrate Ghost

Uses Drupals migrate API to migrate content from a Ghost blog to Drupal 8.

Installation

1. Install Drush if you do not have it already.

2. Download Migrate Plus, Migrate Tools, and this module, using your preferred method (Drush, composer, manual download, etc.)

3. Install the modules.

4. Create a text format with the machine name "markdown"

5. Configure Drupal's access to the Ghost database, by adding a section for it in Drupal's settings.php file, like this:

      $databases['ghost']['default'] = [
        'database' => 'ghost_mikkel',
        'username' => 'ghost',
        'password' => 'ghostly-password',
        'prefix' => '',
        'host' => 'localhost',
        'namespace' => 'Drupal\\Core\\Database\\Driver\\mysql',
        'driver' => 'mysql',
      ];
   

   Note that this section should be in addition to your existing database configuration, not replace it.

   This should work with any of Ghost's supported databases, not just MySQL. Refer to the documentation in settings.php for how to configure the database connection to PostgreSQL or SQLite.

Usage

Once the module is installed (see above), run the following Drush command to complete the migration:

drush mi --group=ghost

Assumptions

This migration process makes a bunch of assumptions, that will work great if you install Drupal using the Standard installation profiles.

These assumptions are that you:

1. want Ghost tags migrated to the “Tags” taxonomy vocabulary.
2. want Ghost posts migrated to be nodes of type “Article”
3. want Ghost pages migrated to be nodes of type “Page”
4. have a text format named "markdown" and
5. want to import the Markdown source of your blog posts (rather than the HTML version that could be used with a WYSIWYG editor)

Currently, changing any of these assumptions will require changing this module's source code.

Status of this module

See CONTRIBUTING for details about outstanding work and the future of this module.