A converter from ghost exported json file to hexo yaml posts


Keywords
ghost, hexo, blog, converter, migration, static website, website, generator, framework, blogging, conversion, conversions, import, importer
License
MIT
Install
npm install ghost2hexo@1.2.0

Documentation

ghost2hexo

A quick'n'dirty command line tool written in Node.js to convert Ghost JSON exported posts into a set of source posts for Hexo... Long story short, an helper to migrate from Ghost to Hexo (and probably other static website publishing platforms).

npm version CircleCI JavaScript Style Guide

Install

With Node.js and Npm installed, as easy as:

npm install -g ghost2hexo

Usage

From your terminal of choice:

ghost2hexo ghost_data.json path/to/hexo/source/_posts

Where:

  • ghost_data.json: is the file exported from the Ghost admin
  • path/to/hexo/source/_posts: the posts folder of your local Hexo project

Quick migration guide

  1. Prepare your Hexo environment (you can follow the official quick start)
  2. Login into your Ghost admin
  3. Go to Settings > Labs and click the blue "Export" button (this will download the ghost data JSON file)
  4. Download your images and files from the contents/images folder of your ghost installation
  5. Use the ghost2hexo command to generate the posts for Hexo
  6. Copy your Ghost images into the your Hexo sources/contents/images
  7. Regenerate your static website with hexo generate

Contribute

Feel more than welcome to report bugs or propose changes.

License

Licensed under MIT.