Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jbarone/ghostToHugo
Convert Ghost blog export to Hugo posts
https://github.com/jbarone/ghostToHugo
Last synced: 12 days ago
JSON representation
Convert Ghost blog export to Hugo posts
- Host: GitHub
- URL: https://github.com/jbarone/ghostToHugo
- Owner: jbarone
- License: mit
- Created: 2015-03-15T12:48:43.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2022-12-25T17:44:18.000Z (almost 2 years ago)
- Last Synced: 2024-08-01T04:57:34.097Z (3 months ago)
- Language: Go
- Size: 8.03 MB
- Stars: 132
- Watchers: 4
- Forks: 13
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ghostToHugo
[](https://github.com/jbarone/ghostToHugo/releases/latest)
[](/LICENSE)
[](https://travis-ci.org/jbarone/ghostToHugo)
[](https://goreportcard.com/report/github.com/jbarone/ghostToHugo)
**ghostToHugo** is a utility project that was created the allow the conversion
of an export from the Ghost blogging engine into the Hugo engine.
## Installing
There are 2 options for installation.
### Pre-Built Binaries
With every new versioned release. Binaries are built for most major platforms.
You can simply download the one for your operating system from the
[releases page](https://github.com/jbarone/ghostToHugo/releases/latest). Unzip
the package and place it somewhere in your path, and you are ready to go.
### Fetch With Go
The project is written in Go, and can easily be built from source.
Make sure you have Go installed and configured, then just run:
```
GO111MODULE=on go get github.com/jbarone/ghostToHugo@latest
```
this will download, compile, and install `ghostToHugo`
### Building the Latest and Greatest
Alternately, you can build directly:
```
git clone http://github.com/jbarone/ghostToHugo
cd ghostToHugo
go install
```
## Usage
```
Usage: ghostToHugo [OPTIONS]
-d, --dateformat string date format string to use for time conversions (default "2006-01-02 15:04:05")
--debug print verbose logging output
-f, --force allow import into non-empty target directory
-p, --hugo string path to create the new hugo project (default "newhugosite")
-l, --location string location to use for time conversions (default: local)
-v, --verbose print verbose logging output
```
At a minimum you need to specify the path to the exported Ghost json file.
NOTES:
- The `dateformat` string must be provided in Go's specific time format string. Reference [here](https://gobyexample.com/time-formatting-parsing)
- The `location` string should be a value that matches the IANA Time Zone database, such as "America/New_York"
- The path specified for the new Hugo site, must either not exist, or be an empty directory. A new site will be created at that location.
### Examples
```
$ ghostToHugo export.json
```
```
$ ghostToHugo --hugo ~/mysite export.json
$ ghostToHugo -p ~/mysite export.json
```
```
$ ghostToHugo --dateformat "2006-01-02 15:04:05" export.json
$ ghostToHugo -d "2006-01-02 15:04:05" export.json
```
```
$ ghostToHugo --location "America/Chicago" export.json
$ ghostToHugo -l "America/Chicago" export.json
```
## Exporting your Ghost content
You can export your Ghost content (and settings) from the "Labs" section of your Ghost install, which will be at a URL like:
```http(s):///ghost/settings/labs/```
See this [Ghost support article](https://help.ghost.org/hc/en-us/articles/224112927-Import-Export-Data) for details.