Skip to content

Commit 957b881

Browse files
committed
Translation of contributing into Ja and fix typo error
1 parent ad4bd2e commit 957b881

File tree

4 files changed

+27
-51
lines changed

4 files changed

+27
-51
lines changed

website_and_docs/content/documentation/about/contributing.en.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ https://selenium.dev/support.
4949

5050
### Creating Examples
5151

52-
Examples that need to be moved are marked with: {{% badge-code %}}
52+
Examples that need to be added are marked with: {{% badge-code %}}
5353

5454
We want to be able to run all of our code examples in the CI to ensure that people can copy and paste and
5555
execute everything on the site. So we put the code where it belongs in the

website_and_docs/content/documentation/about/contributing.ja.md

Lines changed: 24 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -2,25 +2,15 @@
22
title: "Seleniumのサイトとドキュメントに貢献する"
33
linkTitle: "Seleniumのサイトとドキュメントに貢献する"
44
weight: 2
5-
requiresTranslation: true
65
description: >-
7-
Information on improving documentation and code examples for Selenium
6+
Seleniumのドキュメントとコード例を改善するための情報
87
aliases:
98
[
109
"/documentation/ja/contributing/",
1110
"/documentation/ja/front_matter/typographical_conventions/"
1211
]
1312
---
1413

15-
{{% pageinfo color="warning" %}}
16-
<p class="lead">
17-
<i class="fas fa-language d-4"></i>
18-
Page being translated from
19-
English to Japanese. Do you speak Japanese? Help us to translate
20-
it by sending us pull requests!
21-
</p>
22-
{{% /pageinfo %}}
23-
2414
Seleniumは大きなソフトウェアプロジェクトであり、そのサイトとドキュメントは、物事の仕組みを理解し、その可能性を活用する効果的な方法を学ぶための鍵となります。
2515

2616
このプロジェクトには、Seleniumのサイトとドキュメントの両方が含まれています。これは、Seleniumを効果的に使用する方法、Seleniumに参加する方法、およびSeleniumに貢献する方法に関する最新情報を提供するための継続的な取り組みです(特定のリリースを対象としていません)。
@@ -43,53 +33,47 @@ Seleniumのすべてのコンポーネントは、時間の経過とともに非
4333
見つかったものが問題であるかどうかわからない場合、[https://selenium.dev/support](https://selenium.dev/support)に記載されているコミュニケーション手段にて質問してください。
4434

4535

46-
## What to Help With
36+
## 何を手伝うか
4737

48-
### Creating Examples
38+
### 例の作成
4939

50-
Examples that need to be moved are marked with: {{% badge-code %}}
40+
追加が必要な例には、次のマークが付いています: {{% badge-code %}}
5141

52-
We want to be able to run all of our code examples in the CI to ensure that people can copy and paste and
53-
execute everything on the site. So we put the code where it belongs in the
54-
[examples directory](https://github.com/SeleniumHQ/seleniumhq.github.io/blob/trunk/examples/).
55-
Each page in the documentation correlates to a test file in each of the languages, and should follow naming conventions.
56-
For instance examples for this page https://www.selenium.dev/documentation/webdriver/browsers/chrome/ get added in these
57-
files:
42+
すべてのコード例をCIで実行できるようにし、サイト上のすべてのコードをコピー&ペーストして実行できることを確認したいと考えています。そのため、コードを[examplesディレクトリ](https://github.com/SeleniumHQ/seleniumhq.github.io/blob/trunk/examples/)の適切な場所に配置します。
43+
ドキュメントの各ページは各言語のテストファイルに関連しており、命名規則に従う必要があります。
44+
例えば、このページ(https://www.selenium.dev/documentation/webdriver/browsers/chrome/)の例は以下のファイルに追加されています:
5845
* `"/examples/java/src/test/java/dev/selenium/browsers/ChromeTest.java"`
5946
* `"/examples/python/tests/browsers/test_chrome.py"`
6047
* `"/examples/dotnet/SeleniumDocs/Browsers/ChromeTest.cs"`
6148
* `"/examples/ruby/spec/browsers/chrome_spec.rb"`
6249
* `"/examples/javascript/test/browser/chromeSpecificCaps.spec.js"`
6350

64-
Each example should get its own test. Ideally each test has an assertion that verifies the code works as intended.
65-
Once the code is copied to its own test in the proper file, it needs to be referenced in the markdown file.
51+
各例はそれぞれ独自のテストが必要です。理想的には、各テストにはコードが意図したとおりに動作することを確認するアサーションが含まれています。
52+
コードを適切なファイル内の独自のテストにコピーしたら、Markdownファイルで参照する必要があります。
6653

67-
For example, the tab in Ruby would look like this:
54+
例えば、Rubyのtabは次のようになります:
6855

6956
{{</* tab header="Ruby" */>}}
7057
{{</* gh-codeblock path="/examples/ruby/spec/browsers/chrome_spec.rb#L8-L9" */>}}
7158
{{</* /tab */>}}
7259

73-
The line numbers at the end represent only the line or lines of code that actually represent the item being displayed.
74-
If a user wants more context, they can click the link to the GitHub page that will show the full context.
60+
末尾の行番号は、実際に表示される項目を表すコードの行のみを表します。
61+
ユーザーがより多くのコンテキストを必要とする場合、GitHubページへのリンクをクリックすると完全なコンテキストが表示されます。
7562

76-
Make sure that if you add a test to the page that all the other line numbers in the markdown file are still
77-
correct. Adding a test at the top of a page means updating every single reference in the documentation that has a line
78-
number for that file.
63+
ページにテストを追加する場合は、Markdownファイル内の他のすべての行番号が正しいことを確認してください。
64+
ページの先頭にテストを追加すると、そのファイルの行番号を持つドキュメント内のすべての参照が更新されます。
7965

80-
Finally, make sure that the tests pass in the CI.
66+
最後に、CIでテストがPassすることを確認してください。
8167

8268

83-
### Moving Examples
69+
### 例の移動
8470

85-
Examples that need to be moved are marked with: {{% badge-examples %}}
71+
移動が必要な例には、次のマークが付いています: {{% badge-examples %}}
8672

87-
Everything from the [Creating Examples](#creating-examples) section applies, with one addition.
73+
[例の作成](#creating-examples)セクションのすべてが適用されますが、1つ追加があります。
8874

89-
Make sure the tab includes `text=true`. By default, the tabs get formatted
90-
for code, so to use markdown or other shortcode statements (like `gh-codeblock`) it needs to be declared as text.
91-
For most examples, the `tabpane` declares the `text=true`, but if some of the tabs have code examples, the `tabpane`
92-
cannot specify it, and it must be specified in the tabs that do not need automatic code formatting.
75+
tabには`text=true`を含めてください。デフォルトではtabはコード用にフォーマットされるため、Markdownや他のショートコードステートメント(`gh-codeblock`など)を使用するには、`text=true`を宣言する必要があります。
76+
ほとんどの例では、`tabpane``text=true`を宣言しますが、tabの一部にコード例が含まれている場合、`tabpane`はそれを指定できず、自動コードフォーマットが不要なtabでは指定する必要があります。
9377

9478

9579
## 貢献
@@ -110,13 +94,9 @@ Seleniumプロジェクトは新しいコントリビュータを歓迎します
11094

11195
#### 依存関係: Hugo
11296

113-
We use [Hugo](https://gohugo.io/) and the [Docsy theme](https://www.docsy.dev/)
114-
to build and render the site. You will need the “extended”
115-
Sass/SCSS version of the Hugo binary to work on this site. We recommend
116-
to use Hugo 0.125.4 .
97+
[Hugo](https://gohugo.io/)[Docsyテーマ](https://www.docsy.dev/)を使用してサイトの構築とレンダリングをしています。このサイトの作業をするには、Hugoバイナリの“拡張”Sass/SCSSバージョンが必要です。Hugo 0.125.4の使用を推奨します。
11798

118-
Please follow the [Install Hugo](https://www.docsy.dev/docs/getting-started/#install-hugo)
119-
instructions from Docsy.
99+
[Docsyのインストール手順](https://www.docsy.dev/docs/getting-started/#install-hugo)に従ってください。
120100

121101
### ステップ 2: ブランチの作成
122102

@@ -130,19 +110,15 @@ instructions from Docsy.
130110

131111
### ステップ 3: 変更を加える
132112

133-
The repository contains the site and docs. Before jumping into
134-
making changes, please initialize the submodules and install the
135-
needed dependencies (see commands below). To make changes to the site,
136-
work on the `website_and_docs` directory. To see a live preview of
137-
your changes, run `hugo server` on the site's root directory.
113+
リポジトリにはサイトとドキュメントが含まれています。 変更を加える前に、submoduleを初期化し、必要な依存関係をインストールしてください(以下のコマンドを参照)。サイトに変更を加えるには、`website_and_docs` ディレクトリで作業してください。変更のライブプレビューを確認するには、サイトのルートディレクトリで `hugo server`を実行してください。
138114

139115
```shell
140116
% git submodule update --init --recursive
141117
% cd website_and_docs
142118
% hugo server
143119
```
144120

145-
See [Style Guide]({{< ref "style.md" >}}) for more information on our conventions for contribution
121+
寄稿に関する規約の詳細については、 [スタイルガイド]({{< ref "style.md" >}}) をご覧ください。
146122

147123
### ステップ 4: コミット
148124

website_and_docs/content/documentation/about/contributing.pt-br.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ https://selenium.dev/support.
5050

5151
### Creating Examples
5252

53-
Examples that need to be moved are marked with: {{% badge-code %}}
53+
Examples that need to be added are marked with: {{% badge-code %}}
5454

5555
We want to be able to run all of our code examples in the CI to ensure that people can copy and paste and
5656
execute everything on the site. So we put the code where it belongs in the

website_and_docs/content/documentation/about/contributing.zh-cn.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ https://selenium.dev/support.
4545

4646
### Creating Examples
4747

48-
Examples that need to be moved are marked with: {{% badge-code %}}
48+
Examples that need to be added are marked with: {{% badge-code %}}
4949

5050
We want to be able to run all of our code examples in the CI to ensure that people can copy and paste and
5151
execute everything on the site. So we put the code where it belongs in the

0 commit comments

Comments
 (0)