1.2.1 - en to ja translation catalogue (50 entries)

en: Introduction
ja: 導入

en: This documentation describes about how to write, generate and manage Groonga documentation.
ja: この文書では、Groongaドキュメントの執筆・生成・管理の方法について説明します。

en: How to fork and clone Groonga repository
ja: Groongaリポジトリをフォークしクローンする方法

en: Contributing to Groonga's documentation begins with forking and cloning the Groonga repository. These actions are essential first steps that enable personal modifications and experimentation in your personal repository. And also, it enables you to submit them as your contributions to the Groonga repository. Follow these steps.
ja: Groongaドキュメントへ貢献するには、まずはGroongaリポジトリをフォークしクローンするとこから始めます。そうすることで、あなたのリポジトリで個人的な変更や実験が可能になります。他にも、その成果をGroongaリポジトリにあなたの貢献として送ることもできます。まずは、次の手順に倣って、フォークとクローンをしてください。

en: Go to https://github.com/groonga/groonga on GitHub
ja: GitHubの https://github.com/groonga/groonga へ移動してください。

en: Click the `Fork` button to create a copy of the repository
ja: `Fork` ボタンをクリックして、Groongaリポジトリをフォークしてください。

en: Clone your Groonga repository with the following command
ja: 下記のコマンドでフォークしたGroongaリポジトリをクローンしてください。

en: Install depended software
ja: 必要なソフトウェアのインストール

en: Groonga uses [Sphinx](https://www.sphinx-doc.org/) as documentation tool.
ja: Groongaはドキュメントツールとして [Sphinx](https://www.sphinx-doc.org/) を使います。

en: Here are command lines to install Sphinx.
ja: 以下はSphinxをインストールするコマンドラインです。

en: Run `cmake` with `--preset=doc`
ja: `cmake` を `--preset=doc` 付きで実行

en: Groonga disables documentation generation by default. You need to enable it explicitly by adding `--preset=doc` option to `cmake`:
ja: Groonga は、デフォルトではドキュメントの生成を無効化しています。 `cmake` に `--preset=doc` オプションを追加して明示的に有効にする必要があります。:

en: Now, your Groonga build is documentation ready.
ja: これで、 Groonga ドキュメントをビルドする準備が出来ました。

en: Generate HTML
ja: HTMLファイルを生成

en: You can generate HTML by the following command:
ja: 以下のコマンドでHTMLファイルを生成できます。:

en: You can find generated HTML documentation at `../groonga.doc/doc/en/html/`.
ja: 生成されたHTMLドキュメントは `../groonga.doc/doc/ja/html/` にあります。

en: How to edit documentation
ja: ドキュメントを編集する方法

en: The Groonga documentation is written in [reStructuredText (.rst)](https://www.sphinx-doc.org/en/master/usage/restructuredtext/index.html) or [Markdown (.md)](https://myst-parser.readthedocs.io/en/latest/) . These files are located in the `doc/source`. Each page of the documentation corresponds to a `.rst` file or a `.md` file. By modifying the corresponding file, you can edit the target document. For Example, if you want to edit this {doc}`introduction` page, you should edit the `doc/source/contribution/documentation/introduction.rst` file. Please find the file you wish to edit and make your changes.
ja: Groongaドキュメントは、[reStructuredText (.rst)](https://www.sphinx-doc.org/en/master/usage/restructuredtext/index.html) または [Markdown (.md)](https://myst-parser.readthedocs.io/en/latest/) で書かれています。Groongaドキュメントのファイルは、`doc/source` 配下にあります。それぞれのページに対応した `.rst` ファイルまたは、 `.md` が必ず１つあります。対応するファイルを変更することで、対象のドキュメントを編集できます。例えば、この {doc}`introduction` ページを編集したい場合は、`doc/source/contribution/documentation/introduction.rst` ファイルを編集すればよいです。編集したいファイルをみつけて、編集してください。

en: Preview changes on HTML files
ja: HTMLファイルで変更を確認する

en: You can preview your documentation changes in your browser in HTML format. Follow these two steps.
ja: HTML形式でドキュメントの変更をブラウザで確認できます。次の２つの手順に倣ってください。

en: Generate the HTML files with your changes
ja: 変更を反映したHTMLファイルを生成する

en: Preview the generated HTML files in your Web browser
ja: Webブラウザで生成されたHTMLファイルを確認する

en: Use the following command to generate HTML files that reflect your changes. The generated files will be located in `../groonga.doc/doc/en/html/`. Each file corresponds to a `.rst` or `.md` file:
ja: 次のコマンドで、変更を反映したHTMLファイルを生成します。生成されたファイルは、`../groonga.doc/doc/en/html/` 配下にあります。各 `.rst` または `.md` ファイルに対応するファイルが生成されています。

en: Open the generated file in your Web browser to preview your changes. For example, if you have edited this {doc}`introduction` page, you can preview it by the following command:
ja: 生成されたファイルをWebブラウザで開き、変更を確認できます。例えば、この {doc}`introduction` ページを編集した場合、次のコマンドで変更を確認できます。

en: Send patch
ja: パッチを送る

en: You can submit your patch to the Groonga repository on GitHub via a pull request. Feel free to send a pull request by following two steps.
ja: GitHub上のGroongaリポジトリに対してプルリクエストを通じてパッチを送ることができます。次の手順で、気軽にプルリクエストを作ってみましょう。

en: Prepare your pull request
ja: プルリクエストの準備をする

en: Submit your pull request
ja: プルリクエストを送る

en: Ensure your changes are committed and then push your changes to your fork repository on GitHub. Follow these commands:
ja: 次のコマンドで、変更をコミットし、その変更をGitHubにある自分のフォークリポジトリにプッシュします。

en: Now you're ready to submit a pull request to the upstream Groonga repository. Follow these steps:
ja: これで、アップストリームのGroongaリポジトリにプルリクエストを送る準備ができました。次のステップに従い実際にプルリクエストを送ってみましょう。

en: Go to your fork repository on GitHub
ja: GitHubで自分のフォークリポジトリにアクセスします

en: Click the `Compare & pull request` button
ja: `Compare & pull request`ボタンをクリックします

en: Make sure your changes are reflected
ja: 変更がすべて反映されているかを確認します

en: Click the `Create Pull Request` button and send your pull request
ja: `Create Pull Request`ボタンをクリックして、プルリクエストを送ります

en: Optional: Translate documentation
ja: 任意: ドキュメントを翻訳する

en: This is an optional step.
ja: 任意のステップになります。

en: After editing and previewing the Groonga documentation, the next step is to translate the documents to make them accessible to a wider range of Groonga community users. Translating into languages other than English ensures that non-English speakers can also understand the Groonga documentation. Follow these steps to translate Groonga documentation.
ja: Groongaドキュメントの編集とプレビューが完了したら、次のステップは、ドキュメントの翻訳になります。翻訳をすることで、Groongaコミュニティのより広い範囲のユーザーがGroongaを利用しやすくなります。英語以外の言語に翻訳することで、非英語話者でもGroongaのドキュメントを理解しやすくなります。次の手順で、Groongaドキュメントを翻訳しましょう。

en: Translate the documentation in `.edit.po` files
ja: `.edit.po` ファイル内のドキュメントを翻訳する

en: Reflect translations to `.po` files
ja: 翻訳を `.po` ファイルに反映する

en: Preview translations on HTML files
ja: HTMLファイルで翻訳を確認する

en: Use the following command to generate `.edit.po` files, which are translation files, corresponding to your changes. The generated files will be located in `../groonga.doc/doc/locale/${LANGUAGE}/LC_MESSAGES`. Each file corresponds to a `.rst` or `.md` file. Please add your translations to `.edit.po` files:
ja: 次のコマンドで、翻訳用である `.edit.po` ファイルを生成します。生成されたファイルは `../groonga.doc/doc/locale/${LANGUAGE}/LC_MESSAGES` 配下にあります。各 `.rst` または `.md` ファイルに対応するファイルが生成されています。対応する `.edit.po` ファイルに翻訳を追加します。

en: For example, if you have edited the {doc}`introduction` page and want to add Japanese translations, update this `../groonga.doc/doc/ja/LC_MESSAGES/contribution/documentation/introduction.edit.po` file.
ja: 例えば、この {doc}`introduction` ページを編集して、日本語訳を追加したい場合は、`../groonga.doc/doc/ja/LC_MESSAGES/contribution/documentation/introduction.edit.po` ファイルを更新します。

en: Please do not modify the `.rst` or `.md` files while adding translations to the `.edit.po` files. Editing `.rst` or `.md` files without first reflecting the translations in `.po` files will result in the loss of those translations. If you want to edit `.rst` or `.md` files, ensure you first reflect your translations in `.po` files. The method to reflect translations will be introduced in the next step.
ja: `.edit.po` ファイルに翻訳を追加している最中に、翻訳元の `.rst` または `.md` ファイルを変更しないでください。翻訳した内容を `.po` ファイルに反映せずにを翻訳元を編集してしまうと、翻訳内容が消えてしまいます。翻訳元を編集したい場合は先に翻訳内容を `.po` ファイルに反映してください。反映方法は次のステップで紹介します。

en: After adding your translations to the `.edit.po` files, the next step is to reflect these translations to the `.po` files. `.po` files are the finalized translation files. These `.po` files are located in `doc/locale/${LANGUAGE}/LC_MESSAGES`. Each file corresponds to a `.rst` or `.md` file. If you want to edit your translations, edit the corresponding `.edit.po` file and then reflect your changes to the `.po` file.
ja: `.edit.po` ファイルに翻訳を追加した後、`.po` ファイルへ翻訳を反映するのが、次のステップになります。`.po` ファイルは、最終的な翻訳ファイルになります。ファイルは、`doc/locale/${LANGUAGE}/LC_MESSAGES` 配下にあります。各 `.rst` または `.md` ファイルに対応しています。翻訳を編集したい場合は、対応する `.edit.po` ファイルを編集してから、変更内容を `.po` ファイルに反映し直す必要があります。

en: To reflect translations from the `.edit.po` files to the `.po` files, use the following command:
ja: 次のコマンドで、翻訳内容を `.edit.po` ファイルから `.po` ファイルへ反映します。

en: For example, if you have added Japanese translations about the {doc}`introduction` page and then execute the command above, your translations will be reflected to `/doc/locale/ja/LC_MESSAGES/contribution/documentation/introduction.po` file.
ja: 例えば、この {doc}`introduction` ページの日本語訳を行い、上記のコマンドを実行した場合、翻訳内容は、`/doc/locale/ja/LC_MESSAGES/contribution/documentation/introduction.po` ファイルに反映されます。

en: Actually, the command to generate translation `.edit.po` files is the same as the one used for reflecting translations. Therefore, there's no need to memorize different commands for generating translation files and reflecting the translations.
ja: 実は、翻訳を反映するコマンドは、翻訳用の `.edit.po` ファイルを生成するコマンドと同じコマンドです。なので、翻訳用のファイル生成と翻訳の反映で違うコマンドを覚える必要はありません。

en: You can preview your translations in your Web browser in HTML format. The step for reflecting translations into `.po` files also generates the corresponding HTML files. These files are located in `../groonga.doc/doc/${LANGUAGE}/html/`. Each file corresponds to a `.rst` or `.md` file. Open the generated HTML file in your Web browser to review your translations.
ja: 翻訳が反映されたHTML形式のドキュメントをWebブラウザで確認できます。翻訳を `.po` ファイルに反映するステップにて、HTMLファイルも生成されています。これらのファイルは `../groonga.doc/doc/${LANGUAGE}/html/` 配下に生成されています。各ファイルは `.rst` または `.md` ファイルに対応しています。生成されたファイルをWebブラウザで開き、翻訳を確認できます。

en: For example, to preview the Japanese translation of the {doc}`introduction` page, use the following command:
ja: 例えば、{doc}`introduction` ページに日本語訳を追加した場合、次のコマンドで確認できます

en: If the translations seem correct after preview, please send a patch. For more information on this process, see the [Send patch](#send-patch)
ja: 翻訳を確認して正しく反映されていたらパッチを送りましょう。送り方については、[パッチを送る](#send-patch)を参照してください。
