Fine-brewed Hugo theme made open.
Demosite: https://hugo.brewm.co
- Reader-first: Prioritizes readability and accessibility with personalized settings for colors, fonts, and BionRead mode.
- Inclusive: Graceful degradation design oriented with improved semantic HTML structure & WAI-ARIA attribute, the site remains fully functional even when JavaScript is disabled!
- Scalable: Support for multiple authors and languages, optional Pagefind search, external feed over RSS and Fediverse-powered commenting system.
- Frameworkless: Lower maintenace & carbon footprint by lesser resource usage.
- Create a new Hugo site (for an existing hugo site, skip to step 2) :
hugo new site mysite
cd mysite
git init
- Add this theme as a Git submodule:
git submodule add https://github.com/foxihd/hugo-brewm themes/hugo-brewm
- Update your site's configuration in
config.toml:
theme = "hugo-brewm"
Check the example site's configuration directory (./themes/hugo-brewm/exampleSite/config/_default) to explore available configuration options.
- Create a new post under content directory:
hugo new posts/my-first-post.md
- For building and deploying your Hugo site to GitHub Pages, copy the workflow file from ./themes/hugo-brewm/github/workflows/hugo.yml to your repository's root directory and initiate the GitHub Action.
This project could not be made, without a lot efforts of — thank to:
- Aliftype/amiri - for Amiri.
- Alvarotrigo on Codepen - for Logotype.
- Antijingoist/opendyslexic/ - for OpenDyslexic typeface.
- Datalog/qrcode-svg - for page QR code generation.
- Dpecos/mastodon-comments - for Mastodon comments.
- Georgd/EB-Garamond, Imedadel/typeface-eb-garamond-latest/ & Googlefonts/ebgaramond-specimen/ - for serif typeface.
- GoogleFonts/Inconsolata - for teletype typeface.
- IcoMoon - for icon font.
- JulietaUla/Montserrat - for sans-serif typeface.
- Markmead/JS Bionic Reading - for BionRead support.
- Mrozilla on codepen - for dark/light mode toggle style.
- Msurguy/Flow Lines - for generated feature images.
- Omnibus-Type/Rosario - for sans-serif typeface.
- Risilab/Cormorant - for serif typeface.
- Rsms/Inter - for sans-serif typeface.
- Skoch/Crimson - for serif typeface.
- Slashformotion/Hugo Tufte - for figure & marginpar shortcodes.
This theme is released under the MIT License.