Skip to content

Update themes gallery #2846

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Apr 13, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions docs/content/themes/Ergo/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,14 @@
title = "Ergo"
description = "A simple blog Theme focused on writing, inspired by svbtle"
template = "theme.html"
date = 2023-07-14T17:59:06+01:00
date = 2025-03-17T15:01:15Z

[taxonomies]
theme-tags = []

[extra]
created = 2023-07-14T17:59:06+01:00
updated = 2023-07-14T17:59:06+01:00
created = 2025-03-17T15:01:15Z
updated = 2025-03-17T15:01:15Z
repository = "https://github.com/insipx/Ergo.git"
homepage = "https://github.com/insipx/Ergo"
minimum_version = "0.4.1"
Expand Down
8 changes: 4 additions & 4 deletions docs/content/themes/abridge/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,14 @@
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 = 2025-02-02T21:30:23-08:00
date = 2025-04-06T01:01:44Z

[taxonomies]
theme-tags = []

[extra]
created = 2025-02-02T21:30:23-08:00
updated = 2025-02-02T21:30:23-08:00
created = 2025-04-06T01:01:44Z
updated = 2025-04-06T01:01:44Z
repository = "https://github.com/Jieiku/abridge.git"
homepage = "https://github.com/jieiku/abridge"
minimum_version = "0.19.1"
Expand All @@ -33,7 +33,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 --><a href="https://github.com/yugfletcher"><img src="https:&#x2F;&#x2F;github.com&#x2F;yugfletcher.png" width="60px" alt="User avatar: " /></a><a href="https://github.com/samueloph"><img src="https:&#x2F;&#x2F;github.com&#x2F;samueloph.png" width="60px" alt="User avatar: Samuel Henrique" /></a><!-- sponsors -->
<!-- sponsors --><a href="https://github.com/yugfletcher"><img src="https:&#x2F;&#x2F;github.com&#x2F;yugfletcher.png" width="60px" alt="User avatar: " /></a><a href="https://github.com/samueloph"><img src="https:&#x2F;&#x2F;github.com&#x2F;samueloph.png" width="60px" alt="User avatar: Samuel Henrique" /></a><a href="https://github.com/bensuperpc"><img src="https:&#x2F;&#x2F;github.com&#x2F;bensuperpc.png" width="60px" alt="User avatar: Bensuperpc" /></a><!-- sponsors -->

---

Expand Down
19 changes: 11 additions & 8 deletions docs/content/themes/apollo/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,14 @@
title = "apollo"
description = "Modern and minimalistic blog theme"
template = "theme.html"
date = 2025-02-18T18:52:04+01:00
date = 2025-04-03T18:13:10+02:00

[taxonomies]
theme-tags = []

[extra]
created = 2025-02-18T18:52:04+01:00
updated = 2025-02-18T18:52:04+01:00
created = 2025-04-03T18:13:10+02:00
updated = 2025-04-03T18:13:10+02:00
repository = "https://github.com/not-matthias/apollo.git"
homepage = "https://github.com/not-matthias/apollo"
minimum_version = "0.14.0"
Expand All @@ -31,21 +31,23 @@ Modern and minimalistic blog theme powered by [Zola](https://getzola.org). See a
<details open>
<summary>Dark theme</summary>

![blog-dark](./screenshot-dark.png)
![blog-dark](./screenshot-dark.png)

</details>

<details>
<summary>Light theme</summary>

![blog-light](./screenshot.png)

</details>

## Features

- [X] Pagination
- [X] Themes (light, dark, auto)
- [X] Projects page
- [X] Analytics using [GoatCounter](https://www.goatcounter.com/) / [Umami](https://umami.is/)
- [x] Pagination
- [x] Themes (light, dark, auto)
- [x] Projects page
- [x] Analytics using [GoatCounter](https://www.goatcounter.com/) / [Umami](https://umami.is/)
- [x] Social Links
- [x] MathJax Rendering
- [x] Taxonomies
Expand All @@ -57,6 +59,7 @@ Modern and minimalistic blog theme powered by [Zola](https://getzola.org). See a
## Installation

1. Download the theme

```
git submodule add https://github.com/not-matthias/apollo themes/apollo
```
Expand Down
217 changes: 217 additions & 0 deletions docs/content/themes/daisy/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,217 @@

+++
title = "Daisy"
description = "Beautiful and fast responsive theme based on TailwindCSS and DaisyUI."
template = "theme.html"
date = 2025-04-06T13:02:47+02:00

[taxonomies]
theme-tags = ['multilingual', 'responsive', 'search']

[extra]
created = 2025-04-06T13:02:47+02:00
updated = 2025-04-06T13:02:47+02:00
repository = "https://codeberg.org/winterstein/zola-theme-daisy.git"
homepage = "https://codeberg.org/winterstein/zola-theme-daisy"
minimum_version = "0.9.0"
license = "MIT"
demo = "https://zola-daisy.winterstein.biz"

[extra.author]
name = "Adrian Winterstein"
homepage = "https://www.winterstein.biz"
+++

# Daisy Theme

> You can find this theme on [Codeberg](https://codeberg.org/winterstein/zola-theme-daisy) and [Github](https://github.com/awinterstein/zola-theme-daisy).

A beautiful and fast [Zola](https://www.getzola.org/) theme build on [TailwindCSS](https://tailwindcss.com) and [DaisyUI](https://daisyui.com) with 37 different color schemes included. See an example of the *autumn* colors here:

![Screenshot](https://codeberg.org/awinterstein/zola-theme-daisy/raw/branch/main/screenshot.png)

The theme is responsive and works very well on mobile devices:

<img src="https://codeberg.org/awinterstein/zola-theme-daisy/raw/branch/main/screenshot-mobile.png" alt="Mobile Screenshot" width="200"/>

## Features

* Responsive design (looks good on desktop and mobile)
* Automatically selected dark / light modes
* 37 color schemes included
* Customizable navbar and footer (with social links)
* Can be used with any Zola taxonomies (e.g., tags, categories)
* Search functionality
* Multi-language support
* Pagination
* Customizable favicon
* Error 404 page

### Styling

The Daisy theme supports all [built-in color themes of DaisyUI](https://daisyui.com/docs/themes/#enable-a-built-in-theme) plus a light and dark color scheme that I created for my own website. The color themes can optionally even be switched at runtime.

![DaisyUI Color Themes](https://codeberg.org/winterstein/zola-theme-daisy/raw/branch/main/daisyui-themes.png)

## Quick Start

The installation of the theme works the same as for other Zola themes. As it is described in the [official documentation](https://www.getzola.org/documentation/themes/installing-and-using-themes/). Hence, it fist needs to be added as a git submodule:

```bash
cd my-zola-website
git submodule add -b main \
https://codeberg.org/winterstein/zola-theme-daisy.git \
themes/daisy
```

Please make sure to add it at the path `themes/daisy` in your Zola directory. The translations and the icons won't work if added to a different directory.

As the second step, it can be enabled then in the `config.toml` file of your website:

```toml
theme = "daisy"
```

For starting to create a new Zola website using this theme, the you can also just checkout / fork the [example repository](https://codeberg.org/winterstein/zola-theme-daisy-example) and adapt it to your needs. That repository already contains a structure and configuration for the Zola-based website.

## Configuration

See the following sections for information on the possible configurations for the theme in the your `config.toml` file.

### Color Schemes

Set a light and dark color scheme:

```toml
daisyui_theme_light = "light"
daisyui_theme_dark = "dark"
```

See the `themes` list in the [`theme.toml`](theme.toml) for all possible identifiers. You can also set only a light or a dark color scheme, if you do not want the automatic dark mode switching based on the browser settings of your visitors.

If you want to allow your visitors to change the used color scheme, just set the following variable in the `[extra]` section of your `config.toml`:

```toml
[extra]
enable_theme_switching = true
```

There will be a dropdown in the navbar then, for the visitors to select form the color schemes.

### Languages

To enable support for multiple languages, simply set the default language and add language settings for all your additional languages:

```toml
default_language = "en"

[languages.de]
# title and description in the additional language
title = "Daisy Theme"
description = "Beispiel- und Demoseite des Daisy-Themas für Zola."

# don't forget to enable features like search or feed
# generation for the additional language as well
build_search_index = true
generate_feeds = true

# also any taxonomies of your default language need to
# be defined for the additional language as well
taxonomies = [
{ name = "tags", paginate_by = 2, feed = true },
{ name = "directors", paginate_by = 2, feed = true },
]
```

Taxonomies should have exactly the same (not translated) name in all languages, for the language switching to work best.

You need to create an i18n file containing the translations for all theme variables for all the languages of your website, if they are not included in the theme. Right now, only [English](i18n/en.toml) and [German](i18n/de.toml) are included. You can create a the directory `i18n` in your website root directory and the language files in there will be picked up by the theme. It would be great, however, I you create a [pull-request](https://codeberg.org/winterstein/zola-theme-daisy/pulls) on the theme repository to add your translations to the theme.

### Search

Integrating a search into your website is as easy as adding the following to your configuration:

```toml
# enable it globally for the default language
build_search_index = true

[search]
# only this format is supported by the theme
index_format = "elasticlunr_json"

# you need to enable search at all your language sections as well
[languages.de]
build_search_index = true
```

As soon as `build_search_index` is enabled, the search indices are created for all languages that have this variable enabled in their section in the `config.toml` and the search bar is shown in the navbar of the website.

Just be aware, that you need to add a [Lunr Languages](https://github.com/MihaiValentin/lunr-languages) file to your `static` directory, if you ae using other languages than English and German. See the corresponding repository for the [`min` files](https://github.com/MihaiValentin/lunr-languages/tree/master/min). Feel free to add support for your languages to the theme as well, via a [pull-request](https://codeberg.org/winterstein/zola-theme-daisy/pulls).

### Navbar

Arbitrary links can be added to the footer by defining the following list in the `[extra.navbar]` section:

```toml
[extra.navbar]
links = [
{ url = "blog", i18n_key = "posts" },
{ url = "tags", i18n_key = "tags" },
{ url = "movies", i18n_key = "movies" },
]
```

The value of the `i18n_key` must be in the `i18n` files for your languages (see [en.toml](i18n/en.toml), for example).

### Footer

All three parts of the footer can be adapted: the links, the social icons, and the copyright notice.

#### Links

Arbitrary links can be added to the footer by defining the following list in the `[extra.footer]` section:

```toml
[extra.footer]
links = [
{ url = "about", i18n_key = "about" },
{ url = "sitemap.xml", i18n_key = "sitemap", no_translation = true },
]
```

The value of the `i18n_key` must be in the `i18n` files for your languages (see [en.toml](i18n/en.toml), for example). If the parameter `no_translation` is set to true, than the URL is not adapted to contain the current language code. This is needed for external links or something like the `sitemap.xml` in the example, that is not translated within your website.

#### Social Icons

The social icons in the footer can be adapted by setting any of the following variables:

```toml
[extra.social]
codeberg = ""
github = ""
gitlab = ""
stackoverflow = ""
mastodon = ""
linkedin = ""
instagram = ""
youtube = ""
signal = ""
telegram = ""
email = ""
phone = ""
```

For every non-empty variable, the corresponding icon is shown in the footer.

#### Copyright Notice

The copyright notice in the footer can be set by adding the following variable in the configuration:

```toml
[extra.footer]
notice = "This is my <b>copyright</b> notice."
```

HTML can be used there.


Binary file added docs/content/themes/daisy/screenshot.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
6 changes: 3 additions & 3 deletions docs/content/themes/duckquill/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,14 @@
title = "Duckquill"
description = "Modern, pretty, and clean theme"
template = "theme.html"
date = 2025-01-14T12:22:27Z
date = 2025-03-30T08:12:44+03:00

[taxonomies]
theme-tags = []

[extra]
created = 2025-01-14T12:22:27Z
updated = 2025-01-14T12:22:27Z
created = 2025-03-30T08:12:44+03:00
updated = 2025-03-30T08:12:44+03:00
repository = "https://codeberg.org/daudix/duckquill.git"
homepage = "https://codeberg.org/daudix/duckquill"
minimum_version = "0.19.0"
Expand Down
6 changes: 3 additions & 3 deletions docs/content/themes/halve-z/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,14 @@
title = "halve-z"
description = "Retro two-column theme"
template = "theme.html"
date = 2025-03-09T18:53:31-04:00
date = 2025-04-06T19:25:28-04:00

[taxonomies]
theme-tags = []

[extra]
created = 2025-03-09T18:53:31-04:00
updated = 2025-03-09T18:53:31-04:00
created = 2025-04-06T19:25:28-04:00
updated = 2025-04-06T19:25:28-04:00
repository = "https://github.com/charlesrocket/halve-z.git"
homepage = "https://github.com/charlesrocket/halvez"
minimum_version = "0.19.2"
Expand Down
6 changes: 3 additions & 3 deletions docs/content/themes/hermit/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,14 @@
title = "Hermit_Zola"
description = "Minimal Zola theme"
template = "theme.html"
date = 2024-09-30T14:13:56+02:00
date = 2025-04-06T11:23:44+02:00

[taxonomies]
theme-tags = []

[extra]
created = 2024-09-30T14:13:56+02:00
updated = 2024-09-30T14:13:56+02:00
created = 2025-04-06T11:23:44+02:00
updated = 2025-04-06T11:23:44+02:00
repository = "https://github.com/VersBinarii/hermit_zola.git"
homepage = "https://github.com/VersBinarii/hermit_zola"
minimum_version = "0.4.0"
Expand Down
6 changes: 3 additions & 3 deletions docs/content/themes/homepage-creators/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,14 @@
title = "homepage-creators"
description = "A fast and beautiful personal homepage for creators, used by https://jiaxiang.wang, a port of HeoWeb."
template = "theme.html"
date = 2025-03-14T12:19:40+08:00
date = 2025-03-27T00:49:13+08:00

[taxonomies]
theme-tags = []

[extra]
created = 2025-03-14T12:19:40+08:00
updated = 2025-03-14T12:19:40+08:00
created = 2025-03-27T00:49:13+08:00
updated = 2025-03-27T00:49:13+08:00
repository = "https://github.com/iWangJiaxiang/Homepage-Creators.git"
homepage = "https://github.com/iWangJiaxiang/homepage-for-creators"
minimum_version = "0.19.2"
Expand Down
Loading