22title : " Seleniumのサイトとドキュメントに貢献する"
33linkTitle : " Seleniumのサイトとドキュメントに貢献する"
44weight : 2
5- requiresTranslation : true
65description : >-
7- Information on improving documentation and code examples for Selenium
6+ Seleniumのドキュメントとコード例を改善するための情報
87aliases :
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-
2414Seleniumは大きなソフトウェアプロジェクトであり、そのサイトとドキュメントは、物事の仕組みを理解し、その可能性を活用する効果的な方法を学ぶための鍵となります。
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+ [ 例の作成 ] ( #例の作成 ) セクションのすべてが適用されますが、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
0 commit comments