Converts a Medium members txt
export and generates a csv
file you can import into a Ghost installation.
To install the CLI, which is required for the Usage commands below:
npm install --global @tryghost/migrate
To use this package in your own project:
npm install @tryghost/mg-medium-members --save
or
yarn add @tryghost/mg-medium-members
To run basic Medium member migration, the required command is this:
migrate medium-members --pathToTxt /path/to/members.txt
A more complex command for a Medium member migration looks like this:
migrate medium-members --pathToTxt /path/to/members.txt --verbose true
It's possible to pass more options, in order to achieve a better migration file for Ghost:
-
--pathToTxt
(required)- Path to members text file
- string - default:
null
-
--cache
- Persist local cache after migration is complete (Only if
--zip
istrue
) - bool - default:
true
- Persist local cache after migration is complete (Only if
-
-V
--verbose
- Show verbose output
- bool - default:
false
-
--zip
- Create a zip file
- bool - default:
false
This is a mono repository, managed with lerna.
Follow the instructions for the top-level repo.
-
git clone
this repo &cd
into it as usual - Run
yarn
to install top-level dependencies.
To run a local development copy, cd
into this directory, and use yarn dev
instead of migrate
like so:
yarn dev medium-members <commands>
-
yarn lint
run just eslint -
yarn test
run lint and tests
Copyright (c) 2013-2023 Ghost Foundation - Released under the MIT license.