Puppet - Getting Started

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

1hugo 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.

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

Or you can add the theme as a submodule.

1cd mysite
2git init
3git submodule add https://github.com/roninro/hugo-theme-puppet.git themes/puppet
4git 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.

1cp 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.

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

Edit the content of the post.

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

1hugo server --themesDir ../..

Run Tina Locally

1npx tinacms dev - c "hugo server -D"

Rules

Layout a Post

1The main title will only be H1
2Succeeding titles will be H2 and lower

Conditional Rules

Images

Inline images: Uploaded to imgur, then linked Header_img: Uploaded to tina media manager

1![](https://imgur.com/SdQF4AX.jpg)

Screenshots: Uploaded to imgur, then coded

1
2[Screenshots](imgur.com/a/2cHNX0i) of the game uploaded from Imgur.
3
4<blockquote class="imgur-embed-pub" lang="en" data-id="a/2cHNX0i"><a href="//imgur.com/a/2cHNX0i">It's More Find in the
5    Philippines</a></blockquote>
6<script async src="//s.imgur.com/min/embed.js" charset="utf-8"></script>
7

Write-up

Subtitle: Write-up from Kevin Henry’s Risk Assessment and Management in Pluralsight

Draft

Subtitle: (Draft) …
Tags: draft

Search for Drafts

Use search: (Draft)

References

Bulleted Links: Risk Assessment and Management by Kevin Henry on Pluralsight

Redirect

Title: {title} Redirect
Description: Redirect only.
Date: Jan 01, 0001
Body: If you are not redirected automatically, click on this link: {link}
Tags: redirect

Update the netlify.toml

[[redirects]]
from = “/posts/johtomorrow-redirect/"
to = “https://forums.pokemmo.com/index.php?/topic/150498-heartgoldsoulsilver-coming-springish-2023/#comment-2019625"
force = true

Errors

Shortcodes

Temporarily removed due to being unsupported in TinaCMS. So far, only the “Rich Content” is not working.