hugo.yaml

baseURL: 'https://ddia.vonng.com/'
locale: 'zh-CN'
title: '设计数据密集型应用（第二版）'

enableRobotsTXT: true
enableGitInfo: true
hasCJKLanguage: true

services:
  googleAnalytics:
    id: G-SGY2FPH1EG

# OINK leaves generated surfaces to the consumer site. Markdown powers the
# page actions, LLMS emits llms.txt, and print enables whole-book views.
outputs:
  home: [HTML, print, markdown, LLMS]
  page: [HTML, markdown]
  section: [HTML, RSS, print, markdown]

module:
  imports:
    - path: github.com/pgsty/oink

defaultContentLanguage: zh
languages:
  zh:
    label: 简体 · 二版
    locale: zh-CN
    contentDir: content/zh
    weight: 1
    title: 设计数据密集型应用（第二版）
    params:
      description: DDIA 第二版中文翻译，系统讲解数据模型、存储、事务、分布式系统、批处理与流处理。
      version: v2
      version_menu: 第二版
      versions:
        - { name: 第二版, version: v2, url: 'https://ddia.vonng.com/' }
        - { name: 第一版, version: v1, url: '/v1/' }
      comments:
        giscus:
          ariaLabel: 评论
          errorMessage: 评论加载失败，请稍后重试。
      time_format_default: '2006-01-02'
      ui:
        command_palette:
          commands:
            - id: start_reading
              title: 从第一章开始阅读
              description: 进入第二版第一章“数据系统架构中的权衡”
              url: /ch1/
              icon: fa-solid fa-book-open
              keywords: [开始, 阅读, 第一章]
            - id: browse_glossary
              title: 浏览术语表
              description: 查找本书中的数据系统术语
              url: /glossary/
              icon: fa-solid fa-spell-check
              keywords: [术语, 定义, glossary]
            - id: print_book
              title: 打印整本书
              description: 打开第二版整书打印视图，可另存为 PDF
              url: /_print/
              icon: fa-solid fa-print
              keywords: [整书, 打印, PDF, print]
    menus:
      main:
        - identifier: read
          name: 阅读
          pageRef: /toc
          weight: 10
          params: { icon: fa-solid fa-book-open }
        - identifier: toc
          parent: read
          name: 完整目录
          pageRef: /toc
          weight: 10
          params: { icon: fa-solid fa-list, description: 浏览第二版十四章与三个部分 }
        - identifier: glossary
          parent: read
          name: 术语表
          pageRef: /glossary
          weight: 20
          params: { icon: fa-solid fa-spell-check, description: 快速查找数据系统核心术语 }
        - identifier: indexes
          parent: read
          name: 索引
          pageRef: /indexes
          weight: 30
          params: { icon: fa-solid fa-arrow-down-a-z, description: 按主题定位第二版内容 }
        - identifier: contribute
          name: 贡献
          pageRef: /contrib
          weight: 20
          params: { icon: fa-solid fa-code-pull-request }
  tw:
    label: 繁體 · 二版
    locale: zh-TW
    contentDir: content/tw
    weight: 2
    title: 設計資料密集型應用（第二版）
    params:
      description: DDIA 第二版繁體中文翻譯，系統講解資料模型、儲存、事務、分散式系統、批次處理與串流處理。
      version: v2
      version_menu: 第二版
      versions:
        - { name: 第二版, version: v2, url: '/tw/' }
        - { name: 第一版, version: v1, url: '/v1_tw/' }
      comments:
        giscus:
          ariaLabel: 評論
          errorMessage: 評論載入失敗，請稍後再試。
      time_format_default: '2006-01-02'
      ui:
        command_palette:
          commands:
            - id: start_reading
              title: 從第一章開始閱讀
              description: 進入第二版第一章「資料系統架構中的權衡」
              url: /ch1/
              icon: fa-solid fa-book-open
              keywords: [開始, 閱讀, 第一章]
            - id: browse_glossary
              title: 瀏覽術語表
              description: 查找本書中的資料系統術語
              url: /glossary/
              icon: fa-solid fa-spell-check
              keywords: [術語, 定義, glossary]
            - id: print_book
              title: 列印整本書
              description: 開啟第二版整書列印檢視，可另存為 PDF
              url: /_print/
              icon: fa-solid fa-print
              keywords: [整書, 列印, PDF, print]
    menus:
      main:
        - identifier: read
          name: 閱讀
          pageRef: /toc
          weight: 10
          params: { icon: fa-solid fa-book-open }
        - identifier: toc
          parent: read
          name: 完整目錄
          pageRef: /toc
          weight: 10
          params: { icon: fa-solid fa-list, description: 瀏覽第二版十四章與三個部分 }
        - identifier: glossary
          parent: read
          name: 術語表
          pageRef: /glossary
          weight: 20
          params: { icon: fa-solid fa-spell-check, description: 快速查找資料系統核心術語 }
        - identifier: indexes
          parent: read
          name: 索引
          pageRef: /indexes
          weight: 30
          params: { icon: fa-solid fa-arrow-down-a-z, description: 按主題定位第二版內容 }
        - identifier: contribute
          name: 貢獻
          pageRef: /contrib
          weight: 20
          params: { icon: fa-solid fa-code-pull-request }
  v1:
    label: 简体 · 一版
    locale: zh-CN
    contentDir: content/v1
    weight: 3
    title: 设计数据密集型应用（第一版）
    params:
      description: DDIA 第一版中文翻译，涵盖可靠性、数据模型、存储、复制、分区、事务与派生数据。
      version: v1
      version_menu: 第一版
      # The fragment keeps OINK from treating the site's base URL as active
      # while this language site is serving the first edition.
      versions:
        - { name: 第二版, version: v2, url: 'https://ddia.vonng.com/#' }
        - { name: 第一版, version: v1, url: '/v1/' }
      comments:
        giscus:
          ariaLabel: 评论
          errorMessage: 评论加载失败，请稍后重试。
      time_format_default: '2006-01-02'
      ui:
        command_palette:
          commands:
            - id: start_reading
              title: 从第一章开始阅读
              description: 进入第一版第一章“可靠性、可伸缩性和可维护性”
              url: /ch1/
              icon: fa-solid fa-book-open
              keywords: [开始, 阅读, 第一章]
            - id: browse_glossary
              title: 浏览术语表
              description: 查找第一版中的数据系统术语
              url: /glossary/
              icon: fa-solid fa-spell-check
              keywords: [术语, 定义, glossary]
            - id: print_book
              title: 打印整本书
              description: 打开第一版整书打印视图，可另存为 PDF
              url: /_print/
              icon: fa-solid fa-print
              keywords: [整书, 打印, PDF, print]
    menus:
      main:
        - identifier: read
          name: 阅读
          pageRef: /toc
          weight: 10
          params: { icon: fa-solid fa-book-open }
        - identifier: toc
          parent: read
          name: 完整目录
          pageRef: /toc
          weight: 10
          params: { icon: fa-solid fa-list, description: 浏览第一版十二章与三个部分 }
        - identifier: glossary
          parent: read
          name: 术语表
          pageRef: /glossary
          weight: 20
          params: { icon: fa-solid fa-spell-check, description: 快速查找数据系统核心术语 }
        - identifier: colophon
          parent: read
          name: 后记
          pageRef: /colophon
          weight: 30
          params: { icon: fa-solid fa-feather-pointed, description: 阅读第一版译者与作者后记 }
        - identifier: contribute
          name: 贡献
          pageRef: /contrib
          weight: 20
          params: { icon: fa-solid fa-code-pull-request }
  v1_tw:
    label: 繁體 · 一版
    locale: zh-TW
    contentDir: content/v1_tw
    weight: 4
    title: 設計資料密集型應用（第一版）
    params:
      description: DDIA 第一版繁體中文翻譯，涵蓋可靠性、資料模型、儲存、複製、分割槽、事務與衍生資料。
      version: v1
      version_menu: 第一版
      versions:
        - { name: 第二版, version: v2, url: '/tw/' }
        - { name: 第一版, version: v1, url: '/v1_tw/' }
      comments:
        giscus:
          ariaLabel: 評論
          errorMessage: 評論載入失敗，請稍後再試。
      time_format_default: '2006-01-02'
      ui:
        command_palette:
          commands:
            - id: start_reading
              title: 從第一章開始閱讀
              description: 進入第一版第一章「可靠性、可伸縮性和可維護性」
              url: /ch1/
              icon: fa-solid fa-book-open
              keywords: [開始, 閱讀, 第一章]
            - id: browse_glossary
              title: 瀏覽術語表
              description: 查找第一版中的資料系統術語
              url: /glossary/
              icon: fa-solid fa-spell-check
              keywords: [術語, 定義, glossary]
            - id: print_book
              title: 列印整本書
              description: 開啟第一版整書列印檢視，可另存為 PDF
              url: /_print/
              icon: fa-solid fa-print
              keywords: [整書, 列印, PDF, print]
    menus:
      main:
        - identifier: read
          name: 閱讀
          pageRef: /toc
          weight: 10
          params: { icon: fa-solid fa-book-open }
        - identifier: toc
          parent: read
          name: 完整目錄
          pageRef: /toc
          weight: 10
          params: { icon: fa-solid fa-list, description: 瀏覽第一版十二章與三個部分 }
        - identifier: glossary
          parent: read
          name: 術語表
          pageRef: /glossary
          weight: 20
          params: { icon: fa-solid fa-spell-check, description: 快速查找資料系統核心術語 }
        - identifier: colophon
          parent: read
          name: 後記
          pageRef: /colophon
          weight: 30
          params: { icon: fa-solid fa-feather-pointed, description: 閱讀第一版譯者與作者後記 }
        - identifier: contribute
          name: 貢獻
          pageRef: /contrib
          weight: 20
          params: { icon: fa-solid fa-code-pull-request }

markup:
  goldmark:
    extensions:
      footnote: true
      linkify: true
      table: true
      taskList: true
      typographer: true
      passthrough:
        enable: true
        delimiters:
          block:
            - ['\[', '\]']
            - ['$$', '$$']
          inline:
            - ['\(', '\)']
    parser:
      attribute: true
      autoHeadingID: true
      autoHeadingIDType: github
    renderer:
      unsafe: true
  highlight:
    noClasses: false
  tableOfContents:
    startLevel: 2
    endLevel: 4

params:
  description: DDIA 中文翻译，关于数据密集型应用架构与设计的开放阅读版本。
  logo: logo.png
  github_repo: https://github.com/Vonng/ddia
  github_project_repo: https://github.com/Vonng/ddia
  github_branch: main
  copyright:
    authors: '[中文翻译贡献者](/contrib/) 与 DDIA 翻译贡献者'
    from_year: 2017
    to_year: present

  # Local, language-aware full-text search.
  offlineSearch: true
  offlineSearchIndex: content
  offlineSearchSummaryLength: 120
  offlineSearchMaxResults: 12

  page_width: wide
  # Book content follows the normal publication measure; individual pages may
  # opt into slim or wide in front matter.
  content_width: norm
  version_menu_pagelinks: false

  comments:
    enable: true
    type: giscus
    giscus:
      repo: Vonng/ddia
      repoId: MDEwOlJlcG9zaXRvcnkxMjA3MTA2NDQ
      category: Announcements
      categoryId: DIC_kwDOBzHl9M4CtlWB
      mapping: pathname
      strict: 0
      reactionsEnabled: 1
      emitMetadata: 0
      inputPosition: bottom
      theme: auto
      lightTheme: light
      darkTheme: dark
      loading: lazy

  ui:
    quick_links: [read, contribute]
    showLightDarkModeMenu: true
    sidebar_icon_policy: groups
    sidebar_menu_compact: true
    sidebar_menu_foldable: true
    sidebar_root_enabled: true
    sidebar_root_menu: false
    sidebar_width_min: 300
    sidebar_width_max: 448
    sidebar_item_overflow: ellipsis
    sidebar_menu_truncate: 2000
    # The right rail already owns the page outline; keep the chapter tree flat.
    sidebar_headings: false
    ul_show: 2
    book_draft_banner: true
    pager:
      types: [book]
    keyboard_nav:
      enable: true
    page_context_menu:
      enable: true
      # Assistant handoffs stay disabled: activating them discloses the full
      # browser URL (including query and fragment) to a third party.
      assistant_links: false
      links: []
    # Numbered Book figures now carry caption-backed alternatives and stable
    # intrinsic dimensions, so zoom remains accessible without layout shift.
    image_zoom:
      enable: true
    typography:
      preset: system
    lastmod_commit: hash
    feedback:
      enable: false
    readingtime:
      enable: false
    scrollSpy:
      disable: false