↑ ↓ to navigate
    ↵ to select
    esc to close
    Goyo

    Configuration

    Goyo의 설정 방법을 알아보세요.

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

    로고

    logo_text / logo_image_path / logo_image_padding

    • logo_text: 로고 이미지 없을 때 표시되는 텍스트
    • logo_image_path: 로고 이미지 경로
    • logo_image_padding: 로고 이미지에 적용할 padding 값 (예: "5px")
    [extra]
logo_text = "Goyo"
logo_image_path = "images/goyo.png"
logo_image_padding = "5px"

    푸터

    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"

    밝기

    brightness

    • brightness: 테마 전반적인 색상의 밝기를 조절합니다. 옵션:
      • "darker": 색상을 더 어둡게 - 다크 테마는 완전히 검정색으로, 라이트 테마는 더 어두운 색으로 변경됩니다
      • "normal": 기본 밝기 (기본값)
      • "lighter": 색상을 더 밝게 - 두 테마 모두 더 밝아집니다
    [extra]
brightness = "normal"  # 옵션: "darker", "normal", "lighter"

    예시:

    • 완전히 검정색인 다크 테마를 원하는 경우: brightness = "darker"
    • 라이트 테마를 더 어둡게 만들려면: brightness = "darker" 와 default_colorset = "light" 설정
    • 다크 테마를 더 밝게 만들려면: brightness = "lighter"

    구글 태그

    gtag

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

    사이드바 확장 깊이

    sidebar_expand_depth

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

    네비게이션

    nav / nav_{lang}

    • nav: 상단 네비게이션 메뉴입니다. name과 icon 필드는 optional 입니다.
    • nav_{lang}: 언어별 네비게이션 메뉴입니다 (예: nav_ko는 한국어용). 정의되면 해당 언어에서 기본 nav 대신 사용됩니다.
    [extra]
# 기본 네비게이션 (영어 및 폴백용)
nav = [
    { name = "Documents", url = "/introduction", type = "url", icon = "fa-solid fa-book" },
    { name = "GitHub", url = "https://github.com/hahwul/goyo", type = "url", icon = "fa-brands fa-github" },
    { name = "Links", type = "dropdown", icon = "fa-solid fa-link", members = [
        { name = "Creator Blog", url = "https://www.hahwul.com", type = "url", icon = "fa-solid fa-fire-flame-curved" },
    ] },
]

# 한국어 네비게이션 (선택사항)
nav_ko = [
    { name = "문서", url = "/ko/introduction", type = "url", icon = "fa-solid fa-book" },
    { name = "GitHub", url = "https://github.com/hahwul/goyo", type = "url", icon = "fa-brands fa-github" },
    { name = "링크", type = "dropdown", icon = "fa-solid fa-link", members = [
        { name = "제작자 블로그", url = "https://www.hahwul.com", type = "url", icon = "fa-solid fa-fire-flame-curved" },
    ] },
]

    언어 별칭

    lang_aliases

    • lang_aliases: 언어 선택 드롭다운에 표시될 언어의 사용자 정의 이름입니다. 정의하지 않으면 언어 코드가 표시됩니다. 이를 통해 "en" 또는 "ko" 대신 "English" 또는 "한국어"와 같은 사용자 친화적인 이름을 표시할 수 있습니다.
    [extra]
# 언어 선택기의 언어 표시 이름
lang_aliases = { en = "English", ko = "한국어" }

    필요한 만큼 언어를 추가할 수 있습니다:

    [extra]
lang_aliases = { 
    en = "English", 
    ko = "한국어",
    ja = "日本語",
    id = "Bahasa Indonesia"
}

    테마 토글 비활성화

    disable_theme_toggle

    • disable_theme_toggle: true로 설정하면 상단 네비게이션에서 테마(다크/라이트) 토글 버튼이 표시되지 않습니다.
    [extra]
disable_theme_toggle = true

    루트 사이드바 숨기기 비활성화

    disable_root_sidebar_hide

    • disable_root_sidebar_hide: true로 설정하면 루트 페이지 (/ 또는 /{lang}/)에서 사이드바가 숨겨지지 않습니다. 이를 통해 메인 랜딩 페이지에서도 사이드바를 항상 볼 수 있습니다.
    [extra]
disable_root_sidebar_hide = false

    편집 URL

    edit_url

    • edit_url: 페이지 편집을 위한 기본 URL. 설정하면 각 페이지/섹션 하단에 "Edit this page" 링크가 나타나며, 저장소의 소스 파일로 연결됩니다.
    [extra]
edit_url = "https://github.com/hahwul/goyo/edit/main"

    링크는 자동으로 콘텐츠 파일의 상대 경로를 추가합니다 (예: content/introduction/_index.md).

    댓글

    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"
    Edit this page