Create a Blog Post with Hugo
In this post, I will present you a short introduction on how to create a blog post, from the the installation of Hugo to publishing your article.
For the SUAM project, there are two main repositories responsible for content publishing, suam-team/raw for static content and Hugo config, and suam-team/blog which contains
public/ directory for HTML. We have
deploy.sh for executing and pushing content from a markdown file to a HTML file.
- Install the latest version of Hugo. The most painless way is to use a binary from Hugo Releases and make it available in
- Clone the suam-team/raw with all submodules to your workspace. The recommended command to fetch all submodules in parallel is:
$ git clone --recurse-submodules -j8 [email protected]:suam-team/raw.git suam
- Create a post with the command below. The post will be available on
$ hugo new posts/my-post.md
- The current theme required us to add some post metadata in the post header. The parameters below are required but you can add more, see this sample post for reference.
--- title: "Create a Blog Post with Hugo" date: 2020-01-14T01:15:59+07:00 author: "P" draft: false description: "A short introduction on how to create a blog post with Hugo" ---
- You can see a live draft version on your machine with
hugo server -D. Hugo will generate HTML pages from our markdown files and make it available on
- Publishing your content must be done in the following steps:
Congratulation! You’ve just learned on how to contribute with our SUAM blog!