This project hosts the source behind
The blog consists of static html generated by Hugo.
Hugo is installed in the development virtual machine and is used to
generate the site and each blog post.
git clone --recursive firstname.lastname@example.org:doalitic/brook-blog.git
Several themes can be installed cloning the appropriate repo via
The one employed is determined by the configuration file
blog/config.toml. At the moment, we suggest the use of the material
design theme, but others can
be employed instead. In any case, we'll likely fork an existing theme
to adapt it to our needs.
Installing a theme as a git submodule is quite straightforward:
git submodule add https://github.com/pdevty/material-design blog/themes/material-design
Hence, to upgrade to the latest version of installed themes just run:
git submodule foreach git pull origin master
The site is initially created with
hugo new site blog. As a blog
author, you don't need to issue this command again since the resulting
blog structure is already under version control.
In order to add a new post, just run
hugo new post/my-post-name.md
blog directory and:
- Edit the corresponding Markdown file (don't forget to update the
frontmatter metadata, deleting
draft = Truein case it exists).
- Check the result running
make server(port 1313).
When you're happy with the result, add the source files to the
repo and push it. An automated build in Docker Hub will start to create
a data container that exports
/var/www/blog as a volume so that it can
be used from an outside container, mainly from a web server. Such volume
contains the html files generated from the source Markdown.
The Doalitic team email@example.com