docusaurus-advanced
掌握 Docusaurus 配置
文件編寫團隊難以自定義超出基本設置的 Docusaurus 站點。本技能提供有關插件、主題自定義和 MDX 整合的深入指導，適用於高級文件網站。
下载技能 ZIP
在 Claude 中上传
前往 设置 → 功能 → 技能 → 上传技能
开启并开始使用
测试它
正在使用“docusaurus-advanced”。 How do I configure a custom API URL in Docusaurus?
预期结果:
- Expose the API URL via customFields in your docusaurus.config.ts
- Set environment variable: DOCUSAURUS_API_URL or use default
- Access in client-side components via themeConfig.apiUrl
- Configure AuthBar navbar item for authenticated sections
正在使用“docusaurus-advanced”。 What is theme swizzling and when should I use it?
预期结果:
- Theme swizzling replaces Docusaurus theme components with custom versions
- Use it when CSS overrides are not sufficient for your customization needs
- Create component in src/theme/ComponentName to override
- Avoid modifying node_modules directly to prevent upgrade issues
正在使用“docusaurus-advanced”。 How do I organize my documentation sidebar?
预期结果:
- Define sidebar structure in sidebars.ts for consistent navigation
- Use autogenerated sidebars for automatic index creation
- Group related docs using category nodes
- Enable collapsible categories for better user experience
安全审计
安全This skill is a pure documentation guide containing only informational content about Docusaurus configuration. The static analysis flagged 34 pattern-based findings, but evaluation confirms ALL are false positives: the 'hardcoded URLs' are repository metadata, 'C2 keywords' refer to content hash fields, 'weak cryptographic algorithms' are SHA-256 integrity hashes, and 'shell backticks' are documentation file path references. No executable code, command execution, or credential exfiltration exists.
风险因素
🌐 网络访问 (3)
📁 文件系统访问 (1)
⚙️ 外部命令 (9)
🔑 环境变量 (2)
质量评分
你能构建什么
自定義文件網站
學習使用自定義 CSS 和佈局修改來為 Docusaurus 站點添加主題和品牌特色。
添加互動組件
整合 MDX 組件和自定義插件，使用互動元素增強文件內容。
配置構建管道
為文件設置 API 整合、環境變量和部署配置。
试试这些提示
Explain the structure of docusaurus.config.ts and how to configure the basic settings for a documentation site.
What plugins and presets are available in Docusaurus and how do I configure the classic preset for docs, blog, and pages?
How do I customize the Docusaurus theme using CSS overrides and theme swizzling? What files should I modify?
How do I use MDX to create interactive documentation components in Docusaurus? Provide examples of embedded React components.
最佳实践
- 使用經典預設集來構建標準文件網站，包含 docs、blog 和 pages
- 將自定義 CSS 保持在 textbook/src/css/custom.css 中以實現乾淨的主題覆蓋
- 在 sidebars.ts 中定義側邊欄以實現網站一致的導航
避免
- 避免直接修改 Docusaurus 源代碼文件；改用 theme swizzling
- 不要硬編碼 API URL；對不同部署使用環境變量
- 避免跳過側邊欄配置；這會導致不一致的導航