一括メタデータ

デフォルトでは、メタデータはページレベルで管理されます。 詳しくは、 コンテンツのオーサリングと公開を参照してください。

場合によっては、web サイトにメタデータをまとめて適用すると便利です。 一般的なユースケースを次に示します。

一度に複数のページのメタデータを作成する場合は、Excel ワークブックまたはGoogle Sheets ワークブックを、SharePointまたはGoogle Drive の web サイトのルートフォルダーに作成します。

次の図に示すように、ワークブックには 1 つのワークシートと少なくとも 2 つの列のみを含める必要があります。

URL というタイトルの列には、特定のメタデータエントリを取得する必要があるページの URL パターンがあります。

ワイルドカード * （アスタリスク）はプレフィックスまたはサフィックスとして使用でき、URL パス名に柔軟に一致させることができます。 典型的な例としては、/docs/** や **/docs/** があります。

メモ： メタデータシートは上から下に評価されます。サイト全体のメタデータセットは ** に設定され、より具体的なエントリの前にする必要があります。

各メタデータプロパティに対して、ワークシート内に列を作成し、割り当てるプロパティを使用して名前を付けます。 典型的な例としては、template、theme、robots などがあります。

メタデータブロックを使用して追加したページレベルのメタデータは、一括メタデータよりも優先されます。 詳しくは、ドキュメント コンテンツのオーサリングと公開および メタデータ（ブロック）を参照してください。

メタデータを明示的に削除するには、"" を値として使用できます。 これにより、要素が削除されるか、特定のパスに対応する属性が "" に設定されます。

例：

URL          Canonical
/**          ""

上記の例では、例えばページメタデータブロックから特定の上書きが存在しない限り、デフォルトですべてのページから <link rel="canonical"> が削除されます。

メモ： ページに反映された変更を確認するには、メタデータシートをプレビュー/公開する必要があります。

ヒント： SharePoint内で Excel の更新が遅くなる場合があります。 変更がプレビューまたは公開に反映されていない場合は、ブラウザーで Excel ドキュメントをハード更新（URL バーをクリックして更新）して、プレビューを期待どおりに動作させます。

フォルダーにマッピングされたメタデータ

サイトに フォルダーマッピングが設定されている場合、そのフォルダー内のメタデータファイルは、そのマッピングのすべてのページに適用されます。 例えば、/templates/ が /templates/default にフォルダーマッピングされている場合、/templates/default/metadata.xlsx のメタデータは、URL パターンが一致する場合 /templates/ 以下のすべてのページに適用されます。

最終変更日

フォルダーマップメタデータに対する変更は、マッピングされたスコープ内のページの last-modified HTTP 応答ヘッダーには反映されません。 デフォルトでは、デフォルトドキュメントの最終変更日が使用されます。 そのヘッダー値を、メタデータの変更に基づいて更新することに依存する場合（SEO または SEM の目的で望ましい場合があります）、明示的な last-modified 列を追加することで、影響を与えることができます。 これにより、他の行は変更せずに、選択した行にのみ目的の日付文字列またはタイムスタンプを設定できます。 人間が読み取り可能でタイムゾーンが安全な ISO 日付形式をお勧めします。

例：

URL         Last-modified
/products/product1  2024-11-21T00:00:00Z
/products/product2  2024-11-20T00:00:00Z
/products/product3  2024-11-19T00:00:00Z

* 注意： 実際の last-modified HTTP 応答ヘッダーは、応答に関与するリソースの変更時間に基づいて計算されます。

これらのリソースの最新の変更時間が使用されます。 つまり、例えば head.html の値が若い場合には、指定された last-modified 値が最終的なヘッダー値ではない可能性があります。

追加のメタデータ

複数のチームで管理されるメタデータがある場合、すべてを同じメタデータファイルに保持することは現実的ではありません。 マルチメタデータのサポートは、/.helix/config.xlsx ファイルで考慮する必要があるすべてのメタデータファイルを設定することで可能になります。

リスト内のエントリの順序は、データの適用順序を示します。 メタデータの最終的な順序は次のとおりです。

/.helix/config.xlsx に設定されてい metadata い場合：

設定された順序がない場合：

個々のメタデータプロパティは上書きされますが、削除されません。 例えば、/metadata.json でプロパティ title が定義されている場合、/metadata-2nd.json の同じプロパティで値が上書きされますが、その値が空でない場合に限られます。