Configuration Reference

Complete guide to all configuration options available in Zolastrap.

Basic Configuration

base_url = "https://example.com/"
title: "My Website"
description: "A description of my website"
theme = "zolastrap"

Navigation Links

Add custom navigation links in the navbar:

[extra]
links = [
    {title = "Home", url = "/"},
    {title = "Blog", url = "/blog"},
    {title = "Docs", url = "/docs"},
    {title = "GitHub", url = "https://github.com/user/repo"},
]

Links with Icons

Use FontAwesome icons in your navigation:

links = [
    {title = "Home", url = "/", icon = "fas fa-home"},
    {title = "GitHub", url = "https://github.com", icon = "fab fa-github"},
]

Theme Configuration

Bootswatch Themes

Choose from 26 available Bootswatch themes:

[extra]
theme = "simplex"  # Options: default, cerulean, cosmo, cyborg, darkly, flatly, journal, litera, lumen, lux, materia, minty, morph, pulse, quartz, sandstone, sketchy, slate, solar, spacelab, superhero, united, vapor, yeti, zephyr

Theme Switcher

Enable user-selectable theme switching:

[extra]
themes = "Choose a Theme"
data_themes = [
    "cerulean",
    "cosmo",
    "darkly",
    "simplex",
]

Color Schemes

Navbar Background

[extra]
bg = "dark"  # dark, light, primary, secondary, success, danger, warning, info
inverted = false  # true or false

Scheme Switcher

Enable color scheme selection:

[extra]
schemes = "Choose a Color Scheme"
data_schemes = [
    "dark",
    "light",
    "primary",
    "success",
]

Search Configuration

Enable built-in search:

build_search_index = true

[extra]
search = "Search..."

Social Icons

Add social media links in the footer:

[extra]
email = "contact@example.com"

icons = [
    {title = "GitHub", icon = "github", url = "https://github.com"},
    {title = "Twitter", icon = "twitter", url = "https://twitter.com"},
    {title = "LinkedIn", icon = "linkedin", url = "https://linkedin.com"},
]

Comments (Utterances)

Enable GitHub Issues-based comments:

[extra]
utterances = "user/repo"
utterances_label = "Comments"
utterances_theme = "github-light"
utterances_issue_term = "pathname"

Full Example

base_url = "https://example.com/"
title: "My Site"
description: "A beautiful Bootstrap site"
theme = "zolastrap"
output_dir = "docs"

taxonomies = [
    {name = "tags", paginate_by = 5},
    {name = "authors", paginate_by = 5},
]

build_search_index = true

[extra]
theme = "simplex"
bg = "dark"
inverted = false

themes = "Theme"
schemes = "Color"
search = "Search"
tags = "Tags"

links = [
    {title = "Home", url = "/"},
    {title = "Blog", url = "/articles"},
    {title = "Docs", url = "/docs"},
]

icons = [
    {title = "GitHub", icon = "github", url = "https://github.com"},
    {title = "Twitter", icon = "twitter", url = "https://twitter.com"},
]

email = "hello@example.com"