hugo-bearblog/README.md
Martijn Engler dec11203de
Use hugo.toml instead of config.toml (#74)
* Use hugo.toml instead of config.toml

Use the file hugo.toml in both the README.md and the exampleSite, since
Hugo will look for this file first.

The current instructions (using config.toml) in a new Hugo site
(that has a hugo.toml-file) means that the site doesn't work, or the
theme is not activated.

Note that this is a breaking change for sites running on older versions.
(But v0.110.0 was released almost a year ago.)

Relevant Hugo commit:

f38a2fbd2e

* Require `hugo v0.110.0`

> Make hugo.toml the new config.toml

see https://github.com/gohugoio/hugo/releases/tag/v0.110.0

---------

Co-authored-by: Jan Raasch <425211+janraasch@users.noreply.github.com>
2024-01-23 10:28:44 +01:00

3.1 KiB
Raw Blame History

Hugo ʕ•ᴥ•ʔ Bear Blog Test

🧸 A Hugo-theme based on Bear Blog.

Free, no-nonsense, super-fast blogging.

Demo

For a current & working demo of this theme, please check out https://janraasch.github.io/hugo-bearblog/ 🎯.

Screenshots

Light

Dark

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 Hugo site on your machine, you can simply add this theme via

git submodule add https://github.com/janraasch/hugo-bearblog.git themes/hugo-bearblog

Then, adjust the hugo.toml as detailed below.

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

Adjust configuration / hugo.toml

Please check out the hugo.toml included in the exampleSite of this theme.

Content & structure

Starting fresh

If you are starting fresh, simply copy over the contents of the exampleSite-directory included in this theme to your source directory. That should give you a good idea about how things work, and then you can go on from there to make the site your own.

Adding / editing content

Index-Page

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

Page

You can add a new page via running

hugo new my-new-page.md

Blog-Post

You can add a new blog-post via running

hugo new blog/my-new-post.md

Adding your branding / colors / css

Add a custom_head.html-file to your layouts/partials-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.

Issues / Feedback / Contributing

Please use GitHub issues and Pull Requests.

Special Thanks 🎁

A special thank you goes out to Herman, for creating the original ʕ•ᴥ•ʔ Bear Blog.

License

MIT License © Jan Raasch