Shawl

• A simple, unintrusive theme for Zola.

Goals

• Minimal CSS
• Appealing design
• Readable code
• Dry templating

Dependencies

• zola

Install

If you haven't already, initialize a website. Say "No" to enabling Sass compilation, enabling syntax highlighting, and building a search index of content. Shawl does not take advantage of any of these features.

zola init website # Create website

Clone this repo into the themes directory.

cd themes
git clone https://git.foswret.com/shawl

Edit the zola.toml file in the root directory to something like this. Everything should be pretty standard, except the inclusion of [extra] and navbar_items. This theme requires all items in the navigation bar to be specified manually. In this example, the "Posts" section is added, but of this of course can be any section you wish.

base_url = "https://mysite.com"

# Site title and description
title = "my site"
description = ""
default_language = "en"

theme = "shawl"

[extra]
navbar_items = [
{ name = "Home", url = "/", divider = " | " },
{ name = "Posts", url = "/posts" },
]

Config

• To generate an atom.xml file, and enable smart punctuation:

# Generate RSS feed
generate_feeds = true

[markdown]
# Change quotes into curly quotes
smart_punctuation = true

• the stylesheet is located in static/style.css.
  • The header color can be changed by changing the value of the --primary-header-color variable.
  • Change the accent background by changing the location of your background image, as defined in the #right-header ID.
• In your website's root directory, create a file footer.html in a templates/paritals directory. This way, you can customize your footer however you like.