# 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.

```shell
zola init website # Create website
```

Clone this repo into the `themes` directory. 

```shell
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.

```toml
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:
```toml
# 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.