You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Leonora Tindall 4763ed1a04
copyediting, typesetting, and rethemeing, 2021 edition
9 months ago
archetypes Add OAKTROUGH theme 5 months ago
layouts Fix for new renderer w/ more shortcodes 5 months ago
static copyediting, typesetting, and rethemeing, 2021 edition 5 months ago
.gitignore Add OAKTROUGH theme 5 months ago Add OAKTROUGH theme 5 months ago Groundwork for fixing projects folder 5 months ago
theme.toml Fix OAKTROUGH to use correct Hugo version 5 months ago


OAKTROUGH is a Hugo theme based on semantic HTML elements and simple, ultra-responsive CSS.

Title Override

Want your page title to be one thing but the page itself to show something else, like a name for a resumé? Use display_title in the front matter. The title will still show up in the title bar and as the title attribute for all metadata.

Need to hide post metadata? Try hide_post_meta: true.

Skip to Main Content

Every page has a "skip to main content" as its first link, for better screenreader and keyboard support.


All navigation is placed at the top of the page beside the title.

Post Metadata

Every post contains a few <meta> fields, which correspond to either site config or post frontmatter variables. These are Dublin Core enabled where possible, meaning that posts on this theme can easily be ingested into e.g. Zotero.

  • Title is the title of the post.
  • Creator is from author in the frontmatter or params.Author in config.toml otherwise.
  • Date is the Hugo-recorded date of the post.
  • Language is from Hugo's generating locale.
  • Description is from Description in the frontmatter, or Summary if that's not present, or MetaSiteDescription in config.toml as a fallback.
  • Identifier is the permalink URL.

Non-Dublin Core attributes are:

  • viewport for rendering properly, this isn't customizable
  • keywords is from the tags taxonomy in the frontmatter
  • google-site-verification is from params.googlesiteverification in config.toml in case you need that.
  • nolist turns off listing sub-pages on specific index pages.


To insert a figure with caption, you can use the {{< figure >}} shortcode. Simply place your Markdown with image and caption inside it. To make it float left or right, use {{< figure "left" >}} or {{< figure "right" >}}. For instance:

{{< figure "right" >}}                                                                                                                                                                    
    ![The drive cage of my Thelio with one drive out of its slot.](/images/thelio/drive_cage.jpg)
    Drives are inserted on rails using vibration-isolating gromits. If only it were this easy 
    to get RAID working!                                                                      
{{< /figure >}}