用途:面向需要深入定制 Docusaurus 文档站的开发者,讲解配置文件、插件、预设、主题与自定义字段的使用方式。
配置文件:配置文件位于 textbook/docusaurus.config.ts,采用 TypeScript 配置。
自定义字段:通过 customFields 将 API URL 暴露给客户端,示例如下:
customFields: { apiUrl: process.env.DOCUSAURUS_API_URL || 'http://127.0.0.1:8000', }
登录栏:AuthBar 是一个自定义 navbar item,注册在 textbook/src/theme/NavbarItem(若已 swizzle)或单独导入。
插件与预设:使用 classic 预设,包含标准文档、博客与页面;侧边栏在 textbook/sidebars.ts 中定义。
主题 swizzling:自定义 CSS 位于 textbook/src/css/custom.css,包含深色模式与高级 UI 的特定覆盖;Layout 包装器常用于 src/pages 中 Docusaurus 内的独立 React 页面。
MDX:支持 MDX,可在文档中嵌入交互式组件。
限制:资料未提供价格、收费、平台支持范围与具体安装命令等信息,相关细节暂未提供。