diff --git a/docs/content/themes/DeepThought/index.md b/docs/content/themes/DeepThought/index.md index 95186ffb..3462bf66 100644 --- a/docs/content/themes/DeepThought/index.md +++ b/docs/content/themes/DeepThought/index.md @@ -3,11 +3,11 @@ title = "DeepThought" description = "A simple blog theme focused on writing powered by Bulma and Zola." template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/RatanShreshtha/DeepThought.git" homepage = "https://github.com/RatanShreshtha/DeepThought" minimum_version = "0.14.1" diff --git a/docs/content/themes/Ergo/index.md b/docs/content/themes/Ergo/index.md index 9b6629ed..9d4a772a 100644 --- a/docs/content/themes/Ergo/index.md +++ b/docs/content/themes/Ergo/index.md @@ -3,11 +3,11 @@ title = "Ergo" description = "A simple blog Theme focused on writing, inspired by svbtle" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/insipx/Ergo.git" homepage = "https://github.com/insipx/Ergo" minimum_version = "0.4.1" diff --git a/docs/content/themes/HayFlow/index.md b/docs/content/themes/HayFlow/index.md index 1002ff92..dae0fd51 100644 --- a/docs/content/themes/HayFlow/index.md +++ b/docs/content/themes/HayFlow/index.md @@ -3,11 +3,11 @@ title = "HayFlow" description = "HayFlow is a minimal and completely modular Zola theme for anyone wishing to have their own landing page." template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://gitlab.com/cyril-marpaud/hayflow.git" homepage = "https://gitlab.com/cyril-marpaud/hayflow" minimum_version = "0.4.0" diff --git a/docs/content/themes/Zulma/index.md b/docs/content/themes/Zulma/index.md index b534b0fa..c666aca1 100644 --- a/docs/content/themes/Zulma/index.md +++ b/docs/content/themes/Zulma/index.md @@ -3,11 +3,11 @@ title = "Zulma" description = "A zola theme based off bulma.css" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/Worble/Zulma.git" homepage = "https://github.com/Worble/Zulma" minimum_version = "0.6.0" diff --git a/docs/content/themes/abridge/index.md b/docs/content/themes/abridge/index.md index a7b5df54..7f4e3e28 100644 --- a/docs/content/themes/abridge/index.md +++ b/docs/content/themes/abridge/index.md @@ -3,11 +3,11 @@ title = "abridge" description = "A fast and lightweight Zola theme using semantic html, a class-light abridge.css, and No mandatory JS." template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/Jieiku/abridge.git" homepage = "https://github.com/jieiku/abridge" minimum_version = "0.18.0" @@ -30,7 +30,7 @@ A fast, lightweight, and modern [Zola](https://getzola.org) theme utilizing [abr Maintenance of this project is made possible by all the contributors and sponsors. If you'd like to sponsor this project and have your avatar or company logo appear below click here. 💖 - + --- diff --git a/docs/content/themes/adidoks/index.md b/docs/content/themes/adidoks/index.md index bcf7ff8e..27146139 100644 --- a/docs/content/themes/adidoks/index.md +++ b/docs/content/themes/adidoks/index.md @@ -3,11 +3,11 @@ title = "adidoks" description = "AdiDoks is a Zola theme helping you build modern documentation." template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/aaranxu/adidoks.git" homepage = "https://github.com/aaranxu/adidoks" minimum_version = "0.15.0" diff --git a/docs/content/themes/after-dark/index.md b/docs/content/themes/after-dark/index.md index 1759c6da..9397d4dc 100644 --- a/docs/content/themes/after-dark/index.md +++ b/docs/content/themes/after-dark/index.md @@ -3,11 +3,11 @@ title = "after-dark" description = "A robust, elegant dark theme" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/getzola/after-dark.git" homepage = "https://github.com/getzola/after-dark" minimum_version = "0.17.0" diff --git a/docs/content/themes/albatros/index.md b/docs/content/themes/albatros/index.md index 37bf8d49..720c2a8f 100644 --- a/docs/content/themes/albatros/index.md +++ b/docs/content/themes/albatros/index.md @@ -3,11 +3,11 @@ title = "Albatros" description = "A feature rich theme originally made for Duniter website." template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://git.42l.fr/HugoTrentesaux/Albatros.git" homepage = "https://git.42l.fr/HugoTrentesaux/Albatros" minimum_version = "0.16.0" diff --git a/docs/content/themes/anatole-zola/index.md b/docs/content/themes/anatole-zola/index.md index a43d15dd..8a537107 100644 --- a/docs/content/themes/anatole-zola/index.md +++ b/docs/content/themes/anatole-zola/index.md @@ -3,11 +3,11 @@ title = "anatole-zola" description = "A port of farbox-theme-Anatole for zola" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/longfangsong/anatole-zola.git" homepage = "https://github.com/longfangsong/anatole-zola" minimum_version = "0.4.0" diff --git a/docs/content/themes/andromeda/index.md b/docs/content/themes/andromeda/index.md index 4da65075..b9fc9845 100644 --- a/docs/content/themes/andromeda/index.md +++ b/docs/content/themes/andromeda/index.md @@ -3,11 +3,11 @@ title = "Andromeda" description = "Photography journal blog theme" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/Pixadus/andromeda-theme.git" homepage = "https://github.com/Pixadus/andromeda-theme" minimum_version = "0.16.0" diff --git a/docs/content/themes/anemone/index.md b/docs/content/themes/anemone/index.md index 61496379..dd8dbcb6 100644 --- a/docs/content/themes/anemone/index.md +++ b/docs/content/themes/anemone/index.md @@ -3,12 +3,12 @@ title = "anemone" description = "A minimalist Zola theme that prioritizes clean CSS and avoids heavy JavaScript. Enjoy a seamless user experience with lightning-fast load times. Let your content take center stage in a clutter-free, elegant design that enhances readability. Responsive and efficient, anemone brings focus to your ideas." template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 -repository = "https://github.com/Speyll/anemone" +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 +repository = "https://github.com/Speyll/anemone.git" homepage = "https://github.com/Speyll/anemone" minimum_version = "0.4.0" license = "MIT" @@ -30,7 +30,7 @@ Anemone is a versatile Zola theme that comes with both light and dark variants. ![Anemone Light and Dark Theme](screenshot.png) -### Installation +## Installation To get started with Anemone, follow these simple steps: @@ -47,7 +47,23 @@ git clone https://github.com/Speyll/anemone theme = "anemone" ``` -### Options +## Release Notes + +#### 02-03-2024 +This release brings several improvements and enhancements, focusing mainly on optimizing performance and user experience. Here's a summary of the key changes: + +- **suCSS Integration:** The core CSS now leverages the lightweight [suCSS framework](https://speyll.github.io/suCSS/) made by yours truly, providing better maintainability, robustness, and scalability. With suCSS, the theme should maintain consistent appearance across different browsers. + +- **Enhanced Theme Toggle:** The dark and light theme toggle has been revamped for more consistency. Now, the website respects the user's system-wide theme settings, ensuring a seamless experience. Additionally, the toggle retains the selected theme for future visits, offering improved usability. + +- **Smooth Transition and Sound Effect:** Enjoy a smoother transition between the dark and light mode accompanied by a subtle sound effect. Rest assured, the added sound effect incurs minimal performance overhead, with the file size being just 1kb. + +- **Class Names and Shortcodes Update:** Some class names and shortcodes have been modified for better organization and clarity. I apologize for any inconvenience this may cause. + +- **Slight change in Color Choice:** Some dark mode colors have been changed for the sake of readability, still using [veqev](https://github.com/Speyll/veqev). + + +## Options Anemone provides various options to customize your website: @@ -95,13 +111,13 @@ header_nav = [ ] ``` -#### Default Theme +#### Add Table of Contents (TOC) to Pages -To configure the default theme, simply utilize the `default_theme` variable and set it to either `light` or `dark`: +In a page's frontmatter, set `extra.toc` to `true`: ```toml [extra] -default_theme = "light" +toc = true ``` #### Display Author Name in Blog Posts @@ -121,20 +137,12 @@ Add a webring with a shortcode: {{/* webring(prev="#", webring="#", webringName="Random Webring", next="#") */}} ``` -#### Add Table of Contents (TOC) to Pages - -In a page's frontmatter, set `extra.toc` to `true`: - -```toml -[extra] -toc = true -``` - ### Extra Data -- Set the `author` in both the main config and in pages' metadata. +- Set the `author` in both the main config and in pages metadata. - Use the `image` variable in pages to add an image to HTML `` tags. - Similarly, set `favicon` in the main config, and it will be used as the site icon. +- Set `footer_content_license` and `footer_content_license_link` if you wish to display content license information in the footer. #### Disable Twitter Card diff --git a/docs/content/themes/anemone/screenshot.png b/docs/content/themes/anemone/screenshot.png index 5f27ba8b..44c39a32 100644 Binary files a/docs/content/themes/anemone/screenshot.png and b/docs/content/themes/anemone/screenshot.png differ diff --git a/docs/content/themes/anpu/index.md b/docs/content/themes/anpu/index.md index 48db0a79..0da45d85 100644 --- a/docs/content/themes/anpu/index.md +++ b/docs/content/themes/anpu/index.md @@ -3,16 +3,16 @@ title = "Anpu" description = "A port of the Hugo Anubis theme" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/zbrox/anpu-zola-theme.git" homepage = "https://github.com/zbrox/anpu-zola-theme" minimum_version = "0.11.0" license = "MIT" -demo = "https://anpu-zola-theme.netlify.app" +demo = "https://anpu-zola-theme.vercel.app" [extra.author] name = "Rostislav Raykov" diff --git a/docs/content/themes/apollo/index.md b/docs/content/themes/apollo/index.md index 39451098..880ef63f 100644 --- a/docs/content/themes/apollo/index.md +++ b/docs/content/themes/apollo/index.md @@ -3,11 +3,11 @@ title = "apollo" description = "Modern and minimalistic blog theme" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/not-matthias/apollo.git" homepage = "https://github.com/not-matthias/apollo" minimum_version = "0.14.0" @@ -66,6 +66,17 @@ cp -r themes/apollo/content content ## Options +### Comment + +You can enable comment (Giscus) for each page: + +```toml +[extra] +comment = true +``` + +And then save your script from [Giscus](https://giscus.app) to `templates/_giscus_script.html`. + ### Additional stylesheets You can add stylesheets to override the theme: diff --git a/docs/content/themes/archie-zola/index.md b/docs/content/themes/archie-zola/index.md index 206cccc2..9fc67869 100644 --- a/docs/content/themes/archie-zola/index.md +++ b/docs/content/themes/archie-zola/index.md @@ -3,16 +3,16 @@ title = "archie-zola" description = "A zola theme based on Hugo archie." template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/XXXMrG/archie-zola.git" homepage = "https://github.com/XXXMrG/archie-zola" minimum_version = "0.14.0" license = "MIT" -demo = "https://archie-zola.vercel.app/" +demo = "https://archie-zola.netlify.app/" [extra.author] name = "Keith" @@ -21,24 +21,20 @@ homepage = "https://github.com/XXXMrG" # archie-zola - A zola theme forked from [https://github.com/athul/archie](https://github.com/athul/archie) ## Demo - -The Main branch source code hosted on [https://archie-zola.vercel.app](https://archie-zola.vercel.app) +The Main branch source code hosted on [https://archie-zola.netlify.app](https://archie-zola.netlify.app) ### ScreenShot -![screenshot-light](https://archie-zola.vercel.app/screenshot/screenshot-light.png) - -![screenshot-dark](https://archie-zola.vercel.app/screenshot/screenshot-dark.png) +![screenshot-light](https://archie-zola.netlify.app/screenshot/screenshot-light.png) +![screenshot-dark](https://archie-zola.netlify.app/screenshot/screenshot-dark.png) ## Installation - First download this theme to your themes directory: ```bash @@ -53,32 +49,51 @@ git submodule add https://github.com/XXXMrG/archie-zola.git themes/archie-zola ``` and then enable it in your config.toml: + ```toml theme = "archie-zola" ``` +## Update + +If this is the first time you've checked out a repository containing this submodule, you need to initialize the submodules: + +```bash +git submodule update --init +``` + +If your project contains multiple submodules, this command initializes all of them. + +Then, update all submodule: + +```bash +git submodule update --remote +``` + +Finally, check your commit and push it. + ## Feature -* Pagination -* Tags -* Auto Dark Mode(based on system theme) -* Dark/Light Mode toggle -* Google Analytics Script -* Meta Tags For Individual Pages +- Pagination +- Tags +- Auto Dark Mode(based on system theme) +- Dark/Light Mode toggle +- Google Analytics Script +- Meta Tags For Individual Pages +- Support Latex. in the planning stage: - [ ] Custom CSS & JS - [ ] Twitter Cards & Youtube video - ## Config -### Customize `` tags +### Customize `` tags -The following TOML and YAML code will yiled two `` tags, ``, ``. +The following TOML and YAML code will yiled two `` tags, ``, ``. -TOML: +TOML: ```toml title = "post title" @@ -92,21 +107,21 @@ meta = [ ] ``` -YAML: +YAML: ```yaml title: "post title" description: "post desc" date: "2023-01-01" -extra: - meta: - - property: "og:title" - content: "the og title" - - property: "og:description" - content: "the og description" +extra: + meta: + - property: "og:title" + content: "the og title" + - property: "og:description" + content: "the og description" ``` -If the `og:title`, the `og:description`, or the "description" are not set, the page's title and description will be used. That is, the following TOML code generates ``, ``, and `` as default values. +If the `og:title`, the `og:description`, or the "description" are not set, the page's title and description will be used. That is, the following TOML code generates ``, ``, and `` as default values. ```toml title = "post title" @@ -176,11 +191,38 @@ url = "https://gitlab.com/your-name/" ``` +### Latex math formula support + +This theme support latex math formula, by using [KaTeX](https://katex.org/). + +You can enable it by add `katex_enable = true` in the `extra` section of config.toml: + +```toml +[extra] +katex_enable = true +``` + +After that, you can use latex math formula in your markdown file: + +``` +$$ +{x: \mathbf{Num},\ y: \mathbf{Num} \over x + y : \mathbf{Num} }\ (\text{N-Add}) +$$ +``` + +You can also use inline and block-style: + +``` +1. \\( \KaTeX \\) inline +2. \\[ \KaTeX \\] +3. $$ \KaTeX $$ +``` + ### Content config -**In content/posts/_index.md. I use Zola config: transparent = true to implement the pagination** +**In content/posts/\_index.md. I use Zola config: transparent = true to implement the pagination** -In Zola, you can use config in the _index.md to control pagination and sort post list: +In Zola, you can use config in the \_index.md to control pagination and sort post list: ```toml paginate_by = 3 @@ -203,7 +245,7 @@ Thank you very much for considering contributing to this project! We appreciate any form of contribution: -* New issues (feature requests, bug reports, questions, ideas, ...) -* Pull requests (documentation improvements, code improvements, new features, ...) +- New issues (feature requests, bug reports, questions, ideas, ...) +- Pull requests (documentation improvements, code improvements, new features, ...) \ No newline at end of file diff --git a/docs/content/themes/ataraxia-zola/index.md b/docs/content/themes/ataraxia-zola/index.md index 061de951..8915fed4 100644 --- a/docs/content/themes/ataraxia-zola/index.md +++ b/docs/content/themes/ataraxia-zola/index.md @@ -3,12 +3,12 @@ title = "ataraxia" description = "A personal theme focused on ease of reading." template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 -repository = "https://github.com/gersonbdev/ataraxia-zola" +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 +repository = "https://github.com/gersonbdev/ataraxia-zola.git" homepage = "https://github.com/gersonbenavides/ataraxia-zola" minimum_version = "0.16.0" license = "MPL-2.0" diff --git a/docs/content/themes/bearblog/index.md b/docs/content/themes/bearblog/index.md index 7fdde640..8d597d3a 100644 --- a/docs/content/themes/bearblog/index.md +++ b/docs/content/themes/bearblog/index.md @@ -3,12 +3,12 @@ title = "Bear" description = "Bear blog theme" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 -repository = "https://codeberg.org/alanpearce/zola-bearblog" +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 +repository = "https://codeberg.org/alanpearce/zola-bearblog.git" homepage = "https://codeberg.org/alanpearce/zola-bearblog" minimum_version = "0.4.0" license = "MIT" @@ -66,6 +66,10 @@ Please check out the included [config.toml](https://codeberg.org/alanpearce/zola 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 = "Home" +url = "/" + [[extra.main_menu]] name = "Bear" url = "@/bear.md" diff --git a/docs/content/themes/blow/index.md b/docs/content/themes/blow/index.md index e0ec5d03..5a402e3b 100644 --- a/docs/content/themes/blow/index.md +++ b/docs/content/themes/blow/index.md @@ -3,11 +3,11 @@ title = "Blow" description = "A Zola theme made with Tailwindcss" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/tchartron/blow.git" homepage = "https://github.com/tchartron/blow" minimum_version = "0.9.0" diff --git a/docs/content/themes/book/index.md b/docs/content/themes/book/index.md index 20f9971a..8bc9347c 100644 --- a/docs/content/themes/book/index.md +++ b/docs/content/themes/book/index.md @@ -3,11 +3,11 @@ title = "book" description = "A book theme inspired from GitBook/mdBook" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/getzola/book.git" homepage = "https://github.com/getzola/book" minimum_version = "0.17.0" diff --git a/docs/content/themes/boring/index.md b/docs/content/themes/boring/index.md index 24ad48a1..371ab18b 100644 --- a/docs/content/themes/boring/index.md +++ b/docs/content/themes/boring/index.md @@ -3,11 +3,11 @@ title = "boring" description = "A minimal theme" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/ssiyad/boring.git" homepage = "https://github.com/ssiyad/boring" minimum_version = "0.16.0" diff --git a/docs/content/themes/clean-blog/index.md b/docs/content/themes/clean-blog/index.md index a18cc5c2..7583911a 100644 --- a/docs/content/themes/clean-blog/index.md +++ b/docs/content/themes/clean-blog/index.md @@ -3,11 +3,11 @@ title = "Clean Blog" description = "A port of Start Bootstrap Clean Blog for Zola" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/dave-tucker/zola-clean-blog.git" homepage = "https://github.com/dave-tucker/zola-clean-blog" minimum_version = "0.4.0" diff --git a/docs/content/themes/codinfox-zola/index.md b/docs/content/themes/codinfox-zola/index.md index a119e4f8..64398564 100644 --- a/docs/content/themes/codinfox-zola/index.md +++ b/docs/content/themes/codinfox-zola/index.md @@ -3,11 +3,11 @@ title = "codinfox-zola" description = "Codinfox theme for Zola" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/svavs/codinfox-zola.git" homepage = "https://github.com/svavs/codinfox-zola" minimum_version = "0.11.0" diff --git a/docs/content/themes/d3c3nt/index.md b/docs/content/themes/d3c3nt/index.md index e3a44aae..a4b0458c 100644 --- a/docs/content/themes/d3c3nt/index.md +++ b/docs/content/themes/d3c3nt/index.md @@ -3,11 +3,11 @@ title = "d3c3nt" description = "A simple, clean, and flexible theme for personal sites." template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "git://git.figbert.com/d3c3nt.git" homepage = "https://git.figbert.com/d3c3nt/" minimum_version = "0.15.0" diff --git a/docs/content/themes/dinkleberg/index.md b/docs/content/themes/dinkleberg/index.md index ac1b1286..9a83131f 100644 --- a/docs/content/themes/dinkleberg/index.md +++ b/docs/content/themes/dinkleberg/index.md @@ -3,11 +3,11 @@ title = "dinkleberg" description = "The Rust BR theme for Gutenberg" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/rust-br/dinkleberg.git" homepage = "https://github.com/rust-br/dinkleberg" minimum_version = "0.4.0" diff --git a/docs/content/themes/docsascode-theme/index.md b/docs/content/themes/docsascode-theme/index.md index 16a75682..d341bd23 100644 --- a/docs/content/themes/docsascode-theme/index.md +++ b/docs/content/themes/docsascode-theme/index.md @@ -3,11 +3,11 @@ title = "Docsascode_theme" description = "A modern simple Zola's theme related to docs as code methodology" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/codeandmedia/zola_docsascode_theme.git" homepage = "https://github.com/codeandmedia/zola_docsascode_theme" minimum_version = "0.10.0" diff --git a/docs/content/themes/dose/index.md b/docs/content/themes/dose/index.md index f7dc9906..7f60c08a 100644 --- a/docs/content/themes/dose/index.md +++ b/docs/content/themes/dose/index.md @@ -3,11 +3,11 @@ title = "dose" description = "a small blog theme" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/oltdaniel/dose.git" homepage = "https://github.com/oltdaniel/dose" minimum_version = "0.14.0" diff --git a/docs/content/themes/duckquill/index.md b/docs/content/themes/duckquill/index.md index 484d1e7b..4172ccb7 100644 --- a/docs/content/themes/duckquill/index.md +++ b/docs/content/themes/duckquill/index.md @@ -3,11 +3,11 @@ title = "Duckquill" description = "Modern, pretty, and clean theme" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://codeberg.org/daudix/duckquill.git" homepage = "https://codeberg.org/daudix/duckquill" minimum_version = "0.17.2" @@ -19,33 +19,45 @@ name = "David Lapshin" homepage = "https://daudix.codeberg.page" +++ -# Duckquill - [![Please don't upload to GitHub](https://nogithub.codeberg.page/badge.svg)](https://nogithub.codeberg.page) -[![status-badge](https://ci.codeberg.org/api/badges/12890/status.svg)](https://ci.codeberg.org/repos/12890) +[![MIT license](https://img.shields.io/badge/License-MIT-blue)](https://mit-license.org) +[![status-badge](https://ci.codeberg.org/api/badges/13032/status.svg)](https://ci.codeberg.org/repos/13032) -[Duckquill](https://daudix.codeberg.page/duckquill) is a modern, pretty, and clean (and very opinionated) [Zola](https://www.getzola.org) theme that has the purpose of greatly simplifying the process of rolling up your blog. It aims to provide all the needed options for comfortable writing, keeping the balance of it being simple. +# [Duckquill](https://daudix.codeberg.page/duckquill/) -[![Duckquill screenshot](./screenshot.png)](https://daudix.codeberg.page/duckquill) +Duckquill is a modern, pretty, and clean (and opinionated) [Zola](https://www.getzola.org) theme that has the purpose of greatly simplifying the process of rolling up your blog. It aims to provide all the needed options for comfortable writing, keeping the balance of it being simple. + +![Screenshot](screenshot.png) ## Docs -See the [live demo](https://daudix.codeberg.page/duckquill) for the docs. +Docs are provided in form of a [live demo](https://daudix.codeberg.page/duckquill). -## Contribute +## Know your rights -If you want to improve Duckquill in any way, feel free to open an issue, or better yet, a pull request! I appreciate every contribution! +This website is under the MIT license: -## Credits +- **Freedom to Use**: You have the right to use the software for any purpose, whether it's personal, academic, or commercial. +- **Freedom to Modify**: You can modify the source code of the software to suit your needs or preferences. +- **Freedom to Distribute**: You have the right to distribute the software, whether in its original form or modified, to others. +- **Collaboration**: You can collaborate with others on the software's development and improvement. +- **No License Compatibility Issues**: You can combine the MIT-licensed software with other software, even if they use different licenses. +- **No Usage Restrictions**: There are no restrictions on the technologies or fields of use, giving you maximum flexibility. +- **No Royalties**: You are not required to pay any royalties or fees for using, modifying, or distributing the software. -- [Quill image used in the metadata card](https://commons.wikimedia.org/wiki/File:3quills.jpg) +## Contributing guidelines -## Thanks to ♥ +There are several ways to contribute to this project: -- [Jakub Steiner](https://jimmac.eu) for the [OS Component Website](https://jimmac.github.io/os-component-website), on top of which this whole thing is built -- [Cassidy James](https://cassidyjames.com) for the [Mastodon-powered Comments](https://cassidyjames.com/blog/fediverse-blog-comments-mastodon) -- [Rasmus](https://rsms.me) for the [Inter](https://rsms.me/inter/) font -- [JetBrains](https://www.jetbrains.com) for the [JetBrains Mono](https://www.jetbrains.com/lp/mono/) font -- Everyone who supported me and said good stuff <3 +- Reporting issues +- Discussing potential improvements +- Contributing code +- Writing documentation +- Submitting feature requests +- Providing feedback + +When making any sort of contribution, please make sure to follow [Forgejo's Code of Conduct](https://codeberg.org/forgejo/code-of-conduct). If you don't have the time to read it, just know that all you have to do is be nice, and you'll be just fine. + +*> with <3 by [daudix](https://daudix.codeberg.page) | README based on [libreivan's](https://codeberg.org/libreivan/libreivan.com)* \ No newline at end of file diff --git a/docs/content/themes/duckquill/screenshot.png b/docs/content/themes/duckquill/screenshot.png index 4aff71a2..cd782ac4 100644 Binary files a/docs/content/themes/duckquill/screenshot.png and b/docs/content/themes/duckquill/screenshot.png differ diff --git a/docs/content/themes/emily/index.md b/docs/content/themes/emily/index.md index b5eb1fba..fbb1b7ad 100644 --- a/docs/content/themes/emily/index.md +++ b/docs/content/themes/emily/index.md @@ -3,11 +3,11 @@ title = "emily_zola_theme" description = "a KISS theme for Zola" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/kyoheiu/emily_zola_theme.git" homepage = "https://github.com/kyoheiu/emily_zola_theme" minimum_version = "0.14.1" diff --git a/docs/content/themes/even/index.md b/docs/content/themes/even/index.md index fd219696..df906c19 100644 --- a/docs/content/themes/even/index.md +++ b/docs/content/themes/even/index.md @@ -3,11 +3,11 @@ title = "even" description = "A robust, elegant dark theme" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/getzola/even.git" homepage = "https://github.com/getzola/even" minimum_version = "0.17.0" diff --git a/docs/content/themes/feather/index.md b/docs/content/themes/feather/index.md index 90cec3e4..b44b43de 100644 --- a/docs/content/themes/feather/index.md +++ b/docs/content/themes/feather/index.md @@ -3,11 +3,11 @@ title = "feather" description = "A fuzzy blog theme" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/piedoom/feather.git" homepage = "https://github.com/piedoom/feather" minimum_version = "0.11.0" @@ -27,12 +27,49 @@ many themes created specifically for Zola). [![screenshot](screenshot.png)](https://feather.doomy.org/) -# Developing & Contributing -Because feather comes with example content, you can run the theme just like any Zola -blog with `zola serve`. +## Features + +- Fully responsive +- Designed for legibility +- All JS is non-critical and fails gracefully + +## Options +Zola allows themes to [define `[extra]` variables](https://www.getzola.org/documentation/getting-started/configuration/) +in the config. Here's a full list of theme variables with example values and comments. + +```toml +# Regular variables you might want to set... +title = "My site" # Otherwise, this will read "Home" in the nav + +[extra] +# Specify a theme +# Default: unset +# +# by default, feather enables light and dark mode +# (and switching when javascript is enabled.) +# However, if you prefer to only allow one mode, +# set this to "dark" or "light". +feather_theme = "dark" + +# Quickly insert into `
` +# Default: unset +feather_head = "" + +# Add Disqus comments +# Default: unset +# +# Adds comments to pages by providing your +# disqus domain. Comments will not appear on +# index pages, etc. +feather_disqus_domain = "mysite-com" + +# Hide the nav bottom border/background image +# Default: false +feather_hide_nav_image = true +``` # Usage -Using feather is easy. Install [Zola](https://www.getzola.org/) and follow +Using feather is easy. Install [Zola](https://www.getzola.org/) and follow [the guide for creating a site and using a theme](https://www.getzola.org/documentation/themes/installing-and-using-themes/). Then, add `theme = "feather"` to your `config.toml` file. @@ -41,16 +78,8 @@ tutorial](https://www.getzola.org/documentation/deployment/github-pages/). You can specify `tags` taxonomies . -## Options -Zola allows themes to [define `[extra]` variables](https://www.getzola.org/documentation/getting-started/configuration/) -in the config. Here's a full list of theme variables with example values and comments. - -``` -title = "My site" # Otherwise, this will read "Home" in the nav - -[extra] -feather_analytics = "" # basically just a place to put extra scripts -feather_disqus_domain = "mysite-com" # disqus embeds, if you want that -``` +# Developing & Contributing +Because feather comes with example content, you can run the theme just like any Zola +blog with `zola serve`. \ No newline at end of file diff --git a/docs/content/themes/float/index.md b/docs/content/themes/float/index.md index 4cbabdd1..5a81fe54 100644 --- a/docs/content/themes/float/index.md +++ b/docs/content/themes/float/index.md @@ -3,11 +3,11 @@ title = "Float" description = "An elegant blog theme" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://gitlab.com/float-theme/float.git" homepage = "https://gitlab.com/float-theme/float/" minimum_version = "0.15.3" diff --git a/docs/content/themes/hallo/index.md b/docs/content/themes/hallo/index.md index f8c77a62..be176c51 100644 --- a/docs/content/themes/hallo/index.md +++ b/docs/content/themes/hallo/index.md @@ -3,11 +3,11 @@ title = "hallo" description = "A single-page theme to introduce yourself." template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/flyingP0tat0/zola-hallo.git" homepage = "https://github.com/janbaudisch/zola-hallo" minimum_version = "0.4.0" diff --git a/docs/content/themes/halve-z/index.md b/docs/content/themes/halve-z/index.md index 2b9560ac..82172bda 100644 --- a/docs/content/themes/halve-z/index.md +++ b/docs/content/themes/halve-z/index.md @@ -3,12 +3,12 @@ title = "halve-z" description = "Retro two-column theme" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 -repository = "https://github.com/charlesrocket/halve-z" +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 +repository = "https://github.com/charlesrocket/halve-z.git" homepage = "https://github.com/charlesrocket/halvez" minimum_version = "0.18.0" license = "MIT" @@ -19,23 +19,28 @@ name = "-k" homepage = "https://failsafe.monster/" +++ -# halve-z +# `halve-z` [![Netlify Status](https://api.netlify.com/api/v1/badges/352a12ed-cdba-4545-9256-9fb698f5a94f/deploy-status?branch=trunk)](https://app.netlify.com/sites/halve-z/deploys) A two-column theme for **Zola**. +![logo](https://raw.githubusercontent.com/charlesrocket/halve-z/trunk/static/favicon-32x32.png) + ## Features -This is a _retro_ port of [Halve](https://github.com/TaylanTatli/Halve) for **Jekyll**. It features: +This is a _retro_ port of [Halve](https://github.com/TaylanTatli/Halve) (**Jekyll**). It features: +* search * taxonomies +* PWA (dynamic cache/offline mode) * auto color schemes * ToC +* pagination * media shortcodes * SEO * CSP * project cards -* comments ([giscus](http://giscus.app)) +* comments ([Cactus](https://gitlab.com/cactus-comments/)/[Giscus](https://github.com/giscus/giscus)) * read time ## Installation @@ -46,9 +51,17 @@ Add theme submodule using `git`: git submodule add https://github.com/charlesrocket/halve-z themes/halve-z ``` +### Updates + +Use the following command to update theme to the latest version: + +``` +git submodule update --recursive --remote +``` + ## Configuration -1. Copy theme's [config.toml](https://github.com/charlesrocket/halve-z/blob/trunk/config.toml) in your project's root directory. Set variables as required and add `theme = "halve-z"` at the **top** of the config file. +1. Copy theme's [config.toml](https://github.com/charlesrocket/halve-z/blob/trunk/config.toml) into your project's root directory. Set variables as required and add `theme = "halve-z"` at the **top** of the config file. 2. Copy the content to get started: ``` diff --git a/docs/content/themes/hephaestus/index.md b/docs/content/themes/hephaestus/index.md index 3dd62b03..865da135 100644 --- a/docs/content/themes/hephaestus/index.md +++ b/docs/content/themes/hephaestus/index.md @@ -3,11 +3,11 @@ title = "hephaestus" description = "A portfolio theme" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/BConquest/hephaestus.git" homepage = "https://github.com/BConquest/hephaestus" minimum_version = "0.4.0" diff --git a/docs/content/themes/hermit/index.md b/docs/content/themes/hermit/index.md index 72dbf8be..657f6b88 100644 --- a/docs/content/themes/hermit/index.md +++ b/docs/content/themes/hermit/index.md @@ -3,11 +3,11 @@ title = "Hermit_Zola" description = "Minimal Zola theme" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/VersBinarii/hermit_zola.git" homepage = "https://github.com/VersBinarii/hermit_zola" minimum_version = "0.4.0" diff --git a/docs/content/themes/hook/index.md b/docs/content/themes/hook/index.md index 317f5be0..ef51f4ff 100644 --- a/docs/content/themes/hook/index.md +++ b/docs/content/themes/hook/index.md @@ -3,11 +3,11 @@ title = "Hook" description = "Clean and simple personal site/blog theme" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/InputUsername/zola-hook.git" homepage = "https://github.com/InputUsername/zola-hook" minimum_version = "0.15.2" diff --git a/docs/content/themes/hyde/index.md b/docs/content/themes/hyde/index.md index 35f32a61..43e1ddf9 100644 --- a/docs/content/themes/hyde/index.md +++ b/docs/content/themes/hyde/index.md @@ -3,11 +3,11 @@ title = "hyde" description = "A classic blog theme" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/getzola/hyde.git" homepage = "https://github.com/getzola/hyde" minimum_version = "0.11.0" diff --git a/docs/content/themes/inky/index.md b/docs/content/themes/inky/index.md index 6137734e..1c1e0052 100644 --- a/docs/content/themes/inky/index.md +++ b/docs/content/themes/inky/index.md @@ -3,11 +3,11 @@ title = "Inky" description = "An elegant and understated theme for Zola" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/jimmyff/zola-inky.git" homepage = "https://github.com/jimmyff/zola-inky" minimum_version = "0.17.0" diff --git a/docs/content/themes/juice/index.md b/docs/content/themes/juice/index.md index f7b3c1d6..97ce8235 100644 --- a/docs/content/themes/juice/index.md +++ b/docs/content/themes/juice/index.md @@ -3,11 +3,11 @@ title = "juice" description = "An intuitive, elegant, and lightweight Zola theme for product sites." template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/huhu/juice.git" homepage = "https://github.com/huhu/juice" minimum_version = "0.11.0" diff --git a/docs/content/themes/kangae/index.md b/docs/content/themes/kangae/index.md index b06d97cd..c9606b83 100644 --- a/docs/content/themes/kangae/index.md +++ b/docs/content/themes/kangae/index.md @@ -3,11 +3,11 @@ title = "kangae" description = "a lightweight microblog theme for zola" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/ayushnix/kangae.git" homepage = "https://github.com/ayushnix/kangae" minimum_version = "0.15.0" diff --git a/docs/content/themes/karzok/index.md b/docs/content/themes/karzok/index.md index a12b5de1..7396bf8e 100644 --- a/docs/content/themes/karzok/index.md +++ b/docs/content/themes/karzok/index.md @@ -3,11 +3,11 @@ title = "karzok" description = "The theme for launching fast documentation sites" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/kogeletey/karzok.git" homepage = "https://github.com/kogeletey/karzok" minimum_version = "0.15.0" diff --git a/docs/content/themes/kita/index.md b/docs/content/themes/kita/index.md index 293f4646..4c5b697d 100644 --- a/docs/content/themes/kita/index.md +++ b/docs/content/themes/kita/index.md @@ -3,11 +3,11 @@ title = "Kita" description = "Kita is a clean, elegant and simple blog theme for Zola." template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/st1020/kita.git" homepage = "https://github.com/st1020/kita" minimum_version = "0.17.0" @@ -25,12 +25,14 @@ Kita is a clean, elegant and simple blog theme for Zola. This theme is based on Hugo theme [hugo-paper](https://github.com/nanxiaobei/hugo-paper) with some features added. +[Demo](https://st1020.github.io/kita/) + ![Screenshot](https://raw.githubusercontent.com/st1020/kita/main/screenshot.png) ## Features - Easy to use and modify -- No preset limits (This theme does not limit your content directory structure, taxonomy names, etc. Applicable to all zola sites.) +- No preset limits (This theme does not limit your content directory structure, taxonomy names, etc. It's applicable to all zola sites.) - Dark mode - Responsive design - Social icons diff --git a/docs/content/themes/kodama-theme/index.md b/docs/content/themes/kodama-theme/index.md index 548fc4aa..ee75b1fe 100644 --- a/docs/content/themes/kodama-theme/index.md +++ b/docs/content/themes/kodama-theme/index.md @@ -3,11 +3,11 @@ title = "kodama" description = "Theme insipired by wowchemy academic." template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/adfaure/kodama-theme.git" homepage = "https://github.com/adfaure/kodama-theme" minimum_version = "0.15" @@ -181,7 +181,7 @@ The section `blog` is the most standard section. It show a list of article with To use the blog template, configure the section with the following front matter: ```toml -template = "blog.html" +template = "section.html" page_template = "blog-page.html" ``` diff --git a/docs/content/themes/lightspeed/index.md b/docs/content/themes/lightspeed/index.md index aeea4439..f112cfe0 100644 --- a/docs/content/themes/lightspeed/index.md +++ b/docs/content/themes/lightspeed/index.md @@ -3,11 +3,11 @@ title = "lightspeed" description = "Zola theme with a perfect Lighthouse score" template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/carpetscheme/lightspeed.git" homepage = "https://github.com/carpetscheme/lightspeed" minimum_version = "0.10.0" diff --git a/docs/content/themes/mabuya/index.md b/docs/content/themes/mabuya/index.md index 784ea3b5..dd8128b8 100644 --- a/docs/content/themes/mabuya/index.md +++ b/docs/content/themes/mabuya/index.md @@ -3,64 +3,74 @@ title = "Mabuya" description = "🦎 Mabuya—a minimal Zola theme with the goal of helping you build a light and SEO-ready blog." template = "theme.html" -date = 2024-04-02T04:09:32+10:00 +date = 2024-05-03T12:02:37-07:00 [extra] -created = 2024-04-02T04:09:32+10:00 -updated = 2024-04-02T04:09:32+10:00 +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 repository = "https://github.com/semanticdata/mabuya.git" homepage = "https://github.com/semanticdata/mabuya" -minimum_version = "0.17.2" +minimum_version = "0.18.0" license = "MIT" -demo = "https://semanticdata.github.io/mabuya" +demo = "https://mabuya.vercel.app/" [extra.author] name = "Miguel Pimentel" -homepage = "https://miguelpimentel.do" +homepage = "https://miguelpimentel.do/" +++ -+
- +
-## Introduction +[Mabuya](https://mabuya.vercel.app/) is a minimal [Zola](https://www.getzola.org/) theme focused on helping you build an elegant, fast, lightweight, and SEO-ready blog. Put your work front and center with Mabuya as the base of your project. -Mabuya is a minimal [Zola](https://www.getzola.org/) theme focused on helping you build an elegant, fast, lightweight, and SEO-ready blog. Put your work front and center with Mabuya as the base of your project. +Check out the live [demo](https://mabuya.vercel.app/) of the theme. -Check out the live [demo](https://semanticdata.github.io/mabuya/) of the theme. +## Table of Contents -### Screenshots +- 🦎 Mabuya + - Table of Contents + - Screenshot + - Background + - Features and Improvements + - Running the Site Locally + - Customization + - Reporting Issues + - Contributing + - Attributions + - License + +## Screenshot -### Start of Mabuya +## Background While searching for themes, I came across [Zola Tale](https://github.com/aaranxu/tale-zola). Sadly, the project's last update was on Dec 4, 2021. Shortly after, I decided to fork the project and add my own touches to it. -### Where The Name Comes From - The name Mabuya comes from the [Mabuya hispaniolae](https://en.wikipedia.org/wiki/Mabuya_hispaniolae?useskin=vector), a possibly extinct[^1] species of skink endemic to the Dominican Republic, my home country. ## Features and Improvements -While working on the theme, I have added new functionality and many quality of life improvements. Here's a short non-inclusive list: +While working on the theme, I have added new functionality and made many quality of life improvements. Here's a short list: -- Fully refactored stylesheets. -- Added Dark theme and color scheme toggle. +- Refactored stylesheets. +- Added Dark theme and color theme toggle. - Added new footer navigation. -- Created a custom GitHub Action to deploy Zola sites. It is faster than any other in GitHub Actions doing the same. +- Created a custom GitHub Action to deploy Zola sites faster than any other GitHub Actions using Docker. - Refined page transitions from desktop to mobile and viceversa. -- Centralized custom variables. Made it easier to customize make color changes to the site. -- Addressed PR [#7](https://github.com/aaranxu/tale-zola/pull/7). Fixes pagination problem addressed since the theme was updated. -- Addressed (temporarily) Issue [#1](https://github.com/aaranxu/tale-zola/issues/1) by removing the erroneous pinned marker. I have yet to implement it in this theme. +- Centralized custom variables–made it easier to customize the site's colors. +- Addressed PR [#7](https://github.com/aaranxu/tale-zola/pull/7) fixing the pagination problem present in the original Zola theme. - Addressed Issue [#4](https://github.com/aaranxu/tale-zola/issues/4) fixing custom text not being used correctly. -- Optimized for speed and Accesibility. +- Addressed (temporarily) Issue [#1](https://github.com/aaranxu/tale-zola/issues/1) by removing the erroneous pinned marker. +- Optimized for speed and accessibility. Subtle color changes to make the text more readable, etc. - Many other small improvements... ## Running the Site Locally @@ -91,7 +101,7 @@ A short list of commands that will help you develop your own version of the them | Command | Description | | -------------------------- | -------------------------- | -| `zola init
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ + + + + +
+ +[Minimal](https://zola-minimal.vercel.app/) is a [Zola](https://www.getzola.org) theme with the goal of helping you build a light, fast, and SEO ready landing page or website. It is based on the [Jekyll](https://jekyllrb.com/) theme with [the same name](https://github.com/pages-themes/minimal). + +Check out the [demo](https://zola-minimal.vercel.app/). + +## Table of Contents + +- 📚 Minimal + - Table of Contents + - Screenshots + - Getting Started + - Configuration + - Reporting Issues + - Attributions + - License + +## Screenshots + +![theme screenshot](screenshot.png) + +## Getting Started + +Tips that will help you develop and preview the site locally. + +### Requirements + +Before using the theme, you need to install [Zola](https://www.getzola.org/documentation/getting-started/installation/) ≥ 0.18.0. + +### Quick Start + +```sh +# Clone the repo +git clone git@github.com:semanticdata/zola-minimal.git + +# Change directory into the cloned folder +cd zola-minima + +# Serve the site locally +zola serve + +# Open http://127.0.0.1:1111/ in the browser +``` + +For more detailed instructions, visit the [Documentation](https://www.getzola.org/documentation/themes/installing-and-using-themes/) page about installing and using themes. + +### Useful Commands + +A short list of commands that will help you develop your own version of the theme. + +| Command | Description | +| ----------------------- | ---------------------- | +| `zola init