diff --git a/docs/spec/writing.md b/docs/spec/writing.md index da6b0af..c5a17a7 100644 --- a/docs/spec/writing.md +++ b/docs/spec/writing.md @@ -87,7 +87,7 @@ Linux 201 使用 mkdocs + mkdocs-material 作为文档框架与主题,并且 ### 为标题和小标题添加 ID {#heading-ids} -由于文章篇目较长,使用时会经常遇到需要链接到文章某一段的情况。受限于 MkDocs 自动生成 Anchor ID 的功能(只支持英文字符),纯中文的标题会导致生成 `_1`, `_2` 这样的 ID。一方面这样的 ID 看起来不直观,另一方面每当标题发生增减时这些 ID 都会变,因此请为每个**除了 h1 以外的标题**手动添加一个有意义的 ID(最开始的标题 H1 除外),方法如下: +由于文章篇目较长,使用时会经常遇到需要链接到文章某一段的情况。受限于 MkDocs 自动生成 Anchor ID 的功能(只支持英文字符),纯中文的标题会导致生成 `_1`, `_2` 这样的 ID。一方面这样的 ID 看起来不直观,另一方面每当标题发生增减时这些 ID 都会变,因此请为每个**除了 h1 以外的标题**手动添加一个有意义的 ID,方法如下: ```markdown ### 为标题和小标题添加 ID {#heading-ids} @@ -126,6 +126,34 @@ Linux 201 使用 mkdocs + mkdocs-material 作为文档框架与主题,并且 [fstab(5)][fstab.5] 提供了…… ``` +### 定义列表 {#definition-list} + +在写作时,我们可能会需要列出多个术语,同时给出它们的定义或者介绍,如果使用普通的有序或无序列表的话,给读者的观感可能过于紧凑。此时可以考虑使用定义列表格式,类似如下: + +```markdown +定义一 + +: 本项经常出现在科大西区和中区的交界处:肥西路上。在晚上九点之后,有概率可以在路边发现本项。 + + 需要注意的是,离开校门时请带好手机。 + +定义二 + +: 我编不下去了。 +``` + +显示效果如下: + +定义一 + +: 本项经常出现在科大西区和中区的交界处:肥西路上。在晚上九点之后,有概率可以在路边发现本项。 + + 需要注意的是,离开校门时请带好手机。 + +定义二 + +: 我编不下去了。 + ## 内容要求 {#content} ### 编写原则 {#principle}