从使用 Docusaurus 创建的网站复制文本时,编辑器会破坏格式。整个代码块本应被 ``` 包裹,但实际粘贴后,第一行之后会出现一个闭合的 ```,而代码块中的每一行前后都会被加上 `。此外,代码块中的每一行之间还会插入一个空行。
以下是粘贴该部分内容的示例:Create a doc | Docusaurus 请注意,代码块现在变成了单独的行,而不是一个连续的代码块。这在我测试过的所有使用 Docusaurus 构建的网站上都会发生,不仅仅是他们自己的网站。
每个文档都有一个唯一的 id。默认情况下,文档的 id 是相对于根 docs 目录的文档名称(不含扩展名)。
例如,greeting.md 的 ID 是 greeting,而 guide/hello.md 的 ID 是 guide/hello。
website # 你网站的根目录
└── docs
├── greeting.md
└── guide
└── hello.md
然而,id 的最后部分可以由用户在 front matter 中定义。例如,如果 guide/hello.md 的内容定义如下,其最终的 id 将是 guide/part1。
---
id: part1
---
Lorem ipsum
当手动编写侧边栏,或使用与文档相关的布局组件或钩子时,ID 用于引用文档。