|
| 1 | +--- |
| 2 | +title: アナウンス |
| 3 | +description: 特別なイベントのためのアナウンスやバナーを作成します。 |
| 4 | +weight: 50 |
| 5 | +--- |
| 6 | + |
| 7 | +An announcement is a _regular Hugo page_ contained under the `announcements` |
| 8 | +section of a locale. This means that we leverage Hugo's builtin handling of page |
| 9 | +dates (future or expired), internationalization, and more, to automatically show |
| 10 | +or hide banners depending on the build date, determine banner ordering, handle |
| 11 | +fall back to English banners, etc. |
| 12 | + |
| 13 | +> Announcements are currently used as banners only. We _might_ eventually |
| 14 | +> support slightly more general announcements as well. |
| 15 | +
|
| 16 | +### Creating an announcement {#creating-an-announcement} |
| 17 | + |
| 18 | +To add a new announcement, create an announcement markdown file under the |
| 19 | +`announcements` folder of your localization using the following command: |
| 20 | + |
| 21 | +```sh |
| 22 | +hugo new --kind announcement content/YOUR-LOCALE/announcements/announcement-file-name.md |
| 23 | +``` |
| 24 | + |
| 25 | +Adjust according to your desired locale and file name. Add the announcement text |
| 26 | +as the body of the page. |
| 27 | + |
| 28 | +> For banners, the announcement body should be a short phrase. |
| 29 | +
|
| 30 | +{{% alert title="For localizations" %}} |
| 31 | + |
| 32 | +If you are creating a **locale specific announcement override**, make sure that |
| 33 | +you use the **same filename** as the English language announcement. |
| 34 | + |
| 35 | +{{% /alert %}} |
| 36 | + |
| 37 | +### Announcement list {#announcement-list} |
| 38 | + |
| 39 | +Any given announcement will appear in a site build when the build date falls |
| 40 | +between the `date` and `expiryDate` fields of the announcement. When those |
| 41 | +fields are missing they are assumed to be "now" and "forever", respectively. |
| 42 | + |
| 43 | +Announcements will appear in the standard page order as determined using Hugo's |
| 44 | +[Regular pages](https://gohugo.io/methods/site/regularpages/) function. That is, |
| 45 | +the "lightest" announcements (by `weight`) will appear first; when weights are |
| 46 | +the same or unspecified, the most recent announcements (by `date`) will appear |
| 47 | +first, etc. |
| 48 | + |
| 49 | +So, if you want to force an announcement to the top, use a negative `weight` in |
| 50 | +the front matter. |
| 51 | + |
| 52 | +If you find a bug or a problem with the content of this repository, or you would |
| 53 | +like to request an enhancement, [create an issue][new-issue]. |
| 54 | + |
| 55 | +If you discover a security issue, read the |
| 56 | +[Security Policy](https://github.com/open-telemetry/opentelemetry.io/security/policy) |
| 57 | +before opening an issue. |
| 58 | + |
| 59 | +Before reporting a new issue, make sure that the issue was not already reported |
| 60 | +or fixed by searching through our |
| 61 | +[issues list](https://github.com/open-telemetry/opentelemetry.io/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc). |
| 62 | + |
| 63 | +When creating a new issue, include a short, meaningful title and a clear |
| 64 | +description. Add as much relevant information as you can, and, if possible, a |
| 65 | +test case. |
| 66 | + |
| 67 | +[new-issue]: |
| 68 | + https://github.com/open-telemetry/opentelemetry.io/issues/new/choose |
0 commit comments