.github/ISSUE_TEMPLATE | ||
archetypes | ||
data | ||
exampleSite | ||
layouts | ||
static | ||
.gitignore | ||
LICENSE | ||
netlify.toml | ||
README.md | ||
theme.toml |
Cupper
An accessibility-friendly Hugo theme, ported from the original Cupper project.
Table of contents
- Demo
- Installation
- Updating
- Run example site
- Configuration
- Disable toc for a blog post
- Syntax highlighting
- Shortcodes
- Favicons
- Credits
Demo
https://cupper-hugo-theme.netlify.com/
Installation
From the root of your site:
git submodule add https://github.com/zwbetz-gh/cupper-hugo-theme.git themes/cupper-hugo-theme
Updating
From the root of your site:
git submodule update --remote --merge
Run example site
From the root of themes/cupper-hugo-theme/exampleSite
:
hugo server --themesDir ../..
Configuration
Copy the config.toml
from the exampleSite
, then edit as desired.
Replace static/images/logo.svg
with your logo. Keep the filename as logo.svg
.
Disable toc for a blog post
Blog posts that have two or more subheadings (<h2>
s) automatically get a table of contents. To disable this set toc
to false
. For example:
---
title: "My page with a few headings"
toc: false
---
Syntax highlighting
Syntax highlighting is provided by Prism. See the full list of supported languages.
Shortcodes
See the full list of supported shortcodes.
Favicons
Upload your image to RealFaviconGenerator then copy-paste the generated favicon files under static
.
Credits
Thank you to Heydon Pickering and The Paciello Group for creating the original Cupper project.