Ahmed Alaa e094ecaf35 Merge branch 'new-tab' into 'main'

templates/base: support opening nav items in new tab

See merge request 4bcx/no-style-please!4

2023-04-05 18:46:07 +00:00

2.5 KiB

Raw Blame History

no style, please!

A (nearly) no-CSS, fast, minimalist Zola theme. Ported from from riggraz's no style, please! Jekyll theme, and I use it for my site

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

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

TODO

Add RTL support
Write proper test pages

License

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

2.5 KiB Raw Blame History