| .github | ||
| archetypes | ||
| exampleSite | ||
| images | ||
| layouts | ||
| .gitignore | ||
| .jsbeautifyrc | ||
| CONTRIBUTING.md | ||
| LICENSE | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| theme.toml | ||
Hugo ʕ•ᴥ•ʔ Bear Blog 
🧸 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.
Remixes 🎭
The community has created some interesting variations of the Hugo ʕ•ᴥ•ʔ Bear Blog. While the main theme stays true to the minimal Bear Blog philosophy, these remixes experiment with additional features:
-
Hugo ʕ•ᴥ•ʔ Bear Blog ✨ Neo - Features Chinese documentation and an innovative "Toast" upvote system.
-
ᕦʕ •ᴥ•ʔᕤ Bear Cub - A multilingual variant with experimental features like automatic social card generation.
Note: These are independent forks maintained by their respective creators.
Contributing & Community 🤝
Interested in contributing to Hugo ʕ•ᴥ•ʔ Bear Blog? Thanks for your interest!
- Check out our Contributing Guidelines for code contributions and bug reports
- Share your story if you're using the theme - we'd love to see what you've built!
- Have questions? You can find help in our GitHub issues or the Hugo Discourse
We aim to keep this theme as simple and fast as the original Bear Blog, while making it a friendly space for everyone to contribute and share their experiences.
Development
Run the exampleSite locally via
hugo server --source ./exampleSite --themesDir ../..
Special Thanks 🎁
A special thank you goes out to Herman, for creating the original ʕ•ᴥ•ʔ Bear Blog.