docusaurus.config.ts

import {themes as prismThemes} from 'prism-react-renderer';
import type {Config} from '@docusaurus/types';
import type * as Preset from '@docusaurus/preset-classic';

const config: Config = {
  title: 'ECC 源码拆解',
  tagline: '从 Agent 素材库到跨 Harness 工程操作系统',
  favicon: 'img/favicon.svg',
  url: 'https://hanqing.github.io',
  baseUrl: '/ecc-source-notes/',
  organizationName: 'Hanqing',
  projectName: 'ecc-source-notes',
  onBrokenLinks: 'throw',
  markdown: {
    hooks: {onBrokenMarkdownLinks: 'throw'},
  },
  i18n: {
    defaultLocale: 'zh-Hans',
    locales: ['zh-Hans'],
  },
  presets: [
    [
      'classic',
      {
        docs: {
          sidebarPath: './sidebars.ts',
          routeBasePath: 'docs',
          showLastUpdateAuthor: false,
          showLastUpdateTime: false,
          editUrl: 'https://github.com/Hanqing/ecc-source-notes/tree/main/',
        },
        blog: false,
        theme: {
          customCss: './src/css/custom.css',
        },
      } satisfies Preset.Options,
    ],
  ],
  themeConfig: {
    image: 'img/ecc-social-card.svg',
    metadata: [
      {name: 'keywords', content: 'ECC, Everything Claude Code, Agent harness, 源码拆解, Docusaurus'},
      {name: 'description', content: 'Everything Claude Code (ECC) 2.1.0 的中文源码架构拆解。'},
    ],
    colorMode: {
      respectPrefersColorScheme: true,
    },
    navbar: {
      title: 'ECC 源码拆解',
      logo: {alt: 'ECC', src: 'img/ecc-icon.svg'},
      items: [
        {type: 'docSidebar', sidebarId: 'analysisSidebar', position: 'left', label: '开始阅读'},
        {href: 'https://github.com/affaan-m/ECC', label: '上游 ECC', position: 'right'},
        {href: 'https://github.com/Hanqing/ecc-source-notes', label: '本文档仓库', position: 'right'},
      ],
    },
    footer: {
      style: 'dark',
      links: [
        {title: '阅读路线', items: [{label: '从这里开始', to: '/docs/intro'}, {label: '总体架构', to: '/docs/chapters/ch02-architecture'}]},
        {title: '源码入口', items: [{label: 'ECC 上游仓库', href: 'https://github.com/affaan-m/ECC'}, {label: '安装器', href: 'https://github.com/affaan-m/ECC/tree/main/scripts'}]},
      ],
      copyright: `ECC 源码拆解 · 基于 ECC 2.1.0 快照 · Built with Docusaurus`,
    },
    prism: {
      theme: prismThemes.github,
      darkTheme: prismThemes.dracula,
    },
    tableOfContents: {minHeadingLevel: 2, maxHeadingLevel: 3},
  } satisfies Preset.ThemeConfig,
};

export default config;