Skip to main content

为 GitHub Docs 编写内容

了解如何为 GitHub Docs 编写文章。

GitHub Docs 的最佳做法

按照这些最佳做法即可创建用户友好且易于理解的文档。

关于 GitHub 的文档理念

我们的文档理念指导我们创建的内容以及创建内容的方式。

内容设计原则

我们分享这些原则,为使用 GitHub 的人员设计和创建最佳内容。

编写要翻译的内容

我们的文档已翻译成多种语言。 我们编写英语文档的方式可以大大提高这些翻译的质量。

让内容可在搜索中查找

遵循以下 SEO 最佳做法,帮助用户使用搜索引擎来查找 GitHub 文档。

对文档进行版本控制

GitHub Docs 使用 YAML 前辅文和 Liquid 运算符通过单一源方法支持 GitHub 的多个版本。

在 GitHub Docs 中使用 Markdown 和 Liquid

可以使用 Markdown 和 Liquid 在 GitHub Docs 上设置内容格式、创建可重用内容,以及为不同版本编写内容。

使用 YAML 前辅文

可以使用 YAML 前辅文来定义版本控制、添加元数据和控制文章的布局。

在 GitHub Docs 中使用视频

本指南介绍如何创建支持用户对 GitHub Docs 的需求的视频。

创建可重用内容

可以创建可在多个内容文件中引用的可重用内容。

创建屏幕截图

你可以通过将屏幕截图添加到 GitHub Docs 来帮助用户找到用户界面中难以找到的元素。

为 GitHub Docs 创建关系图

本指南介绍何时与如何为 GitHub Docs 创建关系图。

在文章中创建工具切换器

可以使用工具切换器来演示如何使用特定工具完成任务。

配置重定向

如果文章的标题、版本或位置发生更改,则可以创建指向最新内容的重定向。

更改文章的标题

当必须更改文章的标题时,可能需要在多个位置更新名称。

批注代码示例

可以批注较长的代码示例,以说明它们的工作原理以及用户如何自定义它们以用于其他用途。

模板

本文包含 GitHub Docs 中使用的不同内容类型的入门模板。