Configuration

이제 Goyo 테마의 설정을 알아봅니다. 테마를 커스텀하게 사용하기 위한 여러가지 설정을 제공합니다. config.toml에서 사용할 수 있습니다.

로고

logo_text / logo_image_path

  • logo_text: 로고 이미지 없을 때 표시되는 텍스트
  • logo_image_path: 로고 이미지 경로
[extra]
logo_text = "Goyo"
logo_image_path = "images/goyo.png"

푸터

footer_html

  • footer_html: 푸터에 표시되는 HTML 코드
[extra]
footer_html = "Powered by <a href='https://www.getzola.org'>Zola</a> and <a href='https://github.com/hahwul/goyo'>Goyo</a>"

썸네일

default_thumbnail

  • default_thumbnail: 기본 썸네일 이미지 경로
[extra]
default_thumbnail = "images/default_thumbnail.jpg"

트위터

twitter_site / twitter_creator

  • twitter_site: 트위터 사이트 핸들
  • twitter_creator: 트위터 생성자 핸들
[extra]
twitter_site = "@hahwul"
twitter_creator = "@hahwul"

컬러셋

default_colorset

  • default_colorset: 기본 테마 (dark/light)
[extra]
default_colorset = "dark"

구글 태그

gtag

  • gtag: 구글 태그 ID
[extra]
gtag = "G-XXXXXXXXXX"

사이드바 확장 깊이

sidebar_expand_depth

  • sidebar_expand_depth: 사이드바 섹션이 기본적으로 확장되어야 하는 깊이(최대 5)를 지정합니다. 예를 들어, 1 값은 최상위 섹션만 표시하고, 2는 첫 번째 하위 섹션 수준을 확장합니다.
[extra]
sidebar_expand_depth = 2

네비게이션

nav

  • nav: 상단 네비게이션 메뉴
[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: true로 설정하면 루트 페이지 (/ 또는 /{lang}/)에서 사이드바가 숨겨지지 않습니다. 이를 통해 메인 랜딩 페이지에서도 사이드바를 항상 볼 수 있습니다.
[extra]
disable_root_sidebar_hide = false

댓글

comments

  • comments: 댓글 기능 설정 (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"