Skip to content

Commit 8c50991

Browse files
committed
docs: translated contributing/announcements into ja
1 parent ea3b23c commit 8c50991

File tree

1 file changed

+68
-0
lines changed

1 file changed

+68
-0
lines changed
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
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

Comments
 (0)