概览

主题

控制读者之间的浅色/深色模式体验。


Theming Options#

Setting What it does
Theme toggle Show or hide the light/dark mode switcher
Default theme What visitors see on their first visit: light or dark

How to configure:

Float Widget → DesignTheme tab → adjust settings → Save.

Tips for choosing defaults:

  • Technical or developer-focused docs → dark default is widely preferred.
  • User-facing or marketing-style docs → light default feels more approachable.
  • When in doubt, keep the toggle visible so readers can choose their own preference.

主题设置#

默认主题#

设置新访客在他们做出任何选择之前的看到的界面。

选项: Light | Dark

访客的偏好设置保存在他们的浏览器中——因此重访的访客始终会看到他们上次使用的主题,无论你的默认设置如何。

主题切换可见性#

启用时,太阳/月亮图标将出现在页眉或侧边栏中,供访问者手动切换主题。

您还可以控制切换器出现的位置


构建您的读者乐于使用的文档。 连接您的 GitHub 仓库 →