Bilberry Hugo Theme

The Bilberry Hugo Theme is a premium, feature-rich theme designed for the Hugo static site generator. It is an adaptation and further optimization of the Lingonberry WordPress theme by Anders Norén. This guide focuses on the v4 version, with v3 no longer supported. A live demo is available to showcase its capabilities.

Support and Discussions

Support is provided through GitHub's Issues for bug reports and Discussions for general inquiries, Q&A, ideas, and showcasing your projects.

Requirements

To use the Bilberry theme, you need Hugo (version >= 0.139.4 extended) and Git. Go (version >= 1.22.6) is optional, required only when using the theme as a Hugo module.

Quick Start

1. Site Initial Setup: Clone the Bilberry Hugo theme repository, create a new Hugo site, and delete the default archetype.
2. Theme Installation Options: Choose from three methods:
   • Hugo Module (recommended): Initialize your site as a Hugo module, copy example site content, and pull theme files with hugo mod get -u.
   • Git Submodule: Copy example site content, adjust hugo.toml path, and add the theme as a Git submodule.
   • Copying Files: Copy example site content, adjust hugo.toml path, and copy theme files directly into your site's themes directory.
3. Configuration: Customize your website by editing the hugo.toml file. Disable Algolia Search if not needed.
4. Webserver: Build and serve your site locally using hugo server.
5. Free Hosting: Deploy to GitHub Pages or Netlify. Remember to add a .nojekyll file for GitHub Pages.

Features

• Default Post Types: Includes article, audio, code, gallery, link, page, quote, status, and video, supporting both single pages and page bundles.
• Top Navigation Bar: Can be permanently displayed or sticky on scroll, minimized on mobile.
• Light/Dark Theme Mode: Toggleable theme mode for user preference.
• Algolia Search: Integrated content search via Algolia SAAS, requiring initial setup with API keys and index configuration, with options for manual or automated index updates.
• Keyboard Shortcuts: s to open search, Esc to unfocus.
• SEO: Supports original_url for reposted articles and includes comprehensive Open Graph metadata.
• Content Management: Features estimated reading time, flexible summary splits (automatic, manual, front matter, or no summary), automatic Table of Contents (TOC) generation (H2-H5, configurable min word count), and Series Taxonomy for grouping articles.
• Media Support:
  • Images: Supports external images, interactive image modal zoom, featured images (via featuredImage front matter or featuredImage.* in page bundles), automatic image resizing, and hyperlink images.
  • Video: Embeds from YouTube, Vimeo, Prezi, Bilibili, PeerTube, and local MP4 files, configurable via post type or shortcode.
  • Audio: Embeds from Mixcloud, SoundCloud, Spotify, TuneIn, and local Ogg/MP3/WAV files, configurable via post type or shortcode.
• Integrations: Built-in support for Google Analytics (v3 and v4) and various commenting systems including Commento, Disqus, Giscus, and Utterances.
• Archive Page: Automatically generated archive page, configurable for grouping by year or year and month.
• Responsive Design: Optimized for desktops, tablets, and smartphones.
• MathJAX Markup: Support for mathematical notation.
• JavaScript Handling: Fully supports disabled JavaScript, and offers trimmed JavaScript size by making Moment.js optional.
• Raw HTML: Allows embedding raw HTML in markdown content.

Customizations

• Hooks: Extend functionality with head-end.html, body-start.html, and body-end.html partials.
• Favicons: Instructions for generating and integrating custom favicons.
• **404...