baseURL: https://sfclub.cc/~sfcraft
locale: zh-CN
defaultContentLanguage: zh
title: SFCraft 文档
theme: hugo-book

module:
  hugoVersion:
    # layouts/_partials 与 layouts/_shortcodes 目录需要 0.146+,
    # 贴图解析用到的 try 需要 0.141+, hugo.Data 需要 0.156+
    min: 0.156.0

params:
  BookTheme: auto          # 明/暗跟随系统
  BookSection: '*'         # 每个顶层 section 渲染为侧边栏一个栏目
  BookToC: true
  BookSearch: true

  # crafting 组件的物品贴图解析, 见 layouts/_partials/sfcraft/item-texture.html
  itemTextures:
    localDir: items        # 手动放置贴图的目录 (assets/<localDir>/<id>.png)
    publishDir: sfc/items  # 贴图发布到站点内的路径
    userAgent: sfcraft-docs (+https://github.com/saltedfishclub/sfcraft-docs)
    onMissing: error       # 贴图确实不存在时: error 阻断构建 / warn 仅告警 / ignore 静默
    repo:
      enable: true
      # sfcraft 自定义物品贴图; 换版本时改这里的 ref 即可
      baseURL: https://raw.githubusercontent.com/saltedfishclub/sfcraft/rev/26.2/src/main/resources/assets/sfcraft/textures/item/
    wiki:
      enable: true
      api: https://zh.minecraft.wiki/api.php

# 远程贴图与 wiki 查询的抓取缓存: 永不过期, 落在 cacheDir 下。
# 首次构建后即可离线构建; 需要拉取上游更新时执行 hugo --ignoreCache。
caches:
  getresource:
    dir: :cacheDir/:project
    maxAge: -1

markup:
  goldmark:
    renderer:
      unsafe: true         # hugo-book 与 hugo-admonitions 均需要
  tableOfContents:
    startLevel: 1
    endLevel: 3