|
| 1 | +--- |
| 2 | +title: アナウンス |
| 3 | +description: 特別なイベントのためのアナウンスやバナーを作成します。 |
| 4 | +weight: 50 |
| 5 | +default_lang_commit: 9ba98f4fded66ec78bfafa189ab2d15d66df2309 |
| 6 | +--- |
| 7 | + |
| 8 | +アナウンスは、ロケールの `announcements` セクション内に含まれる _通常の Hugo ページ_ です。 |
| 9 | +これにより、Hugo の組み込み機能を活用して、ページの日付 (未来または期限切れ) の処理、国際化の管理などを行い、ビルドの日付によってバナーの表示や非表示を自動で切り替えたり、バナーの並び順を決定したり、英語バナーへのフォールバックを処理したりできます。 |
| 10 | + |
| 11 | +> 現在、アナウンスはバナーとしてのみ使用されています。 |
| 12 | +> 将来的には、もう少し一般的なアナウンス機能をサポートする _可能性が_ あります。 |
| 13 | +
|
| 14 | +### アナウンスを作成する {#creating-an-announcement} |
| 15 | + |
| 16 | +新しいアナウンスを追加するには、以下のコマンドを使用して、ローカリゼーションフォルダー内の `announcements` フォルダーに Markdown ファイルを作成します。 |
| 17 | + |
| 18 | +```sh |
| 19 | +hugo new --kind announcement content/YOUR-LOCALE/announcements/announcement-file-name.md |
| 20 | +``` |
| 21 | + |
| 22 | +希望するロケールとファイル名に応じて調整してください。 |
| 23 | +アナウンスの本文をページの内容として追加します。 |
| 24 | + |
| 25 | +> バナーの場合、アナウンスの本文は短いフレーズにしてください。 |
| 26 | +
|
| 27 | +{{% alert title="ローカリゼーションについて" %}} |
| 28 | + |
| 29 | +**ローカル固有のアナウンスを上書きする場合** は、英語版のアナウンスと **同じファイル名** を使用してください。 |
| 30 | + |
| 31 | +{{% /alert %}} |
| 32 | + |
| 33 | +### アナウンス一覧 {#announcement-list} |
| 34 | + |
| 35 | +各アナウンスは、ビルドの日付が `date` フィールドと `expiryDate` フィールドの間にある場合にサイトのビルドに含まれます。 |
| 36 | +これらのフィールドが省略された場合、それぞれ「現在」と「無期限」と見なされます。 |
| 37 | + |
| 38 | +アナウンスは、Hugo の [Regular pages](https://gohugo.io/methods/site/regularpages/) 機能を使用して決定される標準のページ順序で表示されます。 |
| 39 | +つまり、`weight` が最も低いアナウンスが最初に表示されます。 |
| 40 | +`weight` が同じまたは指定されていない場合は、`date` が最新のアナウンスが最初に表示されます。 |
| 41 | + |
| 42 | +したがって、アナウンスを最上位に固定したい場合は、 |
| 43 | +フロントマターで `weight` に負の値を設定してください。 |
| 44 | + |
| 45 | +このリポジトリの内容にバグや問題を発見した場合、または改善をリクエストしたい場合は、[Create new issue][new-issue] してください。 |
| 46 | + |
| 47 | +セキュリティ上の問題を発見した場合は、イシューを作成する前に[セキュリティポリシー](https://github.com/open-telemetry/opentelemetry.io/security/policy) をお読みください。 |
| 48 | + |
| 49 | +新しい Issue を報告する前に、[イシューのリスト](https://github.com/open-telemetry/opentelemetry.io/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc)を検索することで、既に報告されているか修正されていないかを確認してください。 |
| 50 | + |
| 51 | +新しいイシューを作成する際は、簡潔で意味のあるタイトルと明確な説明を記載してください。 |
| 52 | +可能な限り関連情報を提供し、可能であればテストケースも含めてください。 |
| 53 | + |
| 54 | +[new-issue]: https://github.com/open-telemetry/opentelemetry.io/issues/new/choose |
0 commit comments