diff options
author | Alan Pearce | 2023-05-18 20:57:35 +0200 |
---|---|---|
committer | Alan Pearce | 2023-05-18 20:57:35 +0200 |
commit | c8ec9d9ca2557a00559b4823d9b5bfd2faeb5775 (patch) | |
tree | f46299e4eb99f097caa6a93a9c904778cfae51a7 /themes/bear/README.md | |
parent | b0511b71c29c88acb99df245547a52bcce6b10bd (diff) | |
parent | fe37fcf3daa0eaafc1236050ac95b5d4ba21bcd2 (diff) | |
download | website-c8ec9d9ca2557a00559b4823d9b5bfd2faeb5775.tar.lz website-c8ec9d9ca2557a00559b4823d9b5bfd2faeb5775.tar.zst website-c8ec9d9ca2557a00559b4823d9b5bfd2faeb5775.zip |
Add 'themes/bear/' from commit 'fe37fcf3daa0eaafc1236050ac95b5d4ba21bcd2'
git-subtree-dir: themes/bear git-subtree-mainline: b0511b71c29c88acb99df245547a52bcce6b10bd git-subtree-split: fe37fcf3daa0eaafc1236050ac95b5d4ba21bcd2
Diffstat (limited to 'themes/bear/README.md')
-rw-r--r-- | themes/bear/README.md | 80 |
1 files changed, 80 insertions, 0 deletions
diff --git a/themes/bear/README.md b/themes/bear/README.md new file mode 100644 index 0000000..5396a5b --- /dev/null +++ b/themes/bear/README.md @@ -0,0 +1,80 @@ +# Zola ʕ•ᴥ•ʔ Bear Blog + +🧸 A [Zola](https://www.getzola.org/)-theme based on [Bear Blog](https://bearblog.dev). + +> Free, no-nonsense, super-fast blogging. + +## Demo + +For a current & working demo of this theme, please check out https://alanpearce.codeberg.page/zola-bearblog/ 🎯. + +## Screenshots + +⬜️ [Light][light-screenshot] +![light mode screenshot][light-screenshot] + +⬛️ [Dark][dark-screenshot] +![dark mode screenshot][dark-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`](https://codeberg.org/alanpearce/zola-bearblog/src/branch/main/templates/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][zola-setup-guide] of Zola. + +## Adjust configuration / config.toml + +Please check out the included [config.toml](https://codeberg.org/alanpearce/zola-bearblog/src/branch/main/config.toml) + +## Content & structure + +### Menu + +Create an array in `extra` with a key of `main_menu`. `url` is passed to [`get_url`](https://www.getzola.org/documentation/templates/overview/#get-url) + +```toml +[[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`](https://codeberg.org/alanpearce/zola-bearblog/src/branch/main/templates/style.html)-file to find out which CSS-styles are applied by default. + +## Issues / Feedback / Contributing +Please use [Codeberg issues](https://codeberg.org/alanpearce/zola-bearblog/issues) and [Pull Requests](https://codeberg.org/alanpearce/zola-bearblog/pulls). + +## Special Thanks 🎁 + +A special thank you goes out to [Herman](https://herman.bearblog.dev), for creating the original [ʕ•ᴥ•ʔ Bear Blog](https://bearblog.dev/) and [Jan Raasch](https://www.janraasch.com) for creating the hugo port of the Bear Blog theme. + +## License +[MIT License](http://en.wikipedia.org/wiki/MIT_License) © [Alan Pearce](https://www.alanpearce.eu/) + +[zola-setup-guide]: https://www.getzola.org/documentation/getting-started/installation/ +[light-screenshot]: https://codeberg.org/alanpearce/zola-bearblog/raw/branch/main/screenshot.png +[dark-screenshot]: https://codeberg.org/alanpearce/zola-bearblog/raw/branch/main/screenshot-dark.png |