跳到主要内容

内容与 i18n

页面是 src/jsMain/resources 下的 Markdown 文件。Gradle 插件把它们拷进站点目录;正文部分没有任何东西 是从 Kotlin 生成的。

目录落点用途
resources/docsdocs/文档页
resources/blogblog/博客文章(本站已关闭)
resources/pagessrc/pages/独立页面(.md、.mdx,或 Kotlin 组件的 .jsx shim)
resources/csssrc/css/额外样式表
resources/staticstatic/原样拷贝的文件
resources/i18ni18n/翻译

翻译​

docusaurus.config.mjs 声明了 en 和 zh-Hans 两种语言,源语言是英文。每个译文页都在自己语言、自己 插件的目录下镜像源文件的路径——文档页放在 docusaurus-plugin-content-docs/current/,独立页面放在 docusaurus-plugin-content-pages/:

resources/docs/intro.md
resources/i18n/zh-Hans/docusaurus-plugin-content-docs/current/intro.md

resources/pages/index.md
resources/i18n/zh-Hans/docusaurus-plugin-content-pages/index.md

所以文案始终留在页面里:两种语言两个 Markdown 文件,首页也不例外。同一个 i18n 目录下的 code.json 是给组件自己持有的字符串用的——导航栏、页脚,以及 Kotlin 页面用 translate { id = …; message = "…" } 渲染出来的内容。

侧边栏条目和「上一页 / 下一页」按钮的标签都取自它们指向的那个页面——页面标题,或 front matter 里的 sidebar_label——所以译文页会连标签一起带过来。分类没有自己的页面,它的标签放在 docs 插件自己的翻译文件 i18n/<locale>/docusaurus-plugin-content-docs/current.json 里。

正文为什么不用 MDX​

MDX 是可用的,页面也可以用。它只是不作为默认:只有正文的页面就是 .md 文件,这样它和 React 组件树 毫无关系。当页面确实需要 <Layout> 级别的调整或者一个组件时,把它命名为 index.mdx,走同一条 MDX 流水线——resources/pages 是原样拷贝的,所以变的只有扩展名。