主题配置

dumi-theme-antd-style 为了更好地满足自定义诉求，增加了一些特有字段，并将其置于 dumi 主题配置项 themeConfig 字段中，具体配置字段如下：

基础配置

name

• 类型：string
• 默认值：null

网站名称

logo

• 类型：string
• 默认值：null

网站 logo 图片链接

hero

• 类型：IHero | Record<string, IHero>
• 默认值：null

LP 头部展示，会将配置项透传到 Hero 组件 。

如果不配置该字段，则会兜底使用 index.md 中的 hero 字段。

hero.description

• 类型：string | Record<string, string>
• 默认值：null

配置首页首屏区域的简介文字。

hero.actions

• 类型：IAction[]
• 默认值：null

配置首页首屏区域的操作按钮。

hero.features

• 类型：IFeature[]
• 默认值：null

该配置底层使用本主题包的 Feature 组件，详见 Features 文档。

footer

• 类型：string | false
• 默认值：null

网站页脚，如果配置为 false ，将完全关闭 footer。

footerConfig

• 类型：IFooter
• 默认值：null

网站页脚的完整配置，会将配置项透传到 Footer 组件 。

IFooter 详细配置如下：

socialLinks

与 dumi 保持一致。

socialLinks.github

• 类型：string
• 默认值：null

导航栏 Github 图标链接，如不配置该字段，则不展示。

hideHomeNav

• 类型：boolean
• 默认值：false

是否隐藏首页的 nav tab，配置为 true 则不展示首页的 nav。

高级配置

apiHeader

• 类型：ApiHeaderConfig | false
• 默认值：null

API 文档页头部配置

搭配组件文档中的 atomId 字段

• 类型：ApiHeaderConfig | false
• 默认值：undefined

其中 ApiHeaderConfig 的配置如下：

sourceUrl 和 docUrl 可以尝试匹配的动态字段有：

• github: 在 themeConfig 中配置的 github 字段；
• atomId: 在 markdown 文件中标记的 atomId ；
• title: 在 markdown 文件中标记的 title 字段 ；

syntaxTheme

• 类型：HighlighterSyntaxTheme
• 默认值：null

代码高亮主题配置

• 类型：HighlighterSyntaxTheme
• 默认值：undefined

siteToken

• 类型：SiteConfigToken
• 默认值：undefined

网站主题 Token 配置，该配置会传递给 DumiSiteProvider 组件。

token 介绍如下：

demo

demo.lazyLoading

demo 支持懒加载，如果文档的 demo 量很大，可以开启以提升文档加载性能。

• 类型：boolean
• 默认值：false