跳到主要内容

Theme

Docusaurus theme 加载顺序

Docusaurus 主题加载顺序如下(从高优先级到低优先级):

  1. 自定义主题组件:用户在 src/theme 目录中手动创建的组件具有最高优先级

    • 例如:src/theme/Navbar.js 会覆盖任何主题提供的导航栏组件
  2. 通过 themes 字段引入的主题:按数组中的顺序从后向前加载

    • 数组后面的主题会覆盖前面主题的相同组件
    • 示例配置:
      themes: [
      '@theme-a', // 低优先级
      '@theme-b', // 中等优先级
      '@theme-c', // 高优先级(会覆盖 A 和 B 的组件)
      ]
  3. preset-classic 中的默认主题:作为基础主题,优先级最低

    • 例如:@docusaurus/theme-classic 和相关插件
  4. 插件提供的主题:插件可能附带自己的主题组件

    • 这些组件通常会被上面的主题覆盖

使用一些 theme

搜索 algolia

pnpm add @docusaurus/theme-search-algolia