百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
B

bilberry-hugo-theme

> 编程语言
开源

适用于 Hugo 网站建设器的高级主题。演示:

387 stars0 点赞3 次浏览
访问官网GitHub

工具介绍

适用于 Hugo 网站建设器的高级主题。演示:

Bilberry Hugo Theme v4


This guide is for the v4 version. For v3, please use this guide.

IMPORTANT v3 is no longer supported. If you want to migrate from v3 to v4, please read the migration guide.

For those who want to contribute to or customize the Bilberry Hugo theme, please see the developer guide.


Bilberry is a premium Hugo theme with many great features. This is an adaptation and further optimization of the Lingonberry WordPress theme by Anders Norén.

Here's a live demo site to see this theme in action.

Support and Discussions

Support for this theme is provided through the Issues and Discussions sections of the project. Please use the Issues section if you would like to report a defect or bug. For any other requests, use the Discussions section.

Please use the following guidelines if you want to start a discussion:

  • For any questions regarding a specific feature, or if you need help using or customizing the theme, use the Questions & Answers (Q&A) category.
  • To propose a new feature or any other improvements, use the Ideas category.
  • To showcase your blog or website powered by the Bilberry theme, use the Show and tell category.
  • Please use the General type discussion for any other inquiries.

Table of Contents

  • Requirements
  • Quick Start
    • Site Initial Setup
    • Theme Installation Options
      • Option 1 (recommended): Adding the Theme as a Hugo Module
      • Option 2: Adding the Theme as a Git submodule
      • Option 3: Copying the Theme Files
    • Configuration
    • Webserver
    • Free Hosting
    • Other Tutorials
  • Features
    • Default Post Types
      • Single Page
      • Page Bundle
    • Top Navigation Bar
    • Light/Dark Theme Mode
    • Algolia Search
      • Initial Setup
      • Update Algolia Index
        • Manual Upload
        • Automated Upload
    • Keyboard Shortcuts
    • Reposted Article/Duplicated Content
    • Estimated Reading Time
    • Summary Splits
      • Automatic Summary Split
      • Manual Summary Split
      • Front Matter Summary Split
      • No Summary Split
    • Open Graph Metadata
    • Table of Contents (TOC)
    • Series Taxonomy
    • Images
      • External Images
      • Image Modal Zoom
      • Featured Image
      • Automatic Image Resizing
      • Hyperlink Image
    • Video
      • PeerTube Configuration
    • Audio
    • Google Analytics
    • Comments
      • Commento
      • Disqus
      • Giscus
      • Utterances
    • Archive Page
    • Responsive Design
    • MathJAX Markup
    • Disabled JavaScript Support
    • Trimmed JavaScript Size
    • Raw HTML
  • Customizations
    • Hooks
    • Favicons
    • 404 Page
    • Custom Post Types
    • Individual Posts
    • Syntax Highlighting
    • Layout, Colors, and Fonts
    • CSS and JS modules
    • Cookie Disclaimer (GDPR)
  • Translations
  • Credits
  • Contributors
  • License

Requirements

  • Hugo (version >= 0.153.5 extended), see this guide on how to install Hugo.
  • Git, see this guide on how to install Git.
  • Go (version >= 1.25.7), optional, required only when the Bilberry theme is used as a Hugo module; see this guide on how to install Go.

Quick Start

Site Initial Setup

  • Clone the Bilberry Hugo theme repository to your local computer:
bash
git clone https://github.com/Lednerb/bilberry-hugo-theme.git

Alternatively, you can download it as a ZIP file and extract into the bilberry-hugo-theme directory.

  • Create a new site:
bash
hugo new site my-new-blog
  • Delete the default archetype:
bash
rm my-new-blog/archetypes/default.md

Theme Installation Options

Option 1 (recommended): Adding the Theme as a Hugo Module

Use this option if you want to pull in the theme files as a Hugo module from the main Bilberry Hugo theme repository. This option makes it easy to keep the theme up to date in your site.

  • Initialize your website as a Hugo module from the site's root:
bash
cd my-new-blog
hugo mod init github.com//my-new-blog
  • Copy the example site content, including the hugo.toml file:
bash
cp -r bilberry-hugo-theme/v4/exampleSite/* my-new-blog
  • Pull theme files by updating theme's module:
bash
hugo mod get -u

If you need more details on how to use Hugo modules, please read the Hugo documentation.

Option 2: Adding the Theme as a Git submodule

Use this option if you want to pull in the theme files as a Git submodule from the main Bilberry Hugo theme repository. This option also makes it easy to keep the theme up to date in your site.

  • Copy the example site content, including the hugo.toml file:
bash
cp -r bilberry-hugo-theme/v4/exampleSite/* my-new-blog
  • In the my-new-blog/hugo.toml file, uncomment the path property for Options 2 and 3, and comment out the path property for Option 1:
toml
[module]
  [[module.imports]]
    # Option 1 (recommended): adding the theme as a Hugo module
    # path = "github.com/Lednerb/bilberry-hugo-theme/v4"

    # Options 2 and 3: cloning/copying the theme files
    path = "bilberry-hugo-theme/v4"
  • Add the Bilberry Hugo theme as a Git submodule from the site's root:
bash
$ git submodule add https://github.com/Lednerb/bilberry-hugo-theme.git themes/bilberry-hugo-theme

Option 3: Copying the Theme Files

Use this option if you want to customize and maintain your own copy of the theme directly.

  • Copy the example site content, including the hugo.toml file:
bash
cp -r bilberry-hugo-theme/v4/exampleSite/* my-new-blog
  • In the my-new-blog/hugo.toml file, uncomment the path property for Options 2 and 3, and comment out the path property for Option 1:
toml
[module]
  [[module.imports]]
    # Option 1 (recommended): adding the theme as a Hugo module
    # path = "github.com/Lednerb/bilberry-hugo-theme/v4"

    # Options 2 and 3: cloning/copying the theme files
    path = "bilberry-hugo-theme/v4"
  • Copy cloned (or unzipped) theme files in the previous step to the my-new-blog/themes directory:
bash
cp -r bilberry-hugo-theme my-new-blog/themes/bilberry-hugo-theme

Important: Do NOT change the name of the themes/bilberry-hugo-theme folder in your site's root. Renaming this folder will break your site.

Configuration

To customize your website according to your needs, edit the hugo.toml file in the site's root directory by adjusting the settings. All parameters that need to be configured are commented out or disabled.

The Algolia Search is enabled in the hugo.toml file that comes with the example site; therefore, if you don't plan to use it, disable it by setting the algolia_search property to false.

Webserver

  • To build and serve the site, execute the following command from the site's root:
bash
cd my-new-blog
hugo server

Free Hosting

To deploy and host your website for free, you can use either GitHub Pages or Netlify.

Important: When hosting on GitHub Pages, you should add an empty file named .nojekyll to the site's root to avoid the issue with Font Awesome's icons not being loaded.

Other Tutorials

  • Start Blogging With Hugo, GitHub, and Netlify
  • Configure Custom Domain and HTTPS on Netlify
  • Manage Environment-Specific Settings for Hugo-Based Website

Features

Default Post Types

Bilberry theme comes with a set of predefined post types, namely article, audio, code, gallery, link, page , quote, status, and video, where the article type is the default.

To create a new content, use the hugo new command. Content can be created in two ways: a single page or a page bundle.

Single Page

To create new content as a single page, you can use the following command:

bash
hugo new /my-single-page-content.md

Page Bundle

Or, new page bundle content can be created as follows:

bash
hugo new /my-page-bundle-content/index.md

For example, you can create a new article as a single page and a new gallery as a page bundle using the following commands respectively:

bash
hugo new article/my-single-page-article.md
hugo new gallery/my-page-bundle-gallery/index.md

The page post type is the only one that can be used in the top navigation bar. Pages can be ordered using the weight front matter variable, which should be set to a non-zero value. A page with a lower weight will be displayed first.

The page content can be a static page, such as an About page, or a link to another page, internal or external.

The link post type always links to an external site and can be used with or without a background image.

Top Navigation Bar

If you want to permanently display the top navigation bar with the search text field and page items, set the permanentTopNav parameter to true in the hugo.toml file.

If you want to display the top navigation bar when scrolling down the page, set the stickyNav parameter to true. But this will only work when the permanentTopNav is also set to true.

Please note that the top navigation bar is minimized by default on mobile devices.

Light/Dark Theme Mode

Switching between light and dark theme mode can be enabled by setting the enableLightDarkTheme parameter to true:

toml
[params]
  enableLightDarkTheme = true

Algolia Search

Bilberry theme includes built-in content search via Algolia SAAS. You can see this in action on the demo site by clicking on "hamburger" and typing something in the search text field, such as "sup

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

JavaScripthacktoberfesthugohugo-theme

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言