- Notifications
You must be signed in to change notification settings - Fork0
A Docker-based pipeline to publish the content of a local Ghost 4 server as static pages.
License
rija/ghost-ssg
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
A Docker-based pipeline to publish the content of a local Ghost 4 server as static pages.
┌──────────────────────────────┐ ┌──────────────────────────────┐ ┌──────────────────────────────┐ ┌──────────────────────────────┐│ │ │ │ │ │ │ ││ │ │ │ │ │ │ ││ │ export │ │ preview │ │ git push │ ││ Post editing and management ├────────────────────► Static pages on file system ├────────────────────────►Site served on local web server──────────────────►Site served on GitLab Pages ││ │ │ │ │ │ │ ││ │ │ │ │ │ │ │└──────────────────────────────┘ └──────────────────────────────┘ └──────────────────────────────┘ └──────────────────────────────┘- You need to have installed on your system already:
- Docker
- bash
- git
- bats-core (optional, for running the test suite)
- To publish to remote destination, you need to have a git-enabled remote static page hosting setup and configured:
| Host type | Needs done before | More infos |
|---|---|---|
| Bitbucket | have created a new repository on Bitbucket.org | https://support.atlassian.com/bitbucket-cloud/docs/publishing-a-website-on-bitbucket-cloud/ |
| Codeberg | have created a new public repo named "pages" on Codeberg.org | https://docs.codeberg.org/codeberg-pages/ |
| GitHub | have followed instructions in the docs on Github.com | https://docs.github.com/en/pages/quickstart |
| GitLab | have created a new project of type "Pages/Plain HTML" on GitLab.com | https://docs.gitlab.com/ee/user/project/pages/ |
Disclaimer: at time of writing, I have only tested with GitLab.com (it may work on other GitLab-based forges - like framagit.org - , not sure for the other ones)
- Run the setup script:
$ ./setupThen edit .env file to assign a value toDEST_REPO, ensure the value for PAGES_REPO_PATH and DEST_BRANCH are correct
- Start the servers (the blog editor, the preview server and the backup server)
$ ./upGhost is now available athttp://localhost:2368
- Export the content of Ghost as static file for preview
$ ./previewA preview of the static website can be viewed athttp://localhost:9999
- Publish the content of Ghost
$ ./publishThe static web pages are first exported in thepublic directory inside the directory defined by the $PAGES_REPO_PATH variable.Then the changes are commited and pushed to the remote git repository.
- Backup your installation
$ ./backupThis will backup the SQL database and the content directory
- Shutdown the servers
$ ./down- Show what server is up:
$ ./whatsup- Inspect the server logs:
$ ./log- Show the current versions of the dependencies
$ ./versions- Run the test suite
$ ./test- Restore from backup
$ ./restoreAbout
A Docker-based pipeline to publish the content of a local Ghost 4 server as static pages.