- 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.
Topics
Resources
License
Code of conduct
Security policy
Uh oh!
There was an error while loading.Please reload this page.
Stars
Watchers
Forks
Packages0
Uh oh!
There was an error while loading.Please reload this page.