Search

    Goyo

    Configuration

    Now let's look at the settings for the Goyo theme. It provides various settings to customize the theme. You can use them in config.toml.

    logo_text / logo_image_path

    • logo_text: Text displayed when no logo image is present.
    • logo_image_path: Path to the logo image.
    [extra]
logo_text = "Goyo"
logo_image_path = "images/goyo.png"

    footer_html

    • footer_html: HTML code displayed in the footer.
    [extra]
footer_html = "Powered by <a href='https://www.getzola.org'>Zola</a> and <a href='https://github.com/hahwul/goyo'>Goyo</a>"

    Thumbnail

    default_thumbnail

    • default_thumbnail: Path to the default thumbnail image.
    [extra]
default_thumbnail = "images/default_thumbnail.jpg"

    Twitter

    twitter_site / twitter_creator

    • twitter_site: Twitter site handle.
    • twitter_creator: Twitter creator handle.
    [extra]
twitter_site = "@hahwul"
twitter_creator = "@hahwul"

    Color

    default_colorset

    • default_colorset: Default theme (dark/light).
    [extra]
default_colorset = "dark"

    Google Tag

    gtag

    • gtag: Google Tag ID.
    [extra]
gtag = "G-XXXXXXXXXX"

    sidebar_expand_depth

    • sidebar_expand_depth: Specifies the depth (up to 5) to which sidebar sections should be expanded by default. For example, a value of 1 will only show top-level sections, while 2 will expand the first level of subsections.
    [extra]
sidebar_expand_depth = 2

    nav

    • nav: Top navigation menu.
    [extra]
nav = [
    { name = "Documents", url = "/introduction", type = "url" },
    { name = "GitHub", url = "https://github.com/hahwul/goyo", type = "url" },
    { name = "Links", type = "dropdown", members = [
        { name = "Creator Blog", url = "https://www.hahwul.com", type = "url" },
    ] },
]

    Disable Root Sidebar Hide

    disable_root_sidebar_hide

    • disable_root_sidebar_hide: If set to true, the sidebar will not be hidden on the root page (/ or /{lang}/). This allows the sidebar to always be visible, even on the main landing page.
    [extra]
disable_root_sidebar_hide = false

    Comments

    comments

    • comments: Comment feature settings (giscus/utterances).
    [extra.comments]
enabled = true
system = "giscus"
repo = "hahwul/goyo"
repo_id = "R_kgDOPHnqwg"
category = "General"
category_id = "DIC_kwDOPHnqws4CspmC"
mapping = "pathname"
strict = "0"
reactions_enabled = "1"
emit_metadata = "0"
input_position = "bottom"
theme = "catppuccin_mocha"
lang = "en"
    ‹ Get Started
    Writing ›