zola/docs/content/themes/sam/index.md

+++ title = "sam" description = "A Simple and Minimalist theme with a focus on typography and content." template = "theme.html" date = 2024-09-02T05:58:27Z

[extra] created = 2024-09-02T05:58:27Z updated = 2024-09-02T05:58:27Z repository = "https://github.com/janbaudisch/zola-sam.git" homepage = "https://github.com/janbaudisch/zola-sam" minimum_version = "0.4.0" license = "AGPL-3.0" demo = "https://zola-sam.janbaudisch.dev"

[extra.author] name = "Jan Baudisch" homepage = "https://janbaudisch.dev" +++

Sam

A Simple and Minimalist theme with a focus on typography and content.

Zola port of hugo-theme-sam.

Original

This is a port of the original hugo-theme-sam theme for Hugo (License).

See upstream for source code take from there.

Installation

The easiest way to install this theme is to either clone it ...

git clone https://github.com/janbaudisch/zola-sam.git themes/sam

... or to use it as a submodule.

git submodule add https://github.com/janbaudisch/zola-sam.git themes/sam

Either way, you will have to enable the theme in your config.toml.

theme = "sam"

Taxonomies

Sam supports the tags and authors taxonomies.

To use them, declare them in your config.toml:

taxonomies = [
    { name = "tags", rss = true },
    { name = "authors", rss = true }
]

Set them in your page's frontmatter:

[taxonomies]
tags = ["some", "tag"]
authors = ["Alice", "Sam"]

See Zola's documentation for more details.

Options

See config.toml for an example configuration.

Menu

The menu on the index page is created as follows: If the sam_menu variable is set, it gets used.

[extra]
sam_menu = [
    { text = "posts", link = "/posts" },
    { text = "about", link = "/about" },
    { text = "github", link = "https://github.com" }
]

If it is not set, all sections under content will get linked.

Bottom menu

This variable decides wether the menu - as mentioned above - will also be displayed at the bottom of pages.

Default: false

[extra]
sam_bottom_menu = true

home

Sets the name for all links referring to the home page in the menus and the 404 page.

Default: home

[extra]
home = "home"

Date format

Specifies how to display dates. The format is described here.

Default: %a %b %e, %Y

[extra]
date_format = "%a %b %e, %Y"

Word count and reading time

You can enable or disable word count and reading time for posts across the whole site:

Default: true (both)

[extra]
show_word_count = true
show_reading_time = true

If enabled, you can opt-out per page via front-matter:

Default: false (both)

+++
[extra]
hide_word_count = true
hide_reading_time = true
+++

Disable page header

If you want to disable the complete header of a page (for example a page which is explicitly not a post), you can do so via front-matter:

Default: false

+++
[extra]
no_header = true
+++

Footer

To place some text at the end of pages, set the following:

[extra.sam_footer]
text = "Some footer text."