コンテンツを再利用する

コンテンツの一貫性を高め、コンテンツ作成にかかる時間を短縮できるように、Braze Docs全体でコンテンツを再利用する方法を学びましょう。コンテンツの再利用に関する一般的な情報については、「コンテンツ管理」を参照してください。

Jekyll でのコンテンツの再利用は、インクルードを使用して行われます。インクルードは通常の Markdown _includes ファイルとしてディレクトリに保存されます。ただし、_docsディレクトリ内のMarkdownファイルとは異なり、これらのファイルにはYAMLフロントマターは必要ありません。

前提条件

まだの場合は、Braze Docs への貢献のステップを完了します。

インクルードの作成

.md_includesディレクトリに拡張子を付けた新しい Markdown ファイルを作成します。インクルードファイルはこのディレクトリのどこにでも保存できますが、関連するコンテンツはサブディレクトリを使用してまとめておくのが一番です。ファイルツリーは次のようになっているはずです。

1
2
3
4
5
6
braze-docs
└── _includes
    ├── alerts
    ├── archive
    └── contributing
        └── site_generator.md

ページにコンテンツを追加し、必ず Braze Docs スタイルガイドに従ってください。すでに YAML フロントマターがあるページにインクルードを追加する予定がある場合は、インクルードにフロントマターを追加しないでください。コンテンツは次のようになっているはずです。

```markdown

サイトジェネレーター

Braze Docsは、人気の静的サイトジェネレーター（SSG）であるJekyllを使用して構築されています。これにより、コンテンツファイルとデザインファイルをコンテンツファイル用とデザインファイル用に別々のディレクトリに保存できます。_docs assetsサイトを構築すると、Jekyllは各ファイルをインテリジェントにマージし、XMLおよびHTMLデータとしてディレクトリに保存します。_site詳細については、「Jekyll ディレクトリ構造」を参照してください。

寄稿者は、主に以下のディレクトリで作業することになります。

```

インクルードを参照する

インクルードを参照するには、関連する Markdown ファイル内で以下の構文を使用してください。

1
{% multi_lang_include PATH_TO_INCLUDE %}

PATH_TO_INCLUDE_includesディレクトリ内の相対パスに置き換えます。たとえば、次のファイルツリーがあるとします。

1
2
3
4
5
6
braze-docs
└── _includes
    ├── alerts
    ├── archive
    └── contributing
        └── prerequisites.md

リファレンスは以下のようになります。

• example input
• example output