Puppet - Getting Started

Total Views:

Puppet is a responsive, simple and clean Hugo theme based on the Huxblog Jekyll theme.

Install Hugo

Make sure you have installed the latest version of Hugo-extented.

Create a New Site

1
hugo new site mysite

Add the Theme

You can download and unpack the theme manually from Github or use git to clone the theme into your site’s themes directory.

1
2
3
cd mysite
git init
git clone https://github.com/roninro/hugo-theme-puppet.git themes/puppet

Or you can add the theme as a submodule.

1
2
3
4
cd mysite
git init
git submodule add https://github.com/roninro/hugo-theme-puppet.git themes/puppet
git submodule update --init --recursive

That’s all, Puppet is ready to be used.

Add Config Files

For getting started, you can copy the config.toml file from the theme’s exampleSite directory to the root directory of your site.

1
cp themes/puppet/exampleSite/config.toml .

Note: You may need to delete the themesDir line in the config file.

Add Some Content

Create a new post with the following command.

1
hugo new posts/my-first-post.md

Edit the content of the post.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
+++
title = "{{ replace .Name "-" " " | title }}"
date = {{ .Date }}
description = ""
draft = true
subtitle = ""
header_img = ""
toc = true
tags = []
categories = []
series = []
comment = true
+++

Your content here...

Some front-matter used for SEO, others used for displaying contents, configuration, etc.

Run example site

From the root of themes/puppet/exampleSite:

1
hugo server --themesDir ../..