mirror
/
zola
mirror of https://github.com/getzola/zola
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
zola/docs/content/themes/tranquil/index.md

2.9 KiB
Raw Permalink Blame History

+++ title = "tranquil" description = "A blog theme for zola, simple and clean" template = "theme.html" date = 2024-09-02T05:58:27Z

[extra] created = 2024-09-02T05:58:27Z updated = 2024-09-02T05:58:27Z 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 screenshot (dark theme) of the example page of the demo website A screenshot (light theme) of the example page of the demo website
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

Contributing

  • Before you make any non-trivial changes, consider opening an issue so we can discuss the change.