Kotlin 语言参考文档 中文版 Help

模块文档

针对模块整体的文档, 以及针对模块内包的文档, 可以通过单独的 Markdown 文件的形式提供.

文件格式

在 Markdown 文件内, 针对模块整体的文档, 以及针对各个包的文档, 分别使用各自的顶级标题来指定. 对于模块, 标题文字 必须Module <module name>, 对于包, 标题文字 必须Package <package qualified name>.

文件不一定需要同时包含模块和包的文档. 你可以让文件只包含包或模块的文档. 也可以为每个模块或包分别生成 Markdown 文件.

使用 Markdown 语法, 你可以添加:

  • 最多 6 层的标题

  • 粗体或斜体格式的强调内容

  • 链接

  • 内嵌代码

  • 代码块

  • 引用块

下面是一个示例文件, 同时包含模块和包的文档:

# Module kotlin-demo 这段内容出现在你的模块名称之下. # Package org.jetbrains.kotlin.demo 这段内容出现在包列表中的你的包名称之下. 也出现在你的包的页面的顶级标题之下. ## 包 org.jetbrains.kotlin.demo 的二级标题 这个标题之后的内容也是 `org.jetbrains.kotlin.demo` 的文档的一部分 # Package org.jetbrains.kotlin.demo2 这段内容出现在包列表中的你的包名称之下. 也出现在你的包的页面的顶级标题之下. ## 包 org.jetbrains.kotlin.demo2 的二级标题 这个标题之后的内容也是 `org.jetbrains.kotlin.demo2` 的文档的一部分

使用 Gradle 的示例项目, 可以参见 Dokka Gradle 示例.

向 Dokka 传递文件

要将文件传递给 Dokka, 你需要对 Gradle, Maven, 或 CLI, 使用相关的 includes 选项:

源代码集配置 中 使用 includes 选项.

一般配置 中 使用 includes 选项.

如果你使用命令行配置, 请在 源代码集选项 中 使用 includes 选项.

如果你使用 JSON 配置, 请在 一般配置 中 使用 includes 选项.

最终更新: 2024/10/17