content for the docker-saigon.github.io blog, powered by:
Hugo is a static site generator written in Go. It is optimized for speed, easy use and configurability. Hugo takes a directory with content and templates and renders them into a full HTML website.
Hugo relies on Markdown files with front matter for meta data. And you can run Hugo from any directory.
Currently we are using the startbootstrap-clean-blog Theme.
The theme has been added as a git submodule
.
If you want to work on the blog, you will need to use the --recursive
option
when you git clone
this repository.
Any changes to the css/js will need to copy the files from the themes/startbootstrap-clean-blog/static/{css,js}
paths to the static/{css,js}
path to ensure the changes are not lost when pushing to this repository.
To add a blog posts to this blog, follow these steps:
-
Fork this repository and its submodules
git clone --recursive git@github.com:docker-saigon/blog-hugo
-
Get the Hugo binary for your platform & put it on
PATH
ashugo
-
Ensure everything is working by using
hugo server -w -d dev/
to run a live reload server accessible on http://localhost:1313 -
Add a new post via cli, using
hugo new post/<title>
& finalize the post using the live reload server. Reference -
Open a pull-request on github for peer review of your new post.
-
Pull Updates from origin
-
If
public/
folder does not exist yet, clone current site topublic/
folder:git submodule add git@github.com:docker-saigon/docker-saigon.github.io public/
-
Run
hugo
to generate the new site with new content overwritingpublic/
-
Use
./publish.sh [commit message]
script to push new static site to thedocker-saigon/docker-saigon.github.io
repository on github
./publish.sh
will move into the public/
folder, commit all the changes and push them to the website.