no style, please!

A (nearly) no-CSS, fast, minimalist Zola theme

Author: Ahmed

This theme requires Zola version 0.4.0 and above

License: MIT

Homepage: https://git.sr.ht/~gumxcc/zola-no-style-please

Live Demo: https://zola-no-style-please.demo.gumx.cc

Last updated: 2025-10-16T17:33:00+03:00

no style, please!

A (nearly) no-CSS, fast, minimalist Zola theme. Ported from from riggraz's no style, please! Jekyll theme, and you can find the demo here

Main project is on sourcehut, with mirrors on GitHub and GitLab.

Installation

First download this theme to your themes directory:

cd themes
git clone https://gitlab.com/4bcx/no-style-please.git

and then enable it in your config.toml:

theme = "no-style-please"

Options

Default taxonomies

Special templates for tags, categories, and contexts taxonomies are provided. However, generic templates exist for custom taxonomies.

To use taxonomies, in a page metadata add

[taxonomies]
tags = [ 'tag1', 'tag2' ]
categories = [ 'category A', 'B class' ]
genre = [ 'rock', 'alternative' ]   # custom taxonomy

Pages list in homepage

To enable listing of pages in homepage add the following in config.toml

[extra]
list_pages = true

If you do not want the date of the post added next to the title in the list, add the following as well:

no_list_date = true

Header and footer nav links

Also in the extra section in config.toml

[extra]

header_nav = [
    { name = "~home", url = "/" },
    { name = "#tags", url = "/tags" },
    { name = "+categories", url = "/categories" },
    { name = "@contexts", url = "/contexts" },
    { name = "example", url = "http://example.com", new_tab=true },
]
footer_nav = [
    { name = "< previous", url = "#" },
    { name = "webring", url = "#" },
    { name = "next >", url = "#" },
]

Add TOC to pages

In a page frontmatter, set extra.add_toc to true

[extra]
add_toc = true

Extra data

• author can be set in both main config and in pages metadata
• image variable can be used in pages to add an image to HTML <meta> tags
• Same for logo in main config, except this one is also used as the site icon

Horizontal rule shortcode hr()

Adds the option to insert text in the thematic break

{{ hr(data_content="footnotes") }}

is rendered

Invertable image iimg()

Images are not inverted in darkmode by default. To add an invertable image use the following

{{ iimg(src="logo.png", alt="alt text") }}

In light mode

In dark mode

Disable Twitter card

Twitter metatags are generated by default, to disable them set extra.twitter_card to false in in your config.toml

[extra]
twitter_card = true

TODO

• Add RTL support
• Write proper test pages

License

The theme is available as open source under the terms of the MIT License.