Co-authored-by: GitHub Action <action@github.com>
2.8 KiB
+++ title = "tranquil" description = "A blog theme for zola, simple and clean" template = "theme.html" date = 2023-09-29T13:09:24+02:00
[extra] created = 2023-09-29T13:09:24+02:00 updated = 2023-09-29T13:09:24+02:00 repository = "https://github.com/TeaDrinkingProgrammer/tranquil.git" homepage = "https://github.com/TeaDrinkingProgrammer/tranquil" minimum_version = "0.9.0" license = "MIT" demo = "https://teadrinkingprogrammer.github.io/tranquil-demo/"
[extra.author] name = "TeaDrinkingProgrammer" homepage = "https://github.com/TeaDrinkingProgrammer" +++
A blog theme for Zola. Simple, elegant and uses Tailwind. Based on Isunjns Serene theme.
Demo
Features
- A simple and elegant design.
- Projects page: display a list of the projects you have worked on with links.
- Theme toggle: switch between light and dark theme regardless of your browser preference.
- Image zooming using Lightense: zoom in on images by clicking on them.
- Out-of-date alert: show alerts when your post is outdated.
- Callouts (note, warning, alert, etc.) that can be used right in Markdown.
- Comments using Giscus.
- Mathematical notations using KaTeX.
- Diagrams and visualizations using Mermaid.
Shoutouts
This theme wouldn't have existed without Isunjns Serene theme. It's a great theme, so go check that one out as well.
When I doubted about layout, I always went to look at FasterThanLimes blog to see how he did it.
Of course, this website wouldn't render without Zola and it wouldn't show anything without Tailwind.
Tranquil vs Serene
Tranquil is a fork of Serene. The main reason to fork was not that I thought Serene was bad: I just wanted to try out Tailwind for a while and reimplementing a blog theme seemed like the perfect way to do so.
The main and pretty much only difference between Tranquil and Serene is that the styling is built from scratch with Tailwind. The icons have also been changed to align better with Tailwind.
Usage
- Check the USAGE.md of
main
branch.
Contributing
- Before you make any non-trivial changes, consider opening an issue so we can discuss the change.