zola/docs/content/themes/feather/index.md
2021-08-02 14:32:05 +00:00

3 KiB

+++ title = "feather" description = "A modern blog theme" template = "theme.html" date = 2021-08-02T23:30:47+09:00

[extra] created = 2021-08-02T23:30:47+09:00 updated = 2021-08-02T23:30:47+09:00 repository = "https://github.com/piedoom/feather" homepage = "https://github.com/piedoom/feather" minimum_version = "0.5.1" license = "MIT" demo = ""

[extra.author] name = "doomy" homepage = "https://alexanderlozada.com" +++

feather

A lightweight theme for zola

Feather is a blog theme specifically designed for the static site generator Zola. It's as far as I know the first theme for the platform that isn't a port or just contained within template files.

Feather is not intended for anything other than blogs.

Developing & Contributing

Because feather comes with example content, you can run the theme just like any Gutenberg blog with zola serve. Your changes will autoreload!

Considerations

Please don't edit the content folder directly for your own blog, use it as a theme like intended!

Usage

Using feather is easy. Install Zola and follow the guide for creating a site and using a theme. Then, add theme = "feather" to your config.toml file.

If you intend to publish your site to Github Pages, please check out this tutorial.

Options

Zola allows themes to define [extra] variables in the config. Here's a full list of theme variables with example values and comments.

[extra]
# specify an image for the big header at the top of the page.
# this will be a background cover image, so make it large enough
# so that it won't upscale enough to pixelate
feather_header_image = "/theme_images/default.gif"

# if you want comments, add your disqus embed code here.  
# you can obtain a code on the disqus website.
feather_disqus_code = "<div id='disqus_thread'></div><script> var disqus_config = ... etc ... etc ..."

# if you'd like people to be able to donate to you, you can include a donate link
# to be displayed in the footer of the website.
feather_donate_link = "https://paypal.me/piedoomy"

# if you want analytics, add your tracking code HTML here.
feather_analytics = "<script async src='https://www.googletagmanager.com/gtag/... etc ... etc ..."

Features

Feather also provides several features optional.

  • Categories page
  • Tags page
  • Sorting chronologically
  • Comments
  • Analytics
  • Donate links

Using Categories and Tags

In order to use categories and tags, you'll need to enable their compilation by adding the following lines to your config.toml (make sure they aren't under [extra]):

generate_categories_pages = true
generate_tags_pages = true

Live demo

My dev site uses the latest version of feather.