{"meta":{"title":"再利用可能なコンテンツの作成","intro":"複数のコンテンツ ファイルで参照できる再利用可能コンテンツを作成できます。","product":"GitHub Docs に投稿する","breadcrumbs":[{"href":"/ja/contributing","title":"GitHub Docs に投稿する"},{"href":"/ja/contributing/writing-for-github-docs","title":"GitHub Docs 向け執筆"},{"href":"/ja/contributing/writing-for-github-docs/creating-reusable-content","title":"再利用可能なコンテンツの作成"}],"documentType":"article"},"body":"# 再利用可能なコンテンツの作成\n\n複数のコンテンツ ファイルで参照できる再利用可能コンテンツを作成できます。\n\n## Reusables について\n\nReusables とは、複数のコンテンツ ファイルで参照できる、段落や手続き型リストなど、再利用可能なテキストからなる長い文字列です。\n\nReusables には Markdown が (YAML の代わりに) 使われています。 Markdown を使うと、ローカライズ パイプラインで文字列を小さな翻訳可能なセグメントに分割できるため、翻訳エラーが少なくなり、ソースの英語コンテンツが変更された場合でもチャーンが少なくなります。\n\n各 Reusable は 個別の 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### Reusables にバージョン管理を適用する\n\nReusables には、表示されている現在のバージョンに応じてコンテンツを条件付きでレンダリングするための 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` には次の 2 つの変数が含まれています。\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 %}` としてアクセスできます。"}