Premium theme for the hugo site builder. DEMO:
Premium theme for the hugo site builder. DEMO:
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 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:
Table of Contents
git clone https://github.com/Lednerb/bilberry-hugo-theme.gitAlternatively, you can download it as a ZIP file
and extract into the bilberry-hugo-theme directory.
hugo new site my-new-blogrm my-new-blog/archetypes/default.mdUse 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.
cd my-new-blog
hugo mod init github.com//my-new-bloghugo.toml file:cp -r bilberry-hugo-theme/v4/exampleSite/* my-new-bloghugo mod get -uIf you need more details on how to use Hugo modules, please read the Hugo documentation.
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.
hugo.toml file:cp -r bilberry-hugo-theme/v4/exampleSite/* my-new-blogmy-new-blog/hugo.toml file, uncomment the path property for Options 2 and 3, and
comment out the path property for Option 1:[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"$ git submodule add https://github.com/Lednerb/bilberry-hugo-theme.git themes/bilberry-hugo-themeUse this option if you want to customize and maintain your own copy of the theme directly.
hugo.toml file:cp -r bilberry-hugo-theme/v4/exampleSite/* my-new-blogmy-new-blog/hugo.toml file, uncomment the path property for Options 2 and 3, and
comment out the path property for Option 1:[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"my-new-blog/themes directory:cp -r bilberry-hugo-theme my-new-blog/themes/bilberry-hugo-themeImportant: Do NOT change the name of the themes/bilberry-hugo-theme folder in your site's root.
Renaming this folder will break your site.
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.
cd my-new-blog
hugo serverTo 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.
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.
To create new content as a single page, you can use the following command:
hugo new /my-single-page-content.mdOr, new page bundle content can be created as follows:
hugo new /my-page-bundle-content/index.mdFor example, you can create a new article as a single page and a new gallery as a page bundle using the following commands respectively:
hugo new article/my-single-page-article.md
hugo new gallery/my-page-bundle-gallery/index.mdThe 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.
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.
Switching between light and dark theme mode can be enabled by setting the enableLightDarkTheme parameter to true:
[params]
enableLightDarkTheme = trueBilberry 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
No open issues yet, or sync has not completed.