Zola ʕ•ᴥ•ʔ Bear Blog

🧸 A Zola-theme based on Bear Blog.

Free, no-nonsense, super-fast blogging.

Demo

For a current & working demo of this theme, please check out https://zola-bearblog.netlify.app/ 🎯.

Screenshot

When the user's browser is running »dark mode«, the dark color scheme will be used automatically. The default is the light/white color scheme. Check out the style.html-file for the implementation.

Installation

If you already have a Zola site on your machine, you can simply add this theme via

git submodule add https://codeberg.org/alanpearce/zola-bearblog themes/zola-bearblog

Then, adjust the config.toml as detailed below.

For more information, read the official setup guide of Zola.

Alternatively, you can quickly deploy a copy of the theme site to Netlify using this button:

(Note that this method makes it harder to keep up-to-date with theme updates, which might be necessary for newer versions of Zola.)

Adjust configuration / config.toml

Please check out the included config.toml

Content & structure

Menu

Create an array in extra with a key of main_menu. url is passed to get_url

[[extra.main_menu]]
name = "Home"
url = "/"

[[extra.main_menu]]
name = "Bear"
url = "@/bear.md"

[[extra.main_menu]]
name = "Zola"
url = "@/zola.md"

[[extra.main_menu]]
name = "Blog"
url = "@/blog/_index.md"

Adding / editing content

Index-Page

The contents of the index-page may be changed by editing your content/_index.md-file.

Adding your branding / colors / css

Add a custom_head.html-file to your templates/-directory. In there you may add a <style>-tag, or you may add a <link>-tag referencing your own custom.css (in case you prefer to have a separate .css-file). Check out the style.html-file to find out which CSS-styles are applied by default.

Table of contents

Table of contents are not rendered by default. To render them, set extra.table_of_contents.show = true in config.toml.

The table of contents is rendered inside a details element. If you want the section to be collapsed on page load, set extra.table_of_contents.visible_on_load = false. This defaults to true.

In addition, extra.table_of_contents.max_level can limit the maximum level of headers to show. To show only h1s, set max_level = 1, to show h1s and h2s, set max_level = 2, and so on. By default, max_level is set to 6, so all headers on the page are shown.

Below is an example of how to configure the table of contents in config.toml.

[extra.table_of_contents]
show = true
max_level = 2
visible_on_load = false

It can also be toggled on page-by-page basis. Add extra.hide_table_of_contents = true to the page's frontmatter to hide the table of contents for that specific page.

Issues / Feedback / Contributing

Please use Codeberg issues and Pull Requests.

Special Thanks 🎁

A special thank you goes out to Herman, for creating the original ʕ•ᴥ•ʔ Bear Blog and Jan Raasch for creating the hugo port of the Bear Blog theme.

License

MIT License © Alan Pearce