Skip to content
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

Update themes gallery #2180

Merged
merged 1 commit into from
Apr 17, 2023
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/DeepThought/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,11 @@
title = "DeepThought"
description = "A simple blog theme focused on writing powered by Bulma and Zola."
template = "theme.html"
date = 2022-12-04T21:40:33+02:00
date = 2023-04-16T21:40:29+02:00

[extra]
created = 2022-12-04T21:40:33+02:00
updated = 2022-12-04T21:40:33+02:00
created = 2023-04-16T21:40:29+02:00
updated = 2023-04-16T21:40:29+02:00
repository = "https://github.com/RatanShreshtha/DeepThought.git"
homepage = "https://github.com/RatanShreshtha/DeepThought"
minimum_version = "0.14.1"
Expand Down
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,11 +3,11 @@
title = "Ergo"
description = "A simple blog Theme focused on writing, inspired by svbtle"
template = "theme.html"
date = 2022-12-04T21:40:33+02:00
date = 2023-04-16T21:40:29+02:00

[extra]
created = 2022-12-04T21:40:33+02:00
updated = 2022-12-04T21:40:33+02:00
created = 2023-04-16T21:40:29+02:00
updated = 2023-04-16T21:40:29+02:00
repository = "https://github.com/insipx/Ergo.git"
homepage = "https://github.com/insipx/Ergo"
minimum_version = "0.4.1"
Expand Down
156 changes: 156 additions & 0 deletions docs/content/themes/HayFlow/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,156 @@

+++
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 = 2023-04-16T21:40:29+02:00

[extra]
created = 2023-04-16T21:40:29+02:00
updated = 2023-04-16T21:40:29+02:00
repository = "https://gitlab.com/cyril-marpaud/hayflow.git"
homepage = "https://gitlab.com/cyril-marpaud/hayflow"
minimum_version = "0.4.0"
license = "CC-BY-SA 4.0"
demo = "https://cyril-marpaud.gitlab.io"

[extra.author]
name = "Cyril Marpaud"
homepage = "https://cyril-marpaud.gitlab.io"
+++

# HayFlow - Modular Zola Theme

## About

<div align="center">
![Preview screenshot](https://gitlab.com/cyril-marpaud/hayflow/-/raw/main/screenshot.png "Preview screenshot")
</div>

[HayFlow](https://gitlab.com/cyril-marpaud/hayflow) is a modular landing page made as a theme for [Zola](https://www.getzola.org), a static site generator written in [Rust](https://www.rust-lang.org). It features a dark theme with a particles background, vertical arrows for navigation and a few card types which you are free to include to best suit your needs. Nearly all UI elements are subtly animated to convey a professional look (although I'm no designer 🤷 merely an [embedded systems engineer](https://www.linkedin.com/in/cyrilmarpaud)).

It has been designed to require only [Markdown](https://www.markdownguide.org) editing (no HTML/CSS), but feel free to do so if you need to. I'll be glad to review a [Merge Request](https://gitlab.com/cyril-marpaud/hayflow/-/merge_requests) if you implement a new card type !

[[_TOC_]]

## Live demo

See [my personal website](https://cyril-marpaud.gitlab.io) for an example of what can be accomplished in a few minutes with this theme. Its source code is also available as an example in my [Gitlab website repository](https://gitlab.com/cyril-marpaud/cyril-marpaud.gitlab.io).

## Built with

- [Zola](https://www.getzola.org)
- [Particles.js](https://vincentgarreau.com/particles.js/)
- [Font Awesome](https://fontawesome.com)
- [Modern Normalize](https://github.com/sindresorhus/modern-normalize)
- Inspiration came from [particle-zola](https://github.com/svavs/particle-zola), another theme.

## Quick start

Initialize a Zola website and install HayFlow:
```bash
zola init mywebsite
cd mywebsite
git clone [email protected]:cyril-marpaud/hayflow.git themes/hayflow
```

Add `theme = "hayflow"` at the top of your `config.toml` file to tell Zola to use HayFlow (as described in [the documentation](https://www.getzola.org/documentation/themes/installing-and-using-themes/)).

Finally, run...

```bash
zola serve
```
...and go to [http://localhost:1111](http://localhost:1111) to see your landing page in action with the default name displayed (John Doe).

## Landing page customization

Customizing the landing page boils down to adding variables to your `config.toml`'s `[extra]` section. There are three variables one can use to do so: `name`, `roles` and `links` (they are all optional).

- `name` speaks for itself.
- `roles` is an array of strings. Each string is displayed on a separate line.
- `links` is an array of `{icon, url}` objects. You can use any **free** icon from [Font Awesome](https://fontawesome.com/search?o=r&m=free) here, all you need is the icon's code. The [enveloppe icon](https://fontawesome.com/icons/envelope?s=solid&f=classic)'s code is `fa-solid fa-envelope`. The [pizza-slice icon](https://fontawesome.com/icons/pizza-slice?s=solid&f=classic)'s code is `fa-solid fa-pizza-slice`.

```TOML
[extra]
name = { first = "ninja", last = "turtle" }

roles = ["Green 🟢", "Turtle 🐢", "Pizza enthusiast 🍕"]

links = [
{ icon = "fa-solid fa-envelope", url = "mailto:[email protected]" },
{ icon = "fa-solid fa-pizza-slice", url = "https://en.wikipedia.org/wiki/Pizza" },
]
```

## Adding a section

Inside the `content` directory, create a `pizza` folder and place this `_index.md` file inside:

```TOML
+++
title = "Pizza"
+++

What a mouthful !
```

Then, add this `sections` variable (an array of strings) to your `config.toml`'s `[extra]` section:

```TOML
[extra]
sections = ["pizza"]
```

A new internal link pointing to that section will appear on the landing page. Click it and see what happens ! This is called a "simple card" section.

## Customizing sections

HayFlow currently supports three card types : `simple`, `columns` and `list`. If left unspecified, the type will default to `simple`. To change it, add a `card_type` variable to your `_index.md`'s [front matter](https://www.getzola.org/documentation/content/section/#front-matter)'s `[extra]` section:

```TOML
+++
title = "Pizza"

[extra]
card_type = "simple"
+++

What a mouthful !
```

### Columns card

Add a new section and set its card type to `columns`. Then, alongside the `_index.md` file, create three other files: `one.md`, `two.md` and `three.md`. These will be the ingredients of your new pizza. Their content is similar to `_index.md`:

```TOML
+++
title = "Tomato"

[extra]
icons = ["fa-solid fa-tomato"]
+++

The basis of any self-respecting pizza. It is the edible berry of the plant Solanum lycopersicum.
```

The `icons` variable is optional.

### List card

Add a new section and set its card type to `list`. Then, alongside the `_index.md` file, create three other files: `one.md`, `two.md` and `three.md`. These will be your favourite pizzas. Their content is similar to `_index.md`:

```TOML
+++
title = "Margherita"

[extra]
link = "https://en.wikipedia.org/wiki/Pizza_Margherita"
+++

Margherita pizza is a typical [Neapolitan pizza](https://en.wikipedia.org/wiki/Neapolitan_pizza), made with San Marzano tomatoes, mozzarella cheese, fresh basil, salt, and extra-virgin olive oil.
```

The `link` variable is optional.


Binary file added docs/content/themes/HayFlow/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/Zulma/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,11 @@
title = "Zulma"
description = "A zola theme based off bulma.css"
template = "theme.html"
date = 2022-12-04T21:40:33+02:00
date = 2023-04-16T21:40:29+02:00

[extra]
created = 2022-12-04T21:40:33+02:00
updated = 2022-12-04T21:40:33+02:00
created = 2023-04-16T21:40:29+02:00
updated = 2023-04-16T21:40:29+02:00
repository = "https://github.com/Worble/Zulma.git"
homepage = "https://github.com/Worble/Zulma"
minimum_version = "0.6.0"
Expand Down
6 changes: 3 additions & 3 deletions docs/content/themes/abridge/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,11 @@
title = "abridge"
description = "A fast and lightweight Zola theme using semantic html, a class-light abridge.css, and No JS."
template = "theme.html"
date = 2022-12-04T21:40:33+02:00
date = 2023-04-16T21:40:29+02:00

[extra]
created = 2022-12-04T21:40:33+02:00
updated = 2022-12-04T21:40:33+02:00
created = 2023-04-16T21:40:29+02:00
updated = 2023-04-16T21:40:29+02:00
repository = "https://github.com/Jieiku/abridge.git"
homepage = "https://github.com/jieiku/abridge/"
minimum_version = "0.16.0"
Expand Down
6 changes: 3 additions & 3 deletions docs/content/themes/adidoks/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,11 @@
title = "adidoks"
description = "AdiDoks is a Zola theme helping you build modern documentation."
template = "theme.html"
date = 2022-12-04T21:40:33+02:00
date = 2023-04-16T21:40:29+02:00

[extra]
created = 2022-12-04T21:40:33+02:00
updated = 2022-12-04T21:40:33+02:00
created = 2023-04-16T21:40:29+02:00
updated = 2023-04-16T21:40:29+02:00
repository = "https://github.com/aaranxu/adidoks.git"
homepage = "https://github.com/aaranxu/adidoks"
minimum_version = "0.15.0"
Expand Down
6 changes: 3 additions & 3 deletions docs/content/themes/after-dark/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,11 @@
title = "after-dark"
description = "A robust, elegant dark theme"
template = "theme.html"
date = 2022-12-04T21:40:33+02:00
date = 2023-04-16T21:40:29+02:00

[extra]
created = 2022-12-04T21:40:33+02:00
updated = 2022-12-04T21:40:33+02:00
created = 2023-04-16T21:40:29+02:00
updated = 2023-04-16T21:40:29+02:00
repository = "https://github.com/getzola/after-dark.git"
homepage = "https://github.com/getzola/after-dark"
minimum_version = "0.11.0"
Expand Down
6 changes: 3 additions & 3 deletions docs/content/themes/albatros/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,11 @@
title = "Albatros"
description = "A feature rich theme originally made for Duniter website."
template = "theme.html"
date = 2022-12-04T21:40:33+02:00
date = 2023-04-16T21:40:29+02:00

[extra]
created = 2022-12-04T21:40:33+02:00
updated = 2022-12-04T21:40:33+02:00
created = 2023-04-16T21:40:29+02:00
updated = 2023-04-16T21:40:29+02:00
repository = "https://git.42l.fr/HugoTrentesaux/Albatros.git"
homepage = "https://git.42l.fr/HugoTrentesaux/Albatros"
minimum_version = "0.16.0"
Expand Down
6 changes: 3 additions & 3 deletions docs/content/themes/anatole-zola/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,11 @@
title = "anatole-zola"
description = "A port of farbox-theme-Anatole for zola"
template = "theme.html"
date = 2022-12-04T21:40:33+02:00
date = 2023-04-16T21:40:29+02:00

[extra]
created = 2022-12-04T21:40:33+02:00
updated = 2022-12-04T21:40:33+02:00
created = 2023-04-16T21:40:29+02:00
updated = 2023-04-16T21:40:29+02:00
repository = "https://github.com/longfangsong/anatole-zola.git"
homepage = "https://github.com/longfangsong/anatole-zola"
minimum_version = "0.4.0"
Expand Down
6 changes: 3 additions & 3 deletions docs/content/themes/anpu/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,11 @@
title = "Anpu"
description = "A port of the Hugo Anubis theme"
template = "theme.html"
date = 2022-12-04T21:40:33+02:00
date = 2023-04-16T21:40:29+02:00

[extra]
created = 2022-12-04T21:40:33+02:00
updated = 2022-12-04T21:40:33+02:00
created = 2023-04-16T21:40:29+02:00
updated = 2023-04-16T21:40:29+02:00
repository = "https://github.com/zbrox/anpu-zola-theme.git"
homepage = "https://github.com/zbrox/anpu-zola-theme"
minimum_version = "0.11.0"
Expand Down
6 changes: 3 additions & 3 deletions docs/content/themes/apollo/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,11 @@
title = "apollo"
description = "Modern and minimalistic blog theme"
template = "theme.html"
date = 2022-12-04T21:40:33+02:00
date = 2023-04-16T21:40:29+02:00

[extra]
created = 2022-12-04T21:40:33+02:00
updated = 2022-12-04T21:40:33+02:00
created = 2023-04-16T21:40:29+02:00
updated = 2023-04-16T21:40:29+02:00
repository = "https://github.com/not-matthias/apollo.git"
homepage = "https://github.com/not-matthias/apollo"
minimum_version = "0.14.0"
Expand Down
6 changes: 3 additions & 3 deletions docs/content/themes/archie-zola/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,11 @@
title = "archie-zola"
description = "A zola theme based on Hugo archie."
template = "theme.html"
date = 2022-12-04T21:40:33+02:00
date = 2023-04-16T21:40:29+02:00

[extra]
created = 2022-12-04T21:40:33+02:00
updated = 2022-12-04T21:40:33+02:00
created = 2023-04-16T21:40:29+02:00
updated = 2023-04-16T21:40:29+02:00
repository = "https://github.com/XXXMrG/archie-zola.git"
homepage = "https://github.com/XXXMrG/archie-zola"
minimum_version = "0.14.0"
Expand Down
6 changes: 3 additions & 3 deletions docs/content/themes/ataraxia-zola/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,11 @@
title = "ataraxia"
description = "A personal theme focused on ease of reading"
template = "theme.html"
date = 2022-12-04T21:40:33+02:00
date = 2023-04-16T21:40:29+02:00

[extra]
created = 2022-12-04T21:40:33+02:00
updated = 2022-12-04T21:40:33+02:00
created = 2023-04-16T21:40:29+02:00
updated = 2023-04-16T21:40:29+02:00
repository = "https://github.com/gersonbdev/ataraxia-zola"
homepage = "https://github.com/gersonbdev/ataraxia-zola"
minimum_version = "0.16.0"
Expand Down
6 changes: 3 additions & 3 deletions docs/content/themes/blow/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,11 @@
title = "Blow"
description = "A Zola theme made with Tailwindcss"
template = "theme.html"
date = 2022-12-04T21:40:33+02:00
date = 2023-04-16T21:40:29+02:00

[extra]
created = 2022-12-04T21:40:33+02:00
updated = 2022-12-04T21:40:33+02:00
created = 2023-04-16T21:40:29+02:00
updated = 2023-04-16T21:40:29+02:00
repository = "https://github.com/tchartron/blow.git"
homepage = "https://github.com/tchartron/blow"
minimum_version = "0.9.0"
Expand Down
6 changes: 3 additions & 3 deletions docs/content/themes/book/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,11 @@
title = "book"
description = "A book theme inspired from GitBook/mdBook"
template = "theme.html"
date = 2022-12-04T21:40:33+02:00
date = 2023-04-16T21:40:29+02:00

[extra]
created = 2022-12-04T21:40:33+02:00
updated = 2022-12-04T21:40:33+02:00
created = 2023-04-16T21:40:29+02:00
updated = 2023-04-16T21:40:29+02:00
repository = "https://github.com/getzola/book.git"
homepage = "https://github.com/getzola/book"
minimum_version = "0.5.0"
Expand Down
6 changes: 3 additions & 3 deletions docs/content/themes/boring/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,11 @@
title = "boring"
description = "A minimal theme"
template = "theme.html"
date = 2022-12-04T21:40:33+02:00
date = 2023-04-16T21:40:29+02:00

[extra]
created = 2022-12-04T21:40:33+02:00
updated = 2022-12-04T21:40:33+02:00
created = 2023-04-16T21:40:29+02:00
updated = 2023-04-16T21:40:29+02:00
repository = "https://github.com/ssiyad/boring.git"
homepage = "https://github.com/ssiyad/boring"
minimum_version = "0.16.0"
Expand Down
6 changes: 3 additions & 3 deletions docs/content/themes/clean-blog/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,11 @@
title = "Clean Blog"
description = "A port of Start Bootstrap Clean Blog for Zola"
template = "theme.html"
date = 2022-12-04T21:40:33+02:00
date = 2023-04-16T21:40:29+02:00

[extra]
created = 2022-12-04T21:40:33+02:00
updated = 2022-12-04T21:40:33+02:00
created = 2023-04-16T21:40:29+02:00
updated = 2023-04-16T21:40:29+02: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"
Expand Down
Loading