reivilibre/mirror-zola
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Update themes gallery (#2490)

Browse Source 
Co-authored-by: GitHub Action <action@github.com>
This commit is contained in:
Vincent Prouillet 2024-05-07 23:29:59 +02:00 committed by GitHub
parent f682baa85e
commit 18245b323c
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
90 changed files with 713 additions and 421 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
docs/content/themes/DeepThought/index.md
View File

@ -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"

6
docs/content/themes/Ergo/index.md
View File

@ -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"

6
docs/content/themes/HayFlow/index.md
View File

@ -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"

6
docs/content/themes/Zulma/index.md
View File

@ -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"

8
docs/content/themes/abridge/index.md
View File

@ -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 <a href="https://github.com/Jieiku/abridge/graphs/contributors">contributors</a> and <a href="https://github.com/sponsors/Jieiku">sponsors</a>. If you'd like to sponsor this project and have your avatar or company logo appear below <a href="https://github.com/sponsors/Jieiku">click here</a>. 💖
<!-- sponsors --><!-- sponsors -->
<!-- sponsors --><a href="https://github.com/yugfletcher"><img src="https://github.com/yugfletcher.png" width="60px" alt="" /></a><a href="https://github.com/samueloph"><img src="https://github.com/samueloph.png" width="60px" alt="Samuel Henrique" /></a><!-- sponsors -->
---

6
docs/content/themes/adidoks/index.md
View File

@ -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"

6
docs/content/themes/after-dark/index.md
View File

@ -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"

6
docs/content/themes/albatros/index.md
View File

@ -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"

6
docs/content/themes/anatole-zola/index.md
View File

@ -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"

6
docs/content/themes/andromeda/index.md
View File

@ -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"

46
docs/content/themes/anemone/index.md
View File

@ -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 `<meta>` 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

BIN
docs/content/themes/anemone/screenshot.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 59 KiB

After

Width:  |  Height:  |  Size: 141 KiB

8
docs/content/themes/anpu/index.md
View File

@ -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"

17
docs/content/themes/apollo/index.md
View File

@ -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:

108
docs/content/themes/archie-zola/index.md
View File

@ -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 `<meta/>` tags
### Customize `<meta/>` tags
The following TOML and YAML code will yiled two `<meta/>` tags, `<meta property="og:title" content="the og title"/>`, `<meta property="og:description" content="the og description"/>`.
The following TOML and YAML code will yiled two `<meta/>` tags, `<meta property="og:title" content="the og title"/>`, `<meta property="og:description" content="the og description"/>`.
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 `<meta property="og:title" content="post title"/>`, `<meta property="og:description" content="post desc"/>`, and `<meta property="og:description" content="post desc"/>` 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 `<meta property="og:title" content="post title"/>`, `<meta property="og:description" content="post desc"/>`, and `<meta property="og:description" content="post desc"/>` 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, ...)

8
docs/content/themes/ataraxia-zola/index.md
View File

@ -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"

12
docs/content/themes/bearblog/index.md
View File

@ -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"

6
docs/content/themes/blow/index.md
View File

@ -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"

6
docs/content/themes/book/index.md
View File

@ -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"

6
docs/content/themes/boring/index.md
View File

@ -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"

6
docs/content/themes/clean-blog/index.md
View File

@ -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"

6
docs/content/themes/codinfox-zola/index.md
View File

@ -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"

6
docs/content/themes/d3c3nt/index.md
View File

@ -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"

6
docs/content/themes/dinkleberg/index.md
View File

@ -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"

6
docs/content/themes/docsascode-theme/index.md
View File

@ -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"

6
docs/content/themes/dose/index.md
View File

@ -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"

50
docs/content/themes/duckquill/index.md
View File

@ -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/) <img src="logo.png" alt="Logo" width="96" align="right"/>
[![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)*

BIN
docs/content/themes/duckquill/screenshot.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 186 KiB

After

Width:  |  Height:  |  Size: 275 KiB

6
docs/content/themes/emily/index.md
View File

@ -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"

6
docs/content/themes/even/index.md
View File

@ -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"

65
docs/content/themes/feather/index.md
View File

@ -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 `<head>`
# Default: unset
feather_head = "<script>alert()</script>"
# 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 = "<script></script>" # 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`.

6
docs/content/themes/float/index.md
View File

@ -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"

6
docs/content/themes/hallo/index.md
View File

@ -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"

29
docs/content/themes/halve-z/index.md
View File

@ -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:
```

6
docs/content/themes/hephaestus/index.md
View File

@ -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"

6
docs/content/themes/hermit/index.md
View File

@ -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"

6
docs/content/themes/hook/index.md
View File

@ -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"

6
docs/content/themes/hyde/index.md
View File

@ -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"

6
docs/content/themes/inky/index.md
View File

@ -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"

6
docs/content/themes/juice/index.md
View File

@ -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"

6
docs/content/themes/kangae/index.md
View File

@ -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"

6
docs/content/themes/karzok/index.md
View File

@ -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"

10
docs/content/themes/kita/index.md
View File

@ -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

8
docs/content/themes/kodama-theme/index.md
View File

@ -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"
```

6
docs/content/themes/lightspeed/index.md
View File

@ -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"

70
docs/content/themes/mabuya/index.md
View File

@ -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/"
+++
<h1 align="center">🦎 Mabuya</h1>
# 🦎 Mabuya
<p align="center">
<p align="">
<img src="https://img.shields.io/github/languages/code-size/semanticdata/mabuya" />
<img src="https://img.shields.io/github/repo-size/semanticdata/mabuya" />
<img src="https://img.shields.io/github/commit-activity/t/semanticdata/mabuya" />
<img src="https://img.shields.io/github/last-commit/semanticdata/mabuya" />
<img src="https://img.shields.io/website/https/semanticdata.github.io/mabuya.svg" />
<img src="https://img.shields.io/website/https/mabuya.vercel.app.svg" />
</p>
## 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
<img alt="Website Screenshot" src="screenshot.png" width="720px" />
### 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 <my-repo>` | Initiate new Zola site |
| `zola init <repo-name>` | 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*.

53
docs/content/themes/minimal-dark/index.md
View File

@ -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)

BIN
docs/content/themes/minimal-dark/screenshot.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 763 KiB

After

Width:  |  Height:  |  Size: 534 KiB

6
docs/content/themes/nasm-theme/index.md
View File

@ -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"

6
docs/content/themes/no-style-please/index.md
View File

@ -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"

6
docs/content/themes/ntun/index.md
View File

@ -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"

6
docs/content/themes/oceanic-zen/index.md
View File

@ -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"

6
docs/content/themes/otherworld/index.md
View File

@ -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"

6
docs/content/themes/papaya/index.md
View File

@ -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"

6
docs/content/themes/papermod/index.md
View File

@ -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"

6
docs/content/themes/particle/index.md
View File

@ -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"

11
docs/content/themes/pico/index.md
View File

@ -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)

12
docs/content/themes/polymathic/index.md
View File

@ -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"
<a href="https://www.producthunt.com/posts/polymathic?utm_source=badge-featured&utm_medium=badge&utm_souce=badge-polymathic" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=422530&theme=light" alt="polymathic - Zola&#0032;portfolio&#0032;theme&#0032;for&#0032;those&#0032;with&#0032;many&#0032;talents | Product Hunt" style="width: 250px; height: 54px;" width="250" height="54" /></a>
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.

6
docs/content/themes/resume/index.md
View File

@ -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"

6
docs/content/themes/sam/index.md
View File

@ -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"

6
docs/content/themes/seagull/index.md
View File

@ -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"

8
docs/content/themes/seje2/index.md
View File

@ -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"

23
docs/content/themes/serene/index.md
View File

@ -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"
+++
<img width="1501" alt="screenshot" src="https://github.com/isunjn/serene/assets/60461730/33516366-3670-497f-bd72-41ebe8f06f1a">
<img width="1501" alt="screenshot" src="https://github.com/isunjn/serene/assets/60461730/61b9ff3d-6ed3-4062-8872-1f3a3d9b60a7">
<br /><br />
<br />
<br />
A blog theme for [zola](https://www.getzola.org), simple and clean
## Demo
- <https://serene-demo-site.vercel.app>
- <https://serene-demo.pages.dev>
## 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

BIN
docs/content/themes/serene/screenshot.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 357 KiB

After

Width:  |  Height:  |  Size: 341 KiB

8
docs/content/themes/shadharon/index.md
View File

@ -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"

6
docs/content/themes/simple-dev-blog/index.md
View File

@ -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"

6
docs/content/themes/slim/index.md
View File

@ -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"

6
docs/content/themes/soapstone/index.md
View File

@ -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"

6
docs/content/themes/solar-theme-zola/index.md
View File

@ -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"

58
docs/content/themes/tabi/index.md
View File

@ -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"
+++
<p align="center">
<a href="CONTRIBUTING.md#pull-requests">
<img src="https://img.shields.io/badge/PRs-welcome-0?style=flat-square&labelColor=202b2d&color=087e96" alt="PRs welcome"></a>
<a href="https://github.com/welpo/tabi/graphs/contributors">
<img src="https://img.shields.io/github/contributors/welpo/tabi?style=flat-square&labelColor=202b2d&color=087e96" alt="Contributors"></a>
<a href="https://github.com/welpo/tabi/forks">
<img src="https://img.shields.io/github/forks/welpo/tabi?style=flat-square&labelColor=202b2d&color=087e96" alt="Forks"></a>
<a hfref="https://github.com/welpo/tabi/commits/main/">
<img src="https://img.shields.io/github/last-commit/welpo/tabi?style=flat-square&labelColor=202b2d&color=087e96" alt="Last commit"></a>
<br>
<a href="https://github.com/welpo/tabi/releases">
<img src="https://img.shields.io/github/v/release/welpo/tabi?style=flat-square&labelColor=202b2d&color=087e96" alt="Latest release"></a>
<a href="https://welpo.github.io/tabi/blog/mastering-tabi-settings/">
<img src="https://img.shields.io/website?url=https%3A%2F%2Fwelpo.github.io%2Ftabi&style=flat-square&label=docs&labelColor=202b2d&color=087e96" alt="Documentation"></a>
<a href="https://github.com/welpo/tabi/blob/main/LICENSE">
<img src="https://img.shields.io/github/license/welpo/tabi?style=flat-square&labelColor=202b2d&color=087e96" alt="License"></a>
<a href="https://github.com/welpo/git-sumi">
<img src="https://img.shields.io/badge/clean_commits-git--sumi-0?style=flat-square&labelColor=202b2d&color=087e96" alt="Clean commits"></a>
</p>
# 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 (旅, /<span title="/t/: 't' in 'sty'">t</span><span title="/ɐ/: a sound between 'a' in 'sofa' and 'u' in 'nut'">ɐ</span><span title="/ˈ/: primary stress mark, indicating that the following syllable is pronounced with greater emphasis">ˈ</span><span title="/b/: 'b' in 'cab'">b</span><span title="/i/: 'i' in 'fleece'">i</span>/): 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.

BIN
docs/content/themes/tabi/screenshot.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 160 KiB

After

Width:  |  Height:  |  Size: 144 KiB

6
docs/content/themes/tale-zola/index.md
View File

@ -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"

6
docs/content/themes/tilde/index.md
View File

@ -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"

6
docs/content/themes/toucan/index.md
View File

@ -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"

6
docs/content/themes/tranquil/index.md
View File

@ -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"

6
docs/content/themes/zerm/index.md
View File

@ -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"

6
docs/content/themes/zhuia/index.md
View File

@ -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"

6
docs/content/themes/zola-henry/index.md
View File

@ -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"

109
docs/content/themes/zola-minimal/index.md Normal file
View File

@ -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
<p align="">
<img src="https://img.shields.io/github/languages/code-size/semanticdata/zola-minimal" />
<img src="https://img.shields.io/github/repo-size/semanticdata/zola-minimal" />
<img src="https://img.shields.io/github/commit-activity/t/semanticdata/zola-minimal" />
<img src="https://img.shields.io/github/last-commit/semanticdata/zola-minimal" />
<img src="https://img.shields.io/website/https/zola-minimal.vercel.app.svg" />
</p>
[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 <repo-name>` | 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).

BIN
docs/content/themes/zola-minimal/screenshot.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 154 KiB

6
docs/content/themes/zola-paper/index.md
View File

@ -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"

10
docs/content/themes/zola-pickles/index.md
View File

@ -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"
</div>
<br>
<div align="center">
<a href="https://effervescent-chebakia-056748.netlify.app/">
<a href="https://zola-pickles.pages.dev/">
<img src="https://img.shields.io/badge/demo-website-forestgreen" alt="demo website"></a>
<a href="https://github.com/lukehsiao/zola-pickles/blob/main/LICENSE">
<img src="https://img.shields.io/badge/license-BlueOak--1.0.0-blue" alt="License">

6
docs/content/themes/zola-theme-course/index.md
View File

@ -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"

6
docs/content/themes/zola-theme-hikari/index.md
View File

@ -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"

6
docs/content/themes/zola-theme-terminimal/index.md
View File

@ -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"

6
docs/content/themes/zola.386/index.md
View File

@ -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"

6
docs/content/themes/zola_easydocs_theme/index.md
View File

@ -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"

6
docs/content/themes/zolarwind/index.md
View File

@ -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"

6
docs/content/themes/zolastrap/index.md
View File

@ -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"

37
docs/content/themes/zplit/index.md
View File

@ -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)