Migrate

A collection of tools for migrating to Ghost.

Each tool has its own detailed documentation:

• Ghost
• Curated
• Curated members
• HubSpot
• Jekyll
• Medium
• Revue
• Squarespace
• Substack
• Substack members
• WordPress

Install

Migrate is a set of command line tools, install them globally:

npm install --global @tryghost/migrate

Usage

Run migrate --help to see a list of available commands.

Basic usage is migrate [source] source-info:

E.g.

migrate medium path/to/export.zip

migrate wp-api https://mywpsite.com

Each source comes with optional flags to customise the migration:

migrate [source] --help will give more detail

Develop

This is a mono repository, managed with lerna.

1. git clone this repo & cd into it as usual
2. yarn setup is mapped to lerna bootstrap
   • installs all external dependencies
   • links all internal dependencies

To add a new package to the repo:

• install slimer
• run slimer new <package name>

Run

To run a local development copy, cd into this directory, and use yarn dev instead of migrate like so:

yarn dev [source]

Test

• yarn lint run just eslint
• yarn test run lint and tests

Publish

• yarn ship is an alias for lerna publish
  • Publishes all packages which have changed
  • Also updates any packages which depend on changed packages

Copyright & License

Copyright (c) 2013-2022 Ghost Foundation - Released under the MIT license.