name: docusaurus-advanced description: 深入探讨Docusaurus的配置、插件和自定义字段。
Docusaurus配置
配置文件
- 文件:
textbook/docusaurus.config.ts - 类型: TypeScript配置文件。
集成功能
- API URL: 通过
customFields暴露给客户端。customFields: { apiUrl: process.env.DOCUSAURUS_API_URL || 'http://127.0.0.1:8000', } - AuthBar: 一个自定义导航栏项目，注册在
textbook/src/theme/NavbarItem中（如果进行了主题定制）或专门导入。
插件与预设
- 预设:
classic（标准文档、博客、页面功能）。 - 侧边栏: 在
textbook/sidebars.ts中定义。
主题定制
- 自定义CSS:
textbook/src/css/custom.css（包含针对深色模式和高级UI的特定覆盖样式）。 - 布局:
Layout包装器常用于src/pages目录中，用于在Docusaurus内创建独立的React页面。
MDX
我们支持在文档中使用MDX，以便集成交互式组件。