docusaurus-advanced

深入探讨Docusaurus配置、插件和自定义字段。

📖 中文导读:深入探讨Docusaurus配置、插件和自定义字段。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: Docusaurus Advanced description: Deep dive into the Docusaurus configuration, plugins, and custom fields.

Docusaurus Configuration

Config File

  • File: textbook/docusaurus.config.ts
  • Type: TypeScript config.

Integrations

  • API URL: Exposed to client via customFields.
    customFields: {
      apiUrl: process.env.DOCUSAURUS_API_URL || 'http://127.0.0.1:8000',
    }
    
  • AuthBar: A custom navbar item registered in textbook/src/theme/NavbarItem (if swizzled) or imported specifically.

Plugins & Presets

  • Preset: classic (standard docs, blog, pages).
  • Sidebar: Defined in textbook/sidebars.ts.

Theme Swizzling

  • Custom CSS: textbook/src/css/custom.css (contains specific overrides for dark mode and premium UI).
  • Layout: Layout wrapper is often used in src/pages for standalone React pages within Docusaurus.

MDX

We support MDX for interactive components within documentation.