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. 💖 - +Samuel Henrique --- 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/) Logo -[![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/" +++ -

🦎 Mabuya

+# 🦎 Mabuya -

+

- +

-## 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 Website 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 ` | Initiate new Zola site | +| `zola init ` | Initiate new Zola site | | `zola build` | Build only | | `zola serve` | Build and Serve | @@ -115,19 +125,17 @@ If your problem or idea is not addressed yet, [open a new issue](https://github. We'd love your help! Please see [CONTRIBUTING](./CONTRIBUTING.md) to learn about the kinds of contributions we're looking for. -Please read and be aware of the [Code of Conduct](.github/CODE_OF_CONDUCT.md) before conttributing. +Please read and be aware of the [Code of Conduct](.github/CODE_OF_CONDUCT.md) before contributing. -## Acknowledgements and Attributions +## Attributions -Mabuya is a fork of [Tale](https://github.com/aaranxu/tale-zola), which is a port of the Jekyll theme [Tale](https://github.com/chesterhow/tale)—a now Archived repository. +Mabuya is a fork of [Tale](https://github.com/aaranxu/tale-zola), which itself is a port of the Jekyll theme [Tale](https://github.com/chesterhow/tale) which is now archived. The icons used throughout the site are kindly provided by [UXWing](https://uxwing.com/license/). Read their [license](https://uxwing.com/license/). -Other icons used come from [Remix Icon](https://remixicon.com/). Check out their [license](https://remixicon.com/license). - ## License -Source code in this repository is available under the [MIT](LICENSE) license. You are free to use this code however you like. That said, some acknowledgement would be well received. +Source code in this repository is available under the [MIT License](LICENSE). [^1]: *Mabuya hispaniolae*'s conservation status is *Critically endangered, possibly extinct*. diff --git a/docs/content/themes/minimal-dark/index.md b/docs/content/themes/minimal-dark/index.md index 037f798f..d9fd679b 100644 --- a/docs/content/themes/minimal-dark/index.md +++ b/docs/content/themes/minimal-dark/index.md @@ -3,13 +3,13 @@ title = "minimal-dark" description = "Clean and minimalistic 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/kuznetsov17/minimal-dark.git" -homepage = "https://github.com/getzola/minimal-dark" +homepage = "https://github.com/kuznetsov17/minimal-dark" minimum_version = "0.18.0" license = "MIT" demo = "https://kuznetsov17.github.io/minimal-dark/" @@ -19,11 +19,17 @@ name = "Vitaliy Kuznetsov" homepage = "https://viku.me" +++ +[![Deploy Zola with GitHub Pages](https://github.com/kuznetsov17/minimal-dark/actions/workflows/zola-build.yml/badge.svg)](https://github.com/kuznetsov17/minimal-dark/actions/workflows/zola-build.yml) + # General I am not the best webmaster, but should be somewhat responsive. -I intentionally using the bigger fonts to make, feel free to change it in main.css +I intentionally using the bigger fonts to make, feel free to change it in main.scss + + +# Light mode +Now light mode also supported. # Important Please make sure to set up your base_url with trailing slash: @@ -49,9 +55,10 @@ crossorigin="anonymous" nonce="" ``` -# Page configurations +# Page onfigurations Customize the page blocks by setting configuration in **[extra]** section: ```toml +copyright_string = "Сreated in %YEAR% for fun." # the string displayed in footer. %YEAR% is replaced by current year on build show_copyright = true / false # enables / disables footer with copyright show_comments = true / false # enables / disables comments show_shares = true / false # enables / disables section with social share buttons @@ -75,6 +82,40 @@ copyright_string = "Сreated by John Doe in 2024 – %YEAR% for fun." # footer c nonce = "${SOME_HASH_VALUE}" # used for JavaScript src nonce ``` +# Shortcodes + +## Callouts +``` +{%/* callout(type = 'warning') */%} +This is an example of **Warning** callout. [Some link](#) +{%/* end */%} +{%/* callout(type = 'alert') */%} +This is an example of **Alert** callout. [Some link](#) +{%/* end */%} +{%/* callout(type = 'info') */%} +This is an example of **Info** callout. [Some link](#) +{%/* end */%} +``` +## Timeline +``` +{%/* timeline() */%} +[{ + "title":"Lorem Ipsum Event", + "body":"Lorem Ipsum is simply dummy text of the printing and typesetting industry.", + "date":"Jul-2023" +}, +{ + "title":"Lorem Ipsum event 2", + "body":"Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book. It has survived not only five centuries, but also the leap into electronic typesetting, remaining essentially unchanged.", + "date":"Jun-2022" +}] +{%/* end */%} +``` + +# Thanks to + - [Giscuss](https://giscuss.app) for excellent comments system + - [bootstrap icons](https://icons.getbootstrap.com) for great social icons + # Screenshot ![Screenshot](https://github.com/kuznetsov17/minimal-dark/blob/main/screenshot.png?raw=true) diff --git a/docs/content/themes/minimal-dark/screenshot.png b/docs/content/themes/minimal-dark/screenshot.png index a43c086c..c1bbdf19 100644 Binary files a/docs/content/themes/minimal-dark/screenshot.png and b/docs/content/themes/minimal-dark/screenshot.png differ diff --git a/docs/content/themes/nasm-theme/index.md b/docs/content/themes/nasm-theme/index.md index d5e8a7a6..03dfde7a 100644 --- a/docs/content/themes/nasm-theme/index.md +++ b/docs/content/themes/nasm-theme/index.md @@ -3,11 +3,11 @@ title = "nasm-theme" description = "A robust, elegant blue 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/lucasnasm/nasm-theme.git" homepage = "https://github.com/lucasnasm/nasm-theme" minimum_version = "0.1.0" diff --git a/docs/content/themes/no-style-please/index.md b/docs/content/themes/no-style-please/index.md index c5f15977..b71b9089 100644 --- a/docs/content/themes/no-style-please/index.md +++ b/docs/content/themes/no-style-please/index.md @@ -3,11 +3,11 @@ title = "no style, please!" description = "A (nearly) no-CSS, fast, minimalist 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://gitlab.com/4bcx/no-style-please.git" homepage = "https://gitlab.com/atgumx/no-style-please" minimum_version = "0.4.0" diff --git a/docs/content/themes/ntun/index.md b/docs/content/themes/ntun/index.md index 19aea11a..1503ddad 100644 --- a/docs/content/themes/ntun/index.md +++ b/docs/content/themes/ntun/index.md @@ -3,11 +3,11 @@ title = "ntun-zola-theme" description = "A classic resume 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/Netoun/ntun.git" homepage = "https://github.com/netoun/ntun" minimum_version = "0.1.0" diff --git a/docs/content/themes/oceanic-zen/index.md b/docs/content/themes/oceanic-zen/index.md index 434094be..fa8d063d 100644 --- a/docs/content/themes/oceanic-zen/index.md +++ b/docs/content/themes/oceanic-zen/index.md @@ -3,11 +3,11 @@ title = "Oceanic Zen" description = "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/barlog-m/oceanic-zen.git" homepage = "https://github.com/barlog-m/oceanic-zen" minimum_version = "0.12.0" diff --git a/docs/content/themes/otherworld/index.md b/docs/content/themes/otherworld/index.md index b2184950..c188ee92 100644 --- a/docs/content/themes/otherworld/index.md +++ b/docs/content/themes/otherworld/index.md @@ -3,11 +3,11 @@ title = "otherworld" description = "Vaporwave aesthetic 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://git.blek.codes/blek/otherworld.git" homepage = "https://git.blek.codes/blek/otherworld" minimum_version = "0.1.0" diff --git a/docs/content/themes/papaya/index.md b/docs/content/themes/papaya/index.md index 03f4d352..385f0d84 100644 --- a/docs/content/themes/papaya/index.md +++ b/docs/content/themes/papaya/index.md @@ -3,11 +3,11 @@ title = "Papaya" description = "A clean Zola theme for blogging and projects" 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/justint/papaya.git" homepage = "https://github.com/justint/papaya" minimum_version = "0.16.1" diff --git a/docs/content/themes/papermod/index.md b/docs/content/themes/papermod/index.md index 199f55aa..aca6ba6b 100644 --- a/docs/content/themes/papermod/index.md +++ b/docs/content/themes/papermod/index.md @@ -3,11 +3,11 @@ title = "PaperMod" description = "A fast, clean, responsive theme ported to 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/cydave/zola-theme-papermod.git" homepage = "https://github.com/cydave/zola-theme-papermod" minimum_version = "0.4.0" diff --git a/docs/content/themes/particle/index.md b/docs/content/themes/particle/index.md index 256218c7..a414d7b8 100644 --- a/docs/content/themes/particle/index.md +++ b/docs/content/themes/particle/index.md @@ -3,11 +3,11 @@ title = "particle" description = "Particle 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/particle-zola.git" homepage = "https://github.com/svavs/particle-zola" minimum_version = "0.16.1" diff --git a/docs/content/themes/pico/index.md b/docs/content/themes/pico/index.md index d164fee0..8cf11262 100644 --- a/docs/content/themes/pico/index.md +++ b/docs/content/themes/pico/index.md @@ -1,13 +1,13 @@ +++ title = "pico" -description = "One more minimalistic theme for Zola" +description = "Clean and minimalistic 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/kuznetsov17/pico.git" homepage = "https://github.com/kuznetsov17/pico" minimum_version = "0.18.0" @@ -147,7 +147,8 @@ graph LR # Thanks to - [Giscuss](https://giscuss.app) for excellent comments system - [bootstrap icons](https://icons.getbootstrap.com) for great social icons - - [Google Fonts](https://fonts.google.com/specimen/Urbanist) for Urbanist font + - [Urbanist Font](https://fonts.google.com/specimen/Urbanist) + - [Mulush Font](https://fonts.google.com/specimen/Mulish) # Screenshot ![Screenshot](https://github.com/kuznetsov17/pico/blob/main/screenshot.png?raw=true) diff --git a/docs/content/themes/polymathic/index.md b/docs/content/themes/polymathic/index.md index d390ebc3..25cc1322 100644 --- a/docs/content/themes/polymathic/index.md +++ b/docs/content/themes/polymathic/index.md @@ -3,12 +3,12 @@ title = "polymathic" description = "A portfolio theme for person of many talents" 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/anvlkv/polymathic" +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 +repository = "https://github.com/anvlkv/polymathic.git" homepage = "https://github.com/anvlkv/polymathic" minimum_version = "0.17.2" license = "MIT" @@ -23,12 +23,14 @@ homepage = "https://a.nvlkv.xyz" polymathic - Zola portfolio theme for those with many talents | Product Hunt -polymathic is a [Zola](https://www.getzola.org/) portfolio theme. +polymathic is a [Zola](https://www.getzola.org/) portfolio (and not only) theme. I made it for my own portfolio. The theme is called `polymathic`, inspired by individuals with a wide range of talents. The theme focuses on rich and consistent navigation experience, exposing the variety of topics to chose from, yet allowing the user to focus on a single thread of your story once they've made a choice. Docs and theme demo are available here [main--polymathic-demo.netlify.app](https://main--polymathic-demo.netlify.app/) +__Be sure to chek the [demo repo](https://github.com/anvlkv/polymathic-demo/)__ and follow zola docs on [installing and using a theme](https://www.getzola.org/documentation/themes/installing-and-using-themes/#installing-a-theme) + This theme uses [Bulma](https://bulma.io/) scss framework, making the theme styles highly customizable and enabling mobile first theme design. This theme uses [Animate.css](https://animate.style) for animations. diff --git a/docs/content/themes/resume/index.md b/docs/content/themes/resume/index.md index 043799d2..14b4ea4a 100644 --- a/docs/content/themes/resume/index.md +++ b/docs/content/themes/resume/index.md @@ -3,11 +3,11 @@ title = "resume" description = "A resume 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/AlongWY/zola-resume.git" homepage = "https://github.com/alongwy/zola-resume" minimum_version = "0.11.0" diff --git a/docs/content/themes/sam/index.md b/docs/content/themes/sam/index.md index 2630ddb7..90128b25 100644 --- a/docs/content/themes/sam/index.md +++ b/docs/content/themes/sam/index.md @@ -3,11 +3,11 @@ title = "sam" description = "A Simple and Minimalist theme with a focus on typography and content." 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/janbaudisch/zola-sam.git" homepage = "https://github.com/janbaudisch/zola-sam" minimum_version = "0.4.0" diff --git a/docs/content/themes/seagull/index.md b/docs/content/themes/seagull/index.md index 792c97b3..9e6d671a 100644 --- a/docs/content/themes/seagull/index.md +++ b/docs/content/themes/seagull/index.md @@ -3,11 +3,11 @@ title = "Seagull" description = "A 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://git.42l.fr/HugoTrentesaux/seagull.git" homepage = "https://git.42l.fr/HugoTrentesaux/seagull" minimum_version = "0.17.0" diff --git a/docs/content/themes/seje2/index.md b/docs/content/themes/seje2/index.md index 3b9f4a8b..5771f1bd 100644 --- a/docs/content/themes/seje2/index.md +++ b/docs/content/themes/seje2/index.md @@ -3,12 +3,12 @@ title = "Seje2" description = "A beautiful 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 -repository = "https://github.com/eatradish/seje2" +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 +repository = "https://github.com/eatradish/seje2.git" homepage = "https://github.com/eatradish/Seje2" minimum_version = "0.15.0" license = "MIT" diff --git a/docs/content/themes/serene/index.md b/docs/content/themes/serene/index.md index d3ffc9b6..32271e77 100644 --- a/docs/content/themes/serene/index.md +++ b/docs/content/themes/serene/index.md @@ -3,31 +3,32 @@ title = "serene" description = "A blog theme for zola, simple and clean" 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/isunjn/serene.git" homepage = "https://github.com/isunjn/serene" minimum_version = "0.9.0" license = "MIT" -demo = "https://serene-demo-site.vercel.app" +demo = "https://serene-demo.pages.dev" [extra.author] name = "isunjn" homepage = "https://github.com/isunjn" +++ -screenshot +screenshot -

+
+
A blog theme for [zola](https://www.getzola.org), simple and clean ## Demo -- +- ## Features @@ -37,9 +38,9 @@ A blog theme for [zola](https://www.getzola.org), simple and clean - Image zooming - Out-of-date alert - Sticky table-of-contents -- Callouts (note, warning, alert, etc.) +- Callout (note, warning, alert, etc.) - Comments using [Giscus](https://giscus.app) -- Mathematical notations using [KaTeX](https://katex.org) +- Mathematical notations using [KaTeX](https://katex.org) or [Typst](https://typst.app) - Diagrams and visualizations using [Mermaid](https://github.com/mermaid-js/mermaid) ## Usage @@ -47,8 +48,4 @@ A blog theme for [zola](https://www.getzola.org), simple and clean - Check the [USAGE.md](https://github.com/isunjn/serene/blob/latest/USAGE.md) of `latest` branch - Also available in Simplified Chinese: [USAGE-zh_CN.md](https://github.com/isunjn/serene/blob/latest/USAGE-zh_CN.md) (简体中文) -## Contributing - -- Before you make any non-trivial changes, you may want to open an issue so we can discuss - \ No newline at end of file diff --git a/docs/content/themes/serene/screenshot.png b/docs/content/themes/serene/screenshot.png index 0c7e33d6..2edce87d 100644 Binary files a/docs/content/themes/serene/screenshot.png and b/docs/content/themes/serene/screenshot.png differ diff --git a/docs/content/themes/shadharon/index.md b/docs/content/themes/shadharon/index.md index cfeb2b3b..f4ec72a5 100644 --- a/docs/content/themes/shadharon/index.md +++ b/docs/content/themes/shadharon/index.md @@ -3,12 +3,12 @@ title = "shadharon" description = "Simple blog theme powered by 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 -repository = "https://github.com/syedzayyan/shadharon" +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 +repository = "https://github.com/syedzayyan/shadharon.git" homepage = "https://github.com/syedzayyan/shadharon" minimum_version = "0.4.0" license = "MIT" diff --git a/docs/content/themes/simple-dev-blog/index.md b/docs/content/themes/simple-dev-blog/index.md index e75fd376..bf0bc3a1 100644 --- a/docs/content/themes/simple-dev-blog/index.md +++ b/docs/content/themes/simple-dev-blog/index.md @@ -3,11 +3,11 @@ title = "simple-dev-blog" description = "A simple dev blog theme with no javascript, prerendered linked pages and SEO tags." 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/bennetthardwick/simple-dev-blog-zola-starter.git" homepage = "https://github.com/bennetthardwick/simple-dev-blog-zola-starter" minimum_version = "0.4.0" diff --git a/docs/content/themes/slim/index.md b/docs/content/themes/slim/index.md index 9380e732..a10c55a2 100644 --- a/docs/content/themes/slim/index.md +++ b/docs/content/themes/slim/index.md @@ -3,11 +3,11 @@ title = "Slim" description = "Slim is a minimal, clean and beautiful 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/jameshclrk/zola-slim.git" homepage = "https://github.com/jameshclrk/zola-slim" minimum_version = "0.8.0" diff --git a/docs/content/themes/soapstone/index.md b/docs/content/themes/soapstone/index.md index 5c74673c..09e3be57 100644 --- a/docs/content/themes/soapstone/index.md +++ b/docs/content/themes/soapstone/index.md @@ -3,11 +3,11 @@ title = "Soapstone" description = "A bare bones dark theme with some color tweakability" 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/MattyRad/soapstone.git" homepage = "https://github.com/MattyRad/soapstone" minimum_version = "0.4.0" diff --git a/docs/content/themes/solar-theme-zola/index.md b/docs/content/themes/solar-theme-zola/index.md index 2b569c73..b05e2fef 100644 --- a/docs/content/themes/solar-theme-zola/index.md +++ b/docs/content/themes/solar-theme-zola/index.md @@ -3,11 +3,11 @@ title = "solar-theme-zola" description = "A port of solar-theme-hugo 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/hulufei/solar-theme-zola.git" homepage = "https://github.com/hulufei/solar-theme-zola" minimum_version = "0.4.0" diff --git a/docs/content/themes/tabi/index.md b/docs/content/themes/tabi/index.md index acfa981f..acb56ac2 100644 --- a/docs/content/themes/tabi/index.md +++ b/docs/content/themes/tabi/index.md @@ -3,11 +3,11 @@ title = "tabi" description = "A fast, lightweight, and modern Zola theme with multi-language support, optional JavaScript, and 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/welpo/tabi.git" homepage = "https://github.com/welpo/tabi" minimum_version = "0.17.0" @@ -19,6 +19,26 @@ name = "Óscar Fernández" homepage = "https://osc.garden" +++ +

+ + PRs welcome + + Contributors + + Forks + + Last commit +
+ + Latest release + + Documentation + + License + + Clean commits +

+ # tabi A fast, lightweight, and modern [Zola](https://www.getzola.org) theme with multi-language support. It aims to be a personal page and home to blog posts. @@ -27,7 +47,7 @@ See a live preview (and the theme's documentation) [here](https://welpo.github.i Explore the Sites Using tabi section to see real-world applications. -> tabi (旅): Journey. +> tabi (旅, /tɐˈbi/): Journey. ![tabi](https://github.com/welpo/tabi/raw/main/light_dark_screenshot.png) @@ -38,7 +58,7 @@ tabi has a perfect score on Google's Lighthouse audit: ## Features - [X] [Set any language as default](https://welpo.github.io/tabi/blog/faq-languages/#how-do-i-set-a-default-language-for-my-site). Set your base site to Chinese, Spanish, French, Hindi… or any [other supported language](/i18n). The theme's interface will be translated accordingly. -- [X] [Integration with remote repositories](https://welpo.github.io/tabi/mastering-tabi-settings/#git-repository-integration) on GitHub, GitLab, Gitea & Codeberg for commit history and showing the site source. +- [X] [Integration with remote repositories](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#git-repository-integration) on GitHub, GitLab, Gitea & Codeberg for commit history and showing the site source. - [X] Dark and light themes. Defaults to the OS setting, with a switcher in the navigation bar. - [X] Thorough documentation. See [Mastering tabi Settings: A Comprehensive Guide](https://welpo.github.io/tabi/blog/mastering-tabi-settings/). - [X] Perfect Lighthouse score (Performance, Accessibility, Best Practices and SEO). @@ -67,18 +87,6 @@ tabi has a perfect score on Google's Lighthouse audit: - [X] [Social links](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#social-media-icons). - [X] [Tags](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#tags). -## Quick start - -Once you have installed Zola 0.17.0 or newer: - -```bash -git clone https://github.com/welpo/tabi.git -cd tabi -zola serve -``` - -Open http://127.0.0.1:1111 in the browser. - ## Installation To add tabi to you existing Zola site: @@ -115,7 +123,15 @@ theme = "tabi" title = "Your Site Title" ``` -4. Create a `content/_index.md` file with the following content: +4. Configure code block highlighting in your `config.toml`: + +```toml +[markdown] +highlight_code = true +highlight_theme = "css" +``` + +5. Create a `content/_index.md` file with the following content: ``` +++ @@ -132,7 +148,7 @@ If you want to serve your blog posts from a different path, such as `blog/`, add section_path = "blog/_index.md" ``` -5. If you want an introduction section (see screenshot above), add these lines to `content/_index.md`: +6. If you want an introduction section (see screenshot above), add these lines to `content/_index.md`: ``` [extra] @@ -141,7 +157,7 @@ header = {title = "Hello! I'm tabi~", img = "img/main.webp", img_alt = "Your Nam The content outside the front matter will be rendered between the header title and the posts listing. In the screenshot above, it's the text that reads "tabi is a fast, lightweight, and modern Zola theme…". -6. If you want a multilingual site, you will need to set up each language. In `config.toml`, set the title and taxonomies for each language, like: +7. If you want a multilingual site, you will need to set up each language. In `config.toml`, set the title and taxonomies for each language, like: ```toml [languages.es] @@ -164,9 +180,9 @@ To learn more about multilingual support, see the [Frequently Asked Questions](h | [osc.garden](https://osc.garden) | Óscar Fernández ([welpo](https://github.com/welpo)) | Data science, psychology, and Zola | [Source](https://github.com/welpo/osc.garden) | | [sandip.live](https://sandip.live) | Sandip G ([sandman](https://github.com/sandman)) | Startups, tech and the good life | [Source](https://github.com/sandman/sandman.github.io) | | [seadve.github.io](https://seadve.github.io/) | Dave Patrick Caberto ([SeaDve](https://github.com/SeaDve/)) | Personal blog and portfolio with custom CSS | [Source](https://github.com/SeaDve/seadve.github.io) | -| [donovan.is](https://donovan.is) | [Donovan Glover](https://github.com/donovanglover) | Linux, Rust, and Full Stack Web Development | [Source](https://github.com/donovanglover/donovan.is) | | [mikufan.page](https://mikufan.page) | [Nadia](https://github.com/nyadiia) | Personal blog | [Source](https://github.com/nyadiia/mikufan.page) | | [tim-boettcher.online](https://tim-boettcher.online/) | [Tim Böttcher](https://codeberg.org/Tim-Boettcher/) | Insights and ramblings of a deafblind programmer | [Source](https://codeberg.org/Tim-Boettcher/tim-boettcher-online/) | +| [www.richtman.au](https://www.richtman.au) | [Ariel Richtman](https://github.com/arichtman) | Personal tech blog | [Source](https://github.com/arichtman/www.richtman.au) | Using tabi? Feel free to create a PR and add your site to this list. diff --git a/docs/content/themes/tabi/screenshot.png b/docs/content/themes/tabi/screenshot.png index 06099755..43e06e53 100644 Binary files a/docs/content/themes/tabi/screenshot.png and b/docs/content/themes/tabi/screenshot.png differ diff --git a/docs/content/themes/tale-zola/index.md b/docs/content/themes/tale-zola/index.md index 91ca7b31..7ffc784d 100644 --- a/docs/content/themes/tale-zola/index.md +++ b/docs/content/themes/tale-zola/index.md @@ -3,11 +3,11 @@ title = "tale-zola" description = "Tala-Zola is a minimal Zola theme helping you to build a nice 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/aaranxu/tale-zola.git" homepage = "https://github.com/aaranxu/tale-zola" minimum_version = "0.13.0" diff --git a/docs/content/themes/tilde/index.md b/docs/content/themes/tilde/index.md index ad4247a3..2f5e5fd2 100644 --- a/docs/content/themes/tilde/index.md +++ b/docs/content/themes/tilde/index.md @@ -3,11 +3,11 @@ title = "tilde" description = "Simple theme to match the dracula tilde 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://git.sr.ht/~savoy/tilde" homepage = "https://git.sr.ht/~savoy/tilde" minimum_version = "0.4.0" diff --git a/docs/content/themes/toucan/index.md b/docs/content/themes/toucan/index.md index 9b12a9ca..c35d704a 100644 --- a/docs/content/themes/toucan/index.md +++ b/docs/content/themes/toucan/index.md @@ -3,11 +3,11 @@ title = "Toucan" description = "Inspired from Pelican default 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://git.42l.fr/HugoTrentesaux/toucan.git" homepage = "https://git.42l.fr/HugoTrentesaux/toucan" minimum_version = "0.8.0" diff --git a/docs/content/themes/tranquil/index.md b/docs/content/themes/tranquil/index.md index caf27717..9957474e 100644 --- a/docs/content/themes/tranquil/index.md +++ b/docs/content/themes/tranquil/index.md @@ -3,11 +3,11 @@ title = "tranquil" description = "A blog theme for zola, simple and clean" 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/TeaDrinkingProgrammer/tranquil.git" homepage = "https://github.com/TeaDrinkingProgrammer/tranquil" minimum_version = "0.9.0" diff --git a/docs/content/themes/zerm/index.md b/docs/content/themes/zerm/index.md index 083c0267..6738e9ed 100644 --- a/docs/content/themes/zerm/index.md +++ b/docs/content/themes/zerm/index.md @@ -3,11 +3,11 @@ title = "zerm" description = "A minimalistic and dark theme based on Radek Kozieł's theme for Hugo" 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/ejmg/zerm.git" homepage = "https://github.com/ejmg/zerm" minimum_version = "0.8.0" diff --git a/docs/content/themes/zhuia/index.md b/docs/content/themes/zhuia/index.md index 80299935..14305216 100644 --- a/docs/content/themes/zhuia/index.md +++ b/docs/content/themes/zhuia/index.md @@ -3,11 +3,11 @@ title = "Zhuia" description = "An elegant but still playful 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/gicrisf/zhuia.git" homepage = "https://github.com/gicrisf/zhuia" minimum_version = "0.15.0" diff --git a/docs/content/themes/zola-henry/index.md b/docs/content/themes/zola-henry/index.md index 0930cb16..21177c7a 100644 --- a/docs/content/themes/zola-henry/index.md +++ b/docs/content/themes/zola-henry/index.md @@ -3,11 +3,11 @@ title = "henry" description = "A timeless 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/sirodoht/zola-henry.git" homepage = "https://github.com/sirodoht/zola-henry" minimum_version = "0.4.0" diff --git a/docs/content/themes/zola-minimal/index.md b/docs/content/themes/zola-minimal/index.md new file mode 100644 index 00000000..bf4babc4 --- /dev/null +++ b/docs/content/themes/zola-minimal/index.md @@ -0,0 +1,109 @@ + ++++ +title = "Minimal" +description = "📚 Minimal is a Zola port of the Jekyll theme with the same name." +template = "theme.html" +date = 2024-05-03T12:02:37-07:00 + +[extra] +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 +repository = "https://github.com/semanticdata/zola-minimal.git" +homepage = "https://github.com/semanticdata/zola-minimal/" +minimum_version = "0.18.0" +license = "MIT" +demo = "https://zola-minimal.vercel.app/" + +[extra.author] +name = "Miguel Pimentel" +homepage = "https://miguelpimentel.do/" ++++ + +# 📚 Minimal + +

+ + + + + +

+ +[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 ` | Initiate new Zola site | +| `zola build` | Build only | +| `zola serve` | Build and Serve | + +## Configuration + +You can changed the configuration, templates and content yourself. Refer to the `config.toml`, and templates files for ideas. In most cases you only need to modify the contents of `config.toml` to customize the appearance of your blog. Make sure to visit the [Zola Documentation](https://www.getzola.org/documentation/getting-started/overview/). + +### Custom CSS Styles + +Adding custom CSS is as easy as adding your styles to `sass/_custom.scss`. This is made possible because SCSS files are backwards compatible with CSS. This means you can type normal CSS code into a SCSS file and it will be valid. + +## Reporting Issues + +We use GitHub Issues as the official bug tracker for **Minimal**. Please +search [existing issues](https://github.com/semanticdata/zola-minimal/issues). It’s possible someone has already reported the same problem. + +If your problem or idea is not addressed yet, [open a new issue](https://github.com/semanticdata/zola-minimal/issues/new). + +## Attributions + +Zola Minimal is a fork of the Jekyll theme [Minimal](https://github.com/pages-themes/minimal). + +## License + +Source code in this repository is available under the [MIT License](LICENSE). + + \ No newline at end of file diff --git a/docs/content/themes/zola-minimal/screenshot.png b/docs/content/themes/zola-minimal/screenshot.png new file mode 100644 index 00000000..45ec812c Binary files /dev/null and b/docs/content/themes/zola-minimal/screenshot.png differ diff --git a/docs/content/themes/zola-paper/index.md b/docs/content/themes/zola-paper/index.md index e83f03a2..2c3a3936 100644 --- a/docs/content/themes/zola-paper/index.md +++ b/docs/content/themes/zola-paper/index.md @@ -3,11 +3,11 @@ title = "zola-paper" description = "A clean theme inspired from hugo-paper." 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/schoenenberg/zola-paper.git" homepage = "https://github.com/schoenenberg/zola-paper" minimum_version = "0.11.0" diff --git a/docs/content/themes/zola-pickles/index.md b/docs/content/themes/zola-pickles/index.md index 0659a77a..a7942b8c 100644 --- a/docs/content/themes/zola-pickles/index.md +++ b/docs/content/themes/zola-pickles/index.md @@ -3,16 +3,16 @@ title = "pickles" description = "A modern, simple, clean 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/lukehsiao/zola-pickles.git" homepage = "https://github.com/lukehsiao/zola-pickles" minimum_version = "0.13.0" license = "BlueOak-1.0.0" -demo = "https://effervescent-chebakia-056748.netlify.app/" +demo = "https://zola-pickles.pages.dev/" [extra.author] name = "Luke Hsiao" @@ -28,7 +28,7 @@ homepage = "https://luke.hsiao.dev"
- + demo website License diff --git a/docs/content/themes/zola-theme-course/index.md b/docs/content/themes/zola-theme-course/index.md index d8307a8c..6390bf0b 100644 --- a/docs/content/themes/zola-theme-course/index.md +++ b/docs/content/themes/zola-theme-course/index.md @@ -3,11 +3,11 @@ title = "Course" description = "A zola theme designed for online courses or tutorials" 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/elegaanz/zola-theme-course.git" homepage = "https://github.com/elegaanz/zola-theme-course" minimum_version = "0.17.1" diff --git a/docs/content/themes/zola-theme-hikari/index.md b/docs/content/themes/zola-theme-hikari/index.md index 298b5c8c..123d6b7e 100644 --- a/docs/content/themes/zola-theme-hikari/index.md +++ b/docs/content/themes/zola-theme-hikari/index.md @@ -3,11 +3,11 @@ title = "Hikari" description = "Fluid, responsive 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/waynee95/zola-theme-hikari.git" homepage = "https://github.com/waynee95/zola-theme-hikari" minimum_version = "0.5.1" diff --git a/docs/content/themes/zola-theme-terminimal/index.md b/docs/content/themes/zola-theme-terminimal/index.md index 6e82aeb7..6392a153 100644 --- a/docs/content/themes/zola-theme-terminimal/index.md +++ b/docs/content/themes/zola-theme-terminimal/index.md @@ -3,11 +3,11 @@ title = "terminimal" description = "A simple, minimal retro 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/pawroman/zola-theme-terminimal.git" homepage = "https://github.com/pawroman/zola-theme-terminimal" minimum_version = "0.11.0" diff --git a/docs/content/themes/zola.386/index.md b/docs/content/themes/zola.386/index.md index a8acb8d9..4397cbd0 100644 --- a/docs/content/themes/zola.386/index.md +++ b/docs/content/themes/zola.386/index.md @@ -3,11 +3,11 @@ title = "zola.386" description = "Zola port of the BOOTSTRA.386 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/lopes/zola.386.git" homepage = "https://github.com/lopes/zola.386" minimum_version = "0.10.1" diff --git a/docs/content/themes/zola_easydocs_theme/index.md b/docs/content/themes/zola_easydocs_theme/index.md index 52391935..cfabdbf4 100644 --- a/docs/content/themes/zola_easydocs_theme/index.md +++ b/docs/content/themes/zola_easydocs_theme/index.md @@ -3,11 +3,11 @@ title = "EasyDocs" description = "An easy way to create docs for your project" 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_easydocs_theme.git" homepage = "https://github.com/codeandmedia/zola_easydocs_theme" minimum_version = "0.13.0" diff --git a/docs/content/themes/zolarwind/index.md b/docs/content/themes/zolarwind/index.md index 42da010b..d6713eda 100644 --- a/docs/content/themes/zolarwind/index.md +++ b/docs/content/themes/zolarwind/index.md @@ -3,11 +3,11 @@ title = "Zolarwind" description = "A localizable blog theme using Tailwind CSS for styling and KaTex for math" 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/thomasweitzel/zolarwind.git" homepage = "https://github.com/thomasweitzel/zolarwind" minimum_version = "0.18.0" diff --git a/docs/content/themes/zolastrap/index.md b/docs/content/themes/zolastrap/index.md index 23302d8b..c6f0cbb2 100644 --- a/docs/content/themes/zolastrap/index.md +++ b/docs/content/themes/zolastrap/index.md @@ -3,11 +3,11 @@ title = "zolastrap" description = "A bootstrap 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/marcodpt/zolastrap.git" homepage = "https://github.com/marcodpt/zolastrap" minimum_version = "0.14.1" diff --git a/docs/content/themes/zplit/index.md b/docs/content/themes/zplit/index.md index d864381a..868e870d 100644 --- a/docs/content/themes/zplit/index.md +++ b/docs/content/themes/zplit/index.md @@ -3,12 +3,12 @@ title = "Zplit" description = "A single page theme for a professional online presence." 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/gicrisf/zplit" +created = 2024-05-03T12:02:37-07:00 +updated = 2024-05-03T12:02:37-07:00 +repository = "https://github.com/gicrisf/zplit.git" homepage = "https://github.com/gicrisf/zplit" minimum_version = "0.15.0" license = "Creative Commons Attribution 3.0 License" @@ -21,7 +21,7 @@ homepage = "https://github.com/gicrisf" # Zplit -Zplit is a single page, centrally-divided layout for a professional online presence with a big image or video left with alongside content. It is a port of [Split](//onepagelove.com/split) by [One Page Love](//onepagelove.com) for [Zola](https://www.getzola.org/). +Zplit is a single-page, centrally-divided layout designed for a professional online presence. It features a large image or video on the left, accompanied by content on the right. Zplit is a port of [Split](//onepagelove.com/split) by [One Page Love](//onepagelove.com) for [Zola](https://www.getzola.org/). ![Zola Zplit Theme screenshot](screenshot.png) @@ -29,7 +29,7 @@ Zplit is a single page, centrally-divided layout for a professional online prese ## Installation -Download this theme to your `themes` directory: +Download the theme to your `themes` directory: ```bash $ cd themes @@ -39,17 +39,16 @@ $ git clone https://github.com/gicrisf/zplit.git Then, enable the theme editing your `config.toml`: ```toml -theme = "zhuia" +theme = "zplit" ``` ## Getting started -You can find the most important file of the theme in the root directory. It's called `config.toml`. -Edit it, specifying your personal preferences. Go through this (small) file to set some self-explaining variable, such as `author` under `[extra]` or `intro_tagline` under `[extra.content]`. +The most important file of the theme is located in the root directory and is named =config.toml=. Edit this file to customize your preferences. Look for sections like `[extra]` to set variables like `author`, or `[extra.content]` to modify intro_tagline. -If something appears not that evident, maybe you missed the ["configuration" paragraph of the Zola official documentation](https://www.getzola.org/documentation/getting-started/configuration/). Even if this is your first time with a static site generator, don't be scared and go through the docs, because it's very basic stuff. +If something is unclear or not obvious, you might have missed [the "configuration" section of the Zola official documentation](https://www.getzola.org/documentation/getting-started/configuration/). Even if you're new to static site generators, don't worry and take some time to go through the documentation, as it covers fundamental concepts. -Here, we'll see in more detail two more section, that are peculiar for this theme: +Here after, we will discuss two specific sections in more detail, because those are unique for the Zplit theme: - Background image - Lists (of links) @@ -96,24 +95,24 @@ Remember to set the `url` field with the link itself you want to direct your use ## Posts -You could add new posts, by adding markdown files to the `content` directory. -To sort the post index by date, enable sort in your index section `content/_index.md`: +To add new posts, simply place markdown files in the `content` directory. In order to sort the post index by date, you need to enable the `sort_by` option in the `content/_index.md` file within the index section. ```toml sort_by = "date" ``` -This theme wasn't written with blogging in mind, but more as a landing page for professionals. If you want to blog some stuff, though, you can, absolutely. If you add a new section in the content directory, you just have to add it to the main menu through the config file and it will be immediately accessible to the user. -The theme doesn't support taxonomies or other advanced stuff: just simple pages. If you want to extend the blogging features, feel free to tweak the code or open an issue with a specific request. +This theme was not specifically designed for blogging, but rather as a landing page for professionals. However, if you wish to blog using this theme, you certainly can. To do so, simply add a new section in the content directory and include it in the main menu through the config file. This will make it readily accessible to the user. + +The theme does not offer support for taxonomies or other advanced features. It is focused on providing simple pages. If you wish to enhance the blogging functionality, you are welcome to customize the code or submit a specific request as an issue. ## Custom CSS -Add a `custom.css` file in `static` directory and add all the changes you want to the original stylesheets. +To make custom changes to the original stylesheets, you can create a `custom.css` file in the `static` directory. In this file, you can add any modifications or additions you desire. ## Custom colors -If you want to tweak the colors or grid dimensions, though, it could be easier to directly edit the `_01-content.scss` file frontmatter, where the variables are easily exposed at the top of the file: +If you need to make adjustments to the colors or grid dimensions, it may be easier to modify the frontmatter of the `_01-content.scss` file directly. In this file, you will find variables conveniently located at the top: ``` scss //------------------------------------------------------------------------------- @@ -134,8 +133,6 @@ $bp-tablet : 800px; $bp-mobile : 500px; ``` -If you choose this way, you don't have to care about anything else in that file. Just look at the variables. - ## Features - [x] Lightweight and minimal @@ -154,7 +151,7 @@ If you choose this way, you don't have to care about anything else in that file. ## Support me! -Do you love this theme? Was it useful to you? Make a donation and support new features! +Do you love Zplit? Did you find it enjoyable and useful? If so, consider showing your support by making a donation. Your contribution will help fund the development of new features and improvements for this theme. [![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/V7V425BFU)