给代码块换上 Departure Mono,一个 CSS 变量搞定
· 阅读需 8 分钟
给文档站所有代码块换上了 Departure Mono(像素风格等宽字体)。最初以为要写 JS 注入,实际上一行不用——但为了确认「一个变量到底管不管全部」「内联样式会不会压不掉」,翻了会儿源码,这里一并记下。
Docusaurus tag description
查看所有标签给文档站所有代码块换上了 Departure Mono(像素风格等宽字体)。最初以为要写 JS 注入,实际上一行不用——但为了确认「一个变量到底管不管全部」「内联样式会不会压不掉」,翻了会儿源码,这里一并记下。
给本站接入了思源黑体 / 思源宋体两套字体,并在导航栏加了一个按钮,点击即可在「黑体 ↔ 宋体」之间切换。过程不小心中了两个 Docusaurus 3.x 的坑:themeConfig.stylesheets 静默失效、自定义导航项类型过不了配置校验。这里把做法和排坑过程记一下。
本站的「日志」就是 Docusaurus 的博客。这篇文章把「怎么新增一篇、怎么改一篇、有哪些坑」整理成一份可照抄的指南,方便以后随手记录。
给文档站导航栏右侧加了一个「DrissionPage」下拉菜单,顺带踩了个坑:菜单项一多,鼠标往下面的条目移动时菜单会自动消失。这里把配置写法和修复过程记一下。
Docusaurus 的博客功能 由 博客插件 提供支持。
下面是一些可能有用的提示。
日志支持 Docusaurus 的 Markdown 特性,例如 MDX。
用 React 的能力做出可交互的日志。
这是这篇超长日志的摘要。
用 {/* truncate */} 注释来限制日志在列表页显示的长度。
这是摘要,简单说明这篇日志要讲什么。