Twenty Nineteen Hugo

This is a Hugo port of WordPress’s Twenty Nineteen theme.

Highlights

• Accent color configurable via config.toml
• Featured images via image: in your post or page frontmatter
• Featured image filter effect works and can be disabled
• Menu locations and social menu icons all work using Hugo’s built-in menus
• Syntax highlighting included with the Monokai Light syntax theme
• Image alignment and caption styles ported to work nicely Hugo’s built-in figure shortcode

Installation

From the root of your site:

git submodule add https://github.com/jeremybise/twentynineteen-hugo.git themes/twentynineteen-hugo

In your config.toml, add the following:

theme = "twentynineteen-hugo"

Updating

From the root of your site:

git submodule update --remote --merge

Differences from original theme

• Comment stuff has been omitted
• Author stuff has been omitted

Content Notes

• To set a featured image for a post or page, add image: /path/to/image.jpg to your post or page’s frontmatter.

Available Site Params

Some theme features can be configured in config.toml. Here are the options:

[params]
  accent_color = "#FF0000" # Set a custom accent color for links and image filters, if enabled. Defaults to blue.
  description = "This is the site tagline." # Adds tagline next to the site title.
  privacy_link = "/privacy/" # Relative URL to privacy page, if there is one. This enables a Privacy Policy link in the footer. The link doesn't display if this isn't specified.
  disable_image_filters = false # Setting to true disables the color filter feature on images. Defaults to false.

Menus

The theme includes three menu locations: main, social and footer.

You can include pages in the main and footer menus using any of Hugo’s documented methods.

Sub menus work one level deep. For example, in your frontmatter:

menu:
  main:
    parent: "About Hugo"

The social menu can be configured in config.toml following this example:

[menu]
  [[menu.social]]
    identifier = "github"
    name = "Github"
    url = "https://github.com/gohugoio"
  [menu]
  [[menu.social]]
    identifier = "twitter"
    name = "Twitter"
    url = "https://twitter.com/gohugoio"

The theme uses the identifier to determine which icon to show. For a listing of which icons are available, check out the social icons partial folder.

Search

Add the JSON output format to your config.toml to create the index:

[outputs]
  home = ["HTML", "RSS", "JSON"]

Add search.md at the root of your content folder with the following frontmatter:

---
title: "Search"
type: static
layout: search
---

Google Analytics

Add your Google Analytics Tracking Code ID to your config.toml:

googleAnalytics = "UA-123-45"

The asynchronous tracking script will be included on pages on the live server, but not the dev server.

License

Open sourced under the GPL license (inherited from the original theme)

See Also

• Er
• Hugo-Primer
• Whiteplain
• Academia Hugo
• Academic