zhuia
zhuia copied to clipboard
An elegant but still playful theme for Zola.
Zhuia
An elegant but still playful theme for Zola powered by Spectre.css.
It is especially optimized for mobile navigation (optionally without JavaScript, if you don't like fancy stuff).
DEMO: https://zhuia.netlify.app/
Contents
- Installation
- Features
-
Options
- Title
- SEO
- Menu
- Social
- Footer
- Name
- Genesis
- Donate
- License
Installation
First download this theme to your themes
directory:
$ cd themes
$ git clone https://github.com/gicrisf/zhuia.git
and then enable it in your config.toml
:
theme = "zhuia"
Posts should be placed directly in the content
folder.
To sort the post index by date, enable sort in your index section content/_index.md
:
sort_by = "date"
Features
- [x] Lightweight and minimal
- [x] Spectre CSS classes to manage content. Look at the docs
- [x] Responsive for mobile support (with full-page mobile menu)
- [x] SCSS based CSS source files for easy customization
- [x] HTML based sidebar widget
- [x] Author card sidebar widget with customizable avatar
- [ ] Multi-author support
- [x] Optional twitter sidebar widget
- [x] Feed RSS/Atom
- [x] Open Graph and Twitter Cards support
- [x] Social buttons with icons
- [x] Deploy via Netlify (config already included)
- [x] Tags AND categories
- [x] Granular image optimization for a really faster loading on mobile
- [x] Pagination
- [x] Easily extendable menu
- [ ] Inter-page pagination
- [x] Optional NoJs
- [x] Hamburger animation
- [ ] Comments
- [ ] Related posts (not sure about this)
- [ ] Search bar
- [x] Math rendering
- [x] Other shortcodes
- [ ] Multilanguage support
- [ ] Dark mode
- [ ] Table of Contents
- [ ] Image + text title option
Options
Title
Set a title and description in the config to appear in the site header and on the RSS feed:
title = "Der Prozess"
description = "a novel written by Franz Kafka in 1914"
SEO
Most SEO tags are populated by the page metadata, but you can set the author
and for the og:image
tag provide the path to an image:
[extra]
author = "Timothy Morton"
og_image = "Hyperobjects.png"
Menu
You can choose between two modes:
- With a small script for an elegant overlay menu
- Without any scripts at all (it just your show menu underneath)
Social
Set a field in extra
with a key of footer_links
:
[extra]
# Freely comment out or delete every field
social_links = [
{url = "https://t.me/yourname", name = "telegram"},
{url = "https://twitter.com/gicrisf", name = "twitter"},
{url = "https://github.com/gicrisf", name = "github"},
# {url = "", name = "facebook"},
# {url = "", name = "instagram"},
# {url = "", name = "bookstack"},
# {url = "", name = "dokuwiki"},
]
The theme automatically picks up the right icons. We can expand the support to other social, for sure: make a PR or open an enhancement issue to ask a new implementation.
Footer
You can add your own copyright or whatever to the footer with a through a simple option on the config file:
[extra]
footer_tagline = "What if everything is an illusion and nothing exists? In that case, I definitely overpaid for my carpet."
Name
The name arise from two parts:
- The generator, Zola, gives the "Z";
- An extinct species of New Zealand wattlebird, the huia, provide the second part.
The theme is built on Spectre CSS framework, so I found reasonable evoking a spectral species.
Genesis
This theme is based on a Pelican theme I originally made for my blog, which was in turn based on the Grav theme Quark.
Donate
Did you liked this theme? Make a donation and support new features!
License
Open sourced under the MIT license.