TL;DR​

在 docusaurus.config.ts 的 scripts 数组中添加 Umami 脚本，同时更新 CSP 的 script-src 和 connect-src 允许 Umami 域名即可完成集成。

TL;DR​

Docusaurus 3.9 对翻译文件格式有严格要求，code.json 和 current.json 中的值必须是 { "message": "xxx" } 对象格式，不能是纯字符串或嵌套对象。

TL;DR​

在 Docusaurus 组件中使用 /images/xxx.png 直接引用图片，构建后可能 404。改用 require('@site/static/images/xxx.png').default 可确保图片被 Webpack 正确打包。

TL;DR​

Docusaurus 项目引入 Tailwind CSS 后，markdown 文档中的标题（h1-h6）会失去默认样式。原因是 Tailwind Preflight 重置了所有标题的 font-size 和 font-weight。在 custom.css 中使用 .markdown 选择器手动恢复即可。

TL;DR​

Docusaurus 使用 data-theme 属性控制主题，Tailwind 默认的 attribute 模式会匹配任意 data-theme 值。改用 selector 模式可精确匹配 data-theme="dark"。

TL;DR​

Docusaurus 切换 Rspack 构建后，Navbar Logo 可能显示原始图片尺寸覆盖页面。在 custom.css 中显式覆盖 .navbar__logo 样式即可解决。

临时文档 - 记录浮窗优化方案配置