{"meta":{"title":"创建可重用内容","intro":"可以创建可在多个内容文件中引用的可重用内容。","product":"贡献 GitHub 文档","breadcrumbs":[{"href":"/zh/contributing","title":"贡献 GitHub 文档"},{"href":"/zh/contributing/writing-for-github-docs","title":"为 GitHub 文档撰写内容"},{"href":"/zh/contributing/writing-for-github-docs/creating-reusable-content","title":"创建可重用的内容"}],"documentType":"article"},"body":"# 创建可重用内容\n\n可以创建可在多个内容文件中引用的可重用内容。\n\n## 关于可重用内容\n\n可重用内容是可重用文本的长字符串，例如可在多个内容文件中引用的段落或过程列表。\n\n我们对可重用内容使用 Markdown（而不是 YAML）。 通过 Markdown，我们的本地化管道可以将字符串拆分为较小的可翻译段，从而减少翻译错误并减少源英语内容更改时的变动。\n\n每个可重用内容都位于自己的 Markdown 文件中。\n\n每个 Markdown 文件的路径和文件名决定了它将在数据对象中的路径是怎样的。 例如，名为 `/data/reusables/foo/bar.md` 的文件将在页面中以 `{% data reusables.foo.bar %}` 形式供用户访问。\n\n可重用文件通常按任务划分到目录中。 例如，如果要为有关 GitHub 通知的文章创建一个可重用字符串，则会将其添加到目录中 `data/reusables/notifications/`，该文件名为 `data/reusables/notifications/YOUR-REUSABLE-NAME.md`。 要添加到源的内容引用将类似于 `{% data reusables.notifications.YOUR-REUSABLE-NAME %}`。\n\n### 将版本控制应用于可重用内容\n\n可重用内容可以包含 Liquid 条件，以根据正在查看的当前版本有条件地呈现内容。 <!-- For more information, see [AUTOTITLE](/contributing/writing-for-github-docs/using-markdown-and-liquid-in-github-docs). -->\n\n## 关于变量\n\n变量是可重用文本的短字符串。\n\n我们对变量使用 YAML 文件。\n\n每个 YAML 文件中的路径、文件名和键决定了它的什么路径将位于数据对象中。\n\n例如，此 YAML 文件 `data/variables/foo/bar.yml` 包含两个变量：\n\n```yaml\n# the YAML file can contain multiple short strings in one file\nmeaning_of_life: 42\n\n# the strings can also be nested if needed\nnested:\n  values:\n    too: Yes!\n```\n\n值可作为 `{% data foo.bar.meaning_of_life %}` 和 `{% data foo.bar.nested.values.too %}` 进行访问。"}