設定檔

設定檔

Hugo Stack Theme 的 config.yaml 設定檔案相關的範例及註解都在下方的程式碼片段中

# 網站網址
baseurl: https://hugo-stack-theme.kejyun.com
# 語系
languageCode: zh-tw
# 主題
theme: ["hugo-theme-stack"]
# 首頁文章顯示數量
paginate: 5
# 網站名稱
title: KJ Stack Theme

# Change it to your Disqus shortname before using
# Disqus 留言板名稱
disqusShortname:

# GA Tracking ID
googleAnalytics:

# Theme i18n support
# Available values: en, fr, id, ja, ko, pt-br, zh-cn, es, de, nl
# 預設語系
defaultContentLanguage: zh-tw

permalinks:
    # 文章網址格式
    post: /article/:year:month-:slug/
    page: /:slug/

params:
    # 主要區塊,顯示於首頁
    mainSections:
        - post
    featuredImageField: image
    # RSS Feed
    rssFullContent: true
    # 最愛 icon
    favicon: images/observe-universe.png

    # 置底
    footer:
        # 版權起始年
        since: 2021
        # 自訂版權文字
        customText: All rights reserved,未經允許不得隨意轉載

    # 日期格式
    dateFormat:
        # 發佈日期
        published: Jan 02, 2006
        # 修改日期
        lastUpdated: Jan 02, 2006
    # 側邊欄
    sidebar:
        # 表情
        emoji: 🍥
        # 副標題
        subtitle: Hugo Stack Theme Example
        avatar:
            # 是否絕對路徑
            local: true
            # 大頭貼網址
            src: img/avatar.png
    # 文章
    article:
        math: false
        # 授權
        license:
            enabled: false
            default: Licensed under CC BY-NC-SA 4.0

    # 留言板
    comments:
        # 是否開啟留言板
        enabled: true
        # 留言板供應商
        provider: disqus

        utterances:
            repo:
            issueTerm: pathname
            label:

        remark42:
            host:
            site:
            locale:

        vssue:
            platform:
            owner:
            repo:
            clientId:
            clientSecret:

    # 套件
    widgets:
        enabled:
            - search
            - archives
            - tag-cloud

        # 封存顯示文章數量
        archives:
            limit: 10

        # 標籤雲
        tagCloud:
            limit: 30

    opengraph:
        twitter:
            # Your Twitter username
            site:

            # Available values: summary, summary_large_image
            card: summary_large_image

    defaultImage:
        opengraph:
            enabled: true
            local: false
            src: images/observe-universe.png

    colorScheme:
        # Display toggle
        # 是否可切換配色
        toggle: true

        # Available values: auto, light, dark
        # 預設顏色
        default: light

    # 圖片處理
    imageProcessing:
        cover:
            enabled: true
        content:
            enabled: true


#  選單
### Custom menu
### See https://docs.stack.jimmycai.com/configuration/custom-menu
### To remove about, archive and search page menu item, remove `menu` field from their FrontMatter
menu:
    main:
        - identifier: home
          name: Home
          url: /
          weight: -100
          pre: home
# 相關文章
related:
    includeNewer: true
    threshold: 60
    toLower: false
    indices:
        - name: tags
          weight: 100

        - name: categories
          weight: 200

markup:
    highlight:
        noClasses: false

參考資料