preview image

simple-dev-blog-zola-starter

A simple dev-blog theme for Zola. It uses no JavaScript, prerenders links between navigation, blog posts and tags and adds common tags for SEO.

You can view it live here.

How to get started

To create a new Zola site, first download the CLI and install it on your system. This theme requires Zola version 0.14 or greater.

You can find installation instructions on the Zola website.

  1. After you've installed the Zola CLI, run the following command to create a new site:

    zola init my_amazing_site
    cd my_amazing_site
    
  2. After you've created the site, install the "Simple Dev Blog" theme like so:

    git clone --depth=1 \
      https://github.com/bennetthardwick/simple-dev-blog-zola-starter \
      themes/simple-dev-blog
    
  3. Now in your config.toml file, choose the theme by setting theme = "simple-dev-blog".

  4. This theme uses the tags taxonomy, in your config.toml file set taxonomies = [ { name = "tags" } ]

  5. Copy across the default content from the theme by running cp themes/simple-dev-blog/content/* ./content -r

  6. That's it! Now build your site by running the following command, and navigate to 127.0.0.1:111:

    zola serve
    

You should now have a speedy simple dev blog up and running, have fun!

Customisation

Look at the config.toml and theme.toml in this repo for an idea, here's a list of all the options:

Global

The following options should be under the [extra] in config.toml

Page

The following options should be under the [extra] section of each page