diff --git a/locales/ja/LC_MESSAGES/CONTRIBUTING.po b/locales/ja/LC_MESSAGES/CONTRIBUTING.po index 2dc63400..2b038c8b 100644 --- a/locales/ja/LC_MESSAGES/CONTRIBUTING.po +++ b/locales/ja/LC_MESSAGES/CONTRIBUTING.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: pyOpenSci Python Package Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-01-04 09:59+0900\n" +"POT-Creation-Date: 2026-08-25 07:47+0900\n" "PO-Revision-Date: 2025-04-14 18:12+0000\n" "Last-Translator: Tetsuo Koyama , 2025\n" "Language: ja\n" @@ -21,7 +21,7 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.17.0\n" +"Generated-By: Babel 2.18.0\n" #: ../../CONTRIBUTING.md:4 msgid "Contributing to the Python Packaging Guide" @@ -51,9 +51,9 @@ msgstr "" #: ../../CONTRIBUTING.md:13 msgid "" "If you find a typo, feel free to [submit a pull " -"request](https://github.com/pyOpenSci/python-package-guide/pulls) to " -"modify the text directly. Or, if you are less comfortable with pull " -"requests, feel free to open an issue." +"request](https://github.com/pyOpenSci/python-package-guide/pulls) to modify" +" the text directly. Or, if you are less comfortable with pull requests, " +"feel free to open an issue." msgstr "" "もしタイプミスを見つけたら、遠慮なく [submit a pull request](https://github.com/pyOpenSci" "/python-package-guide/pulls) して直接テキストを修正してください。 " @@ -61,20 +61,20 @@ msgstr "" #: ../../CONTRIBUTING.md:14 msgid "" -"If you are interested in helping translate the guide into other " -"languages, take a look at the [translation guide](./TRANSLATING.md)." +"If you are interested in helping translate the guide into other languages, " +"take a look at the [translation guide](./TRANSLATING.md)." msgstr "このガイドを他の言語に翻訳することに興味がある方は、 [翻訳ガイド](./TRANSLATING.md) をご覧ください。" #: ../../CONTRIBUTING.md:15 msgid "" -"If you want to see a larger change to the content of the guide book, " -"please submit an issue first!" +"If you want to see a larger change to the content of the guide book, please" +" submit an issue first!" msgstr "ガイドブックの内容をもっと大きく変えてほしいという方は、まずissueを投稿してください！" #: ../../CONTRIBUTING.md:17 msgid "" -"If you are unsure about how to contribute or are not familiar with git " -"and github, this guide will help you through the process." +"If you are unsure about how to contribute or are not familiar with git and " +"github, this guide will help you through the process." msgstr "どのように貢献すればいいのかわからない、あるいはgitやgithubに詳しくないという方は、このガイドを参考にしてください。" #: ../../CONTRIBUTING.md:19 @@ -106,9 +106,9 @@ msgstr "このガイドには2つの方法で貢献することができます msgid "" "The first approach is using a local copy of the guide in your computer. " "This option requires a more involved setup, but allows you to build the " -"guide locally to verify your contribution did not introduce any bugs " -"before submitting a pull request. It is the recommended approach for " -"larger contribution, like writing a whole new section." +"guide locally to verify your contribution did not introduce any bugs before" +" submitting a pull request. It is the recommended approach for larger " +"contribution, like writing a whole new section." msgstr "" "最初のアプローチは、あなたのコンピュータにあるガイドのローカルコピーを使用することです。 " "このオプションは、より複雑なセットアップを必要としますが、プルリクエストを提出する前に、ガイドをローカルでビルドし、あなたの貢献がバグを引き起こしていないことを確認することができます。" @@ -117,12 +117,12 @@ msgstr "" #: ../../CONTRIBUTING.md:31 msgid "" "The second approach is making your contribution directly in the GitHub " -"website. This option does not require any setup on your computer and " -"while your contribution will still be tested when you submit a PR " -"(continuous integration), it will take longer for you to get any feedback" -" in case of issue. It is the best way to make small contribution, like " -"fixing typos, or if this is your first contribution to open source and " -"the first approach feels too intimidating." +"website. This option does not require any setup on your computer and while " +"your contribution will still be tested when you submit a PR (continuous " +"integration), it will take longer for you to get any feedback in case of " +"issue. It is the best way to make small contribution, like fixing typos, or" +" if this is your first contribution to open source and the first approach " +"feels too intimidating." msgstr "" "二つ目の方法は、GitHub のウェブサイトで直接貢献する方法です。 " "この方法ではコンピュータのセットアップは不要で、PRを投稿した時点であなたの貢献は (継続的インテグレーション) " @@ -136,9 +136,9 @@ msgstr "リポジトリをフォークする" #: ../../CONTRIBUTING.md:35 msgid "" "Independently of the approach you choose, the first step is to fork the " -"Python Packaging Guide repository into your personal GitHub space. You " -"can do this by clicking the \"Fork\" button in the top right corner of " -"the repository page." +"Python Packaging Guide repository into your personal GitHub space. You can " +"do this by clicking the \"Fork\" button in the top right corner of the " +"repository page." msgstr "" "どの方法を選ぶかは別として、最初のステップは Python Packaging Guide のリポジトリを個人の GitHub " "スペースにフォークすることです。 リポジトリページの右上にある \"Fork \"ボタンをクリックすることでできます。" @@ -163,8 +163,8 @@ msgstr "GitHubにログインしていることを確認してください。" #: ../../CONTRIBUTING.md:44 #, fuzzy msgid "" -"Go to the repo you would like to fork, in this case the [Python Packaging" -" Guide](https://github.com/pyopensci/python-package-guide) repo." +"Go to the repo you would like to fork, in this case the [Python Packaging " +"Guide](https://github.com/pyopensci/python-package-guide) repo." msgstr "" "フォークしたいリポジトリ、ここでは [Pythonパッケージングガイド](https://www.github.com/pyopensci" "/python-package-guide) リポジトリに移動します。" @@ -172,16 +172,15 @@ msgstr "" #: ../../CONTRIBUTING.md:46 msgid "" "In the top right-hand corner of the page there is a 'Fork' button. Click " -"that button. You will be brought to a new page where you will 'Create a " -"new fork'. Feel free to keep all the default inputs and click 'Create " -"fork'. This will create a copy of the repo at " -"`https://github.com//python-package-guide`, where `` " -"is your GitHub username." +"that button. You will be brought to a new page where you will 'Create a new" +" fork'. Feel free to keep all the default inputs and click 'Create fork'. " +"This will create a copy of the repo at `https://github.com//python-package-guide`, where `` is your GitHub username." msgstr "" -"ページの右上に 'Fork' ボタンがあります。そのボタンをクリックしてください。 新しいページが表示され、そこで '新しいフォークを作成' " -"します。 デフォルトの入力のまま、'Create fork' をクリックします。 これで、 " -"`https://github.com/1/python-package-guide` にリポジトリのコピーが作成されます。 " -"`` はあなたの GitHub ユーザー名です。" +"ページの右上に 'Fork' ボタンがあります。そのボタンをクリックしてください。 新しいページが表示され、そこで '新しいフォークを作成' します。" +" デフォルトの入力のまま、'Create fork' をクリックします。 これで、 `https://github.com/1" +"/python-package-guide` にリポジトリのコピーが作成されます。 `` はあなたの GitHub " +"ユーザー名です。" #: ../../CONTRIBUTING.md:51 msgid "Contributing via the GitHub website" @@ -193,10 +192,10 @@ msgstr "MarkDownファイルの編集方法" #: ../../CONTRIBUTING.md:55 msgid "" -"The Python Packaging Guide is written in myST, a variant of MarkDown. You" -" can edit the files directly in the GitHub website. To do so, navigate to" -" the file you want to edit and click the pencil icon in the top right " -"corner of the file." +"The Python Packaging Guide is written in myST, a variant of MarkDown. You " +"can edit the files directly in the GitHub website. To do so, navigate to " +"the file you want to edit and click the pencil icon in the top right corner" +" of the file." msgstr "" "Python パッケージングガイドは、MarkDown の変種である myST " "で書かれています。GitHubのウェブサイトでファイルを直接編集できます。編集したいファイルに移動し、ファイルの右上にある鉛筆のアイコンをクリックします。" @@ -217,8 +216,8 @@ msgstr "GitHubの編集ファイル" #: ../../CONTRIBUTING.md:72 msgid "" -"An image showing when a file is being edited in GitHub. The file content " -"is displayed in a text editor." +"An image showing when a file is being edited in GitHub. The file content is" +" displayed in a text editor." msgstr "GitHubでファイルが編集されているときに表示される画像です。 ファイルの内容はテキストエディタで表示されます。" #: ../../CONTRIBUTING.md:75 @@ -232,8 +231,8 @@ msgstr "GitHubで変更をプレビューする" #: ../../CONTRIBUTING.md:83 msgid "" "An image showing how to preview changes in GitHub. The file content is " -"displayed in a text editor. The preview changes tab is highlighted with a" -" red rectangle." +"displayed in a text editor. The preview changes tab is highlighted with a " +"red rectangle." msgstr "" "GitHub で変更をプレビューする方法を示す画像です。 ファイルの内容はテキストエディタで表示されます。 " "プレビュー変更タブは赤い四角で強調表示されます。" @@ -244,10 +243,10 @@ msgstr "変更をコミットする方法" #: ../../CONTRIBUTING.md:88 msgid "" -"When you are done editing the file, scroll down to the bottom of the " -"page. You will see a section called \"Commit changes\". Here you can " -"write a title and a description for your changes. Make sure to write a " -"clear and concise title that describes the changes you made." +"When you are done editing the file, scroll down to the bottom of the page. " +"You will see a section called \"Commit changes\". Here you can write a " +"title and a description for your changes. Make sure to write a clear and " +"concise title that describes the changes you made." msgstr "" "ファイルの編集が終わったら、ページの下までスクロールしてください。 \"変更をコミット\" " "というセクションが表示されます。ここでは、変更内容のタイトルと説明を書くことができます。タイトルは、あなたが行った変更を説明する明確で簡潔なものにしましょう。" @@ -259,16 +258,16 @@ msgstr "GitHubで変更をコミットする" #: ../../CONTRIBUTING.md:97 msgid "" "An image showing how to commit changes in GitHub. The commit message is " -"displayed in a text editor. The commit changes section is highlighted " -"with a red rectangle." +"displayed in a text editor. The commit changes section is highlighted with " +"a red rectangle." msgstr "" "GitHub で変更をコミットする方法を示す画像です。コミットのメッセージはテキストエディタで表示されます。 " "コミット変更セクションは赤い四角で強調表示されます。" #: ../../CONTRIBUTING.md:100 msgid "" -"After writing your commit message, click the \"Commit changes\" button to" -" save your changes." +"After writing your commit message, click the \"Commit changes\" button to " +"save your changes." msgstr "コミットメッセージを書いたら、 \"Commit changes\" ボタンをクリックして変更を保存します。" #: ../../CONTRIBUTING.md:102 @@ -281,9 +280,8 @@ msgstr "フォークしたリポジトリをクローンする" #: ../../CONTRIBUTING.md:106 msgid "" -"To clone your forked repository to your computer, you need to copy the " -"URL of your forked repository and run the following command in your " -"terminal:" +"To clone your forked repository to your computer, you need to copy the URL " +"of your forked repository and run the following command in your terminal:" msgstr "フォークしたリポジトリを自分のコンピューターにクローンするには、フォークしたリポジトリのURLをコピーし、ターミナルで以下のコマンドを実行する必要があります:" #: ../../CONTRIBUTING.md:111 @@ -313,9 +311,9 @@ msgstr "新しいブランチを作る" #: ../../CONTRIBUTING.md:124 msgid "" -"Before making any changes, you should create a new branch to work on. " -"This will help keep your changes separate from the main branch and make " -"it easier to submit a pull request." +"Before making any changes, you should create a new branch to work on. This " +"will help keep your changes separate from the main branch and make it " +"easier to submit a pull request." msgstr "変更を加える前に、作業をする新しいブランチを作成してください。こうすることで、あなたの変更をメインブランチから切り離すことができ、プルリクエストを提出しやすくなります。" #: ../../CONTRIBUTING.md:126 @@ -329,8 +327,8 @@ msgstr "仮想環境を作る" #: ../../CONTRIBUTING.md:134 msgid "" "To build the guide locally, you need to create a virtual environment and " -"install the dependencies. You can do this by running the following " -"commands in your terminal:" +"install the dependencies. You can do this by running the following commands" +" in your terminal:" msgstr "ガイドをローカルでビルドするには、仮想環境を作成し、依存関係をインストールする必要があります。ターミナルで以下のコマンドを実行すれば可能です:" #: ../../CONTRIBUTING.md:136 @@ -347,43 +345,62 @@ msgstr "開発依存パッケージをインストールする" #: ../../CONTRIBUTING.md:150 msgid "" -"To install the development dependencies, run the following command in " -"your terminal:" +"To install the development dependencies, run the following command in your " +"terminal:" msgstr "開発依存関係をインストールするには、ターミナルで以下のコマンドを実行します:" #: ../../CONTRIBUTING.md:156 +msgid "" +"The quotes around `'.[dev]'` matter if you use zsh, the default shell on " +"macOS. Without them, zsh treats the square brackets as a filename pattern " +"and fails with `no matches found`." +msgstr "" +"`.[dev]`` を囲む引用符は、macOS のデフォルトのシェルである zsh を使用する場合に重要です。これらがないと、zsh " +"は角括弧をファイル名パターンとして扱い、「一致するものが見つかりません」というエラーで失敗します。" + +#: ../../CONTRIBUTING.md:158 +msgid "" +"On Windows they are harmless in PowerShell, but if you use the older " +"`cmd.exe` prompt you need to remove them and run `python -m pip install -e " +".[dev]` instead, because `cmd.exe` does not strip single quotes." +msgstr "" +"Windows では、これらは PowerShell では無害ですが、古い `cmd.exe` " +"プロンプトを使用している場合は、それらを削除し、代わりに `python -m pip install -e .[dev]` " +"を実行する必要があります。これは、`cmd.exe` が一重引用符を削除しないためです。" + +#: ../../CONTRIBUTING.md:160 msgid "Commit your changes" msgstr "変更をコミットする" -#: ../../CONTRIBUTING.md:158 +#: ../../CONTRIBUTING.md:162 msgid "" "After making your changes, you need to commit them to your local " "repository. To do this, run the following commands in your terminal:" msgstr "変更を加えたら、ローカルリポジトリにコミットする必要があります。 これを行うには、ターミナルで以下のコマンドを実行します:" -#: ../../CONTRIBUTING.md:160 +#: ../../CONTRIBUTING.md:164 msgid "To see the changes you made:" msgstr "変更を確認するには:" -#: ../../CONTRIBUTING.md:164 +#: ../../CONTRIBUTING.md:168 msgid "To add the changes to the staging area:" msgstr "変更をステージングエリアに追加するには:" -#: ../../CONTRIBUTING.md:168 +#: ../../CONTRIBUTING.md:172 msgid "To commit the changes:" msgstr "変更をコミットするには:" -#: ../../CONTRIBUTING.md:172 +#: ../../CONTRIBUTING.md:176 msgid "" "Replace `\"Your commit message here\"` with a clear and concise message " "that describes the changes you made." msgstr "`\"Your commit message here\"` を、あなたが行った変更を説明する明確で簡潔なメッセージに置き換えてください。" -#: ../../CONTRIBUTING.md:174 +#: ../../CONTRIBUTING.md:178 msgid "How to build the guide locally" msgstr "ローカルでのガイドのビルド方法" -#: ../../CONTRIBUTING.md:176 +#: ../../CONTRIBUTING.md:180 msgid "" "To build the guide locally, you can use the `nox` command. This will run " "the default `nox` session, which builds the guide and opens it in your " @@ -392,139 +409,139 @@ msgstr "" "ガイドをローカルにビルドするには、`nox`コマンドを使うことができます。これはデフォルトの `nox` " "セッションを実行し、ガイドをビルドしてブラウザで開きます。" -#: ../../CONTRIBUTING.md:178 +#: ../../CONTRIBUTING.md:182 msgid "" -"To see the different sessions available, you can run the following " -"command in your terminal:" +"To see the different sessions available, you can run the following command " +"in your terminal:" msgstr "利用可能なさまざまなセッションを確認するには、ターミナルで次のコマンドを実行します:" -#: ../../CONTRIBUTING.md:183 +#: ../../CONTRIBUTING.md:187 msgid "" -"There are different sessions in nox related to building the docs: `docs`," -" `docs-test`, `docs-live`. You can run them by specifying the session " -"name after the `nox` command." +"There are different sessions in nox related to building the docs: `docs`, " +"`docs-test`, `docs-live`. You can run them by specifying the session name " +"after the `nox` command." msgstr "" "noxには、ドキュメントの作成に関連するさまざまなセッションがあります: `docs`, `docs-test`, `docs-live` 。 " "`nox` コマンドの後にセッション名を指定して実行することができます。" -#: ../../CONTRIBUTING.md:185 +#: ../../CONTRIBUTING.md:189 msgid "`docs`: this session builds the guide and opens it in your browser." msgstr "`docs`: このセッションでガイドを作成し、ブラウザで開きます。" -#: ../../CONTRIBUTING.md:189 +#: ../../CONTRIBUTING.md:193 msgid "" -"To see the guide built locally, open the file `_build/html/index.html` in" -" your browser." +"To see the guide built locally, open the file `_build/html/index.html` in " +"your browser." msgstr "ローカルに構築されたガイドを見るには、ブラウザで `_build/html/index.html` ファイルを開いてください。" -#: ../../CONTRIBUTING.md:191 +#: ../../CONTRIBUTING.md:195 msgid "`docs-linkcheck`: this session checks that links in documentation work" msgstr "`docs-linkcheck`: このセッションでドキュメント内のリンクが正常に機能するか確認します。" -#: ../../CONTRIBUTING.md:195 +#: ../../CONTRIBUTING.md:199 msgid "" "If the tests fail, you will see logs in the terminal and in " "`_build/linkcheck_output/output.txt`." msgstr "テストが失敗した場合はターミナル及び`_build/linkcheck_output/output.txt`.にログが表示されます" -#: ../../CONTRIBUTING.md:197 +#: ../../CONTRIBUTING.md:201 msgid "`docs-test`: this session runs the tests for the guide." msgstr "`docs-test`: このセッションでは、ガイドのテストを実行します。" -#: ../../CONTRIBUTING.md:201 +#: ../../CONTRIBUTING.md:205 msgid "" -"If the tests fail, you will see an error message in your terminal. You " -"need to fix the errors before submitting your pull request." +"If the tests fail, you will see an error message in your terminal. You need" +" to fix the errors before submitting your pull request." msgstr "テストが失敗すると、ターミナルにエラーメッセージが表示されます。 プルリクエストを提出する前にエラーを修正する必要があります。" -#: ../../CONTRIBUTING.md:203 +#: ../../CONTRIBUTING.md:207 msgid "" "`docs-live`: this session builds the guide and opens it in your browser " "with live reloading." msgstr "`docs-live`: このセッションでガイドを作成し、ライブリローディングしてブラウザで開きます。" -#: ../../CONTRIBUTING.md:207 +#: ../../CONTRIBUTING.md:211 msgid "" -"open the local version of the guide in your browser at ``localhost`` " -"shown in the terminal." +"open the local version of the guide in your browser at ``localhost`` shown " +"in the terminal." msgstr "ターミナルに表示されている ``localhost`` のブラウザでローカル版のガイドを開いてください。" -#: ../../CONTRIBUTING.md:209 +#: ../../CONTRIBUTING.md:213 msgid "Before you submit your pull request" msgstr "プルリクエストを提出する前に" -#: ../../CONTRIBUTING.md:211 +#: ../../CONTRIBUTING.md:215 msgid "" -"Before submitting your pull request, make sure to run the tests and check" -" the formatting of your code." +"Before submitting your pull request, make sure to run the tests and check " +"the formatting of your code." msgstr "プルリクエストを提出する前に、必ずテストを実行し、コードのフォーマットをチェックしてください。" -#: ../../CONTRIBUTING.md:216 +#: ../../CONTRIBUTING.md:220 msgid "" -"If the tests fail, you will see an error message in your terminal. You " -"need to fix the errors before submitting your pull request. Also make " -"sure to check the formatting of your documentation by building the docs " -"locally and checking that your changes look correct." +"If the tests fail, you will see an error message in your terminal. You need" +" to fix the errors before submitting your pull request. Also make sure to " +"check the formatting of your documentation by building the docs locally and" +" checking that your changes look correct." msgstr "" "テストに失敗すると、ターミナルにエラーメッセージが表示されます。 プルリクエストを提出する前にエラーを修正する必要があります。 " "また、ドキュメントをローカルでビルドし、変更が正しく見えるかどうかをチェックすることで、ドキュメントのフォーマットを確認してください。" -#: ../../CONTRIBUTING.md:220 +#: ../../CONTRIBUTING.md:224 msgid "Submitting a pull request with your contribution" msgstr "あなたの貢献のプルリクエストを投稿する" -#: ../../CONTRIBUTING.md:222 +#: ../../CONTRIBUTING.md:226 msgid "How to make a pull request" msgstr "プルリクエストの作り方" -#: ../../CONTRIBUTING.md:224 +#: ../../CONTRIBUTING.md:228 msgid "" -"To open a pull request on GitHub, navigate to the main page of your " -"forked repository and click on the \"Pull requests\" tab." +"To open a pull request on GitHub, navigate to the main page of your forked " +"repository and click on the \"Pull requests\" tab." msgstr "GitHubでプルリクエストを開くには、フォークしたリポジトリのメインページに移動し、 \"Pull requests\" タブをクリックします。" -#: ../../CONTRIBUTING.md:226 +#: ../../CONTRIBUTING.md:230 msgid "Pull requests tab in GitHub" msgstr "GitHubのPull requestsタブ" -#: ../../CONTRIBUTING.md:232 +#: ../../CONTRIBUTING.md:236 msgid "" "An image showing how to navigate to the pull requests tab in GitHub. The " "pull requests tab is highlighted with a red rectangle." msgstr "GitHubのプルリクエストタブへの移動方法を示す画像です。プルリクエストタブは赤い四角で強調表示されます。" -#: ../../CONTRIBUTING.md:235 +#: ../../CONTRIBUTING.md:239 msgid "Click on the \"New pull request\" button." msgstr "\"New pull request\" ボタンをクリックします。" -#: ../../CONTRIBUTING.md:237 +#: ../../CONTRIBUTING.md:241 msgid "New pull request button in GitHub" msgstr "GitHubの新しいプルリクエストボタン" -#: ../../CONTRIBUTING.md:243 +#: ../../CONTRIBUTING.md:247 msgid "" -"An image showing how to create a new pull request in GitHub. The new pull" -" request button is highlighted with a red rectangle." +"An image showing how to create a new pull request in GitHub. The new pull " +"request button is highlighted with a red rectangle." msgstr "GitHubで新しいプルリクエストを作成する方法を示す画像です。 新しいプルリクエストボタンは赤い四角で強調表示されます。" -#: ../../CONTRIBUTING.md:246 +#: ../../CONTRIBUTING.md:250 msgid "" -"Write a clear and concise title and description for your pull request. " -"Make sure to describe the changes you made and why they are necessary." +"Write a clear and concise title and description for your pull request. Make" +" sure to describe the changes you made and why they are necessary." msgstr "プルリクエストのタイトルと説明を明確かつ簡潔に書きましょう。変更した内容と、それが必要な理由を必ず説明してください。" -#: ../../CONTRIBUTING.md:248 +#: ../../CONTRIBUTING.md:252 msgid "What happens when you submit a pull request (CI/CD)" msgstr "プルリクエストを提出するとどうなるか(CI/CD)" -#: ../../CONTRIBUTING.md:250 +#: ../../CONTRIBUTING.md:254 msgid "" "Once you submit a pull request, a series of checks will be run to ensure " "that your changes do not introduce any bugs or errors. These checks " "include:" msgstr "あなたがプルリクエストを提出すると、あなたの変更がバグやエラーを引き起こさないように、一連のチェックが実行されます。これらのチェックには以下が含まれます:" -#: ../../CONTRIBUTING.md:252 +#: ../../CONTRIBUTING.md:256 msgid "" "**Code formatting and styles**: checks that your code is formatted " "correctly, by `pre-commit.ci - pr check`." @@ -532,157 +549,154 @@ msgstr "" "**コードのフォーマットとスタイル**: は、あなたのコードが `pre-commit.ci - pr check` " "によって正しくフォーマットされているかをチェックします。" -#: ../../CONTRIBUTING.md:253 +#: ../../CONTRIBUTING.md:257 msgid "" "**docs build**: checks that the documentation builds correctly, using " "`circleci`." msgstr "**ドキュメントビルド**: は、 `circleci` を使用して、ドキュメントが正しくビルドされることをチェックします。" -#: ../../CONTRIBUTING.md:255 +#: ../../CONTRIBUTING.md:259 msgid "You will see the status of these checks in your pull request." msgstr "プルリクエストには、これらのチェックのステータスが表示されます。" -#: ../../CONTRIBUTING.md:257 +#: ../../CONTRIBUTING.md:261 msgid "Pull request checks in GitHub" msgstr "GitHubでのプルリクエストチェック" -#: ../../CONTRIBUTING.md:263 +#: ../../CONTRIBUTING.md:267 msgid "" -"An image showing the status of the checks in a pull request in GitHub. " -"The checks are displayed in a table with a status icon next to each " -"check. The checks are highlighted with a red rectangle." +"An image showing the status of the checks in a pull request in GitHub. The " +"checks are displayed in a table with a status icon next to each check. The " +"checks are highlighted with a red rectangle." msgstr "" "GitHubのプルリクエストのチェック状況を示す画像です。チェックは表で表示され、各チェックの横にステータスアイコンが表示されます。 " "チェックは赤い四角で強調表示されます。" -#: ../../CONTRIBUTING.md:265 +#: ../../CONTRIBUTING.md:269 msgid "" "If any of these checks fail, you will see an error message in your pull " "request. You need to fix the errors before your changes can be merged." msgstr "これらのチェックのいずれかが失敗した場合、プルリクエストにエラーメッセージが表示されます。変更をマージする前に、エラーを修正する必要があります。" -#: ../../CONTRIBUTING.md:267 +#: ../../CONTRIBUTING.md:271 msgid "Pull request checks failed in GitHub" msgstr "GitHubでのプルリクエストチェックに失敗" -#: ../../CONTRIBUTING.md:273 +#: ../../CONTRIBUTING.md:277 msgid "" -"An image showing the status of the checks in a pull request in GitHub. " -"The checks are displayed in a table with a status icon next to each " -"check. The checks that failed and the details link are highlighted with a" -" red rectangle." +"An image showing the status of the checks in a pull request in GitHub. The " +"checks are displayed in a table with a status icon next to each check. The " +"checks that failed and the details link are highlighted with a red " +"rectangle." msgstr "" "GitHubのプルリクエストのチェック状況を示す画像です。チェックは表で表示され、各チェックの横にステータスアイコンが表示されます。 " "失敗と詳細リンクのチェックは赤い四角で強調表示されます。" -#: ../../CONTRIBUTING.md:276 +#: ../../CONTRIBUTING.md:280 msgid "" -"To get more information about the errors, you can click on the " -"\"Details\" link next to the failed check." +"To get more information about the errors, you can click on the \"Details\" " +"link next to the failed check." msgstr "エラーに関する詳細情報を得るには、失敗したチェックの隣にある \"Details\" リンクをクリックすることができます。" -#: ../../CONTRIBUTING.md:278 +#: ../../CONTRIBUTING.md:282 msgid "What to expect from the review process" msgstr "レビュープロセスに期待すること" -#: ../../CONTRIBUTING.md:280 +#: ../../CONTRIBUTING.md:284 msgid "" -"Once you submit a pull request, a maintainer of the repository will " -"review your changes and provide feedback. The review process may involve:" +"Once you submit a pull request, a maintainer of the repository will review " +"your changes and provide feedback. The review process may involve:" msgstr "プルリクエストを提出すると、リポジトリのメンテナがあなたの変更を確認し、フィードバックを提供します。審査プロセスには以下が含まれます:" -#: ../../CONTRIBUTING.md:282 +#: ../../CONTRIBUTING.md:286 msgid "" -"**Comments**: the reviewer may leave comments on your pull request to ask" -" questions or provide feedback." +"**Comments**: the reviewer may leave comments on your pull request to ask " +"questions or provide feedback." msgstr "**Comments**: レビュアーはあなたのプルリクエストにコメントを残し、質問やフィードバックをすることができます。" -#: ../../CONTRIBUTING.md:283 +#: ../../CONTRIBUTING.md:287 msgid "" "**Suggestions**: the reviewer may suggest changes to your code or " "documentation." msgstr "**Suggestions**: レビューワーは、あなたのコードや文書の変更を提案するかもしれません。" -#: ../../CONTRIBUTING.md:284 +#: ../../CONTRIBUTING.md:288 msgid "" -"**Approvals**: once the reviewer is satisfied with your changes, they " -"will approve the pull request." +"**Approvals**: once the reviewer is satisfied with your changes, they will " +"approve the pull request." msgstr "**Approvals**: レビュアーがあなたの変更に満足したら、プルリクエストを承認します。" -#: ../../CONTRIBUTING.md:286 +#: ../../CONTRIBUTING.md:290 msgid "" "You can make changes to your pull request by pushing new commits to the " "branch. The pull request will be updated automatically with your new " "changes." msgstr "新しいコミットをブランチにプッシュすることで、プルリクエストに変更を加えることができます。プルリクエストはあなたの新しい変更で自動的に更新されます。" -#: ../../CONTRIBUTING.md:288 +#: ../../CONTRIBUTING.md:292 msgid "" -"Once your pull request is approved, it will be merged into the main " -"branch and your changes will be included in the guide." +"Once your pull request is approved, it will be merged into the main branch " +"and your changes will be included in the guide." msgstr "あなたのプルリクエストが承認されると、メインブランチにマージされ、あなたの変更がガイドに含まれます。" -#: ../../CONTRIBUTING.md:290 +#: ../../CONTRIBUTING.md:294 msgid "Additional help" msgstr "追加ヘルプ" -#: ../../CONTRIBUTING.md:292 +#: ../../CONTRIBUTING.md:296 msgid "How to get help" msgstr "助けを求めるには" -#: ../../CONTRIBUTING.md:294 +#: ../../CONTRIBUTING.md:298 msgid "" -"*__TODO__: This section should describe the options for finding more help" -" in case beginner contributors need more help (e.g., create an issue, " -"post in a forum, etc).*" +"*__TODO__: This section should describe the options for finding more help " +"in case beginner contributors need more help (e.g., create an issue, post " +"in a forum, etc).*" msgstr "" "*__TODO__: このセクションには、初心者の投稿者がさらに助けを必要とする場合に備えて、より多くの助けを見つけるためのオプション " "(イシューの作成、フォーラムへの投稿など) を記述してください。*" -#: ../../CONTRIBUTING.md:296 +#: ../../CONTRIBUTING.md:300 msgid "Additional resources" msgstr "その他のリソース" -#: ../../CONTRIBUTING.md:298 +#: ../../CONTRIBUTING.md:302 msgid "" -"*__TODO__: It should also include links to beginner documentation, like " -"the GitHub docs.*" +"*__TODO__: It should also include links to beginner documentation, like the" +" GitHub docs.*" msgstr "*__TODO__: また、GitHubのドキュメントのような初心者向けのドキュメントへのリンクも含める必要があります。*" -#: ../../CONTRIBUTING.md:300 +#: ../../CONTRIBUTING.md:304 msgid "Annex" msgstr "書き添える" -#: ../../CONTRIBUTING.md:302 +#: ../../CONTRIBUTING.md:306 msgid "Code examples" msgstr "コード例" -#: ../../CONTRIBUTING.md:304 +#: ../../CONTRIBUTING.md:308 msgid "" "This guide uses the [literalinclude Sphinx directive](https://www.sphinx-" "doc.org/en/master/usage/restructuredtext/directives.html#directive-" -"literalinclude) whenever possible to keep code and prose separate. Code " -"for use in the documentation is kept in the `examples/` folder." +"literalinclude) whenever possible to keep code and prose separate. Code for" +" use in the documentation is kept in the `examples/` folder." msgstr "" "このガイドでは、可能な限り [iteralinclude Sphinx ディレクティブ](https://www.sphinx-" "doc.org/en/master/usage/restructuredtext/directives.html#directive-" -"literalinclude) を使用して、コードと散文を分けています。 ドキュメントで使用するコードは `examples/` " -"フォルダにあります。" +"literalinclude) を使用して、コードと散文を分けています。 ドキュメントで使用するコードは `examples/` フォルダにあります。" -#: ../../CONTRIBUTING.md:308 +#: ../../CONTRIBUTING.md:312 msgid "Referencing code in documentation" msgstr "ドキュメントでコードを参照する" -#: ../../CONTRIBUTING.md:310 +#: ../../CONTRIBUTING.md:314 msgid "" "If an example is present elsewhere in the documentation that you want to " -"use, you can copy the `literalinclude` directive verbatim and the " -"examples will stay in sync." -msgstr "" -"使用したい例がドキュメントの他の場所にある場合、 `literalinclude` " -"ディレクティブをそのままコピーすれば、例は同期されたままになります。" +"use, you can copy the `literalinclude` directive verbatim and the examples " +"will stay in sync." +msgstr "使用したい例がドキュメントの他の場所にある場合、 `literalinclude` ディレクティブをそのままコピーすれば、例は同期されたままになります。" -#: ../../CONTRIBUTING.md:313 +#: ../../CONTRIBUTING.md:317 msgid "" "If you already see code in the examples folder that you can use for new " "documentation, a new `literalinclude` can be made to extract it into the " @@ -696,113 +710,113 @@ msgstr "" "に必要なのはコードへの相対パスだけですが、ほとんどの場合 `:language:` と `:lines:` も指定する必要があります。 " "前者はコード例をより美しくし、後者は将来的なコードの変更からサンプルを守ることができます。" -#: ../../CONTRIBUTING.md:318 +#: ../../CONTRIBUTING.md:322 msgid "" "**Pro tip**: As an alternative to `:lines:` there are also the `:start-" -"after:`, `:start-at:`, `:end-before:`, and `:end-at:` options. And if the" -" example code is Python, `:pyobject:` can be an even more future-proof " -"way to keep the same documentation content even through code refactors." +"after:`, `:start-at:`, `:end-before:`, and `:end-at:` options. And if the " +"example code is Python, `:pyobject:` can be an even more future-proof way " +"to keep the same documentation content even through code refactors." msgstr "" "**プロからのヒント** : `:lines:` の代わりに `:start-after:`, `:start-at:`, `:end-" "before:`, `:end-at:` オプションもあります。 また、サンプルコードがPythonの場合、 `:pyobject:` " "を使用すると、コードのリファクタリングがあっても同じドキュメント内容を維持することができます。" -#: ../../CONTRIBUTING.md:322 +#: ../../CONTRIBUTING.md:326 msgid "" "If you need example code that doesn't yet exist in `examples/` see " "[creating code for documentation](#creating-code-for-documentation)." msgstr "" -"`examples/` にまだ存在しないサンプルコードが必要な場合は、 [ドキュメント用のコードを作成する](#creating-code-" -"for-documentation) を参照してください。" +"`examples/` にまだ存在しないサンプルコードが必要な場合は、 [ドキュメント用のコードを作成する](#creating-code-for-" +"documentation) を参照してください。" -#: ../../CONTRIBUTING.md:325 +#: ../../CONTRIBUTING.md:329 msgid "Creating code for documentation" msgstr "ドキュメント用コードの作成" -#: ../../CONTRIBUTING.md:327 +#: ../../CONTRIBUTING.md:331 msgid "" "Whenever you come across a place that could benefit from a code block, " "instead of writing it in-line with a code fence (`` ``` `` blocked text) " -"you can write it as a file in its own format. Your example may even " -"already exist; [see referencing code in documentation ](#referencing-" -"code-in-documentation)." +"you can write it as a file in its own format. Your example may even already" +" exist; [see referencing code in documentation ](#referencing-code-in-" +"documentation)." msgstr "" "コードブロックが役立つ場所に出くわしたら、コードフェンス (`` ``` `` " -"ブロックテキスト)と一緒にインラインで書く代わりに、独自の形式でファイルとして書くことができます。 あなたの例はすでに存在しているかもしれません;" -" [ドキュメントのコードを参照する](#referencing-code-in-documentation) を参照してください。" +"ブロックテキスト)と一緒にインラインで書く代わりに、独自の形式でファイルとして書くことができます。 あなたの例はすでに存在しているかもしれません; " +"[ドキュメントのコードを参照する](#referencing-code-in-documentation) を参照してください。" -#: ../../CONTRIBUTING.md:331 +#: ../../CONTRIBUTING.md:335 msgid "" -"If you want to add a new example that doesn't fit into any of the " -"existing example files, you can create a new file and reference it in a " -"`literalinclude` block. If it makes sense for that file to live within " -"one of the existing example projects please add it there; otherwise " -"create a new folder in the `examples` directory." +"If you want to add a new example that doesn't fit into any of the existing " +"example files, you can create a new file and reference it in a " +"`literalinclude` block. If it makes sense for that file to live within one " +"of the existing example projects please add it there; otherwise create a " +"new folder in the `examples` directory." msgstr "" "既存のサンプルファイルのどれにも当てはまらない新しいサンプルを追加したい場合は、新しいファイルを作成して `literalinclude` " "ブロックで参照することができます。 " -"もしそのファイルが既存のサンプルプロジェクトの中にあるのが理にかなっているのであれば、そこに追加してください。そうでなければ、 " -"`examples` ディレクトリに新しいフォルダを作成してください。" +"もしそのファイルが既存のサンプルプロジェクトの中にあるのが理にかなっているのであれば、そこに追加してください。そうでなければ、 `examples` " +"ディレクトリに新しいフォルダを作成してください。" -#: ../../CONTRIBUTING.md:335 +#: ../../CONTRIBUTING.md:339 msgid "" "If an existing example is incomplete or a new example makes sense to be " -"added to an existing file, go ahead and add it, but take care to not " -"break the rest of the guide. Whenever possible, extend the example rather" -" that rewrite it. So for instance, add new functions to the end of the " -"file, new methods after all existing ones in a class." +"added to an existing file, go ahead and add it, but take care to not break " +"the rest of the guide. Whenever possible, extend the example rather that " +"rewrite it. So for instance, add new functions to the end of the file, new " +"methods after all existing ones in a class." msgstr "" "既存の例が不完全であったり、新しい例を既存のファイルに追加することに意味がある場合は、先に進んで追加してください。 " "可能な限り、例を書き直すのではなく、拡張してください。 " "例えば、ファイルの最後に新しい関数を追加したり、クラス内の既存のメソッドの後に新しいメソッドを追加したりします。" -#: ../../CONTRIBUTING.md:339 +#: ../../CONTRIBUTING.md:343 msgid "" "Example code is checked for correctness, so adding a new example may " -"require adding additional tests for coverage, and will require fixing any" -" failing tests." +"require adding additional tests for coverage, and will require fixing any " +"failing tests." msgstr "例題のコードは正しさをチェックされるので、新しい例題を追加するには、カバレッジのためのテストを追加する必要があるかもしれないし、失敗したテストを修正する必要があるかもしれません。" -#: ../../CONTRIBUTING.md:342 +#: ../../CONTRIBUTING.md:346 msgid "" "***⚠️ WARNING***: great care should be taken when modifying existing " "example code, especially any modification beyond appending to the end of " -"the file. All code examples are (potentially) shared examples. This makes" -" for more consistent examples in the guide but can mean action-" -"at-a-distance when modifying the examples for one particular use case. If" -" you find yourself modifying existing examples try running this command " -"and then checking those pages in a new build." +"the file. All code examples are (potentially) shared examples. This makes " +"for more consistent examples in the guide but can mean action-at-a-distance" +" when modifying the examples for one particular use case. If you find " +"yourself modifying existing examples try running this command and then " +"checking those pages in a new build." msgstr "" "***⚠️ 警告***: 既存のサンプル・コードを変更する場合、特にファイルの末尾に追加する以上の変更を加える場合は、細心の注意が必要です。 " "すべてのコード例は（潜在的に）共有例です。 " "これにより、ガイド内のサンプルはより一貫したものになりますが、ある特定のユースケースのためにサンプルを修正する場合、アクションが遠のく可能性があります。" " もし既存のサンプルを修正することに気づいたら、このコマンドを実行し、新しいビルドでそれらのページをチェックしてみてください。" -#: ../../CONTRIBUTING.md:350 +#: ../../CONTRIBUTING.md:354 msgid "Example:" msgstr "例:" -#: ../../CONTRIBUTING.md:352 +#: ../../CONTRIBUTING.md:356 msgid "Instead of writing example code in markdown like this" msgstr "このようにマークダウンでサンプルコードを書くのではなく" -#: ../../CONTRIBUTING.md:363 +#: ../../CONTRIBUTING.md:367 msgid "The python can be extracted into a `.py` file" msgstr "python は `.py` ファイルに展開することができます。" -#: ../../CONTRIBUTING.md:377 +#: ../../CONTRIBUTING.md:381 msgid "" -"As another example, if you only need to show part of a `pyproject.toml`, " -"we already have complete project definitions, you need only to find the " +"As another example, if you only need to show part of a `pyproject.toml`, we" +" already have complete project definitions, you need only to find the " "relevant part." msgstr "" "別の例として、 `pyproject.toml` " "の一部だけを表示する必要がある場合、我々はすでに完全なプロジェクト定義を持っているので、関連する部分を見つけるだけでよいです。" -#: ../../CONTRIBUTING.md:380 +#: ../../CONTRIBUTING.md:384 msgid "Instead of writing this" msgstr "こう書く代わりに" -#: ../../CONTRIBUTING.md:391 +#: ../../CONTRIBUTING.md:395 msgid "an example could be extracted from an existing toml file" msgstr "例は、既存のtomlファイルから抽出することができます" diff --git a/locales/ja/LC_MESSAGES/TRANSLATING.po b/locales/ja/LC_MESSAGES/TRANSLATING.po index 736ac16d..01f18383 100644 --- a/locales/ja/LC_MESSAGES/TRANSLATING.po +++ b/locales/ja/LC_MESSAGES/TRANSLATING.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: pyOpenSci Python Package Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-22 12:19-0700\n" +"POT-Creation-Date: 2026-08-25 07:47+0900\n" "PO-Revision-Date: 2025-04-14 18:12+0000\n" "Last-Translator: Tetsuo Koyama , 2025\n" "Language: ja\n" @@ -28,14 +28,14 @@ msgstr "Python パッケージングガイドの翻訳ガイド" #: ../../TRANSLATING.md:7 msgid "" -"This guide will help you get started contributing to the translation of " -"the Python Packaging Guide." +"This guide will help you get started contributing to the translation of the" +" Python Packaging Guide." msgstr "このガイドは Python パッケージングガイドの翻訳への貢献を始めるのに役立ちます。" #: ../../TRANSLATING.md:9 msgid "" -"The process of contributing to the translation of the guide is similar to" -" the process of contributing to the guide itself, except that instead of " +"The process of contributing to the translation of the guide is similar to " +"the process of contributing to the guide itself, except that instead of " "working on the guide source files directly, you will be working on the " "translation files." msgstr "ガイドの翻訳に貢献するプロセスは、ガイドのソースファイルに直接取り組むのではなく、翻訳ファイルに取り組むという点を除けば、ガイドそのものに貢献するプロセスと似ています。" @@ -45,144 +45,218 @@ msgid "Translation Status" msgstr "翻訳ステータス" #: ../../TRANSLATING.md:16 +msgid "" +"The translation status graph updates every time the book is build with " +"translations. You can see the status of the translations by going to [this " +"link](https://www.pyopensci.org/python-package-guide/TRANSLATING)" +msgstr "" +"翻訳ステータス グラフは、翻訳を含む書籍が構築されるたびに更新されます。 [このリンク](https://www.pyopensci.org" +"/python-package-guide/TRANSLATING) にアクセスすると、翻訳のステータスを確認できます。" + +#: ../../TRANSLATING.md:18 msgid "Overview of the Translation Process" msgstr "翻訳プロセスの概要" -#: ../../TRANSLATING.md:18 +#: ../../TRANSLATING.md:20 msgid "" "The process of adapting software to different languages is called " "internationalization, or i18n for short. Internationalization makes sure " -"that translation can happen without having to modify the source code, or " -"in our case, the original English source files of the guide." +"that translation can happen without having to modify the source code, or in" +" our case, the original English source files of the guide." msgstr "" "ソフトウェアを異なる言語に適応させるプロセスは国際化、略してi18nと呼ばれます。 " "国際化はソースコード、私たちの場合はガイドのオリジナルの英語のソースファイルを修正することなく翻訳が行われるようにします。" -#: ../../TRANSLATING.md:20 +#: ../../TRANSLATING.md:22 msgid "" -"Sphinx, the documentation engine we use to build the Python Package " -"Guide, has built-in support for internationalization, so the workflow is " -"very straightforward." +"Sphinx, the documentation engine we use to build the Python Package Guide, " +"has built-in support for internationalization, so the workflow is very " +"straightforward." msgstr "Pythonパッケージガイドをビルドするために使っているドキュメントエンジンであるSphinxは、国際化をビルトインでサポートしているので、ワークフローはとても簡単です。" -#: ../../TRANSLATING.md:22 +#: ../../TRANSLATING.md:24 msgid "" -"The process of actually translating the guide into different languages is" -" called localization, or l10n for short. This is the step you will be " +"The process of actually translating the guide into different languages is " +"called localization, or l10n for short. This is the step you will be " "helping with your contribution." msgstr "ガイドを実際に異なる言語に翻訳するプロセスをローカリゼーション、略してl10nと呼びます。 あなたが貢献するのはこのステップです。" -#: ../../TRANSLATING.md:24 +#: ../../TRANSLATING.md:26 msgid "Here is a quick overview of how the translation process works:" msgstr "ここでは、翻訳プロセスの概要を簡単に説明します:" -#: ../../TRANSLATING.md:26 +#: ../../TRANSLATING.md:28 msgid "" -"The guide is originally written in English and stored in a set of " -"MarkDown files." +"The guide is originally written in English and stored in a set of MarkDown " +"files." msgstr "このガイドはもともと英語で書かれており、MarkDownのファイル群に保存されています。" -#: ../../TRANSLATING.md:27 +#: ../../TRANSLATING.md:29 msgid "" -"The source files are processed by Sphinx to generate a set of translation" -" files stored in a folder for each target language." +"The source files are processed by Sphinx to generate a set of translation " +"files stored in a folder for each target language." msgstr "ソースファイルはSphinxによって処理され、各ターゲット言語のフォルダに格納された翻訳ファイルのセットを生成します。" -#: ../../TRANSLATING.md:28 -msgid "" -"Contributors (like you!) translate these files into the different " -"languages." +#: ../../TRANSLATING.md:30 +msgid "Contributors (like you!) translate these files into the different languages." msgstr "（あなたのような!）貢献者は、これらのファイルをさまざまな言語に翻訳します。" -#: ../../TRANSLATING.md:29 +#: ../../TRANSLATING.md:31 msgid "" "When the guide is built, Sphinx creates a version of the guide in the " -"original language (English) and the translated versions for the languages" -" defined in the configuration." +"original language (English) and the translated versions for the languages " +"defined in the configuration." msgstr "ガイドがビルドされると、Sphinxはオリジナルの言語(英語)と、設定で定義された言語の翻訳版のガイドを作成します。" -#: ../../TRANSLATING.md:32 +#: ../../TRANSLATING.md:34 msgid "" "You don't need to understand the technical details to contribute, but if " -"you are interested in learning how Sphinx handles internationalization " -"and localization, you can find more information [here](https://www" -".sphinx-doc.org/en/master/usage/advanced/intl.html)." +"you are interested in learning how Sphinx handles internationalization and " +"localization, you can find more information [here](https://www.sphinx-" +"doc.org/en/master/usage/advanced/intl.html)." msgstr "" "貢献するために技術的な詳細を理解する必要はありませんが、もしSphinxがどのように国際化とローカライズを処理するのかに興味があれば、 " "[ここ](https://www.sphinx-doc.org/en/master/usage/advanced/intl.html) " "に詳しい情報があります。" -#: ../../TRANSLATING.md:35 -msgid "Setting up Your Local Environment" -msgstr "ローカル環境の設定" - #: ../../TRANSLATING.md:37 -msgid "Before you start, you will need to set up your local work environment." -msgstr "作業を始める前に、ローカルの作業環境を設定する必要があります。" +#, fuzzy +msgid "Two Ways to Contribute a Translation" +msgstr "翻訳作業" #: ../../TRANSLATING.md:39 msgid "" -"First, fork the guide repository into your personal GitHub account and " -"clone the forked repository to your local computer." -msgstr "まず、ガイドリポジトリを個人のGitHubアカウントにフォークし、フォークしたリポジトリをローカルコンピューターにクローンします。" +"There are two ways to contribute a translation, and the first one does not " +"require you to install anything on your computer." +msgstr "翻訳を投稿するには 2 つの方法があり、1 つ目の方法では、コンピューターに何もインストールする必要はありません。" #: ../../TRANSLATING.md:41 msgid "" -"To create a virtual environment and install the development dependencies " -"for the guide, run the following commands:" -msgstr "仮想環境を作成し、ガイドの開発依存関係をインストールするには、以下のコマンドを実行します:" +"**From the GitHub website.** Translation files are plain text, so you can " +"edit them right in your browser. Fork the repository, edit a `.po` file in " +"your fork, and open a pull request. This is the best place to start if this" +" is your first open source contribution. The contributing guide walks " +"through the browser workflow in [Contributing via the GitHub " +"website](CONTRIBUTING.md#contributing-via-the-github-website). Once you " +"have a fork, you can skip ahead to [Editing the Translation Files" +"](#editing-the-translation-files)." +msgstr "" +"**GitHub Web サイトより。** 翻訳ファイルはプレーンテキストであるため、ブラウザで直接編集できます。リポジトリをフォークし、フォーク内の" +" `.po` ファイルを編集して、プル リクエストを開きます。初めてオープンソースに貢献する場合は、ここから始めるのが最適です。コントリビュート " +"ガイドでは、[GitHub Web サイト経由でのコントリビュート](CONTRIBUTING.md#contributing-via-the-" +"github-website) でブラウザのワークフローを説明します。フォークを取得したら、[翻訳ファイルの編集](#editing-the-" +"translation-files) に進んでください。" + +#: ../../TRANSLATING.md:43 +msgid "" +"**From a local copy on your computer.** This takes more setup, but it lets " +"you check how much of a file is translated with `sphinx-intl stat` and " +"preview the translated guide in your browser before you open a pull " +"request. Choose this if you plan to translate a lot of strings or want to " +"see your work in context." +msgstr "" +"**コンピュータ上のローカル コピーから。** これにはさらにセットアップが必要ですが、プル リクエストを開く前に、`sphinx-intl " +"stat` " +"でファイルのどの程度が翻訳されているかを確認し、ブラウザで翻訳されたガイドをプレビューできます。大量の文字列を翻訳する予定がある場合、または作業内容をコンテキスト内で確認したい場合は、これを選択してください。" + +#: ../../TRANSLATING.md:45 +msgid "Setting up Your Local Environment" +msgstr "ローカル環境の設定" -#: ../../TRANSLATING.md:50 +#: ../../TRANSLATING.md:47 +msgid "You only need this if you chose the second approach above." +msgstr "これは、上記の 2 番目のアプローチを選択した場合にのみ必要です。" + +#: ../../TRANSLATING.md:49 msgid "" -"TODO: This section needs more work or to be replaced with a reference to " -"the CONTRIBUTING guide." -msgstr "TODO: このセクションは、より多くの作業が必要か、CONTRIBUTINGガイドへの参照に置き換える必要があります。" +"Setting up to translate is no different from setting up to contribute " +"anything else to the guide, so rather than repeat the steps here, follow " +"these sections of the contributing guide in order:" +msgstr "翻訳するための設定は、ガイドに他の何かを投稿するための設定と何ら変わりません。そのため、ここで手順を繰り返すのではなく、投稿ガイドの次のセクションを順番に実行してください。" + +#: ../../TRANSLATING.md:51 +msgid "[Forking the repository](CONTRIBUTING.md#forking-the-repository)" +msgstr "[リポジトリのフォーク](CONTRIBUTING.md#forking-the-repository)" #: ../../TRANSLATING.md:52 +msgid "[Clone your forked repository](CONTRIBUTING.md#clone-your-forked-repository)" +msgstr "[フォークされたリポジトリのクローンを作成する](CONTRIBUTING.md#clone-your-forked-repository)" + +#: ../../TRANSLATING.md:53 +msgid "[Create a new branch](CONTRIBUTING.md#create-a-new-branch)" +msgstr "[新しいブランチを作成する](CONTRIBUTING.md#create-a-new-branch)" + +#: ../../TRANSLATING.md:54 +msgid "" +"[Create a virtual environment](CONTRIBUTING.md#create-a-virtual-" +"environment), which gives the commands for both Windows and macOS/Linux" +msgstr "" +"[仮想環境の作成](CONTRIBUTING.md#create-a-virtual-environment)、Windows と " +"macOS/Linux の両方のコマンドを提供します。" + +#: ../../TRANSLATING.md:55 +msgid "" +"[Install the development dependencies](CONTRIBUTING.md#install-the-" +"development-dependencies)" +msgstr "[開発依存関係をインストールする](CONTRIBUTING.md#install-the-development-dependency)" + +#: ../../TRANSLATING.md:58 +msgid "" +"Installing the development dependencies is what makes `sphinx-intl` and " +"`nox` available in your environment. Both are used later in this guide: " +"`sphinx-intl` reports how much of each file has been translated, and `nox` " +"builds the guide so you can preview your work." +msgstr "" +"開発依存関係をインストールすると、環境内で「sphinx-intl」と「nox」が使用可能になります。両方ともこのガイドの後半で使用します" +"。「sphinx-intl」は各ファイルがどれだけ翻訳されたかを報告し、「nox」は作業をプレビューできるようにガイドを構築します。" + +#: ../../TRANSLATING.md:61 msgid "Starting a New Language Translation" msgstr "新しい言語の翻訳を始める" -#: ../../TRANSLATING.md:54 +#: ../../TRANSLATING.md:63 msgid "" -"If you plan to work on an existing translation, you can skip this step " -"and go directly to the next section." +"If you plan to work on an existing translation, you can skip this step and " +"go directly to the next section." msgstr "既存の翻訳に手を加える場合は、このステップを飛ばして直接次のセクションに進んでください。" -#: ../../TRANSLATING.md:56 ../../TRANSLATING.md:222 +#: ../../TRANSLATING.md:65 ../../TRANSLATING.md:231 msgid "Important" msgstr "重要" -#: ../../TRANSLATING.md:57 +#: ../../TRANSLATING.md:66 msgid "" "If you would like to start the translation of the guide into a new " -"language, start by [creating an issue](https://github.com/pyOpenSci" -"/python-package-guide/issues) in the repository." +"language, start by [creating an issue](https://github.com/pyOpenSci/python-" +"package-guide/issues) in the repository." msgstr "" "新しい言語へのガイドの翻訳を開始したい場合は、リポジトリに [issueを作成する](https://github.com/pyOpenSci" "/python-package-guide/issues) ことから始めてください。" -#: ../../TRANSLATING.md:60 +#: ../../TRANSLATING.md:69 #, fuzzy msgid "" -"To generate the translation files for a new language, add the language to" -" the `LANGUAGES` list in the `conf.py` configuration file. " +"To generate the translation files for a new language, add the language to " +"the `languages` list in the `conf.py` configuration file. " "[Nox](https://nox.thea.codes/en/stable/index.html) is the tool we use to " -"manage the building of the guide and its translations." +"manage the building of the guide and its translations, and it reads this " +"list from `conf.py`." msgstr "" "新しい言語の翻訳ファイルを生成するには、 `noxfile.py` 設定ファイルの `LANGUAGES` リストにその言語を追加します。 " "[Nox](https://nox.thea.codes/en/stable/index.html) " "はガイドとその翻訳のビルドを管理するために使うツールです。" -#: ../../TRANSLATING.md:62 +#: ../../TRANSLATING.md:71 +#, fuzzy msgid "" -"Inside `noxfile.py`, find the `LANGUAGES` list and add the corresponding " -"two-letter code. For example, if you want to start the translation of the" -" guide into French, you would add `'fr'`:" +"Inside `conf.py`, find the `languages` list and add the corresponding two-" +"letter code. For example, if you want to start the translation of the guide" +" into French, you would add `'fr'`:" msgstr "" "`noxfile.py` の中で `LANGUAGES` リストを見つけて、対応する2文字のコードを追加します。 " "例えば、フランス語への翻訳を開始したい場合は `'fr'` を追加します:" -#: ../../TRANSLATING.md:73 +#: ../../TRANSLATING.md:80 msgid "" "You can find a list of the two-letter Sphinx language option " "[here](https://www.sphinx-doc.org/en/master/usage/configuration.html" @@ -191,56 +265,57 @@ msgstr "" "[ここで](https://www.sphinx-doc.org/en/master/usage/configuration.html" "#confval-language) 、2文字のSphinx言語オプションのリストを見つけることができます。" -#: ../../TRANSLATING.md:76 +#: ../../TRANSLATING.md:83 msgid "Preparing the Translation Files" msgstr "翻訳ファイルの準備" -#: ../../TRANSLATING.md:78 +#: ../../TRANSLATING.md:85 msgid "" -"The translation files contain the original English text and a space for " -"you to enter the translated text. Before starting to translate, you need " -"to make sure the translation files are up to date with the latest changes" -" to the guide." +"The translation files contain the original English text and a space for you" +" to enter the translated text. Before starting to translate, you need to " +"make sure the translation files are up to date with the latest changes to " +"the guide." msgstr "" "翻訳ファイルには、英語の原文と翻訳文を入力するスペースが含まれています。 " "翻訳を始める前に、翻訳ファイルがガイドの最新の変更に対応していることを確認する必要があります。" -#: ../../TRANSLATING.md:80 +#: ../../TRANSLATING.md:87 msgid "" "You can do this by running the following command, replacing LANG by the " "language code you plan to work on (e.g., `es` for Spanish):" msgstr "以下のコマンドを実行し、LANGを作業する予定の言語コードに置き換えてください (例えばスペイン語は `es`):" -#: ../../TRANSLATING.md:86 +#: ../../TRANSLATING.md:93 msgid "" -"This command will create the translation files if they don't exist yet, " -"or update them with the latest changes if they already exist." +"This command will create the translation files if they don't exist yet, or " +"update them with the latest changes if they already exist." msgstr "このコマンドは、翻訳ファイルがまだ存在しない場合は作成し、すでに存在する場合は最新の変更内容で更新します。" -#: ../../TRANSLATING.md:88 +#: ../../TRANSLATING.md:95 +#, fuzzy msgid "" "The translation files are text files with the `.po` extension stored in " -"the `./locales`, in folders corresponding to each language. For example, " -"the translation files for Spanish are stored in the " -"`locale/es/LC_MESSAGES` directory." +"`./locales`, in folders corresponding to each language. For example, the " +"translation files for Spanish are stored in the `locales/es/LC_MESSAGES` " +"directory." msgstr "" "翻訳ファイルは拡張子が `.po` のテキストファイルで、各言語に対応するフォルダ `./locales` に格納されています。 " "例えば、スペイン語の翻訳ファイルは `locale/es/LC_MESSAGES` ディレクトリに格納されています。" -#: ../../TRANSLATING.md:90 +#: ../../TRANSLATING.md:97 msgid "" -"Because the translation files map the original English text to translated" -" text, they are sometimes referred to as \"catalog\" files or \"portable " +"Because the translation files map the original English text to translated " +"text, they are sometimes referred to as \"catalog\" files or \"portable " "object\" files." msgstr "" "翻訳ファイルは、元の英文テキストと翻訳テキストを対応付けるため、 \"catalog\" ファイルや \"portable object\" " "ファイルと呼ばれることもあります。" -#: ../../TRANSLATING.md:93 +#: ../../TRANSLATING.md:100 msgid "" "You don't need to know all the details about the PO format in order to " -"translate. If you are interested in learning more, you can find " -"additional details in the [GNU gettext " +"translate. If you are interested in learning more, you can find additional " +"details in the [GNU gettext " "documentation](https://www.gnu.org/software/gettext/manual/html_node/PO-" "Files.html)." msgstr "" @@ -248,47 +323,47 @@ msgstr "" "documentation](https://www.gnu.org/software/gettext/manual/html_node/PO-" "Files.html) に詳細があります。" -#: ../../TRANSLATING.md:96 +#: ../../TRANSLATING.md:103 msgid "Working on a Translation" msgstr "翻訳作業" -#: ../../TRANSLATING.md:98 +#: ../../TRANSLATING.md:105 +#, fuzzy msgid "" "In order to start translating, go to the folder inside `./locales` " -"corresponding to the target language you want to translate to (for " -"example, `./locale/es/LC_MESSAGES/` for the Spanish translation)." +"corresponding to the target language you want to translate to (for example," +" `./locales/es/LC_MESSAGES/` for the Spanish translation)." msgstr "" "翻訳を開始するには、翻訳したいターゲット言語に対応する `./locales` 内のフォルダに移動します（例えば、スペイン語翻訳なら " "`./locale/es/LC_MESSAGES/` です）。" -#: ../../TRANSLATING.md:100 +#: ../../TRANSLATING.md:107 msgid "" "In this folder you will find a set of `.po` files, corresponding to the " "different sections of the guide:" msgstr "このフォルダには、ガイドの各セクションに対応する `.po` ファイルのセットがあります：" -#: ../../TRANSLATING.md:116 +#: ../../TRANSLATING.md:125 msgid "" "You may also see some `.mo` files in the same folder. These are compiled " -"versions of the `.po` files create by Sphinx during the build process, " -"and used to generate the translated version of the guide. They are " -"intermediary files and are not meant to be edited directly or stored in " -"the repository." +"versions of the `.po` files create by Sphinx during the build process, and " +"used to generate the translated version of the guide. They are intermediary" +" files and are not meant to be edited directly or stored in the repository." msgstr "" "また、同じフォルダにいくつかの `.mo` ファイルがあるかもしれません。 これらはSphinxがビルド中に作成した `.po` " "ファイルをコンパイルしたもので、翻訳されたバージョンのガイドを生成するために使用されます。 " "これらは中間的なファイルで、直接編集したり、リポジトリに保存したりするものではありません。" -#: ../../TRANSLATING.md:119 +#: ../../TRANSLATING.md:128 msgid "" -"If you are working on a new translation, choose one of the `.po` files to" -" start with. If you are working on an existing translation, you can start" -" with the `.po` files that need the most work." +"If you are working on a new translation, choose one of the `.po` files to " +"start with. If you are working on an existing translation, you can start " +"with the `.po` files that need the most work." msgstr "" "新しい翻訳をする場合は、`.po` ファイルを1つ選んで始めます。 既存の翻訳をする場合は、最も作業が必要な `.po` " "ファイルから始めることができます。" -#: ../../TRANSLATING.md:121 +#: ../../TRANSLATING.md:130 msgid "" "To see how much of each file has been translated, use the `sphinx-intl " "stat`. You will be able to see the number of translated, fuzzy, and " @@ -297,33 +372,33 @@ msgstr "" "各ファイルがどれくらい翻訳されたかを見るには、 `sphinx-intl stat` を使ってください。 それぞれの `.po` " "ファイルに含まれる、翻訳された文字列、あいまいな文字列、未翻訳の文字列の数を見ることができます。" -#: ../../TRANSLATING.md:123 +#: ../../TRANSLATING.md:132 msgid "" -"For example, to see the statistics for the Spanish translation, you would" -" run:" +"For example, to see the statistics for the Spanish translation, you would " +"run:" msgstr "例えば、スペイン語翻訳の統計を見るには、次のように実行します:" -#: ../../TRANSLATING.md:137 +#: ../../TRANSLATING.md:146 msgid "What do these categories mean:" msgstr "これらのカテゴリーは何を意味するのか:" -#: ../../TRANSLATING.md:139 +#: ../../TRANSLATING.md:148 msgid "" "Translated strings are strings that have been translated into the target " "language." msgstr "Translated stringsは、ターゲット言語に翻訳された文字列です。" -#: ../../TRANSLATING.md:140 +#: ../../TRANSLATING.md:149 msgid "" -"Fuzzy strings are strings that have been translated but need to be " -"reviewed because the original English string in the guide changed." +"Fuzzy strings are strings that have been translated but need to be reviewed" +" because the original English string in the guide changed." msgstr "Fuzzy stringsとは、翻訳されたものの、ガイドの元の英語の文字列が変更されたため、見直しが必要な文字列のことです。" -#: ../../TRANSLATING.md:141 +#: ../../TRANSLATING.md:150 msgid "Untranslated strings are strings that have not been translated yet." msgstr "Untranslated stringsは、まだ翻訳されていない文字列です。" -#: ../../TRANSLATING.md:144 +#: ../../TRANSLATING.md:153 msgid "" "When Sphinx is building the guide in another language, it will look into " "the corresponding folder in `./locales/` for translated strings. If the " @@ -335,23 +410,23 @@ msgstr "" "もし翻訳が利用可能であれば、Sphinxは英語のテキストをターゲット言語の同等のテキストに置き換えます。 " "もし翻訳が利用できない場合、Sphinxはオリジナルの英語の文字列を使用します。" -#: ../../TRANSLATING.md:147 +#: ../../TRANSLATING.md:156 msgid "Editing the Translation Files" msgstr "翻訳ファイルの編集" -#: ../../TRANSLATING.md:149 +#: ../../TRANSLATING.md:158 msgid "" "You can use any text editor to edit the `.po` file. But if you prefer, " "there are also tools like [Poedit](https://poedit.net/) that provide a " "graphic use interface." msgstr "" -".po`ファイルの編集にはどんなテキストエディタでも使えます。 しかし、お好みであれば、 " -"[Poedit](https://poedit.net/) のようなグラフィックなインターフェースを提供するツールもあります。" +".po`ファイルの編集にはどんなテキストエディタでも使えます。 しかし、お好みであれば、 [Poedit](https://poedit.net/) " +"のようなグラフィックなインターフェースを提供するツールもあります。" -#: ../../TRANSLATING.md:151 +#: ../../TRANSLATING.md:160 msgid "" -"Depending on your editor of choice, you may be able to install a plugin " -"or extension that can provide syntax highlighting and other features for " +"Depending on your editor of choice, you may be able to install a plugin or " +"extension that can provide syntax highlighting and other features for " "working with `.po` files. Like for example, the " "[gettext](https://marketplace.visualstudio.com/items?itemName=mrorz" ".language-gettext) extension for Visual Studio Code." @@ -361,13 +436,13 @@ msgstr "" "[gettext](https://marketplace.visualstudio.com/items?itemName=mrorz" ".language-gettext) エクステンションのようなものです。" -#: ../../TRANSLATING.md:153 +#: ../../TRANSLATING.md:162 msgid "" -"When you open a `.po` file, you will see a series of entries that look " -"like this:" +"When you open a `.po` file, you will see a series of entries that look like" +" this:" msgstr ".po`ファイルを開くと、次のようなエントリーが並んでいます:" -#: ../../TRANSLATING.md:163 +#: ../../TRANSLATING.md:172 msgid "" "The first line of an entry starts with `#:` and is a reference to the " "original source file and line number from which the text was extracted. " @@ -377,102 +452,103 @@ msgstr "" "エントリーの最初の行は `#:` で始まり、テキストが抽出された元のソースファイルと行番号への参照となります。 " "この情報は、ガイド内のテキストの文脈を見つけるのに便利です。" -#: ../../TRANSLATING.md:165 +#: ../../TRANSLATING.md:174 msgid "" "The `msgid` field contains the original English text that needs to be " -"translated. The `msgstr` field is where you will enter the translated " -"text. This field might contain text if someone else already translated " -"the entry." +"translated. The `msgstr` field is where you will enter the translated text." +" This field might contain text if someone else already translated the " +"entry." msgstr "" "`msgid` フィールドには翻訳が必要な元の英語のテキストを入力します。 `msgstr` フィールドには翻訳されたテキストを入力します。 " "このフィールドには他の人がすでに翻訳したテキストが入るかもしれません。" -#: ../../TRANSLATING.md:175 +#: ../../TRANSLATING.md:184 msgid "" -"Sometimes the original English text may be too long for a single line, " -"and it may be split into multiple lines. In this case, you can keep the " -"same structure in the translated text. Notice that both the `msgid` and " -"`msgstr` fields in the example below start with an empty string, " -"indicating that the text continues in the next line." +"Sometimes the original English text may be too long for a single line, and " +"it may be split into multiple lines. In this case, you can keep the same " +"structure in the translated text. Notice that both the `msgid` and `msgstr`" +" fields in the example below start with an empty string, indicating that " +"the text continues in the next line." msgstr "" -"英語の原文が1行では長すぎて、複数行に分かれている場合があります。 このような場合、翻訳されたテキストでも同じ構造を保つことができます。 " -"以下の例の `msgid` フィールドと `msgstr` フィールドの両方が空文字列で始まっていることに注意してください。" +"英語の原文が1行では長すぎて、複数行に分かれている場合があります。 このような場合、翻訳されたテキストでも同じ構造を保つことができます。 以下の例の " +"`msgid` フィールドと `msgstr` フィールドの両方が空文字列で始まっていることに注意してください。" -#: ../../TRANSLATING.md:191 +#: ../../TRANSLATING.md:200 msgid "" -"The English text will sometimes contain Markdown formatting, such as bold" -" or italic text. You should keep the formatting in the translated text, " +"The English text will sometimes contain Markdown formatting, such as bold " +"or italic text. You should keep the formatting in the translated text, " "making sure to translate the text inside the formatting tags." msgstr "英語のテキストには、太字や斜体などのMarkdown書式が含まれていることがあります。翻訳されたテキストで書式を維持する必要があります、フォーマットタグの中のテキストを翻訳してください。" -#: ../../TRANSLATING.md:193 +#: ../../TRANSLATING.md:202 msgid "" -"The English text may also contain links to other sections of the guide or" -" external resources. You should keep the links in the translated text, " +"The English text may also contain links to other sections of the guide or " +"external resources. You should keep the links in the translated text, " "making sure to update the link text when appropriate." msgstr "英文テキストには、ガイドの他のセクションや外部リソースへのリンクが含まれている場合があります。リンクは翻訳されたテキストの中に残してください、必要に応じてリンクテキストを更新してください。" -#: ../../TRANSLATING.md:201 +#: ../../TRANSLATING.md:210 msgid "" "An entry may be marked as `fuzzy`, which means that the original English " "text has changed since the translation was made, and the translation may " -"need to be revised. When this is the case you will see an additional line" -" in the entry, starting with `#,`:" +"need to be revised. When this is the case you will see an additional line " +"in the entry, starting with `#,`:" msgstr "" "エントリーには `fuzzy` " -"と表示されることがありますが、これは原文の英文が翻訳後に変更され、翻訳を修正する必要があることを意味します。このような場合、エントリーに `#,`" -" で始まる行が追加されます:" +"と表示されることがありますが、これは原文の英文が翻訳後に変更され、翻訳を修正する必要があることを意味します。このような場合、エントリーに `#,` " +"で始まる行が追加されます:" -#: ../../TRANSLATING.md:218 +#: ../../TRANSLATING.md:227 msgid "" -"You can review the translation and make any necessary changes, removing " -"the `fuzzy` tag once you are satisfied with the translation." +"You can review the translation and make any necessary changes, removing the" +" `fuzzy` tag once you are satisfied with the translation." msgstr "翻訳を確認して必要な変更を加え、翻訳に満足したら `fuzzy` タグを削除することができます。" -#: ../../TRANSLATING.md:220 +#: ../../TRANSLATING.md:229 msgid "" "You can also add comments to the translation file, by adding lines that " -"start with a `#` character to the entry. This can be helpful to add " -"context to the translation for other translators or reviewers to see, but" -" this might be only necessary in special circumstances." +"start with a `#` character to the entry. This can be helpful to add context" +" to the translation for other translators or reviewers to see, but this " +"might be only necessary in special circumstances." msgstr "文字で始まる行をエントリに追加することで、翻訳ファイルにコメントを追加することもできます。これは、他の翻訳者やレビュアーが翻訳を見るために文脈を追加するのに役立ちます、しかし、これは特別な状況でのみ必要かもしれません。" -#: ../../TRANSLATING.md:223 +#: ../../TRANSLATING.md:232 msgid "" "When working on a translation, you **should not** modify the original " "English text in the `msgid` field. If you see a typo or an error in the " -"original text, please consider fixing it in the original source file (use" -" the first line of the entry to locate it) and submit a separate pull " +"original text, please consider fixing it in the original source file (use " +"the first line of the entry to locate it) and submit a separate pull " "request." msgstr "" "翻訳作業をするときは、 `msgid` フィールドの元の英文を修正 **しないで** ください。 " "もし原文に誤字や脱字があった場合は、原文のソースファイル（エントリーの1行目から探してください）を修正し、別途プルリクエストを提出してください。" -#: ../../TRANSLATING.md:226 +#: ../../TRANSLATING.md:235 msgid "Building the Translated Documentation" msgstr "翻訳されたドキュメントの構築" -#: ../../TRANSLATING.md:228 +#: ../../TRANSLATING.md:237 msgid "" -"Once you finished translating or when you want to check the translation " -"in context, you can build the guide locally on your computer, using the " -"following command, replacing LANG by the proper language code (e.g., `es`" -" for Spanish)" +"Once you finished translating or when you want to check the translation in " +"context, you can build the guide locally on your computer, using the " +"following command, replacing LANG by the proper language code (e.g., `es` " +"for Spanish)" msgstr "" "翻訳が終わったら、あるいは文脈の中で翻訳をチェックしたい場合は、次のコマンドを使用して、ガイドをコンピュータにローカルに構築することができます、 " "LANGを適切な言語コードに置き換えます (例: スペイン語なら `es` )。" -#: ../../TRANSLATING.md:234 +#: ../../TRANSLATING.md:243 +#, fuzzy msgid "" -"This command will build all the translated versions of the guide defined " -"in the `LANGUAGES` list in `noxfile.py`. These translations will be " -"stored in the `_build/html`, in folders named after the language code " -"(e.g., `es`, `fr`, etc.)." +"This command builds a single translated version of the guide: the one for " +"LANG. The result is stored in `_build/html`, in a folder named after the " +"language code (e.g., `es`). If you want to build every language at once " +"instead, use `nox -s build-all-languages`." msgstr "" "このコマンドは `noxfile.py` の `LANGUAGES` リストで定義されたガイドの全ての翻訳版をビルドします。 これらの翻訳版は " "`_build/html` に、言語コードにちなんだ名前(例えば `es`、`fr` など)のフォルダに保存されます。" -#: ../../TRANSLATING.md:236 +#: ../../TRANSLATING.md:245 msgid "" "To view the translated version of the guide in your browser, open the " "corresponding `index.html` file. For example, to view the Spanish " @@ -481,19 +557,19 @@ msgstr "" "ブラウザで翻訳版のガイドを見るには、対応する `index.html` ファイルを開いてください。 例えば、スペイン語の翻訳版を見るには、 " "`_build/html/es/index.html` を開きます。" -#: ../../TRANSLATING.md:238 +#: ../../TRANSLATING.md:247 msgid "" -"You can also build a live version of the guide that updates automatically" -" as you make changes to the translation files. To do this, use the `nox " -"-s docs-live-lang` command. Note that in this case you need to specify " -"which language you want to build. For example, if you are working on the " -"Spanish translation, you would run:" +"You can also build a live version of the guide that updates automatically " +"as you make changes to the translation files. To do this, use the `nox -s " +"docs-live-lang` command. Note that in this case you need to specify which " +"language you want to build. For example, if you are working on the Spanish " +"translation, you would run:" msgstr "" "また、翻訳ファイルを変更すると自動的に更新されるガイドのライブバージョンをビルドすることもできます。 これを行うには、`nox -s docs-" "live-lang` コマンドを使用します。 この場合、ビルドしたい言語を指定する必要があることに注意してください。 " "例えば、スペイン語翻訳に取り組んでいる場合、次のように実行します:" -#: ../../TRANSLATING.md:244 +#: ../../TRANSLATING.md:253 msgid "" "Note the `--` before the language code, it indicates that the following " "arguments should be passed into the nox session and not be interpreted " @@ -503,84 +579,83 @@ msgstr "" "言語コードの前の `--` に注意してください。これは次の引数がnoxセッションに渡され、noxによって直接解釈されないことを示します。 もし " "`--` を忘れると、noxは代わりに 'es' という名前のセッションを探し、それが存在しないとエラーを発生させます。" -#: ../../TRANSLATING.md:246 +#: ../../TRANSLATING.md:255 msgid "" -"This command will use `sphinx-autobuild` to launch a local web server " -"where you can access the translated version of the guide. You can open " -"the guide in your browser by navigating to `http://localhost:8000`." +"This command will use `sphinx-autobuild` to launch a local web server where" +" you can access the translated version of the guide. You can open the guide" +" in your browser by navigating to `http://localhost:8000`." msgstr "" -"このコマンドは `sphinx-autobuild` " -"を使って、ローカルのWebサーバーを起動し、そこでガイドの翻訳版にアクセスすることができます。 ブラウザで " -"`http://localhost:8000` に移動して、ガイドを開くことができます。" +"このコマンドは `sphinx-autobuild` を使って、ローカルのWebサーバーを起動し、そこでガイドの翻訳版にアクセスすることができます。 " +"ブラウザで `http://localhost:8000` に移動して、ガイドを開くことができます。" -#: ../../TRANSLATING.md:248 +#: ../../TRANSLATING.md:257 msgid "" -"This is a great way to see how the translated version of the guide looks " -"as you make changes to the translation files." +"This is a great way to see how the translated version of the guide looks as" +" you make changes to the translation files." msgstr "これは、翻訳ファイルに変更を加えながら、翻訳版のガイドがどのように見えるかを確認するのに最適な方法です。" -#: ../../TRANSLATING.md:250 +#: ../../TRANSLATING.md:259 msgid "Submitting a PR for Your Contribution" msgstr "貢献PRの提出" -#: ../../TRANSLATING.md:252 +#: ../../TRANSLATING.md:261 msgid "" -"Once you are finished translating and before you submit a pull request " -"(PR) for your translation, you need to make sure that the translated " -"version of the guide builds without any errors or warning and looks " -"correctly in the browser." +"Once you are finished translating and before you submit a pull request (PR)" +" for your translation, you need to make sure that the translated version of" +" the guide builds without any errors or warning and looks correctly in the " +"browser." msgstr "翻訳が終わり、翻訳のプルリクエスト（PR）を提出する前に、翻訳されたバージョンのガイドがエラーや警告なしにビルドされ、ブラウザで正しく表示されることを確認する必要があります。" -#: ../../TRANSLATING.md:254 +#: ../../TRANSLATING.md:263 msgid "You can follow these steps:" msgstr "以下の手順に従ってください:" -#: ../../TRANSLATING.md:256 +#: ../../TRANSLATING.md:265 msgid "" -"Build the translations of the guide with same parameters that will be " -"used during the release:" +"Build the translations of the guide with same parameters that will be used " +"during the release:" msgstr "リリース時に使用されるのと同じパラメータでガイドの翻訳をビルドします:" -#: ../../TRANSLATING.md:262 +#: ../../TRANSLATING.md:271 msgid "" -"Make sure there are no warnings or errors in the output. If there are, " -"you will need to fix them before submitting the PR." +"Make sure there are no warnings or errors in the output. If there are, you " +"will need to fix them before submitting the PR." msgstr "出力に警告やエラーがないことを確認してください。 もしあれば、PRを提出する前に修正する必要があります。" -#: ../../TRANSLATING.md:263 +#: ../../TRANSLATING.md:272 msgid "" -"Make sure the translated version of the guide looks good in the browser " -"by opening the `_build/html//index.html` file, where `` is " -"the language you have been working on." +"Make sure the translated version of the guide looks good in the browser by " +"opening the `_build/html//index.html` file, where `` is the " +"language you have been working on." msgstr "" -"`_build/html//index.html` " -"ファイルを開いて、翻訳版のガイドがブラウザでうまく表示されることを確認してください。 `` は作業中の言語です。" +"`_build/html//index.html` ファイルを開いて、翻訳版のガイドがブラウザでうまく表示されることを確認してください。 " +"`` は作業中の言語です。" -#: ../../TRANSLATING.md:265 +#: ../../TRANSLATING.md:274 msgid "If everything looks good, you can submit a PR with your changes." msgstr "問題がなければ、変更内容をPRとして提出することができます。" -#: ../../TRANSLATING.md:268 +#: ../../TRANSLATING.md:277 msgid "" -"When you submit a PR for a translation, you should only include changes " -"to one language. If you worked in multiple languages, please submit a " -"separate PR for each language." +"When you submit a PR for a translation, you should only include changes to " +"one language. If you worked in multiple languages, please submit a separate" +" PR for each language." msgstr "翻訳のPRを提出する際は、1つの言語に対する変更のみを記載してください。 複数の言語で翻訳した場合は、言語ごとにPRを提出してください。" -#: ../../TRANSLATING.md:271 +#: ../../TRANSLATING.md:280 msgid "" "Translations PRs will be tagged with a label indicating the language to " -"make them easier to identify and review. For example, contributions to " -"the Spanish translation will be tagged with 'lang-es'." +"make them easier to identify and review. For example, contributions to the " +"Spanish translation will be tagged with 'lang-es'." msgstr "" "翻訳PRには、識別とレビューを容易にするため、言語を示すラベルが付けられます。 例えば、スペイン語翻訳への貢献には 'lang-es' " "というタグが付けられます。" -#: ../../TRANSLATING.md:273 +#: ../../TRANSLATING.md:282 msgid "TODO: This tagging could be automated with a GitHub Actions." msgstr "TODO: このタグ付けは、GitHub Actionsで自動化できるかもしれません。" -#: ../../TRANSLATING.md:275 +#: ../../TRANSLATING.md:284 msgid "" "When you submit the PR, make sure to include a short description of the " "changes you made and any context that might be helpful for the reviewer " @@ -588,17 +663,17 @@ msgid "" "typos, etc.)" msgstr "PRを提出する際には、あなたが行った変更についての簡単な説明と、レビュアーにとって参考になりそうな文脈（新しい文字列を翻訳した、あいまいなエントリーを見直した、誤字脱字を修正した、など）を必ず含めてください。" -#: ../../TRANSLATING.md:277 +#: ../../TRANSLATING.md:286 msgid "The Review Process" msgstr "レビュープロセス" -#: ../../TRANSLATING.md:279 +#: ../../TRANSLATING.md:288 msgid "" -"The review process for a translation contribution is similar to the " -"review process for any other contribution to the guide." +"The review process for a translation contribution is similar to the review " +"process for any other contribution to the guide." msgstr "翻訳貢献のレビュープロセスは、ガイドへの他のレビューのレビュープロセスと同様です。" -#: ../../TRANSLATING.md:281 +#: ../../TRANSLATING.md:290 msgid "" "TODO: This section needs more work, depending on the review workflow we " "decide to adopt. Other projects usually assign a coordinator/editor for " @@ -608,111 +683,108 @@ msgstr "" "TODO: このセクションは、私たちが採用するレビューのワークフローによって、もっと作業が必要です。 " "他のプロジェクトでは、通常、言語ごとにコーディネーター/編集者を割り当て、その人が翻訳投稿のレビューとマージに責任を持ちます。" -#: ../../TRANSLATING.md:283 +#: ../../TRANSLATING.md:292 msgid "" -"Each language has an assigned editor who is responsible for reviewing and" -" merging translation contributions. The editor will review the changes to" -" make sure they are accurate and consistent with the style and tone of " -"the guide." -msgstr "" -"各言語には担当エディターがおり、翻訳投稿の確認と統合を担当します。 " -"エディターは、変更が正確で、ガイドのスタイルやトーンと一致していることを確認します。" +"Each language has an assigned editor who is responsible for reviewing and " +"merging translation contributions. The editor will review the changes to " +"make sure they are accurate and consistent with the style and tone of the " +"guide." +msgstr "各言語には担当エディターがおり、翻訳投稿の確認と統合を担当します。 エディターは、変更が正確で、ガイドのスタイルやトーンと一致していることを確認します。" -#: ../../TRANSLATING.md:285 +#: ../../TRANSLATING.md:294 msgid "" "Sometimes the editor may ask for clarification or suggest changes to " "improve the translation. If this happens, you can make the requested " -"changes and push them to the same branch where you submitted the original" -" PR." +"changes and push them to the same branch where you submitted the original " +"PR." msgstr "" "エディターが翻訳を改善するために説明を求めたり、変更を提案したりすることがあります。 " "このような場合は、要求された変更を行い、元のPRを投稿したブランチにプッシュしてください。" -#: ../../TRANSLATING.md:287 +#: ../../TRANSLATING.md:296 msgid "" -"When the editor is satisfied with the translation, they will merge the " -"PR. The translated version of the guide will be available on the " -"pyOpenSci website once the language is released." +"When the editor is satisfied with the translation, they will merge the PR. " +"The translated version of the guide will be available on the pyOpenSci " +"website once the language is released." msgstr "エディターが翻訳に満足したら、PRをマージします。ガイドの翻訳版は言語がリリースされ次第、pyOpenSciのウェブサイトから入手できます。" -#: ../../TRANSLATING.md:289 +#: ../../TRANSLATING.md:298 msgid "The Release Process" msgstr "リリースのプロセス" -#: ../../TRANSLATING.md:291 +#: ../../TRANSLATING.md:300 +#, fuzzy msgid "" "If a language is ready to go live, the maintainers will add the language " -"code to the `RELEASE_LANGUAGES` list in the `noxfile.py` configuration " -"file." +"code to the `release_languages` list in the `conf.py` configuration file." msgstr "" "言語がライブにする準備ができたら、メンテナは `noxfile.py` 設定ファイルの `RELEASE_LANGUAGES` " "リストに言語コードを追加します。" -#: ../../TRANSLATING.md:293 +#: ../../TRANSLATING.md:302 +#, fuzzy msgid "" "When the guide is built for release in CI, Sphinx will also generate the " "translated versions of the guide for the languages in the " -"`RELEASE_LANGUAGES` list." -msgstr "" -"ガイドがCIでリリースするためにビルドされると、Sphinxは `RELEASE_LANGUAGES` " -"リストにある言語の翻訳版のガイドも生成します。" +"`release_languages` list." +msgstr "ガイドがCIでリリースするためにビルドされると、Sphinxは `RELEASE_LANGUAGES` リストにある言語の翻訳版のガイドも生成します。" -#: ../../TRANSLATING.md:295 +#: ../../TRANSLATING.md:304 #, fuzzy msgid "" "Translations are released in the same way as the English version of the " -"guide, and the translated versions will be available in folders named " -"after the language code. For example, the Spanish translation will be " -"available at: `https://www.pyopensci.org/python-package-guide/es/` when " -"it is published online." +"guide, and the translated versions will be available in folders named after" +" the language code. For example, the Spanish translation will be available " +"at: `https://www.pyopensci.org/python-package-guide/es/` when it is " +"published online." msgstr "" "翻訳版は英語版ガイドと同じ方法でリリースされ、言語コードにちなんだフォルダで利用できるようになります。 例えば、スペイン語版は " "[https://www.pyopensci.org/python-package-" "guide/es/](https://www.pyopensci.org/python-package-guide/es/) にあります。" -#: ../../TRANSLATING.md:297 +#: ../../TRANSLATING.md:306 msgid "Frequently Asked Questions (FAQ)" msgstr "よくある質問(FAQ)" -#: ../../TRANSLATING.md:299 +#: ../../TRANSLATING.md:308 msgid "How do I know which strings need to be translated?" msgstr "どの文字列を翻訳する必要があるか、どうすればわかりますか？" -#: ../../TRANSLATING.md:301 +#: ../../TRANSLATING.md:310 msgid "" -"When you run the `sphinx-intl stat` command, you will see a list of `.po`" -" files with the number of translated, fuzzy, and untranslated strings. " -"You can start by working on the files with the most untranslated strings." +"When you run the `sphinx-intl stat` command, you will see a list of `.po` " +"files with the number of translated, fuzzy, and untranslated strings. You " +"can start by working on the files with the most untranslated strings." msgstr "" "`sphinx-intl stat` コマンドを実行すると、翻訳された文字列、あいまいな文字列、未翻訳の文字列を含む `.po` " "ファイルのリストが表示されます。 未翻訳の文字列が最も多いファイルから、作業を始めることができます。" -#: ../../TRANSLATING.md:303 +#: ../../TRANSLATING.md:312 msgid "What happens when a string has changed in the original English text?" msgstr "英語の原文で文字列が変更された場合はどうなりますか？" -#: ../../TRANSLATING.md:305 +#: ../../TRANSLATING.md:314 +#, fuzzy msgid "" -"If a string has changed in the original English version, it will be " -"marked as `fuzzy` in the translation file the next time it is updated " -"(`update-language`, `update-all-languages`, or `update-all-release-" -"languages`). Contributors working on the translation can then review the " -"fuzzy entries and make the necessary changes to ensure it is accurate, " -"before removing the `fuzzy` tag." +"If a string has changed in the original English version, it will be marked " +"as `fuzzy` in the translation file the next time it is updated (`update-" +"language` or `update-release-languages`). Contributors working on the " +"translation can then review the fuzzy entries and make the necessary " +"changes to ensure it is accurate, before removing the `fuzzy` tag." msgstr "" "オリジナルの英語版で文字列が変更された場合、次に翻訳ファイルが更新されるとき (`update-language`, `update-all-" "languages`, または `update-all-release-languages`) に `fuzzy` としてマークされます。 " "翻訳に携わっているコントリビューターは、 `fuzzy` " "タグを削除する前に、あいまいなエントリを確認し、正確であることを確認するために必要な変更を行うことができます。" -#: ../../TRANSLATING.md:307 +#: ../../TRANSLATING.md:316 msgid "How do I handle links in the translated text?" msgstr "翻訳されたテキスト内のリンクはどのように扱えばいいですか？" -#: ../../TRANSLATING.md:309 +#: ../../TRANSLATING.md:318 msgid "" -"You should keep the links in the translated text, but make sure to update" -" the link text if necessary. For example, if the original English text " +"You should keep the links in the translated text, but make sure to update " +"the link text if necessary. For example, if the original English text " "contains a link to `[What is a Python package?](/tutorials/intro)`, you " "should keep the link in the translated text but update the link text to " "`[¿Que es un paquete de Python?](/tutorials/intro)`." @@ -721,127 +793,147 @@ msgstr "" "Python package?](/tutorials/intro)` へのリンクがある場合、翻訳文のリンクはそのままにして、リンクテキストを " "`[Pythonパッケージとは何ですか](/tutorials/intro)` に更新してください。" -#: ../../TRANSLATING.md:311 +#: ../../TRANSLATING.md:320 msgid "How do I handle formatting in the translated text?" msgstr "翻訳されたテキストの書式設定はどうすればよいですか？" -#: ../../TRANSLATING.md:313 +#: ../../TRANSLATING.md:322 msgid "" "You should keep the formatting in the translated text, but make sure to " -"translate the text inside the formatting tags as well. For example, if " -"the original English text is `**Test special cases:**`, you should keep " -"the bold formatting in the translated text but update the text inside the" -" formatting tags to `**Prueba casos especiales:**`." +"translate the text inside the formatting tags as well. For example, if the " +"original English text is `**Test special cases:**`, you should keep the " +"bold formatting in the translated text but update the text inside the " +"formatting tags to `**Prueba casos especiales:**`." msgstr "" -"翻訳されたテキストの書式はそのままにして、書式タグの中のテキストも翻訳してください。 たとえば、元の英語のテキストが `**Test " -"special cases:**` の場合、翻訳されたテキストでは太字の書式を維持しますが、書式タグ内のテキストを `**特殊ケーステスト:**`" -" に更新する必要があります。" +"翻訳されたテキストの書式はそのままにして、書式タグの中のテキストも翻訳してください。 たとえば、元の英語のテキストが `**Test special " +"cases:**` の場合、翻訳されたテキストでは太字の書式を維持しますが、書式タグ内のテキストを `**特殊ケーステスト:**` " +"に更新する必要があります。" -#: ../../TRANSLATING.md:315 +#: ../../TRANSLATING.md:324 msgid "How do I handle strings that are too long for a single line?" msgstr "1行では長すぎる文字列はどう扱えばいいですか？" -#: ../../TRANSLATING.md:317 +#: ../../TRANSLATING.md:326 msgid "" -"If the original English text is too long for a single line, it may be " -"split into multiple lines. Multiline strings in the `.po` file are " -"indicated by an empty string in the `msgid` and `msgstr` fields, followed" -" by the continuation of the text in the next line. For example:" +"If the original English text is too long for a single line, it may be split" +" into multiple lines. Multiline strings in the `.po` file are indicated by " +"an empty string in the `msgid` and `msgstr` fields, followed by the " +"continuation of the text in the next line. For example:" msgstr "" "元の英文が長すぎて1行に収まらない場合は、複数行に分けることができます。 `.po` ファイル内の複数行の文字列は `msgid` と " "`msgstr` フィールドに空の文字列を入れ、その後に次の行のテキストの続きを入れることで示されます。 例えば:" -#: ../../TRANSLATING.md:330 +#: ../../TRANSLATING.md:339 msgid "How do I translate images?" msgstr "画像を翻訳するにはどうすればよいですか？" -#: ../../TRANSLATING.md:332 +#: ../../TRANSLATING.md:341 msgid "" -"You should not translate images in the guide. Producing translated " -"versions of images is a complex process that requires additional tools " -"and resources, and it is not typically done unless the translated images " -"are created alongside the original images. More often, the text around " -"the image is modified to include any necessary translations." +"You should not translate images in the guide. Producing translated versions" +" of images is a complex process that requires additional tools and " +"resources, and it is not typically done unless the translated images are " +"created alongside the original images. More often, the text around the " +"image is modified to include any necessary translations." msgstr "" "ガイド内の画像を翻訳すべきではありません。 " "画像の翻訳版を作成するのは、追加のツールやリソースを必要とする複雑なプロセスであり、翻訳された画像がオリジナルの画像と一緒に作成されない限り、通常は行われません。" " 多くの場合、画像の周りのテキストは、必要な翻訳を含むように修正されます。" -#: ../../TRANSLATING.md:334 +#: ../../TRANSLATING.md:343 msgid "" -"In some special cases, an image might be critical to the understanding of" -" the content. In those cases, the translations will be handled by the " +"In some special cases, an image might be critical to the understanding of " +"the content. In those cases, the translations will be handled by the " "maintainers and editors outside this workflow." msgstr "特殊なケースでは、画像がコンテンツの理解に不可欠な場合があります。 そのような場合、翻訳はこのワークフロー外のメンテナやエディタが担当します。" -#: ../../TRANSLATING.md:336 +#: ../../TRANSLATING.md:345 msgid "" "I am interested in translating the guide into a language that is not " "listed. How can I get started?" msgstr "ガイドに掲載されていない言語への翻訳に興味があります。 どうすれば始められますか？" -#: ../../TRANSLATING.md:338 +#: ../../TRANSLATING.md:347 msgid "" -"If you want to start a new translation of the guide into a language that " -"is not listed, you should [create an issue](https://github.com/pyOpenSci" -"/python-package-guide/issues) in the repository to let the maintainers " -"know that you intend to work on it. This will help avoid duplication of " -"effort and ensure that the maintainers are ready to review your " -"contribution when you are done." +"If you want to start a new translation of the guide into a language that is" +" not listed, you should [create an issue](https://github.com/pyOpenSci" +"/python-package-guide/issues) in the repository to let the maintainers know" +" that you intend to work on it. This will help avoid duplication of effort " +"and ensure that the maintainers are ready to review your contribution when " +"you are done." msgstr "" -"リストにない言語へのガイドの新しい翻訳を始めたい場合は、リポジトリに [issue " -"を作成](https://github.com/pyOpenSci/python-package-guide/issues) " -"して、あなたがその翻訳に取り組むつもりであることをメンテナに知らせてください。 " +"リストにない言語へのガイドの新しい翻訳を始めたい場合は、リポジトリに [issue を作成](https://github.com/pyOpenSci" +"/python-package-guide/issues) して、あなたがその翻訳に取り組むつもりであることをメンテナに知らせてください。 " "こうすることで、作業の重複を避け、あなたが作業を終えたときにメンテナがあなたの貢献をレビューできるようになります。" -#: ../../TRANSLATING.md:340 +#: ../../TRANSLATING.md:349 msgid "How do I know when a translation is ready to be released?" msgstr "翻訳がいつリリースできるか、どうすればわかりますか？" -#: ../../TRANSLATING.md:342 +#: ../../TRANSLATING.md:351 +#, fuzzy msgid "" "When a translation is ready to be included in the next release of the " "guide, the maintainers will add the language code to the " -"`RELEASE_LANGUAGES` list in the `noxfile.py` configuration file. This " -"will trigger the build of the translation during the release process, and" -" the translated version of the guide will be available on the pyOpenSci " -"website." +"`release_languages` list in the `conf.py` configuration file. This will " +"trigger the build of the translation during the release process, and the " +"translated version of the guide will be available on the pyOpenSci website." msgstr "" "ガイドの次のリリースに翻訳を含める準備ができたら、メンテナは `noxfile.py` 設定ファイルの `RELEASE_LANGUAGES` " "リストに言語コードを追加します。 " "これにより、リリースプロセス中に翻訳のビルドが開始され、翻訳されたバージョンのガイドがpyOpenSciのウェブサイトで利用できるようになります。" -#: ../../TRANSLATING.md:344 +#: ../../TRANSLATING.md:353 msgid "" -"TODO: There are many approaches here, some projects release a translation" -" as soon as some strings are translated, others wait until a certain " +"TODO: There are many approaches here, some projects release a translation " +"as soon as some strings are translated, others wait until a certain " "percentage of the content is translated." msgstr "TODO：ここにはさまざまなアプローチがあります。あるプロジェクトでは、いくつかの文字列が翻訳されるとすぐに翻訳をリリースしますし、ある一定の割合のコンテンツが翻訳されるまで待つプロジェクトもあります。" -#: ../../TRANSLATING.md:346 +#: ../../TRANSLATING.md:355 msgid "How can I get help with my translation?" msgstr "翻訳を手伝ってもらうにはどうすればよいですか？" -#: ../../TRANSLATING.md:348 +#: ../../TRANSLATING.md:357 msgid "" "If you have any questions or need help with your translation, you can " -"create an [issue](https://github.com/pyOpenSci/python-package-" -"guide/issues) in the [Packaging Guide " -"repository](https://github.com/pyOpenSci/python-package-guide)" +"create an [issue](https://github.com/pyOpenSci/python-package-guide/issues)" +" in the [Packaging Guide repository](https://github.com/pyOpenSci/python-" +"package-guide)" msgstr "" "翻訳について質問がある場合や助けが必要な場合は、 [パッケージングガイドのリポジトリ](https://github.com/pyOpenSci" "/python-package-guide) に [issue](https://github.com/pyOpenSci/python-" "package-guide/issues) を作成してください。" -#: ../../TRANSLATING.md:350 +#: ../../TRANSLATING.md:359 msgid "" "You can also ask in the PyOpenSci Discord server ([click " "here](https://discord.gg/NQtTTqtv) to join), you will find a general " "channel for questions related to our workflow, processes, and tools " -"(translation-general) and channels for each of the languages we are " -"working on (spanish-translation, japanese-translation, etc)." +"(translation-general) and channels for each of the languages we are working" +" on (spanish-translation, japanese-translation, etc)." msgstr "" "PyOpenSci Discord サーバでも質問できます (参加は [こちら](https://discord.gg/NQtTTqtv)) " "、私たちのワークフロー、プロセス、ツールに関する一般的な質問用のチャンネル (translation-general) " -"と、私たちが取り組んでいる各言語のチャンネル (spanish-translation、japanese-translationなど) " -"があります。" +"と、私たちが取り組んでいる各言語のチャンネル (spanish-translation、japanese-translationなど) があります。" + +#~ msgid "Before you start, you will need to set up your local work environment." +#~ msgstr "作業を始める前に、ローカルの作業環境を設定する必要があります。" + +#~ msgid "" +#~ "First, fork the guide repository into " +#~ "your personal GitHub account and clone " +#~ "the forked repository to your local " +#~ "computer." +#~ msgstr "まず、ガイドリポジトリを個人のGitHubアカウントにフォークし、フォークしたリポジトリをローカルコンピューターにクローンします。" + +#~ msgid "" +#~ "To create a virtual environment and " +#~ "install the development dependencies for " +#~ "the guide, run the following commands:" +#~ msgstr "仮想環境を作成し、ガイドの開発依存関係をインストールするには、以下のコマンドを実行します:" + +#~ msgid "" +#~ "TODO: This section needs more work " +#~ "or to be replaced with a reference" +#~ " to the CONTRIBUTING guide." +#~ msgstr "TODO: このセクションは、より多くの作業が必要か、CONTRIBUTINGガイドへの参照に置き換える必要があります。" diff --git a/locales/ja/LC_MESSAGES/documentation.po b/locales/ja/LC_MESSAGES/documentation.po index 642125ff..ca0a64d2 100644 --- a/locales/ja/LC_MESSAGES/documentation.po +++ b/locales/ja/LC_MESSAGES/documentation.po @@ -24,7 +24,7 @@ msgstr "" #: ../../documentation/glossary.md:7 msgid "Python packaging glossary" -msgstr "" +msgstr "Python パッケージ化用語集" #: ../../documentation/glossary.md:9 #, fuzzy @@ -33,31 +33,35 @@ msgstr "あなたのパッケージ" #: ../../documentation/glossary.md msgid "`__init__.py`" -msgstr "" +msgstr "`__init__.py`" #: ../../documentation/glossary.md:13 msgid "" "A special Python file that marks a directory as a Python package. When " -"Python sees this file, it knows the folder contains importable code. It " -"can either be empty or contain code that runs when the package is " -"imported." +"Python sees this file, it knows the folder contains importable code. It can" +" either be empty or contain code that runs when the package is imported." msgstr "" +"ディレクトリを Python パッケージとしてマークする特別な Python ファイル。 Python " +"はこのファイルを参照すると、そのフォルダーにインポート可能なコードが含まれていることを認識します。空にすることも、パッケージのインポート時に実行されるコードを含めることもできます。" #: ../../documentation/glossary.md:6 msgid "API token" -msgstr "" +msgstr "APIトークン" #: ../../documentation/glossary.md:19 msgid "" -"A secret key used to authenticate with PyPI or TestPyPI when publishing a" -" package. You generate one in your account settings and use it in place " -"of a password. **Treat it like a password and never share it or commit it" -" to version control**." +"A secret key used to authenticate with PyPI or TestPyPI when publishing a " +"package. You generate one in your account settings and use it in place of a" +" password. **Treat it like a password and never share it or commit it to " +"version control**." msgstr "" +"パッケージを公開するときに PyPI または TestPyPI " +"で認証するために使用される秘密キー。アカウント設定で生成し、パスワードの代わりに使用します。 " +"**これをパスワードのように扱い、決して共有したり、バージョン管理にコミットしたりしないでください**。" #: ../../documentation/glossary.md:12 msgid "Build backend" -msgstr "" +msgstr "バックエンドの構築" #: ../../documentation/glossary.md:25 msgid "" @@ -65,14 +69,19 @@ msgid "" "distribution files. In this guide, the build backend is Hatchling. You " "specify it in your `pyproject.toml` file under `[build-system]`." msgstr "" +"パッケージを配布ファイルに構築する実際の作業を行うツール。このガイドでは、ビルド バックエンドは Hatchling です。これは、`[build-" +"system]` の下の `pyproject.toml` ファイルで指定します。" #: ../../documentation/glossary.md:29 msgid "" -"You execute a build by running `hatch build`. Alternatively, you can run" -" `python -m build`. [Reference: official Python Packaging " -"documentation](https://packaging.python.org/en/latest/tutorials" -"/packaging-projects/#choosing-a-build-backend)" +"You execute a build by running `hatch build`. Alternatively, you can run " +"`python -m build`. [Reference: official Python Packaging " +"documentation](https://packaging.python.org/en/latest/tutorials/packaging-" +"projects/#choosing-a-build-backend)" msgstr "" +"`hatch build` を実行することでビルドを実行します。あるいは、「python -m build」を実行することもできます。 [参照: 公式" +" Python パッケージ化ドキュメント](https://packaging.python.org/en/latest/tutorials" +"/packaging-projects/#choosing-a-build-backend)" #: ../../documentation/glossary.md:20 #, fuzzy @@ -81,33 +90,39 @@ msgstr "貢献ファイル" #: ../../documentation/glossary.md:33 msgid "" -"The files you upload to PyPI so others can install your package. There " -"are two common types: a wheel (`.whl`) and a source distribution " -"(`.tar.gz`). See also `Wheel (.whl)` and `Source distribution (sdist)`." +"The files you upload to PyPI so others can install your package. There are " +"two common types: a wheel (`.whl`) and a source distribution (`.tar.gz`). " +"See also `Wheel (.whl)` and `Source distribution (sdist)`." msgstr "" +"他の人がパッケージをインストールできるようにするために PyPI にアップロードするファイル。一般的なタイプには、ホイール (`.whl`) とソース" +" ディストリビューション (`.tar.gz`) の 2 つがあります。 「ホイール (.whl)」および「ソース配布 " +"(sdist)」も参照してください。" #: ../../documentation/glossary.md:26 msgid "Module" -msgstr "" +msgstr "モジュール" #: ../../documentation/glossary.md:39 msgid "" -"A single Python file (`.py`) containing code such as functions, classes, " -"or variables that can be imported. A package is made up of one or more " +"A single Python file (`.py`) containing code such as functions, classes, or" +" variables that can be imported. A package is made up of one or more " "modules." -msgstr "" +msgstr "インポートできる関数、クラス、変数などのコードを含む単一の Python ファイル (`.py`)。パッケージは 1 つ以上のモジュールで構成されます。" #: ../../documentation/glossary.md:31 msgid "`pyproject.toml`" -msgstr "" +msgstr "`pyproject.toml`" #: ../../documentation/glossary.md:44 msgid "" -"The configuration file at the root of your Python package. Written in " -"TOML format, it stores metadata such as name, version, authors, and " -"license. It can also configure tools such as Hatch, uv, and pytest. See " -"also [Make your Python package PyPI ready](../tutorials/pyproject-toml)." +"The configuration file at the root of your Python package. Written in TOML " +"format, it stores metadata such as name, version, authors, and license. It " +"can also configure tools such as Hatch, uv, and pytest. See also [Make your" +" Python package PyPI ready](../tutorials/pyproject-toml)." msgstr "" +"Python パッケージのルートにある構成ファイル。 TOML 形式で記述され、名前、バージョン、作成者、ライセンスなどのメタデータが保存されます。 " +"Hatch、uv、pytest などのツールを構成することもできます。 [Python パッケージ PyPI を準備する](../tutorials" +"/pyproject-toml) も参照してください。" #: ../../documentation/glossary.md:37 #, fuzzy @@ -116,11 +131,14 @@ msgstr "あなたのパッケージ" #: ../../documentation/glossary.md:50 msgid "" -"A directory of Python code structured so it can be installed, imported, " -"and shared with others. A package includes at least an `__init__.py` file" -" and a `pyproject.toml` file. This is sometimes referred to as a " -"**regular package**." +"A directory of Python code structured so it can be installed, imported, and" +" shared with others. A package includes at least an `__init__.py` file and " +"a `pyproject.toml` file. This is sometimes referred to as a **regular " +"package**." msgstr "" +"インストール、インポート、他のユーザーとの共有ができるように構造化された Python コードのディレクトリ。パッケージには少なくとも " +"`__init__.py` ファイルと `pyproject.toml` ファイルが含まれます。これは **通常パッケージ** " +"と呼ばれることもあります。" #: ../../documentation/glossary.md:55 msgid "" @@ -130,69 +148,85 @@ msgid "" "documentation](https://docs.python.org/3/glossary.html#term-namespace-" "package)." msgstr "" +"情報: " +"**名前空間パッケージ**という用語を聞くことがありますが、これは実際にはパッケージではなく、サブパッケージのコンテナです。これはこのガイドの範囲外です。興味がある場合は、[Python" +" ドキュメント](https://docs.python.org/3/glossary.html#term-namespace-package) " +"を参照してください。" #: ../../documentation/glossary.md:47 msgid "PyPI / TestPyPI" -msgstr "" +msgstr "PyPI / テストPyPI" #: ../../documentation/glossary.md:60 msgid "" "PyPI (the Python Package Index) is the official repository where Python " -"packages are published and installed from. TestPyPI is a separate " -"practice environment used for learning and testing publishing workflows. " -"See [pypi.org](https://pypi.org) and " -"[test.pypi.org](https://test.pypi.org). See also [Publish your Python " -"package to PyPI](../tutorials/publish-pypi)." +"packages are published and installed from. TestPyPI is a separate practice " +"environment used for learning and testing publishing workflows. See " +"[pypi.org](https://pypi.org) and [test.pypi.org](https://test.pypi.org). " +"See also [Publish your Python package to PyPI](../tutorials/publish-pypi)." msgstr "" +"PyPI (Python Package Index) は、Python パッケージが公開およびインストールされる公式リポジトリです。 " +"TestPyPI は、パブリッシュ ワークフローの学習とテストに使用される別の練習環境です。 [pypi.org](https://pypi.org)" +" および [test.pypi.org](https://test.pypi.org) を参照してください。 [Python パッケージを PyPI " +"に公開する](../tutorials/publish-pypi) も参照してください。" #: ../../documentation/glossary.md:55 msgid "Source distribution (sdist)" -msgstr "" +msgstr "ソース配布 (sdist)" #: ../../documentation/glossary.md:68 msgid "" "One of the two distribution file types for a Python package. The sdist " -"(`.tar.gz`) contains source code and project files. When someone installs" -" from an sdist, tools build the package locally first. See also [Publish " +"(`.tar.gz`) contains source code and project files. When someone installs " +"from an sdist, tools build the package locally first. See also [Publish " "your Python package to PyPI](../tutorials/publish-pypi)." msgstr "" +"Python パッケージの 2 つの配布ファイル タイプのうちの 1 つ。 sdist (`.tar.gz`) には、ソース コードとプロジェクト " +"ファイルが含まれています。誰かが sdist からインストールすると、ツールは最初にパッケージをローカルに構築します。 [Python パッケージを " +"PyPI に公開する](../tutorials/publish-pypi) も参照してください。" #: ../../documentation/glossary.md:61 msgid "TOML" -msgstr "" +msgstr "TOML" #: ../../documentation/glossary.md:74 msgid "" "Tom's Obvious Minimal Language, a simple format for configuration files. " -"TOML organizes data into tables such as `[project]` or `[tool.hatch]` and" -" arrays. `pyproject.toml` uses TOML." +"TOML organizes data into tables such as `[project]` or `[tool.hatch]` and " +"arrays. `pyproject.toml` uses TOML." msgstr "" +"Tom's Obvious Minimal Language、構成ファイルの単純な形式。 TOML はデータを `[project]` や " +"`[tool.hatch]` などのテーブルと配列に編成します。 `pyproject.toml` は TOML を使用します。" #: ../../documentation/glossary.md:66 msgid "Trusted publishing" -msgstr "" +msgstr "信頼できる出版" #: ../../documentation/glossary.md:79 msgid "" "A secure way to publish to PyPI using GitHub Actions instead of an API " -"token. Rather than storing a secret token, you configure PyPI to trust " -"your repository directly. See also [Setup Trusted Publishing for secure " -"and automated publishing via GitHub Actions](../tutorials/trusted-" -"publishing)." +"token. Rather than storing a secret token, you configure PyPI to trust your" +" repository directly. See also [Setup Trusted Publishing for secure and " +"automated publishing via GitHub Actions](../tutorials/trusted-publishing)." msgstr "" +"API トークンの代わりに GitHub Actions を使用して PyPI に公開する安全な方法。シークレット " +"トークンを保存するのではなく、リポジトリを直接信頼するように PyPI を構成します。 [GitHub Actions " +"経由で安全かつ自動公開するための信頼された公開のセットアップ](../tutorials/trusted-publishing) も参照してください。" #: ../../documentation/glossary.md:72 msgid "Wheel (.whl)" -msgstr "" +msgstr "ホイール (.whl)" #: ../../documentation/glossary.md:85 msgid "" -"The binary distribution type for a Python package. A wheel is a pre-built" -" binary format (`.whl`, a ZIP file) that installs directly without a " -"build step. For many pure Python packages, one wheel can work across " -"platforms. See also [Publish your Python package to PyPI](../tutorials" -"/publish-pypi)." +"The binary distribution type for a Python package. A wheel is a pre-built " +"binary format (`.whl`, a ZIP file) that installs directly without a build " +"step. For many pure Python packages, one wheel can work across platforms. " +"See also [Publish your Python package to PyPI](../tutorials/publish-pypi)." msgstr "" +"Python パッケージのバイナリ配布タイプ。ホイールは、ビルドステップなしで直接インストールされる、事前にビルドされたバイナリ形式 " +"(`.whl`、ZIP ファイル) です。多くの純粋な Python パッケージでは、1 つのホイールがプラットフォーム間で動作します。 " +"[Python パッケージを PyPI に公開する](../tutorials/publish-pypi) も参照してください。" #: ../../documentation/glossary.md:92 #, fuzzy @@ -211,115 +245,139 @@ msgid "" "structure, configuration, and tooling quickly. See " "[copier.readthedocs.io](https://copier.readthedocs.io)." msgstr "" +"テンプレートから新しいプロジェクトを作成するためのコマンドライン ツール。このガイドでは、コピー機と pyOpenSci パッケージ " +"テンプレートを使用して、構造、構成、ツールを迅速にセットアップできます。 " +"[copier.readthedocs.io](https://copier.readthedocs.io) を参照してください。" #: ../../documentation/glossary.md:6 msgid "coverage.py" -msgstr "" +msgstr "coverage.py" #: ../../documentation/glossary.md:102 msgid "" -"A tool that measures how much of your code is exercised by tests, often " -"as a percentage. It shows which lines and branches are covered. See " +"A tool that measures how much of your code is exercised by tests, often as " +"a percentage. It shows which lines and branches are covered. See " "[coverage.readthedocs.io](https://coverage.readthedocs.io)." msgstr "" +"テストによって実行されるコードの量を、多くの場合パーセンテージで測定するツール。どのラインとブランチがカバーされているかを示します。 " +"[coverage.readthedocs.io](https://coverage.readthedocs.io) を参照してください。" #: ../../documentation/glossary.md:11 msgid "Hatch" -msgstr "" +msgstr "ハッチ" #: ../../documentation/glossary.md:107 msgid "" -"A modern Python packaging and project management tool. In this guide, " -"Hatch is used to build packages, manage environments, run scripts, and " -"publish. Configuration lives in `pyproject.toml`. See " +"A modern Python packaging and project management tool. In this guide, Hatch" +" is used to build packages, manage environments, run scripts, and publish. " +"Configuration lives in `pyproject.toml`. See " "[hatch.pypa.io](https://hatch.pypa.io). See also [Get to know " "Hatch](../tutorials/get-to-know-hatch)." msgstr "" +"最新の Python パッケージ化およびプロジェクト管理ツール。このガイドでは、Hatch " +"を使用してパッケージを構築し、環境を管理し、スクリプトを実行し、公開します。設定は `pyproject.toml` にあります。 " +"[hatch.pypa.io](https://hatch.pypa.io) を参照してください。 [Hatch " +"について知る](../tutorials/get-to-know-hatch) も参照してください。" #: ../../documentation/glossary.md:18 msgid "Hatchling" -msgstr "" +msgstr "孵化したばかりの子" #: ../../documentation/glossary.md:114 msgid "" -"The build backend used by Hatch. When you run `python -m build` or `hatch" -" build`, Hatchling reads `pyproject.toml` and creates sdist and wheel " -"files. See " -"[hatch.pypa.io/latest/backend](https://hatch.pypa.io/latest/backend/)." +"The build backend used by Hatch. When you run `python -m build` or `hatch " +"build`, Hatchling reads `pyproject.toml` and creates sdist and wheel files." +" See [hatch.pypa.io/latest/backend](https://hatch.pypa.io/latest/backend/)." msgstr "" +"Hatch によって使用されるビルド バックエンド。 `python -m build` または `hatch build` " +"を実行すると、Hatchling は `pyproject.toml` を読み取り、sdist ファイルと Wheel ファイルを作成します。 " +"[hatch.pypa.io/latest/backend](https://hatch.pypa.io/latest/backend/) " +"を参照してください。" #: ../../documentation/glossary.md:24 msgid "pip" -msgstr "" +msgstr "ピップ" #: ../../documentation/glossary.md:120 msgid "" -"Python's default package installer. You can use it to install packages " -"from PyPI into an environment with commands such as `pip install package-" -"name`. See [pip.pypa.io](https://pip.pypa.io)." +"Python's default package installer. You can use it to install packages from" +" PyPI into an environment with commands such as `pip install package-name`." +" See [pip.pypa.io](https://pip.pypa.io)." msgstr "" +"Python のデフォルトのパッケージ インストーラー。これを使用すると、「pip install package-name」などのコマンドで " +"PyPI から環境にパッケージをインストールできます。 [pip.pypa.io](https://pip.pypa.io) を参照してください。" #: ../../documentation/glossary.md:29 msgid "pytest" -msgstr "" +msgstr "pytest" #: ../../documentation/glossary.md:125 msgid "" -"A widely used Python testing framework for discovering and running tests." -" In this guide, pytest often runs through Hatch scripts. See " +"A widely used Python testing framework for discovering and running tests. " +"In this guide, pytest often runs through Hatch scripts. See " "[docs.pytest.org](https://docs.pytest.org)." msgstr "" +"テストを検出して実行するために広く使用されている Python テスト フレームワーク。このガイドでは、pytest は多くの場合 Hatch " +"スクリプトを通じて実行されます。 [docs.pytest.org](https://docs.pytest.org) を参照してください。" #: ../../documentation/glossary.md:34 msgid "Ruff" -msgstr "" +msgstr "ラフ" #: ../../documentation/glossary.md:130 msgid "" -"A fast Python linter and formatter. It checks style and can automatically" -" fix many styling issues. See " +"A fast Python linter and formatter. It checks style and can automatically " +"fix many styling issues. See " "[docs.astral.sh/ruff](https://docs.astral.sh/ruff)." msgstr "" +"高速な Python リンターおよびフォーマッタ。スタイルをチェックし、多くのスタイルの問題を自動的に修正できます。 " +"[docs.astral.sh/ruff](https://docs.astral.sh/ruff) を参照してください。" #: ../../documentation/glossary.md:39 msgid "Sphinx" -msgstr "" +msgstr "スフィンクス" #: ../../documentation/glossary.md:135 msgid "" -"A documentation generator for Python projects. Sphinx reads docstrings " -"and documentation files to build a docs site. See [sphinx-" -"doc.org](https://www.sphinx-doc.org)." +"A documentation generator for Python projects. Sphinx reads docstrings and " +"documentation files to build a docs site. See [sphinx-doc.org](https://www" +".sphinx-doc.org)." msgstr "" +"Python プロジェクト用のドキュメント ジェネレーター。 Sphinx は docstring とドキュメント ファイルを読み取り、ドキュメント " +"サイトを構築します。 [sphinx-doc.org](https://www.sphinx-doc.org)を参照してください。" #: ../../documentation/glossary.md:44 msgid "Twine" -msgstr "" +msgstr "麻ひも" #: ../../documentation/glossary.md:140 msgid "" -"A tool for securely uploading distribution files to PyPI or TestPyPI. See" -" [twine.readthedocs.io](https://twine.readthedocs.io)." +"A tool for securely uploading distribution files to PyPI or TestPyPI. See " +"[twine.readthedocs.io](https://twine.readthedocs.io)." msgstr "" +"配布ファイルを PyPI または TestPyPI に安全にアップロードするためのツール。 " +"[twine.readthedocs.io](https://twine.readthedocs.io) を参照してください。" #: ../../documentation/glossary.md:48 msgid "uv" -msgstr "" +msgstr "紫外線" #: ../../documentation/glossary.md:144 msgid "" -"A fast Python package and environment manager. In this guide, you can use" -" uv to manage dependencies and run commands in project environments. See " +"A fast Python package and environment manager. In this guide, you can use " +"uv to manage dependencies and run commands in project environments. See " "[docs.astral.sh/uv](https://docs.astral.sh/uv)." msgstr "" +"高速な Python パッケージおよび環境マネージャー。このガイドでは、uv を使用して依存関係を管理し、プロジェクト環境でコマンドを実行できます。 " +"[docs.astral.sh/uv](https://docs.astral.sh/uv) を参照してください。" #: ../../documentation/glossary.md:149 msgid "Hatch-specific concepts" -msgstr "" +msgstr "ハッチング固有の概念" #: ../../documentation/glossary.md msgid "Hatch environment" -msgstr "" +msgstr "ハッチ環境" #: ../../documentation/glossary.md:153 msgid "" @@ -327,10 +385,12 @@ msgid "" "environments in `pyproject.toml` for testing, docs, builds, and style " "checks, each with its own dependencies and scripts." msgstr "" +"Hatch によって管理される分離された Python 環境。 `pyproject.toml` で、テスト、ドキュメント、ビルド、スタイル " +"チェック用に複数の環境を定義でき、それぞれに独自の依存関係とスクリプトが含まれます。" #: ../../documentation/glossary.md:5 msgid "Script (Hatch)" -msgstr "" +msgstr "スクリプト（ハッチング）" #: ../../documentation/glossary.md:158 msgid "" @@ -338,17 +398,21 @@ msgid "" "Scripts provide shortcuts such as `hatch run build:check` and `hatch run " "test:run`." msgstr "" +"`pyproject.toml` の Hatch 環境内で定義された名前付きコマンド。スクリプトには、「hatch run " +"build:check」や「hatch run test:run」などのショートカットが用意されています。" #: ../../documentation/glossary.md:10 msgid "Task runner" -msgstr "" +msgstr "タスクランナー" #: ../../documentation/glossary.md:163 msgid "" -"A tool that automates repetitive development workflows. Hatch can " -"function as a task runner by letting you define scripts that run in " -"specific environments." +"A tool that automates repetitive development workflows. Hatch can function " +"as a task runner by letting you define scripts that run in specific " +"environments." msgstr "" +"反復的な開発ワークフローを自動化するツール。 Hatch は、特定の環境で実行されるスクリプトを定義できるようにすることで、タスク " +"ランナーとして機能できます。" #: ../../documentation/glossary.md:168 #, fuzzy @@ -357,14 +421,16 @@ msgstr "開発ガイド" #: ../../documentation/glossary.md msgid "Code coverage" -msgstr "" +msgstr "コードカバレッジ" #: ../../documentation/glossary.md:172 msgid "" "A measure of how much source code executes during tests, usually as a " -"percentage. High coverage does not guarantee no bugs, but low coverage " -"can indicate untested areas." +"percentage. High coverage does not guarantee no bugs, but low coverage can " +"indicate untested areas." msgstr "" +"テスト中に実行されるソース コードの量の尺度 " +"(通常はパーセンテージ)。カバレッジが高いからといってバグがないことは保証されませんが、カバレッジが低い場合はテストされていない領域があることを示している可能性があります。" #: ../../documentation/glossary.md:5 #, fuzzy @@ -376,7 +442,7 @@ msgid "" "Other Python packages needed for your package to work. Common classes " "include required dependencies, optional dependencies, and development " "dependencies." -msgstr "" +msgstr "パッケージが動作するために必要な他の Python パッケージ。共通クラスには、必須の依存関係、オプションの依存関係、および開発の依存関係が含まれます。" #: ../../documentation/glossary.md:10 #, fuzzy @@ -389,10 +455,12 @@ msgid "" "behavior, inputs, and outputs. Docstrings can be used by tools such as " "Sphinx to generate API documentation." msgstr "" +"動作、入力、出力を説明する関数、クラス、またはモジュールの先頭にある文字列。 docstring は、Sphinx などのツールで API " +"ドキュメントを生成するために使用できます。" #: ../../documentation/glossary.md:15 msgid "End-to-end test" -msgstr "" +msgstr "エンドツーエンドのテスト" #: ../../documentation/glossary.md:187 msgid "" @@ -400,89 +468,95 @@ msgid "" "scientific packages, tutorials executed during docs builds can serve as " "end-to-end tests." msgstr "" +"最初から最後まで完全なユーザー " +"ワークフローをシミュレートするテスト。科学的パッケージでは、ドキュメントのビルド中に実行されるチュートリアルがエンドツーエンドのテストとして機能します。" #: ../../documentation/glossary.md:20 msgid "Integration test" -msgstr "" +msgstr "結合テスト" #: ../../documentation/glossary.md:192 msgid "" "A test that checks how multiple functions or components work together. " "Unlike a unit test, it verifies behavior across a broader workflow." -msgstr "" +msgstr "複数の機能またはコンポーネントがどのように連携して動作するかをチェックするテスト。単体テストとは異なり、より広範なワークフロー全体の動作を検証します。" #: ../../documentation/glossary.md:24 msgid "Linting" -msgstr "" +msgstr "糸くず" #: ../../documentation/glossary.md:196 msgid "" "Automatic checks for style issues, formatting problems, and potential " "errors in code." -msgstr "" +msgstr "スタイルの問題、書式設定の問題、コード内の潜在的なエラーを自動的にチェックします。" #: ../../documentation/glossary.md:28 msgid "Unit test" -msgstr "" +msgstr "単体テスト" #: ../../documentation/glossary.md:200 msgid "" -"A test that checks one function or method in isolation. Unit tests are " -"fast and help pinpoint where failures occur." -msgstr "" +"A test that checks one function or method in isolation. Unit tests are fast" +" and help pinpoint where failures occur." +msgstr "1 つの関数またはメソッドを単独でチェックするテスト。単体テストは高速であり、障害が発生した場所を特定するのに役立ちます。" #: ../../documentation/glossary.md:32 msgid "Version specifier / lower bound" -msgstr "" +msgstr "バージョン指定子/下限" #: ../../documentation/glossary.md:204 msgid "" "A constraint on which dependency versions are accepted. For example, " -"`numpy>=1.24` sets a lower bound so versions older than 1.24 are not " -"used." -msgstr "" +"`numpy>=1.24` sets a lower bound so versions older than 1.24 are not used." +msgstr "依存関係のバージョンを受け入れる制約。たとえば、`numpy>=1.24` は下限を設定するため、1.24 より古いバージョンは使用されません。" #: ../../documentation/glossary.md:209 msgid "Git / GitHub" -msgstr "" +msgstr "Git / GitHub" #: ../../documentation/glossary.md msgid "git" -msgstr "" +msgstr "git" #: ../../documentation/glossary.md:213 msgid "A tool for version control." -msgstr "" +msgstr "バージョン管理のためのツールです。" #: ../../documentation/glossary.md:3 msgid "GitHub" -msgstr "" +msgstr "GitHub" #: ../../documentation/glossary.md:216 msgid "" "A service providing accounts and organizations to facilitate sharing " "repositories." -msgstr "" +msgstr "リポジトリの共有を容易にするアカウントと組織を提供するサービス。" #: ../../documentation/glossary.md:6 msgid "GitHub Codespace" -msgstr "" +msgstr "GitHub コードスペース" #: ../../documentation/glossary.md:219 msgid "" "A cloud-based development environment that runs in a browser. See " "[github.com/features/codespaces](https://github.com/features/codespaces)." msgstr "" +"ブラウザ上で動作するクラウドベースの開発環境。 " +"[github.com/features/codespaces](https://github.com/features/codespaces) " +"を参照してください。" #: ../../documentation/glossary.md:10 msgid "Scoped commit" -msgstr "" +msgstr "スコープ付きコミット" #: ../../documentation/glossary.md:223 msgid "" -"A git commit that makes one focused change, such as one fix or one " -"feature update. Scoped commits improve reviewability and history clarity." +"A git commit that makes one focused change, such as one fix or one feature " +"update. Scoped commits improve reviewability and history clarity." msgstr "" +"1 つの修正や 1 つの機能更新など、1 つの集中的な変更を行う git " +"コミット。スコープ付きコミットにより、レビュー可能性と履歴の明確さが向上します。" #: ../../documentation/glossary.md:228 #, fuzzy @@ -498,7 +572,7 @@ msgstr "あなたの行動規範" msgid "" "A document that sets expectations for how contributors and community " "members treat one another in a project." -msgstr "" +msgstr "プロジェクト内で貢献者とコミュニティのメンバーが互いにどのように接するかについての期待を設定する文書。" #: ../../documentation/glossary.md:4 #, fuzzy @@ -510,6 +584,8 @@ msgid "" "A document, often `CONTRIBUTING.md`, that explains how others can " "contribute, including setup steps, workflow, and code style." msgstr "" +"セットアップ手順、ワークフロー、コード スタイルなど、他の人がどのように貢献できるかを説明するドキュメント " +"(多くの場合「CONTRIBUTING.md」)。" #: ../../documentation/glossary.md:8 #, fuzzy @@ -518,11 +594,13 @@ msgstr "myST vs Markdown vs rst" #: ../../documentation/glossary.md:240 msgid "" -"Markedly Structured Text, a Markdown flavor that supports Sphinx " -"directives and roles. It allows Markdown-based docs while keeping Sphinx " -"features. See [myst-parser.readthedocs.io](https://myst-" -"parser.readthedocs.io)." +"Markedly Structured Text, a Markdown flavor that supports Sphinx directives" +" and roles. It allows Markdown-based docs while keeping Sphinx features. " +"See [myst-parser.readthedocs.io](https://myst-parser.readthedocs.io)." msgstr "" +"Markedly Structured Text、Sphinx ディレクティブとロールをサポートする Markdown フレーバー。 Sphinx " +"の機能を維持しながら、Markdown ベースのドキュメントが可能になります。 [myst-parser.readthedocs.io](https" +"://myst-parser.readthedocs.io)を参照してください。" #: ../../documentation/glossary.md:14 #, fuzzy @@ -531,17 +609,19 @@ msgstr "README ファイル" #: ../../documentation/glossary.md:246 msgid "" -"The front page of your package on GitHub and often on PyPI. A good README" -" explains purpose, installation, usage, and support options." +"The front page of your package on GitHub and often on PyPI. A good README " +"explains purpose, installation, usage, and support options." msgstr "" +"GitHub および多くの場合 PyPI 上のパッケージのフロント ページ。優れた README では、目的、インストール、使用方法、サポート " +"オプションについて説明しています。" #: ../../documentation/glossary.md:250 msgid "AI" -msgstr "" +msgstr "AI" #: ../../documentation/glossary.md msgid "Generative AI / LLM" -msgstr "" +msgstr "生成AI / LLM" #: ../../documentation/glossary.md:254 msgid "" @@ -549,6 +629,8 @@ msgid "" "stands for Large Language Model, the technology behind tools such as " "ChatGPT, GitHub Copilot, and Claude." msgstr "" +"生成 AI システムは、テキスト、コード、画像などのコンテンツを生成します。 LLM は Large Language Model " +"の略で、ChatGPT、GitHub Copilot、Claude などのツールの背後にあるテクノロジーです。" #: ../../documentation/hosting-tools/intro.md:1 msgid "Tools to Build and Host your Documentation" @@ -558,8 +640,8 @@ msgstr "ドキュメンテーションの構築とホスティングのための msgid "" "The most common tool for building documentation in the Python ecosystem " "currently is Sphinx. However, some maintainers are using tools like " -"[mkdocs](https://www.mkdocs.org/) for documentation. It is up to you to " -"use the platform that you prefer for your documentation!" +"[mkdocs](https://www.mkdocs.org/) for documentation. It is up to you to use" +" the platform that you prefer for your documentation!" msgstr "" "現在、Pythonエコシステムでドキュメントを構築するための最も一般的なツールはSphinxです。 しかし、 " "[mkdocs](https://www.mkdocs.org/) のようなツールを使っているメンテナもいます。 " @@ -568,8 +650,8 @@ msgstr "" #: ../../documentation/hosting-tools/intro.md:8 msgid "" "In this section, we introduce Sphinx as a common tool to build " -"documentation. We talk about various syntax options that you can use when" -" writing Sphinx documentation including mySt and rST." +"documentation. We talk about various syntax options that you can use when " +"writing Sphinx documentation including mySt and rST." msgstr "" "このセクションでは、ドキュメントを作成するための一般的なツールとしてSphinxを紹介します。 " "ここでは、Sphinxのドキュメントを書くときに使用できる、myStやrSTを含むさまざまな構文オプションについて説明します。" @@ -591,12 +673,12 @@ msgstr "Pythonのドキュメントを作成するためによく使われる構 #: ../../documentation/hosting-tools/myst-markdown-rst-doc-syntax.md:4 msgid "" "[markdown](https://www.markdownguide.org/): Markdown is an easy-to-learn " -"text syntax. It is the default syntax used in Jupyter Notebooks. There " -"are tools that you can add to a Sphinx website that allow it to render " -"markdown as html. However, using markdown to write documentation has " -"limitations. For instance if you want to add references, colored call out" -" blocks and other custom elements to your documentation, you will need to" -" use either **myST** or **rST**." +"text syntax. It is the default syntax used in Jupyter Notebooks. There are " +"tools that you can add to a Sphinx website that allow it to render markdown" +" as html. However, using markdown to write documentation has limitations. " +"For instance if you want to add references, colored call out blocks and " +"other custom elements to your documentation, you will need to use either " +"**myST** or **rST**." msgstr "" "[markdown](https://www.markdownguide.org/): Markdownは習得しやすいテキスト構文です。 " "これはJupyter Notebooksで使われるデフォルトの構文です。 " @@ -620,14 +702,14 @@ msgstr "" #: ../../documentation/hosting-tools/myst-markdown-rst-doc-syntax.md:9 msgid "" -"[myST:](https://myst-parser.readthedocs.io/en/latest/intro.html) myST is " -"a combination of `markdown` and `rST` syntax. It is a nice option if you " -"are comfortable writing markdown. `myst` is preferred by many because it " -"offers both the rich functionality of rST combined with a simple-to-write" -" markdown syntax." +"[myST:](https://myst-parser.readthedocs.io/en/latest/intro.html) myST is a " +"combination of `markdown` and `rST` syntax. It is a nice option if you are " +"comfortable writing markdown. `myst` is preferred by many because it offers" +" both the rich functionality of rST combined with a simple-to-write " +"markdown syntax." msgstr "" -"[myST:](https://myst-parser.readthedocs.io/en/latest/intro.html) mySTは普通の" -" `markdown` と `rST` の構文の組み合わせです。 もしあなたがマークダウンを書くのに慣れているのであれば、良いオプションです。 " +"[myST:](https://myst-parser.readthedocs.io/en/latest/intro.html) mySTは普通の " +"`markdown` と `rST` の構文の組み合わせです。 もしあなたがマークダウンを書くのに慣れているのであれば、良いオプションです。 " "myst`はrSTの豊富な機能と書きやすいマークダウン構文の両方を提供するため、多くの人に好まれています。" #: ../../documentation/hosting-tools/myst-markdown-rst-doc-syntax.md:12 @@ -642,14 +724,14 @@ msgstr "よりシンプルな構文であるため、習得しやすいです;" #: ../../documentation/hosting-tools/myst-markdown-rst-doc-syntax.md:16 msgid "" -"The above simplicity will make it easier for more people to contribute to" -" your documentation." +"The above simplicity will make it easier for more people to contribute to " +"your documentation." msgstr "上記のようにシンプルにすることで、より多くの人があなたのドキュメントに貢献しやすくなります。" #: ../../documentation/hosting-tools/myst-markdown-rst-doc-syntax.md:17 msgid "" -"Most of your core Python package text files, such as your README.md file," -" are already in `.md` format" +"Most of your core Python package text files, such as your README.md file, " +"are already in `.md` format" msgstr "README.mdファイルなど、Pythonパッケージのコアとなるテキストファイルのほとんどは、すでに `.md` 形式になっています。" #: ../../documentation/hosting-tools/myst-markdown-rst-doc-syntax.md:18 @@ -660,8 +742,8 @@ msgstr "`GitHub` と `Jupyter Notebooks` はMarkdownをサポートしており #: ../../documentation/hosting-tools/myst-markdown-rst-doc-syntax.md:22 msgid "" -"If you are on the fence about myST vs rst, you might find that **myST** " -"is easier for more people to contribute to." +"If you are on the fence about myST vs rst, you might find that **myST** is " +"easier for more people to contribute to." msgstr "mySTとrstを迷っているなら、 **myST** の方がより多くの人が貢献しやすいと感じるかもしれません。" #: ../../documentation/hosting-tools/publish-documentation-online.md:1 @@ -728,8 +810,8 @@ msgstr "プルリクエストとの統合を有効にすると、ドキュメン #: ../../documentation/hosting-tools/publish-documentation-online.md:19 msgid "" "Supports versioning of your documentation which allows users to refer to " -"older tagged versions of the docs if they are using older versions of " -"your package." +"older tagged versions of the docs if they are using older versions of your " +"package." msgstr "ドキュメントのバージョン管理をサポートし、ユーザーが古いバージョンのパッケージを使用している場合、タグ付けされた古いバージョンのドキュメントを参照できるようにします。" #: ../../documentation/hosting-tools/publish-documentation-online.md:20 @@ -750,14 +832,14 @@ msgstr "GitHub Pagesとは？" #, fuzzy msgid "" "[GitHub Pages](https://docs.github.com/en/pages/getting-started-with-" -"github-pages/what-is-github-pages) is a free web hosting service offered " -"by GitHub. Using GitHub pages, you can build your documentation locally " -"or using a Continuous Integration setup, and then push to a branch in " -"your GitHub repository that is setup to run the GitHub Pages web build." +"github-pages/what-is-github-pages) is a free web hosting service offered by" +" GitHub. Using GitHub pages, you can build your documentation locally or " +"using a Continuous Integration setup, and then push to a branch in your " +"GitHub repository that is setup to run the GitHub Pages web build." msgstr "" "[GitHub Pages](https://docs.github.com/en/pages/getting-started-with-" -"github-pages/about-github-pages) は GitHub が提供する無料のウェブホスティングサービスです。 GitHub" -" Pages を使えば、ローカルあるいは継続的インテグレーションを使ってドキュメントをビルドし、GitHub Pages " +"github-pages/about-github-pages) は GitHub が提供する無料のウェブホスティングサービスです。 GitHub " +"Pages を使えば、ローカルあるいは継続的インテグレーションを使ってドキュメントをビルドし、GitHub Pages " "のウェブビルドを実行するように設定した GitHub リポジトリのブランチにプッシュすることができます。" #: ../../documentation/hosting-tools/publish-documentation-online.md:33 @@ -766,18 +848,17 @@ msgstr "Read the Docs vs GitHub Pages" #: ../../documentation/hosting-tools/publish-documentation-online.md:35 msgid "" -"GitHub pages is a great option for your documentation deployment. " -"However, you will need to do a bit more work to build and deploy your " -"documentation if you use GitHub pages." +"GitHub pages is a great option for your documentation deployment. However, " +"you will need to do a bit more work to build and deploy your documentation " +"if you use GitHub pages." msgstr "" "GitHub pages は、ドキュメントのデプロイに最適な選択肢です。 しかし、GitHub pages " "を使う場合はドキュメントのビルドやデプロイに少し手間がかかります。" #: ../../documentation/hosting-tools/publish-documentation-online.md:39 msgid "" -"Read the Docs can be setup in your Read the Docs user account. The " -"service automates the entire process of building and deploying your " -"documentation." +"Read the Docs can be setup in your Read the Docs user account. The service " +"automates the entire process of building and deploying your documentation." msgstr "" "Read the Docsは、Read the Docsのユーザーアカウントで設定できます。 " "このサービスは、ドキュメントの作成と配布の全プロセスを自動化します。" @@ -795,16 +876,16 @@ msgstr "Sphinxを使ってPythonパッケージのドキュメントを作る" #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:17 msgid "" "On this page we discuss using [Sphinx](https://www.sphinx-doc.org/) to " -"build your user-facing package documentation. While Sphinx is currently " -"the most commonly-used tool in the scientific Python ecosystem, you are " +"build your user-facing package documentation. While Sphinx is currently the" +" most commonly-used tool in the scientific Python ecosystem, you are " "welcome to explore other tools to build documentation such as " -"[mkdocs](https://www.mkdocs.org/) which is gaining popularity in the " -"Python packaging ecosystem." +"[mkdocs](https://www.mkdocs.org/) which is gaining popularity in the Python" +" packaging ecosystem." msgstr "" "このページでは、 [Sphinx](https://www.sphinx-doc.org/) " "を使ってユーザー向けのパッケージのドキュメントをビルドする方法について説明します。 " -"Sphinxは科学的なPythonのエコシステムで現在最もよく使われているツールですが、Pythonのパッケージングエコシステムで人気を集めている" -" [mkdocs](https://www.mkdocs.org/) のような、ドキュメントをビルドするための他のツールを調べることも歓迎します。" +"Sphinxは科学的なPythonのエコシステムで現在最もよく使われているツールですが、Pythonのパッケージングエコシステムで人気を集めている " +"[mkdocs](https://www.mkdocs.org/) のような、ドキュメントをビルドするための他のツールを調べることも歓迎します。" #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:25 msgid "Examples of documentation websites that we love:" @@ -834,8 +915,8 @@ msgstr "" #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:31 msgid "" -"[Here is our documentation if you want to see a myST example of a landing" -" page.](https://github.com/pyOpenSci/python-package-" +"[Here is our documentation if you want to see a myST example of a landing " +"page.](https://github.com/pyOpenSci/python-package-" "guide/blob/main/index.md)" msgstr "" "[ランディングページのmyST例をご覧になりたい方は、こちらのドキュメントをご覧ください](https://github.com/pyOpenSci" @@ -851,11 +932,10 @@ msgid "" "generator](https://www.cloudflare.com/learning/performance/static-site-" "generator/). A static site generator is a tool that creates html for a " "website based upon a set of templates. The html files are then served " -"\"Statically\" which means that there is no generation or modification of" -" the files on the fly." +"\"Statically\" which means that there is no generation or modification of " +"the files on the fly." msgstr "" -"Sphinxは " -"[スタティックサイトジェネレーター](https://www.cloudflare.com/learning/performance" +"Sphinxは [スタティックサイトジェネレーター](https://www.cloudflare.com/learning/performance" "/static-site-generator/) です。 " "静的サイトジェネレータとは、テンプレートのセットに基づいて、ウェブサイトのhtmlを作成するツールです。 " "htmlファイルは「静的」に提供されるため、その場でファイルを生成したり変更したりすることはありません。" @@ -870,8 +950,8 @@ msgstr "Sphinxサイトは拡張機能やテーマを使ってカスタマイズ #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:43 msgid "" -"The functionality of Sphinx can be extended using extensions and themes. " -"A few examples include:" +"The functionality of Sphinx can be extended using extensions and themes. A " +"few examples include:" msgstr "Sphinxの機能は、エクステンションやテーマを使って拡張することができます。 いくつかの例があります:" #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:46 @@ -901,9 +981,9 @@ msgstr "" #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:49 msgid "" -"While Sphinx natively supports the `rST` syntax, you can add custom " -"syntax parsers to support easier-to-write syntax using tools such as [the" -" MyST parser](https://myst-parser.readthedocs.io/)." +"While Sphinx natively supports the `rST` syntax, you can add custom syntax " +"parsers to support easier-to-write syntax using tools such as [the MyST " +"parser](https://myst-parser.readthedocs.io/)." msgstr "" "[MySTパーサー](https://myst-parser.readthedocs.io/) " "などのツールを使って、書きやすい構文をサポートするカスタム構文パーサーを追加できます。Sphinxはネイティブで `rST` " @@ -916,8 +996,7 @@ msgstr "よく使われるSphinxのテーマ" #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:53 msgid "" "You are free to use whatever Sphinx theme that you prefer. However, the " -"most common Sphinx themes used in the Python scientific community " -"include:" +"most common Sphinx themes used in the Python scientific community include:" msgstr "" "あなたは好きなSphinxテーマを自由に使うことができます。 " "しかし、Pythonの科学コミュニティで最もよく使われているSphinxのテーマは次のようなものです:" @@ -944,9 +1023,9 @@ msgstr "検索エンジン(および他のユーザー)に見つけてもらえ #: ../../documentation/hosting-tools/website-hosting-optimizing-your-docs.md:3 msgid "" -"If you are interested in more people finding your package, you may want " -"to add some core Sphinx extensions (and theme settings) that will help " -"search engines such as Google find your documentation." +"If you are interested in more people finding your package, you may want to " +"add some core Sphinx extensions (and theme settings) that will help search " +"engines such as Google find your documentation." msgstr "もし、より多くの人にあなたのパッケージを見つけてもらいたいのであれば、Sphinxのコアとなる拡張機能(およびテーマの設定)を追加することで、Googleなどの検索エンジンがあなたのドキュメントを見つけやすくすることができます。" #: ../../documentation/hosting-tools/website-hosting-optimizing-your-docs.md:7 @@ -957,27 +1036,24 @@ msgstr "Google アナリティクス" msgid "" "Google analytics [is not compliant with the European General Data " "Protection Regulation (GDPR)](https://matomo.org/blog/2022/05/google-" -"analytics-4-gdpr/). While there are many components to this regulation, " -"one of the core elements is that you have to let users know on your site " -"that you are collecting data and they have to consent. While it is " -"possible to add infrastructure around Google Analytics to make it close " -"to following GDPR regulations, the community is slowly shifting away from" -" Google using open tools such as [Plausible](https://plausible.io/), " -"[Cloudflare Web Analytics](https://www.cloudflare.com/web-analytics/) and" -" [Matomo](https://matomo.org) for web analytics." -msgstr "" -"Googleアナリティクスは " -"[欧州一般データ保護規則（GDPR）に準拠していません](https://matomo.org/blog/2022/05/google-" -"analytics-4-gdpr/) " +"analytics-4-gdpr/). While there are many components to this regulation, one" +" of the core elements is that you have to let users know on your site that " +"you are collecting data and they have to consent. While it is possible to " +"add infrastructure around Google Analytics to make it close to following " +"GDPR regulations, the community is slowly shifting away from Google using " +"open tools such as [Plausible](https://plausible.io/), [Cloudflare Web " +"Analytics](https://www.cloudflare.com/web-analytics/) and " +"[Matomo](https://matomo.org) for web analytics." +msgstr "" +"Googleアナリティクスは [欧州一般データ保護規則（GDPR）に準拠していません](https://matomo.org/blog/2022/05" +"/google-analytics-4-gdpr/) " "。この規制には多くの要素があるが、核となる要素のひとつは、データを収集していることをサイト上でユーザーに知らせ、同意を得なければならないということです。Googleアナリティクスの周辺にインフラを追加してGDPRの規制に沿うようにすることは可能ですが、コミュニティは徐々にGoogleから" " [Plausible](https://plausible.io/) 、 [Cloudflare Web " "Analytics](https://www.cloudflare.com/web-analytics/) 、 " "[Matomo](https://matomo.org) といったオープンツールをウェブ解析に使う方向にシフトしつつあります。" #: ../../documentation/hosting-tools/website-hosting-optimizing-your-docs.md:13 -msgid "" -"pyOpenSci is currently looking into free options for open source " -"developers." +msgid "pyOpenSci is currently looking into free options for open source developers." msgstr "pyOpenSci は現在、オープンソース開発者のための無料のオプションを検討しています。" #: ../../documentation/hosting-tools/website-hosting-optimizing-your-docs.md:16 @@ -987,32 +1063,29 @@ msgid "" "sphinx-theme.readthedocs.io/en/latest/user_guide/analytics.html#google-" "analytics). However, if the theme that you chose does not offer Google " "Analytics support, you can use the [`sphinxcontrib-gtagjs` " -"extension](https://github.com/attakei/sphinxcontrib-gtagjs). This " -"extension will add a Google Analytics site tag to each page of your " -"documentation." +"extension](https://github.com/attakei/sphinxcontrib-gtagjs). This extension" +" will add a Google Analytics site tag to each page of your documentation." msgstr "" "[`pydata-sphinx-theme`や `sphinx-book-theme` のようなsphinxテーマには、Google " "Analyticsのサポートが組み込まれています](https://pydata-sphinx-" -"theme.readthedocs.io/en/latest/user_guide/analytics.html#google-" -"analytics) 。しかし、もしあなたが選んだテーマがGoogle Analyticsをサポートしていない場合は、 " -"[sphinxcontrib-gtagjs` extension](https://github.com/attakei" -"/sphinxcontrib-gtagjs) を使うことができます。 このエクステンションは、Google " -"Analyticsのサイトタグをドキュメントの各ページに追加します。" +"theme.readthedocs.io/en/latest/user_guide/analytics.html#google-analytics) " +"。しかし、もしあなたが選んだテーマがGoogle Analyticsをサポートしていない場合は、 [sphinxcontrib-gtagjs` " +"extension](https://github.com/attakei/sphinxcontrib-gtagjs) を使うことができます。 " +"このエクステンションは、Google Analyticsのサイトタグをドキュメントの各ページに追加します。" #: ../../documentation/hosting-tools/website-hosting-optimizing-your-docs.md:22 msgid "" "[sphinx-sitemap](https://sphinx-" -"sitemap.readthedocs.io/en/latest/index.html) for search engine " -"optimization" +"sitemap.readthedocs.io/en/latest/index.html) for search engine optimization" msgstr "" "検索エンジン最適化のための [sphinx-sitemap](https://sphinx-" "sitemap.readthedocs.io/en/latest/index.html)" #: ../../documentation/hosting-tools/website-hosting-optimizing-your-docs.md:24 msgid "" -"While we are trying to move away from Google Analytics do to compliance " -"and privacy issues, search engine optimization is still important. Google" -" is the most popular search engine. And if your documentation is search " +"While we are trying to move away from Google Analytics do to compliance and" +" privacy issues, search engine optimization is still important. Google is " +"the most popular search engine. And if your documentation is search " "optimized, users are more likely to find your package!" msgstr "" "コンプライアンスやプライバシーの問題からGoogleアナリティクスから離れようとしていますが、検索エンジン最適化は依然として重要です。 " @@ -1021,8 +1094,8 @@ msgstr "" #: ../../documentation/hosting-tools/website-hosting-optimizing-your-docs.md:30 msgid "" -"If you are interested in optimizing your documentation for search engines" -" such as Google, you want a **sitemap.xml** file. You can submit this " +"If you are interested in optimizing your documentation for search engines " +"such as Google, you want a **sitemap.xml** file. You can submit this " "sitemap to Google and it will index your entire site. This over time can " "make the content on your site more visible to others when they search." msgstr "" @@ -1036,8 +1109,8 @@ msgstr "このエクステンションは軽量です。" #: ../../documentation/hosting-tools/website-hosting-optimizing-your-docs.md:38 msgid "" -"It [requires that you to add it to your Sphinx `conf.py` extension list " -"and site your documentation base url](https://sphinx-" +"It [requires that you to add it to your Sphinx `conf.py` extension list and" +" site your documentation base url](https://sphinx-" "sitemap.readthedocs.io/en/latest/getting-started.html)." msgstr "" "これは、 [Sphinxの `conf.py` 拡張機能リストに追加し、ドキュメントのベースURLを指定する必要があります](https" @@ -1051,13 +1124,12 @@ msgstr "[sphinxext.opengraph](https://github.com/sphinx-doc/sphinxext-opengraph) #, fuzzy msgid "" "OpenGraph is an extension that allows you to add metadata to your " -"documentation content pages. [The OpenGraph protocol allows other " -"websites to provide a useful preview of the content on your page when " -"shared](https://www.freecodecamp.org/news/what-is-open-graph-and-how-" -"can-i-use-it-for-my-website/#heading-what-is-open-graph). This is " -"important for when the pages in your documentation are shared on social " -"media and even for shares on collaboration platforms like Slack and " -"Discourse." +"documentation content pages. [The OpenGraph protocol allows other websites " +"to provide a useful preview of the content on your page when " +"shared](https://www.freecodecamp.org/news/what-is-open-graph-and-how-can-i" +"-use-it-for-my-website/#heading-what-is-open-graph). This is important for " +"when the pages in your documentation are shared on social media and even " +"for shares on collaboration platforms like Slack and Discourse." msgstr "" "OpenGraphは、ドキュメントのコンテンツページにメタデータを追加できる拡張機能です。 " "[OpenGraphプロトコルは、共有されたときに他のウェブサイトがあなたのページのコンテンツの有用なプレビューを提供することを可能にします](https://www.freecodecamp.org/news" @@ -1150,11 +1222,10 @@ msgstr "オープンソースPythonパッケージのドキュメント" msgid "" "Please note that the tools discussed here are those that we see commonly " "used in the community. As tools evolve we will update this guide. If you " -"are submitting a package for pyOpenSci peer review and use other tools " -"that are not listed in our guide to build your package you can still " -"submit for review! The tools listed here are suggestions, not " -"requirements. Our requirements are focused on the documentation content " -"of your package." +"are submitting a package for pyOpenSci peer review and use other tools that" +" are not listed in our guide to build your package you can still submit for" +" review! The tools listed here are suggestions, not requirements. Our " +"requirements are focused on the documentation content of your package." msgstr "" "ここで取り上げているツールは、コミュニティで一般的に使用されているものです。 ツールの進化に伴い、このガイドを更新します。 " "pyOpenSci査読のためにパッケージを提出し、パッケージを構築するためにガイドに記載されていない他のツールを使用する場合でも、査読のために提出することができます！" @@ -1172,17 +1243,17 @@ msgstr "ドキュメンテーションは、あなたのPythonオープンソー #: ../../documentation/index.md:70 msgid "" -"Quality code is of course valuable as its how your package gets the tasks" -" done. However, if users don't understand how to use your package in " -"their workflows, then they won't use it." +"Quality code is of course valuable as its how your package gets the tasks " +"done. However, if users don't understand how to use your package in their " +"workflows, then they won't use it." msgstr "" "もちろん、パッケージがどのようにタスクを遂行するかという点で、質の高いコードは価値があります。 " "しかし、もしユーザーがワークフローであなたのパッケージの使い方を理解していなければ、使ってもらえないでしょう。" #: ../../documentation/index.md:73 msgid "" -"Further, explicitly documenting how to contribute is important if you " -"wish to build a base of contributors to your package." +"Further, explicitly documenting how to contribute is important if you wish " +"to build a base of contributors to your package." msgstr "さらに、どのように貢献するかを明確に文書化することは、あなたのパッケージへの貢献者の基盤を築きたいのであれば重要です。" #: ../../documentation/index.md:76 @@ -1191,8 +1262,8 @@ msgstr "Pythonパッケージユーザーの2つのタイプ" #: ../../documentation/index.md:78 msgid "" -"The documentation that you write for your package should target two types" -" of users:" +"The documentation that you write for your package should target two types " +"of users:" msgstr "パッケージのために書くドキュメントは、2つのタイプのユーザーをターゲットにすべきです:" #: ../../documentation/index.md:81 @@ -1202,8 +1273,8 @@ msgstr "1. 基本ツールユーザー" #: ../../documentation/index.md:83 msgid "" "Basic tool users are the people who will use your package code in their " -"Python workflows. They might be new(er) to Python and/or data science. Or" -" expert programmers. But they might not have a background in software " +"Python workflows. They might be new(er) to Python and/or data science. Or " +"expert programmers. But they might not have a background in software " "development. These users need to know:" msgstr "" "基本ツールユーザーは、あなたのパッケージコードを Python ワークフローで使用する人たちです。 " @@ -1224,14 +1295,14 @@ msgstr "コードベースの使い始め方" #: ../../documentation/index.md:91 msgid "" -"Information on how to cite your code / give you credit if they are using " -"it in a research application." +"Information on how to cite your code / give you credit if they are using it" +" in a research application." msgstr "研究用アプリケーションでコードを使用する場合、あなたのコードをどのように引用し、クレジットを付与するかについての情報。" #: ../../documentation/index.md:93 msgid "" -"Information on the license that your code uses so they know how they can " -"or can't use the code in an operational setting." +"Information on the license that your code uses so they know how they can or" +" can't use the code in an operational setting." msgstr "あなたのコードが使用するライセンスに関する情報を提供することで、運用環境においてコードをどのように使用できるか、または使用できないかを知ってもらいます。" #: ../../documentation/index.md:96 @@ -1262,17 +1333,17 @@ msgstr "また、ドキュメントのスペルミスやチュートリアルの #: ../../documentation/index.md:106 msgid "" -"These users need all of the things that a basic user needs. But, they " -"also need to understand how you'd like for them to contribute to your " -"package. These potential contributors need:" +"These users need all of the things that a basic user needs. But, they also " +"need to understand how you'd like for them to contribute to your package. " +"These potential contributors need:" msgstr "" "これらのユーザーは、基本的なユーザーが必要とするすべてのものを必要としています。 " "しかし、彼らがあなたのパッケージにどのように貢献してほしいかを理解する必要もあります。 このような貢献者候補には、次のようなものが必要です:" #: ../../documentation/index.md:110 msgid "" -"A development guide to help them understand the infrastructure used in " -"your package repository." +"A development guide to help them understand the infrastructure used in your" +" package repository." msgstr "パッケージリポジトリで使われているインフラを理解するための開発ガイドです。" #: ../../documentation/index.md:111 @@ -1284,10 +1355,9 @@ msgstr "どのような貢献の投稿を歓迎し、どのように貢献をし #: ../../documentation/index.md:114 msgid "" "It's important to remember that the definition of what a contribution is " -"can be broad. A contribution could be something as simple as a bug " -"report. Or fixing a spelling issue in your documentation. Or it could be " -"a code fix that includes a new test that covers an edge-case that they " -"discovered." +"can be broad. A contribution could be something as simple as a bug report. " +"Or fixing a spelling issue in your documentation. Or it could be a code fix" +" that includes a new test that covers an edge-case that they discovered." msgstr "重要なのは、貢献の定義は幅広いということを覚えておくことです。貢献とは、バグ報告のような単純なものでもよいのです。あるいは、ドキュメントのスペルの問題を修正する。あるいは、彼らが発見したエッジケースをカバーする新しいテストを含むコード修正かもしれません。" #: ../../documentation/index.md:120 @@ -1298,15 +1368,15 @@ msgstr "pyOpenSciがPythonパッケージをレビューする際に注目する msgid "" "In the pyOpenSci open peer review, we look for a documentation structure " "that supports both your tool users and potential contributors. The files " -"and elements that we look for specifically can be found in our peer " -"review check list (see link below)." +"and elements that we look for specifically can be found in our peer review " +"check list (see link below)." msgstr "pyOpenSciオープンピアレビューでは、あなたのツールのユーザーと潜在的な貢献者の両方をサポートする文書構造を探します。私たちが特にチェックするファイルや要素は、査読チェックリスト（下記リンク参照）に記載されています。" #: ../../documentation/index.md:127 msgid "" "In this guide, we discuss each required element, and also discuss other " -"elements that you should consider in your package's documentation in more" -" detail." +"elements that you should consider in your package's documentation in more " +"detail." msgstr "このガイドでは、各必須要素について説明し、パッケージの文書で考慮すべきその他の要素についても詳しく説明します。" #: ../../documentation/index.md:131 @@ -1315,8 +1385,8 @@ msgstr "pyOpenSci査読チェックリストを見る" #: ../../documentation/index.md:138 msgid "" -"Image showing the files in the the MovingPandas GitHub repository. Files " -"in the image include code of conduct.md contributing.md license.txt and " +"Image showing the files in the the MovingPandas GitHub repository. Files in" +" the image include code of conduct.md contributing.md license.txt and " "readme.md." msgstr "" "MovingPandasのGitHubリポジトリにあるファイルを示す画像。画像内のファイルには、code of conduct.md " @@ -1325,8 +1395,8 @@ msgstr "" #: ../../documentation/index.md:144 msgid "" "An example from the MovingPandas GitHub repository with all of the major " -"files in it including CONTRIBUTING.md, README.md, CODE_OF_CONDUCT.md and " -"a LICENSE.txt file. *(screen shot taken Nov 23 2022)*" +"files in it including CONTRIBUTING.md, README.md, CODE_OF_CONDUCT.md and a " +"LICENSE.txt file. *(screen shot taken Nov 23 2022)*" msgstr "" "MovingPandasのGitHubリポジトリから、CONTRIBUTING.md、README.md、CODE_OF_CONDUCT.md、LICENSE.txtを含む主要なファイルを抜粋。" " *( スクリーンショットは2022年11月23日撮影 )* 。" @@ -1351,10 +1421,10 @@ msgstr "Todo" #: ../../documentation/index.md:156 msgid "" -"Python version support You should always be explicit about which versions" -" of Python your package supports. Keeping compatibility with old Python " -"versions can be difficult as functionality changes. A good rule of thumb " -"is that the package should support, at least, the latest three Python " +"Python version support You should always be explicit about which versions " +"of Python your package supports. Keeping compatibility with old Python " +"versions can be difficult as functionality changes. A good rule of thumb is" +" that the package should support, at least, the latest three Python " "versions (e.g., 3.8, 3.7, 3.6)." msgstr "" "Pythonのバージョンサポート あなたのパッケージがどのバージョンのPythonをサポートしているか、常に明示しておくべきです。 " @@ -1374,8 +1444,8 @@ msgid "" "The `CHANGELOG.md` document serves as a valuable resource for developers " "and users alike to track the evolution of a project over time. " "Understanding the structure and purpose of a changelog helps users and " -"contributors stay informed about new features, bug fixes, and other " -"changes introduced in each release." +"contributors stay informed about new features, bug fixes, and other changes" +" introduced in each release." msgstr "" "`CHANGELOG.md` ドキュメントは、開発者にとってもユーザーにとっても、プロジェクトの進化を追跡するための貴重なリソースとなります。 " "変更履歴の構造と目的を理解することで、ユーザーや貢献者は各リリースで導入された新機能やバグ修正、その他の変更について常に情報を得ることができます。" @@ -1388,8 +1458,8 @@ msgstr "CHANGELOG.mdとは？" msgid "" "The primary purpose of `CHANGELOG.md` is to provide a record of notable " "changes made to the project with each new release. This document helps " -"users understand what has been added, fixed, modified, or removed with " -"each version of the software." +"users understand what has been added, fixed, modified, or removed with each" +" version of the software." msgstr "" "`CHANGELOG.md` の主な目的は、新しいリリースごとにプロジェクトに加えられた注目すべき変更の記録を提供することです。 " "このドキュメントは、ソフトウェアの各バージョンで何が追加、修正、変更、削除されたかをユーザーが理解するのに役立ちます。" @@ -1397,9 +1467,9 @@ msgstr "" #: ../../documentation/repository-files/changelog-file.md:11 #, fuzzy msgid "" -"[Keep a Changelog](https://keepachangelog.com/en/1.1.0/) is a great, " -"simple resource for understanding what a changelog is and how to create a" -" good changelog. It also includes examples of things to avoid." +"[Keep a Changelog](https://keepachangelog.com/en/1.1.0/) is a great, simple" +" resource for understanding what a changelog is and how to create a good " +"changelog. It also includes examples of things to avoid." msgstr "" "[Keep a " "CHAGELOG.md](https://keepachangelog.com/en/1.1.0/)は、変更ログとは何か、どのように良い変更ログを作成するかを理解するための、シンプルで素晴らしいリソースです。" @@ -1411,17 +1481,17 @@ msgstr "Pythonパッケージのバージョン管理とセマンティックバ #: ../../documentation/repository-files/changelog-file.md:16 msgid "" -"An important component of a package that serves as the backbone behind " -"the changelog file is a good versioning scheme. Semantic Versioning is " -"widely used across Python packages." +"An important component of a package that serves as the backbone behind the " +"changelog file is a good versioning scheme. Semantic Versioning is widely " +"used across Python packages." msgstr "" "変更履歴ファイルのバックボーンとなるパッケージの重要なコンポーネントは、優れたバージョン管理スキームです。 セマンティック・バージョニングは " "Python パッケージ全体で広く使われています。" #: ../../documentation/repository-files/changelog-file.md:17 msgid "" -"[Creating New Versions of Your Python Package](../../package-structure-" -"code/python-package-versions.md)" +"[Creating New Versions of Your Python Package](../../package-structure-code" +"/python-package-versions.md)" msgstr "" "[Python パッケージの新しいバージョンの作成](../../package-structure-code/python-package-" "versions.md)" @@ -1436,11 +1506,11 @@ msgstr "なぜそれが重要なのか？" #: ../../documentation/repository-files/changelog-file.md:23 msgid "" -"A well-maintained changelog is essential for transparent communication " -"with users and developers. It serves as a centralized hub for documenting" -" changes and highlights the progress made in each release. By keeping the" -" changelog up-to-date, project maintainers can build trust with their " -"user base and demonstrate their commitment to improving the software." +"A well-maintained changelog is essential for transparent communication with" +" users and developers. It serves as a centralized hub for documenting " +"changes and highlights the progress made in each release. By keeping the " +"changelog up-to-date, project maintainers can build trust with their user " +"base and demonstrate their commitment to improving the software." msgstr "" "ユーザーや開発者との透明性のあるコミュニケーションには、よく管理された変更履歴が不可欠です。 " "変更ログは、変更点を文書化し、各リリースでの進捗をハイライトするための一元的なハブとして機能します。 " @@ -1453,10 +1523,10 @@ msgstr "その内容は？" #: ../../documentation/repository-files/changelog-file.md:27 #, fuzzy msgid "" -"The contents of a `CHANGELOG.md` file typically follow a structured " -"format, detailing the changes introduced in each release. While the exact" -" format may vary depending on the project's conventions, some common " -"elements found in changelogs for Python packages include:" +"The contents of a `CHANGELOG.md` file typically follow a structured format," +" detailing the changes introduced in each release. While the exact format " +"may vary depending on the project's conventions, some common elements found" +" in changelogs for Python packages include:" msgstr "" "changelog.md ファイルの内容は一般的に構造化されたフォーマットに従い、各リリースで導入された変更の詳細を記述します。 " "正確なフォーマットはプロジェクトの規約によって異なるかもしれませんが、 Python パッケージの changelog " @@ -1464,8 +1534,8 @@ msgstr "" #: ../../documentation/repository-files/changelog-file.md:29 msgid "" -"**Versioning**: Clear identification of each release version using " -"semantic versioning or another versioning scheme adopted by the project." +"**Versioning**: Clear identification of each release version using semantic" +" versioning or another versioning scheme adopted by the project." msgstr "" "**Versioning**： " "セマンティックバージョニング、またはプロジェクトが採用するその他のバージョニングスキームを使って、各リリースのバージョンを明確に識別すること。" @@ -1479,8 +1549,8 @@ msgstr "**Release Date**: 各バージョンが公開された日付で、変更 #: ../../documentation/repository-files/changelog-file.md:33 msgid "" "**Change Categories**: Organizing changes into categories such as " -"\"Added,\" \"Changed,\" \"Fixed,\" and \"Removed\" to facilitate " -"navigation and understanding." +"\"Added,\" \"Changed,\" \"Fixed,\" and \"Removed\" to facilitate navigation" +" and understanding." msgstr "" "**変更カテゴリー**: 変更を \"Added,\" \"Changed,\" \"Fixed,\" \"Removed\" " "などのカテゴリーに整理し、ナビゲーションと理解を容易にします。" @@ -1494,9 +1564,9 @@ msgstr "**変更の内容**: 新機能、機能強化、バグフィックス、 #: ../../documentation/repository-files/changelog-file.md:37 msgid "" -"**Links to Issues or Pull Requests**: References to relevant issue " -"tracker items or pull requests associated with each change, enabling " -"users to access more detailed information if needed." +"**Links to Issues or Pull Requests**: References to relevant issue tracker " +"items or pull requests associated with each change, enabling users to " +"access more detailed information if needed." msgstr "" "**課題またはプルリクエストへのリンク**: " "各変更に関連する課題追跡項目またはプルリクエストへの参照で、ユーザーは必要に応じてより詳細な情報にアクセスできます。" @@ -1504,8 +1574,8 @@ msgstr "" #: ../../documentation/repository-files/changelog-file.md:39 msgid "" "**Upgrade Instructions**: Guidance for users on how to upgrade to the " -"latest version, including any breaking changes or migration steps they " -"need to be aware of." +"latest version, including any breaking changes or migration steps they need" +" to be aware of." msgstr "**アップグレード手順**: 最新バージョンへのアップグレード方法に関するガイダンス、注意すべき変更点や移行手順を含みます。" #: ../../documentation/repository-files/changelog-file.md:41 @@ -1546,14 +1616,14 @@ msgstr "リリースセクション" #: ../../documentation/repository-files/changelog-file.md:61 msgid "" -"When you are ready to make a new release, you can move the elements into " -"a section that is specific to that new release number." +"When you are ready to make a new release, you can move the elements into a " +"section that is specific to that new release number." msgstr "新しいリリースを作る準備ができたら、要素をその新しいリリース番号専用のセクションに移動させることができます。" #: ../../documentation/repository-files/changelog-file.md:63 msgid "" -"This specific release section will sit below the unreleased section and " -"can include any updates, additions, deprecations and contributors." +"This specific release section will sit below the unreleased section and can" +" include any updates, additions, deprecations and contributors." msgstr "この特定のリリースセクションは、未リリースセクションの下に位置し、更新、追加、非推奨、貢献者を含むことができます。" #: ../../documentation/repository-files/changelog-file.md:65 @@ -1602,10 +1672,10 @@ msgstr "[fatiandoのCODE_OF_CONDUCT.mdファイル](https://github.com/fatiando/ #: ../../documentation/repository-files/code-of-conduct-file.md:12 msgid "" "Your package should have a `CODE_OF_CONDUCT.md` file located the root of " -"the repository. Once you have people using your package, you can consider" -" the package itself as having a community around it. Some of this " -"community uses your tool. These users may have questions or encounter " -"challenges using your package." +"the repository. Once you have people using your package, you can consider " +"the package itself as having a community around it. Some of this community " +"uses your tool. These users may have questions or encounter challenges " +"using your package." msgstr "" "あなたのパッケージには、リポジトリのルートに `CODE_OF_CONDUCT.md` ファイルがあるはずです。 " "あなたのパッケージを使っている人がいれば、そのパッケージ自体にコミュニティがあると考えることができます。 " @@ -1614,8 +1684,8 @@ msgstr "" #: ../../documentation/repository-files/code-of-conduct-file.md:18 msgid "" -"Others in the community might want to contribute to your tool. They might" -" fix bugs, update documentation and engage with the maintainer team." +"Others in the community might want to contribute to your tool. They might " +"fix bugs, update documentation and engage with the maintainer team." msgstr "" "コミュニティの他の人たちも、あなたのツールに貢献したいと思うかもしれません。 " "バグを修正したり、ドキュメントを更新したり、メンテナチームと関わりを持ったりするかもしれません。" @@ -1627,12 +1697,11 @@ msgstr "CODE_OF_CONDUCTが必要な理由" #: ../../documentation/repository-files/code-of-conduct-file.md:24 msgid "" "In order to keep this community healthy and to protect yourself, your " -"maintainer team and your users from unhealthy behavior, it is important " -"to have a [`CODE_OF_CONDUCT`](https://opensource.guide/code-of-conduct/)." +"maintainer team and your users from unhealthy behavior, it is important to " +"have a [`CODE_OF_CONDUCT`](https://opensource.guide/code-of-conduct/)." msgstr "" "このコミュニティを健全に保ち、あなた自身、あなたのメンテナチーム、そしてユーザーを不健全な行動から守るためには、 " -"[`CODE_OF_CONDUCT`](https://opensource.guide/code-of-conduct/) " -"を持つことが重要です。" +"[`CODE_OF_CONDUCT`](https://opensource.guide/code-of-conduct/) を持つことが重要です。" #: ../../documentation/repository-files/code-of-conduct-file.md:28 msgid "" @@ -1648,21 +1717,21 @@ msgstr "" #: ../../documentation/repository-files/code-of-conduct-file.md:34 msgid "" -"If you are not comfortable with creating your own `CODE_OF_CONDUCT` text," -" we encourage you to adopt the `CODE_OF_CONDUCT` language used in the " +"If you are not comfortable with creating your own `CODE_OF_CONDUCT` text, " +"we encourage you to adopt the `CODE_OF_CONDUCT` language used in the " "[Contributor Covenant](https://www.contributor-" "covenant.org/version/2/1/code_of_conduct/). [Many other " -"communities](https://www.contributor-covenant.org/adopters/) have adopted" -" this `CODE_OF_CONDUCT` as their own. See the [Fatiando a Terra " -"Geoscience Python community's example " +"communities](https://www.contributor-covenant.org/adopters/) have adopted " +"this `CODE_OF_CONDUCT` as their own. See the [Fatiando a Terra Geoscience " +"Python community's example " "here.](https://github.com/fatiando/community/blob/main/CODE_OF_CONDUCT.md)" msgstr "" "あなた自身の `CODE_OF_CONDUCT` の文章を作成することに抵抗がある場合、 [Contributor " "Covenant](https://www.contributor-" "covenant.org/version/2/1/code_of_conduct/) で使用されている `CODE_OF_CONDUCT` " "の文言を採用することをお勧めします。 [他の多くのコミュニティ](https://www.contributor-" -"covenant.org/adopters/) はこの `CODE_OF_CONDUCT` を自分たちのものとして採用しています。 " -"[Fatiando Terra Geoscience " +"covenant.org/adopters/) はこの `CODE_OF_CONDUCT` を自分たちのものとして採用しています。 [Fatiando" +" Terra Geoscience " "Pythonコミュニティの例はこちら](https://github.com/fatiando/community/blob/main/CODE_OF_CONDUCT.md)" " を参照してください。" @@ -1674,12 +1743,11 @@ msgstr "あなたのPythonパッケージのCONTRIBUTINGファイル" msgid "" "The **CONTRIBUTING.md** is the landing page guide for your project's " "contributors. It outlines how contributors can get involved, the " -"contribution types that you welcome, and how contributors should interact" -" or engage with you and your maintainer team. The contributor guide " -"should also link to get-started resources that overview how to set up " -"development environments, what type of workflow you expect on " -"GitHub/GitLab, and anything else that contributors might need to get " -"started." +"contribution types that you welcome, and how contributors should interact " +"or engage with you and your maintainer team. The contributor guide should " +"also link to get-started resources that overview how to set up development " +"environments, what type of workflow you expect on GitHub/GitLab, and " +"anything else that contributors might need to get started." msgstr "" "**CONTRIBUTING.md** " "は、あなたのプロジェクトの貢献者のためのランディングページガイドです。貢献者の参加方法、歓迎する貢献の種類、貢献者があなたやメンテナチームとどのように関わり合うべきかについて概説しています。コントリビューターガイドは、開発環境のセットアップ方法や、GitHub/GitLabでどのようなワークフローを想定しているかなど、コントリビューターが始めるために必要なことをまとめたスタートアップリソースにもリンクしておくべきです。" @@ -1688,10 +1756,10 @@ msgstr "" msgid "" "This file benefits maintainers and contributors. For contributors, it " "provides a roadmap that helps them get started and makes their first " -"contribution easier. For maintainers, it answers commonly asked questions" -" and reduces the burden of explaining your process to every person who " -"wants to contribute. This document creates a more collaborative and " -"efficient development process for everyone." +"contribution easier. For maintainers, it answers commonly asked questions " +"and reduces the burden of explaining your process to every person who wants" +" to contribute. This document creates a more collaborative and efficient " +"development process for everyone." msgstr "" "このファイルは、メンテナと貢献者に利益をもたらします。コントリビューターにとっては、最初のコントリビューションを容易にするためのロードマップとなります。" " " @@ -1709,14 +1777,14 @@ msgstr "コントリビュートファイルは、ロードマップを提供す #: ../../documentation/repository-files/contributing-file.md:12 msgid "" -"**For Contributors**: It provides clear instructions on contributing, " -"from reporting issues to submitting pull requests." +"**For Contributors**: It provides clear instructions on contributing, from " +"reporting issues to submitting pull requests." msgstr "**貢献者向け**: 問題の報告からプルリクエストの提出まで、貢献に関する明確な指示を提供します。" #: ../../documentation/repository-files/contributing-file.md:13 msgid "" -"**For Maintainers**: It streamlines contributions by setting expectations" -" and standardizing processes, reducing the time spent clarifying common " +"**For Maintainers**: It streamlines contributions by setting expectations " +"and standardizing processes, reducing the time spent clarifying common " "questions or handling incomplete issues or pull requests." msgstr "" "**メンテナ向け**: " @@ -1724,9 +1792,9 @@ msgstr "" #: ../../documentation/repository-files/contributing-file.md:15 msgid "" -"Including a well-written CONTRIBUTING.md file in your project is one way " -"of making it more welcoming and open to new and seasoned contributors. It" -" also helps create a smoother workflow for everyone involved." +"Including a well-written CONTRIBUTING.md file in your project is one way of" +" making it more welcoming and open to new and seasoned contributors. It " +"also helps create a smoother workflow for everyone involved." msgstr "" "よく書かれた CONTRIBUTING.md " "ファイルをプロジェクトに含めることは、新しい貢献者やベテランの貢献者をより歓迎し、オープンにする方法の1つです。また、関係者全員にとって、よりスムーズなワークフローを構築するのにも役立ちます。" @@ -1743,14 +1811,14 @@ msgstr "歓迎されるガイドにします。あらゆる経験レベルの貢 #: ../../documentation/repository-files/contributing-file.md:21 msgid "" -"Avoid technical jargon or explain terms when necessary (for example, " -"\"fork the repository\")." +"Avoid technical jargon or explain terms when necessary (for example, \"fork" +" the repository\")." msgstr "専門用語は避け、必要な場合は用語を説明します (例えば \"リポジトリをフォークする\" など) 。" #: ../../documentation/repository-files/contributing-file.md:22 msgid "" -"Include a friendly introduction, such as \"Thank you for your interest in" -" contributing! We're excited to collaborate with you.\"" +"Include a friendly introduction, such as \"Thank you for your interest in " +"contributing! We're excited to collaborate with you.\"" msgstr "\"ご協力ありがとうございます！ あなたとのコラボレーションを楽しみにしています。\" のような友好的な自己紹介を入れます。" #: ../../documentation/repository-files/contributing-file.md:23 @@ -1798,18 +1866,17 @@ msgstr "歓迎する貢献の種類" #: ../../documentation/repository-files/contributing-file.md:41 msgid "" -"Example: We welcome contributions of all kinds. If you want to address an" -" existing issue, check out our issues in this repository and comment on " -"the one that you'd like to help with. Otherwise, you can open a new " -"issue..." +"Example: We welcome contributions of all kinds. If you want to address an " +"existing issue, check out our issues in this repository and comment on the " +"one that you'd like to help with. Otherwise, you can open a new issue..." msgstr "" "例: あらゆる種類の貢献を歓迎します。 " "既存の問題に取り組みたい場合は、このリポジトリにある私たちの問題をチェックし、手伝いたい問題にコメントしてください。そうでない場合は、新しいissueを開くことができます..." #: ../../documentation/repository-files/contributing-file.md:43 msgid "" -"How you'd like contributions to happen. Clearly outline your contribution" -" process. For example:" +"How you'd like contributions to happen. Clearly outline your contribution " +"process. For example:" msgstr "どのように貢献してほしいか。貢献のプロセスを明確に示します。 例えば:" #: ../../documentation/repository-files/contributing-file.md:44 @@ -1841,30 +1908,29 @@ msgstr "課題、プルリクエスト、質問を提出するユーザーに対 #: ../../documentation/repository-files/contributing-file.md:51 msgid "" "If you have a [development guide](development-guide), link to it. This " -"guide should provide clear instructions on how to set up your development" -" environment locally. It also should overview CI tools that you have that" -" could simplify the contribution process (for example, pre-[commit.ci " -"bot](https://www.pyopensci.org/python-package-guide/package-structure-" -"code/code-style-linting-format.html#pre-commit-ci), and so on), [linters," -" code formatters](https://www.pyopensci.org/python-package-guide/package-" -"structure-code/code-style-linting-format.html#code-linting-formatting-" -"and-styling-tools), and so on." +"guide should provide clear instructions on how to set up your development " +"environment locally. It also should overview CI tools that you have that " +"could simplify the contribution process (for example, pre-[commit.ci " +"bot](https://www.pyopensci.org/python-package-guide/package-structure-code" +"/code-style-linting-format.html#pre-commit-ci), and so on), [linters, code " +"formatters](https://www.pyopensci.org/python-package-guide/package-" +"structure-code/code-style-linting-format.html#code-linting-formatting-and-" +"styling-tools), and so on." msgstr "" "[development guide](development-guide) を持っているなら、リンクしてください。 " "このガイドでは、開発環境をローカルにセットアップする方法をわかりやすく説明します。また、貢献のプロセスを簡素化できるようなCIツールについても概説する必要があります" " (例えば [commit.ci bot](https://www.pyopensci.org/python-package-guide" -"/package-structure-code/code-style-linting-format.html#pre-commit-ci) " -"など), [linters, code formatters](https://www.pyopensci.org/python-package-" -"guide/package-structure-code/code-style-linting-format.html#code-linting-" +"/package-structure-code/code-style-linting-format.html#pre-commit-ci) など), " +"[linters, code formatters](https://www.pyopensci.org/python-package-guide" +"/package-structure-code/code-style-linting-format.html#code-linting-" "formatting-and-styling-tools), など。" #: ../../documentation/repository-files/contributing-file.md:53 #, fuzzy msgid "" -"This guide should also include information for someone interested in " -"asking questions. Some projects accept questions as GitHub or GitLab " -"issues. Others use GitHub Discussions, Discourse, or even a Discord " -"server." +"This guide should also include information for someone interested in asking" +" questions. Some projects accept questions as GitHub or GitLab issues. " +"Others use GitHub Discussions, Discourse, or even a Discord server." msgstr "" "このガイドには、質問することに興味がある人のための情報も含まれているはずです。 " "GitHubやGitLabのissueとして質問を受け付けるプロジェクトもあります。また、GitHubディスカッションやDiscourse、あるいはDiscordサーバーを使う人もいます。" @@ -1892,9 +1958,9 @@ msgstr "概要" #: ../../documentation/repository-files/contributing-file.md:64 msgid "" "A well-crafted CONTRIBUTING.md file is welcome mat for your project! By " -"providing clear instructions, helpful resources, and a welcoming tone, " -"you make it easier for contributors to get involved and build a stronger," -" more collaborative community around your project." +"providing clear instructions, helpful resources, and a welcoming tone, you " +"make it easier for contributors to get involved and build a stronger, more " +"collaborative community around your project." msgstr "よく練られたCONTRIBUTING.mdファイルは、あなたのプロジェクトのウェルカムマットです！明確な指示、有用なリソース、歓迎ムードを提供することで、貢献者がプロジェクトに参加しやすくなり、より強力で協力的なコミュニティが構築されます。" #: ../../documentation/repository-files/development-guide.md:2 @@ -1903,10 +1969,10 @@ msgstr "Pythonパッケージの開発ガイドに含めるべき内容" #: ../../documentation/repository-files/development-guide.md:4 msgid "" -"Ideally, your package should also have a development guide. This file may" -" live in your package documentation and should be linked to from your " -"CONTRIBUTING.md file (discussed above). A development guide should " -"clearly show technically proficient users how to:" +"Ideally, your package should also have a development guide. This file may " +"live in your package documentation and should be linked to from your " +"CONTRIBUTING.md file (discussed above). A development guide should clearly " +"show technically proficient users how to:" msgstr "" "理想的には、あなたのパッケージは開発ガイドを持つべきです。 このファイルはあなたのパッケージのドキュメントにあり、 " "CONTRIBUTING.mdファイル(前述)からリンクされるべきです。 " @@ -1930,15 +1996,15 @@ msgstr "開発ガイドには、次のようなガイドラインもあるはず #: ../../documentation/repository-files/development-guide.md:14 msgid "" -"code standards including docstring style, code format and any specific " -"code approaches that the package follows." +"code standards including docstring style, code format and any specific code" +" approaches that the package follows." msgstr "docstringスタイルを含むコード標準、コードフォーマットと、パッケージが従う特定のコードアプローチ。" #: ../../documentation/repository-files/development-guide.md:16 msgid "" "It's also helpful to specify the types of tests you request if a " -"contributor submits a new feature or a change to an existing feature that" -" will not be covered by your existing test suite." +"contributor submits a new feature or a change to an existing feature that " +"will not be covered by your existing test suite." msgstr "また、既存のテストスイートではカバーできないような新機能や既存機能の変更をコントリビューターが提出する場合、要求するテストの種類を指定しておくと便利です。" #: ../../documentation/repository-files/development-guide.md:18 @@ -1961,15 +2027,15 @@ msgstr "新しいメンテナーを迎える。" #: ../../documentation/repository-files/development-guide.md:26 msgid "" -"Allow technically inclined contributors to make thoughtful and useful " -"code based pull requests to your repository." +"Allow technically inclined contributors to make thoughtful and useful code " +"based pull requests to your repository." msgstr "技術志向のコントリビューターが、あなたのリポジトリに対して、思慮深く有用なコードベースのプルリクエストを行えるようにします。" #: ../../documentation/repository-files/development-guide.md:28 msgid "" "It also is important to pyOpenSci that the maintenance workflow is " -"documented in the case that we need to help you onboard new maintainers " -"in the future." +"documented in the case that we need to help you onboard new maintainers in " +"the future." msgstr "また、pyOpenSciにとって、将来新しいメンテナーの参加を支援する必要がある場合に備えて、メンテナンスのワークフローを文書化しておくことも重要です。" #: ../../documentation/repository-files/development-guide.md:33 @@ -1989,8 +2055,8 @@ msgstr "開発ガイドは強く推奨されますが、pyOpenSciがレビュー #: ../../documentation/repository-files/development-guide.md:44 msgid "" -"[The Mozilla Science Lab website has a nice outline of things to consider" -" when creating a contributing guide](https://mozillascience.github.io" +"[The Mozilla Science Lab website has a nice outline of things to consider " +"when creating a contributing guide](https://mozillascience.github.io" "/working-open-workshop/contributing/)" msgstr "" "[Mozilla Science " @@ -2003,19 +2069,19 @@ msgstr "Pythonパッケージリポジトリにあるべきドキュメントフ #: ../../documentation/repository-files/intro.md:3 msgid "" -"In this section of the Python packaging guide, we review all of the files" -" that you should have in your Python package repository. Your Python " -"package should, at a minimum have the following files:" +"In this section of the Python packaging guide, we review all of the files " +"that you should have in your Python package repository. Your Python package" +" should, at a minimum have the following files:" msgstr "" -"Python パッケージングガイドのこのセクションでは、Python パッケージリポジトリにあるべきすべてのファイルをレビューします。 " -"Python パッケージには最低限以下のファイルが必要です:" +"Python パッケージングガイドのこのセクションでは、Python パッケージリポジトリにあるべきすべてのファイルをレビューします。 Python " +"パッケージには最低限以下のファイルが必要です:" #: ../../documentation/repository-files/intro.md:7 msgid "" -"The files mentions above (README, Code of Conduct, license file, etc) are" -" used as a measure of package community health on many online platforms. " -"Below, you can see an example how GitHub evaluates community health. This" -" community health link is available for all GitHub repositories." +"The files mentions above (README, Code of Conduct, license file, etc) are " +"used as a measure of package community health on many online platforms. " +"Below, you can see an example how GitHub evaluates community health. This " +"community health link is available for all GitHub repositories." msgstr "" "上で言及したファイル（README、行動規範、ライセンスファイルなど）は、多くのオンラインプラットフォームでパッケージコミュニティの健全性を測る尺度として使われています。" " 以下に、GitHubがコミュニティの健全性をどのように評価しているかの例を示します。 このコミュニティ健全性リンクは、すべての GitHub " @@ -2023,11 +2089,10 @@ msgstr "" #: ../../documentation/repository-files/intro.md:13 msgid "" -"Image showing that the MovingPandas GitHub repository community health " -"page with green checks next to each file including a description, README," -" code of conduct, contributing, license and issue templates. Note that " -"Security policy has a yellow circle next to it as that is missing from " -"the repo." +"Image showing that the MovingPandas GitHub repository community health page" +" with green checks next to each file including a description, README, code " +"of conduct, contributing, license and issue templates. Note that Security " +"policy has a yellow circle next to it as that is missing from the repo." msgstr "" "MovingPandasのGitHubリポジトリコミュニティの健全性を示す画像で、説明、README、行動規範、貢献、ライセンス、課題テンプレートを含む各ファイルの横に緑色のチェックが付いています。" " セキュリティポリシーは黄色い丸で囲まれています。" @@ -2035,11 +2100,11 @@ msgstr "" #: ../../documentation/repository-files/intro.md:19 #, fuzzy msgid "" -"GitHub community health looks for a readme file among other elements when" -" it evaluates the community level health of your repository. This example" -" is from the [MovingPandas GitHub " -"repo](https://github.com/movingpandas/movingpandas/community) *(screen " -"shot taken Nov 23 2022)*" +"GitHub community health looks for a readme file among other elements when " +"it evaluates the community level health of your repository. This example is" +" from the [MovingPandas GitHub " +"repo](https://github.com/movingpandas/movingpandas/community) *(screen shot" +" taken Nov 23 2022)*" msgstr "" "GitHub community health は、リポジトリのコミュニティレベルの健全性を評価する際に、他の要素の中から readme " "ファイルを探します。この例は、 [MovingPandas GitHub " @@ -2048,8 +2113,8 @@ msgstr "" #: ../../documentation/repository-files/intro.md:22 msgid "" -"[Snyk](https://snyk.io/advisor/python) is another well-known company that" -" keeps tabs on package health. Below you can see a similar evaluation of " +"[Snyk](https://snyk.io/advisor/python) is another well-known company that " +"keeps tabs on package health. Below you can see a similar evaluation of " "files in the GitHub repo as a measure of community health." msgstr "" "[Snyk](https://snyk.io/advisor/python) もパッケージの健全性を監視している有名な会社です。 " @@ -2057,24 +2122,22 @@ msgstr "" #: ../../documentation/repository-files/intro.md:26 msgid "" -"Screenshot of the Snyk page for movingpandas. It shows that the " -"repository has a README file, contributing file, code of conduct. It also" -" shows that it has 30 contributors and no funding. The package health " -"score is 78/100." +"Screenshot of the Snyk page for movingpandas. It shows that the repository " +"has a README file, contributing file, code of conduct. It also shows that " +"it has 30 contributors and no funding. The package health score is 78/100." msgstr "" "movingpandasのSnykページのスクリーンショットです。 " -"このリポジトリには、READMEファイル、貢献ファイル、行動規範があることがわかります。 " -"また、30人の貢献者がいて、資金提供はないことがわかります。 パッケージのヘルススコアは78/100です。" +"このリポジトリには、READMEファイル、貢献ファイル、行動規範があることがわかります。 また、30人の貢献者がいて、資金提供はないことがわかります。" +" パッケージのヘルススコアは78/100です。" #: ../../documentation/repository-files/intro.md:32 msgid "" "Screenshot showing [SNYK](https://snyk.io/advisor/python/movingpandas) " -"package health for moving pandas. Notice both platforms look for a README" -" file. *(screen shot taken Nov 23 2022)*" +"package health for moving pandas. Notice both platforms look for a README " +"file. *(screen shot taken Nov 23 2022)*" msgstr "" -"[SNYK](https://snyk.io/advisor/python/movingpandas) " -"パッケージの健全性を示すスクリーンショット。 両方のプラットフォームがREADMEファイルを探していることに注目してください。 " -"*(スクリーンショットは2022年11月23日撮影)* 。" +"[SNYK](https://snyk.io/advisor/python/movingpandas) パッケージの健全性を示すスクリーンショット。 " +"両方のプラットフォームがREADMEファイルを探していることに注目してください。 *(スクリーンショットは2022年11月23日撮影)* 。" #: ../../documentation/repository-files/license-files.md:8 #, fuzzy @@ -2093,10 +2156,9 @@ msgstr "オープンソースライセンスファイルとは何ですか？" #: ../../documentation/repository-files/license-files.md:19 msgid "" -"When we talk about LICENSE files, we are referring to a file in your " -"GitHub or GitLab repository that contains legally binding language that " -"describes to your users how they can legally use (and not use) your " -"package." +"When we talk about LICENSE files, we are referring to a file in your GitHub" +" or GitLab repository that contains legally binding language that describes" +" to your users how they can legally use (and not use) your package." msgstr "LICENSEファイルというのは、GitHubやGitLabのリポジトリにあるファイルのことです。このファイルには、あなたのパッケージをユーザーが合法的に使う（あるいは使わない）方法が書かれています。" #: ../../documentation/repository-files/license-files.md:23 @@ -2130,8 +2192,8 @@ msgstr "などなど。" #: ../../documentation/repository-files/license-files.md:33 msgid "" -"[Read more about why license files are critical in protecting both you as" -" a maintainer and your users of your scientific Python open source " +"[Read more about why license files are critical in protecting both you as a" +" maintainer and your users of your scientific Python open source " "package.](https://opensource.guide/legal/#just-give-me-the-tldr-on-what-i" "-need-to-protect-my-project)" msgstr "" @@ -2150,15 +2212,14 @@ msgstr "`LICENSE` ファイルは GitHub / GitLab リポジトリのルートに #: ../../documentation/repository-files/license-files.md:39 msgid "" -"Some maintainers customize the language in their license files for " -"specific reasons. However, if you are just getting started, we suggest " -"that you select a permissive license and then use the legal language " -"templates provided both by GitHub and/or the " +"Some maintainers customize the language in their license files for specific" +" reasons. However, if you are just getting started, we suggest that you " +"select a permissive license and then use the legal language templates " +"provided both by GitHub and/or the " "[choosealicense.com](https://choosealicense.com/) website." msgstr "" -"特定の理由からライセンスファイルの言葉をカスタマイズするメンテナもいます。 " -"しかし、これから始めるのであれば、寛容なライセンスを選択し、GitHubや " -"[choosealicense.com](https://choosealicense.com/) " +"特定の理由からライセンスファイルの言葉をカスタマイズするメンテナもいます。 しかし、これから始めるのであれば、寛容なライセンスを選択し、GitHubや" +" [choosealicense.com](https://choosealicense.com/) " "のウェブサイトで提供されている法的な言語テンプレートを使うことをお勧めします。" #: ../../documentation/repository-files/license-files.md:42 @@ -2175,8 +2236,8 @@ msgstr "可能な限りオープンパーミッシブライセンスを使用す #, fuzzy msgid "" "We generally suggest that you use a permissive, license that is [Open " -"Software Initiative (OSI) approved](https://opensource.org/license). If " -"you are [submitting your package to pyOpenSci for peer " +"Software Initiative (OSI) approved](https://opensource.org/license). If you" +" are [submitting your package to pyOpenSci for peer " "review](https://www.pyopensci.org/about-peer-review/index.html), then we " "require an OSI approved license." msgstr "" @@ -2197,8 +2258,8 @@ msgid "" "greater) rights to modify, copy, share, and redistribute it. In other " "words, copyleft licenses prohibit someone taking your work, making a " "proprietary version of it, and redistributing it without providing the " -"source code so others can do the same. Copyleft licenses are \"sticky\" " -"in that they are designed to ensure that more free software is created." +"source code so others can do the same. Copyleft licenses are \"sticky\" in " +"that they are designed to ensure that more free software is created." msgstr "" "ライセンスのもう一つの大きなカテゴリーは、 [\"コピーレフト\" " "ライセンスです](https://en.wikipedia.org/wiki/Copyleft) " @@ -2214,18 +2275,18 @@ msgid "" "cultural divide in free and open source software (e.g., see " "{footcite}`hunterReclaimingComputingCommons2016`, " "{footcite}`gnuprojectWhatFreeSoftware2019`, " -"{footcite}`gnuprojectWhatCopyleft2022`). It is important to understand " -"this difference when choosing your license. Copyleft licenses represents " -"the \"free\" part of \"free and open source software\". Free and open " -"source software is intrinsically political, and it is important to be " -"aware of power dynamics in computing as well as the practical problems of" -" license compatibility (discussed below)." +"{footcite}`gnuprojectWhatCopyleft2022`). It is important to understand this" +" difference when choosing your license. Copyleft licenses represents the " +"\"free\" part of \"free and open source software\". Free and open source " +"software is intrinsically political, and it is important to be aware of " +"power dynamics in computing as well as the practical problems of license " +"compatibility (discussed below)." msgstr "" "コピーレフトとパーミッシブライセンスの違いは、フリーでオープンなソースソフトウェアにおける重要な文化的分裂です (例えば " "{footcite}`hunterReclaimingComputingCommons2016`, " "{footcite}`gnuprojectWhatFreeSoftware2019`, " -"{footcite}`gnuprojectWhatCopyleft2022`)。 ライセンスを選択する際には、この違いを理解することが重要である。" -" コピーレフトのライセンスは、 \"フリーでオープンなソースソフトウェア\" の \"フリー\" の部分を表している。 " +"{footcite}`gnuprojectWhatCopyleft2022`)。 ライセンスを選択する際には、この違いを理解することが重要である。 " +"コピーレフトのライセンスは、 \"フリーでオープンなソースソフトウェア\" の \"フリー\" の部分を表している。 " "フリーでオープンなソースソフトウェアは、本質的に政治的なものであり、ライセンスの互換性という現実的な問題 (後述) " "と同様に、コンピューティングにおけるパワーダイナミクスを意識することが重要です。" @@ -2235,22 +2296,21 @@ msgstr "ライセンスの選び方" #: ../../documentation/repository-files/license-files.md:63 msgid "" -"To select your license, we suggest that you use GitHub's [Choose a " -"License tool](https://choosealicense.com/)." +"To select your license, we suggest that you use GitHub's [Choose a License " +"tool](https://choosealicense.com/)." msgstr "" -"ライセンスを選択するには、GitHubの [Choose a License tool](https://choosealicense.com/)" -" を使うことをお勧めします。" +"ライセンスを選択するには、GitHubの [Choose a License tool](https://choosealicense.com/) " +"を使うことをお勧めします。" #: ../../documentation/repository-files/license-files.md:66 msgid "" -"If you choose your license when creating a new GitHub repository, you can" -" also automatically get a text copy of the license file to add to your " +"If you choose your license when creating a new GitHub repository, you can " +"also automatically get a text copy of the license file to add to your " "repository. However in some cases the license that you want is not " "available through that online process." msgstr "" -"GitHub " -"リポジトリの新規作成時にライセンスを選択すると、自動的にライセンスファイルのテキストコピーを取得してリポジトリに追加することもできます。 " -"しかし、オンラインプロセスでは希望のライセンスが取得できないこともあります。" +"GitHub リポジトリの新規作成時にライセンスを選択すると、自動的にライセンスファイルのテキストコピーを取得してリポジトリに追加することもできます。" +" しかし、オンラインプロセスでは希望のライセンスが取得できないこともあります。" #: ../../documentation/repository-files/license-files.md:71 msgid "License recommendations from the SciPy package" @@ -2261,11 +2321,11 @@ msgstr "SciPyパッケージからのライセンス勧告" msgid "" "[The SciPy documentation has an excellent overview of " "licenses.](https://docs.scipy.org/doc/scipy/dev/core-" -"dev/index.html#licensing) One of the key elements that these docs " -"recommend is ensuring that the license that you select is compatible with" -" licenses used in many parts of the scientific Python ecosystem. Below is" -" a highlight of this text which outlines license that are compatible with" -" the modified BSD license that SciPy uses." +"dev/index.html#licensing) One of the key elements that these docs recommend" +" is ensuring that the license that you select is compatible with licenses " +"used in many parts of the scientific Python ecosystem. Below is a highlight" +" of this text which outlines license that are compatible with the modified " +"BSD license that SciPy uses." msgstr "" "[SciPyのドキュメントには、ライセンスの優れた概要があります](https://docs.scipy.org/doc/scipy/dev" "/core-dev/index.html#licensing) 。 " @@ -2274,42 +2334,42 @@ msgstr "" #: ../../documentation/repository-files/license-files.md:78 msgid "" -"Other licenses that are compatible with the modified BSD license that " -"SciPy uses are 2-clause BSD, MIT and PSF. Incompatible licenses are GPL, " -"Apache and custom licenses that require attribution/citation or prohibit " -"use for commercial purposes." +"Other licenses that are compatible with the modified BSD license that SciPy" +" uses are 2-clause BSD, MIT and PSF. Incompatible licenses are GPL, Apache " +"and custom licenses that require attribution/citation or prohibit use for " +"commercial purposes." msgstr "" "SciPyが使用している修正BSDライセンスと互換性のある他のライセンスは、2-clause BSD、MIT、PSFです。 " "互換性のないライセンスは、GPL、Apache、および帰属表示/引用を必要とする、または商用目的での使用を禁止するカスタムライセンスです。" #: ../../documentation/repository-files/license-files.md:80 msgid "" -"If your primary goal is for your code to be used by other, major packages" -" in the scientific ecosystem, we also recommend that you consider using " -"either BSD or MIT as your license. If you are unsure, the MIT license " -"tends to be a simpler easier-to-understand option." +"If your primary goal is for your code to be used by other, major packages " +"in the scientific ecosystem, we also recommend that you consider using " +"either BSD or MIT as your license. If you are unsure, the MIT license tends" +" to be a simpler easier-to-understand option." msgstr "" "もしあなたのコードが、科学的エコシステムの他の主要なパッケージで使われることを第一の目的としているのであれば、BSDかMITのどちらかのライセンスを使うことを検討することも推奨します。" " よくわからない場合、MITライセンスはよりシンプルで理解しやすい選択肢となる傾向があります。" #: ../../documentation/repository-files/license-files.md:85 msgid "" -"Important: make sure that you closely follow the guidelines outlines by " -"the License that you chose" +"Important: make sure that you closely follow the guidelines outlines by the" +" License that you chose" msgstr "重要：選択したライセンスのガイドラインに忠実に従うこと" #: ../../documentation/repository-files/license-files.md:87 msgid "" -"Every license has different guidelines in terms of what code you can use " -"in your package and also how others can (or can not) use the code in your" -" package." +"Every license has different guidelines in terms of what code you can use in" +" your package and also how others can (or can not) use the code in your " +"package." msgstr "どのライセンスも、あなたがパッケージの中でどのようなコードを使うことができるか、また、他の人があなたのパッケージの中のコードをどのように使うことができるか(あるいは使うことができないか)という点で、異なるガイドラインを持っています。" #: ../../documentation/repository-files/license-files.md:90 msgid "" -"If you borrow code from other tools or online sources, make sure that the" -" license for the code that you are using also complies with the license " -"that you selected for your package." +"If you borrow code from other tools or online sources, make sure that the " +"license for the code that you are using also complies with the license that" +" you selected for your package." msgstr "他のツールやオンラインソースからコードを借用する場合は、使用するコードのライセンスが、あなたがパッケージに選択したライセンスにも準拠していることを確認してください。" #: ../../documentation/repository-files/license-files.md:94 @@ -2325,14 +2385,14 @@ msgstr "" #: ../../documentation/repository-files/license-files.md:98 msgid "" -"**Permissive licenses** like BSD and MIT have few **outbound** " -"restrictions - they can be used in any way by downstream consumers, " -"including making them proprietary. This is why they are favored by many " -"businesses and large packages that want to be adopted by businesses. " -"Permissive licenses have more **inbound** restrictions - they can't use " -"software that requires more freedoms to be preserved than they do, like " -"copyleft licenses. A package licensed under MIT needs to take special " -"care when including or modifying a package licensed under the GPL-3." +"**Permissive licenses** like BSD and MIT have few **outbound** restrictions" +" - they can be used in any way by downstream consumers, including making " +"them proprietary. This is why they are favored by many businesses and large" +" packages that want to be adopted by businesses. Permissive licenses have " +"more **inbound** restrictions - they can't use software that requires more " +"freedoms to be preserved than they do, like copyleft licenses. A package " +"licensed under MIT needs to take special care when including or modifying a" +" package licensed under the GPL-3." msgstr "" "BSDやMITのような **Permissive licenses** は、 **outbound** の制限がほとんどありません - " "専有化も含めて、ダウンストリームのカスタマーがどのようにでも使用することができます。 " @@ -2342,12 +2402,12 @@ msgstr "" #: ../../documentation/repository-files/license-files.md:103 msgid "" -"**Copyleft licenses** like GPL-3 have more **outbound** restrictions - " -"they require more of packages that include, use, modify, and reproduce " -"them. This is the purpose of copyleft licenses, to ensure that derivative" -" works remain free and open source. They have fewer **inbound** " -"restrictions - a GPL-3 licensed package can include any other " -"permissively licensed and most copyleft licensed packages." +"**Copyleft licenses** like GPL-3 have more **outbound** restrictions - they" +" require more of packages that include, use, modify, and reproduce them. " +"This is the purpose of copyleft licenses, to ensure that derivative works " +"remain free and open source. They have fewer **inbound** restrictions - a " +"GPL-3 licensed package can include any other permissively licensed and most" +" copyleft licensed packages." msgstr "" "GPL-3のような **Copyleft licenses** は、より **outbound** の制限があります - " "それらは、それらを含み、使用し、変更し、複製するパッケージにより多くを要求します。 " @@ -2400,9 +2460,9 @@ msgstr "StackOverflowを例に、ライセンスによってコードの使用 #: ../../documentation/repository-files/license-files.md:123 msgid "" "[Stack Overflow uses a Creative Commons Share Alike " -"license.](https://stackoverflow.com/help/licensing). The sharealike " -"license requires you to use the same sharealike license when you reuse " -"any code from Stack Overflow." +"license.](https://stackoverflow.com/help/licensing). The sharealike license" +" requires you to use the same sharealike license when you reuse any code " +"from Stack Overflow." msgstr "" "[Stack OverflowはCreative Commons Share " "Alikeライセンスを使用しています。](https://stackoverflow.com/help/licensing) " @@ -2412,17 +2472,17 @@ msgstr "" #: ../../documentation/repository-files/license-files.md:125 #, python-brace-format msgid "" -"This means that from a legal perspective, if you copy code from the Stack" -" Overflow website and use it in your package that is licensed " -"differently, say with a MIT license, you are violating Stack Overflow's " -"license requirements! This would not be true with a GPL licensed package." -" `GPL-3` packages can include code licensed by `CC-BY-SA` " +"This means that from a legal perspective, if you copy code from the Stack " +"Overflow website and use it in your package that is licensed differently, " +"say with a MIT license, you are violating Stack Overflow's license " +"requirements! This would not be true with a GPL licensed package. `GPL-3` " +"packages can include code licensed by `CC-BY-SA` " "{footcite}`creativecommonsShareAlikeCompatibilityGPLv32015`." msgstr "" "つまり、法的な観点からは、Stack " "Overflowのウェブサイトからコードをコピーし、MITライセンスなど異なるライセンスのパッケージで使用すると、Stack " -"Overflowのライセンス要件に違反することになります！ これはGPLライセンスのパッケージでは当てはまりません。 `GPL-3` パッケージは" -" `CC-BY-SA` {footcite}`creativecommonsShareAlikeCompatibilityGPLv32015` " +"Overflowのライセンス要件に違反することになります！ これはGPLライセンスのパッケージでは当てはまりません。 `GPL-3` パッケージは " +"`CC-BY-SA` {footcite}`creativecommonsShareAlikeCompatibilityGPLv32015` " "によってライセンスされたコードを含むことができます。" #: ../../documentation/repository-files/license-files.md:128 @@ -2438,9 +2498,9 @@ msgstr "ソフトウェアの引用についてはどうだろうか？" msgid "" "While many permissive licenses do not require citation, we strongly " "encourage that you cite all software that you use in papers, blogs, and " -"other publications. You tell your users how to cite your package by using" -" a [citation.cff file](https://docs.github.com/en/repositories/managing-" -"your-repositorys-settings-and-features/customizing-your-repository/about-" +"other publications. You tell your users how to cite your package by using a" +" [citation.cff file](https://docs.github.com/en/repositories/managing-your-" +"repositorys-settings-and-features/customizing-your-repository/about-" "citation-files)." msgstr "" "多くの寛容なライセンスは引用を必要としませんが、わたしたちは、あなたが論文やブログ、その他の出版物で使用するすべてのソフトウェアを引用することを強く推奨します。" @@ -2453,25 +2513,28 @@ msgstr "" msgid "" "Additional resources on software citation The Turing Way has excellent " "guides on this topic:" -msgstr "" +msgstr "ソフトウェアの引用に関する追加リソース The Turing Way には、このトピックに関する優れたガイドがあります。" #: ../../documentation/repository-files/license-files.md:139 msgid "" -"[CITATION.cff files](https://book.the-turing-" -"way.org/communication/citable/citable-cff) — detailed guide on creating " -"and maintaining citation files" +"[CITATION.cff files](https://book.the-turing-way.org/communication/citable" +"/citable-cff) — detailed guide on creating and maintaining citation files" msgstr "" +"[CITATION.cff files](https://book.the-turing-way.org/communication/citable" +"/citable-cff) — 引用ファイルの作成と管理に関する詳細なガイド" #: ../../documentation/repository-files/license-files.md:140 msgid "" "[Software citation pathways](https://book.the-turing-way.org/pathways" -"/pathways-software-citation) — overview of how software citation works in" -" practice" +"/pathways-software-citation) — overview of how software citation works in " +"practice" msgstr "" +"[ソフトウェア引用経路](https://book.the-turing-way.org/pathways/pathways-software-" +"quote) — ソフトウェア引用が実際にどのように機能するかの概要" #: ../../documentation/repository-files/license-files.md:142 msgid "Citation.cff files: Making your software citable" -msgstr "" +msgstr "Citation.cff ファイル: ソフトウェアを引用可能にする" #: ../../documentation/repository-files/license-files.md:144 msgid "" @@ -2480,57 +2543,69 @@ msgid "" "File Format,\" which is a standardized format for software citation " "metadata." msgstr "" +"「CITATION.cff」ファイルは、ソフトウェア パッケージの引用情報を提供する機械可読ファイルです。 「cff」は「Citation File " +"Format」の略で、ソフトウェア引用メタデータの標準化された形式です。" #: ../../documentation/repository-files/license-files.md:146 msgid "What citation.cff files add to your repository" -msgstr "" +msgstr "リポジトリに追加する cycling.cff ファイル" #: ../../documentation/repository-files/license-files.md:148 msgid "" -"When you add a `CITATION.cff` file to your repository, GitHub " -"automatically detects it and displays a \"Cite this repository\" button. " -"This makes it easy for users to properly cite your software. The file " -"contains standardized citation information that tools and services can " -"automatically read and use. GitHub will generate both APA and BibTeX " -"citation formats for users." +"When you add a `CITATION.cff` file to your repository, GitHub automatically" +" detects it and displays a \"Cite this repository\" button. This makes it " +"easy for users to properly cite your software. The file contains " +"standardized citation information that tools and services can automatically" +" read and use. GitHub will generate both APA and BibTeX citation formats " +"for users." msgstr "" +"`CITATION.cff` ファイルをリポジトリに追加すると、GitHub はそれを自動的に検出し、[このリポジトリを引用] " +"ボタンを表示します。これにより、ユーザーがソフトウェアを適切に引用することが容易になります。このファイルには、ツールやサービスが自動的に読み取って使用できる標準化された引用情報が含まれています。" +" GitHub は、ユーザー向けに APA と BibTeX の両方の引用形式を生成します。" #: ../../documentation/repository-files/license-files.md:150 msgid "How dates are tracked in citation.cff files" -msgstr "" +msgstr "citation.cff ファイル内での日付の追跡方法" #: ../../documentation/repository-files/license-files.md:152 msgid "" "The citation file tracks important dates for your software. The `date-" "released` field shows when the current version was released. The `date-" -"published` field shows when the software was first made available. You " -"also include a `version` field with the specific version number." +"published` field shows when the software was first made available. You also" +" include a `version` field with the specific version number." msgstr "" +"引用ファイルは、ソフトウェアの重要な日付を追跡します。 「date-" +"release」フィールドには、現在のバージョンがいつリリースされたかが表示されます。 " +"「公開日」フィールドには、ソフトウェアが最初に利用可能になった時期が表示されます。特定のバージョン番号を含む「version」フィールドも含めます。" #: ../../documentation/repository-files/license-files.md:154 msgid "" "You should update these dates with each new release so people cite the " "correct version of your software." -msgstr "" +msgstr "人々があなたのソフトウェアの正しいバージョンを引用できるように、新しいリリースごとにこれらの日付を更新する必要があります。" #: ../../documentation/repository-files/license-files.md:156 msgid "Integration with Zenodo" -msgstr "" +msgstr "Zenodo との統合" #: ../../documentation/repository-files/license-files.md:158 msgid "" -"Citation.cff files work well with Zenodo, which is a popular place to " -"store research software and get DOIs. When you create a Zenodo release, " -"it can automatically pull information from your citation file. This keeps" -" your citation information the same between GitHub and Zenodo. You can " -"also include your Zenodo DOI in the citation file. Each time you make a " -"new GitHub release, it can create a new Zenodo version with updated " -"citation information." +"Citation.cff files work well with Zenodo, which is a popular place to store" +" research software and get DOIs. When you create a Zenodo release, it can " +"automatically pull information from your citation file. This keeps your " +"citation information the same between GitHub and Zenodo. You can also " +"include your Zenodo DOI in the citation file. Each time you make a new " +"GitHub release, it can create a new Zenodo version with updated citation " +"information." msgstr "" +"Citation.cff ファイルは、研究ソフトウェアを保存して DOI を取得するための人気のある場所である Zenodo とうまく連携します。 " +"Zenodo リリースを作成すると、引用ファイルから情報が自動的に取得されます。これにより、GitHub と Zenodo " +"の間で引用情報が同じに保たれます。 Zenodo DOI を引用ファイルに含めることもできます。新しい GitHub " +"リリースを作成するたびに、引用情報が更新された新しい Zenodo バージョンを作成できます。" #: ../../documentation/repository-files/license-files.md:161 msgid "Here's a basic example of what a `CITATION.cff` file might look like:" -msgstr "" +msgstr "「CITATION.cff」ファイルがどのようなものであるかを示す基本的な例を次に示します。" #: ../../documentation/repository-files/license-files.md:177 msgid "References" @@ -2554,9 +2629,7 @@ msgid "The README.md file is the landing page of:" msgstr "README.mdファイルは、そのランディングページです:" #: ../../documentation/repository-files/readme-file-best-practices.md:11 -msgid "" -"Your package as it appears on a repository site such as PyPI or " -"Anaconda.org" +msgid "Your package as it appears on a repository site such as PyPI or Anaconda.org" msgstr "PyPIやAnaconda.orgのようなリポジトリサイトに表示されているあなたのパッケージ" #: ../../documentation/repository-files/readme-file-best-practices.md:12 @@ -2572,42 +2645,40 @@ msgstr "あなたのREADME.mdファイルは、以下のようなサイトで、 #: ../../documentation/repository-files/readme-file-best-practices.md:17 msgid "" "[GitHub community health for MovingPandas (available for all " -"repositories)](https://github.com/movingpandas/movingpandas/community) " -"and [Snyk - MovingPandas " -"example](https://snyk.io/advisor/python/movingpandas)" +"repositories)](https://github.com/movingpandas/movingpandas/community) and " +"[Snyk - MovingPandas example](https://snyk.io/advisor/python/movingpandas)" msgstr "" "[GitHub community health for MovingPandas (available for all " "repositories)](https://github.com/movingpandas/movingpandas/community) と " -"[Snyk - MovingPandas " -"example](https://snyk.io/advisor/python/movingpandas) 。" +"[Snyk - MovingPandas example](https://snyk.io/advisor/python/movingpandas) " +"。" #: ../../documentation/repository-files/readme-file-best-practices.md:19 msgid "" -"README landing page screenshot for the Pandera package. It has the " -"Pandera logo at the top - which has two arrows in a chevron pattern " -"pointing downward within a circle. Subtitle is statistical data testing " -"toolkit. A data validation library for scientists, engineering, and " -"analytics seeking correctness. Below that are a series of badges " -"including CI tests passing, docs passing, version of Pandera on pypi " -"(0.13.4), MIT license and that it has been pyOpenSci peer reviewed. There" -" are numerous badges below that. Finally below the badges the text says, " -"Pandera provides a flexible and expressive API for performing data " -"validation on dataframe-like objects to make data processing pipelines " -"more readable and robust." +"README landing page screenshot for the Pandera package. It has the Pandera " +"logo at the top - which has two arrows in a chevron pattern pointing " +"downward within a circle. Subtitle is statistical data testing toolkit. A " +"data validation library for scientists, engineering, and analytics seeking " +"correctness. Below that are a series of badges including CI tests passing, " +"docs passing, version of Pandera on pypi (0.13.4), MIT license and that it " +"has been pyOpenSci peer reviewed. There are numerous badges below that. " +"Finally below the badges the text says, Pandera provides a flexible and " +"expressive API for performing data validation on dataframe-like objects to " +"make data processing pipelines more readable and robust." msgstr "" " " "PanderaパッケージのREADMEランディングページのスクリーンショット。上部にPanderaのロゴがあり、丸の中にシェブロン模様の2本の矢印が下を向いています。副題は統計データテストツールキットです。正しさを追求する科学者、エンジニアリング、アナリティクスのためのデータ検証ライブラリです。その下には、CIテスト合格、ドキュメント合格、pypi上のPanderaのバージョン(0.13.4)、MITライセンス、pyOpenSci査読済みなどのバッジがあります。その下にも数多くのバッジがあります。バッジの下には、Panderaは、データ処理パイプラインの可読性と堅牢性を向上させるために、データフレームのようなオブジェクトに対してデータ検証を実行するための柔軟で表現力豊かなAPIを提供しますとあります。" #: ../../documentation/repository-files/readme-file-best-practices.md:25 msgid "" -"Your GitHub repository landing page highlights the README.md file. Here " -"you can see the README.md file for the pyOpenSci package " -"[Pandera](https://github.com/unionai-oss/pandera). *(screen shot taken " -"Nov 23 2022)*" +"Your GitHub repository landing page highlights the README.md file. Here you" +" can see the README.md file for the pyOpenSci package " +"[Pandera](https://github.com/unionai-oss/pandera). *(screen shot taken Nov " +"23 2022)*" msgstr "" "GitHub リポジトリのランディングページは README.md ファイルをハイライトします。ここでは、pyOpenSciパッケージ " -"[Pandera](https://github.com/unionai-oss/pandera) " -"のREADME.mdファイルを見ることができます。 *(スクリーンショットは2022年11月23日撮影)* 。" +"[Pandera](https://github.com/unionai-oss/pandera) のREADME.mdファイルを見ることができます。" +" *(スクリーンショットは2022年11月23日撮影)* 。" #: ../../documentation/repository-files/readme-file-best-practices.md:28 msgid "" @@ -2641,8 +2712,8 @@ msgstr "✔️ パッケージ名" #: ../../documentation/repository-files/readme-file-best-practices.md:58 msgid "" -"Ideally your GitHub repository's name is also the name of your package. " -"The more self explanatory that name is, the better." +"Ideally your GitHub repository's name is also the name of your package. The" +" more self explanatory that name is, the better." msgstr "GitHub リポジトリの名前がパッケージの名前にもなっているのが理想的です。 説明しやすい名前であればあるほどよいでしょう。" #: ../../documentation/repository-files/readme-file-best-practices.md:61 @@ -2653,17 +2724,17 @@ msgstr "✔️ 現在のパッケージバージョン、継続的インテグ #: ../../documentation/repository-files/readme-file-best-practices.md:63 msgid "" -"Badges are a useful way to draw attention to the quality of your project." -" Badges assure users that your package is well-designed, tested, and " -"maintained. They are also a useful maintenance tool to evaluate if things" -" are building properly. A great example of this is adding a [Read the " -"Docs status badge](https://docs.readthedocs.io/en/stable/badges.html) to " -"your README.md file to quickly see when the build on that site fails." +"Badges are a useful way to draw attention to the quality of your project. " +"Badges assure users that your package is well-designed, tested, and " +"maintained. They are also a useful maintenance tool to evaluate if things " +"are building properly. A great example of this is adding a [Read the Docs " +"status badge](https://docs.readthedocs.io/en/stable/badges.html) to your " +"README.md file to quickly see when the build on that site fails." msgstr "" "バッジは、あなたのプロジェクトの品質に注意を向けるための便利な方法です。 " "バッジは、あなたのパッケージがよく設計され、テストされ、保守されていることをユーザに保証します。 " -"また、適切にビルドされているかどうかを評価するのに便利なメンテナンスツールでもあります。 README.mdファイルに [Read the " -"Docs status badge](https://docs.readthedocs.io/en/stable/badges.html) " +"また、適切にビルドされているかどうかを評価するのに便利なメンテナンスツールでもあります。 README.mdファイルに [Read the Docs " +"status badge](https://docs.readthedocs.io/en/stable/badges.html) " "を追加することで、そのサイトのビルドが失敗したときにすぐに確認することができます。" #: ../../documentation/repository-files/readme-file-best-practices.md:69 @@ -2698,13 +2769,11 @@ msgid "" "Status of tests (pass or fail) - Example: [![CI Build](https://github.com" "/unionai-" "oss/pandera/workflows/CI%20Tests/badge.svg?branch=main)](https://github.com" -"/unionai-" -"oss/pandera/actions?query=workflow%3A%22CI+Tests%22+branch%3Amain)" +"/unionai-oss/pandera/actions?query=workflow%3A%22CI+Tests%22+branch%3Amain)" msgstr "" "テストのステータス(合格または不合格) - 例: [![CI Build](https://github.com/pandera-" "dev/pandera/workflows/CI%20Tests/badge.svg?branch=main)](https://github.com" -"/pandera-" -"dev/pandera/actions?query=workflow%3A%22CI+Tests%22+branch%3Amain)" +"/pandera-dev/pandera/actions?query=workflow%3A%22CI+Tests%22+branch%3Amain)" #: ../../documentation/repository-files/readme-file-best-practices.md:78 msgid "CI Build" @@ -2738,16 +2807,14 @@ msgstr "DOI" #: ../../documentation/repository-files/readme-file-best-practices.md:85 #, fuzzy msgid "" -"Once you package is accepted to pyOpenSci, we will provide you with a " -"badge to add to your repository that shows that it has been reviewed. " +"Once you package is accepted to pyOpenSci, we will provide you with a badge" +" to add to your repository that shows that it has been reviewed. " "[![pyOpenSci](https://www.pyopensci.org/badges/peer-" -"reviewed.svg)](https://github.com/pyOpenSci/software-" -"submission/issues/12)" +"reviewed.svg)](https://github.com/pyOpenSci/software-submission/issues/12)" msgstr "" "あなたのパッケージがpyOpenSciに受理されると、あなたのリポジトリにレビュー済みであることを示すバッジを提供します。 " "[![pyOpenSci](https://pyopensci.org/badges/peer-" -"reviewed.svg)](https://github.com/pyOpenSci/software-" -"submission/issues/12)" +"reviewed.svg)](https://github.com/pyOpenSci/software-submission/issues/12)" #: ../../documentation/repository-files/readme-file-best-practices.md:85 msgid "pyOpenSci" @@ -2765,20 +2832,19 @@ msgstr "✔️ あなたのパッケージが何をするのかを短く、わ #: ../../documentation/repository-files/readme-file-best-practices.md:97 msgid "" -"At the top of your README file you should have a short, easy-to-" -"understand, 1-3 sentence description of what your package does. This " -"section should clearly state your goals for the package. The language in " -"this description should use less technical terms so that a variety of " -"users with varying scientific (and development) backgrounds can " -"understand it." +"At the top of your README file you should have a short, easy-to-understand," +" 1-3 sentence description of what your package does. This section should " +"clearly state your goals for the package. The language in this description " +"should use less technical terms so that a variety of users with varying " +"scientific (and development) backgrounds can understand it." msgstr "READMEファイルの一番上に、あなたのパッケージが何をするのか、短く、わかりやすく、1-3文の説明を書くべきです。このセクションには、パッケージの目標を明記します。この説明では、科学的（および開発的）背景が異なるさまざまなユーザーが理解できるように、専門用語をあまり使わないようにすべきです。" #: ../../documentation/repository-files/readme-file-best-practices.md:103 msgid "" "In this description, it's useful to let users know how your package fits " -"within the broader scientific Python package ecosystem. If there are " -"other similar packages or complementary package mentions them here in 1-2" -" sentences." +"within the broader scientific Python package ecosystem. If there are other " +"similar packages or complementary package mentions them here in 1-2 " +"sentences." msgstr "" "この説明では、あなたのパッケージがより広い科学的 Python " "パッケージのエコシステムの中でどのように位置づけられるかをユーザに知らせるのに役立ちます。 " @@ -2786,9 +2852,9 @@ msgstr "" #: ../../documentation/repository-files/readme-file-best-practices.md:108 msgid "" -"Consider writing for a high school level (or equivalent) level. This " -"level of writing is often considered an appropriate level for scientific " -"content that serves a variety of users with varying backgrounds." +"Consider writing for a high school level (or equivalent) level. This level " +"of writing is often considered an appropriate level for scientific content " +"that serves a variety of users with varying backgrounds." msgstr "" "高校レベル（または同等のレベル）の文章を書くことを考慮します。 " "このレベルの文章は、さまざまな背景を持つさまざまなユーザーに役立つ科学的な内容として、しばしば適切なレベルとみなされます。" @@ -2805,9 +2871,9 @@ msgstr "✔️ インストール手順" #: ../../documentation/repository-files/readme-file-best-practices.md:118 msgid "" -"Include instructions for installing your package. If you have published " -"the package on both PyPI and Anaconda.org, be sure to include " -"instructions for both." +"Include instructions for installing your package. If you have published the" +" package on both PyPI and Anaconda.org, be sure to include instructions for" +" both." msgstr "パッケージのインストール手順を含めます。 PyPIとAnaconda.orgの両方でパッケージを公開している場合は、必ず両方の説明を含めてください。" #: ../../documentation/repository-files/readme-file-best-practices.md:121 @@ -2856,15 +2922,15 @@ msgstr "良いことのあまり" #: ../../documentation/repository-files/readme-file-best-practices.md:143 msgid "" -"Try to avoid including several tutorials in the README.md file itself. " -"This too will overwhelm the user with information." +"Try to avoid including several tutorials in the README.md file itself. This" +" too will overwhelm the user with information." msgstr "README.mdファイル自体に複数のチュートリアルを含めるのはなるべく避けてください。 これもユーザーを情報で圧倒してしまいます。" #: ../../documentation/repository-files/readme-file-best-practices.md:145 msgid "" -"A short quick-start code example that shows someone how to use your " -"package is plenty of content for the README file. All other tutorials and" -" documentation should be presented as descriptive links." +"A short quick-start code example that shows someone how to use your package" +" is plenty of content for the README file. All other tutorials and " +"documentation should be presented as descriptive links." msgstr "" "READMEファイルの内容は、あなたのパッケージの使い方を示す短いクイックスタートのコード例で十分です。 " "他のすべてのチュートリアルやドキュメントは、説明的なリンクとして表示されるべきです。" @@ -2917,8 +2983,8 @@ msgstr "READMEリソース" #: ../../documentation/repository-files/readme-file-best-practices.md:173 msgid "" -"Below are some resources on creating great README.md files that you might" -" find helpful." +"Below are some resources on creating great README.md files that you might " +"find helpful." msgstr "以下に、優れたREADME.mdファイルを作成するためのリソースをいくつか紹介するので、参考にしてください。" #: ../../documentation/repository-files/readme-file-best-practices.md:176 @@ -2931,11 +2997,11 @@ msgstr "" #: ../../documentation/repository-files/readme-file-best-practices.md:177 msgid "" -"[Art of README - Kira (@hackergrrl)](https://github.com/hackergrrl/art-" -"of-readme)" +"[Art of README - Kira (@hackergrrl)](https://github.com/hackergrrl/art-of-" +"readme)" msgstr "" -"[Art of README - Kira (@hackergrrl)](https://github.com/hackergrrl/art-" -"of-readme)" +"[Art of README - Kira (@hackergrrl)](https://github.com/hackergrrl/art-of-" +"readme)" #: ../../documentation/repository-files/readme-file-best-practices.md:178 #, python-format @@ -2945,16 +3011,21 @@ msgid "" "compliant](https://img.shields.io/badge/readme%20style-standard-" "brightgreen.svg)](https://github.com/RichardLitt/standard-readme)" msgstr "" +"[標準 Readme - Richard Littauer](https://github.com/RichardLitt/standard-" +"readme) [![standard-readme 準拠](https://img.shields.io/badge/readme%20style-" +"standard-brightgreen.svg)](https://github.com/RichardLitt/standard-readme)" #: ../../documentation/repository-files/readme-file-best-practices.md:178 msgid "standard-readme compliant" -msgstr "" +msgstr "標準Readme準拠" #: ../../documentation/repository-files/readme-file-best-practices.md:179 msgid "" -"[Standard Readme pre-commit hooks](https://github.com/tkoyama010" -"/standard-readme-pre-commit)" +"[Standard Readme pre-commit hooks](https://github.com/tkoyama010/standard-" +"readme-pre-commit)" msgstr "" +"[標準 Readme プリコミットフック](https://github.com/tkoyama010/standard-readme-pre-" +"commit)" #: ../../documentation/write-user-documentation/create-package-tutorials.md:1 msgid "Create tutorials in your Python package documentation" @@ -2963,8 +3034,8 @@ msgstr "Pythonパッケージのドキュメントにチュートリアルを作 #: ../../documentation/write-user-documentation/create-package-tutorials.md:6 msgid "" "Your package should have tutorials that make it easy for a user to get " -"started using your package. Ideally, those tutorials also can be run from" -" start to finish providing a second set of checks (on top of your test " +"started using your package. Ideally, those tutorials also can be run from " +"start to finish providing a second set of checks (on top of your test " "suite) to your package's code base." msgstr "" "パッケージには、ユーザが簡単にパッケージを使い始められるようなチュートリアルがあるべきです。 " @@ -2974,11 +3045,11 @@ msgstr "" #: ../../documentation/write-user-documentation/create-package-tutorials.md:11 msgid "" "On this page, we review two Sphinx extensions (`sphinx-gallery` and " -"`nbsphinx`) that allow you to create reproducible tutorials that are run" -" when your Sphinx documentation builds." +"`nbsphinx`) that allow you to create reproducible tutorials that are run " +"when your Sphinx documentation builds." msgstr "" -"このページでは、あなたのSphinxドキュメントがビルドされたときに実行される、2つのSphinx拡張機能 (`sphinx-gallery` と" -" `nbsphinx`) について紹介します。" +"このページでは、あなたのSphinxドキュメントがビルドされたときに実行される、2つのSphinx拡張機能 (`sphinx-gallery` と " +"`nbsphinx`) について紹介します。" #: ../../documentation/write-user-documentation/create-package-tutorials.md:15 msgid "Create Python package tutorials that run when you build your docs" @@ -2986,8 +3057,8 @@ msgstr "ドキュメントのビルド時に実行されるPythonパッケージ #: ../../documentation/write-user-documentation/create-package-tutorials.md:17 msgid "" -"Adding well constructed tutorials to your package will make it easier for" -" someone new to begin using your package." +"Adding well constructed tutorials to your package will make it easier for " +"someone new to begin using your package." msgstr "よく構成されたチュートリアルをパッケージに加えることで、新しい人があなたのパッケージを使い始めるのが簡単になります。" #: ../../documentation/write-user-documentation/create-package-tutorials.md:20 @@ -3016,8 +3087,8 @@ msgstr "ユーザーがチュートリアルをサムネイルで見ることが #: ../../documentation/write-user-documentation/create-package-tutorials.md:28 msgid "" -"Run the code in your tutorials adding another level of \"testing\" for " -"your package as used." +"Run the code in your tutorials adding another level of \"testing\" for your" +" package as used." msgstr "チュートリアルのコードを実行し、使用するパッケージの \"テスト\" をもう一段階追加する。" #: ../../documentation/write-user-documentation/create-package-tutorials.md:29 @@ -3030,10 +3101,10 @@ msgstr "[sphinx gallery:](https://sphinx-gallery.github.io/stable/index.html)" #: ../../documentation/write-user-documentation/create-package-tutorials.md:33 msgid "" -"If you prefer to write your tutorials using Python **.py** scripts, you " -"may enjoy using Sphinx gallery. Sphinx gallery uses **.py** files with " -"text and code sections that mimic the Jupyter Notebook format. When you " -"build your documentation, the gallery extension:" +"If you prefer to write your tutorials using Python **.py** scripts, you may" +" enjoy using Sphinx gallery. Sphinx gallery uses **.py** files with text " +"and code sections that mimic the Jupyter Notebook format. When you build " +"your documentation, the gallery extension:" msgstr "" "もしPythonの **.py** スクリプトを使ってチュートリアルを書きたいのであれば、Sphinx galleryを使うと楽しいでしょう。 " "Sphinx galleryは、Jupyter Notebookのフォーマットを模倣した、テキストとコードのセクションを持つ **.py** " @@ -3041,9 +3112,9 @@ msgstr "" #: ../../documentation/write-user-documentation/create-package-tutorials.md:38 msgid "" -"Runs the code in each tutorial. Running your tutorial like this acts as a" -" check to ensure your package's functions, classes, methods, and " -"attributes (ie the API) are working as they should." +"Runs the code in each tutorial. Running your tutorial like this acts as a " +"check to ensure your package's functions, classes, methods, and attributes " +"(ie the API) are working as they should." msgstr "" "各チュートリアルのコードを実行します。 " "このようにチュートリアルを実行することで、パッケージの関数、クラス、メソッド、アトリビュート(つまりAPI)が正常に動作しているかどうかを確認することができます。" @@ -3058,8 +3129,8 @@ msgstr "" #: ../../documentation/write-user-documentation/create-package-tutorials.md:40 msgid "" -"Creates a rendered **.html** page with the code elements and code " -"outputs in a user-friendly tutorial gallery." +"Creates a rendered **.html** page with the code elements and code outputs " +"in a user-friendly tutorial gallery." msgstr "レンダリングされた **.html** ページを作成し、ユーザーフレンドリーなチュートリアルギャラリーにコード要素とコード出力を表示します。" #: ../../documentation/write-user-documentation/create-package-tutorials.md:41 @@ -3079,10 +3150,10 @@ msgstr "" #: ../../documentation/write-user-documentation/create-package-tutorials.md:50 msgid "" -"`sphinx-gallery` makes it easy to create a user-friendly tutorial " -"gallery. Each tutorial has a download link where the user can download a " -"**.py** file or a Jupyter Notebook. And it renders the tutorials in a " -"user-friendly grid." +"`sphinx-gallery` makes it easy to create a user-friendly tutorial gallery. " +"Each tutorial has a download link where the user can download a **.py** " +"file or a Jupyter Notebook. And it renders the tutorials in a user-friendly" +" grid." msgstr "" "`sphinx-gallery` は、ユーザーフレンドリーなチュートリアルギャラリーを簡単に作成することができます。 " "それぞれのチュートリアルにはダウンロードリンクがあり、ユーザーは **.py** ファイルやJupyter " @@ -3094,20 +3165,20 @@ msgstr "下記はsphinx-galleryで作成したチュートリアルの様子で #: ../../documentation/write-user-documentation/create-package-tutorials.md:56 msgid "" -"Image showing ta single tutorial from Sphinx gallery. The tutorial shows " -"a simple matplotlib created plot and associated code." +"Image showing ta single tutorial from Sphinx gallery. The tutorial shows a " +"simple matplotlib created plot and associated code." msgstr "" "画像はSphinxギャラリーのチュートリアルです。 " "このチュートリアルでは、簡単なmatplotlibで作成したプロットと、それに関連するコードを示しています。" #: ../../documentation/write-user-documentation/create-package-tutorials.md:62 msgid "" -"`sphinx-gallery` tutorials by default include download links for both the" -" python script (**.py** file) and a Jupyter notebook (**.ipynb** file) at" -" the bottom." +"`sphinx-gallery` tutorials by default include download links for both the " +"python script (**.py** file) and a Jupyter notebook (**.ipynb** file) at " +"the bottom." msgstr "" -"`sphinx-gallery` のチュートリアルは、デフォルトでは、Pythonスクリプト (**.py** " -"ファイル)とJupyterノートブック (**.ipynb** ファイル)のダウンロードリンクが下部に含まれています。" +"`sphinx-gallery` のチュートリアルは、デフォルトでは、Pythonスクリプト (**.py** ファイル)とJupyterノートブック" +" (**.ipynb** ファイル)のダウンロードリンクが下部に含まれています。" #: ../../documentation/write-user-documentation/create-package-tutorials.md:66 msgid "Sphinx Gallery benefits" @@ -3149,14 +3220,14 @@ msgstr "**.py** ファイルは、特にmatplotlibのプロット出力がある #: ../../documentation/write-user-documentation/create-package-tutorials.md:78 msgid "" -"For example: To allow for plots to render, you need to name each file " -"with `plot_` at the beginning." +"For example: To allow for plots to render, you need to name each file with " +"`plot_` at the beginning." msgstr "例えば: プロットをレンダリングできるようにするには、各ファイルの先頭に `plot_` を付ける必要があります。" #: ../../documentation/write-user-documentation/create-package-tutorials.md:81 msgid "" -"Many users these days are used to working in Jupyter Notebooks. .py may " -"be slightly less user friendly to work with" +"Many users these days are used to working in Jupyter Notebooks. .py may be " +"slightly less user friendly to work with" msgstr "最近、多くのユーザーはJupyter Notebookで作業することに慣れています。.pyは作業するのに少し使いにくいかもしれません" #: ../../documentation/write-user-documentation/create-package-tutorials.md:83 @@ -3198,8 +3269,8 @@ msgstr "ノートブックを実行し、レンダリングされたチュート #: ../../documentation/write-user-documentation/create-package-tutorials.md:121 msgid "" "Pro/con By default it does not support downloading of **.py** and " -"**.ipynb** files. However you can add a [link to the notebook at the top " -"of the page with some additional conf.py settings (see: epilog " +"**.ipynb** files. However you can add a [link to the notebook at the top of" +" the page with some additional conf.py settings (see: epilog " "settings)](https://nbsphinx.readthedocs.io/en/0.8.10/prolog-and-" "epilog.html)" msgstr "" @@ -3217,8 +3288,8 @@ msgstr "画像は、nbsphinxがsphinx-galleryフロントエンドインター #: ../../documentation/write-user-documentation/create-package-tutorials.md:131 msgid "" "`nbsphinx` can be combined with Sphinx gallery to create a gallery of " -"tutorials. However, rather than rendering the gallery as a grid, it lists" -" all of the gallery elements in a single column." +"tutorials. However, rather than rendering the gallery as a grid, it lists " +"all of the gallery elements in a single column." msgstr "" "`nbsphinx` はチュートリアルのギャラリーを作成するために、Sphinx galleryと組み合わせることができます。 " "しかし、ギャラリーをグリッドとしてレンダリングするのではなく、1つのカラムに全てのギャラリー要素をリストアップします。" @@ -3233,8 +3304,8 @@ msgstr "APIとは何か？" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:6 msgid "" -"API stands for **A**pplied **P**rogramming **I**nterface. When discussed " -"in the context of a (Python) package, the API refers to the functions, " +"API stands for **A**pplied **P**rogramming **I**nterface. When discussed in" +" the context of a (Python) package, the API refers to the functions, " "classes, methods, and attributes that a package maintainer creates for " "users." msgstr "" @@ -3244,10 +3315,10 @@ msgstr "" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:10 msgid "" "A simple example of a package API element: For instance, a package might " -"have a function called `add_numbers()` that adds up a bunch of numbers. " -"To add up numbers, you as the user simply call `add_numbers(1,2,3)` and " -"the package function calculates the value and returns `6`. By calling the" -" `add_numbers` function, you are using the package's API." +"have a function called `add_numbers()` that adds up a bunch of numbers. To " +"add up numbers, you as the user simply call `add_numbers(1,2,3)` and the " +"package function calculates the value and returns `6`. By calling the " +"`add_numbers` function, you are using the package's API." msgstr "" "パッケージAPI要素の単純な例： 例えば、あるパッケージに `add_numbers()` " "という関数があり、その関数はたくさんの数字を足し算するとします。 数字を足し算するには、ユーザは `add_numbers(1,2,3)` " @@ -3266,13 +3337,12 @@ msgstr "docstringとは何ですか？docstringとドキュメンテーション #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:20 msgid "" -"In Python, a docstring refers to text in a function, method or class that" -" describes what the function does and its inputs and outputs. Python " +"In Python, a docstring refers to text in a function, method or class that " +"describes what the function does and its inputs and outputs. Python " "programmers usually refer to the inputs to functions as " -"[\"parameters\"](https://docs.python.org/3/glossary.html#term-parameter) " -"or [\"arguments\"](https://docs.python.org/3/faq/programming.html#faq-" -"argument-vs-parameter), and the outputs are often called \"return " -"values\"" +"[\"parameters\"](https://docs.python.org/3/glossary.html#term-parameter) or" +" [\"arguments\"](https://docs.python.org/3/faq/programming.html#faq-" +"argument-vs-parameter), and the outputs are often called \"return values\"" msgstr "" "Pythonにおいてdocstringとは、関数、メソッド、クラスにおいて、その関数が何を行うのか、その入出力を記述したテキストを指します。 " "Pythonプログラマは通常、関数への入力を " @@ -3287,18 +3357,18 @@ msgstr "docstringは以下のために重要です:" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:25 msgid "" "When you call `help()` in Python, for example, `help(add_numbers)` will " -"show the text of the function's docstring. The docstring thus helps a " -"user better understand how to apply the function more effectively to " -"their workflow." +"show the text of the function's docstring. The docstring thus helps a user " +"better understand how to apply the function more effectively to their " +"workflow." msgstr "" -"Pythonで `help()` を呼び出すと、例えば `help(add_numbers)` は関数のdocstringのテキストを表示します。" -" このようにdocstringは、ユーザが自分のワークフローにより効果的に関数を適用する方法をよりよく理解するのに役立ちます。" +"Pythonで `help()` を呼び出すと、例えば `help(add_numbers)` は関数のdocstringのテキストを表示します。 " +"このようにdocstringは、ユーザが自分のワークフローにより効果的に関数を適用する方法をよりよく理解するのに役立ちます。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:26 msgid "" "When you build your package's documentation, the docstrings can also be " -"used to automatically create full API documentation that provides a clean" -" view of all its functions, classes, methods, and attributes." +"used to automatically create full API documentation that provides a clean " +"view of all its functions, classes, methods, and attributes." msgstr "パッケージのドキュメントを作成するとき、docstringsを使用して、すべての関数、クラス、メソッド、属性をきれいに表示する完全なAPIドキュメントを自動的に作成することもできます。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:29 @@ -3309,8 +3379,8 @@ msgstr "パッケージ内のすべての関数、クラス、メソッド、属 #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:30 msgid "" -"[View example high-level API documentation for the Verde package. This " -"page lists every function and class in the package along with a brief " +"[View example high-level API documentation for the Verde package. This page" +" lists every function and class in the package along with a brief " "explanation of what it " "does](https://www.fatiando.org/verde/latest/api/index.html)" msgstr "" @@ -3319,8 +3389,8 @@ msgstr "" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:31 msgid "" -"[You can further dig down to see what a specific function does within the" -" package by clicking on an API " +"[You can further dig down to see what a specific function does within the " +"package by clicking on an API " "element](https://www.fatiando.org/verde/latest/api/generated/verde.grid_coordinates.html#verde.grid_coordinates)" msgstr "[APIエレメントをクリックすることで、パッケージ内で特定の関数が何を行っているかをさらに掘り下げて確認することができます](https://www.fatiando.org/verde/latest/api/generated/verde.grid_coordinates.html#verde.grid_coordinates)" @@ -3362,8 +3432,8 @@ msgstr "Pythonの3つのdocstringフォーマットとNumPyスタイルが好き #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:50 msgid "" -"There are several Python docstring formats that you can choose to use " -"when documenting your package including:" +"There are several Python docstring formats that you can choose to use when " +"documenting your package including:" msgstr "Pythonのdocstringフォーマットには、パッケージを文書化する際に使用できるものがいくつかあります:" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:53 @@ -3413,10 +3483,10 @@ msgstr "" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:63 msgid "" -"The Numpy style docstring is simplified and thus easier to read both in " -"the code and when calling `help()` in Python. In contrast, some feel that" -" reST style docstrings are harder to quickly scan, and can take up more " -"lines of code in modules." +"The Numpy style docstring is simplified and thus easier to read both in the" +" code and when calling `help()` in Python. In contrast, some feel that reST" +" style docstrings are harder to quickly scan, and can take up more lines of" +" code in modules." msgstr "" "Numpyスタイルのドキュメントストリングは単純化されているので、コード内でもPythonで `help()` " "を呼び出すときでも読みやすくなっています。 " @@ -3443,14 +3513,14 @@ msgstr "Docstringの例 Better と Best" msgid "" "Below is a good example of a well-documented function. Notice that this " "function's docstring describes the function's inputs and the function's " -"output (or return value). The initial description of the function is " -"short (one line). Following that single-line description, there is a " -"slightly longer description of what the function does (2 to 3 sentences)." -" The return of the function is also specified." +"output (or return value). The initial description of the function is short " +"(one line). Following that single-line description, there is a slightly " +"longer description of what the function does (2 to 3 sentences). The return" +" of the function is also specified." msgstr "" -"以下はよく文書化された関数の良い例です。 " -"この関数のdocstringには、関数の入力と出力（または戻り値）が記述されていることに注目してください。 関数の最初の説明は短いです（1行）。 " -"その1行の説明に続いて、関数が何をするのかについて少し長い説明があります（2～3文）。 関数の戻り値も指定されています。" +"以下はよく文書化された関数の良い例です。 この関数のdocstringには、関数の入力と出力（または戻り値）が記述されていることに注目してください。 " +"関数の最初の説明は短いです（1行）。 その1行の説明に続いて、関数が何をするのかについて少し長い説明があります（2～3文）。 " +"関数の戻り値も指定されています。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:107 msgid "Best: a docstring with example use of the function" @@ -3458,9 +3528,8 @@ msgstr "ベスト: 関数の使用例を記載したdocstring" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:109 msgid "" -"This example contains an example of using the function that is also " -"tested in sphinx using " -"[doctest](https://docs.python.org/3/library/doctest.html)." +"This example contains an example of using the function that is also tested " +"in sphinx using [doctest](https://docs.python.org/3/library/doctest.html)." msgstr "" "この例には、sphinxでも [doctest](https://docs.python.org/3/library/doctest.html) " "を使ってテストされている関数の使用例が含まれています。" @@ -3469,8 +3538,8 @@ msgstr "" msgid "" "Using the above NumPy format docstring in sphinx, the autodoc extension " "will create the about documentation section for the `extent_to_json` " -"function. The output of the `es.extent_to_json(rmnp)` command can even be" -" tested using doctest adding another quality check to your package." +"function. The output of the `es.extent_to_json(rmnp)` command can even be " +"tested using doctest adding another quality check to your package." msgstr "" "上記のNumPyフォーマットのdocstringをsphinxで使用すると、autodocエクステンションが `extent_to_json` " "関数のabout documentationセクションを作成します。 `es.extent_to_json(rmnp)` " @@ -3484,15 +3553,15 @@ msgstr "doctestを使って、パッケージのメソッドや関数でdocstrin #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:171 msgid "" -"Above, we provided some examples of good, better, best docstring formats." -" If you are using Sphinx to create your docs, you can add the " +"Above, we provided some examples of good, better, best docstring formats. " +"If you are using Sphinx to create your docs, you can add the " "[doctest](https://www.sphinx-" -"doc.org/en/master/usage/extensions/doctest.html) extension to your Sphinx" -" build. Doctest provides an additional check for docstrings with example " +"doc.org/en/master/usage/extensions/doctest.html) extension to your Sphinx " +"build. Doctest provides an additional check for docstrings with example " "code in them. Doctest runs the example code in your docstring `Examples` " -"checking that the expected output is correct. Similar to running " -"tutorials in your documentation, `doctest` can be a useful step that " -"assures that your package's code (API) runs as you expect it to." +"checking that the expected output is correct. Similar to running tutorials " +"in your documentation, `doctest` can be a useful step that assures that " +"your package's code (API) runs as you expect it to." msgstr "" "上記では、良いdocstringフォーマット、より良いdocstringフォーマット、ベストなdocstringフォーマットの例をいくつか紹介しました。" " もしSphinxを使ってドキュメントを作成しているのであれば、 [doctest](https://www.sphinx-" @@ -3504,13 +3573,12 @@ msgstr "" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:178 msgid "" -"It's important to keep in mind that examples in your docstrings help " -"users using your package. Running `doctest` on those examples provides a " -"check of your package's API. The doctest ensures that the functions and " -"methods in your package run as you expect them to. Neither of these items" -" replace a separate, stand-alone test suite that is designed to test your" -" package's core functionality across operating systems and Python " -"versions." +"It's important to keep in mind that examples in your docstrings help users " +"using your package. Running `doctest` on those examples provides a check of" +" your package's API. The doctest ensures that the functions and methods in " +"your package run as you expect them to. Neither of these items replace a " +"separate, stand-alone test suite that is designed to test your package's " +"core functionality across operating systems and Python versions." msgstr "" "docstrings にあるサンプルは、あなたのパッケージを使っているユーザーを 助けるものであるということを覚えておくことが重要です。 " "これらのサンプルに対して `doctest` を実行することで、パッケージの API をチェックすることができます。 " @@ -3520,8 +3588,8 @@ msgstr "" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:186 msgid "" "Below is an example of a docstring with an example. doctest will run the " -"example below and test that if you provide `add_me` with the values 1 and" -" 3 it will return 4." +"example below and test that if you provide `add_me` with the values 1 and 3" +" it will return 4." msgstr "doctestは以下の例を実行し、 `add_me` に1と3の値を与えると4が返されることをテストします。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:219 @@ -3530,12 +3598,11 @@ msgstr "docstringに型ヒントを追加する" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:221 msgid "" -"In the example above, you saw the use of numpy-style docstrings to " -"describe data types that are passed into functions as parameters or into " -"classes as attributes. In a numpy-style docstring you add those types in " -"the Parameters section of the docstring. Below you can see that the " -"parameter `num1` and `num2` should both be a Python `int` (integer) " -"value." +"In the example above, you saw the use of numpy-style docstrings to describe" +" data types that are passed into functions as parameters or into classes as" +" attributes. In a numpy-style docstring you add those types in the " +"Parameters section of the docstring. Below you can see that the parameter " +"`num1` and `num2` should both be a Python `int` (integer) value." msgstr "" "上の例では、パラメータとして関数に渡されるデータ型や、属性としてクラスに渡されるデータ型を記述するために、numpyスタイルのdocstringを使用することを見ました。" " numpyスタイルのdocstringでは、docstringのParametersセクションにそれらのデータ型を追加します。 " @@ -3543,15 +3610,15 @@ msgstr "" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:236 msgid "" -"Describing the expected data type that a function or method requires " -"helps users better understand how to call a function or method." +"Describing the expected data type that a function or method requires helps " +"users better understand how to call a function or method." msgstr "関数やメソッドが必要とするデータ型を記述することで、ユーザーが関数やメソッドの呼び出し方をより理解しやすくなります。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:239 msgid "" -"Type-hints add another layer of type documentation to your code. Type-" -"hints make it easier for new developers, your future self or contributors" -" to get to know your code base quickly." +"Type-hints add another layer of type documentation to your code. Type-hints" +" make it easier for new developers, your future self or contributors to get" +" to know your code base quickly." msgstr "" "型ヒントは、あなたのコードに型ドキュメントの別のレイヤーを追加します。 " "型ヒントは、新しい開発者や将来の自分、あるいは貢献者が、あなたのコードベースについて素早く知ることを容易にします。" @@ -3565,8 +3632,8 @@ msgstr "型のヒントは関数の定義に追加されます。 以下の例 #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:250 msgid "" -"You can further describe the expected function output using `->`. Below " -"the output of the function is also an int." +"You can further describe the expected function output using `->`. Below the" +" output of the function is also an int." msgstr "さらに `->` を使って、期待される関数の出力を記述することができます。以下の関数の出力も int です。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:258 @@ -3623,9 +3690,9 @@ msgstr "コードに型ヒントを追加する際には、場合によっては #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:277 msgid "" -"If you have a complex code base, type hints may make code more difficult " -"to read. This is especially true when a parameter’s input takes multiple " -"data types and you list each one." +"If you have a complex code base, type hints may make code more difficult to" +" read. This is especially true when a parameter’s input takes multiple data" +" types and you list each one." msgstr "" "複雑なコードベースを持っている場合、型ヒントはコードを読みにくくする可能性がある。 " "パラメーターの入力が複数のデータ型を取り、それぞれをリストアップする場合は特にそうだ。" @@ -3642,15 +3709,15 @@ msgstr "型ヒントを徐々に追加" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:283 msgid "" -"Adding type hints can take a lot of time. However, you can add type hints" -" incrementally as you work on your code." +"Adding type hints can take a lot of time. However, you can add type hints " +"incrementally as you work on your code." msgstr "型ヒントの追加には多くの時間がかかります。 しかし、コードを書きながら少しずつ型ヒントを追加していくことができます。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:287 msgid "" -"Adding type hints is also a great task for new contributors. It will help" -" them get to know your package's code and structure better before digging" -" into more complex contributions." +"Adding type hints is also a great task for new contributors. It will help " +"them get to know your package's code and structure better before digging " +"into more complex contributions." msgstr "" "型ヒントを追加することは、新しい貢献者にとっても素晴らしい作業です。 " "より複雑な貢献をする前に、あなたのパッケージのコードと構造をよりよく知ることができます。" @@ -3671,9 +3738,9 @@ msgstr "以下では、ドキュメントを2つのタイプに大別します msgid "" "**User-facing documentation** refers to documentation that describes the " "way the tools within a package are broadly used in workflows. **API " -"documentation** refers to documentation of functions, classes, methods, " -"and attributes in your code and is written at a more granular level. This" -" documentation is what a user sees when they type `help(function-name)`." +"documentation** refers to documentation of functions, classes, methods, and" +" attributes in your code and is written at a more granular level. This " +"documentation is what a user sees when they type `help(function-name)`." msgstr "" "**ユーザー向け文書** は、パッケージ内のツールがワークフローで広く使用される方法を説明する文書を指します。 **APIドキュメント** " "は、コード内の関数、クラス、メソッド、属性のドキュメントを指し、より細かいレベルで書かれています。 このドキュメントは、ユーザーが `help" @@ -3687,9 +3754,9 @@ msgstr "Pythonパッケージのユーザー向けドキュメントには、い #: ../../documentation/write-user-documentation/get-started.md:26 msgid "" -"**Documentation Website:** This refers to easy-to-read documentation that" -" helps someone use your package. This documentation should help users " -"both install and use your package." +"**Documentation Website:** This refers to easy-to-read documentation that " +"helps someone use your package. This documentation should help users both " +"install and use your package." msgstr "" "**ドキュメントウェブサイト:** これは、誰かがあなたのパッケージを使うのを助ける、読みやすいドキュメンテーションのことです。 " "このドキュメンテーションは、ユーザがあなたのパッケージをインストールし、使うのを助けるものでなければなりません。" @@ -3717,9 +3784,8 @@ msgstr "" "**パッケージコード/APIドキュメント:** パッケージの関数、クラス、メソッド、属性（API）もドキュメント化されるべきです。 " "APIドキュメントは、あなたのコードにある " "[docstrings](https://pandas.pydata.org/docs/development/contributing_docstring.html)" -" から生成することができます。 " -"理想的には、Pythonパッケージ内のすべてのユーザー向けの関数、クラス、メソッドのdocstringがあることです。 " -"[コードドキュメンテーションとdocstringについてはこちらで詳しく説明します。](document-your-code-api-" +" から生成することができます。 理想的には、Pythonパッケージ内のすべてのユーザー向けの関数、クラス、メソッドのdocstringがあることです。" +" [コードドキュメンテーションとdocstringについてはこちらで詳しく説明します。](document-your-code-api-" "docstrings)" #: ../../documentation/write-user-documentation/get-started.md:32 @@ -3729,9 +3795,9 @@ msgstr "使いやすい文書を書く" #: ../../documentation/write-user-documentation/get-started.md:34 msgid "" "User-facing documentation should be published on a easy-to-navigate " -"website. The documentation should be written keeping in mind that users " -"may not be developers or expert-level programmers. Rather, the language " -"that you use in your documentation should not be highly technical." +"website. The documentation should be written keeping in mind that users may" +" not be developers or expert-level programmers. Rather, the language that " +"you use in your documentation should not be highly technical." msgstr "" "ユーザー向けのドキュメントは、閲覧しやすいウェブサイトで公開されるべきである。 " "ドキュメントは、ユーザーが開発者や専門家レベルのプログラマーではないことを念頭に置いて書かれるべきです。 " @@ -3763,34 +3829,30 @@ msgstr "優れたオープンソース・ドキュメントのランディング #: ../../documentation/write-user-documentation/get-started.md:48 msgid "" -"To make it easy for users to find what they need quickly, consider adding" -" quick links on your package's landing page to the following elements:" +"To make it easy for users to find what they need quickly, consider adding " +"quick links on your package's landing page to the following elements:" msgstr "ユーザーが必要なものをすぐに見つけられるように、パッケージのランディングページに以下の要素へのクイックリンクを追加することを検討してください:" #: ../../documentation/write-user-documentation/get-started.md:52 msgid "" "**Getting started:** This section should provide the user with a quick " "start for installing your package. A small example of how to use the " -"package is good to have here as well. Or you can link to useful tutorials" -" in the get started section." +"package is good to have here as well. Or you can link to useful tutorials " +"in the get started section." msgstr "" -"**Getting started:** このセクションは、あなたのパッケージをインストールするためのクイックスタート " -"をユーザーに提供するものです。 パッケージの使い方の小さな例もここにあると良いでしょう。 " -"または、便利なチュートリアルへのリンクを、スタートセクションに置くこともできます。" +"**Getting started:** このセクションは、あなたのパッケージをインストールするためのクイックスタート をユーザーに提供するものです。" +" パッケージの使い方の小さな例もここにあると良いでしょう。 または、便利なチュートリアルへのリンクを、スタートセクションに置くこともできます。" #: ../../documentation/write-user-documentation/get-started.md:53 -msgid "" -"**About:** Describe your project, stating its goals and its " -"functionality." +msgid "**About:** Describe your project, stating its goals and its functionality." msgstr "**About:** プロジェクトについて、その目標と機能を説明してください。" #: ../../documentation/write-user-documentation/get-started.md:54 msgid "" -"**Community:** Instructions for how to help and/or get involved. This " -"might include links to your issues (if that is where you let users ask " -"questions) or the discussion part of your GitHub repo. This section might" -" include a development guide for those who might contribute to your " -"package." +"**Community:** Instructions for how to help and/or get involved. This might" +" include links to your issues (if that is where you let users ask " +"questions) or the discussion part of your GitHub repo. This section might " +"include a development guide for those who might contribute to your package." msgstr "" "**Community:** どのように手伝ったり、参加したりするかについての説明。 このセクションには、issue " "(ユーザーに質問できるようにしている場合) や GitHub リポジトリのディスカッションへのリンクが含まれます。 " @@ -3798,10 +3860,10 @@ msgstr "" #: ../../documentation/write-user-documentation/get-started.md:55 msgid "" -"**API Documentation:** This is the detailed project documentation. Here " -"you store documentation for your package's API including all user-facing " -"functions, classes, methods, and attributes as well as any additional " -"high level discussion that will help people use your package." +"**API Documentation:** This is the detailed project documentation. Here you" +" store documentation for your package's API including all user-facing " +"functions, classes, methods, and attributes as well as any additional high " +"level discussion that will help people use your package." msgstr "" "**APIドキュメント:** これはプロジェクトの詳細なドキュメントです。 " "ここには、ユーザー向けの関数、クラス、メソッド、属性、およびパッケージの使用に役立つ追加的な高レベルのディスカッションを含む、パッケージのAPIのドキュメントを保存します。" @@ -3817,9 +3879,9 @@ msgstr "" #: ../../documentation/write-user-documentation/get-started.md:64 msgid "" -"The documentation landing page of GeoPandas, a spatial Python library, " -"has the 4 element specified above. Notice that the landing page is simple" -" and directs users to each element using a Sphinx card." +"The documentation landing page of GeoPandas, a spatial Python library, has " +"the 4 element specified above. Notice that the landing page is simple and " +"directs users to each element using a Sphinx card." msgstr "" "空間的なPythonライブラリであるGeoPandasのドキュメントのランディングページには、上記の4つの要素が指定されています。 " "ランディングページはシンプルで、Sphinxカードを使って各要素にユーザーを誘導していることに注目してください。" @@ -3864,8 +3926,8 @@ msgstr "ここでは、ドキュメンテーションを容易にするために #: ../../documentation/write-user-documentation/intro.md:13 msgid "" -"autodoc to automagically populate documentation for your code's " -"functions, classes, methods and attributes (API documentation) and" +"autodoc to automagically populate documentation for your code's functions, " +"classes, methods and attributes (API documentation) and" msgstr "autodocは、あなたのコードの関数、クラス、メソッド、属性（APIドキュメント）のドキュメントを自動生成します。" #: ../../documentation/write-user-documentation/intro.md:15 diff --git a/locales/ja/LC_MESSAGES/index.po b/locales/ja/LC_MESSAGES/index.po index 0da6c785..47c4dc69 100644 --- a/locales/ja/LC_MESSAGES/index.po +++ b/locales/ja/LC_MESSAGES/index.po @@ -102,11 +102,11 @@ msgstr "このガイドについて" msgid "" "Image with the pyOpenSci flower logo in the upper right hand corner. The " "image shows the packaging lifecycle. The graphic shows a high level " -"overview of the elements of a Python package. The inside circle has 5 " -"items - user documentation, code/api, test suite, contributor " -"documentation, project metadata / license / readme. In the middle of the " -"circle is says maintainers and has a small icon with people. On the " -"outside circle there is an arrow and it says infrastructure." +"overview of the elements of a Python package. The inside circle has 5 items" +" - user documentation, code/api, test suite, contributor documentation, " +"project metadata / license / readme. In the middle of the circle is says " +"maintainers and has a small icon with people. On the outside circle there " +"is an arrow and it says infrastructure." msgstr "" "右上にpyOpenSciの花のロゴがある画像。画像はパッケージングのライフサイクルを示しています。図にはPythonパッケージの要素のハイレベルな概要が示されています。内側の円には5つの項目があります" " - " @@ -177,10 +177,10 @@ msgstr "_new_ チュートリアルシリーズ: Pythonパッケージの作成" #: ../../index.md:61 msgid "" -"The first round of our community-developed, how to create a Python " -"package tutorial series for scientists is complete! Join our community " -"review process or watch development of future tutorials in our [GitHub " -"repo here](https://github.com/pyOpenSci/python-package-guide)." +"The first round of our community-developed, how to create a Python package " +"tutorial series for scientists is complete! Join our community review " +"process or watch development of future tutorials in our [GitHub repo " +"here](https://github.com/pyOpenSci/python-package-guide)." msgstr "" "コミュニティが開発した、科学者のためのPythonパッケージの作り方チュートリアルシリーズの第一弾が完成しました！ " "コミュニティのレビュープロセスに参加したり、 [GitHub リポジトリはこちら](https://github.com/pyOpenSci" @@ -219,9 +219,7 @@ msgstr "[READMEファイルの追加方法](/tutorials/add-readme)" msgid "" "[How to add metadata to a pyproject.toml file for publication to " "PyPI.](/tutorials/pyproject-toml.md)" -msgstr "" -"[PyPIに公開するためにpyproject.tomlファイルにメタデータを追加する方法](/tutorials/pyproject-" -"toml.md)" +msgstr "[PyPIに公開するためにpyproject.tomlファイルにメタデータを追加する方法](/tutorials/pyproject-toml.md)" #: ../../index.md:86 msgid "✿ Packaging Tool Tutorials ✿" @@ -250,9 +248,9 @@ msgstr "科学者のためのPythonパッケージング" #: ../../index.md:104 msgid "" -"Learn about Python packaging best practices. You will also get to know " -"the the vibrant ecosystem of packaging tools that are available to help " -"you with your Python packaging needs." +"Learn about Python packaging best practices. You will also get to know the " +"the vibrant ecosystem of packaging tools that are available to help you " +"with your Python packaging needs." msgstr "" "Python のパッケージングのベストプラクティスについて学びます。 また、Python " "のパッケージングを支援するために利用可能なパッケージングツールの活発なエコシステムを知ることができます。" @@ -267,16 +265,16 @@ msgstr "[パッケージファイル構造](/package-structure-code/python-packa #: ../../index.md:116 msgid "" -"[Package metadata / pyproject.toml](package-structure-code/pyproject-" -"toml-python-package-metadata.md)" -msgstr "" -"[パッケージメタデータ / pyproject.toml](package-structure-code/pyproject-toml-" +"[Package metadata / pyproject.toml](package-structure-code/pyproject-toml-" "python-package-metadata.md)" +msgstr "" +"[パッケージメタデータ / pyproject.toml](package-structure-code/pyproject-toml-python-" +"package-metadata.md)" #: ../../index.md:117 msgid "" -"[Build your package (sdist / wheel)](package-structure-code/python-" -"package-distribution-files-sdist-wheel.md)" +"[Build your package (sdist / wheel)](package-structure-code/python-package-" +"distribution-files-sdist-wheel.md)" msgstr "" "[パッケージのビルド (sdist / wheel)](package-structure-code/python-package-" "distribution-files-sdist-wheel.md)" @@ -297,9 +295,7 @@ msgstr "" msgid "" "[Non pure Python builds](package-structure-code/complex-python-package-" "builds.md)" -msgstr "" -"[純粋な Python 以外のビルド](package-structure-code/complex-python-package-" -"builds.md)" +msgstr "[純粋な Python 以外のビルド](package-structure-code/complex-python-package-builds.md)" #: ../../index.md:123 msgid "✨ Publish your package ✨" @@ -307,8 +303,8 @@ msgstr "✨パッケージを公開する✨" #: ../../index.md:127 msgid "" -"Gain a better understanding of the Python packaging ecosystem Learn about" -" best practices for:" +"Gain a better understanding of the Python packaging ecosystem Learn about " +"best practices for:" msgstr "Pythonのパッケージングエコシステムをより深く理解するためのベストプラクティスを学ぶ:" #: ../../index.md:130 @@ -322,8 +318,8 @@ msgid "" "[Publish to PyPI & Conda-forge](/package-structure-code/publish-python-" "package-pypi-conda.md)" msgstr "" -"[PyPIとConda-forgeへの公開](/package-structure-code/publish-python-package-" -"pypi-conda.md)" +"[PyPIとConda-forgeへの公開](/package-structure-code/publish-python-package-pypi-" +"conda.md)" #: ../../index.md:142 msgid "✨ Write The Docs ✨" @@ -373,14 +369,12 @@ msgstr "✨コミュニティのためのドキュメント✨" msgid "" "[Writing a README file](/documentation/repository-files/readme-file-best-" "practices)" -msgstr "" -"[READMEファイルの書き方](/documentation/repository-files/readme-file-best-" -"practices)" +msgstr "[READMEファイルの書き方](/documentation/repository-files/readme-file-best-practices)" #: ../../index.md:161 msgid "" -"[Set norms with a Code of Conduct](/documentation/repository-files/code-" -"of-conduct-file)" +"[Set norms with a Code of Conduct](/documentation/repository-files/code-of-" +"conduct-file)" msgstr "[行動規範で規範を定める](/documentation/repository-files/code-of-conduct-file)" #: ../../index.md:162 @@ -401,19 +395,19 @@ msgstr "[Sphinxを使う](/documentation/hosting-tools/intro)" #: ../../index.md:170 msgid "" -"[Markdown, MyST, and ReST](/documentation/hosting-tools/myst-markdown-" -"rst-doc-syntax)" -msgstr "" -"[Markdown、MyST、およびReST](/documentation/hosting-tools/myst-markdown-rst-" +"[Markdown, MyST, and ReST](/documentation/hosting-tools/myst-markdown-rst-" "doc-syntax)" +msgstr "" +"[Markdown、MyST、およびReST](/documentation/hosting-tools/myst-markdown-rst-doc-" +"syntax)" #: ../../index.md:171 msgid "" "[Host your docs on Read The Docs or GitHub Pages](/documentation/hosting-" "tools/publish-documentation-online)" msgstr "" -"[Read The Docs または GitHub Pages でドキュメントをホストする](/documentation/hosting-" -"tools/publish-documentation-online)" +"[Read The Docs または GitHub Pages でドキュメントをホストする](/documentation/hosting-tools" +"/publish-documentation-online)" #: ../../index.md:181 msgid "✨ Tests for your Python package ✨" @@ -473,7 +467,7 @@ msgstr "このガイドへのご貢献をお待ちしております。貢献方 #: ../../index.md:221 msgid "A group of people building a pyramid with blocks" -msgstr "" +msgstr "ブロックでピラミッドを構築する人々のグループ" #: ../../index.md:227 msgid "A community-created guidebook" @@ -482,9 +476,9 @@ msgstr "コミュニティが作るガイドブック" #: ../../index.md:229 msgid "" "Every page in this guidebook goes through an extensive community review " -"process. To ensure our guidebook is both beginner-friendly and accurate, " -"we encourage reviews from a diverse set of pythonistas and scientists " -"with a wide range of skills and expertise." +"process. To ensure our guidebook is both beginner-friendly and accurate, we" +" encourage reviews from a diverse set of pythonistas and scientists with a " +"wide range of skills and expertise." msgstr "" "このガイドブックのすべてのページは、コミュニティの広範なレビュープロセスを経ています。 " "このガイドブックが初心者にやさしく、正確であることを保証するために、私たちは幅広いスキルと専門知識を持つ多様なpythonistaや科学者からのレビューを奨励しています。" @@ -509,14 +503,14 @@ msgstr "Pythonパッケージの作成に関する初歩から終わりまでの #: ../../index.md:245 msgid "" -"Resources to help you navigate the Python packaging ecosystem of tools " -"and approaches to packaging." +"Resources to help you navigate the Python packaging ecosystem of tools and " +"approaches to packaging." msgstr "Python のパッケージングエコシステムをナビゲートするのに役立つリソースです。" #: ../../index.md:246 msgid "" -"A curated list of resources to help you get your package into documented," -" usable and maintainable shape." +"A curated list of resources to help you get your package into documented, " +"usable and maintainable shape." msgstr "あなたのパッケージが文書化され、使用可能で保守可能な形になるのを助けるリソースの厳選されたリストです。" #: ../../index.md:248 @@ -525,13 +519,12 @@ msgstr "このガイドの方向性" #: ../../index.md:250 msgid "" -"If you have ideas of things you'd like to see here clarified in this " -"guide, [we invite you to open an issue on " -"GitHub.](https://github.com/pyOpenSci/python-package-guide/issues)." +"If you have ideas of things you'd like to see here clarified in this guide," +" [we invite you to open an issue on GitHub.](https://github.com/pyOpenSci" +"/python-package-guide/issues)." msgstr "" -"このガイドで明確にしてほしいことがあれば、 " -"[GitHubにissueを開いてください。](https://github.com/pyOpenSci/python-package-" -"guide/issues) 。" +"このガイドで明確にしてほしいことがあれば、 [GitHubにissueを開いてください。](https://github.com/pyOpenSci" +"/python-package-guide/issues) 。" #: ../../index.md:253 #, fuzzy @@ -545,8 +538,8 @@ msgstr "" #: ../../index.md:255 msgid "" -"This living Python packaging guide is updated as tools and best practices" -" evolve in the Python packaging ecosystem. We will be adding new content " +"This living Python packaging guide is updated as tools and best practices " +"evolve in the Python packaging ecosystem. We will be adding new content " "over the next year." msgstr "" "これは Python のパッケージングエコシステムにおけるツールやベストプラクティスの進化に合わせて更新されるこの生きた Python " @@ -565,33 +558,32 @@ msgstr "" #~ "guide)*" #~ msgid "" -#~ "xkcd comic showing a stick figure " -#~ "on the ground and one in the " -#~ "air. The one on the ground is " -#~ "saying. `You're flying! how?` The " -#~ "person in the air replies `Python!` " -#~ "Below is a 3 rectangle comic with" -#~ " the following text in each box. " -#~ "Box 1 - I learned it last " -#~ "night. Everything is so simple. Hello" -#~ " world is just print hello world. " -#~ "Box 2 - the person on the " -#~ "ground says - come join us " -#~ "programming is fun again. It's a " -#~ "whole new world. But how are you" -#~ " flying? box 3 - the person " -#~ "flying says - i just typed import" -#~ " antigravity. I also sampled everything " -#~ "in the medicine cabinet. But i " -#~ "think this is the python. The " -#~ "person on the ground is saying -" -#~ " that's it?" +#~ "xkcd comic showing a stick figure on" +#~ " the ground and one in the air." +#~ " The one on the ground is saying." +#~ " `You're flying! how?` The person in" +#~ " the air replies `Python!` Below is" +#~ " a 3 rectangle comic with the " +#~ "following text in each box. Box 1" +#~ " - I learned it last night. " +#~ "Everything is so simple. Hello world " +#~ "is just print hello world. Box 2 " +#~ "- the person on the ground says " +#~ "- come join us programming is fun" +#~ " again. It's a whole new world. " +#~ "But how are you flying? box 3 " +#~ "- the person flying says - i " +#~ "just typed import antigravity. I also " +#~ "sampled everything in the medicine " +#~ "cabinet. But i think this is the " +#~ "python. The person on the ground is" +#~ " saying - that's it?" #~ msgstr "" #~ "xkcdの漫画で、地面に置かれた棒人間と空中にある棒人間が描かれている。地上にいる人が言っている。 " #~ "`あなたは飛んでいる！どうやって？` 空中にいる人は `Python!` " #~ "と答える。以下は3つの長方形のマンガで、各ボックスに次のテキストが入っている。ボックス1 - " #~ "昨夜学んだ。すべてがとてもシンプルだ。Hello worldはprint hello " -#~ "worldだけ。ボックス2 - 地上にいる人が言う。まったく新しい世界だ。でもどうやって飛んでるの？ボックス3" -#~ " - 飛んでいる人はこう言う。- " +#~ "worldだけ。ボックス2 - 地上にいる人が言う。まったく新しい世界だ。でもどうやって飛んでるの？ボックス3 " +#~ "- 飛んでいる人はこう言う。- " #~ "`反重力をインポートしました。薬箱の中のものも全部試しました。でもこれがpythonだと思う。地上の人はこう言っている。- " #~ "これで終わり？" diff --git a/locales/ja/LC_MESSAGES/maintain-automate.po b/locales/ja/LC_MESSAGES/maintain-automate.po index a9968dfd..415c9d16 100644 --- a/locales/ja/LC_MESSAGES/maintain-automate.po +++ b/locales/ja/LC_MESSAGES/maintain-automate.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: pyOpenSci Python Package Guide \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-18 12:56-0700\n" +"POT-Creation-Date: 2026-08-25 07:47+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: ja\n" @@ -21,81 +21,87 @@ msgstr "" "Generated-By: Babel 2.18.0\n" #: ../../maintain-automate/ci.md:2 -msgid "" -"Continuous Integration and Continuous Deployment (CI/CD) For Python " -"Packages" -msgstr "" +msgid "Continuous Integration and Continuous Deployment (CI/CD) For Python Packages" +msgstr "Python パッケージの継続的インテグレーションと継続的デプロイ (CI/CD)" #: ../../maintain-automate/ci.md:4 msgid "" "When you develop, work on, and contribute to software, there is more to " -"consider than just writing code. Having tests and checks ensures that " -"your code runs reliably and follows a consistent format is also " -"important. You can use **Continuous Integration (CI)** and **Continuous " -"Deployment (CD)** to run tests and checks on your code every time someone" -" suggests a change online in a platform like GitHub or GitLab." +"consider than just writing code. Having tests and checks ensures that your " +"code runs reliably and follows a consistent format is also important. You " +"can use **Continuous Integration (CI)** and **Continuous Deployment (CD)** " +"to run tests and checks on your code every time someone suggests a change " +"online in a platform like GitHub or GitLab." msgstr "" +"ソフトウェアを開発し、取り組み、貢献するときは、コードを書くこと以外にも考慮すべきことがあります。テストとチェックを行うことで、コードが確実に実行され、一貫した形式に従っていることを確認することも重要です。" +" **継続的インテグレーション (CI)** と **継続的デプロイ (CD)** を使用すると、GitHub や GitLab " +"などのプラットフォームで誰かがオンラインで変更を提案するたびに、コードのテストとチェックを実行できます。" #: ../../maintain-automate/ci.md:12 msgid "" "**Continuous Integration (CI):** Automates the process of running tests, " "code checks, and other workflows each time code is updated." -msgstr "" +msgstr "**継続的インテグレーション (CI):** コードが更新されるたびに、テスト、コード チェック、その他のワークフローを実行するプロセスを自動化します。" #: ../../maintain-automate/ci.md:14 msgid "" "**Continuous Deployment (CD):** Extends CI by allowing you to automate " "publishing your package to PyPI, publishing your documentation, and more." -msgstr "" +msgstr "**継続的デプロイメント (CD):** PyPI へのパッケージの公開、ドキュメントの公開などを自動化できるようにすることで、CI を拡張します。" #: ../../maintain-automate/ci.md:18 msgid "" "CI and CD streamline software development by automating repetitive tasks " "and ensuring code quality and consistency. Having CI setup also makes it " -"easier for new contributors to contribute to your code base without " -"setting up all your test suites and other local checks." +"easier for new contributors to contribute to your code base without setting" +" up all your test suites and other local checks." msgstr "" +"CI と CD は、反復的なタスクを自動化し、コードの品質と一貫性を確保することにより、ソフトウェア開発を合理化します。 CI " +"をセットアップすると、すべてのテスト スイートやその他のローカル チェックをセットアップしなくても、新しいコントリビューターがコード " +"ベースに簡単にコントリビュートできるようになります。" #: ../../maintain-automate/ci.md:23 msgid "What is continuous integration?" -msgstr "" +msgstr "継続的インテグレーションとは何ですか?" #: ../../maintain-automate/ci.md:25 msgid "" "When you're ready to publish your code online, you can set up Continuous " -"Integration (CI). CI is a platform that allows you to specify and run " -"jobs or workflows you define. These workflows include:" +"Integration (CI). CI is a platform that allows you to specify and run jobs " +"or workflows you define. These workflows include:" msgstr "" +"コードをオンラインで公開する準備ができたら、継続的インテグレーション (CI) をセットアップできます。 CI " +"は、定義したジョブやワークフローを指定して実行できるプラットフォームです。これらのワークフローには次のものが含まれます。" #: ../../maintain-automate/ci.md:28 msgid "Running your test suite" -msgstr "" +msgstr "テストスイートを実行する" #: ../../maintain-automate/ci.md:29 msgid "Running code checkers / linters / spellcheck" -msgstr "" +msgstr "コードチェッカー/リンター/スペルチェックの実行" #: ../../maintain-automate/ci.md:30 msgid "Building your documentation" -msgstr "" +msgstr "ドキュメントを作成する" #: ../../maintain-automate/ci.md:32 msgid "" -"CI allows you to automate running workflows across a suite of " -"environments, including:" -msgstr "" +"CI allows you to automate running workflows across a suite of environments," +" including:" +msgstr "CI を使用すると、次のような一連の環境全体で実行中のワークフローを自動化できます。" #: ../../maintain-automate/ci.md:34 msgid "environments containing different Python versions and" -msgstr "" +msgstr "異なる Python バージョンが含まれる環境と、" #: ../../maintain-automate/ci.md:35 msgid "different operating systems (Mac, Linux, Windows)." -msgstr "" +msgstr "さまざまなオペレーティング システム (Mac、Linux、Windows)。" #: ../../maintain-automate/ci.md:37 msgid "What is continuous deployment (CD)?" -msgstr "" +msgstr "継続的展開 (CD) とは何ですか?" #: ../../maintain-automate/ci.md:39 msgid "" @@ -103,39 +109,43 @@ msgid "" "deployment of code changes to production or staging environments. In the " "case of your open source tool, CD can be used to:" msgstr "" +"継続的デプロイメント (CD) は、実稼働環境またはステージング環境へのコード変更のデプロイメントを自動化することで、CI " +"プロセスを拡張します。オープンソース ツールの場合、CD は次の目的で使用できます。" #: ../../maintain-automate/ci.md:41 msgid "Automate publishing to PyPI" -msgstr "" +msgstr "PyPI へのパブリッシュを自動化する" #: ../../maintain-automate/ci.md:42 msgid "Automate publishing your documentation to GitHub Pages or Read the Docs." -msgstr "" +msgstr "GitHub Pages へのドキュメントの公開を自動化するか、ドキュメントを読んでください。" #: ../../maintain-automate/ci.md:44 msgid "" -"It is also used once your conda-forge recipe is set up to keep your " -"package up to date on conda-forge." -msgstr "" +"It is also used once your conda-forge recipe is set up to keep your package" +" up to date on conda-forge." +msgstr "これは、conda-forge レシピが設定された後、conda-forge 上でパッケージを最新の状態に保つためにも使用されます。" #: ../../maintain-automate/ci.md:47 msgid "Why use CI?" -msgstr "" +msgstr "CI を使用する理由" #: ../../maintain-automate/ci.md:49 msgid "" -"CI can be configured to run a workflow on every commit pushed to GitHub " -"and every pull request opened. This ensures that any changes made to your" -" package are tested across environments before merging into the main " -"branch of your code." +"CI can be configured to run a workflow on every commit pushed to GitHub and" +" every pull request opened. This ensures that any changes made to your " +"package are tested across environments before merging into the main branch " +"of your code." msgstr "" +"GitHub にプッシュされたすべてのコミットと開かれたすべてのプル リクエストでワークフローを実行するように CI " +"を構成できます。これにより、コードのメイン ブランチにマージする前に、パッケージに加えられた変更が環境全体でテストされるようになります。" #: ../../maintain-automate/ci.md:54 msgid "" -"These checks are particularly useful if someone new is contributing to " -"your code. Every contributor's change will be tested when pushed to your " -"code repository." -msgstr "" +"These checks are particularly useful if someone new is contributing to your" +" code. Every contributor's change will be tested when pushed to your code " +"repository." +msgstr "これらのチェックは、新しい人がコードに貢献している場合に特に役立ちます。すべての投稿者の変更は、コード リポジトリにプッシュされるときにテストされます。" #: ../../maintain-automate/ci.md:58 msgid "" @@ -143,68 +153,86 @@ msgid "" "deploying code. They aim to improve software development and publication " "efficiency, quality, and reliability." msgstr "" +"CI と CD " +"を併用すると、コードの構築、テスト、デプロイのプロセスが合理化されます。ソフトウェア開発と公開の効率、品質、信頼性を向上させることを目指しています。" #: ../../maintain-automate/ci.md:63 msgid "" -"All pyOpenSci packages must use some form of continuous integration. Even" -" if you are not planning to go through peer review, we strongly recommend" -" that you use continuous integration, too!" +"All pyOpenSci packages must use some form of continuous integration. Even " +"if you are not planning to go through peer review, we strongly recommend " +"that you use continuous integration, too!" msgstr "" +"すべての pyOpenSci " +"パッケージは、何らかの形式の継続的統合を使用する必要があります。ピアレビューを受ける予定がない場合でも、継続的インテグレーションを使用することを強くお勧めします。" #: ../../maintain-automate/ci.md:68 msgid "" -"In the case of GitHub actions (which we will focus on here), CI workflows" -" are running on online servers that support GitHub." +"In the case of GitHub actions (which we will focus on here), CI workflows " +"are running on online servers that support GitHub." msgstr "" +"GitHub アクション (ここではこれに焦点を当てます) の場合、CI ワークフローは GitHub をサポートするオンライン " +"サーバー上で実行されます。" #: ../../maintain-automate/ci.md:71 msgid "CI/CD platforms" -msgstr "" +msgstr "CI/CD プラットフォーム" #: ../../maintain-automate/ci.md:73 msgid "" "There are numerous platforms available for CI/CD. Here, we will focus on " -"GitHub Actions (GHA), built into GitHub. GitHub is the most commonly used" -" platform to store scientific open-source software." +"GitHub Actions (GHA), built into GitHub. GitHub is the most commonly used " +"platform to store scientific open-source software." msgstr "" +"CI/CD に利用できるプラットフォームは多数あります。ここでは、GitHub に組み込まれている GitHub Actions (GHA) " +"に焦点を当てます。 GitHub は、科学的なオープンソース ソフトウェアを保存するために最も一般的に使用されているプラットフォームです。" #: ../../maintain-automate/ci.md:78 msgid "" "If you use [GitLab](https://about.gitlab.com/) CI/CD, many of the " -"principles described here will apply. However, the workflow files may " -"look different." +"principles described here will apply. However, the workflow files may look " +"different." msgstr "" +"[GitLab](https://about.gitlab.com/) CI/CD " +"を使用する場合、ここで説明されている原則の多くが適用されます。ただし、ワークフロー ファイルは異なる場合があります。" #: ../../maintain-automate/ci.md:83 msgid "If you aren't sure, use GitHub Actions" -msgstr "" +msgstr "よくわからない場合は、GitHub Actions を使用してください" #: ../../maintain-automate/ci.md:85 msgid "" "While you are welcome to use the continuous integration platform of your " "choice, we recommend GitHub Actions because it is free-to-use and " -"integrated tightly into the GitHub user interface. There is also an " -"entire store of GitHub action templates that you can easily use and adapt" -" to your own needs." +"integrated tightly into the GitHub user interface. There is also an entire " +"store of GitHub action templates that you can easily use and adapt to your " +"own needs." msgstr "" +"お好みの継続的統合プラットフォームを使用することは歓迎ですが、無料で使用でき、GitHub ユーザー インターフェイスに緊密に統合されている " +"GitHub Actions をお勧めします。また、簡単に使用して独自のニーズに適応できる GitHub アクション " +"テンプレートのストア全体もあります。" #: ../../maintain-automate/ci.md:91 msgid "Other platforms that you may run into" -msgstr "" +msgstr "遭遇する可能性のあるその他のプラットフォーム" #: ../../maintain-automate/ci.md:94 msgid "" -"[Appveyor:](https://www.appveyor.com/): Supports running tests on Windows" -" operating systems and predated the release of GitHub Actions. Today, " +"[Appveyor:](https://www.appveyor.com/): Supports running tests on Windows " +"operating systems and predated the release of GitHub Actions. Today, " "AppVeyor supports operating systems beyond Windows." msgstr "" +"[Appveyor:](https://www.appveyor.com/): Windows オペレーティング " +"システムでのテストの実行をサポートしており、GitHub Actions のリリースより前から提供されていました。現在、AppVeyor は " +"Windows 以外のオペレーティング システムもサポートしています。" #: ../../maintain-automate/ci.md:97 msgid "" "[Travis CI:](https://www.travis-ci.com/) had been a common CI platform " -"choice in our ecosystem. Usage dropped after Travis CI ended free support" -" for open-source projects." +"choice in our ecosystem. Usage dropped after Travis CI ended free support " +"for open-source projects." msgstr "" +"[Travis CI:](https://www.travis-ci.com/) は、私たちのエコシステムでは一般的な CI " +"プラットフォームの選択肢でした。 Travis CI がオープンソース プロジェクトの無料サポートを終了した後、使用量は減少しました。" #: ../../maintain-automate/ci.md:100 msgid "" @@ -212,62 +240,293 @@ msgid "" "builds of websites and documentation since it offers a preview of the PR " "changes." msgstr "" +"[CircleCI:](https://circleci.com/) CircleCI は PR 変更のプレビューを提供するため、Web " +"サイトやドキュメントの自動構築に役立ちます。" #: ../../maintain-automate/ci.md:105 msgid "Embrace automation" -msgstr "" +msgstr "自動化を採用する" #: ../../maintain-automate/ci.md:107 msgid "" -"By embracing CI/CD, you can ensure that your code runs as you expect it " -"to across the diverse landscapes of user environments. Further, you can " -"automate certain checks (and, in some cases, code fixes), including " -"linting and code style. You can even automate spell-checking your " -"documentation and docstrings!" +"By embracing CI/CD, you can ensure that your code runs as you expect it to " +"across the diverse landscapes of user environments. Further, you can " +"automate certain checks (and, in some cases, code fixes), including linting" +" and code style. You can even automate spell-checking your documentation " +"and docstrings!" +msgstr "" +"CI/CD を採用することで、ユーザー環境の多様な環境にわたってコードが期待どおりに実行されることを保証できます。さらに、リンティングやコード " +"スタイルなどの特定のチェック (場合によってはコード修正) を自動化できます。ドキュメントや docstring " +"のスペルチェックを自動化することもできます。" + +#: ../../maintain-automate/dev-installs.md:1 +msgid "Installing your own code" +msgstr "独自のコードをインストールする" + +#: ../../maintain-automate/dev-installs.md:3 +msgid "" +"You have a conda environment. It works. Maybe it has packages that were " +"hard to install, like GDAL, HDF5, or other compiled scientific " +"dependencies." +msgstr "" +"conda " +"環境があります。それは動作します。おそらく、GDAL、HDF5、またはその他のコンパイルされた科学的依存関係など、インストールが困難なパッケージが含まれている可能性があります。" + +#: ../../maintain-automate/dev-installs.md:5 +msgid "" +"You also have code that you are writing locally. Maybe it started as a " +"script, or maybe it is already organized as a Python package. You want to " +"use that code inside the same environment with GDAL, HDF5, and the other " +"tools you already installed." +msgstr "" +"ローカルで記述しているコードもあります。おそらくスクリプトとして始まったか、すでに Python " +"パッケージとして編成されているのかもしれません。そのコードを、GDAL、HDF5、およびすでにインストールされている他のツールと同じ環境内で使用したいと考えています。" + +#: ../../maintain-automate/dev-installs.md:7 +msgid "" +"The instructions to install your code into a conda environment is to first " +"activate your conda environment `conda activate your_env_name` and then run" +" this: `python -m pip install -e . --no-deps`. You may also see this " +"written as `pip install -e .`. See [The Full Command](the-full-command) " +"section below for more info as to the details of this command." +msgstr "" +"コードを conda 環境にインストールする手順は、まず conda 環境をアクティブ化して「conda activate " +"your_env_name」、次にこれを実行します: `python -m pip install -e 。 --no-deps`。これが「pip " +"install -e .」と書かれていることもあります。このコマンドの詳細については、以下の [完全なコマンド](the-full-command) " +"セクションを参照してください。" + +#: ../../maintain-automate/dev-installs.md:9 +msgid "" +"If this is the first time you're seeing pip install commands, you may not " +"be totally sure what is going on here. Conda created the environment, why " +"am I using `pip` to install things now? You may have heard guidance to " +"generally try and avoid mixing conda and pip? You may already be mixing " +"conda and pip and things are totally fine. You may also not care at all " +"because `pip install -e .` seems to work fine and you can get back to what " +"you're actually trying to do. (If that last one is you, you're also " +"probably not reading this page). In any event, all of these situations are " +"perfectly understandable and totally okay for you to be going through." +msgstr "" +"pip install コマンドを初めて見る場合は、ここで何が起こっているのかよくわからないかもしれません。 Conda " +"が環境を作成したのに、なぜ今インストールに `pip` を使用しているのでしょうか?一般的に conda と pip " +"を混合しないようにするというガイダンスを聞いたことがあるかもしれません。すでに conda と pip " +"を混合しているかもしれませんが、まったく問題ありません。また、`pip install -e .` " +"は問題なく動作しているようで、実際にやろうとしていることに戻ることができるので、まったく気にしないかもしれません。 " +"(最後の人があなたなら、おそらくこのページも読んでいないでしょう)。いずれにせよ、これらの状況はすべて完全に理解できるものであり、あなたが経験してもまったく問題ありません。" + +#: ../../maintain-automate/dev-installs.md:11 +msgid "" +"So... why pip? The short answer is that conda and pip are doing different " +"jobs here." +msgstr "それで...なぜピップ?簡単に言うと、ここでは conda と pip が異なる仕事をしているということです。" + +#: ../../maintain-automate/dev-installs.md:13 +msgid "" +"The slightly longer, mostly apologetic, answer is this is just sort of the " +"current ergonomics of how python packaging works and, honestly? Most of us " +"have turned this confusing pain point into muscle memory. But not you. " +"You're new here. And you're like... wat? And you're totally justified to " +"feel this way." +msgstr "" +"少し長く、ほとんど謝罪的な答えですが、これは Python " +"のパッケージ化がどのように機能するかについての現在の人間工学のようなもので、正直に言って?私たちのほとんどは、このわかりにくい痛みのポイントを筋肉の記憶に変えています。しかし、あなたはそうではありません。あなたはここに来たのは初めてです。そしてあなたは...何ですか？そして、あなたがそのように感じるのも当然です。" + +#: ../../maintain-automate/dev-installs.md:15 +msgid "" +"So, what is happening here? `conda` manages the environment: the Python " +"runtime, compiled libraries, command line tools, and the packages your " +"project depends on. This is stuff that you've already been doing and you're" +" comfortable with (or at least familiar with). `pip` is doing one Python-" +"packaging-specific job: installing your local package into the active " +"environment." +msgstr "" +"それで、ここで何が起こっているのでしょうか？ `conda` は、Python ランタイム、コンパイルされたライブラリ、コマンド ライン " +"ツール、プロジェクトが依存するパッケージなどの環境を管理します。これはあなたがすでに行っており、慣れている（または少なくとも慣れている）ことです。 " +"`pip` は、ローカル パッケージをアクティブな環境にインストールするという、Python パッケージング固有のジョブを 1 つ実行します。" + +#: ../../maintain-automate/dev-installs.md:17 +msgid "" +"In editable mode, the `-e` flag, `pip` connects the active environment to " +"the source files you are editing. And... why exactly is that useful?" +msgstr "" +"編集可能モードでは、「-e」フラグ、「pip」により、アクティブな環境が編集中のソース " +"ファイルに接続されます。そして...なぜそれが役立つのでしょうか?" + +#: ../../maintain-automate/dev-installs.md:19 +msgid "It's useful because it gives you a pretty quick development loop:" +msgstr "これは非常に迅速な開発ループを提供するので便利です。" + +#: ../../maintain-automate/dev-installs.md:21 +msgid "Edit your code in your editor." +msgstr "エディターでコードを編集します。" + +#: ../../maintain-automate/dev-installs.md:22 +msgid "Run it from a terminal, test suite, or Jupyter notebook." +msgstr "ターミナル、テスト スイート、または Jupyter ノートブックから実行します。" + +#: ../../maintain-automate/dev-installs.md:23 +msgid "Edit the code again." +msgstr "コードを再度編集します。" + +#: ../../maintain-automate/dev-installs.md:24 +msgid "Run it again without reinstalling your package." +msgstr "パッケージを再インストールせずに再度実行します。" + +#: ../../maintain-automate/dev-installs.md:26 +msgid "" +"So the goal is not to switch from conda to pip. The goal is to keep using " +"your conda environment while making your local package importable inside " +"that environment." +msgstr "" +"したがって、目標は conda から pip に切り替えることではありません。目標は、conda 環境を使用し続けながら、その環境内でローカル " +"パッケージをインポートできるようにすることです。" + +#: ../../maintain-automate/dev-installs.md:28 +msgid "Should I use pip for everything now?" +msgstr "今度はすべてに pip を使用する必要がありますか?" + +#: ../../maintain-automate/dev-installs.md:30 +msgid "Probably not?" +msgstr "おそらくそうではないでしょうか？" + +#: ../../maintain-automate/dev-installs.md:32 +msgid "" +"If conda is already working well for your project, keep using conda to " +"manage the environment. Use pip only for this one task: installing your " +"local package in editable mode." +msgstr "" +"conda がすでにプロジェクトでうまく機能している場合は、引き続き conda を使用して環境を管理してください。 pip は、ローカル " +"パッケージを編集可能モードでインストールするというこの 1 つのタスクにのみ使用してください。" + +#: ../../maintain-automate/dev-installs.md:34 +msgid "" +"If you are curious about other tools like uv, pixi, Hatch, or pip-only " +"workflows, see [Environment Managers](environment-managers.md). Those tools" +" can be great choices. But you do not need to switch tools just to develop " +"your local package inside a conda environment." +msgstr "" +"uv、pixi、Hatch、pip のみのワークフローなどの他のツールに興味がある場合は、[環境マネージャー](environment-" +"managers.md) を参照してください。これらのツールは素晴らしい選択肢になる可能性があります。ただし、conda 環境内でローカル " +"パッケージを開発するためだけにツールを切り替える必要はありません。" + +#: ../../maintain-automate/dev-installs.md:36 +msgid "" +"As a final note, people in the conda ecosystem are actively working on " +"better conda/pip interoperability. In the future, this workflow may become " +"less awkward. For now, `python -m pip install -e . --no-deps` is the " +"standard bridge." +msgstr "" +"最後になりますが、conda エコシステムの人々は conda/pip " +"の相互運用性の向上に積極的に取り組んでいます。将来的には、このワークフローはそれほど面倒ではなくなるかもしれません。現時点では、 `python -m" +" pip install -e です。 --no-deps` は標準のブリッジです。" + +#: ../../maintain-automate/dev-installs.md:39 +msgid "The full command" +msgstr "完全なコマンド" + +#: ../../maintain-automate/dev-installs.md:41 +msgid "" +"`python -m pip install -e . --no-deps` is a mouthful. I know it. You know " +"it. Why do we do these things?" +msgstr "" +"`python -m pip install -e 。 --no-deps` " +"は一口です。私はそれを知っている。あなたはそれを知っています。なぜこのようなことをするのでしょうか?" + +#: ../../maintain-automate/dev-installs.md:43 +msgid "The simplest version of this is:" +msgstr "これの最も単純なバージョンは次のとおりです。" + +#: ../../maintain-automate/dev-installs.md:48 +msgid "But we recommend the longer version in conda environments for two reasons." +msgstr "ただし、conda 環境では 2 つの理由から長いバージョンをお勧めします。" + +#: ../../maintain-automate/dev-installs.md:50 +msgid "" +"The `python -m pip` part ensures that you're using pip from the active " +"conda environment. Sometimes this results in `pip not found`, which is " +"actually a good error to get because it means you prevented an annoying-to-" +"debug failure mode. If this happens just `conda install pip` and try again." +" So, why? Sometimes `pip` from a different python environment can be on " +"your PATH which means that you'll accidentally install your code into an " +"unrelated python environment. This can be confusing to debug. This has " +"happened to most (all?) of us. It usually hits when you're least prepared " +"to debug and fix it. So we recommend the `python -m` in front to prevent " +"this from happening. But it does add to the length of the command." +msgstr "" +"`python -m pip` 部分は、アクティブな conda 環境から pip を使用していることを保証します。場合によっては、これにより「pip" +" not " +"found」というエラーが発生することがありますが、これはデバッグに煩わしい障害モードを回避したことを意味するため、実際には発生しても良いエラーです。この問題が発生した場合は、「conda" +" install pip」を実行して再試行してください。それで、なぜですか？場合によっては、別の Python 環境の `pip` が PATH " +"上に存在することがあります。これは、コードを誤って無関係な Python " +"環境にインストールしてしまうことを意味します。これはデバッグが混乱する可能性があります。これは私たちのほとんど（全員？）に起こったことです。通常、デバッグと修正の準備が整っていないときに発生します。したがって、これが起こらないようにするために、先頭に「python" +" -m」を付けることをお勧めします。ただし、コマンドの長さは長くなります。" + +#: ../../maintain-automate/dev-installs.md:52 +msgid "" +"The `--no-deps` flag tells pip not to install your package's dependencies, " +"if you have any listed in your project. If you do have them listed, " +"probably in your `pyproject.toml` file, then `pip install -e .` will try to" +" install the dependencies that are listed in that file. In a conda " +"environment, that can range from \"mostly fine\" to \"now my environment is" +" broken and I am not sure how to recover.\"" msgstr "" +"`--no-deps` フラグは、プロジェクトにパッケージの依存関係がリストされている場合に、パッケージの依存関係をインストールしないように pip " +"に指示します。おそらく `pyproject.toml` ファイルにそれらがリストされている場合、`pip install -e .` " +"はそのファイルにリストされている依存関係をインストールしようとします。 conda " +"環境では、「ほとんど問題ありません」から「環境が壊れており、回復方法がわかりません」までさまざまです。" + +#: ../../maintain-automate/dev-installs.md:54 +msgid "" +"With `--no-deps`, pip installs only your local package. You remain " +"responsible for managing the environment dependencies with conda." +msgstr "" +"`--no-deps` を指定すると、pip はローカル パッケージのみをインストールします。 conda " +"を使用して環境の依存関係を管理するのは引き続きお客様の責任です。" #: ../../maintain-automate/environment-managers.md:2 msgid "Environment Managers for Python Packaging" -msgstr "" +msgstr "Python パッケージングの環境マネージャー" #: ../../maintain-automate/environment-managers.md:4 msgid "Quick Decision Guide" -msgstr "" +msgstr "クイック意思決定ガイド" #: ../../maintain-automate/environment-managers.md:6 msgid "**Python-only project, want simplicity?** → venv + pip" -msgstr "" +msgstr "**Python のみのプロジェクト、シンプルさが必要ですか?** → venv + pip" #: ../../maintain-automate/environment-managers.md:7 msgid "**Python-only, want speed?** → **uv** (recommended)" -msgstr "" +msgstr "**Python のみ、速度が必要ですか?** → **uv** (推奨)" #: ../../maintain-automate/environment-managers.md:8 msgid "**Installing CLI tools globally?** → pipx" -msgstr "" +msgstr "**CLI ツールをグローバルにインストールしますか?** → pipx" #: ../../maintain-automate/environment-managers.md:9 msgid "" "**Need conda packages or cross-language dependencies?** → **pixi** " "(recommended) or conda/mamba" -msgstr "" +msgstr "**conda パッケージまたは言語間の依存関係が必要ですか?** → **pixi** (推奨) または conda/mamba" #: ../../maintain-automate/environment-managers.md:10 msgid "" "**Creating a Python package?** → Use Hatch -- with UV as a dependency " "manager" -msgstr "" +msgstr "**Python パッケージを作成しますか?** → Hatch を使用します -- 依存関係マネージャーとして UV を使用します" #: ../../maintain-automate/environment-managers.md:12 msgid "" -"You can mix tools! For example, use **pipx** to install tools you use " -"often (at the command line) like Hatch, ruff or pre-commit, then use " -"**uv** within your projects for package and environment management." +"You can mix tools! For example, use **pipx** to install tools you use often" +" (at the command line) like Hatch, ruff or pre-commit, then use **uv** " +"within your projects for package and environment management." msgstr "" +"ツールを組み合わせることができます!たとえば、**pipx** を使用して、Hatch、ruff、または pre-commit " +"などのよく使用するツール (コマンド ラインで) をインストールし、プロジェクト内で **uv** を使用してパッケージと環境を管理します。" #: ../../maintain-automate/environment-managers.md:15 msgid "Environment and package managers" -msgstr "" +msgstr "環境およびパッケージマネージャー" #: ../../maintain-automate/environment-managers.md:17 msgid "" @@ -275,15 +534,20 @@ msgid "" "packaging workflows. To make Your packaging experience when selecting a " "tool will be easier if you understand the difference between the two." msgstr "" +"パッケージおよび環境マネージャーは、Python パッケージ化ワークフローにおける重要なツールです。 2 " +"つの違いを理解すると、ツールを選択する際のパッケージング エクスペリエンスが容易になります。" #: ../../maintain-automate/environment-managers.md:20 msgid "" "A **package manager** is used to install, update, and remove Python " -"packages (libraries and tools) and their dependencies in your " -"environment. When you use a package manager, you are often downloading " -"packages from a repository like PyPI (Python Package Index) or a local " -"repository like GitHub / GitLab." +"packages (libraries and tools) and their dependencies in your environment. " +"When you use a package manager, you are often downloading packages from a " +"repository like PyPI (Python Package Index) or a local repository like " +"GitHub / GitLab." msgstr "" +"**パッケージ マネージャー**は、環境内の Python パッケージ (ライブラリとツール) " +"とその依存関係をインストール、更新、削除するために使用されます。パッケージ マネージャーを使用する場合、多くの場合、PyPI (Python " +"Package Index) などのリポジトリ、または GitHub / GitLab などのローカル リポジトリからパッケージをダウンロードします。" #: ../../maintain-automate/environment-managers.md:23 msgid "" @@ -292,57 +556,67 @@ msgid "" "package is PyPI, but it can be used to install packages from other " "repositories such as GitHub." msgstr "" +"`pip install numpy` を実行すると、pip はパッケージ マネージャーとして機能し、PyPI から numpy " +"をインストールします。パッケージをインストールするときの Pip のデフォルトのリポジトリは PyPI ですが、GitHub " +"などの他のリポジトリからパッケージをインストールするために使用できます。" #: ../../maintain-automate/environment-managers.md:26 msgid "" -"An **environment manager** creates isolated spaces (environments) for " -"your Python projects. Each environment has its own Python installation " -"and its own installed packages. Using isolated environments for different" -" projects reduces the change of environment conflicts when using the same" -" environment across different projects with different dependencies." +"An **environment manager** creates isolated spaces (environments) for your " +"Python projects. Each environment has its own Python installation and its " +"own installed packages. Using isolated environments for different projects " +"reduces the change of environment conflicts when using the same environment" +" across different projects with different dependencies." msgstr "" +"**環境マネージャー**は、Python プロジェクト用に隔離されたスペース (環境) を作成します。各環境には独自の Python " +"インストールと独自のインストール済みパッケージがあります。異なるプロジェクトに分離された環境を使用すると、異なる依存関係を持つ異なるプロジェクト間で同じ環境を使用する場合に、環境変更の競合が軽減されます。" #: ../../maintain-automate/environment-managers.md:28 msgid "" "There are many tools listed below, but if you're short on time, you may " "want to consider" -msgstr "" +msgstr "以下にリストされているツールはたくさんありますが、時間がない場合は、次のツールを検討するとよいでしょう。" #: ../../maintain-automate/environment-managers.md:30 msgid "" -"Hatch combined with UV if you are managing a Python package. [Check out " -"our tutorials for more on this workflow.](create-pure-python-package)" +"Hatch combined with UV if you are managing a Python package. [Check out our" +" tutorials for more on this workflow.](create-pure-python-package)" msgstr "" +"Python パッケージを管理している場合は、ハッチングを UV と組み合わせます。 " +"[このワークフローの詳細については、チュートリアルを確認してください。](create-pure-python-package)" #: ../../maintain-automate/environment-managers.md:31 msgid "" "Pixi or mamba as faster alternatives to conda if you are working in the " "non-Pure Python packaging space." -msgstr "" +msgstr "非 Pure Python パッケージング領域で作業している場合は、conda のより高速な代替手段として Pixi または mamba を使用します。" #: ../../maintain-automate/environment-managers.md:33 msgid "Where environment managers save your environment" -msgstr "" +msgstr "環境マネージャーが環境を保存する場所" #: ../../maintain-automate/environment-managers.md:35 msgid "" -"Environment managers save environments in different locations by default." -" For instance, `venv`, an environment manager that ships with Python, " -"saves an environment by default in your current working directory. UV has" -" the same native behavior. In contrast, conda and mamba save environments" -" in a global location, allowing you to access them easily across " -"projects." +"Environment managers save environments in different locations by default. " +"For instance, `venv`, an environment manager that ships with Python, saves " +"an environment by default in your current working directory. UV has the " +"same native behavior. In contrast, conda and mamba save environments in a " +"global location, allowing you to access them easily across projects." msgstr "" +"環境マネージャーは、デフォルトで環境を別の場所に保存します。たとえば、Python " +"に同梱されている環境マネージャーである「venv」は、デフォルトで現在の作業ディレクトリに環境を保存します。 UV " +"にも同じネイティブ動作があります。対照的に、conda と mamba " +"は環境をグローバルな場所に保存するため、プロジェクト間で簡単にアクセスできます。" #: ../../maintain-automate/environment-managers.md:38 msgid "" -"UV does have a global cache even tho its default behavior is to create an" -" environment in your current working directory." -msgstr "" +"UV does have a global cache even tho its default behavior is to create an " +"environment in your current working directory." +msgstr "UV には、デフォルトの動作が現在の作業ディレクトリに環境を作成することであっても、グローバル キャッシュがあります。" #: ../../maintain-automate/environment-managers.md:42 msgid "Some tools do everything" -msgstr "" +msgstr "一部のツールはすべてを実行します" #: ../../maintain-automate/environment-managers.md:44 msgid "" @@ -350,203 +624,208 @@ msgid "" "management. For instance, UV, conda and mamba can be used to both create " "environments, add dependencies, and build and install tools." msgstr "" +"最新のツールの中には、パッケージのインストールと環境管理の両方を処理するものもあります。たとえば、UV、conda、mamba " +"は、環境の作成、依存関係の追加、ツールの構築とインストールの両方に使用できます。" #: ../../maintain-automate/environment-managers.md:46 msgid "Comparison Table: pip ecosystem" -msgstr "" +msgstr "比較表: pip エコシステム" #: ../../maintain-automate/environment-managers.md:37 msgid "Tool" -msgstr "" +msgstr "道具" #: ../../maintain-automate/environment-managers.md:37 msgid "Type" -msgstr "" +msgstr "タイプ" #: ../../maintain-automate/environment-managers.md:37 msgid "Language" -msgstr "" +msgstr "言語" #: ../../maintain-automate/environment-managers.md:37 msgid "Speed" -msgstr "" +msgstr "スピード" #: ../../maintain-automate/environment-managers.md:37 msgid "Default Environment Location" -msgstr "" +msgstr "デフォルトの環境の場所" #: ../../maintain-automate/environment-managers.md:37 msgid "Description" -msgstr "" +msgstr "説明" #: ../../maintain-automate/environment-managers.md:37 msgid "**pip**" -msgstr "" +msgstr "**ピッ**" #: ../../maintain-automate/environment-managers.md:37 msgid "Package manager" -msgstr "" +msgstr "パッケージマネージャー" #: ../../maintain-automate/environment-managers.md:37 #: ../../maintain-automate/task-runners.md msgid "Python" -msgstr "" +msgstr "パイソン" #: ../../maintain-automate/environment-managers.md:37 msgid "Slower" -msgstr "" +msgstr "もっとゆっくり" #: ../../maintain-automate/environment-managers.md:37 msgid "N/A (uses existing environment)" -msgstr "" +msgstr "該当なし (既存の環境を使用)" #: ../../maintain-automate/environment-managers.md:37 msgid "Python's standard package installer. pip also builds packages" -msgstr "" +msgstr "Pythonの標準パッケージインストーラー。 pip はパッケージもビルドします" #: ../../maintain-automate/environment-managers.md:37 msgid "**pipx**" -msgstr "" +msgstr "**pipx**" #: ../../maintain-automate/environment-managers.md:37 msgid "Global (isolated per tool)" -msgstr "" +msgstr "グローバル (ツールごとに分離)" #: ../../maintain-automate/environment-managers.md:37 msgid "" -"Installs tools that you need to regularly use across projects such as " -"nox, pytest or ruff in a global location" -msgstr "" +"Installs tools that you need to regularly use across projects such as nox, " +"pytest or ruff in a global location" +msgstr "nox、pytest、ruff などのプロジェクト間で定期的に使用する必要があるツールをグローバルな場所にインストールします" #: ../../maintain-automate/environment-managers.md:37 msgid "**uv**" -msgstr "" +msgstr "**紫外線**" #: ../../maintain-automate/environment-managers.md:37 msgid "Both" -msgstr "" +msgstr "両方" #: ../../maintain-automate/environment-managers.md:37 msgid "Rust" -msgstr "" +msgstr "さび" #: ../../maintain-automate/environment-managers.md:37 msgid "Fastest" -msgstr "" +msgstr "最速" #: ../../maintain-automate/environment-managers.md:37 msgid "Current working directory" -msgstr "" +msgstr "現在の作業ディレクトリ" #: ../../maintain-automate/environment-managers.md:37 msgid "Fast package installer and environment creator" -msgstr "" +msgstr "高速パッケージインストーラーおよび環境クリエーター" #: ../../maintain-automate/environment-managers.md:37 msgid "**venv**" -msgstr "" +msgstr "**ヴェンヴ**" #: ../../maintain-automate/environment-managers.md:37 msgid "Environment manager" -msgstr "" +msgstr "環境管理者" #: ../../maintain-automate/environment-managers.md:37 msgid "Python's built-in environment creator" -msgstr "" +msgstr "Pythonの組み込み環境作成者" #: ../../maintain-automate/environment-managers.md:37 msgid "**virtualenv**" -msgstr "" +msgstr "**仮想環境**" #: ../../maintain-automate/environment-managers.md:37 msgid "Moderate" -msgstr "" +msgstr "適度" #: ../../maintain-automate/environment-managers.md:37 msgid "Feature-rich alternative to venv" -msgstr "" +msgstr "venv に代わる機能が豊富な代替ツール" #: ../../maintain-automate/environment-managers.md:56 msgid "Comparison Table: conda ecosystem" -msgstr "" +msgstr "比較表: conda エコシステム" #: ../../maintain-automate/environment-managers.md:37 msgid "**conda**" -msgstr "" +msgstr "**コンダ**" #: ../../maintain-automate/environment-managers.md:37 msgid "Python/C++" -msgstr "" +msgstr "Python/C++" #: ../../maintain-automate/environment-managers.md:37 msgid "Global (`~/anaconda3/envs/`)" -msgstr "" +msgstr "グローバル (`~/anaconda3/envs/`)" #: ../../maintain-automate/environment-managers.md:37 msgid "Cross-language package and environment manager" -msgstr "" +msgstr "クロス言語パッケージおよび環境マネージャー" #: ../../maintain-automate/environment-managers.md:37 msgid "**mamba**" -msgstr "" +msgstr "**マンバ**" #: ../../maintain-automate/environment-managers.md:37 msgid "C++" -msgstr "" +msgstr "C++" #: ../../maintain-automate/environment-managers.md:37 msgid "Faster" -msgstr "" +msgstr "もっと早く" #: ../../maintain-automate/environment-managers.md:37 msgid "Faster drop-in replacement for conda" -msgstr "" +msgstr "conda のより迅速なドロップイン置換" #: ../../maintain-automate/environment-managers.md:37 msgid "**pixi**" -msgstr "" +msgstr "**ピクシー**" #: ../../maintain-automate/environment-managers.md:37 msgid "Current working directory (`.pixi/`)" -msgstr "" +msgstr "現在の作業ディレクトリ (`.pixi/`)" #: ../../maintain-automate/environment-managers.md:37 msgid "Modern conda-based tool with lock files" -msgstr "" +msgstr "ロックファイルを備えた最新の conda ベースのツール" #: ../../maintain-automate/environment-managers.md:64 msgid "" -"**Speed comparison:** Rust-based tools (uv, pixi) are significantly " -"faster when installing packages and resolving complex environments than " -"Python-based tools. Mamba is faster than conda but might be slower than " -"Rust-based alternatives such as Pixi." +"**Speed comparison:** Rust-based tools (uv, pixi) are significantly faster " +"when installing packages and resolving complex environments than Python-" +"based tools. Mamba is faster than conda but might be slower than Rust-based" +" alternatives such as Pixi." msgstr "" +"**速度の比較:** Rust ベースのツール (uv、pixi) は、パッケージのインストールや複雑な環境の解決において、Python " +"ベースのツールよりも大幅に高速です。 Mamba は conda より高速ですが、Pixi などの Rust " +"ベースの代替手段よりは遅い可能性があります。" #: ../../maintain-automate/environment-managers.md:67 msgid "Package Managers" -msgstr "" +msgstr "パッケージマネージャー" #: ../../maintain-automate/environment-managers.md:69 msgid "pip" -msgstr "" +msgstr "ピップ" #: ../../maintain-automate/environment-managers.md:71 msgid "" -"Pip is Python's standard package installer. It is included with Python by" -" default." -msgstr "" +"Pip is Python's standard package installer. It is included with Python by " +"default." +msgstr "Pip は Python の標準パッケージ インストーラーです。 Python にはデフォルトで含まれています。" #: ../../maintain-automate/environment-managers.md:72 msgid "" "Pip is great for installing packages from PyPI and GitHub / GitLab into " "existing environments." -msgstr "" +msgstr "Pip は、PyPI および GitHub / GitLab から既存の環境にパッケージをインストールするのに最適です。" #: ../../maintain-automate/environment-managers.md:73 msgid "" "It is also great for development if you want to install your package " "locally in editable mode." -msgstr "" +msgstr "パッケージを編集可能モードでローカルにインストールする場合の開発にも最適です。" #: ../../maintain-automate/environment-managers.md:75 #: ../../maintain-automate/environment-managers.md:87 @@ -557,61 +836,67 @@ msgstr "" #: ../../maintain-automate/environment-managers.md:261 #: ../../maintain-automate/environment-managers.md:280 msgid "**Basic usage:**" -msgstr "" +msgstr "**基本的な使用方法:**" #: ../../maintain-automate/environment-managers.md:81 msgid "pipx" -msgstr "" +msgstr "pipx" #: ../../maintain-automate/environment-managers.md:83 msgid "" -"Pipx is can be used to install a tool that you need to use across " -"projects (like `riff`, `pytest`, `sphinx`, `nox`), globally." +"Pipx is can be used to install a tool that you need to use across projects " +"(like `riff`, `pytest`, `sphinx`, `nox`), globally." msgstr "" +"Pipx を使用すると、プロジェクト間で使用する必要があるツール (`riff`、`pytest`、`sphinx`、`nox` など) " +"をグローバルにインストールできます。" #: ../../maintain-automate/environment-managers.md:85 msgid "" -"Why use it: You might use it to avoid reinstalling the same tool over and" -" over on your machine." -msgstr "" +"Why use it: You might use it to avoid reinstalling the same tool over and " +"over on your machine." +msgstr "使用する理由: マシンに同じツールを何度も再インストールすることを避けるために使用できます。" #: ../../maintain-automate/environment-managers.md:93 msgid "conda / mamba" -msgstr "" +msgstr "コンダ / マンバ" #: ../../maintain-automate/environment-managers.md:95 msgid "" -"Conda is a cross-language package manager that installs Python packages, " -"R packages, system libraries, and more. Mamba is a faster, drop-in " -"replacement for conda and we highly recommend mamba over conda if you are" -" still using conda." +"Conda is a cross-language package manager that installs Python packages, R " +"packages, system libraries, and more. Mamba is a faster, drop-in " +"replacement for conda and we highly recommend mamba over conda if you are " +"still using conda." msgstr "" +"Conda は、Python パッケージ、R パッケージ、システム ライブラリなどをインストールするクロス言語パッケージ マネージャーです。 " +"Mamba は、conda のより高速なドロップイン代替品であり、まだ conda を使用している場合は、conda よりも mamba " +"を強くお勧めします。" #: ../../maintain-automate/environment-managers.md:97 msgid "" "These tools are best for scientific computing projects and environments " -"that need non-Python dependencies (like C libraries, GDAL, or R " -"packages)." +"that need non-Python dependencies (like C libraries, GDAL, or R packages)." msgstr "" +"これらのツールは、Python 以外の依存関係 (C ライブラリ、GDAL、R パッケージなど) を必要とする科学技術コンピューティング " +"プロジェクトや環境に最適です。" #: ../../maintain-automate/environment-managers.md:109 msgid "Conda and mamba also function as environment managers - see below!" -msgstr "" +msgstr "Conda と mamba は環境マネージャーとしても機能します - 以下を参照してください。" #: ../../maintain-automate/environment-managers.md:112 -#: ../../maintain-automate/index.md:46 +#: ../../maintain-automate/index.md:51 msgid "Environment Managers" -msgstr "" +msgstr "環境管理者" #: ../../maintain-automate/environment-managers.md:114 msgid "hatch for pure Python packaging" -msgstr "" +msgstr "純粋な Python パッケージング用のハッチ" #: ../../maintain-automate/environment-managers.md:116 #: ../../maintain-automate/environment-managers.md:204 #: ../../maintain-automate/environment-managers.md:273 msgid "pyOpenSci Recommends" -msgstr "" +msgstr "pyOpenSci の推奨事項" #: ../../maintain-automate/environment-managers.md:118 msgid "" @@ -620,62 +905,72 @@ msgid "" "handles publishing—all in one tool. It can use **uv** as its backend for " "even faster operations." msgstr "" +"Python パッケージ化のための完全なプロジェクト管理ツールとして **hatch** をお勧めします。 Hatch " +"は、環境の管理、パッケージの構築、テストの実行、公開の処理をすべて 1 つのツールで行います。 **uv** " +"をバックエンドとして使用して、さらに高速な操作を実現できます。" #: ../../maintain-automate/environment-managers.md:121 msgid "" "Hatch is a comprehensive modern Python project manager that handles " "environments, package building, testing, and publishing. Hatch creates " "isolated environments for different tasks (testing, docs, development). " -"Hatch uses UV under the hood to install Python, and can be set to use UV " -"to manage environment installations too." +"Hatch uses UV under the hood to install Python, and can be set to use UV to" +" manage environment installations too." msgstr "" +"Hatch は、環境、パッケージの構築、テスト、公開を処理する包括的な最新の Python プロジェクト マネージャーです。 Hatch " +"は、さまざまなタスク (テスト、ドキュメント、開発) 用に分離された環境を作成します。 Hatch は内部で UV を使用して Python " +"をインストールし、UV を使用して環境のインストールを管理するように設定することもできます。" #: ../../maintain-automate/environment-managers.md:123 msgid "" "Hatch is best for Python package developers who want an all-in-one tool " -"that handles the entire packaging workflow from development to " -"publication." -msgstr "" +"that handles the entire packaging workflow from development to publication." +msgstr "Hatch は、開発から公開までのパッケージ化ワークフロー全体を処理するオールインワン ツールを必要とする Python パッケージ開発者に最適です。" #: ../../maintain-automate/environment-managers.md:125 msgid "[Check out our tutorial](create-pure-python-package)" -msgstr "" +msgstr "[チュートリアルをチェックしてください](create-pure-python-package)" #: ../../maintain-automate/environment-managers.md msgid "hatch (recommended)" -msgstr "" +msgstr "ハッチ (推奨)" #: ../../maintain-automate/environment-managers.md msgid "hatch with uv backend" -msgstr "" +msgstr "UV バックエンドを使用したハッチング" #: ../../maintain-automate/environment-managers.md:160 msgid "" -"Hatch acts as a task runner and can manage multiple environments that you" -" define. It also handles project and dependency installation, making it " +"Hatch acts as a task runner and can manage multiple environments that you " +"define. It also handles project and dependency installation, making it " "ideal for package maintainers who want consistency across development " "tasks." msgstr "" +"Hatch はタスク " +"ランナーとして機能し、定義した複数の環境を管理できます。また、プロジェクトと依存関係のインストールも処理するため、開発タスク間で一貫性を求めるパッケージ管理者にとって理想的です。" #: ../../maintain-automate/environment-managers.md:163 msgid "venv" -msgstr "" +msgstr "ベンヴ" #: ../../maintain-automate/environment-managers.md:165 msgid "" -"venv is Python's built-in environment creator (included with Python " -"3.3+). It is best for simple pure Python projects. Because venv ships " -"with Python, and it is used by Hatch, UV and other tools under the hood, " -"it is the most widely used tool." +"venv is Python's built-in environment creator (included with Python 3.3+). " +"It is best for simple pure Python projects. Because venv ships with Python," +" and it is used by Hatch, UV and other tools under the hood, it is the most" +" widely used tool." msgstr "" +"venv は、Python の組み込み環境作成ツールです (Python 3.3 以降に含まれています)。これは、単純な純粋な Python " +"プロジェクトに最適です。 venv は Python " +"に同梱されており、Hatch、UV、その他のツールによって内部的に使用されるため、最も広く使用されているツールです。" #: ../../maintain-automate/environment-managers.md:168 msgid "Basic usage:" -msgstr "" +msgstr "基本的な使い方:" #: ../../maintain-automate/environment-managers.md:184 msgid "virtualenv" -msgstr "" +msgstr "仮想環境" #: ../../maintain-automate/environment-managers.md:186 msgid "" @@ -683,10 +978,12 @@ msgid "" "performance and additional options. It's best for you if you need more " "control over your environments." msgstr "" +"virtualenv は、より優れたパフォーマンスと追加のオプションを備えた、venv " +"のより機能豊富な代替品です。環境をより詳細に制御する必要がある場合に最適です。" #: ../../maintain-automate/environment-managers.md:202 msgid "uv" -msgstr "" +msgstr "紫外線" #: ../../maintain-automate/environment-managers.md:206 msgid "" @@ -694,39 +991,45 @@ msgid "" "management. It's significantly faster than pip and easily handles both " "installing packages and creating environments." msgstr "" +"高速で信頼性の高い Python パッケージと環境管理には **uv** をお勧めします。 pip " +"よりも大幅に高速で、パッケージのインストールと環境の作成の両方を簡単に処理できます。" #: ../../maintain-automate/environment-managers.md:209 msgid "" -"UV is a fast, Rust-based tool that replaces both pip and venv. It " -"installs packages and creates virtual environments at lightning speed. UV" -" is best for any pure Python project. Pixi is better if are working in " -"the non-pure Python packaging space." +"UV is a fast, Rust-based tool that replaces both pip and venv. It installs " +"packages and creates virtual environments at lightning speed. UV is best " +"for any pure Python project. Pixi is better if are working in the non-pure " +"Python packaging space." msgstr "" +"UV は、pip と venv の両方を置き換える高速な Rust ベースのツールです。パッケージをインストールし、仮想環境を超高速で作成します。 " +"UV は純粋な Python プロジェクトに最適です。非純粋な Python パッケージング領域で作業する場合は、Pixi の方が適しています。" #: ../../maintain-automate/environment-managers.md msgid "uv (recommended)" -msgstr "" +msgstr "紫外線（推奨）" #: ../../maintain-automate/environment-managers.md msgid "venv + pip" -msgstr "" +msgstr "ヴェンブ + ピップ" #: ../../maintain-automate/environment-managers.md #: ../../maintain-automate/environment-managers.md:272 msgid "pixi" -msgstr "" +msgstr "ピクシー" #: ../../maintain-automate/environment-managers.md:256 msgid "conda / mamba (as environment managers)" -msgstr "" +msgstr "conda / mamba (環境マネージャーとして)" #: ../../maintain-automate/environment-managers.md:258 msgid "" "Conda and mamba create isolated environments that can contain Python, R, " -"system libraries, and more. The conda ecosystem tools are best for " -"managing complex dependencies across languages or when you need specific " -"system libraries." +"system libraries, and more. The conda ecosystem tools are best for managing" +" complex dependencies across languages or when you need specific system " +"libraries." msgstr "" +"Conda と mamba は、Python、R、システム ライブラリなどを含めることができる分離環境を作成します。 conda エコシステム " +"ツールは、言語間の複雑な依存関係を管理する場合、または特定のシステム ライブラリが必要な場合に最適です。" #: ../../maintain-automate/environment-managers.md:275 msgid "" @@ -734,85 +1037,103 @@ msgid "" "conda/mamba. It's faster, uses lock files for reproducibility, and works " "cross-platform." msgstr "" +"conda パッケージが必要なプロジェクトの場合は、conda/mamba ではなく **pixi** " +"をお勧めします。より高速で、再現性のためにロック ファイルを使用し、クロスプラットフォームで動作します。" #: ../../maintain-automate/environment-managers.md:278 msgid "" "Pixi is a modern, fast package and environment manager built on conda " "ecosystems. Similar to UV, Pixi uses lock files for reproducible " "environments. Pixi is best suited for scientific projects that require " -"conda packages, teams that require exact reproducibility, or cross-" -"platform development." +"conda packages, teams that require exact reproducibility, or cross-platform" +" development." msgstr "" +"Pixi は、conda エコシステム上に構築された最新の高速パッケージおよび環境マネージャーです。 UV と同様に、Pixi " +"は再現可能な環境にロック ファイルを使用します。 Pixi は、conda " +"パッケージを必要とする科学プロジェクト、正確な再現性を必要とするチーム、またはクロスプラットフォーム開発に最適です。" #: ../../maintain-automate/environment-managers.md:299 msgid "" -"Pixi automatically creates a lock file (`pixi.lock`) ensuring everyone on" -" your team gets identical environments." -msgstr "" +"Pixi automatically creates a lock file (`pixi.lock`) ensuring everyone on " +"your team gets identical environments." +msgstr "Pixi はロック ファイル (`pixi.lock`) を自動的に作成し、チームの全員が同一の環境を利用できるようにします。" -#: ../../maintain-automate/index.md:46 +#: ../../maintain-automate/index.md:51 msgid "What is CI?" -msgstr "" +msgstr "CIとは何ですか?" -#: ../../maintain-automate/index.md:46 +#: ../../maintain-automate/index.md:51 msgid "Task runners" -msgstr "" +msgstr "タスクランナー" -#: ../../maintain-automate/index.md:46 +#: ../../maintain-automate/index.md:51 +msgid "Development installs with conda" +msgstr "開発は conda でインストールします" + +#: ../../maintain-automate/index.md:51 msgid "Maintain & Automate" -msgstr "" +msgstr "保守と自動化" #: ../../maintain-automate/index.md:2 msgid "Automate Workflows and Maintain Your Package" -msgstr "" +msgstr "ワークフローを自動化し、パッケージを保守する" #: ../../maintain-automate/index.md:4 msgid "" -"Once you've [created your package](create-pure-python-package), " -"[published it](publish-pypi-tutorial), and set up a repository for it, " -"the next step is to automate development and maintenance workflows. " -"Automation makes maintaining your package easier, more robust, and more " -"secure. It also helps new contributors get started quickly without having" -" to manually set up complex development environments and testing " -"workflows." +"Once you've [created your package](create-pure-python-package), [published " +"it](publish-pypi-tutorial), and set up a repository for it, the next step " +"is to automate development and maintenance workflows. Automation makes " +"maintaining your package easier, more robust, and more secure. It also " +"helps new contributors get started quickly without having to manually set " +"up complex development environments and testing workflows." msgstr "" +"[パッケージを作成](create-pure-python-package)、[公開](publish-pypi-" +"tutorial)してリポジトリを設定したら、次のステップは開発とメンテナンスのワークフローを自動化することです。自動化により、パッケージの保守がより簡単、より堅牢、より安全になります。また、新しいコントリビューターが複雑な開発環境やテスト" +" ワークフローを手動でセットアップする必要がなく、すぐに作業を開始できるようになります。" #: ../../maintain-automate/index.md:11 msgid "Why automate?" -msgstr "" +msgstr "なぜ自動化するのか?" #: ../../maintain-automate/index.md:13 msgid "" -"When you automate repetitive tasks like running tests, checking code " -"style, and building documentation, you ensure that these important steps " -"happen consistently every time. This consistency helps you catch bugs " -"early, maintain code quality, and make it easier for others to contribute" -" to your package. Automation also saves you time—instead of remembering " -"and typing long command sequences, you can run everything with simple " -"commands or have workflows run automatically when you push code to " -"GitHub." +"When you automate repetitive tasks like running tests, checking code style," +" and building documentation, you ensure that these important steps happen " +"consistently every time. This consistency helps you catch bugs early, " +"maintain code quality, and make it easier for others to contribute to your " +"package. Automation also saves you time—instead of remembering and typing " +"long command sequences, you can run everything with simple commands or have" +" workflows run automatically when you push code to GitHub." msgstr "" +"テストの実行、コード " +"スタイルのチェック、ドキュメントの作成などの反復的なタスクを自動化すると、これらの重要な手順が毎回一貫して実行されるようになります。この一貫性により、バグを早期に発見し、コードの品質を維持し、他の人がパッケージに貢献しやすくなります。自動化により時間も節約できます。長いコマンド" +" シーケンスを覚えて入力する代わりに、単純なコマンドですべてを実行したり、コードを GitHub " +"にプッシュするときにワークフローを自動的に実行したりできます。" #: ../../maintain-automate/index.md:22 msgid "What you'll learn" -msgstr "" +msgstr "学べること" #: ../../maintain-automate/index.md:24 msgid "" -"This section will walk you through two key automation strategies for " -"Python packages:" -msgstr "" +"This section will walk you through two key automation strategies for Python" +" packages:" +msgstr "このセクションでは、Python パッケージの 2 つの主要な自動化戦略について説明します。" #: ../../maintain-automate/index.md:27 msgid "" -"[**Task runners**](task-runners-intro) help you automate common " -"development tasks locally— things like running tests, building " -"documentation, formatting code, and checking for errors. Instead of " -"typing out long command sequences every time, you define tasks once and " -"run them with simple commands. Task runners like Hatch and Nox also " -"manage isolated environments for different workflows, ensuring you have " -"the right dependencies for each task." +"[**Task runners**](task-runners-intro) help you automate common development" +" tasks locally— things like running tests, building documentation, " +"formatting code, and checking for errors. Instead of typing out long " +"command sequences every time, you define tasks once and run them with " +"simple commands. Task runners like Hatch and Nox also manage isolated " +"environments for different workflows, ensuring you have the right " +"dependencies for each task." msgstr "" +"[**タスク ランナー**](task-runners-intro) " +"は、テストの実行、ドキュメントの構築、コードのフォーマット、エラーのチェックなど、一般的な開発タスクをローカルで自動化するのに役立ちます。毎回長いコマンド" +" シーケンスを入力する代わりに、タスクを一度定義し、単純なコマンドで実行します。 Hatch や Nox などのタスク " +"ランナーは、さまざまなワークフローの分離環境も管理し、各タスクに適切な依存関係を確保します。" #: ../../maintain-automate/index.md:35 msgid "" @@ -823,21 +1144,37 @@ msgid "" "they're merged. You can also use Continuous Deployment (CD) to automate " "publishing your package to PyPI and deploying your documentation." msgstr "" +"[**継続的インテグレーション (CI)**](ci-cd) は、コードが GitHub にプッシュされるたび、または誰かがプル " +"リクエストを開くたびにテストとチェックを自動的に実行することで、自動化をさらに進めます。 CI では、すべての変更がマージされる前に、異なる " +"Python バージョンおよびオペレーティング システム間でテストされることが保証されます。継続的デプロイメント (CD) を使用して、PyPI " +"へのパッケージの公開とドキュメントのデプロイを自動化することもできます。" #: ../../maintain-automate/index.md:42 msgid "" -"Together, task runners and CI/CD create a robust development workflow " -"that makes your package easier to maintain and more welcoming to " -"contributors." +"Together, task runners and CI/CD create a robust development workflow that " +"makes your package easier to maintain and more welcoming to contributors." +msgstr "" +"タスク ランナーと CI/CD " +"を組み合わせることで、パッケージの保守が容易になり、コントリビューターにとってより歓迎される堅牢な開発ワークフローが作成されます。" + +#: ../../maintain-automate/index.md:46 +msgid "" +"[**Development installs in conda environments**](dev-installs) help you " +"connect conda-based scientific development environments with local Python " +"package development. This is especially useful when your package depends on" +" compiled or system-level dependencies that conda manages well." msgstr "" +"[**conda 環境での開発インストール**](dev-installs) は、conda ベースの科学開発環境をローカルの Python " +"パッケージ開発と接続するのに役立ちます。これは、conda が適切に管理するコンパイル済み依存関係またはシステム " +"レベルの依存関係にパッケージが依存している場合に特に便利です。" #: ../../maintain-automate/task-runners.md:2 msgid "Task Runners for Python Packaging" -msgstr "" +msgstr "Python パッケージ化のタスク ランナー" #: ../../maintain-automate/task-runners.md:4 msgid "What is a Task Runner?" -msgstr "" +msgstr "タスクランナーとは何ですか?" #: ../../maintain-automate/task-runners.md:6 msgid "" @@ -846,37 +1183,44 @@ msgid "" "your code, build documentation, or check your package, you define these " "tasks once and run them with simple commands." msgstr "" +"タスク " +"ランナーは、反復的な開発ワークフローを自動化するツールです。コードのテスト、ドキュメントの構築、パッケージのチェックが必要になるたびに長いコマンド " +"シーケンスを入力する代わりに、これらのタスクを一度定義し、単純なコマンドで実行します。" #: ../../maintain-automate/task-runners.md:11 msgid "For example, rather than running:" -msgstr "" +msgstr "たとえば、次のように実行するのではなく、" #: ../../maintain-automate/task-runners.md:19 msgid "You can define a task and run:" -msgstr "" +msgstr "タスクを定義して実行できます。" #: ../../maintain-automate/task-runners.md:25 msgid "" -"Most modern task runners also include environment management features " -"that make it quick and easy to run tasks. Task runners ensure that " -"workflows are executed consistently every time, whether you're running " -"them on your laptop or in continuous integration, and they also make it " -"easier for contributors to recreate the same workflows in their local " -"environments." +"Most modern task runners also include environment management features that " +"make it quick and easy to run tasks. Task runners ensure that workflows are" +" executed consistently every time, whether you're running them on your " +"laptop or in continuous integration, and they also make it easier for " +"contributors to recreate the same workflows in their local environments." msgstr "" +"最新のタスク ランナーのほとんどには、タスクを迅速かつ簡単に実行できる環境管理機能も含まれています。タスク " +"ランナーを使用すると、ラップトップで実行している場合でも、継続的統合で実行している場合でも、ワークフローが常に一貫して実行されることが保証され、また、コントリビューターがローカル環境で同じワークフローを簡単に再作成できるようになります。" #: ../../maintain-automate/task-runners.md:32 msgid "Benefits of task runners" -msgstr "" +msgstr "タスクランナーのメリット" #: ../../maintain-automate/task-runners.md:34 msgid "" -"Task runners provide several benefits for package development. When you " -"use a task runner, everyone on your team runs tasks the same way, " -"reducing environment-specific issues and \"works on my machine\" " -"problems. Complex multi-step processes become single commands, so " -"contributors don't need to memorize or look up lengthy command sequences." +"Task runners provide several benefits for package development. When you use" +" a task runner, everyone on your team runs tasks the same way, reducing " +"environment-specific issues and \"works on my machine\" problems. Complex " +"multi-step processes become single commands, so contributors don't need to " +"memorize or look up lengthy command sequences." msgstr "" +"タスク ランナーは、パッケージ開発にいくつかの利点をもたらします。タスク " +"ランナーを使用すると、チームの全員が同じ方法でタスクを実行するため、環境固有の問題や「自分のマシンで動作する」問題が軽減されます。複雑な複数ステップのプロセスが単一のコマンドになるため、投稿者は長いコマンド" +" シーケンスを記憶したり調べたりする必要がありません。" #: ../../maintain-automate/task-runners.md:41 msgid "" @@ -885,92 +1229,113 @@ msgid "" "without conflicts. This means your tasks run the same way locally and in " "continuous integration, making debugging easier and builds more reliable." msgstr "" +"多くのタスク " +"ランナーは、さまざまなワークフロー用に分離された環境も作成し、競合することなく各タスクで適切な依存関係が利用できるようにします。これは、タスクがローカルでも継続的統合でも同じように実行されることを意味し、デバッグが容易になり、ビルドの信頼性が高まります。" #: ../../maintain-automate/task-runners.md:47 msgid "Two types of task runners" -msgstr "" +msgstr "2種類のタスクランナー" #: ../../maintain-automate/task-runners.md:49 msgid "" "The most common task runners used in the Python ecosystem fall into two " "categories:" -msgstr "" +msgstr "Python エコシステムで使用される最も一般的なタスク ランナーは、次の 2 つのカテゴリに分類されます。" #: ../../maintain-automate/task-runners.md:51 msgid "Environment + command managers" -msgstr "" +msgstr "環境 + コマンドマネージャー" #: ../../maintain-automate/task-runners.md:53 msgid "" -"You can use these to both create custom isolated environments and also to" -" run your tasks." -msgstr "" +"You can use these to both create custom isolated environments and also to " +"run your tasks." +msgstr "これらを使用して、カスタムの分離環境を作成したり、タスクを実行したりできます。" #: ../../maintain-automate/task-runners.md:55 msgid "" "**[Hatch](https://hatch.pypa.io/):** Hatch is an all-in-one package " -"management tool that includes a built-in task runner. It uses a " -"declarative TOML configuration in your `pyproject.toml` file, which means" -" everything related to your package—metadata, dependencies, and " -"tasks—lives in one place. Hatch also integrates with UV for fast " -"environment creation." +"management tool that includes a built-in task runner. It uses a declarative" +" TOML configuration in your `pyproject.toml` file, which means everything " +"related to your package—metadata, dependencies, and tasks—lives in one " +"place. Hatch also integrates with UV for fast environment creation." msgstr "" +"**[Hatch](https://hatch.pypa.io/):** Hatch は、組み込みのタスク " +"ランナーを含むオールインワンのパッケージ管理ツールです。これは、`pyproject.toml` ファイル内で宣言型 TOML " +"構成を使用します。これは、パッケージに関連するすべてのもの (メタデータ、依存関係、タスク) が 1 か所に存在することを意味します。 Hatch は" +" UV とも統合して、環境を迅速に作成します。" #: ../../maintain-automate/task-runners.md:56 msgid "" "**[Nox](https://nox.thea.codes/):** Nox is a flexible Python-based task " "runner that uses a code-based (imperative) configuration approach. You " -"write Python functions to define your tasks in a `noxfile.py`, which " -"gives you maximum flexibility for complex testing scenarios and " -"conditional logic. It's especially popular in the Scientific Python " -"ecosystem." +"write Python functions to define your tasks in a `noxfile.py`, which gives " +"you maximum flexibility for complex testing scenarios and conditional " +"logic. It's especially popular in the Scientific Python ecosystem." msgstr "" +"**[Nox](https://nox.thea.codes/):** Nox は、コードベース (命令型) 構成アプローチを使用する、柔軟な " +"Python ベースのタスク ランナーです。 Python 関数を作成して `noxfile.py` でタスクを定義すると、複雑なテスト " +"シナリオや条件付きロジックに対して最大限の柔軟性が得られます。これは、Scientific Python エコシステムで特に人気があります。" #: ../../maintain-automate/task-runners.md:57 msgid "" "**[Tox](https://tox.wiki/):** Tox is a mature declarative tool that uses " -"INI or TOML configuration files. It's particularly well-suited for " -"testing across multiple Python versions and dependency combinations, and " -"has been a standard in the Python community for years." +"INI or TOML configuration files. It's particularly well-suited for testing " +"across multiple Python versions and dependency combinations, and has been a" +" standard in the Python community for years." msgstr "" +"**[Tox](https://tox.wiki/):** Tox は、INI または TOML " +"構成ファイルを使用する成熟した宣言型ツールです。これは、複数の Python " +"バージョンおよび依存関係の組み合わせにわたるテストに特に適しており、Python コミュニティでは長年にわたり標準となっています。" #: ../../maintain-automate/task-runners.md:59 msgid "Command-only tools" -msgstr "" +msgstr "コマンド専用ツール" #: ../../maintain-automate/task-runners.md:61 msgid "These tools execute your commands but don't manage environments." -msgstr "" +msgstr "これらのツールはコマンドを実行しますが、環境は管理しません。" #: ../../maintain-automate/task-runners.md:63 msgid "" -"**[Make](https://www.gnu.org/software/make/):** Make is a traditional " -"build automation tool that uses Makefiles. It's widely known and " -"available on most systems, making it a good choice for simple task " -"automation when you don't need Python-specific features. However, it can " -"have cross-platform compatibility issues, especially on Windows." +"**[Make](https://www.gnu.org/software/make/):** Make is a traditional build" +" automation tool that uses Makefiles. It's widely known and available on " +"most systems, making it a good choice for simple task automation when you " +"don't need Python-specific features. However, it can have cross-platform " +"compatibility issues, especially on Windows." msgstr "" +"**[Make](https://www.gnu.org/software/make/):** Make は、Makefile " +"を使用する従来のビルド自動化ツールです。これは広く知られており、ほとんどのシステムで利用できるため、Python " +"固有の機能が必要ない場合の単純なタスクの自動化に適しています。ただし、特に Windows " +"では、クロスプラットフォームの互換性の問題が発生する可能性があります。" #: ../../maintain-automate/task-runners.md:64 msgid "" -"**[Just](https://just.systems/):** Just is a modern command runner " -"written in Rust with simple, Make-like syntax. It's fast, cross-platform," -" and easy to learn, making it a good lightweight alternative when you " -"need basic task running without environment management." +"**[Just](https://just.systems/):** Just is a modern command runner written " +"in Rust with simple, Make-like syntax. It's fast, cross-platform, and easy " +"to learn, making it a good lightweight alternative when you need basic task" +" running without environment management." msgstr "" +"**[Just](https://just.systems/):** Just は、シンプルな Make のような構文を使用して Rust " +"で書かれた最新のコマンド " +"ランナーです。これは高速でクロスプラットフォームであり、習得が簡単であるため、環境管理なしで基本的なタスクを実行する必要がある場合の軽量な代替手段として適しています。" #: ../../maintain-automate/task-runners.md:66 msgid "" "Generally the two task runners that pyOpenSci suggests and uses are " "[Nox](https://nox.thea.codes/en/stable/) and [Hatch (also a package " "management tool)](https://hatch.pypa.io/latest/). Below, you will learn " -"about the differences between all of the tools and can make a decision " -"for yourself depending on your needs." +"about the differences between all of the tools and can make a decision for " +"yourself depending on your needs." msgstr "" +"一般に、pyOpenSci が提案および使用する 2 つのタスク " +"ランナーは、[Nox](https://nox.thea.codes/en/stable/) と [Hatch " +"(これもパッケージ管理ツール)](https://hatch.pypa.io/latest/) " +"です。以下では、すべてのツールの違いについて説明し、ニーズに応じて自分で決定できます。" #: ../../maintain-automate/task-runners.md:71 msgid "pyOpenSci recommends: Hatch and Nox" -msgstr "" +msgstr "pyOpenSci が推奨する: Hatch と Nox" #: ../../maintain-automate/task-runners.md:73 msgid "" @@ -978,292 +1343,320 @@ msgid "" "development. Hatch also includes a task and environment system feature. " "Using Hatch means you don't need to setup another tool like Nox." msgstr "" +"pyOpenSci では、Python パッケージ開発には **Hatch** " +"を推奨しています。ハッチには、タスクおよび環境システム機能も含まれています。 Hatch を使用すると、Nox " +"などの別のツールをセットアップする必要がなくなります。" #: ../../maintain-automate/task-runners.md:77 msgid "" "However, **Nox** is also an excellent choice, particularly if you need " "complex testing, build or workflow logic." -msgstr "" +msgstr "ただし、**Nox** も、特に複雑なテスト、ビルド、またはワークフロー ロジックが必要な場合には優れた選択肢です。" #: ../../maintain-automate/task-runners.md:80 msgid "" "You'll find many of the pyOpenSci documentation repositories use Nox to " "automate workflows such as building and testing documentation." msgstr "" +"pyOpenSci ドキュメント リポジトリの多くは、ドキュメントの構築やテストなどのワークフローを自動化するために Nox " +"を使用していることがわかります。" #: ../../maintain-automate/task-runners.md:83 msgid "Why use Hatch?" -msgstr "" +msgstr "ハッチを使用する理由" #: ../../maintain-automate/task-runners.md:85 msgid "" -"Hatch is an all-in-one tool that helps you manage metadata, dependencies," -" build configuration, and tasks together in `pyproject.toml`. Using " -"Hatch, everything related to your package lives in one place. It combines" -" packaging (building and publishing) with everyday development tasks like" -" testing, docs, and formatting, making workflows easier to run and share." -" Hatch also integrates with UV making it extremely fast. Finally, Hatch " -"follows modern packaging practices (for example, PEP 621), so your " -"project stays aligned with community standards." -msgstr "" +"Hatch is an all-in-one tool that helps you manage metadata, dependencies, " +"build configuration, and tasks together in `pyproject.toml`. Using Hatch, " +"everything related to your package lives in one place. It combines " +"packaging (building and publishing) with everyday development tasks like " +"testing, docs, and formatting, making workflows easier to run and share. " +"Hatch also integrates with UV making it extremely fast. Finally, Hatch " +"follows modern packaging practices (for example, PEP 621), so your project " +"stays aligned with community standards." +msgstr "" +"Hatch は、メタデータ、依存関係、ビルド構成、およびタスクを `pyproject.toml` でまとめて管理するのに役立つオールインワン " +"ツールです。 Hatch を使用すると、パッケージに関連するすべてが 1 か所にまとめられます。パッケージ化 (ビルドと公開) " +"とテスト、ドキュメント、フォーマットなどの日常的な開発タスクを組み合わせて、ワークフローの実行と共有を容易にします。 Hatch は UV " +"とも統合されており、非常に高速です。最後に、Hatch は最新のパッケージ化慣行 (PEP 621 など) " +"に従っているため、プロジェクトはコミュニティ標準に準拠した状態を維持できます。" #: ../../maintain-automate/task-runners.md:95 msgid "Why use Nox?" -msgstr "" +msgstr "Nox を使用する理由" #: ../../maintain-automate/task-runners.md:97 msgid "" -"Python-based configuration gives Nox maximum flexibility, making it easy " -"to express complex logic and conditionals directly. Because sessions are " -"written in Python, they are explicit and easy to inspect and debug. Nox " -"is particularly powerful for handling complex test and build scenarios " -"that some packages require." +"Python-based configuration gives Nox maximum flexibility, making it easy to" +" express complex logic and conditionals directly. Because sessions are " +"written in Python, they are explicit and easy to inspect and debug. Nox is " +"particularly powerful for handling complex test and build scenarios that " +"some packages require." msgstr "" +"Python ベースの構成により Nox に最大限の柔軟性が与えられ、複雑なロジックや条件を直接簡単に表現できるようになります。セッションは " +"Python で記述されているため、明示的であり、検査とデバッグが簡単です。 Nox " +"は、一部のパッケージに必要な複雑なテストとビルドのシナリオを処理するのに特に強力です。" #: ../../maintain-automate/task-runners.md:103 msgid "Declarative vs. imperative configuration" -msgstr "" +msgstr "宣言型構成と命令型構成" #: ../../maintain-automate/task-runners.md:105 msgid "An important distinction between these tools is how you configure them:" -msgstr "" +msgstr "これらのツールの重要な違いは、その構成方法です。" #: ../../maintain-automate/task-runners.md:107 msgid "" "Hatch is a **Declarative tool**. This means it uses a configuration file " "where you specify *what* you want. See the example below:" -msgstr "" +msgstr "ハッチングは **宣言型ツール** です。これは、必要な「内容」を指定する構成ファイルを使用することを意味します。以下の例を参照してください。" #: ../../maintain-automate/task-runners.md:119 msgid "" "Nox uses an **Imperative** approach to defining workflows. With Nox, you " -"write Python code that defines how to perform a task. An example of a Nox" -" function (which would live in a separate noxfile.py file) is shown " -"below:" +"write Python code that defines how to perform a task. An example of a Nox " +"function (which would live in a separate noxfile.py file) is shown below:" msgstr "" +"Nox は、**命令的** アプローチを使用してワークフローを定義します。 Nox では、タスクの実行方法を定義する Python " +"コードを作成します。 Nox 関数の例 (別の noxfile.py ファイルに存在します) を以下に示します。" #: ../../maintain-automate/task-runners.md:132 msgid "Trade-offs: declarative vs. imperative" -msgstr "" +msgstr "トレードオフ: 宣言型と命令型" #: ../../maintain-automate/task-runners.md:134 msgid "" -"**Declarative (Hatch, Tox):** Simpler syntax, easier to read and " -"maintain. Might be slightly less flexible for complex logic (this is user" -" dependent)." +"**Declarative (Hatch, Tox):** Simpler syntax, easier to read and maintain. " +"Might be slightly less flexible for complex logic (this is user dependent)." msgstr "" +"**宣言型 (Hatch、Tox):** 構文が単純になり、読みやすく、保守しやすくなります。複雑なロジックの場合は柔軟性が若干劣る可能性があります " +"(これはユーザーに依存します)。" #: ../../maintain-automate/task-runners.md:137 msgid "" "**Imperative (Nox):** You can easily include complex logic and " "conditionals. Because it uses Python, it might be more familiar to you!" -msgstr "" +msgstr "**命令型 (Nox):** 複雑なロジックや条件を簡単に含めることができます。 Pythonを使っているので、より馴染みがあるかもしれません！" #: ../../maintain-automate/task-runners.md:141 msgid "" "Neither approach is inherently better—it depends on your needs and " -"preferences. Projects with complex testing scenarios may benefit from " -"Nox's flexibility, while projects wanting simple, standardized workflows " -"may prefer the clarity of declarative configuration." +"preferences. Projects with complex testing scenarios may benefit from Nox's" +" flexibility, while projects wanting simple, standardized workflows may " +"prefer the clarity of declarative configuration." msgstr "" +"どちらのアプローチが本質的に優れているというわけではなく、ニーズや好みによって異なります。複雑なテストシナリオを伴うプロジェクトは Nox " +"の柔軟性の恩恵を受ける可能性がありますが、シンプルで標準化されたワークフローを必要とするプロジェクトは宣言型構成の明確さを好む場合があります。" #: ../../maintain-automate/task-runners.md:146 msgid "An overview of the core task runners tools that you will find in" -msgstr "" +msgstr "にあるコア タスク ランナー ツールの概要" #: ../../maintain-automate/task-runners.md:147 msgid "the Python ecosystem" -msgstr "" +msgstr "Python エコシステム" #: ../../maintain-automate/task-runners.md:149 msgid "Comparison table" -msgstr "" +msgstr "比較表" #: ../../maintain-automate/task-runners.md:151 msgid "" -"Below you will see a comparison of features associated with each tool. " -"Each tool is then described in a bit more detail just in case you want a " -"better lay of the land." -msgstr "" +"Below you will see a comparison of features associated with each tool. Each" +" tool is then described in a bit more detail just in case you want a better" +" lay of the land." +msgstr "以下に、各ツールに関連する機能の比較を示します。次に、より詳しく知りたい場合に備えて、各ツールについてもう少し詳しく説明します。" #: ../../maintain-automate/task-runners.md msgid "Feature" -msgstr "" +msgstr "特徴" #: ../../maintain-automate/task-runners.md #: ../../maintain-automate/task-runners.md:167 msgid "Hatch" -msgstr "" +msgstr "ハッチ" #: ../../maintain-automate/task-runners.md #: ../../maintain-automate/task-runners.md:223 msgid "Nox" -msgstr "" +msgstr "ノックス" #: ../../maintain-automate/task-runners.md #: ../../maintain-automate/task-runners.md:275 msgid "Tox" -msgstr "" +msgstr "トックス" #: ../../maintain-automate/task-runners.md #: ../../maintain-automate/task-runners.md:321 msgid "Make" -msgstr "" +msgstr "作る" #: ../../maintain-automate/task-runners.md #: ../../maintain-automate/task-runners.md:360 msgid "Just" -msgstr "" +msgstr "ただ" #: ../../maintain-automate/task-runners.md msgid "**Configuration**" -msgstr "" +msgstr "**構成**" #: ../../maintain-automate/task-runners.md msgid "pyproject.toml" -msgstr "" +msgstr "pyproject.toml" #: ../../maintain-automate/task-runners.md msgid "noxfile.py" -msgstr "" +msgstr "noxfile.py" #: ../../maintain-automate/task-runners.md msgid "tox.ini" -msgstr "" +msgstr "tox.ini" #: ../../maintain-automate/task-runners.md msgid "Makefile" -msgstr "" +msgstr "メイクファイル" #: ../../maintain-automate/task-runners.md msgid "justfile" -msgstr "" +msgstr "ジャストファイル" #: ../../maintain-automate/task-runners.md msgid "**Configuration Style**" -msgstr "" +msgstr "**構成スタイル**" #: ../../maintain-automate/task-runners.md msgid "Declarative" -msgstr "" +msgstr "宣言的" #: ../../maintain-automate/task-runners.md msgid "Imperative" -msgstr "" +msgstr "命令的" #: ../../maintain-automate/task-runners.md msgid "**Language**" -msgstr "" +msgstr "**言語**" #: ../../maintain-automate/task-runners.md msgid "TOML" -msgstr "" +msgstr "TOML" #: ../../maintain-automate/task-runners.md msgid "INI/TOML" -msgstr "" +msgstr "INI/TOML" #: ../../maintain-automate/task-runners.md msgid "Make syntax" -msgstr "" +msgstr "構文を作成する" #: ../../maintain-automate/task-runners.md msgid "Just syntax" -msgstr "" +msgstr "構文だけ" #: ../../maintain-automate/task-runners.md msgid "**Python-specific**" -msgstr "" +msgstr "**Python 固有**" #: ../../maintain-automate/task-runners.md msgid "Yes" -msgstr "" +msgstr "はい" #: ../../maintain-automate/task-runners.md msgid "No" -msgstr "" +msgstr "いいえ" #: ../../maintain-automate/task-runners.md msgid "**Environment Management**" -msgstr "" +msgstr "**環境管理**" #: ../../maintain-automate/task-runners.md msgid "**Matrix Testing**" -msgstr "" +msgstr "**マトリックス テスト**" #: ../../maintain-automate/task-runners.md msgid "**Packaging Integration**" -msgstr "" +msgstr "**パッケージの統合**" #: ../../maintain-automate/task-runners.md msgid "**Cross-platform**" -msgstr "" +msgstr "**クロスプラットフォーム**" #: ../../maintain-automate/task-runners.md msgid "Limited" -msgstr "" +msgstr "限定" #: ../../maintain-automate/task-runners.md msgid "**Best For**" -msgstr "" +msgstr "**こんな用途に最適**" #: ../../maintain-automate/task-runners.md msgid "Complete package development" -msgstr "" +msgstr "パッケージ開発を完了する" #: ../../maintain-automate/task-runners.md msgid "Complex testing workflows and other builds" -msgstr "" +msgstr "複雑なテストワークフローとその他のビルド" #: ../../maintain-automate/task-runners.md msgid "Legacy projects, standard testing" -msgstr "" +msgstr "レガシープロジェクト、標準テスト" #: ../../maintain-automate/task-runners.md msgid "Simple tasks" -msgstr "" +msgstr "単純なタスク" #: ../../maintain-automate/task-runners.md msgid "Simple commands" -msgstr "" +msgstr "簡単なコマンド" #: ../../maintain-automate/task-runners.md:169 msgid "" -"[Hatch](https://hatch.pypa.io/) is a modern, all-in-one packaging and " -"task automation tool that simplifies Python package development by " -"handling everything from building and publishing to running tests and " -"formatting code. Hatch is what we use [in our packaging tutorials found " -"in this guidebook](packaging-101)." +"[Hatch](https://hatch.pypa.io/) is a modern, all-in-one packaging and task " +"automation tool that simplifies Python package development by handling " +"everything from building and publishing to running tests and formatting " +"code. Hatch is what we use [in our packaging tutorials found in this " +"guidebook](packaging-101)." msgstr "" +"[Hatch](https://hatch.pypa.io/) は、最新のオールインワン " +"パッケージ化およびタスク自動化ツールで、ビルドと公開からテストの実行とコードのフォーマットまですべてを処理することで、Python " +"パッケージ開発を簡素化します。ハッチは、[このガイドブックにあるパッケージング チュートリアルで]使用するものです(packaging-101)。" #: ../../maintain-automate/task-runners.md:174 msgid "Why we like Hatch" -msgstr "" +msgstr "ハッチが好きな理由" #: ../../maintain-automate/task-runners.md:176 msgid "" -"Hatch stands out because it's a single tool that handles both packaging " -"AND task running. Instead of juggling multiple tools, you configure " -"everything in your `pyproject.toml` file—no extra configuration files " -"needed. Hatch creates isolated environments for different tasks (like " -"testing or building docs) and integrates with UV for extremely fast " -"environment setup. It uses a declarative, clean syntax that's easy to " -"read and maintain, and it supports matrix testing so you can easily test " -"your package across multiple Python versions." -msgstr "" +"Hatch stands out because it's a single tool that handles both packaging AND" +" task running. Instead of juggling multiple tools, you configure everything" +" in your `pyproject.toml` file—no extra configuration files needed. Hatch " +"creates isolated environments for different tasks (like testing or building" +" docs) and integrates with UV for extremely fast environment setup. It uses" +" a declarative, clean syntax that's easy to read and maintain, and it " +"supports matrix testing so you can easily test your package across multiple" +" Python versions." +msgstr "" +"Hatch " +"が際立っているのは、パッケージ化とタスクの実行の両方を単一のツールで処理できるためです。複数のツールを使いこなす代わりに、「pyproject.toml」ファイルですべてを設定します。追加の設定ファイルは必要ありません。" +" Hatch は、さまざまなタスク (ドキュメントのテストや構築など) 用に分離された環境を作成し、UV " +"と統合して非常に高速な環境セットアップを実現します。読みやすく保守しやすい宣言的でクリーンな構文を使用しており、マトリックス " +"テストをサポートしているため、複数の Python バージョンにわたってパッケージを簡単にテストできます。" #: ../../maintain-automate/task-runners.md:185 msgid "When to use Hatch" -msgstr "" +msgstr "ハッチを使用する場合" #: ../../maintain-automate/task-runners.md:187 msgid "" -"Hatch is ideal for complete package development workflows. You can use it" -" for testing across Python versions, building documentation, running code" -" formatters and linters, and building and publishing your package to " -"PyPI. If you want a modern, all-in-one solution that follows current " -"Python packaging standards (like PEP 621), Hatch is an excellent choice." +"Hatch is ideal for complete package development workflows. You can use it " +"for testing across Python versions, building documentation, running code " +"formatters and linters, and building and publishing your package to PyPI. " +"If you want a modern, all-in-one solution that follows current Python " +"packaging standards (like PEP 621), Hatch is an excellent choice." msgstr "" +"Hatch は、完全なパッケージ開発ワークフローに最適です。これは、Python バージョン間でのテスト、ドキュメントの構築、コード " +"フォーマッタとリンターの実行、パッケージの構築と PyPI への公開に使用できます。現在の Python パッケージ標準 (PEP 621 など) " +"に準拠した最新のオールインワン ソリューションが必要な場合、Hatch は優れた選択肢です。" #: ../../maintain-automate/task-runners.md:194 #: ../../maintain-automate/task-runners.md:251 @@ -1271,15 +1664,18 @@ msgstr "" #: ../../maintain-automate/task-runners.md:344 #: ../../maintain-automate/task-runners.md:383 msgid "Example configuration" -msgstr "" +msgstr "構成例" #: ../../maintain-automate/task-runners.md:196 msgid "" -"Below is an example of how you'd set up a test environment in Hatch. This" -" configuration creates a `test` environment with pytest and pytest-cov " -"installed, defines a `run` script to execute your tests, and sets up " -"matrix testing to run tests on Python 3.10, 3.11, and 3.12:" +"Below is an example of how you'd set up a test environment in Hatch. This " +"configuration creates a `test` environment with pytest and pytest-cov " +"installed, defines a `run` script to execute your tests, and sets up matrix" +" testing to run tests on Python 3.10, 3.11, and 3.12:" msgstr "" +"以下は、Hatch でテスト環境をセットアップする方法の例です。この構成では、pytest と pytest-cov " +"がインストールされた「test」環境を作成し、テストを実行する「run」スクリプトを定義し、Python 3.10、3.11、および 3.12 " +"でテストを実行するためのマトリックス テストを設定します。" #: ../../maintain-automate/task-runners.md:217 #: ../../maintain-automate/task-runners.md:269 @@ -1287,27 +1683,29 @@ msgstr "" #: ../../maintain-automate/task-runners.md:356 #: ../../maintain-automate/task-runners.md:396 msgid "You would run the above in your terminal using:" -msgstr "" +msgstr "以下を使用してターミナルで上記を実行します。" #: ../../maintain-automate/task-runners.md:219 msgid "`hatch run test:run`" -msgstr "" +msgstr "`ハッチ実行テスト:実行`" #: ../../maintain-automate/task-runners.md:221 msgid "**Learn more:** [Hatch documentation](https://hatch.pypa.io/)" -msgstr "" +msgstr "**詳細:** [Hatch ドキュメント](https://hatch.pypa.io/)" #: ../../maintain-automate/task-runners.md:225 msgid "" -"[Nox](https://nox.thea.codes/) is a Python-based automation toolkit " -"focused on testing across environments. It uses a code-based (imperative)" -" configuration approach that gives you maximum flexibility for complex " +"[Nox](https://nox.thea.codes/) is a Python-based automation toolkit focused" +" on testing across environments. It uses a code-based (imperative) " +"configuration approach that gives you maximum flexibility for complex " "testing workflows." msgstr "" +"[Nox](https://nox.thea.codes/) は、複数の環境にわたるテストに焦点を当てた Python " +"ベースの自動化ツールキットです。コードベースの (命令型) 構成アプローチを使用しており、複雑なテスト ワークフローに最大限の柔軟性をもたらします。" #: ../../maintain-automate/task-runners.md:230 msgid "Why we like Nox" -msgstr "" +msgstr "Nox が好きな理由" #: ../../maintain-automate/task-runners.md:232 msgid "" @@ -1316,39 +1714,51 @@ msgid "" "automation workflows. Because sessions are written in Python, they're " "explicit, easy to inspect, and straightforward to debug. Nox is " "particularly powerful for handling complex test and build scenarios that " -"some packages require, and it's especially popular in the Scientific " -"Python ecosystem. You'll find many pyOpenSci documentation repositories " -"use Nox to automate workflows such as building and testing documentation." +"some packages require, and it's especially popular in the Scientific Python" +" ecosystem. You'll find many pyOpenSci documentation repositories use Nox " +"to automate workflows such as building and testing documentation." msgstr "" +"Nox が際立っているのは、Python " +"コードを使用してタスクを定義しているためです。つまり、複雑なロジックや条件を自動化ワークフローに直接組み込むことができます。セッションは Python" +" で記述されているため、明示的であり、検査が簡単で、デバッグも簡単です。 Nox は、一部のパッケージで必要とされる複雑なテストおよびビルド " +"シナリオの処理に特に強力であり、Scientific Python エコシステムで特に人気があります。多くの pyOpenSci ドキュメント " +"リポジトリが Nox を使用してドキュメントの構築やテストなどのワークフローを自動化していることがわかります。" #: ../../maintain-automate/task-runners.md:242 msgid "When to use Nox" -msgstr "" +msgstr "Nox を使用する場合" #: ../../maintain-automate/task-runners.md:244 msgid "" -"Nox is ideal when you need complex testing scenarios with conditional " -"logic or when you prefer Python-based configuration over declarative " -"formats. It's excellent for testing across Python versions and managing " -"multiple testing environments. If packaging is handled separately and you" -" want maximum flexibility in your task automation, Nox is a great choice." +"Nox is ideal when you need complex testing scenarios with conditional logic" +" or when you prefer Python-based configuration over declarative formats. " +"It's excellent for testing across Python versions and managing multiple " +"testing environments. If packaging is handled separately and you want " +"maximum flexibility in your task automation, Nox is a great choice." msgstr "" +"Nox は、条件付きロジックを使用した複雑なテスト シナリオが必要な場合、または宣言形式よりも Python ベースの構成を好む場合に最適です。 " +"Python " +"のバージョン間でのテストや、複数のテスト環境の管理に最適です。パッケージ化が個別に処理され、タスクの自動化に最大限の柔軟性が必要な場合は、Nox " +"が最適な選択肢です。" #: ../../maintain-automate/task-runners.md:253 msgid "" -"Below is an example of a Nox session that runs tests across multiple " -"Python versions. The `@nox.session` decorator defines a session (similar " -"to a task), and you specify which Python versions to test with. Nox will " -"create isolated environments for each version and run your tests:" +"Below is an example of a Nox session that runs tests across multiple Python" +" versions. The `@nox.session` decorator defines a session (similar to a " +"task), and you specify which Python versions to test with. Nox will create " +"isolated environments for each version and run your tests:" msgstr "" +"以下は、複数の Python バージョンにわたってテストを実行する Nox セッションの例です。 `@nox.session` " +"デコレーターはセッション (タスクと同様) を定義し、テストに使用する Python バージョンを指定します。 Nox " +"はバージョンごとに隔離された環境を作成し、テストを実行します。" #: ../../maintain-automate/task-runners.md:271 msgid "`nox -s tests`" -msgstr "" +msgstr "「nox -s テスト」" #: ../../maintain-automate/task-runners.md:273 msgid "**Learn more:** [Nox documentation](https://nox.thea.codes/)" -msgstr "" +msgstr "**詳細:** [Nox ドキュメント](https://nox.thea.codes/)" #: ../../maintain-automate/task-runners.md:277 msgid "" @@ -1356,235 +1766,263 @@ msgid "" "multiple environments. It uses declarative configuration and has been a " "standard in the Python community for years." msgstr "" +"[Tox](https://tox.wiki/) " +"は、複数の環境でテストするための成熟した自動化ツールです。これは宣言型構成を使用しており、Python " +"コミュニティでは長年にわたり標準となっています。" #: ../../maintain-automate/task-runners.md:281 msgid "Why people use Tox" -msgstr "" +msgstr "なぜ人々はToxを使用するのか" #: ../../maintain-automate/task-runners.md:283 msgid "" -"Tox is mature and stable, with a long history in the Python ecosystem. It" -" uses declarative configuration (traditionally INI format, though TOML " +"Tox is mature and stable, with a long history in the Python ecosystem. It " +"uses declarative configuration (traditionally INI format, though TOML " "support was added recently) and is particularly good for testing across " "Python versions and dependency sets. Many projects use Tox because it " "integrates well with CI/CD systems and has a robust plugin ecosystem." msgstr "" +"Tox は成熟していて安定しており、Python エコシステム内で長い歴史があります。宣言型構成 (最近 TOML " +"サポートが追加されましたが、伝統的に INI 形式) を使用しており、Python のバージョンと依存関係セットにわたるテストに特に適しています。 " +"Tox は CI/CD システムとうまく統合され、堅牢なプラグイン エコシステムを備えているため、多くのプロジェクトで Tox が使用されています。" #: ../../maintain-automate/task-runners.md:290 msgid "When to use Tox" -msgstr "" +msgstr "トックスをいつ使用するか" #: ../../maintain-automate/task-runners.md:292 msgid "" -"Tox is ideal if you're maintaining a legacy project that already uses it," -" or if you have existing `tox.ini` configuration you want to preserve. " -"It's also a good choice if you need specific Tox plugins or prefer " -"declarative configuration separate from your packaging tools. However, " -"keep in mind that Tox can be slower than modern alternatives like Hatch." +"Tox is ideal if you're maintaining a legacy project that already uses it, " +"or if you have existing `tox.ini` configuration you want to preserve. It's " +"also a good choice if you need specific Tox plugins or prefer declarative " +"configuration separate from your packaging tools. However, keep in mind " +"that Tox can be slower than modern alternatives like Hatch." msgstr "" +"Tox は、既に使用しているレガシー プロジェクトを維持している場合、または保存したい既存の `tox.ini` 設定がある場合に最適です。特定の " +"Tox プラグインが必要な場合や、パッケージ化ツールとは別の宣言型構成を希望する場合にも、これは良い選択です。ただし、Tox は Hatch " +"などの最新の代替手段よりも遅い可能性があることに注意してください。" #: ../../maintain-automate/task-runners.md:301 msgid "" -"Below is an example of a Tox configuration that runs tests across " -"multiple Python versions. The `envlist` specifies which Python versions " -"to test, and the `testenv` section defines what to install and run:" +"Below is an example of a Tox configuration that runs tests across multiple " +"Python versions. The `envlist` specifies which Python versions to test, and" +" the `testenv` section defines what to install and run:" msgstr "" +"以下は、複数の Python バージョンにわたってテストを実行する Tox 構成の例です。 「envlist」はテストする Python " +"バージョンを指定し、「testenv」セクションは何をインストールして実行するかを定義します。" #: ../../maintain-automate/task-runners.md:317 msgid "" "`tox` (runs all environments) or `tox -e py310` (runs a specific " "environment)" -msgstr "" +msgstr "`tox` (すべての環境を実行) または `tox -e py310` (特定の環境を実行)" #: ../../maintain-automate/task-runners.md:319 msgid "**Learn more:** [Tox documentation](https://tox.wiki/)" -msgstr "" +msgstr "**さらに詳しく:** [Tox ドキュメント](https://tox.wiki/)" #: ../../maintain-automate/task-runners.md:323 msgid "" "[Make](https://www.gnu.org/software/make/) is a traditional build " -"automation tool that uses Makefiles. It's been around since the 1970s and" -" is widely used across many programming languages." +"automation tool that uses Makefiles. It's been around since the 1970s and " +"is widely used across many programming languages." msgstr "" +"[Make](https://www.gnu.org/software/make/) は、Makefile を使用する従来のビルド自動化ツールです。 " +"1970 年代から存在し、多くのプログラミング言語で広く使用されています。" #: ../../maintain-automate/task-runners.md:327 msgid "Why people use Make" -msgstr "" +msgstr "Make を使用する理由" #: ../../maintain-automate/task-runners.md:329 msgid "" "Make is widely known and available on most systems, making it a familiar " "choice for many developers. It has simple syntax for basic tasks and " -"executes very quickly. Because it's not Python-specific, you can use it " -"to coordinate tasks across different languages in the same project." +"executes very quickly. Because it's not Python-specific, you can use it to " +"coordinate tasks across different languages in the same project." msgstr "" +"Make " +"は広く知られており、ほとんどのシステムで利用できるため、多くの開発者にとって馴染みのある選択肢となっています。基本的なタスク用の単純な構文を備えており、非常に高速に実行されます。これは" +" Python 固有ではないため、同じプロジェクト内の異なる言語間でタスクを調整するために使用できます。" #: ../../maintain-automate/task-runners.md:335 msgid "When to use Make" -msgstr "" +msgstr "Make を使用する場合" #: ../../maintain-automate/task-runners.md:337 msgid "" -"Make is best for simple task automation when you don't need Python-" -"specific features or environment management. It's a good lightweight " -"option if you want something fast and universally available. However, be " -"aware that Make can have cross-platform compatibility issues, especially " -"on Windows, and you'll need to handle Python environment management " -"separately." +"Make is best for simple task automation when you don't need Python-specific" +" features or environment management. It's a good lightweight option if you " +"want something fast and universally available. However, be aware that Make " +"can have cross-platform compatibility issues, especially on Windows, and " +"you'll need to handle Python environment management separately." msgstr "" +"Make は、Python " +"固有の機能や環境管理が必要ない場合の単純なタスクの自動化に最適です。高速で誰でも利用できるものが必要な場合には、これは優れた軽量オプションです。ただし、Make" +" には、特に Windows 上でクロスプラットフォーム互換性の問題が発生する可能性があり、Python " +"環境の管理を個別に処理する必要があることに注意してください。" #: ../../maintain-automate/task-runners.md:346 msgid "" "Below is an example of a simple Makefile with tasks for testing and " "building documentation:" -msgstr "" +msgstr "以下は、ドキュメントのテストと構築のためのタスクを含む単純な Makefile の例です。" #: ../../maintain-automate/task-runners.md:358 msgid "`make test` or `make docs`" -msgstr "" +msgstr "`make test` または `make docs`" #: ../../maintain-automate/task-runners.md:362 msgid "" "[Just](https://just.systems/) is a modern command runner written in Rust " "that offers a simpler, more user-friendly alternative to Make." msgstr "" +"[Just](https://just.systems/) は、Rust で書かれた最新のコマンド ランナーで、Make " +"のよりシンプルでユーザーフレンドリーな代替手段を提供します。" #: ../../maintain-automate/task-runners.md:365 msgid "Why people use Just" -msgstr "" +msgstr "Just を使用する理由" #: ../../maintain-automate/task-runners.md:367 msgid "" -"Just has simple, Make-like syntax but with better error messages and more" -" intuitive behavior. It's fast, truly cross-platform (unlike Make), and " -"easy to learn. The tool is written in Rust, which makes it very " -"performant, and it avoids many of the quirks and gotchas that Make has " -"accumulated over decades." +"Just has simple, Make-like syntax but with better error messages and more " +"intuitive behavior. It's fast, truly cross-platform (unlike Make), and easy" +" to learn. The tool is written in Rust, which makes it very performant, and" +" it avoids many of the quirks and gotchas that Make has accumulated over " +"decades." msgstr "" +"シンプルで Make に似た構文を持ちますが、エラー メッセージが改善され、動作がより直感的になります。これは高速で、真にクロスプラットフォームで " +"(Make とは異なり)、習得が簡単です。このツールは Rust で書かれているため、非常にパフォーマンスが高く、Make " +"が数十年にわたって蓄積してきた癖や注意点の多くが回避されています。" #: ../../maintain-automate/task-runners.md:373 msgid "When to use Just" -msgstr "" +msgstr "「ジャスト」を使用する場合" #: ../../maintain-automate/task-runners.md:375 msgid "" -"Just is ideal when you need a lightweight command runner for simple tasks" -" and don't require Python-specific features or environment management. " -"It's a great choice if you want something faster and more modern than " -"Make, with better cross-platform support. However, keep in mind that Just" -" requires separate installation and has less integration with the Python " -"packaging ecosystem compared to tools like Hatch or Nox." +"Just is ideal when you need a lightweight command runner for simple tasks " +"and don't require Python-specific features or environment management. It's " +"a great choice if you want something faster and more modern than Make, with" +" better cross-platform support. However, keep in mind that Just requires " +"separate installation and has less integration with the Python packaging " +"ecosystem compared to tools like Hatch or Nox." msgstr "" +"Just は、単純なタスク用の軽量のコマンド ランナーが必要で、Python 固有の機能や環境管理を必要としない場合に最適です。 Make " +"よりも高速で最新の、より優れたクロスプラットフォーム サポートが必要な場合は、これが最適な選択です。ただし、Just " +"は個別のインストールが必要であり、Hatch や Nox などのツールと比べて Python " +"パッケージ化エコシステムとの統合が少ないことに注意してください。" #: ../../maintain-automate/task-runners.md:385 msgid "" "Below is an example of a justfile with tasks for testing and building " "documentation:" -msgstr "" +msgstr "以下は、ドキュメントのテストと構築のためのタスクを含む justfile の例です。" #: ../../maintain-automate/task-runners.md:398 msgid "`just test` or `just docs`" -msgstr "" +msgstr "「テストだけ」または「ドキュメントだけ」" #: ../../maintain-automate/task-runners.md:400 msgid "**Learn more:** [Just documentation](https://just.systems/)" -msgstr "" +msgstr "**詳細:** [Just ドキュメント](https://just.systems/)" #: ../../maintain-automate/task-runners.md:402 msgid "Choosing the right task runner" -msgstr "" +msgstr "適切なタスク ランナーの選択" #: ../../maintain-automate/task-runners.md:404 msgid "**Choose Hatch if:**" -msgstr "" +msgstr "**次の場合はハッチングを選択してください:**" #: ../../maintain-automate/task-runners.md:406 msgid "You're building a Python package" -msgstr "" +msgstr "Python パッケージを構築しています" #: ../../maintain-automate/task-runners.md:407 msgid "You want an all-in-one tool" -msgstr "" +msgstr "オールインワンツールが欲しい" #: ../../maintain-automate/task-runners.md:408 msgid "You prefer configuration in pyproject.toml" -msgstr "" +msgstr "pyproject.toml での設定を希望する場合" #: ../../maintain-automate/task-runners.md:409 msgid "You want fast environment management" -msgstr "" +msgstr "迅速な環境管理が必要な場合" #: ../../maintain-automate/task-runners.md:410 msgid "You prefer declarative configuration" -msgstr "" +msgstr "宣言型構成を好む場合" #: ../../maintain-automate/task-runners.md:412 msgid "**Choose Nox if:**" -msgstr "" +msgstr "**次の場合は Nox を選択してください:**" #: ../../maintain-automate/task-runners.md:414 msgid "You need complex testing scenarios with conditional logic" -msgstr "" +msgstr "条件付きロジックを使用した複雑なテスト シナリオが必要な場合" #: ../../maintain-automate/task-runners.md:415 msgid "You prefer Python-based, imperative configuration" -msgstr "" +msgstr "Python ベースの命令型構成を好む場合" #: ../../maintain-automate/task-runners.md:416 msgid "You're working in the Scientific Python ecosystem" -msgstr "" +msgstr "あなたは Scientific Python エコシステムで働いています" #: ../../maintain-automate/task-runners.md:417 msgid "Packaging is handled separately" -msgstr "" +msgstr "梱包は別途対応させていただきます" #: ../../maintain-automate/task-runners.md:418 msgid "You want maximum flexibility" -msgstr "" +msgstr "最大限の柔軟性が必要な場合" #: ../../maintain-automate/task-runners.md:420 msgid "**Choose Tox if:**" -msgstr "" +msgstr "**次の場合は Tox を選択してください:**" #: ../../maintain-automate/task-runners.md:422 msgid "You're maintaining a legacy project already using it" -msgstr "" +msgstr "すでに使用しているレガシー プロジェクトを維持している" #: ../../maintain-automate/task-runners.md:423 msgid "You have existing tox.ini configuration" -msgstr "" +msgstr "既存の tox.ini 設定がある" #: ../../maintain-automate/task-runners.md:424 msgid "You need specific tox plugins" -msgstr "" +msgstr "特定の有害なプラグインが必要です" #: ../../maintain-automate/task-runners.md:425 msgid "You prefer declarative configuration separate from packaging" -msgstr "" +msgstr "パッケージ化とは別に宣言的な構成を好む場合" #: ../../maintain-automate/task-runners.md:427 msgid "**Choose Make or Just if:**" -msgstr "" +msgstr "**Make または Just if を選択してください:**" #: ../../maintain-automate/task-runners.md:429 msgid "You need a lightweight command runner" -msgstr "" +msgstr "軽量のコマンドランナーが必要です" #: ../../maintain-automate/task-runners.md:430 msgid "You're not doing Python-specific workflows" -msgstr "" +msgstr "Python 固有のワークフローを実行していない" #: ../../maintain-automate/task-runners.md:431 msgid "You want something simple and fast" -msgstr "" +msgstr "シンプルで速いものが欲しい" #: ../../maintain-automate/task-runners.md:432 msgid "You don't need environment management" -msgstr "" +msgstr "環境管理は必要ありません" #: ../../maintain-automate/task-runners.md:434 msgid "Next steps" -msgstr "" +msgstr "次のステップ" #: ../../maintain-automate/task-runners.md:436 msgid "" @@ -1592,12 +2030,14 @@ msgid "" "environments](https://hatch.pypa.io/latest/tutorials/environment/basic-" "usage/)" msgstr "" +"[ハッチ環境](https://hatch.pypa.io/latest/tutorials/environment/basic-usage/) " +"の使用方法を学ぶ" #: ../../maintain-automate/task-runners.md:437 msgid "" "[Create a package using the Python package tutorial.](create-pure-python-" "package)" -msgstr "" +msgstr "[Python パッケージ チュートリアルを使用してパッケージを作成します。](create-pure-python-package)" #: ../../maintain-automate/task-runners.md:438 msgid "" @@ -1605,6 +2045,8 @@ msgid "" "template](https://github.com/pyOpenSci/pyos-package-template) with pre-" "configured Hatch tasks" msgstr "" +"[pyOpenSci パッケージ テンプレート](https://github.com/pyOpenSci/pyos-package-" +"template) を調べて、事前構成された Hatch タスクとともに使用します" #: ../../maintain-automate/task-runners.md:441 msgid "" @@ -1613,3 +2055,6 @@ msgid "" "This guide is excellent if you plan to use nox as your task runner as it " "has lots of examples that you can follow." msgstr "" +"[タスク ランナーに関する Scientific Python 開発ガイド](https://learn.scientific-" +"python.org/development/guides/tasks/) を読んでください。このガイドには、従うべき例がたくさんあるため、nox " +"をタスクランナーとして使用する予定がある場合に最適です。" diff --git a/locales/ja/LC_MESSAGES/package-structure-code.po b/locales/ja/LC_MESSAGES/package-structure-code.po index 79f923f2..b0162d8f 100644 --- a/locales/ja/LC_MESSAGES/package-structure-code.po +++ b/locales/ja/LC_MESSAGES/package-structure-code.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: pyOpenSci Python Package Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-05-22 12:19-0700\n" +"POT-Creation-Date: 2026-08-25 07:47+0900\n" "PO-Revision-Date: 2025-04-14 18:12+0000\n" "Last-Translator: Tetsuo Koyama , 2025\n" "Language: ja\n" @@ -37,8 +37,8 @@ msgstr "pyOpenSciは、作者がPEP 8コードフォーマットガイドライ #: ../../package-structure-code/code-style-linting-format.md:6 msgid "" -"Setting up a code formatters like Black and isort will help you enforce " -"PEP 8 style guidelines and also consistent, readable code format" +"Setting up a code formatters like Black and isort will help you enforce PEP" +" 8 style guidelines and also consistent, readable code format" msgstr "" "Blackやisortのようなコードフォーマッタを設定することで、PEP " "8のスタイルガイドラインを実施し、一貫性のある読みやすいコードフォーマットにすることができます。" @@ -49,16 +49,16 @@ msgstr "よく使われるツールは以下の通り： Black、Isort、flake8 #: ../../package-structure-code/code-style-linting-format.md:8 msgid "" -"You can also setup pre-commit hooks which will run code formatters " -"locally each time you make a commit." +"You can also setup pre-commit hooks which will run code formatters locally " +"each time you make a commit." msgstr "また、コミット前にフックをセットアップして、コミットするたびにコードフォーマッタをローカルで実行することもできます。" #: ../../package-structure-code/code-style-linting-format.md:10 msgid "" "[precommit.ci](https://pre-commit.ci/) is a bot that you can add to your " "GitHub repository. It will automagically apply code format to every PR " -"using the tools specified in your pre-commit-config.yaml file. It can " -"save significant time and make contributions easier for new contributors." +"using the tools specified in your pre-commit-config.yaml file. It can save " +"significant time and make contributions easier for new contributors." msgstr "" "[precommit.ci](https://pre-commit.ci/) は、GitHub リポジトリに追加できるボットです。 pre-" "commit-config.yaml ファイルで指定したツールを使って、すべての PR にコードフォーマットを自動的に適用します。 " @@ -66,15 +66,15 @@ msgstr "" #: ../../package-structure-code/code-style-linting-format.md:11 msgid "" -"Automation is good! By making code quality tools care of your code, you " -"can focus on structural and high values tasks." +"Automation is good! By making code quality tools care of your code, you can" +" focus on structural and high values tasks." msgstr "自動化は良いことです! コードクオリティツールにコードを管理させることで、あなたは構造的で価値の高いタスクに集中することができます。" #: ../../package-structure-code/code-style-linting-format.md:14 msgid "" -"Consistent code format and style is useful to both your package and " -"across the scientific Python ecosystem because using similar formats " -"makes code easier to read." +"Consistent code format and style is useful to both your package and across " +"the scientific Python ecosystem because using similar formats makes code " +"easier to read." msgstr "一貫したコードフォーマットとスタイルは、あなたのパッケージにとっても、科学的なPythonエコシステム全体にとっても有用です、なぜなら、同じようなフォーマットを使うことでコードが読みやすくなるからです。" #: ../../package-structure-code/code-style-linting-format.md:18 @@ -85,18 +85,18 @@ msgstr "例えば、空白や句読点のないこのような文章を見た場 #: ../../package-structure-code/code-style-linting-format.md:25 msgid "" -"pyOpenSci peer review process requires that you to follow standard " -"[Python PEP 8 format rules](https://peps.python.org/pep-0008/) as closely" -" as you can." +"pyOpenSci peer review process requires that you to follow standard [Python " +"PEP 8 format rules](https://peps.python.org/pep-0008/) as closely as you " +"can." msgstr "" "pyOpenSciの査読プロセスでは、標準的な [Python PEP 8 format " "rules](https://peps.python.org/pep-0008/) にできるだけ忠実に従うことが求められます。" #: ../../package-structure-code/code-style-linting-format.md:29 msgid "" -"pyOpenSci doesn't require you to use a specific code format tool. " -"However, we do look for consistency and readability in code style. Below " -"you will find a discussion of:" +"pyOpenSci doesn't require you to use a specific code format tool. However, " +"we do look for consistency and readability in code style. Below you will " +"find a discussion of:" msgstr "" "pyOpenSciは特定のコードフォーマットツールを使うことを要求しません。 しかし、コードスタイルに一貫性と読みやすさを求めています。 " "以下は、その考察です:" @@ -160,8 +160,8 @@ msgstr "コードレビューが付加価値に焦点を当てるように、コ #: ../../package-structure-code/code-style-linting-format.md:55 msgid "" -"Many packages use a suite of tools to apply code format rules, taking the" -" work out of manually implementing code format requirements." +"Many packages use a suite of tools to apply code format rules, taking the " +"work out of manually implementing code format requirements." msgstr "多くのパッケージは、コードフォーマット規則を適用するために一連のツールを使用しており、手作業でコードフォーマット要件を実装する手間を省いています。" #: ../../package-structure-code/code-style-linting-format.md:58 @@ -187,10 +187,10 @@ msgstr "コードリンティング" #: ../../package-structure-code/code-style-linting-format.md:67 msgid "" -"A code linter is a tool that will review your code and identify errors or" -" issues. A linter typically does not modify your code. It will tell you " -"what the error is and on what line it was discovered. Flake8, discussed " -"below, is an example of a commonly-used code linter." +"A code linter is a tool that will review your code and identify errors or " +"issues. A linter typically does not modify your code. It will tell you what" +" the error is and on what line it was discovered. Flake8, discussed below, " +"is an example of a commonly-used code linter." msgstr "" "コードリンターは、コードをレビューしてエラーや問題を特定するツールです。 リンターは通常、あなたのコードを修正しません。 " "エラーが何であり、どの行で発見されたかを教えてくれます。 後述するFlake8は、よく使われるコードリンターの一例です。" @@ -203,17 +203,17 @@ msgstr "コードフォーマッタ（およびスタイラーズ）" #: ../../package-structure-code/code-style-linting-format.md:74 msgid "" "Code formatters will reformat your code for you. Python focused code " -"formatters often follow PEP 8 standards. However, they also make " -"stylistic decisions about code consistency." +"formatters often follow PEP 8 standards. However, they also make stylistic " +"decisions about code consistency." msgstr "" -"コードフォーマッタはあなたのコードを再フォーマットしてくれます。 Python に特化したコードフォーマッタは PEP 8 " -"標準に従うことが多いです。 しかし、コードの一貫性に関する文体的な決定も行います。" +"コードフォーマッタはあなたのコードを再フォーマットしてくれます。 Python に特化したコードフォーマッタは PEP 8 標準に従うことが多いです。" +" しかし、コードの一貫性に関する文体的な決定も行います。" #: ../../package-structure-code/code-style-linting-format.md:78 msgid "" -"Black is an example of a commonly-used code formatter. Black both applies" -" PEP 8 standards while also making decisions about things like consistent" -" use of double quotes for strings, and spacing of items in lists." +"Black is an example of a commonly-used code formatter. Black both applies " +"PEP 8 standards while also making decisions about things like consistent " +"use of double quotes for strings, and spacing of items in lists." msgstr "" "Blackはよく使われるコードフォーマッターの一例です。 BlackはPEP " "8の標準を適用すると同時に、文字列に対する二重引用符の一貫した使用や、リスト内の項目のスペーシングなどについても決定しています。" @@ -232,11 +232,11 @@ msgstr "Black" #: ../../package-structure-code/code-style-linting-format.md:89 msgid "" -"[Black](https://black.readthedocs.io/en/stable/) is a code formatter. " -"Black will automagically (and _unapologetically_) fix spacing issues and " -"ensure code format is consistent throughout your package. Black also " -"generally adheres to PEP 8 style guidelines with some exceptions. A few " -"examples of those exceptions are below:" +"[Black](https://black.readthedocs.io/en/stable/) is a code formatter. Black" +" will automagically (and _unapologetically_) fix spacing issues and ensure " +"code format is consistent throughout your package. Black also generally " +"adheres to PEP 8 style guidelines with some exceptions. A few examples of " +"those exceptions are below:" msgstr "" "[Black](https://black.readthedocs.io/en/stable/) はコードフォーマッタです。 " "Blackは自動的に(そして _unapologetically_ " @@ -246,8 +246,8 @@ msgstr "" #: ../../package-structure-code/code-style-linting-format.md:95 msgid "" "Black defaults to a line length of 88 (79 + 10%) rather than the 79 " -"character `PEP 8` specification. However, line length is a setting can be" -" manually overwritten in your Black configuration." +"character `PEP 8` specification. However, line length is a setting can be " +"manually overwritten in your Black configuration." msgstr "" "Blackのデフォルトの行の長さは、79文字の `PEP 8` 仕様ではなく、88 (79 + 10%) です。 しかし、行の長さは Black " "の設定で手動で上書きすることができます。" @@ -258,11 +258,9 @@ msgstr "Blackはコメントやdocstringの行の長さを調整しません。" #: ../../package-structure-code/code-style-linting-format.md:97 msgid "" -"This tool will not review and fix import order (you need `isort` or " -"`ruff` to do that - see below)." -msgstr "" -"このツールはインポートの順番を見直したり修正したりはしません（そのためには `isort` や `ruff` が必要です - " -"下記を参照してください）。" +"This tool will not review and fix import order (you need `isort` or `ruff` " +"to do that - see below)." +msgstr "このツールはインポートの順番を見直したり修正したりはしません（そのためには `isort` や `ruff` が必要です - 下記を参照してください）。" #: ../../package-structure-code/code-style-linting-format.md:100 msgid "" @@ -274,8 +272,8 @@ msgstr "" #: ../../package-structure-code/code-style-linting-format.md:104 msgid "" -"Using a code formatter like Black will leave you more time to work on " -"code function rather than worry about format." +"Using a code formatter like Black will leave you more time to work on code " +"function rather than worry about format." msgstr "Blackのようなコードフォーマッターを使うことで、書式を気にするよりもコードの機能に時間を割くことができます。" #: ../../package-structure-code/code-style-linting-format.md:108 @@ -285,8 +283,7 @@ msgstr "Flake8" #: ../../package-structure-code/code-style-linting-format.md:110 msgid "" "To adhere to Python `pep8` format standards, you might want to add " -"[flake8](https://flake8.pycqa.org/en/latest/) to your code format " -"toolbox." +"[flake8](https://flake8.pycqa.org/en/latest/) to your code format toolbox." msgstr "" "Python の `pep8` " "フォーマットの標準に準拠するために、[flake8](https://flake8.pycqa.org/en/latest/) " @@ -298,8 +295,8 @@ msgstr "flake8 は:" #: ../../package-structure-code/code-style-linting-format.md:116 msgid "" -"Flag every line in your code that extends beyond 79 characters (including" -" those in docstrings and comments)" +"Flag every line in your code that extends beyond 79 characters (including " +"those in docstrings and comments)" msgstr "コード中の79文字を超えるすべての行にフラグを付ける（docstringやコメント中の行も含む）" #: ../../package-structure-code/code-style-linting-format.md:117 @@ -316,8 +313,8 @@ msgstr "Flake8はまた、モジュール内の未使用のインポートや未 #: ../../package-structure-code/code-style-linting-format.md:122 msgid "" -"Below you can see the output of running `flake8 filename.py` at the " -"command line for a Python file within a package called `stravalib`." +"Below you can see the output of running `flake8 filename.py` at the command" +" line for a Python file within a package called `stravalib`." msgstr "" "下記は `stravalib` というパッケージ内の Python ファイルに対してコマンドラインで `flake8 filename.py` " "を実行したときの出力です。" @@ -328,9 +325,9 @@ msgstr "PEP 8の行の長さの標準は79文字です。" #: ../../package-structure-code/code-style-linting-format.md:128 msgid "" -"Notice that flake8 returns a list of issues that it found in the model.py" -" module on the command line. The Python file itself is not modified. " -"Using this output, you can fix each issue line by line manually." +"Notice that flake8 returns a list of issues that it found in the model.py " +"module on the command line. The Python file itself is not modified. Using " +"this output, you can fix each issue line by line manually." msgstr "" "flake8はコマンドラインでmodel.pyモジュールで見つかった問題のリストを返すことに注意してください。 " "Pythonファイル自体は変更されません。 この出力を使って、問題を一行ずつ手作業で修正することができます。" @@ -341,9 +338,9 @@ msgstr "Isort" #: ../../package-structure-code/code-style-linting-format.md:145 msgid "" -"Python imports refer to the Python packages that a module in your package" -" requires. Imports should always be located at the top of each Python " -"module in your package." +"Python imports refer to the Python packages that a module in your package " +"requires. Imports should always be located at the top of each Python module" +" in your package." msgstr "" "Python import は、あなたのパッケージのモジュールが必要とする Python パッケージを指します。 " "importsは常にパッケージ内の各Pythonモジュールの先頭に配置されるべきです。" @@ -376,17 +373,17 @@ msgstr "ローカルアプリケーション/ライブラリ固有のインポ #: ../../package-structure-code/code-style-linting-format.md:157 msgid "" -"While `flake8` will identify unused imports in your code, it won't fix or" -" identify issues with the order of package imports." +"While `flake8` will identify unused imports in your code, it won't fix or " +"identify issues with the order of package imports." msgstr "" "`flake8` " "はあなたのコードで使用されていないインポートを特定しますが、パッケージのインポートの順序に関する問題を修正したり特定したりすることはできません。" #: ../../package-structure-code/code-style-linting-format.md:160 msgid "" -"`isort` will identify where imports in your code are out of order. It " -"will then modify your code, automatically reordering all imports. This " -"leaves you with one less thing to think about when cleaning up your code." +"`isort` will identify where imports in your code are out of order. It will " +"then modify your code, automatically reordering all imports. This leaves " +"you with one less thing to think about when cleaning up your code." msgstr "" "`isort` は、コードの中でインポートの順番が狂っている箇所を特定します。 " "そして、あなたのコードを修正し、すべてのインポートの順番を自動的に並べ替えます。 これで、コードを整理するときに考えることが1つ減ります。" @@ -401,11 +398,11 @@ msgstr "`isort` が実行される前にコードがインポートされます: #: ../../package-structure-code/code-style-linting-format.md:169 msgid "" -"Below, the `pandas` is a third party package, `typing` is a core `Python`" -" package distributed with `Python`, and `examplePy.temperature` is a " -"first-party module which means it belongs to the same package as the file" -" doing the import. Also notice that there are no spaces in the imports " -"listed below." +"Below, the `pandas` is a third party package, `typing` is a core `Python` " +"package distributed with `Python`, and `examplePy.temperature` is a first-" +"party module which means it belongs to the same package as the file doing " +"the import. Also notice that there are no spaces in the imports listed " +"below." msgstr "" "以下では、`pandas`はサードパーティのパッケージであり、`typing`は `Python` とともに配布されている `Python` " "のコアパッケージであり、 " @@ -426,12 +423,11 @@ msgstr "Ruff" #: ../../package-structure-code/code-style-linting-format.md:195 msgid "" -"[Ruff](https://docs.astral.sh/ruff/) is a new addition to the code " -"quality ecosystem, gaining some traction since its release. `ruff` is " -"both a linter and a code formatter for Python, aiming to replace several " -"tools behind a single interface. As such, `ruff` can be used at a " -"replacement of all other tools mentioned here, or in complement to some " -"of them." +"[Ruff](https://docs.astral.sh/ruff/) is a new addition to the code quality " +"ecosystem, gaining some traction since its release. `ruff` is both a linter" +" and a code formatter for Python, aiming to replace several tools behind a " +"single interface. As such, `ruff` can be used at a replacement of all other" +" tools mentioned here, or in complement to some of them." msgstr "" "[Ruff](https://docs.astral.sh/ruff/) " "は、コードクオリティのエコシステムに新しく追加されたもので、リリース以来人気を集めています。 `ruff` " @@ -439,9 +435,7 @@ msgstr "" "はここで紹介する他のすべてのツールの置き換えとして、あるいはいくつかのツールの補完として使用することができます。" #: ../../package-structure-code/code-style-linting-format.md:201 -msgid "" -"`ruff` has some interesting features that distinguish it from other " -"linters:" +msgid "`ruff` has some interesting features that distinguish it from other linters:" msgstr "`ruff` には他のリンターと異なる興味深い特徴があります:" #: ../../package-structure-code/code-style-linting-format.md:203 @@ -454,8 +448,8 @@ msgstr "数百のルールが含まれ、その多くは自動的に修正可能 #: ../../package-structure-code/code-style-linting-format.md:205 msgid "" -"Rules explanation, see [F403](https://docs.astral.sh/ruff/rules" -"/undefined-local-with-import-star/) for an example" +"Rules explanation, see [F403](https://docs.astral.sh/ruff/rules/undefined-" +"local-with-import-star/) for an example" msgstr "" "ルールの説明、例については [F403](https://docs.astral.sh/ruff/rules/undefined-local-" "with-import-star/) を参照してください。" @@ -468,8 +462,8 @@ msgstr "実行時間が速いので、大規模プロジェクトでも素早い #: ../../package-structure-code/code-style-linting-format.md:208 msgid "" -"Here is a simple configuration to get started with `ruff`. It would go " -"into your `pyproject.toml`:" +"Here is a simple configuration to get started with `ruff`. It would go into" +" your `pyproject.toml`:" msgstr "以下は `ruff` を使い始めるための簡単な設定です。 これは `pyproject.toml` に記述します:" #: ../../package-structure-code/code-style-linting-format.md:216 @@ -488,10 +482,10 @@ msgstr "リンター、コードフォーマッター、お気に入りのコー #: ../../package-structure-code/code-style-linting-format.md:228 msgid "" -"Linters can be run as a command-line tool as shown above. They also can " -"be run within your favorite coding tool (e.g. VScode, pycharm, etc). For " -"example, you might prefer to have tools like Black and isort run when you" -" save a file. In some editors you can also setup shortcuts that run your " +"Linters can be run as a command-line tool as shown above. They also can be " +"run within your favorite coding tool (e.g. VScode, pycharm, etc). For " +"example, you might prefer to have tools like Black and isort run when you " +"save a file. In some editors you can also setup shortcuts that run your " "favorite code format tools on demand." msgstr "" "リンターは上記のようにコマンドラインツールとして実行できます。 " @@ -527,27 +521,27 @@ msgstr "コマンドラインで `git commit -m \"message here\"` を実行" #: ../../package-structure-code/code-style-linting-format.md:248 msgid "" -"Once you hit return, pre-commit will run any tools that you have " -"configured in a **.pre-commit-config.yaml** file." +"Once you hit return, pre-commit will run any tools that you have configured" +" in a **.pre-commit-config.yaml** file." msgstr "returnを押すと、pre-commitは **.pre-commit-config.yaml** ファイルで設定したツールを実行します。" #: ../../package-structure-code/code-style-linting-format.md:250 msgid "" "If the tools configured in the pre-commit hook run successfully without " -"making changes or finding errors in your code, the commit will be applied" -" to the repository." +"making changes or finding errors in your code, the commit will be applied " +"to the repository." msgstr "" "pre-" "commitフックで設定したツールが、コードに変更を加えたりエラーを発見したりすることなく正常に実行されると、コミットがリポジトリに適用されます。" #: ../../package-structure-code/code-style-linting-format.md:254 msgid "" -"If the tools configured in the hook find errors in your files, the commit" -" will NOT be applied to the repository. Remember from the discussion " -"above that a code formatter like Black will run and reformat your code. A" -" linter like _flake8_ will provide you with some output that details " -"where there are syntax issues in your code. You will then need to fix " -"those issues, manually." +"If the tools configured in the hook find errors in your files, the commit " +"will NOT be applied to the repository. Remember from the discussion above " +"that a code formatter like Black will run and reformat your code. A linter " +"like _flake8_ will provide you with some output that details where there " +"are syntax issues in your code. You will then need to fix those issues, " +"manually." msgstr "" "フックで設定したツールがファイルにエラーを見つけた場合、コミットはリポジトリに適用されません。 上の説明で、Black " "のようなコードフォーマッタが実行され、コードを再フォーマットすることを思い出してください。 _flake8_ " @@ -566,18 +560,18 @@ msgstr "左から右へ、 pre-commit ワークフローのステップを示す #: ../../package-structure-code/code-style-linting-format.md:267 #, fuzzy msgid "" -"The pre-commit workflow begins with you adding files that have changes to" -" be staged in git. Next, you'd run git commit. When you run git commit, " -"the pre-commit hooks will then run. In this example, Black, the code " -"formatter and flake8, a linter both run. If all of the files pass Black " -"and flake8 checks, then your commit will be recorded. If they don't, the " -"commit is canceled. You will have to fix any flake8 issues, and then re-" -"add / stage the files to be committed. [_Image " +"The pre-commit workflow begins with you adding files that have changes to " +"be staged in git. Next, you'd run git commit. When you run git commit, the " +"pre-commit hooks will then run. In this example, Black, the code formatter " +"and flake8, a linter both run. If all of the files pass Black and flake8 " +"checks, then your commit will be recorded. If they don't, the commit is " +"canceled. You will have to fix any flake8 issues, and then re-add / stage " +"the files to be committed. [_Image " "Source_](https://ljvmiranda921.github.io/notebook/2018/06/21/precommits-" "using-black-and-flake8/)" msgstr "" -"pre-commit のワークフローは、まず git にステージすべき変更があるファイルを追加することから始まります。 次に git commit" -" を実行します。git commit を実行すると、pre-commit フックが実行されます。 この例では、コード整形ツールである Black " +"pre-commit のワークフローは、まず git にステージすべき変更があるファイルを追加することから始まります。 次に git commit " +"を実行します。git commit を実行すると、pre-commit フックが実行されます。 この例では、コード整形ツールである Black " "とリンターである flake8 が実行されます。 すべてのファイルがBlackとflake8のチェックをパスすれば、コミットが記録される。 " "通らなかった場合、コミットはキャンセルされます。 flake8の問題を修正し、コミットするファイルを再度追加/ステージする必要があります。 " "[_Image Source_](https://ljvmiranda921.github.io/notebook/2018/06/21" @@ -585,8 +579,8 @@ msgstr "" #: ../../package-structure-code/code-style-linting-format.md:280 msgid "" -"If have a Python code-base and multiple maintainers actively working on " -"the code, and you intend to run a tool like Black, be sure to coordinate " +"If have a Python code-base and multiple maintainers actively working on the" +" code, and you intend to run a tool like Black, be sure to coordinate " "across your team. An initial commit that applies Black to your entire " "package will likely change a significant amount of your code. This could " "lead to merge conflicts on open and new PR's before the new changes are " @@ -606,8 +600,8 @@ msgid "" "In addition to calling tools, Pre-commit also has a suite of [built in " "format hooks](https://github.com/pre-commit/pre-commit-hooks#hooks-" "available) that you can call. Some, such as `trailing-whitespace` can be " -"also useful to add to your pre-commit workflow to ensure clean, " -"streamlined code files." +"also useful to add to your pre-commit workflow to ensure clean, streamlined" +" code files." msgstr "" "ツールを呼び出すだけでなく、Pre-commitには [ビルトインフォーマットフック](https://github.com/pre-commit" "/pre-commit-hooks#hooks-available) が用意されています。また、 `trailing-whitespace` " @@ -615,8 +609,8 @@ msgstr "" #: ../../package-structure-code/code-style-linting-format.md:294 msgid "" -"An example pre-commit-config.yaml file is below with examples of how this" -" is all setup." +"An example pre-commit-config.yaml file is below with examples of how this " +"is all setup." msgstr "" "以下に、 pre-commit-config.yaml " "ファイルの例を記載します。このファイルに記載されている内容のセットアップ方法の例も記載されています。" @@ -641,11 +635,11 @@ msgstr "コミット前のフック設定をすべて使用して、すべての #: ../../package-structure-code/code-style-linting-format.md:303 msgid "" "If you wish, it will also submit a pull request to your repo with pre-" -"commit fixes, saving you, and new contributors the time of reformatting a" -" pr that has format issues." +"commit fixes, saving you, and new contributors the time of reformatting a " +"pr that has format issues." msgstr "" -"あなたが望むなら、事前にコミットした修正と一緒にあなたのリポジトリにプルリクエストを提出します、あなたや新しい貢献者は、フォーマットの問題がある " -"pr を再フォーマットする時間を節約できます。" +"あなたが望むなら、事前にコミットした修正と一緒にあなたのリポジトリにプルリクエストを提出します、あなたや新しい貢献者は、フォーマットの問題がある pr" +" を再フォーマットする時間を節約できます。" #: ../../package-structure-code/code-style-linting-format.md:306 msgid "You can also call the bot on any pull request to run / and fix the code." @@ -671,9 +665,9 @@ msgstr "メンテナにとっては、コードフォーマットの修正に頭 #: ../../package-structure-code/code-style-linting-format.md:315 msgid "" -"It can make it easier for new comers as they never have to setup pre-" -"commit locally or worry about linting their code. They can even make " -"small fixes to the code directly on GitHub without worry." +"It can make it easier for new comers as they never have to setup pre-commit" +" locally or worry about linting their code. They can even make small fixes " +"to the code directly on GitHub without worry." msgstr "" "ローカルでpre-" "commitをセットアップしたり、コードのlintを心配したりする必要がないので、新規参入者も楽になります。GitHub上で直接コードを修正することもできます。" @@ -693,9 +687,7 @@ msgid "" msgstr "pre-commitをインストールする（そしてリポジトリに開発要件として含める）" #: ../../package-structure-code/code-style-linting-format.md:331 -msgid "" -"Create a .pre-commit-config.yaml file in the root of your package " -"directory." +msgid "Create a .pre-commit-config.yaml file in the root of your package directory." msgstr "パッケージディレクトリのルートに .pre-commit-config.yaml ファイルを作成します。" #: ../../package-structure-code/code-style-linting-format.md:333 @@ -704,14 +696,13 @@ msgid "" "setup the pre-commit hook and the pre-commit.ci bot if you chose to " "implement that too." msgstr "" -"以下は、 pre-commit とpre-commit.ciボットのセットアップに使用できる **.pre-commit-cofig.yaml**" -" ファイルの例です。" +"以下は、 pre-commit とpre-commit.ciボットのセットアップに使用できる **.pre-commit-cofig.yaml** " +"ファイルの例です。" #: ../../package-structure-code/code-style-linting-format.md:341 msgid "" -"This file specifies a hook that will be triggered automatically before " -"each `git commit`, in this case, it specifies a `flake8` using version " -"`6.0.0`." +"This file specifies a hook that will be triggered automatically before each" +" `git commit`, in this case, it specifies a `flake8` using version `6.0.0`." msgstr "" "このファイルでは、各 `git commit` の前に自動的に起動するフックを指定します。この例では、バージョン `6.0.0` を使って " "`flake8` を指定しています。" @@ -722,13 +713,13 @@ msgid "" "install all of the hooks specified in the pre-commit yaml file into your " "environment." msgstr "" -"`pre-commit install` を使用して、(複数の)コミット前フックをインストールします。 これにより、pre-commit yaml" -" ファイルで指定したすべてのフックがあなたの環境にインストールされます。" +"`pre-commit install` を使用して、(複数の)コミット前フックをインストールします。 これにより、pre-commit yaml " +"ファイルで指定したすべてのフックがあなたの環境にインストールされます。" #: ../../package-structure-code/code-style-linting-format.md:346 msgid "" -"Once you have done the above, you are ready to start working on your " -"code. Pre-commit will run every time you run `git commit`." +"Once you have done the above, you are ready to start working on your code. " +"Pre-commit will run every time you run `git commit`." msgstr "上記を実行したら、コードを書き始める準備ができました。 `git commit` を実行するたびに pre-commit が実行されます。" #: ../../package-structure-code/code-style-linting-format.md:349 @@ -737,19 +728,17 @@ msgstr "概要" #: ../../package-structure-code/code-style-linting-format.md:351 msgid "" -"pyOpenSci suggests setting up a linter and a code styler for your " -"package, regardless of whether you use pre-commit hooks, CI or other " -"infrastructure to manage code format. Setting up these tools will give " -"you automatic feedback about your code's structure as you (or a " -"contributor) write it. And using a tool like black that format code for " -"you, reduce effort that you need to make surrounding decisions around " -"code format and style." +"pyOpenSci suggests setting up a linter and a code styler for your package, " +"regardless of whether you use pre-commit hooks, CI or other infrastructure " +"to manage code format. Setting up these tools will give you automatic " +"feedback about your code's structure as you (or a contributor) write it. " +"And using a tool like black that format code for you, reduce effort that " +"you need to make surrounding decisions around code format and style." msgstr "" "pyOpenSciは、プレコミットフック、CI、またはコードフォーマットを管理する他のインフラストラクチャを使用しているかどうかに関係なく、あなたのパッケージにリンターとコードスタイラーをセットアップすることを提案します。" " " "これらのツールをセットアップすることで、あなた(または貢献者)がコードを書いたときに、コードの構造に関する自動的なフィードバックを得ることができます。" -" " -"また、コードを整形してくれるblackのようなツールを使うことで、コードのフォーマットやスタイルにまつわる決断に必要な労力を減らすことができます。" +" また、コードを整形してくれるblackのようなツールを使うことで、コードのフォーマットやスタイルにまつわる決断に必要な労力を減らすことができます。" #: ../../package-structure-code/complex-python-package-builds.md:1 msgid "Complex Python package builds" @@ -757,29 +746,34 @@ msgstr "複雑なPythonパッケージのビルド" #: ../../package-structure-code/complex-python-package-builds.md:3 msgid "" -"This guide is focused on packages that are either pure-python or that " -"have a few simple extensions in another language such as C or C++." +"This guide is focused on packages that are either pure-python or that have " +"a few simple extensions in another language such as C or C++." msgstr "このガイドでは、純粋なPythonか、CやC++のような他の言語でいくつかの簡単な拡張を持つパッケージのどちらかに焦点を当てています。" #: ../../package-structure-code/complex-python-package-builds.md:6 msgid "" "For comprehensive guidance on packaging compiled projects with " -"C/C++/Fortran/Rust extensions, see the [Scientific Python Development " -"Guide on compiled packaging](https://learn.scientific-" +"C/C++/Fortran/Rust extensions, see the [Scientific Python Development Guide" +" on compiled packaging](https://learn.scientific-" "python.org/development/guides/packaging-compiled/). This is the best " "reference for complex builds and covers scikit-build-core, meson-python, " "maturin, and other modern build backends." msgstr "" +"C/C++/Fortran/Rust " +"拡張機能を使用してコンパイルされたプロジェクトをパッケージ化するための包括的なガイダンスについては、[コンパイルされたパッケージ化に関する科学的 " +"Python 開発ガイド](https://learn.scientific-python.org/development/guides" +"/packaging-compiled/) を参照してください。これは、複雑なビルドに最適なリファレンスであり、scikit-build-core" +"、meson-python、maturin、その他の最新のビルド バックエンドをカバーしています。" #: ../../package-structure-code/complex-python-package-builds.md:8 #, fuzzy msgid "" -"If you have questions about these types of package, please open an [issue" -" about this guide specifically in the GitHub repo for this " -"guide](https://github.com/pyOpenSci/python-package-guide/issues). There " -"are many nuances to building and distributing Python packages that have " -"compiled extensions requiring non-Python dependencies at build time. For " -"an overview and thorough discussion of these nuances, please see [this " +"If you have questions about these types of package, please open an [issue " +"about this guide specifically in the GitHub repo for this " +"guide](https://github.com/pyOpenSci/python-package-guide/issues). There are" +" many nuances to building and distributing Python packages that have " +"compiled extensions requiring non-Python dependencies at build time. For an" +" overview and thorough discussion of these nuances, please see [this " "site.](https://pypackaging-native.github.io/)" msgstr "" "将来的には、より複雑なビルドを必要とするパッケージングワークフローのためのリソースを提供したいと考えています。 " @@ -797,9 +791,9 @@ msgstr "純粋なPythonパッケージと他言語の拡張機能付きパッケ #: ../../package-structure-code/complex-python-package-builds.md:12 msgid "" -"You can classify Python package complexity into three general categories." -" These categories can in turn help you select the correct package " -"frontend and backend tools." +"You can classify Python package complexity into three general categories. " +"These categories can in turn help you select the correct package frontend " +"and backend tools." msgstr "" "Pythonパッケージの複雑さを3つの一般的なカテゴリに分類することができます。 " "これらの分類は、正しいパッケージフロントエンドとバックエンドツールを選択するのに役立ちます。" @@ -807,23 +801,23 @@ msgstr "" #: ../../package-structure-code/complex-python-package-builds.md:16 msgid "" "**Pure-python packages:** these are packages that only rely on Python to " -"function. Building a pure Python package is simpler. As such, you can " -"chose a tool below that has the features that you want and be done with " -"your decision!" +"function. Building a pure Python package is simpler. As such, you can chose" +" a tool below that has the features that you want and be done with your " +"decision!" msgstr "" -"**純粋なPythonパッケージ:** Pythonだけに依存して機能するパッケージです。 純粋なPythonパッケージの構築はよりシンプルです。" -" そのため、以下のツールの中から自分の欲しい機能を持つものを選び、決定しましょう!" +"**純粋なPythonパッケージ:** Pythonだけに依存して機能するパッケージです。 純粋なPythonパッケージの構築はよりシンプルです。 " +"そのため、以下のツールの中から自分の欲しい機能を持つものを選び、決定しましょう!" #: ../../package-structure-code/complex-python-package-builds.md:18 msgid "" "**Python packages with non-Python extensions:** These packages have " -"additional components called extensions written in other languages (such " -"as C or C++). If you have a package with non-Python extensions, then you " -"need to select a build backend tool that allows additional build steps " -"needed to compile your extension code. Further, if you wish to use a " -"frontend tool to support your workflow, you will need to select a tool " -"that supports additional build setups. We suggest that you chose build " -"tool that supports custom build steps like Hatch." +"additional components called extensions written in other languages (such as" +" C or C++). If you have a package with non-Python extensions, then you need" +" to select a build backend tool that allows additional build steps needed " +"to compile your extension code. Further, if you wish to use a frontend tool" +" to support your workflow, you will need to select a tool that supports " +"additional build setups. We suggest that you chose build tool that supports" +" custom build steps like Hatch." msgstr "" "**Python以外の拡張を持つPythonパッケージ:** これらのパッケージには、他の言語(CやC++など)で書かれた拡張と呼ばれる " "追加コンポーネントがあります。 Python " @@ -833,14 +827,13 @@ msgstr "" #: ../../package-structure-code/complex-python-package-builds.md:20 msgid "" -"**Python packages that have extensions written in different languages " -"(e.g. Fortran and C++) or that have non Python dependencies that are " -"difficult to install (e.g. GDAL):** These packages often have complex " -"build steps (more complex than a package with just a few C extensions for" -" instance). As such, these packages require tools such as [scikit-" -"build](https://scikit-build.readthedocs.io/en/latest/) or [meson-" -"python](https://mesonbuild.com/Python-module.html) to build. NOTE: you " -"can use meson-python with PDM." +"**Python packages that have extensions written in different languages (e.g." +" Fortran and C++) or that have non Python dependencies that are difficult " +"to install (e.g. GDAL):** These packages often have complex build steps " +"(more complex than a package with just a few C extensions for instance). As" +" such, these packages require tools such as [scikit-build](https://scikit-" +"build.readthedocs.io/en/latest/) or [meson-python](https://mesonbuild.com" +"/Python-module.html) to build. NOTE: you can use meson-python with PDM." msgstr "" "**異なる言語で書かれた拡張(例えばFortranやC++)を持つPythonパッケージや、 " "インストールが困難なPython以外の依存関係(例えばGDAL)を持つPythonパッケージ: ** " @@ -858,11 +851,10 @@ msgid "" "It is sometimes necessary or desirable to use a build frontend with an " "alternative build-backend. This is because some frontends do not have a " "default backend (`build`), and this choice is placed on the maintainer. " -"Other backends (`hatch`) have a preferred backend (`hatchling`) but allow" -" the maintainer to migrate to another, while some backends (`poetry`) " -"only work with a single backend (`poetry-core`). Refer to (#python-" -"package-build-tools) for more information about frontend and backend " -"compatibility." +"Other backends (`hatch`) have a preferred backend (`hatchling`) but allow " +"the maintainer to migrate to another, while some backends (`poetry`) only " +"work with a single backend (`poetry-core`). Refer to (#python-package-" +"build-tools) for more information about frontend and backend compatibility." msgstr "" "ビルドフロントエンドと別のビルドバックエンドを併用することが必要な場合や望ましい場合があります。これは、フロントエンドの中にはデフォルトのバックエンド（`build`）を持たないものがあり、この選択はメンテナに委ねられているからです。他のバックエンド" " (`hatch`) には推奨されるバックエンド (`hatchling`) " @@ -872,14 +864,14 @@ msgstr "" #: ../../package-structure-code/complex-python-package-builds.md:31 msgid "" -"In this packaging guide we recommend using `hatch` along with its " -"preferred backend `hatchling`. While this will be suitable for most " -"packages, an alternate backend may be used with Hatch if needed when " -"creating an extension module. A Python extension module is one that is " -"made up, either in part or entirely, of compiled code. In this case the " -"backend chosen (such as `meson-python`) must know how to compile the " -"extension language and bind it to Python. `hatchling` does not know how " -"to do this all on its own and must either make use of " +"In this packaging guide we recommend using `hatch` along with its preferred" +" backend `hatchling`. While this will be suitable for most packages, an " +"alternate backend may be used with Hatch if needed when creating an " +"extension module. A Python extension module is one that is made up, either " +"in part or entirely, of compiled code. In this case the backend chosen " +"(such as `meson-python`) must know how to compile the extension language " +"and bind it to Python. `hatchling` does not know how to do this all on its " +"own and must either make use of " "[plugins](https://hatch.pypa.io/1.9/plugins/about/) or be replaced by a " "backend that is already capable of building extension modules." msgstr "" @@ -892,12 +884,12 @@ msgstr "" #: ../../package-structure-code/complex-python-package-builds.md:39 msgid "" "In order to use a different backend you will need to edit your project's " -"`pyproject.toml`. If you have a `pyproject.toml` generated by the `hatch`" -" command, or from following the packaging tutorial, you may have to make " -"a change like this" +"`pyproject.toml`. If you have a `pyproject.toml` generated by the `hatch` " +"command, or from following the packaging tutorial, you may have to make a " +"change like this" msgstr "" -"別のバックエンドを使用するには、プロジェクトの `pyproject.toml` を編集する必要があります。 `hatch` コマンドで生成された" -" `pyproject.toml` や、パッケージングチュートリアルに従った `pyproject.toml` " +"別のバックエンドを使用するには、プロジェクトの `pyproject.toml` を編集する必要があります。 `hatch` コマンドで生成された " +"`pyproject.toml` や、パッケージングチュートリアルに従った `pyproject.toml` " "がある場合は、次のように変更する必要があるかもしれません。" #: ../../package-structure-code/declare-dependencies.md:6 @@ -908,8 +900,8 @@ msgstr "Pythonパッケージのバージョンを管理するツール" #: ../../package-structure-code/declare-dependencies.md:8 msgid "" "In the [pyproject.toml overview page](pyproject-toml-python-package-" -"metadata), you learned how to set up a **pyproject.toml** file with basic" -" metadata for your package. On this page, you will learn how to specify " +"metadata), you learned how to set up a **pyproject.toml** file with basic " +"metadata for your package. On this page, you will learn how to specify " "different types of dependencies in your `pyproject.toml`." msgstr "" "[pyproject.tomlの概要ページ](pyproject-toml-python-package-metadata) " @@ -923,11 +915,11 @@ msgstr "パッケージ依存性とは何か？" #: ../../package-structure-code/declare-dependencies.md:16 #, fuzzy msgid "" -"A Python package dependency refers to an external package or A tool that " -"is needed when using or working on your Python project. Declare your " -"dependencies in your `pyproject.toml` file. This keeps all package " -"metadata in one place, making it simpler for users and contributors to " -"understand your package." +"A Python package dependency refers to an external package or A tool that is" +" needed when using or working on your Python project. Declare your " +"dependencies in your `pyproject.toml` file. This keeps all package metadata" +" in one place, making it simpler for users and contributors to understand " +"your package." msgstr "" "依存関係は `pyproject.toml` ファイルを使って宣言することを推奨します。 " "こうすることで、パッケージに関連するすべてのメタデータが一箇所で宣言され、ユーザや貢献者がパッケージのインフラストラクチャを理解するのがより簡単になります。" @@ -941,13 +933,13 @@ msgstr "依存関係はどのように宣言するのか？" msgid "" "While `pyproject.toml` is now the standard, you may sometimes encounter " "older approaches to storing dependencies \"in the wild\":" -msgstr "" +msgstr "現在では「pyproject.toml」が標準ですが、依存関係を「そのまま」保存するための古いアプローチに遭遇する場合があります。" #: ../../package-structure-code/declare-dependencies.md:24 msgid "" "**requirements.txt**: Previously common for dependencies, still used by " "some projects for local development" -msgstr "" +msgstr "**requirements.txt**: 以前は依存関係に一般的でしたが、現在でもローカル開発の一部のプロジェクトで使用されています" #: ../../package-structure-code/declare-dependencies.md:25 #, fuzzy @@ -976,21 +968,27 @@ msgstr "再帰的依存関係" #: ../../package-structure-code/declare-dependencies.md:32 msgid "" "Specifying dependencies in the `project.dependencies` array of your " -"`pyproject.toml` file ensures that libraries needed to run your package " -"are correctly installed into a user's environment. For instance, if your " +"`pyproject.toml` file ensures that libraries needed to run your package are" +" correctly installed into a user's environment. For instance, if your " "package requires Pandas to run properly, and you add Pandas to the " "`project.dependencies` array, Pandas will be installed into the users' " "environment when they install your package using uv, pip, or conda." msgstr "" +"`pyproject.toml` ファイルの `project.dependency` " +"配列で依存関係を指定すると、パッケージの実行に必要なライブラリがユーザーの環境に正しくインストールされるようになります。たとえば、パッケージが適切に実行するために" +" Pandas を必要とする場合、Pandas を `project.dependency` 配列に追加すると、ユーザーが uv、pip、または " +"conda を使用してパッケージをインストールするときに、Pandas がユーザーの環境にインストールされます。" #: ../../package-structure-code/declare-dependencies.md:45 msgid "" "Development dependencies make it easier for contributors to work on your " -"package. You can set up instructions for running specific workflows, such" -" as tests, linting, and even typing, that automatically install groups of" -" development dependencies. These dependencies can be stored in arrays " -"(lists of dependencies) within a `[dependency-groups]` table." +"package. You can set up instructions for running specific workflows, such " +"as tests, linting, and even typing, that automatically install groups of " +"development dependencies. These dependencies can be stored in arrays (lists" +" of dependencies) within a `[dependency-groups]` table." msgstr "" +"開発の依存関係により、コントリビューターがパッケージで作業しやすくなります。テスト、lint、さらには入力など、開発依存関係のグループを自動的にインストールする特定のワークフローを実行するための手順を設定できます。これらの依存関係は" +"、`[dependency-groups]` テーブル内の配列 (依存関係のリスト) に保存できます。" #: ../../package-structure-code/declare-dependencies.md:55 #, fuzzy @@ -999,34 +997,41 @@ msgstr "依存関係のセットを組み合わせる" #: ../../package-structure-code/declare-dependencies.md:57 msgid "" -"There are three different types of dependencies that you will learn about" -" on this page:" -msgstr "" +"There are three different types of dependencies that you will learn about " +"on this page:" +msgstr "このページでは、次の 3 つの異なるタイプの依存関係について説明します。" #: ../../package-structure-code/declare-dependencies.md:59 msgid "" -"**Required dependencies:** These are dependencies that need to be " -"installed for your package to work correctly in a user's environment. You" -" add these dependencies to the `project.dependencies` table in your " -"pyproject.toml file." +"**Required dependencies:** These are dependencies that need to be installed" +" for your package to work correctly in a user's environment. You add these " +"dependencies to the `project.dependencies` table in your pyproject.toml " +"file." msgstr "" +"**必須の依存関係:** これらは、パッケージがユーザーの環境で正しく動作するためにインストールする必要がある依存関係です。これらの依存関係を " +"pyproject.toml ファイルの `project.dependency` テーブルに追加します。" #: ../../package-structure-code/declare-dependencies.md:60 msgid "" "**Feature Dependencies:** These are dependencies that are required if a " "user wants to access additional functionality (that is not core) to your " -"package. Store these in the `[project.optional-dependencies]` table of " -"your pyproject.toml file." +"package. Store these in the `[project.optional-dependencies]` table or your" +" pyproject.toml file." msgstr "" +"**機能の依存関係:** これらは、ユーザーがパッケージの追加機能 (コアではない) にアクセスしたい場合に必要な依存関係です。これらを " +"`[project.optional-dependency]` テーブルまたは pyproject.toml ファイルに保存します。" #: ../../package-structure-code/declare-dependencies.md:61 msgid "" "**Development Dependencies:** These dependencies are required if someone " -"wants to develop or work on your package. These include instance linters," -" testing tools like pytest and mypy are examples of development " -"dependencies. Store these in the `[dependency-groups]` table of " -"your pyproject.toml file." +"wants to develop or work on your package. These include instance linters, " +"testing tools like pytest and mypy are examples of development " +"dependencies. Store these in the `[dependency-groups]` table of your " +"pyproject.toml file." msgstr "" +"**開発の依存関係:** これらの依存関係は、誰かがパッケージを開発または作業したい場合に必要です。これらには、インスタンス リンター、pytest " +"や mypy などのテスト ツールが開発依存関係の例として含まれます。これらを pyproject.toml ファイルの `[dependency-" +"groups]` テーブルに保存します。" #: ../../package-structure-code/declare-dependencies.md:64 #, fuzzy @@ -1045,15 +1050,18 @@ msgstr "再帰的依存関係" msgid "" "Required dependencies are imported and called directly within your " "package's code. They are needed for your package to run." -msgstr "" +msgstr "必要な依存関係はインポートされ、パッケージのコード内で直接呼び出されます。これらはパッケージを実行するために必要です。" #: ../../package-structure-code/declare-dependencies.md:74 msgid "" -"You can add your required dependencies to the `dependencies` array in the" -" `[project]` table of your **pyproject.toml** file. When users install " -"your package with uv, pip, or conda, these dependencies will be " -"automatically installed alongside your package in their environment." +"You can add your required dependencies to the `dependencies` array in the " +"`[project]` table of your **pyproject.toml** file. When users install your " +"package with uv, pip, or conda, these dependencies will be automatically " +"installed alongside your package in their environment." msgstr "" +"必要な依存関係を、**pyproject.toml** ファイルの `[project]` テーブルの `dependency` " +"配列に追加できます。ユーザーが uv、pip、または conda " +"を使用してパッケージをインストールすると、これらの依存関係は、パッケージと一緒に環境に自動的にインストールされます。" #: ../../package-structure-code/declare-dependencies.md:92 #, fuzzy @@ -1070,18 +1078,18 @@ msgstr "必要な依存関係をpyproject.tomlファイルに追加" #: ../../package-structure-code/declare-dependencies.md:102 #: ../../package-structure-code/declare-dependencies.md:162 -#: ../../package-structure-code/declare-dependencies.md:223 +#: ../../package-structure-code/declare-dependencies.md:222 #, fuzzy msgid "You can use uv to add dependencies to your pyproject.toml file:" msgstr "pyproject.tomlファイルに依存関係を追加" #: ../../package-structure-code/declare-dependencies.md:104 msgid "**Add a required dependency:**" -msgstr "" +msgstr "**必要な依存関係を追加します:**" #: ../../package-structure-code/declare-dependencies.md:110 msgid "Will add numpy as a dependency to your `project.dependencies` array:" -msgstr "" +msgstr "numpy を依存関係として `project.dependency` 配列に追加します。" #: ../../package-structure-code/declare-dependencies.md:121 #, fuzzy @@ -1100,9 +1108,9 @@ msgstr "" #: ../../package-structure-code/declare-dependencies.md:133 #, fuzzy msgid "" -"IMPORTANT: If your library depends on a GitHub-hosted project, you should" -" point to a specific commit/tag/hash of that repository before you upload" -" your project to PyPI. You never know how the project might change over " +"IMPORTANT: If your library depends on a GitHub-hosted project, you should " +"point to a specific commit/tag/hash of that repository before you upload " +"your project to PyPI. You never know how the project might change over " "time. Commit hashes are more reliable as they can't be changed" msgstr "重要:セキュリティ上の理由から、あなたのライブラリがGitHubでホストされているプロジェクトに依存している場合、あなたのプロジェクトをPyPIにアップロードするには、そのリポジトリの特定のコミット/タグ/ハッシュを指す必要があります。" @@ -1116,10 +1124,15 @@ msgid "" "Optional (also referred to as feature) dependencies can be installed by " "users as needed. Optional dependencies add specific features to your " "package that not all users need. For example, if your package has an " -"optional interactive plotting feature that uses Bokeh, you would list " -"Bokeh under `[project.optional-dependencies]`. Users who want interactive plotting " -"will install it. Users who don't need plotting don't have to install it." +"optional interactive plotting feature that uses Bokeh, you would list Bokeh" +" under `[project.optional-dependencies]`. Users who want interactive " +"plotting will install it. Users who don't need plotting don't have to " +"install it." msgstr "" +"オプションの (機能とも呼ばれる) " +"依存関係は、必要に応じてユーザーがインストールできます。オプションの依存関係により、すべてのユーザーが必要とするわけではない特定の機能がパッケージに追加されます。たとえば、パッケージに" +" Bokeh を使用するオプションの対話型プロット機能がある場合、`[project.optional-dependency]` の下に Bokeh " +"をリストします。インタラクティブなプロットを必要とするユーザーは、それをインストールします。プロットが必要ないユーザーはインストールする必要はありません。" #: ../../package-structure-code/declare-dependencies.md:144 #, fuzzy @@ -1128,14 +1141,16 @@ msgstr "`[project.optional-dependencies]` テーブルに複数の依存グル #: ../../package-structure-code/declare-dependencies.md:155 msgid "" -"When a user installs your package, uv, pip, or conda automatically " -"installs all required dependencies. Optional dependencies are only " -"installed if the user explicitly requests them." +"When a user installs your package, uv, pip, or conda automatically installs" +" all required dependencies. Optional dependencies are only installed if the" +" user explicitly requests them." msgstr "" +"ユーザーがパッケージをインストールすると、uv、pip、または conda " +"によって必要な依存関係がすべて自動的にインストールされます。オプションの依存関係は、ユーザーが明示的に要求した場合にのみインストールされます。" #: ../../package-structure-code/declare-dependencies.md #, fuzzy -msgid "How to add optional dependencies using UV" +msgid "How to Add optional dependencies using UV" msgstr "オプションの依存関係" #: ../../package-structure-code/declare-dependencies.md:164 @@ -1157,7 +1172,7 @@ msgstr "依存グループをインストールする" msgid "" "Development dependencies include packages needed to work on your package " "locally. They are used to perform tasks such as:" -msgstr "" +msgstr "開発の依存関係には、パッケージをローカルで操作するために必要なパッケージが含まれます。これらは次のようなタスクを実行するために使用されます。" #: ../../package-structure-code/declare-dependencies.md:186 #, fuzzy @@ -1171,103 +1186,115 @@ msgstr "ドキュメントの作成" #: ../../package-structure-code/declare-dependencies.md:188 msgid "linting and formatting code (ruff, black)" -msgstr "" +msgstr "lint およびフォーマットコード (ruff、black)" #: ../../package-structure-code/declare-dependencies.md:189 msgid "building package distribution files (build, twine)" -msgstr "" +msgstr "パッケージ配布ファイルの構築 (build、twine)" #: ../../package-structure-code/declare-dependencies.md:191 msgid "" -"Dependency groups are optional because they are not required for users to" -" install and use your package. However, they will make it easier for " +"Dependency groups are optional because they are not required for users to " +"install and use your package. However, they will make it easier for " "contributors to your project to setup development environments locally." -msgstr "" +msgstr "依存関係グループは、ユーザーがパッケージをインストールして使用するために必須ではないため、オプションです。ただし、プロジェクトの貢献者がローカルで開発環境をセットアップすることが容易になります。" #: ../../package-structure-code/declare-dependencies.md:196 #, fuzzy -msgid "New: PEP 735 development dependency groups" +msgid "New: PEP 735 dependency groups" msgstr "オプションの依存グループを作成する" #: ../../package-structure-code/declare-dependencies.md:199 msgid "" -"`[dependency-groups]` is a newer specification introduced by PEP 735. " -"They are intended to organize development dependencies and are " -"intentionally separate from `[project.optional-dependencies]`, which can" -" be installed into a user's environment." +"`[dependency-groups]` is a newer specification introduced by PEP 735. They " +"are intended to organize development dependencies and are intentionally " +"separate from `[project.optional-dependencies]`, which can be installed " +"into a user's environment." msgstr "" +"`[dependency-groups]` は、PEP 735 " +"によって導入された新しい仕様です。これらは、開発の依存関係を整理することを目的としており、ユーザーの環境にインストールできる `[project" +".optional-dependency]` とは意図的に分離されています。" -#: ../../package-structure-code/declare-dependencies.md:204 +#: ../../package-structure-code/declare-dependencies.md:203 #, fuzzy msgid "How to declare dependency groups" msgstr "依存関係はどのように宣言するのか？" -#: ../../package-structure-code/declare-dependencies.md:206 +#: ../../package-structure-code/declare-dependencies.md:205 #, fuzzy msgid "" -"You declare development dependencies in your **pyproject.toml** file " -"within a `[dependency-groups]` table." +"You declare development dependencies in your **pyproject.toml** file within" +" a `[dependency-groups]` table." msgstr "**pyproject.toml** ファイルでオプションの依存関係を宣言します:" -#: ../../package-structure-code/declare-dependencies.md:209 +#: ../../package-structure-code/declare-dependencies.md:208 msgid "" "Similar to optional-dependencies, you can create separate subgroups or " "arrays with names using the syntax: `group-name = [\"dep1\", \"dep2\"]`" msgstr "" +"オプションの依存関係と同様に、構文 `group-name = [\"dep1\", \"dep2\"]` " +"を使用して、名前を付けて個別のサブグループまたは配列を作成できます。" #: ../../package-structure-code/declare-dependencies.md msgid "How to Add [dependency-groups] using UV" -msgstr "" +msgstr "UVを使用して[依存関係グループ]を追加する方法" -#: ../../package-structure-code/declare-dependencies.md:225 +#: ../../package-structure-code/declare-dependencies.md:224 msgid "**Add a development dependency group:**" -msgstr "" +msgstr "**開発依存関係グループを追加します:**" -#: ../../package-structure-code/declare-dependencies.md:232 +#: ../../package-structure-code/declare-dependencies.md:231 #, fuzzy msgid "Will add the following to your pyproject.toml file:" msgstr "pyproject.tomlファイルに依存関係を追加" -#: ../../package-structure-code/declare-dependencies.md:245 -#: ../../package-structure-code/declare-dependencies.md:251 -#: ../../package-structure-code/declare-dependencies.md:295 -#: ../../package-structure-code/declare-dependencies.md:414 -#: ../../package-structure-code/declare-dependencies.md:496 +#: ../../package-structure-code/declare-dependencies.md:244 +#: ../../package-structure-code/declare-dependencies.md:250 +#: ../../package-structure-code/declare-dependencies.md:294 +#: ../../package-structure-code/declare-dependencies.md:434 +#: ../../package-structure-code/declare-dependencies.md:516 #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:14 msgid "Todo" msgstr "Todo" -#: ../../package-structure-code/declare-dependencies.md:246 +#: ../../package-structure-code/declare-dependencies.md:245 msgid "" "i'll pick back up here tomorrow - this section is all about how things " "install and what \"ships\" with your package vs what just gets installed " "via commands (ie development)" msgstr "" +"明日またここに戻ってきます - このセクションでは、インストール方法と、パッケージに「同梱」されるものと、コマンドによってインストールされるもの " +"(つまり開発) について説明します。" -#: ../../package-structure-code/declare-dependencies.md:249 +#: ../../package-structure-code/declare-dependencies.md:248 #, fuzzy msgid "Understanding required vs. optional dependencies" msgstr "オプションと必須の依存関係を理解する" -#: ../../package-structure-code/declare-dependencies.md:252 +#: ../../package-structure-code/declare-dependencies.md:251 msgid "" "The purpose of this section is to help users understand how dependencies " -"relate to what is installed in their environment. We have two graphics on" -" this page - one that breaks out the two buckets of tools (required and " -"optional) that both get installed into a user's envt vs development " -"groups, which are contributor/ development facing, not user-facing. When " -"we originally wrote this section, development groups didn't exist, and we" -" were using optional dependencies for dev groups." +"relate to what is installed in their environment. We have two graphics on " +"this page - one that breaks out the two buckets of tools (required and " +"optional) that both get installed into a user's envt vs development groups," +" which are contributor/ development facing, not user-facing. When we " +"originally wrote this section, development groups didn't exist, and we were" +" using optional dependencies for dev groups." msgstr "" +"このセクションの目的は、環境にインストールされているものと依存関係がどのように関係しているかをユーザーが理解できるようにすることです。このページには " +"2 つのグラフィックがあります。1 つは、ユーザーの環境にインストールされる 2 つのツール (必須およびオプション) " +"と、ユーザー側ではなく貢献者/開発側である開発グループにインストールされるツールを分けたものです。最初にこのセクションを書いたとき、開発グループは存在せず、開発グループのオプションの依存関係を使用していました。" -#: ../../package-structure-code/declare-dependencies.md:254 +#: ../../package-structure-code/declare-dependencies.md:253 msgid "" "The graphic below is two circles representing optional vs regular / " "required deps - created before development groups existed... there is " "another graphi that shows what gets installed into a uses envt." msgstr "" +"以下のグラフィックは、オプションの DEPS と通常 / 必須の DEPS を表す 2 つの円です。開発グループが存在する前に作成されました。uses" +" 環境に何がインストールされるかを示す別のグラフィックがあります。" -#: ../../package-structure-code/declare-dependencies.md:258 +#: ../../package-structure-code/declare-dependencies.md:257 msgid "" "Diagram showing two main groups of Python package dependencies: required " "and optional. Required dependencies include core packages needed to use " @@ -1275,19 +1302,23 @@ msgid "" "working on the package locally and feature dependencies for additional " "functionality." msgstr "" +"Python パッケージの依存関係の 2 つの主要なグループ (必須とオプション) を示す図。必要な依存関係には、パッケージを使用するために必要なコア" +" パッケージが含まれます。オプションの依存関係には、パッケージをローカルで操作するための開発依存関係と、追加機能のための機能依存関係が含まれます。" -#: ../../package-structure-code/declare-dependencies.md:260 +#: ../../package-structure-code/declare-dependencies.md:259 msgid "" "Python package dependencies fall into two categories: **required** " "dependencies that users need to run your package, and **optional** " "dependencies for development work or additional features." msgstr "" +"Python パッケージの依存関係は、ユーザーがパッケージを実行するために必要な **必須** 依存関係と、開発作業または追加機能用の " +"**オプション** 依存関係の 2 つのカテゴリに分類されます。" -#: ../../package-structure-code/declare-dependencies.md:265 +#: ../../package-structure-code/declare-dependencies.md:264 msgid "Additional dependency resources" msgstr "その他の依存リソース" -#: ../../package-structure-code/declare-dependencies.md:267 +#: ../../package-structure-code/declare-dependencies.md:266 msgid "" "[Learn more: View PyPA's overview of declaring optional " "dependencies](https://packaging.python.org/en/latest/specifications" @@ -1297,7 +1328,7 @@ msgstr "" "PyPAのオプション依存関係の宣言の概要を見る](https://packaging.python.org/en/latest/specifications" "/declaring-project-metadata/#dependencies-optional-dependencies)" -#: ../../package-structure-code/declare-dependencies.md:268 +#: ../../package-structure-code/declare-dependencies.md:267 msgid "" "[Dependency " "specifiers](https://packaging.python.org/en/latest/specifications" @@ -1307,42 +1338,42 @@ msgstr "" "specifiers](https://packaging.python.org/en/latest/specifications" "/dependency-specifiers/)" -#: ../../package-structure-code/declare-dependencies.md:272 +#: ../../package-structure-code/declare-dependencies.md:271 msgid "Install dependency groups" msgstr "依存グループをインストールする" -#: ../../package-structure-code/declare-dependencies.md:274 +#: ../../package-structure-code/declare-dependencies.md:273 msgid "" -"When someone installs your package, only core dependencies are installed " -"by default. To install optional dependencies, you need to specify which " +"When someone installs your package, only core dependencies are installed by" +" default. To install optional dependencies, you need to specify which " "groups to include when installing the package." -msgstr "" +msgstr "誰かがパッケージをインストールすると、デフォルトではコアの依存関係のみがインストールされます。オプションの依存関係をインストールするには、パッケージのインストール時に含めるグループを指定する必要があります。" -#: ../../package-structure-code/declare-dependencies.md:280 +#: ../../package-structure-code/declare-dependencies.md:279 #, fuzzy msgid "" -"Diagram showing a Venn diagram with three sections representing " -"dependency groups - docs, feature, and tests. In the center it shows " -"your-package with core dependencies seaborn and numpy. Two arrows on the " -"right demonstrate: first, python -m pip install your-package installs " -"only the package and core dependencies. Second, python -m pip install " -"your-package[tests] installs the package, core dependencies, and test " -"dependencies including pytest and pytest-cov." +"Diagram showing a Venn diagram with three sections representing dependency " +"groups - docs, feature, and tests. In the center it shows your-package with" +" core dependencies seaborn and numpy. Two arrows on the right demonstrate: " +"first, python -m pip install your-package installs only the package and " +"core dependencies. Second, python -m pip install your-package[tests] " +"installs the package, core dependencies, and test dependencies including " +"pytest and pytest-cov." msgstr "" "上記の依存グループを表す3つのセクションを持つven図を示す図 - ドキュメント機能とテスト。中央には your-package " -"と表示され、そのパッケージの主要な依存関係であるseabornとnumpyがリストされています。 " -"右側に2つの矢印があります。最初のものは、コマンド python - m pip install your-package " +"と表示され、そのパッケージの主要な依存関係であるseabornとnumpyがリストされています。 右側に2つの矢印があります。最初のものは、コマンド " +"python - m pip install your-package " "を示しています。それらをインストールすると、パッケージと2つのコア依存関係のみがユーザー環境にインストールされることを示しています。以下は、2つ目の矢印で、" " python -m pip install youPackage[tests] とあります。これにより、パッケージ依存関係 - your-" "package、seaborn、numpy とテスト依存関係 pytest、pytest-cov の両方を含む環境が構築されます。" -#: ../../package-structure-code/declare-dependencies.md:282 +#: ../../package-structure-code/declare-dependencies.md:281 #, fuzzy msgid "" "When a user installs your package using `pip install your-package`, only " "your package and its core dependencies get installed. When they install " -"with `pip install your-package[tests]`, pip will install your package, " -"core dependencies, and the test dependencies from the `[project.optional-" +"with `pip install your-package[tests]`, pip will install your package, core" +" dependencies, and the test dependencies from the `[project.optional-" "dependencies]` table." msgstr "" "ユーザがローカルで `python -m pip install your-package` " @@ -1351,263 +1382,297 @@ msgstr "" "はあなたのパッケージとそのコア依存パッケージの両方をインストールし、さらに `[project.optional-dependencies]` " "テーブルの tests 配列にリストされている依存パッケージをインストールします。" -#: ../../package-structure-code/declare-dependencies.md:289 +#: ../../package-structure-code/declare-dependencies.md:288 msgid "Using uv or pip for installation" -msgstr "" +msgstr "インストールに uv または pip を使用する" -#: ../../package-structure-code/declare-dependencies.md:291 +#: ../../package-structure-code/declare-dependencies.md:290 msgid "" "UV streamlines this process, allowing you to sync a venv in your project " "directory with both an editable install of your package and its " -"dependencies automatically. You can also use pip and install dependencies" -" into the environment of your choice." +"dependencies automatically. You can also use pip and install dependencies " +"into the environment of your choice." msgstr "" +"UV はこのプロセスを合理化し、プロジェクト ディレクトリ内の venv " +"を、パッケージの編集可能なインストールとその依存関係の両方と自動的に同期できるようにします。 pip " +"を使用して、依存関係を選択した環境にインストールすることもできます。" -#: ../../package-structure-code/declare-dependencies.md:296 +#: ../../package-structure-code/declare-dependencies.md:295 msgid "" -"We shouldn't show UV pip install, so how do you add optional feature deps" -" with UV??" -msgstr "" +"We shouldn't show UV pip install, so how do you add optional feature deps " +"with UV??" +msgstr "UV pip install を表示すべきではないのですが、UV でオプションの機能 deps を追加するにはどうすればよいですか??" -#: ../../package-structure-code/declare-dependencies.md:299 +#: ../../package-structure-code/declare-dependencies.md:298 +#: ../../package-structure-code/declare-dependencies.md:361 #, fuzzy msgid "**Install dependency groups:**" msgstr "依存グループをインストールする" #: ../../package-structure-code/declare-dependencies.md msgid "Use UV" -msgstr "" +msgstr "UVを使用する" -#: ../../package-structure-code/declare-dependencies.md:305 +#: ../../package-structure-code/declare-dependencies.md:304 msgid "You can use uv sync to sync dependency groups in your uv-managed venv" -msgstr "" +msgstr "UV 同期を使用して、UV 管理の venv 内の依存関係グループを同期できます。" + +#: ../../package-structure-code/declare-dependencies.md:312 +msgid "" +"use ``--active`` with ``uv sync`` to prefer the currently active virtual " +"environment over the project's own managed environment:" +msgstr "プロジェクト独自の管理環境よりも現在アクティブな仮想環境を優先するには、 `--active` を `uv sync` とともに使用します。" -#: ../../package-structure-code/declare-dependencies.md:313 -#: ../../package-structure-code/declare-dependencies.md:334 +#: ../../package-structure-code/declare-dependencies.md:319 +#: ../../package-structure-code/declare-dependencies.md:354 #, fuzzy msgid "**Install optional dependencies:**" msgstr "オプションの依存関係" -#: ../../package-structure-code/declare-dependencies.md:321 +#: ../../package-structure-code/declare-dependencies.md:328 +msgid "" +"Use the `--active` flag with `uv run` to prefer the currently active " +"virtual environment over the project's own managed environment:" +msgstr "プロジェクト独自の管理環境よりも現在アクティブな仮想環境を優先するには、「uv run」で「--active」フラグを使用します。" + +#: ../../package-structure-code/declare-dependencies.md:336 +msgid "" +"This is useful when you have activated a virtual environment and want `uv " +"run` to use it instead of automatically creating or selecting the project's" +" environment." +msgstr "これは、仮想環境をアクティブ化しており、プロジェクトの環境を自動的に作成または選択する代わりに、「uv run」でそれを使用したい場合に便利です。" + +#: ../../package-structure-code/declare-dependencies.md:341 #, fuzzy msgid "**Install everything (package + all dependencies):**" msgstr "Pythonパッケージの依存関係" -#: ../../package-structure-code/declare-dependencies.md:327 +#: ../../package-structure-code/declare-dependencies.md:347 msgid "" -"`uv sync` is the recommended command for development workflows. It " -"manages your virtual environment and keeps your lockfile up to date. Use " -"`uv pip install` when you need pip-compatible behavior." +"`uv sync` is the recommended command for development workflows. It manages " +"your virtual environment and keeps your lockfile up to date. Use `uv pip " +"install` when you need pip-compatible behavior." msgstr "" +"「uv sync」は開発ワークフローに推奨されるコマンドです。仮想環境を管理し、ロックファイルを最新の状態に保ちます。 pip " +"互換の動作が必要な場合は、「uv pip install」を使用してください。" #: ../../package-structure-code/declare-dependencies.md msgid "Use pip (version >=25.1)" -msgstr "" +msgstr "pip を使用します (バージョン >=25.1)" -#: ../../package-structure-code/declare-dependencies.md:341 -#, fuzzy -msgid "**Install dependency groups:**" -msgstr "依存グループをインストールする" - -#: ../../package-structure-code/declare-dependencies.md:348 +#: ../../package-structure-code/declare-dependencies.md:368 #, fuzzy msgid "" -"Always call pip using `python -m pip` to ensure you're using the pip from" -" your current active Python environment. This helps avoid installation " +"Always call pip using `python -m pip` to ensure you're using the pip from " +"your current active Python environment. This helps avoid installation " "conflicts." msgstr "" -"`python -m` を使用して pip を呼び出すと、パッケージをインストールするために使用する `pip` が、現在アクティブな " -"Python 環境のものであることが保証されます。インストールの衝突を避けるために、 `pip` " -"を呼び出すときは常にこの方法を使うことを強く推奨します。" +"`python -m` を使用して pip を呼び出すと、パッケージをインストールするために使用する `pip` が、現在アクティブな Python " +"環境のものであることが保証されます。インストールの衝突を避けるために、 `pip` を呼び出すときは常にこの方法を使うことを強く推奨します。" -#: ../../package-structure-code/declare-dependencies.md:352 +#: ../../package-structure-code/declare-dependencies.md:372 msgid "" -"**Note:** Some shells (like zsh on Mac) require quotes around brackets to" -" run successfully:" -msgstr "" +"**Note:** Some shells (like zsh on Mac) require quotes around brackets to " +"run successfully:" +msgstr "**注意:** 一部のシェル (Mac の zsh など) を正常に実行するには、括弧で囲む必要があります。" -#: ../../package-structure-code/declare-dependencies.md:354 +#: ../../package-structure-code/declare-dependencies.md:374 msgid "`python -m pip install \".[tests]\"`" msgstr "`python -m pip install \".[tests]\"`" -#: ../../package-structure-code/declare-dependencies.md:360 +#: ../../package-structure-code/declare-dependencies.md:380 #, fuzzy msgid "Combining dependency groups" msgstr "依存グループをインストールする" -#: ../../package-structure-code/declare-dependencies.md:362 +#: ../../package-structure-code/declare-dependencies.md:382 msgid "You can also create combined groups that reference other groups:" -msgstr "" +msgstr "他のグループを参照する結合グループを作成することもできます。" -#: ../../package-structure-code/declare-dependencies.md:371 +#: ../../package-structure-code/declare-dependencies.md:391 msgid "Then install everything with pip install or uv sync as needed:" -msgstr "" +msgstr "次に、必要に応じて pip install または uv sync を使用してすべてをインストールします。" -#: ../../package-structure-code/declare-dependencies.md:380 +#: ../../package-structure-code/declare-dependencies.md:400 #, fuzzy msgid "" "When you install optional dependencies, pip and uv install your package " "and its core dependencies automatically." msgstr "`pip` はあなたのパッケージとそのコアの依存関係もインストールします。" -#: ../../package-structure-code/declare-dependencies.md:384 +#: ../../package-structure-code/declare-dependencies.md:404 #, fuzzy msgid "Version specifiers for dependencies" msgstr "依存関係のセットを組み合わせる" -#: ../../package-structure-code/declare-dependencies.md:386 +#: ../../package-structure-code/declare-dependencies.md:406 msgid "" "Version specifiers control which versions of a dependency work with your " -"package. Use them to specify minimum versions, exclude buggy releases, or" -" set version ranges." -msgstr "" +"package. Use them to specify minimum versions, exclude buggy releases, or " +"set version ranges." +msgstr "バージョン指定子は、パッケージで動作する依存関係のバージョンを制御します。これらを使用して、最小バージョンを指定したり、バグのあるリリースを除外したり、バージョン範囲を設定したりできます。" -#: ../../package-structure-code/declare-dependencies.md:390 +#: ../../package-structure-code/declare-dependencies.md:410 msgid "Common operators" -msgstr "" +msgstr "一般的な演算子" -#: ../../package-structure-code/declare-dependencies.md:392 +#: ../../package-structure-code/declare-dependencies.md:412 msgid "" "**`>=`** Minimum version set: `numpy>=1.20` (This is the most common " "approach and is recommended)" -msgstr "" +msgstr "**`>=`** 最小バージョンセット: `numpy>=1.20` (これが最も一般的なアプローチであり、推奨されます)" -#: ../../package-structure-code/declare-dependencies.md:393 +#: ../../package-structure-code/declare-dependencies.md:413 msgid "" -"**`==`** Exact version: `requests==2.28.0` (Avoid pinning dependencies " -"like this unless necessary)" -msgstr "" +"**`==`** Exact version: `requests==2.28.0` (Avoid pinning dependencies like" +" this unless necessary)" +msgstr "**`==`** 正確なバージョン: `requests==2.28.0` (必要な場合を除き、このような依存関係の固定は避けてください)" -#: ../../package-structure-code/declare-dependencies.md:394 +#: ../../package-structure-code/declare-dependencies.md:414 msgid "" "**`~=`** Compatible release: `django~=4.2.0` (Allows patches: " ">=4.2.0,<4.3.0)" -msgstr "" +msgstr "**`~=`** 互換性のあるリリース: `django~=4.2.0` (許可されるパッチ: >=4.2.0、<4.3.0)" -#: ../../package-structure-code/declare-dependencies.md:395 +#: ../../package-structure-code/declare-dependencies.md:415 msgid "**`<` or `>`** - Upper/lower bounds: `pandas>=1.0,<3.0`" -msgstr "" +msgstr "**`<` または `>`** - 上限/下限: `pandas>=1.0,<3.0`" -#: ../../package-structure-code/declare-dependencies.md:396 +#: ../../package-structure-code/declare-dependencies.md:416 msgid "" -"**`!=`** Exclude version: `scipy>=1.7,!=1.8.0` (Rare but allows you to " -"skip a buggy release version)" -msgstr "" +"**`!=`** Exclude version: `scipy>=1.7,!=1.8.0` (Rare but allows you to skip" +" a buggy release version)" +msgstr "**`!=`** バージョンを除外します: `scipy>=1.7,!=1.8.0` (まれですが、バグのあるリリース バージョンをスキップできます)" -#: ../../package-structure-code/declare-dependencies.md:399 +#: ../../package-structure-code/declare-dependencies.md:419 msgid "" "**Best practice:** Use `>=` to specify your minimum tested version and " "avoid upper bounds unless you know at what version that dependency is no " -"longer compatible. UV will do this by default when it adds a dependency " -"to your pyproject.toml file. This keeps your package flexible and reduces" -" dependency conflicts." +"longer compatible. UV will do this by default when it adds a dependency to " +"your pyproject.toml file. This keeps your package flexible and reduces " +"dependency conflicts." msgstr "" +"**ベスト プラクティス:** `>=` " +"を使用してテスト済みの最小バージョンを指定し、依存関係に互換性がなくなったバージョンがわからない限り、上限を避けます。 UV " +"は、pyproject.toml " +"ファイルに依存関係を追加するときに、デフォルトでこれを実行します。これにより、パッケージの柔軟性が維持され、依存関係の競合が軽減されます。" -#: ../../package-structure-code/declare-dependencies.md:415 +#: ../../package-structure-code/declare-dependencies.md:435 msgid "Using conda and Pixi" -msgstr "" +msgstr "conda と Pixi の使用" -#: ../../package-structure-code/declare-dependencies.md:419 +#: ../../package-structure-code/declare-dependencies.md:439 #, fuzzy msgid "" "The `pyproject.toml` file works great for pure-Python packages. However, " "some packages (particularly in the scientific Python ecosystem) require " "dependencies written in other languages like C or Fortran. Conda was " -"created to support the distribution of tools with non-Python " -"dependencies." +"created to support the distribution of tools with non-Python dependencies." msgstr "" "いくつかのパッケージ、特に科学的なPythonエコシステムでは、Pythonで書かれていない依存関係を必要とします。 " "Condaは、PythonとPython以外の言語の両方で書かれたコードを持つツールの配布をサポートするために作られました。" -#: ../../package-structure-code/declare-dependencies.md:424 +#: ../../package-structure-code/declare-dependencies.md:444 #, fuzzy msgid "**For conda users:**" msgstr "condaユーザーへのメモ" -#: ../../package-structure-code/declare-dependencies.md:426 +#: ../../package-structure-code/declare-dependencies.md:446 msgid "" -"You can maintain an `environment.yml` file to help users and contributors" -" set up conda environments. This is especially useful for packages with " +"You can maintain an `environment.yml` file to help users and contributors " +"set up conda environments. This is especially useful for packages with " "system-level dependencies like GDAL." msgstr "" +"ユーザーや寄稿者が conda 環境をセットアップできるように、「environment.yml」ファイルを管理できます。これは、GDAL " +"などのシステム レベルの依存関係を持つパッケージに特に役立ちます。" -#: ../../package-structure-code/declare-dependencies.md:430 +#: ../../package-structure-code/declare-dependencies.md:450 msgid "**Consider Pixi for conda package focused workflows:**" -msgstr "" +msgstr "**conda パッケージに重点を置いたワークフローについては、Pixi を検討してください:**" -#: ../../package-structure-code/declare-dependencies.md:432 +#: ../../package-structure-code/declare-dependencies.md:452 msgid "" "[Pixi](https://pixi.sh) is a modern package manager built on top of both " "the conda and Python package ecosystems. Pixi is able to treat conda and " "Python package requirements with parity when resolving environments, but " -"uses a \"conda-first\" approach of using already resolved conda packages " -"if possible when resolving Python dependencies. Pixi [can also use " +"uses a \"conda-first\" approach of using already resolved conda packages if" +" possible when resolving Python dependencies. Pixi [can also use " "`pyproject.toml` for " "configuration](https://pixi.sh/latest/python/pyproject_toml/). If your " "project relies heavily on conda packages, Pixi offers a streamlined " -"workflow with faster dependency resolution and automatic lock file " -"support for full environment reproducibility. If you already have an " -"existing conda environment definition file, like an `environment.yml`, " -"you can [import the " -"environment](https://pixi.sh/latest/tutorials/import/) into a new Pixi " +"workflow with faster dependency resolution and automatic lock file support " +"for full environment reproducibility. If you already have an existing conda" +" environment definition file, like an `environment.yml`, you can [import " +"the environment](https://pixi.sh/latest/tutorials/import/) into a new Pixi " "workspace with" msgstr "" - -#: ../../package-structure-code/declare-dependencies.md:450 +"[Pixi](https://pixi.sh) は、conda パッケージ エコシステムと Python パッケージ " +"エコシステムの両方の上に構築された最新のパッケージ マネージャーです。 Pixi は、環境を解決するときに conda と Python " +"パッケージの要件を同等に扱うことができますが、Python の依存関係を解決するときに、可能であればすでに解決済みの conda " +"パッケージを使用する「conda ファースト」アプローチを使用します。 Pixi [構成に `pyproject.toml` " +"を使用することもできます](https://pixi.sh/latest/python/pyproject_toml/)。プロジェクトが conda " +"パッケージに大きく依存している場合、Pixi は、環境を完全に再現するために、より迅速な依存関係の解決と自動ロック " +"ファイルのサポートを備えた合理化されたワークフローを提供します。 `environment.yml` などの既存の conda " +"環境定義ファイルがすでにある場合は、次のコマンドを使用して新しい Pixi ワークスペースに " +"[環境をインポート](https://pixi.sh/latest/tutorials/import/) できます。" + +#: ../../package-structure-code/declare-dependencies.md:470 msgid "A note for conda users" msgstr "condaユーザーへのメモ" -#: ../../package-structure-code/declare-dependencies.md:453 +#: ../../package-structure-code/declare-dependencies.md:473 msgid "" "If you use a conda environment for development and install your package " -"with `python -m pip install -e .` dependencies will be installed from " -"PyPI, potentially overwriting conda packages that had already been " -"installed. This can cause conflicts, especially for packages with system " -"dependencies." +"with `python -m pip install -e .` dependencies will be installed from PyPI," +" potentially overwriting conda packages that had already been installed. " +"This can cause conflicts, especially for packages with system dependencies." msgstr "" +"開発に conda 環境を使用し、「python -m pip install -e」でパッケージをインストールする場合、依存関係は PyPI " +"からインストールされ、すでにインストールされている conda " +"パッケージが上書きされる可能性があります。これにより、特にシステム依存関係のあるパッケージの場合、競合が発生する可能性があります。" -#: ../../package-structure-code/declare-dependencies.md:458 +#: ../../package-structure-code/declare-dependencies.md:478 #, fuzzy msgid "To avoid this, install your package without dependencies:" msgstr "`pip` はあなたのパッケージとそのコアの依存関係もインストールします。" -#: ../../package-structure-code/declare-dependencies.md:464 +#: ../../package-structure-code/declare-dependencies.md:484 #, fuzzy msgid "Then install dependencies through your conda `environment.yml` file." msgstr "pyproject.tomlファイルに依存関係を追加" -#: ../../package-structure-code/declare-dependencies.md:467 +#: ../../package-structure-code/declare-dependencies.md:487 msgid "Dependencies in Read the Docs" msgstr "Read the Docs の依存関係" -#: ../../package-structure-code/declare-dependencies.md:469 +#: ../../package-structure-code/declare-dependencies.md:489 #, fuzzy msgid "" "Once you've specified dependencies in your `pyproject.toml`, you can use " "them in other workflows like building documentation on Read the Docs." msgstr "プロジェクトで依存関係を指定できたので、Read the Docsへのパブリッシュなど、他のワークフローをサポートするためにそれらを使用できます。" -#: ../../package-structure-code/declare-dependencies.md:472 +#: ../../package-structure-code/declare-dependencies.md:492 #, fuzzy msgid "" -"[Read the Docs](https://readthedocs.org) is a documentation platform that" -" automatically builds and publishes your documentation. To install your " +"[Read the Docs](https://readthedocs.org) is a documentation platform that " +"automatically builds and publishes your documentation. To install your " "dependencies during the build process, configure them in a " "**readthedocs.yaml** file." msgstr "" "[Read the Docs](https://readthedocs.org) " "は、継続的インテグレーション/継続的デプロイメントサービスを備えたドキュメントプラットフォームで、あなたのドキュメントを自動的にビルドして公開します。" -#: ../../package-structure-code/declare-dependencies.md:477 +#: ../../package-structure-code/declare-dependencies.md:497 msgid "Here's an example that installs your `docs` optional dependencies:" -msgstr "" +msgstr "以下は、「docs」のオプションの依存関係をインストールする例です。" -#: ../../package-structure-code/declare-dependencies.md:488 +#: ../../package-structure-code/declare-dependencies.md:508 #, fuzzy msgid "Learn more about Read the Docs" msgstr "flitについてもっと知る" -#: ../../package-structure-code/declare-dependencies.md:491 +#: ../../package-structure-code/declare-dependencies.md:511 #, fuzzy msgid "" "[Creating a readthedocs.yaml file](https://docs.readthedocs.io/en/stable" @@ -1617,17 +1682,17 @@ msgstr "" "ファイルの作成方法についてはこちらをご覧ください。](https://docs.readthedocs.io/en/stable/config-" "file/index.html)" -#: ../../package-structure-code/declare-dependencies.md:492 +#: ../../package-structure-code/declare-dependencies.md:512 #, fuzzy msgid "" -"[Using uv with Read the Docs](https://docs.readthedocs.io/en/stable" -"/build-customization.html)" +"[Using uv with Read the Docs](https://docs.readthedocs.io/en/stable/build-" +"customization.html)" msgstr "" "[ `readthedocs.yaml` " "ファイルの作成方法についてはこちらをご覧ください。](https://docs.readthedocs.io/en/stable/config-" "file/index.html)" -#: ../../package-structure-code/declare-dependencies.md:493 +#: ../../package-structure-code/declare-dependencies.md:513 #, fuzzy msgid "" "[Using Poetry with Read the Docs](https://docs.readthedocs.io/en/stable" @@ -1637,20 +1702,20 @@ msgstr "" "[こちらで詳しく説明されています。](https://docs.readthedocs.io/en/stable/build-" "customization.html#install-dependencies-with-poetry)" -#: ../../package-structure-code/declare-dependencies.md:498 +#: ../../package-structure-code/declare-dependencies.md:518 #, fuzzy msgid "" "Keep this comment - in this file for now - Jeremiah " -"did a nice inventory of common shells and whether they need quotes or " -"not. It's really comprehensive. But do we want it in the guide?? It's " -"really useful for more advanced users." +"guide/pull/106#issuecomment-1844278487> in this file for now - Jeremiah did" +" a nice inventory of common shells and whether they need quotes or not. " +"It's really comprehensive. But do we want it in the guide?? It's really " +"useful for more advanced users." msgstr "" "このコメントを残しておいてください - https://github.com/pyOpenSci/python-package-" "guide/pull/106#issuecomment-1844278487 - " "今のところはこのファイルに。jeremiahは一般的なシェルについて、引用符が必要かどうかという点も含めて、素晴らしいリストを作成しました。本当に包括的です。しかし、ガイドに必要でしょうか？上級ユーザーにとっては本当に役立つと思います。" -#: ../../package-structure-code/declare-dependencies.md:500 +#: ../../package-structure-code/declare-dependencies.md:520 #, fuzzy msgid "" "Following this comment: `pandas 3.X.X`)" +msgstr "メジャー バージョンのアップデート (例: `pandas 2.X.X` -> `pandas 3.X.X`)" + +#: ../../package-structure-code/declare-dependencies.md:691 +#, fuzzy +msgid "new transitive dependencies (i.e. not part of your `pyproject.toml`)" +msgstr "pyproject.tomlファイルに依存関係を追加" + +#: ../../package-structure-code/declare-dependencies.md:694 +msgid "" +"A lock file captures one environment for CI testing, not the full " +"compatibility range declared in `pyproject.toml`. Projects that use lock " +"files may want to have CI test other environments such as" +msgstr "" +"ロック ファイルは、`pyproject.toml` で宣言された完全な互換性範囲ではなく、CI テスト用の 1 つの環境をキャプチャします。ロック " +"ファイルを使用するプロジェクトでは、次のような他の環境を CI テストする必要がある場合があります。" + +#: ../../package-structure-code/declare-dependencies.md:698 +msgid "" +"the latest packages consistent with your `pyproject.toml`, subject to " +"dependency cooldowns. This lets you know if a dependency update breaks your" +" package." +msgstr "" +"依存関係のクールダウンの対象となる、`pyproject.toml` " +"と一致する最新のパッケージ。これにより、依存関係の更新によってパッケージが破損するかどうかがわかります。" + +#: ../../package-structure-code/declare-dependencies.md:701 +msgid "" +"older supported versions of Python to let you know if a recent change to " +"your package no longer works with an older Python release." +msgstr "" +"サポートされている古いバージョンの Python では、パッケージに対する最近の変更が古い Python " +"リリースで動作しなくなったかどうかを通知します。" + +#: ../../package-structure-code/declare-dependencies.md +msgid "What about `requirements.txt`" +msgstr "「requirements.txt」はどうでしょうか？" + +#: ../../package-structure-code/declare-dependencies.md:712 +msgid "" +"Older approaches to locking used `pip freeze` to generate a " +"`requirements.txt` that got used as a lock file. These are minimal lock " +"files that pin a specific version for the system on which the command was " +"run. They might look like" +msgstr "" +"ロックに対する古いアプローチでは、「pip フリーズ」を使用して、ロック " +"ファイルとして使用される「requirements.txt」を生成していました。これらは、コマンドが実行されたシステムの特定のバージョンを固定する最小限のロック" +" ファイルです。彼らは次のように見えるかもしれません" + +#: ../../package-structure-code/declare-dependencies.md:722 +msgid "" +"However, this minimal level of specificity has several downsides making " +"lock files the preferred format:" +msgstr "ただし、この最小レベルの特異性には、ロック ファイルが推奨される形式となるいくつかの欠点があります。" + +#: ../../package-structure-code/declare-dependencies.md:724 +msgid "" +"The versions satisfying `pyproject.toml` may differ between your Windows " +"laptop and the Linux server your CI runs on. A single lock file contains " +"the information needed to build platform specific and Python version " +"specific environments. In contrast, a separate `requirements.txt` files is " +"needed to store this information (e.g. `requirements.ci.txt`, " +"`requirements.py313-macos.txt`)" +msgstr "" +"`pyproject.toml` を満たすバージョンは、Windows ラップトップと CI が実行される Linux " +"サーバーとの間で異なる場合があります。単一のロック ファイルには、プラットフォーム固有および Python " +"バージョン固有の環境を構築するために必要な情報が含まれています。対照的に、この情報を保存するには別の `requirements.txt` " +"ファイルが必要です (例: `requirements.ci.txt`、`requirements.py313-macos.txt`)。" + +#: ../../package-structure-code/declare-dependencies.md:730 +msgid "" +"Packages can get updated without a version update for both legitimate and " +"malicious reasons. Lock files include package hashes to catch this. A " +"[hash](https://en.wikipedia.org/wiki/Hash_function) is a unique signature " +"computed from the code and any change to the code will cause the release to" +" have a different hash even if is given the same release version number." +msgstr "" +"パッケージは、正当な理由と悪意のある理由の両方で、バージョンを更新せずに更新される可能性があります。ロック " +"ファイルには、これを検出するためのパッケージ ハッシュが含まれています。 " +"[ハッシュ](https://en.wikipedia.org/wiki/Hash_function) " +"はコードから計算される一意の署名であり、コードに変更を加えると、たとえ同じリリース " +"バージョン番号が与えられていたとしても、リリースのハッシュは異なります。" + +#: ../../package-structure-code/declare-dependencies.md:736 +msgid "" +"Other metadata determined during resolution of `pyproject.toml` (e.g. which" +" dependencies are transitive, where the packages were downloaded from, " +"etc.) that can help speed up future installs is lost." +msgstr "" +"`pyproject.toml` の解決中に決定された、今後のインストールの高速化に役立つ他のメタデータ (例: " +"どの依存関係が推移的であるか、パッケージのダウンロード元など) は失われます。" + #: ../../package-structure-code/intro.md:163 msgid "Intro" msgstr "イントロ" @@ -1724,10 +2178,12 @@ msgstr "Pythonパッケージ構造" #: ../../package-structure-code/intro.md:3 msgid "" -"This section covers everything you need to structure your Python package," -" configure metadata, choose build tools, and publish your package to PyPI" -" and conda-forge." +"This section covers everything you need to structure your Python package, " +"configure metadata, choose build tools, and publish your package to PyPI " +"and conda-forge." msgstr "" +"このセクションでは、Python パッケージの構造化、メタデータの構成、ビルド ツールの選択、パッケージを PyPI と conda-forge " +"に公開するために必要なすべてについて説明します。" #: ../../package-structure-code/intro.md:9 #, fuzzy @@ -1736,15 +2192,15 @@ msgstr "Pythonパッケージングツール" #: ../../package-structure-code/intro.md:13 msgid "**Start with our step-by-step tutorials:**" -msgstr "" +msgstr "**ステップバイステップのチュートリアルから始めてください:**" #: ../../package-structure-code/intro.md:15 msgid "Follow along as we create a package from scratch" -msgstr "" +msgstr "パッケージを最初から作成する手順に従ってください" #: ../../package-structure-code/intro.md:16 msgid "Learn by doing with guided examples" -msgstr "" +msgstr "ガイド付きの例を使って実践的に学習する" #: ../../package-structure-code/intro.md:17 #, fuzzy @@ -1753,15 +2209,15 @@ msgstr "Pythonパッケージのバージョンを管理するツール" #: ../../package-structure-code/intro.md:19 msgid "Start the tutorial series" -msgstr "" +msgstr "チュートリアル シリーズを開始する" #: ../../package-structure-code/intro.md:27 msgid "Already have code to package?" -msgstr "" +msgstr "パッケージ化するコードはすでにありますか?" #: ../../package-structure-code/intro.md:30 msgid "**Jump into the reference guides:**" -msgstr "" +msgstr "**リファレンス ガイドにジャンプします:**" #: ../../package-structure-code/intro.md:32 #, fuzzy @@ -1770,15 +2226,15 @@ msgstr "Pythonパッケージ構造" #: ../../package-structure-code/intro.md:33 msgid "Compare build tools and choose what's right for you" -msgstr "" +msgstr "構築ツールを比較して最適なものを選択してください" #: ../../package-structure-code/intro.md:34 msgid "Understand the publishing process" -msgstr "" +msgstr "出版プロセスを理解する" #: ../../package-structure-code/intro.md:36 msgid "Start with the cards below ↓" -msgstr "" +msgstr "まずは以下のカードから↓" #: ../../package-structure-code/intro.md:40 msgid "How this content is developed" @@ -1797,55 +2253,53 @@ msgstr "ここで学べること" #: ../../package-structure-code/intro.md:48 msgid "In this section, you'll learn how to:" -msgstr "" +msgstr "このセクションでは、次の方法を学習します。" #: ../../package-structure-code/intro.md:50 msgid "" -"**Structure your package** - Choose between src and flat layouts, " -"organize tests and documentation" -msgstr "" +"**Structure your package** - Choose between src and flat layouts, organize " +"tests and documentation" +msgstr "**パッケージを構造化** - src レイアウトとフラット レイアウトを選択し、テストとドキュメントを整理します" #: ../../package-structure-code/intro.md:51 msgid "" -"**Configure metadata** - Set up `pyproject.toml` with project " -"information, dependencies, and versioning" -msgstr "" +"**Configure metadata** - Set up `pyproject.toml` with project information, " +"dependencies, and versioning" +msgstr "**メタデータの構成** - プロジェクト情報、依存関係、およびバージョン管理を使用して `pyproject.toml` をセットアップします。" #: ../../package-structure-code/intro.md:52 msgid "" -"**Choose build tools** - Compare Hatch, PDM, Poetry, and setuptools to " -"find the right fit" -msgstr "" +"**Choose build tools** - Compare Hatch, PDM, Poetry, and setuptools to find" +" the right fit" +msgstr "**ビルド ツールの選択** - Hatch、PDM、Poetry、setuptools を比較して適切なものを見つけます" #: ../../package-structure-code/intro.md:53 -msgid "" -"**Build distributions** - Create sdist and wheel files ready for " -"publication" -msgstr "" +msgid "**Build distributions** - Create sdist and wheel files ready for publication" +msgstr "**ディストリビューションのビルド** - 公開可能な sdist ファイルと Wheel ファイルを作成します。" #: ../../package-structure-code/intro.md:54 msgid "" "**Publish your package** - Make your package available on PyPI and " "optionally conda-forge" -msgstr "" +msgstr "**パッケージを公開する** - パッケージを PyPI およびオプションで conda-forge で利用できるようにします" #: ../../package-structure-code/intro.md:55 msgid "" -"**Maintain code quality** - Set up linters and formatters to keep your " -"code consistent" -msgstr "" +"**Maintain code quality** - Set up linters and formatters to keep your code" +" consistent" +msgstr "**コードの品質を維持する** - コードの一貫性を保つためにリンターとフォーマッタを設定します。" #: ../../package-structure-code/intro.md:57 #, fuzzy msgid "" "Our recommendations align with current [Python packaging " -"standards](https://packaging.python.org/en/latest/) and [Scientific " -"Python community specs](https://scientific-python.org/specs/), while " -"prioritizing tools that are beginner-friendly and well-maintained." +"standards](https://packaging.python.org/en/latest/) and [Scientific Python " +"community specs](https://scientific-python.org/specs/), while prioritizing " +"tools that are beginner-friendly and well-maintained." msgstr "" "ここでは、私たちの提案を、最新の、受け入れられている " -"[Pythonコミュニティ](https://packaging.python.org/en/latest/) と " -"[科学コミュニティ](https://scientific-python.org/specs/) に合わせることも試みています。" +"[Pythonコミュニティ](https://packaging.python.org/en/latest/) と [科学コミュニティ](https" +"://scientific-python.org/specs/) に合わせることも試みています。" #: ../../package-structure-code/intro.md:59 #, fuzzy @@ -1860,11 +2314,13 @@ msgstr "✨ 1. パッケージのファイル構成 ✨" #: ../../package-structure-code/intro.md:68 msgid "" "Learn how to organize your package files using [src or flat layouts" -"](package-source-layout). This page helps you decide on a package " -"structure that follows modern Python best practices, including where to " -"place [tests](src-layout-test) and [documentation](package-source-" -"layout)." +"](package-source-layout). This page helps you decide on a package structure" +" that follows modern Python best practices, including where to place [tests" +"](src-layout-test) and [documentation](package-source-layout)." msgstr "" +"[src またはフラット レイアウト](package-source-layout) を使用してパッケージ " +"ファイルを整理する方法を学びます。このページは、[テスト](src-layout-test) と [ドキュメント](package-source-" +"layout) をどこに配置するかなど、最新の Python のベスト プラクティスに従ったパッケージ構造を決定するのに役立ちます。" #: ../../package-structure-code/intro.md:71 #, fuzzy @@ -1874,10 +2330,9 @@ msgstr "✨ 4. メタデータを追加する ✨" #: ../../package-structure-code/intro.md:73 #, fuzzy msgid "" -"Learn how to add [project metadata](pyproject-toml-python-package-" -"metadata) to your Python package to support both filtering on PyPI and " -"also the metadata that a package installer needs to build and install " -"your package." +"Learn how to add [project metadata](pyproject-toml-python-package-metadata)" +" to your Python package to support both filtering on PyPI and also the " +"metadata that a package installer needs to build and install your package." msgstr "" "Python パッケージにプロジェクトのメタデータを追加して、PyPI " "でのフィルタリングと、パッケージインストーラがパッケージをビルドしてインストールするために必要なメタデータの両方をサポートする方法を学びましょう。" @@ -1894,6 +2349,9 @@ msgid "" "dependencies](dependency-groups) in your [pyproject.toml file](pyproject-" "toml-overview)." msgstr "" +"[pyproject.toml ファイル](pyproject-toml-overview) で [必須の依存関係](required-" +"dependency)、[オプションの機能の依存関係](optional-dependency)、および [開発の依存関係](dependency-" +"groups) を指定する方法を学びます。" #: ../../package-structure-code/intro.md:83 #, fuzzy @@ -1904,10 +2362,14 @@ msgstr "✨ 5. パッケージのバージョニングを設定する ✨" msgid "" "Learn how to manage package versions using [semantic versioning (SemVer" ")](package-versioning) or [calendar versioning (CalVer)](package-" -"versioning). This page helps you choose the right versioning strategy and" -" set up [automated version management](tools-version-management) using " -"tools like hatch_vcs or setuptools-scm." +"versioning). This page helps you choose the right versioning strategy and " +"set up [automated version management](tools-version-management) using tools" +" like hatch_vcs or setuptools-scm." msgstr "" +"[セマンティック バージョニング (SemVer)](パッケージ バージョニング) または [カレンダー バージョニング " +"(CalVer)](パッケージ バージョニング) を使用してパッケージ " +"バージョンを管理する方法を学びます。このページは、適切なバージョン管理戦略を選択し、hatch_vcs や setuptools-scm " +"などのツールを使用して [自動バージョン管理](tools-version-management) をセットアップするのに役立ちます。" #: ../../package-structure-code/intro.md:89 #, fuzzy @@ -1921,15 +2383,18 @@ msgstr "✨6. コードスタイルとリンター✨" #: ../../package-structure-code/intro.md:98 msgid "" -"Learn how to set up [code formatters and linters](code-style-tools) " -"([Black](about-black), [Ruff](about-ruff), [flake8](about-flake8)) to " -"ensure your package follows [PEP 8 standards](code-style-tools) and " -"maintains consistent code style throughout your project." +"Learn how to set up [code formatters and linters](code-style-tools) ([Black" +"](about-black), [Ruff](about-ruff), [flake8](about-flake8)) to ensure your " +"package follows [PEP 8 standards](code-style-tools) and maintains " +"consistent code style throughout your project." msgstr "" +"[コード フォーマッタとリンター](code-style-tools) ([Black](about-black)、[Ruff](about-" +"ruff)、[flake8](about-flake8)) を設定して、パッケージが [PEP 8 標準](code-style-tools) " +"に準拠し、プロジェクト全体で一貫したコード スタイルを維持する方法を学びます。" #: ../../package-structure-code/intro.md:102 msgid "Build & publish" -msgstr "" +msgstr "構築して公開する" #: ../../package-structure-code/intro.md:109 #, fuzzy @@ -1940,9 +2405,12 @@ msgstr "ビルドワークフローツールの選択" msgid "" "Learn how to choose the right packaging tool for your project. Compare " "[Hatch](about-hatch), [PDM](about-pdm), [Poetry](about-poetry), and " -"[setuptools](about-setuptools) to find the best fit for your workflow. " -"See the [summary comparison](summary-build-tools) to help decide." +"[setuptools](about-setuptools) to find the best fit for your workflow. See " +"the [summary comparison](summary-build-tools) to help decide." msgstr "" +"プロジェクトに適したパッケージ化ツールを選択する方法を学びます。 [Hatch](about-hatch)、[PDM](about-" +"pdm)、[Poetry](about-poetry)、および [setuptools](about-setuptools) " +"を比較して、ワークフローに最適なものを見つけます。決定に役立つように、[概要比較](summary-build-tools) を参照してください。" #: ../../package-structure-code/intro.md:114 #, fuzzy @@ -1955,6 +2423,9 @@ msgid "" "package) ([sdist](python-source-distribution) and [wheel](python-wheel)) " "that can be published on [PyPI](publish-pypi-conda)." msgstr "" +"[PyPI](publish-pypi-conda) で公開できる [配布ファイル](build-package) ([sdist](python-" +"source-distribution) および [wheel](python-wheel)) に Python " +"パッケージをビルドする方法を学びます。" #: ../../package-structure-code/intro.md:119 #, fuzzy @@ -1964,21 +2435,25 @@ msgstr "✨ 4. PyPIとCondaに公開する ✨" #: ../../package-structure-code/intro.md:121 msgid "" "Learn how to publish your package to [PyPI](publish-pypi-conda) and " -"optionally to [conda-forge](how-to-submit-to-conda-forge). This page " -"covers the complete process for making your package available to users, " -"including the [conda-forge submission process](how-to-submit-to-conda-" -"forge) after publishing to PyPI." +"optionally to [conda-forge](how-to-submit-to-conda-forge). This page covers" +" the complete process for making your package available to users, including" +" the [conda-forge submission process](how-to-submit-to-conda-forge) after " +"publishing to PyPI." msgstr "" +"パッケージを [PyPI](publish-pypi-conda) に公開する方法と、オプションで [conda-forge](how-to-" +"submit-to-conda-forge) に公開する方法を学びます。このページでは、PyPI に公開した後の [conda-forge " +"送信プロセス](how-to-submit-to-conda-forge) " +"を含む、パッケージをユーザーが利用できるようにするための完全なプロセスについて説明します。" #: ../../package-structure-code/intro.md:125 msgid "Choosing the right tools" -msgstr "" +msgstr "適切なツールの選択" #: ../../package-structure-code/intro.md:127 msgid "" "Not sure which build tool to use? This decision tree can help you choose " "based on your package's needs:" -msgstr "" +msgstr "どのビルド ツールを使用すればよいかわからない場合は、この意思決定ツリーは、パッケージのニーズに基づいて選択するのに役立ちます。" #: ../../package-structure-code/intro.md:131 msgid "" @@ -1988,39 +2463,41 @@ msgstr "様々なパッケージングツールのフロントエンドとバッ #: ../../package-structure-code/intro.md:133 msgid "" -"Use this decision tree to help select a packaging tool. See the " -"[packaging tools page](python-package-build-tools) for detailed " -"comparisons and recommendations." +"Use this decision tree to help select a packaging tool. See the [packaging " +"tools page](python-package-build-tools) for detailed comparisons and " +"recommendations." msgstr "" +"このディシジョン ツリーは、パッケージ化ツールの選択に役立ちます。詳細な比較と推奨事項については、[パッケージング ツール ページ](python-" +"package-build-tools) を参照してください。" #: ../../package-structure-code/intro.md:136 msgid "Our recommendations" -msgstr "" +msgstr "私たちの推奨事項" #: ../../package-structure-code/intro.md:138 msgid "We suggest tools and approaches based on three principles:" -msgstr "" +msgstr "私たちは、次の 3 つの原則に基づいてツールとアプローチを提案します。" #: ../../package-structure-code/intro.md:140 msgid "" -"**Beginner-friendly** - Tools that are easy to learn and use for those " -"new to packaging" -msgstr "" +"**Beginner-friendly** - Tools that are easy to learn and use for those new " +"to packaging" +msgstr "**初心者向け** - パッケージングの初心者にとって学びやすく、使いやすいツール" #: ../../package-structure-code/intro.md:141 msgid "**Well-maintained** - Tools with active development and good documentation" -msgstr "" +msgstr "**よく管理されている** - 活発な開発と充実したドキュメントを備えたツール" #: ../../package-structure-code/intro.md:142 #, fuzzy msgid "" "**Standards-aligned** - Tools that follow current [Python packaging " -"standards](https://packaging.python.org/en/latest/) and [Scientific " -"Python community specs](https://scientific-python.org/specs/)" +"standards](https://packaging.python.org/en/latest/) and [Scientific Python " +"community specs](https://scientific-python.org/specs/)" msgstr "" "ここでは、私たちの提案を、最新の、受け入れられている " -"[Pythonコミュニティ](https://packaging.python.org/en/latest/) と " -"[科学コミュニティ](https://scientific-python.org/specs/) に合わせることも試みています。" +"[Pythonコミュニティ](https://packaging.python.org/en/latest/) と [科学コミュニティ](https" +"://scientific-python.org/specs/) に合わせることも試みています。" #: ../../package-structure-code/intro.md:144 #, fuzzy @@ -2029,38 +2506,45 @@ msgstr "複雑なビルド" #: ../../package-structure-code/intro.md:146 msgid "" -"**Pure Python packages** can use any modern tool (Hatch, PDM, Poetry, " -"Flit) - choose based on the features you want" +"**Pure Python packages** can use any modern tool (Hatch, PDM, Poetry, Flit)" +" - choose based on the features you want" msgstr "" +"**純粋な Python パッケージ** では、最新のツール (Hatch、PDM、Poetry、Flit) を使用できます - " +"必要な機能に基づいて選択してください" #: ../../package-structure-code/intro.md:147 msgid "" -"**Packages with C/C++ extensions** may need additional build steps. See " -"our [complex builds page](complex-python-package-builds) for guidance. " -"For comprehensive information on packaging compiled projects, see the " +"**Packages with C/C++ extensions** may need additional build steps. See our" +" [complex builds page](complex-python-package-builds) for guidance. For " +"comprehensive information on packaging compiled projects, see the " "[Scientific Python Development Guide on compiled packaging](https://learn" ".scientific-python.org/development/guides/packaging-compiled/)." msgstr "" +"**C/C++ 拡張機能を含むパッケージ**には、追加のビルド手順が必要な場合があります。ガイダンスについては、[複雑なビルド ページ" +"](complex-python-package-builds) " +"を参照してください。コンパイルされたプロジェクトのパッケージ化に関する包括的な情報については、[コンパイルされたパッケージ化に関する " +"Scientific Python 開発ガイド](https://learn.scientific-" +"python.org/development/guides/packaging-compiled/) を参照してください。" #: ../../package-structure-code/intro.md:149 msgid "" -"Most scientific Python packages start simple and can evolve to handle " -"more complex requirements as needed." -msgstr "" +"Most scientific Python packages start simple and can evolve to handle more " +"complex requirements as needed." +msgstr "ほとんどの科学的な Python パッケージは単純なものから始まり、必要に応じてより複雑な要件を処理できるように進化できます。" #: ../../package-structure-code/intro.md:151 msgid "Submitting your package for peer review?" -msgstr "" +msgstr "ピアレビューのためにパッケージを送信しますか?" #: ../../package-structure-code/intro.md:153 #, fuzzy msgid "" "If you're planning to submit your package to pyOpenSci for [peer " -"review](https://www.pyopensci.org/about-peer-review/index.html), check " -"out our [editor checklist](https://www.pyopensci.org/software-peer-review" -"/how-to/editor-in-chief-guide.html#editor-checklist-template) for the " -"minimum requirements. These checks are useful for anyone creating a " -"Python package, not just those submitting for review." +"review](https://www.pyopensci.org/about-peer-review/index.html), check out " +"our [editor checklist](https://www.pyopensci.org/software-peer-review/how-" +"to/editor-in-chief-guide.html#editor-checklist-template) for the minimum " +"requirements. These checks are useful for anyone creating a Python package," +" not just those submitting for review." msgstr "" "査読にパッケージを投稿しようと考えているなら、査読が始まる前にpyOpenSciが行う最低限の [editor " "checks](https://www.pyopensci.org/software-peer-review/how-to/editor-in-" @@ -2069,7 +2553,7 @@ msgstr "" #: ../../package-structure-code/intro.md:155 msgid "These are recommendations, not requirements" -msgstr "" +msgstr "これらは推奨事項であり、要件ではありません" #: ../../package-structure-code/intro.md:158 msgid "" @@ -2077,6 +2561,8 @@ msgid "" "structured package. They are **not** specific requirements for pyOpenSci " "peer review." msgstr "" +"このガイドの提案は、適切に構造化されたパッケージを作成するのに役立つように設計されています。これらは、pyOpenSci " +"ピアレビューの特定の要件ではありません**。" #: ../../package-structure-code/intro.md:160 #, fuzzy @@ -2102,9 +2588,8 @@ msgid "" "installed from a public community repository such as PyPI or a conda " "channel such as `bioconda` or `conda-forge` on Anaconda.org." msgstr "" -"pyOpenSci は、あなたのパッケージが PyPI のようなパブリックコミュニティリポジトリや Anaconda.org の " -"`bioconda` や `conda-forge` のような conda " -"チャンネルからインストールできるディストリビューションを持っていることを要求します。" +"pyOpenSci は、あなたのパッケージが PyPI のようなパブリックコミュニティリポジトリや Anaconda.org の `bioconda`" +" や `conda-forge` のような conda チャンネルからインストールできるディストリビューションを持っていることを要求します。" #: ../../package-structure-code/publish-python-package-pypi-conda.md:9 msgid "" @@ -2120,28 +2605,28 @@ msgstr "pipとcondaの両方を使って同じ環境にパッケージをイン #: ../../package-structure-code/publish-python-package-pypi-conda.md:16 msgid "" -"To minimize conflicts for users who may be using conda (or pip) to manage" -" local environments, consider publishing your package to both PyPI and " -"the conda-forge channel on Anaconda.org." +"To minimize conflicts for users who may be using conda (or pip) to manage " +"local environments, consider publishing your package to both PyPI and the " +"conda-forge channel on Anaconda.org." msgstr "" -"ローカル環境を管理するために conda (または pip) を使用しているかもしれないユーザーの競合を最小にするために、Anaconda.org" -" の PyPI と conda-forge チャンネルの両方にパッケージを公開することを検討してください。" +"ローカル環境を管理するために conda (または pip) を使用しているかもしれないユーザーの競合を最小にするために、Anaconda.org の" +" PyPI と conda-forge チャンネルの両方にパッケージを公開することを検討してください。" #: ../../package-structure-code/publish-python-package-pypi-conda.md:18 msgid "" -"Below you will learn more specifics about the differences between PyPI " -"and conda publishing of your Python package." +"Below you will learn more specifics about the differences between PyPI and " +"conda publishing of your Python package." msgstr "以下では、PythonパッケージのPyPI公開とconda公開の違いについて詳しく説明します。" #: ../../package-structure-code/publish-python-package-pypi-conda.md:23 #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:6 msgid "" -"Image showing the progression of creating a Python package, building it " -"and then publishing to PyPI and conda-forge. You take your code and turn " -"it into distribution files (sdist and wheel) that PyPI accepts. Then " -"there is an arrow towards the PyPI repository where ou publish both " -"distributions. From PyPI if you create a conda-forge recipe you can then " -"publish to conda-forge." +"Image showing the progression of creating a Python package, building it and" +" then publishing to PyPI and conda-forge. You take your code and turn it " +"into distribution files (sdist and wheel) that PyPI accepts. Then there is " +"an arrow towards the PyPI repository where ou publish both distributions. " +"From PyPI if you create a conda-forge recipe you can then publish to conda-" +"forge." msgstr "" "Pythonパッケージの作成、ビルド、そしてPyPIとconda-" "forgeへの公開の流れを示す画像です。あなたのコードをPyPIが受け付ける配布ファイル(sdistとwheel)に変換します。そして、両方のディストリビューションを公開しているPyPIリポジトリへの矢印があります" @@ -2149,11 +2634,11 @@ msgstr "" #: ../../package-structure-code/publish-python-package-pypi-conda.md:25 msgid "" -"Once you have published both package distributions (the source " -"distribution and the wheel) to PyPI, you can then publish to conda-forge." -" The conda-forge requires a source distribution on PyPI in order to build" -" your package on conda-forge. You do not need to rebuild your package to " -"publish to conda-forge." +"Once you have published both package distributions (the source distribution" +" and the wheel) to PyPI, you can then publish to conda-forge. The conda-" +"forge requires a source distribution on PyPI in order to build your package" +" on conda-forge. You do not need to rebuild your package to publish to " +"conda-forge." msgstr "" "両方のパッケージ配布(ソース配布とホイール)をPyPIに公開したら、次にconda-forgeに公開します。conda-" "forgeでパッケージをビルドするには、PyPIでのソース配布が必要です。conda-" @@ -2165,10 +2650,10 @@ msgstr "PyPIとは" #: ../../package-structure-code/publish-python-package-pypi-conda.md:31 msgid "" -"[PyPI](https://pypi.org/) is an online Python package repository that you" -" can use to both find and install and publish your Python package. There " -"is also a test PyPI repository where you can test publishing your package" -" prior to the final publication on PyPI." +"[PyPI](https://pypi.org/) is an online Python package repository that you " +"can use to both find and install and publish your Python package. There is " +"also a test PyPI repository where you can test publishing your package " +"prior to the final publication on PyPI." msgstr "" "[PyPI](https://pypi.org/) " "はオンラインのPythonパッケージリポジトリで、Pythonパッケージの検索やインストール、公開に利用できます。テスト用のPyPIリポジトリもあり、最終的にPyPIで公開する前に、パッケージの公開をテストすることができます。" @@ -2181,9 +2666,9 @@ msgstr "ほとんどのPythonパッケージはPyPIで見つけることがで #: ../../package-structure-code/publish-python-package-pypi-conda.md:38 msgid "" -"The biggest different between using pip and conda to install a package is" -" that conda can install any package regardless of the language(s) that it" -" is written in. Whereas `pip` can only install Python packages." +"The biggest different between using pip and conda to install a package is " +"that conda can install any package regardless of the language(s) that it is" +" written in. Whereas `pip` can only install Python packages." msgstr "" "パッケージのインストールにpipを使う場合とcondaを使う場合の最大の違いは、condaは(複数の)言語に関係なくどんなパッケージでもインストールできるということです。" " 一方、 `pip` は Python パッケージしかインストールできません。" @@ -2194,18 +2679,17 @@ msgstr "PyPIへのパッケージ公開のチュートリアルはこちら。" #: ../../package-structure-code/publish-python-package-pypi-conda.md:51 msgid "" -"On the package build page, we discussed the [two package distribution " -"types that you will create when making a Python package](python-package-" -"distribution-files-sdist-wheel): SDist (packaged as a .tar.gz or .zip) " -"and Wheel (.whl) which is really a zip file. Both of those file " -"\"bundles\" will be published on PyPI when you use [a standard build tool" -"](python-package-build-tools) to build your package." +"On the package build page, we discussed the [two package distribution types" +" that you will create when making a Python package](python-package-" +"distribution-files-sdist-wheel): SDist (packaged as a .tar.gz or .zip) and " +"Wheel (.whl) which is really a zip file. Both of those file \"bundles\" " +"will be published on PyPI when you use [a standard build tool](python-" +"package-build-tools) to build your package." msgstr "" "パッケージビルドのページで、 [Pythonパッケージを作るときに作成する2つのパッケージ配布タイプ](python-package-" -"distribution-files-sdist-wheel) について説明しました: SDist " -"(.tar.gzまたは.zipとしてパッケージ化) とWheel (.whl) は、実際にはzipファイルです。 [標準ビルドツール" -"](python-package-build-tools) を使ってパッケージをビルドすると、これらのファイル \"バンドル\" " -"は両方ともPyPIで公開されます。" +"distribution-files-sdist-wheel) について説明しました: SDist (.tar.gzまたは.zipとしてパッケージ化)" +" とWheel (.whl) は、実際にはzipファイルです。 [標準ビルドツール](python-package-build-tools) " +"を使ってパッケージをビルドすると、これらのファイル \"バンドル\" は両方ともPyPIで公開されます。" #: ../../package-structure-code/publish-python-package-pypi-conda.md:59 msgid "What is conda and Anaconda.org?" @@ -2213,8 +2697,8 @@ msgstr "condaとAnaconda.orgとは？" #: ../../package-structure-code/publish-python-package-pypi-conda.md:61 msgid "" -"conda is an open source package and environment management tool. conda " -"can be used to install tools from the [Anaconda " +"conda is an open source package and environment management tool. conda can " +"be used to install tools from the [Anaconda " "repository](https://repo.anaconda.com/)." msgstr "" "condaはオープンソースのパッケージと環境管理ツールです。condaは " @@ -2222,8 +2706,8 @@ msgstr "" #: ../../package-structure-code/publish-python-package-pypi-conda.md:65 msgid "" -"Anaconda.org contains public and private repositories for packages. These" -" repositories are known as channels (discussed below)." +"Anaconda.org contains public and private repositories for packages. These " +"repositories are known as channels (discussed below)." msgstr "" "Anaconda.org にはパッケージのためのパブリックとプライベートのリポジトリがあります。 " "これらのリポジトリはチャンネルとして知られています（後述）。" @@ -2234,16 +2718,16 @@ msgstr "condaの進化の簡単な歴史" #: ../../package-structure-code/publish-python-package-pypi-conda.md:71 msgid "" -"The conda ecosystem evolved years ago to provide support for, and " -"simplify the process of, managing software dependencies in scientific " -"Python projects." +"The conda ecosystem evolved years ago to provide support for, and simplify " +"the process of, managing software dependencies in scientific Python " +"projects." msgstr "condaエコシステムは、科学的なPythonプロジェクトにおけるソフトウェアの依存関係を管理するためのサポートを提供し、そのプロセスを簡素化するために数年前に発展しました。" #: ../../package-structure-code/publish-python-package-pypi-conda.md:75 msgid "" "Many of the core scientific Python projects depend upon or wrap around " -"tools and extensions that are written in other languages, such as C++. In" -" the early stages of the scientific ecosystem's development, these non-" +"tools and extensions that are written in other languages, such as C++. In " +"the early stages of the scientific ecosystem's development, these non-" "Python extensions and tools were not well supported on PyPI, making " "publication difficult. In recent years there is more support for complex " "builds that allow developers to bundle non-Python code into a Python " @@ -2255,21 +2739,21 @@ msgstr "" #: ../../package-structure-code/publish-python-package-pypi-conda.md:77 msgid "" -"Conda provides a mechanism to manage these dependencies and ensure that " -"the required packages are installed correctly." +"Conda provides a mechanism to manage these dependencies and ensure that the" +" required packages are installed correctly." msgstr "Condaは、これらの依存関係を管理し、必要なパッケージが正しくインストールされるようにするメカニズムを提供します。" #: ../../package-structure-code/publish-python-package-pypi-conda.md:81 msgid "" "While conda was originally created to support Python packages, it is now " -"used across all languages. This cross-language support makes it easier " -"for some packages to include and have access to tools written in other " -"languages, such as C/C++ (gdal), Julia, or R. Creating an environment " -"that mixes all of these packages is usually easier and more consistent " -"with full-fledged package managers like conda." -msgstr "" -"condaはもともとPythonのパッケージをサポートするために作られたが、今ではあらゆる言語で使われています。この言語間サポートにより、C/C++" -" (gdal) " +"used across all languages. This cross-language support makes it easier for " +"some packages to include and have access to tools written in other " +"languages, such as C/C++ (gdal), Julia, or R. Creating an environment that " +"mixes all of these packages is usually easier and more consistent with " +"full-fledged package managers like conda." +msgstr "" +"condaはもともとPythonのパッケージをサポートするために作られたが、今ではあらゆる言語で使われています。この言語間サポートにより、C/C++ " +"(gdal) " "、Julia、Rなど、他の言語で書かれたツールを簡単に取り込んだり、利用したりできるパッケージもあります。これらのパッケージをすべてミックスした環境を作るのは、通常、condaのような本格的なパッケージマネージャを使った方が簡単で、一貫性があります。" #: ../../package-structure-code/publish-python-package-pypi-conda.md:89 @@ -2293,8 +2777,8 @@ msgstr "多くの人がcondaを使ってパッケージをインストールす #: ../../package-structure-code/publish-python-package-pypi-conda.md:97 msgid "" -"**defaults:** this is a channel managed by Anaconda. It is the version of" -" the Python packages that you will install if you install the Anaconda " +"**defaults:** this is a channel managed by Anaconda. It is the version of " +"the Python packages that you will install if you install the Anaconda " "Distribution. Anaconda (the company) decides what packages live on the " "`defaults` channel." msgstr "" @@ -2310,8 +2794,8 @@ msgid "" "channel." msgstr "" "[**conda-forge:**](https://conda-forge.org/) " -"このチャンネルは科学的なパッケージに焦点を当てたコミュニティ主導のチャンネルです。 このチャンネルは地理空間データをサポートするツールに最適です。" -" 誰でもこのチャンネルにパッケージを公開できます。" +"このチャンネルは科学的なパッケージに焦点を当てたコミュニティ主導のチャンネルです。 このチャンネルは地理空間データをサポートするツールに最適です。 " +"誰でもこのチャンネルにパッケージを公開できます。" #: ../../package-structure-code/publish-python-package-pypi-conda.md:99 msgid "" @@ -2321,20 +2805,20 @@ msgstr "[**bioconda**](https://bioconda.github.io/): このチャンネルは生 #: ../../package-structure-code/publish-python-package-pypi-conda.md:101 msgid "" -"**conda-forge** emerged as many of the scientific packages did not exist " -"in the `defaults` Anaconda channel." +"**conda-forge** emerged as many of the scientific packages did not exist in" +" the `defaults` Anaconda channel." msgstr "科学的パッケージの多くが `defaults` Anaconda チャンネルに存在しなかったため、**conda-forge** が出現しました。" #: ../../package-structure-code/publish-python-package-pypi-conda.md:106 msgid "" -"Graphic with the title Python package repositories. Below it says " -"Anything hosted on PyPI can be installed using pip install. Packaging " -"hosted on a conda channel can be installed using conda install. Below " -"that there are two rows. The top row says conda channels. Next to it are " -"three boxes one with conda-forge, community maintained; bioconda and then" -" default - managed by the anaconda team. Below that there is a row that " -"says PyPI servers. PyPI - anyone can publish to PyPI. And test PyPI. A " -"testbed server for you to practice." +"Graphic with the title Python package repositories. Below it says Anything " +"hosted on PyPI can be installed using pip install. Packaging hosted on a " +"conda channel can be installed using conda install. Below that there are " +"two rows. The top row says conda channels. Next to it are three boxes one " +"with conda-forge, community maintained; bioconda and then default - managed" +" by the anaconda team. Below that there is a row that says PyPI servers. " +"PyPI - anyone can publish to PyPI. And test PyPI. A testbed server for you " +"to practice." msgstr "" "Python package repositoriesというタイトルのグラフィック。 PyPI でホストされているものは pip install " "でインストールできます。 condaチャンネルでホストされているパッケージはconda installを使ってインストールできます。 " @@ -2345,11 +2829,11 @@ msgstr "" #: ../../package-structure-code/publish-python-package-pypi-conda.md:108 msgid "" -"Conda channels represent various repositories that you can install " -"packages from. Because conda-forge is community maintained, anyone can " -"submit a recipe there. PyPI is also a community maintained repository. " -"Anyone can submit a package to PyPI and test PyPI. Unlike conda-forge " -"there are no manual checks of packages submitted to PyPI." +"Conda channels represent various repositories that you can install packages" +" from. Because conda-forge is community maintained, anyone can submit a " +"recipe there. PyPI is also a community maintained repository. Anyone can " +"submit a package to PyPI and test PyPI. Unlike conda-forge there are no " +"manual checks of packages submitted to PyPI." msgstr "" "Condaチャンネルは、パッケージをインストールできる様々なリポジトリです。 conda-forge " "はコミュニティによって管理されているため、誰でもレシピを投稿することができます。 PyPIもコミュニティによって管理されているリポジトリです。 " @@ -2379,20 +2863,20 @@ msgstr "どちらの質問に対する答えも、依存関係のコンフリク #: ../../package-structure-code/publish-python-package-pypi-conda.md:123 msgid "" "Image showing an XKCD comic that shows a web of Python environments and " -"tools and installations. At the bottom is says - My python environment " -"has become so degraded that my laptop has been declared a superfund site." +"tools and installations. At the bottom is says - My python environment has" +" become so degraded that my laptop has been declared a superfund site." msgstr "" "画像はXKCDのコミックで、Pythonの環境とツール、インストールの網を描いています。一番下にはこう書いてあります - " "私のパイソン環境は劣化しすぎて、私のラップトップはスーパーファンドサイトに指定された。" #: ../../package-structure-code/publish-python-package-pypi-conda.md:125 msgid "" -"Installing Python and Python packages from different repositories can " -"lead to environment conflicts where a version of on package doesn't work " -"with a version of another package. To keep your environments clean and " -"working, it's best to install packages from the same repository. So use " -"pip to install everything. Or use conda. If you can, try to avoid " -"installing package from both pip and conda into the same environment." +"Installing Python and Python packages from different repositories can lead " +"to environment conflicts where a version of on package doesn't work with a " +"version of another package. To keep your environments clean and working, " +"it's best to install packages from the same repository. So use pip to " +"install everything. Or use conda. If you can, try to avoid installing " +"package from both pip and conda into the same environment." msgstr "" "Python と Python " "パッケージを異なるリポジトリからインストールすると、あるバージョンのパッケージが別のパッケージのバージョンと動作しないといった環境の衝突につながる可能性があります。" @@ -2408,10 +2892,10 @@ msgstr "Pythonパッケージの依存関係の競合を管理する" msgid "" "Python environments can encounter conflicts because Python tools can be " "installed from different repositories. Broadly speaking, Python " -"environments have a smaller chance of dependency conflicts when the tools" -" are installed from the same package repository. Thus environments that " -"contain packages installed from both pip and conda are more likely to " -"yield dependency conflicts." +"environments have a smaller chance of dependency conflicts when the tools " +"are installed from the same package repository. Thus environments that " +"contain packages installed from both pip and conda are more likely to yield" +" dependency conflicts." msgstr "" "Python環境は、Pythonツールが異なるリポジトリからインストールされることがあるため、競合に遭遇する可能性があります。 " "大まかに言えば、Python環境は、ツールが同じパッケージリポジトリからインストールされるとき、依存関係の衝突の可能性が小さくなります。 " @@ -2419,8 +2903,8 @@ msgstr "" #: ../../package-structure-code/publish-python-package-pypi-conda.md:142 msgid "" -"Similarly installing packages from the default anaconda channel mixed " -"with the conda-forge channel can also lead to dependency conflicts." +"Similarly installing packages from the default anaconda channel mixed with " +"the conda-forge channel can also lead to dependency conflicts." msgstr "" "同様に、デフォルトの anaconda チャンネルと conda-forge " "チャンネルを混ぜてパッケージをインストールすることも依存関係の衝突につながります。" @@ -2428,12 +2912,12 @@ msgstr "" #: ../../package-structure-code/publish-python-package-pypi-conda.md:144 msgid "" "Many install packages directly from conda `defaults` channel. However, " -"because this channel is managed by Anaconda, the packages available on it" -" are limited to those that Anaconda decides should be core to a stable " +"because this channel is managed by Anaconda, the packages available on it " +"are limited to those that Anaconda decides should be core to a stable " "installation. The conda-forge channel was created to complement the " -"`defaults` channel. It allows anyone to submit a package to be published " -"in the channel . Thus, `conda-forge` channel ensures that a broad suite " -"of user-developed community packages can be installed from conda." +"`defaults` channel. It allows anyone to submit a package to be published in" +" the channel . Thus, `conda-forge` channel ensures that a broad suite of " +"user-developed community packages can be installed from conda." msgstr "" "多くのパッケージは conda `defaults` チャンネルから直接インストールします。 しかし、このチャンネルは Anaconda " "によって管理されているため、このチャンネルで利用可能なパッケージは、Anaconda " @@ -2443,16 +2927,16 @@ msgstr "" #: ../../package-structure-code/publish-python-package-pypi-conda.md:148 msgid "" -"Take-aways: If you can, publish on both PyPI and conda-forge to " -"accommodate more users of your package" +"Take-aways: If you can, publish on both PyPI and conda-forge to accommodate" +" more users of your package" msgstr "教訓: 可能であれば、PyPI と conda-forge の両方で公開し、より多くのユーザがあなたのパッケージを利用できるようにしましょう。" #: ../../package-structure-code/publish-python-package-pypi-conda.md:150 msgid "" -"The take-away here for maintainers is that if you anticipate users " -"wanting to use conda to manage their local environments (which many do), " -"you should consider publishing to both PyPI and the conda-forge channel " -"(_more on that below_)." +"The take-away here for maintainers is that if you anticipate users wanting " +"to use conda to manage their local environments (which many do), you should" +" consider publishing to both PyPI and the conda-forge channel (_more on " +"that below_)." msgstr "" "メンテナにとって重要なことは、もしユーザがローカル環境の管理にcondaを使いたいと考えているのであれば（多くのユーザがそうしている" "）、PyPIとconda-forge channelの両方に公開することを検討すべきだということです (_詳しくは後述します) 。" @@ -2483,8 +2967,8 @@ msgstr "conda-forgeへの投稿方法" #: ../../package-structure-code/publish-python-package-pypi-conda.md:167 msgid "" -"While pyOpenSci doesn't require you to add your package to conda-forge, " -"we encourage you to consider doing so!" +"While pyOpenSci doesn't require you to add your package to conda-forge, we " +"encourage you to consider doing so!" msgstr "pyOpenSciはあなたのパッケージをconda-forgeに追加する必要はありませんが、追加することを検討することを推奨します！" #: ../../package-structure-code/publish-python-package-pypi-conda.md:170 @@ -2508,8 +2992,8 @@ msgstr "ステップバイステップのチュートリアルをご覧になり #: ../../package-structure-code/publish-python-package-pypi-conda.md:183 msgid "" -"Once your package is added, you will have a feedstock repository on " -"GitHub with your packages name" +"Once your package is added, you will have a feedstock repository on GitHub " +"with your packages name" msgstr "パッケージが追加されると、GitHub の feedstock リポジトリにパッケージ名が追加されます。" #: ../../package-structure-code/publish-python-package-pypi-conda.md:186 @@ -2527,23 +3011,22 @@ msgstr "conda-forge パッケージリポジトリの管理" #: ../../package-structure-code/publish-python-package-pypi-conda.md:191 msgid "" -"Once your package is on the conda-forge channel, maintaining it is " -"simple. Every time that you push a new version of your package to PyPI, " -"it will kick off a continuous integration build that updates your package" -" in the conda-forge repository. Once that build is complete, you will get" -" a notification to review the update." +"Once your package is on the conda-forge channel, maintaining it is simple. " +"Every time that you push a new version of your package to PyPI, it will " +"kick off a continuous integration build that updates your package in the " +"conda-forge repository. Once that build is complete, you will get a " +"notification to review the update." msgstr "" -"いったんあなたのパッケージが conda-forge チャンネルに登録されれば、それを維持するのは簡単です。 新しいバージョンのパッケージを " -"PyPI にプッシュするたびに、conda-forge リポジトリのパッケージを更新する継続的インテグレーションビルドが開始されます。 " +"いったんあなたのパッケージが conda-forge チャンネルに登録されれば、それを維持するのは簡単です。 新しいバージョンのパッケージを PyPI" +" にプッシュするたびに、conda-forge リポジトリのパッケージを更新する継続的インテグレーションビルドが開始されます。 " "ビルドが完了すると、更新を確認するための通知が届きます。" #: ../../package-structure-code/publish-python-package-pypi-conda.md:197 msgid "" -"You can merge the pull request for that update once you are happy with " -"it. A ready-to-merge PR usually means ensuring that your project's " -"dependencies (known as runtime requirements) listed in the updated YAML " -"file found in the pull request match the PyPI metadata of the new " -"release." +"You can merge the pull request for that update once you are happy with it. " +"A ready-to-merge PR usually means ensuring that your project's dependencies" +" (known as runtime requirements) listed in the updated YAML file found in " +"the pull request match the PyPI metadata of the new release." msgstr "" "プルリクエストの内容に満足したら、プルリクエストをマージすることができます。 " "すぐにマージできるPRとは、通常、プルリクエストにある更新されたYAMLファイルに記載されているあなたのプロジェクトの依存関係（実行時要件として知られています）が、新しいリリースのPyPIメタデータと一致していることを確認することです。" @@ -2563,14 +3046,14 @@ msgid "" "package: **[build-system]** and **[project]**. The **[project]** table " "stores your package's metadata." msgstr "" -"インストール可能なPythonパッケージに必要なテーブルは2つだけです: **[build-system]** と **[project]** " -"です。 **[project]** テーブルにはパッケージのメタデータが格納されます。" +"インストール可能なPythonパッケージに必要なテーブルは2つだけです: **[build-system]** と **[project]** です。" +" **[project]** テーブルにはパッケージのメタデータが格納されます。" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:7 #, fuzzy msgid "" -"There are two _required_ fields in the **[project]** table: **name=** and" -" **version=**." +"There are two _required_ fields in the **[project]** table: **name=** and " +"**version=**." msgstr "**[project]** テーブルの必須フィールドは2つだけです: **name=**と **version=** です。" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:8 @@ -2594,14 +3077,14 @@ msgstr "" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:10 msgid "" -"There is no specific order for tables in the `pyproject.toml` file. " -"However fields need to be placed within the correct table sections. For " -"example `requires =` always need to be associated with the **[build-" -"system]** table." +"There is no specific order for tables in the `pyproject.toml` file. However" +" fields need to be placed within the correct table sections. For example " +"`requires =` always need to be associated with the **[build-system]** " +"table." msgstr "" "`pyproject.toml` ファイル内のテーブルには特定の順番はありません。 " -"しかし、フィールドは正しいテーブルセクションに配置する必要があります。 例えば `requires =` は常に **[build-" -"system]** テーブルと関連付ける必要があります。" +"しかし、フィールドは正しいテーブルセクションに配置する必要があります。 例えば `requires =` は常に **[build-system]**" +" テーブルと関連付ける必要があります。" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:16 msgid "when these are published, remove this todo" @@ -2609,14 +3092,12 @@ msgstr "これらが公開されたら、このtodoを削除します" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:25 msgid "" -"Need help creating your pyproject.toml file? This tutorial will walk you" -" through the process." +"Need help creating your pyproject.toml file? This tutorial will walk you " +"through the process." msgstr "pyproject.tomlファイルの作成にヘルプが必要ですか？ このチュートリアルはそのプロセスを説明します。" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:39 -msgid "" -"Click here if need help migrating from setup.py/setup.cfg to " -"pyproject.toml" +msgid "Click here if need help migrating from setup.py/setup.cfg to pyproject.toml" msgstr "setup.py/setup.cfg から pyproject.toml への移行にヘルプが必要な場合はここをクリックしてください。" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:50 @@ -2627,19 +3108,19 @@ msgstr "pyproject.tomlファイルについて" #, fuzzy msgid "" "Every modern Python package should include a `pyproject.toml` file. For " -"pure Python packages, this file replaces the `setup.py` and/or " -"`setup.cfg` file to describe project metadata." +"pure Python packages, this file replaces the `setup.py` and/or `setup.cfg` " +"file to describe project metadata." msgstr "" "最近の Python パッケージには `pyproject.toml` ファイルが含まれているはずです。 もしあなたのプロジェクトが純粋な " -"Python で、メタデータを記述するために `setup.py` や `setup.cfg` ファイルを使っているなら、メタデータとビルド情報を" -" `pyproject.toml` ファイルに移行することを検討するべきです。" +"Python で、メタデータを記述するために `setup.py` や `setup.cfg` ファイルを使っているなら、メタデータとビルド情報を " +"`pyproject.toml` ファイルに移行することを検討するべきです。" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:54 #, fuzzy msgid "" "If your project isn’t pure Python, you might still require a `setup.py` " -"file to build the non-Python extensions. However, a `pyproject.toml` file" -" should still be used to store your project’s metadata." +"file to build the non-Python extensions. However, a `pyproject.toml` file " +"should still be used to store your project’s metadata." msgstr "" "あなたのプロジェクトが純粋な Python でない場合、Python 以外の拡張機能をビルドするために `setup.py` " "ファイルが必要になるかもしれません。 しかし、プロジェクトのメタデータを保存するために `pyproject.toml` " @@ -2647,7 +3128,7 @@ msgstr "" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:56 msgid "Tutorial" -msgstr "" +msgstr "チュートリアル" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:59 msgid "" @@ -2657,6 +3138,10 @@ msgid "" "**pyproject.toml**](https://packaging.python.org/en/latest/specifications" "/declaring-project-metadata/)" msgstr "" +"**setup.py** または **setup.cfg** ファイルから移行しており、サポートが必要な場合は、[このチュートリアルを確認してください" +"。](merge-pyproj) [ビルド要件を指定し、メタデータは **pyproject.toml** " +"と呼ばれます](https://packaging.python.org/en/latest/specations/declaring-" +"project-metadata/)" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:64 msgid "About the .toml format" @@ -2666,15 +3151,15 @@ msgstr ".toml フォーマットについて" #, fuzzy msgid "" "The **pyproject.toml** file is written in [TOML (Tom's Obvious, Minimal " -"Language) format](https://toml.io/en/). TOML is an easy-to-read structure" -" based on key/value pairs. Each section in the **pyproject.toml** file " -"contains a `[table identifier]`. Below that table identifier are " -"key/value pairs that support configuration for that particular table." +"Language) format](https://toml.io/en/). TOML is an easy-to-read structure " +"based on key/value pairs. Each section in the **pyproject.toml** file " +"contains a `[table identifier]`. Below that table identifier are key/value " +"pairs that support configuration for that particular table." msgstr "" "**pyproject.toml**ファイルは [TOML(Tom's Obvious, Minimal " "Language)フォーマット](https://toml.io/en/) で書かれています。 " -"TOMLは読みやすい構造で、キーと値のペアで成り立っています。 **pyproject.toml** ファイルの各セクションは " -"`[テーブル識別子]` を含んでいます。 そのテーブル識別子の下には、その特定のテーブルの設定をサポートするキーと値のペアがあります。" +"TOMLは読みやすい構造で、キーと値のペアで成り立っています。 **pyproject.toml** ファイルの各セクションは `[テーブル識別子]`" +" を含んでいます。 そのテーブル識別子の下には、その特定のテーブルの設定をサポートするキーと値のペアがあります。" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:70 msgid "Below `[build-system]` is considered a table in the toml language." @@ -2698,16 +3183,16 @@ msgstr "パッケージのビルド時にpyproject.tomlがどのように使用 #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:84 msgid "" "When you publish to PyPI, you will notice that each package has metadata " -"listed. Let’s have a look at [xclim](https://pypi.org/project/xclim/), " -"one of our [pyOpenSci packages](https://www.pyopensci.org/python-" -"packages.html). Notice that on the PyPI landing page you see some " -"metadata about the package including python, maintainer information and " -"more. PyPI is able to populate this metadata because it was defined using" -" correct syntax and classifiers by Xclim's maintainers, [pyproject.toml " -"file](https://github.com/Ouranosinc/xclim/blob/master/pyproject.toml). " -"This metadata when the xclim package is built, is translated into a " -"distribution file that allows PyPI to read the metadata and print it out " -"on their website." +"listed. Let’s have a look at [xclim](https://pypi.org/project/xclim/), one " +"of our [pyOpenSci packages](https://www.pyopensci.org/python-" +"packages.html). Notice that on the PyPI landing page you see some metadata " +"about the package including python, maintainer information and more. PyPI " +"is able to populate this metadata because it was defined using correct " +"syntax and classifiers by Xclim's maintainers, [pyproject.toml " +"file](https://github.com/Ouranosinc/xclim/blob/master/pyproject.toml). This" +" metadata when the xclim package is built, is translated into a " +"distribution file that allows PyPI to read the metadata and print it out on" +" their website." msgstr "" "PyPIに公開すると、各パッケージにメタデータがリストされていることに気づくでしょう。[pyOpenSciパッケージ](https://www.pyopensci.org" "/python-packages.html) の一つである [xclim](https://pypi.org/project/xclim/) " @@ -2719,11 +3204,11 @@ msgstr "" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:86 #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:82 msgid "" -"Image showing the left side bar of PyPI for the package xclim. The " -"section at the top says Classifier. Below there is a list of items " -"including Development status, intended audience, License, natural " -"language, operating system, programming language and topic. Below each of" -" those sections are various classifier options.\" width=\"300px\">" +"Image showing the left side bar of PyPI for the package xclim. The section " +"at the top says Classifier. Below there is a list of items including " +"Development status, intended audience, License, natural language, operating" +" system, programming language and topic. Below each of those sections are " +"various classifier options.\" width=\"300px\">" msgstr "" "xclimパッケージのPyPI左サイドバーの画像です。一番上のセクションにはClassifierとあります。その下に、開発状況、対象読者、ライセンス、自然言語、オペレーティングシステム、プログラミング言語、トピックなどの項目があります。" " これらの各セクションの下には、さまざまな分類オプションがあります。 \" width=\"300px\">" @@ -2731,11 +3216,11 @@ msgstr "" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:91 #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:87 msgid "" -"When you add the classifier section to your pyproject.toml and your " -"package is built, the build tool organizes the metadata into a format " -"that PyPI can understand and represent on your PyPI landing page. These " -"classifiers also allow users to sort through packages by version of " -"python they support, categories and more." +"When you add the classifier section to your pyproject.toml and your package" +" is built, the build tool organizes the metadata into a format that PyPI " +"can understand and represent on your PyPI landing page. These classifiers " +"also allow users to sort through packages by version of python they " +"support, categories and more." msgstr "" "pyproject.tomlにclassifierセクションを追加してパッケージがビルドされると、ビルドツールはメタデータをPyPIが理解できる形式に整理し、PyPIのランディングページに表示します。" " これらの分類子により、ユーザはサポートするpythonのバージョンやカテゴリなどでパッケージをソートすることもできます。" @@ -2760,16 +3245,15 @@ msgstr "Setup.py は、複雑なパッケージのビルドに便利です。" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:105 msgid "" "Using **setup.py** to manage package builds and metadata [can cause " -"problems with package " -"development](https://blog.ganssle.io/articles/2021/10/setup-py-" -"deprecated.html). In some cases where a Python package build is complex, " -"a **setup.py** file may be required. While this guide will not cover " -"complex builds, we will provide resources working with complex builds in " -"the future." +"problems with package development](https://blog.ganssle.io/articles/2021/10" +"/setup-py-deprecated.html). In some cases where a Python package build is " +"complex, a **setup.py** file may be required. While this guide will not " +"cover complex builds, we will provide resources working with complex builds" +" in the future." msgstr "" "パッケージのビルドとメタデータを管理するために **setup.py** を使うことは " -"[パッケージ開発に問題を引き起こす可能性があります](https://blog.ganssle.io/articles/2021/10" -"/setup-py-deprecated.html) 。 Python パッケージのビルドが複雑な場合、**setup.py** " +"[パッケージ開発に問題を引き起こす可能性があります](https://blog.ganssle.io/articles/2021/10/setup-" +"py-deprecated.html) 。 Python パッケージのビルドが複雑な場合、**setup.py** " "ファイルが必要になるかもしれません。 このガイドでは複雑なビルドは扱いませんが、将来的には複雑なビルドを扱うリソースを提供する予定です。" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:111 @@ -2789,8 +3273,8 @@ msgstr "" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:115 msgid "" "[An overview of all of the project metadata elements can be found " -"here.](https://packaging.python.org/en/latest/specifications/core-" -"metadata/#project-url-multiple-use)" +"here.](https://packaging.python.org/en/latest/specifications/core-metadata" +"/#project-url-multiple-use)" msgstr "" "[プロジェクトの全メタデータ要素の概要は、こちらをご覧ください。](https://packaging.python.org/en/latest/specifications" "/core-metadata/#project-url-multiple-use)" @@ -2801,11 +3285,11 @@ msgstr "`[project]` テーブルの必須フィールド" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:119 msgid "" -"As mentioned above, your `pyproject.toml` file needs to have a **`name`**" -" and **`version`** field in order to properly build your package:" +"As mentioned above, your `pyproject.toml` file needs to have a **`name`** " +"and **`version`** field in order to properly build your package:" msgstr "" -"上述したように、 `pyproject.toml` ファイルはパッケージを適切にビルドするために **`name`** と " -"**`version`** フィールドを持つ必要があります:" +"上述したように、 `pyproject.toml` ファイルはパッケージを適切にビルドするために **`name`** と **`version`**" +" フィールドを持つ必要があります:" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:121 msgid "`name`: This is the name of your project provided as a string" @@ -2813,9 +3297,9 @@ msgstr "`name`: プロジェクトの名前を文字列で指定します。" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:122 msgid "" -"`version`: This is the version of your project. If you are using a SCM " -"tool for versioning (using git tags to determine versions), then the " -"version may be dynamic (more on that below)." +"`version`: This is the version of your project. If you are using a SCM tool" +" for versioning (using git tags to determine versions), then the version " +"may be dynamic (more on that below)." msgstr "" "`version`: プロジェクトのバージョンです。 バージョン管理に SCM ツール (git タグを使用してバージョンを決定する) " "を使用している場合は、このバージョンは動的なものになります (詳細は後述します)。" @@ -2826,10 +3310,10 @@ msgstr "`[project]` テーブルに含めるオプションフィールド" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:126 msgid "" -"We strongly suggest that you also add the metadata keys below as they " -"will help users finding your package on PyPI. These fields will make it " -"clear how your package is structured, what platforms you support and what" -" dependencies your package requires." +"We strongly suggest that you also add the metadata keys below as they will " +"help users finding your package on PyPI. These fields will make it clear " +"how your package is structured, what platforms you support and what " +"dependencies your package requires." msgstr "" "以下のメタデータキーも追加することを強くお勧めします。 " "これらのフィールドを追加することで、あなたのパッケージがどのような構造になっているのか、どのプラットフォームをサポートしているのか、どのような依存関係が必要なのかを明確にすることができます。" @@ -2850,8 +3334,8 @@ msgstr "" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:133 msgid "" "**Requires-python** (used by pip): this is a field that is used by pip. " -"Here you tell the installer whether you are using Python 2.x or 3.x. Most" -" projects will be using 3.x." +"Here you tell the installer whether you are using Python 2.x or 3.x. Most " +"projects will be using 3.x." msgstr "" "**Requires-python** (pipで使用): これはpipが使用するフィールドです。 ここでは、Python " "2.xと3.xのどちらを使っているかをインストーラに伝えます。 ほとんどのプロジェクトは3.xを使うでしょう。" @@ -2862,37 +3346,41 @@ msgstr "**ライセンス:** 使用しているライセンス" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:135 msgid "" -"**Authors:** these are the original authors of the package. Sometimes the" -" authors are different from the maintainers. Other times they might be " -"the same." +"**Authors:** these are the original authors of the package. Sometimes the " +"authors are different from the maintainers. Other times they might be the " +"same." msgstr "**Authors:** パッケージの原作者です。 作者がメンテナと異なることもあります。 また、同じ場合もあります。" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:136 msgid "" -"**Maintainers:** you can choose to populate this or not. You can populate" -" this using a list with a sub element for each author or maintainer name," -" email" +"**Maintainers:** you can choose to populate this or not. You can populate " +"this using a list with a sub element for each author or maintainer name, " +"email" msgstr "" "**Maintainers:** これを入力するかどうかを選択できます。 " "各作者やメンテナーの名前、Eメール、メールアドレスなどのサブ要素を持つリストを使って、この情報を入力することができます。" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:144 msgid "" -"**project.dependencies:** The dependency group is optional because not " -"all packages require dependencies. However, if your project has specific " -"dependencies, include this section in your `pyproject.toml`. Dependencies" -" declared in the pyproject.toml file will be installed by uv or pip when " +"**project.dependencies:** The dependency group is optional because not all " +"packages require dependencies. However, if your project has specific " +"dependencies, include this section in your `pyproject.toml`. Dependencies " +"declared in the pyproject.toml file will be installed by uv or pip when " "your project is installed." msgstr "" +"**project.dependency:** " +"すべてのパッケージが依存関係を必要とするわけではないため、依存関係グループはオプションです。ただし、プロジェクトに特定の依存関係がある場合は、このセクションを" +" `pyproject.toml` に含めてください。 pyproject.toml ファイルで宣言された依存関係は、プロジェクトのインストール時に " +"uv または pip によってインストールされます。" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:146 #, fuzzy msgid "" -"**project.optional-dependencies:** Optional or feature dependencies will " -"be installed if someone runs `python -m pip install " -"projectname[feature]`. Use this array to declare dependencies that add " -"specific features to your package that are not installed by default when " -"a user runs `uv sync` or `python -m pip install packagename`." +"**project.optional-dependencies:** Optional or feature dependencies will be" +" installed if someone runs `python -m pip install projectname[feature]`. " +"Use this array to declare dependencies that add specific features to your " +"package that are not installed by default when a user runs `uv sync` or " +"`python -m pip install packagename`." msgstr "" "**`[project.optional-dependencies]`:** 誰かが `python -m pip install " "projectname[dev]` を実行したときに、オプションまたは開発用の依存パッケージがインストールされます。 " @@ -2900,22 +3388,27 @@ msgstr "" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:147 msgid "" -"**dependency-groups:** Dependency groups organize packages and tools that" -" a contributor or developer would need to work on your package. These " -"dependencies may include tools for building and running tests, linters, " -"and code formatters. This is an optional but highly suggested way to " -"organize and install dependencies. This section can replace a " -"requirements.txt file. [Learn more about adding these to your package in " -"the PyPA guide " +"**dependency-groups:** Dependency groups organize packages and tools that a" +" contributor or developer would need to work on your package. These " +"dependencies may include tools for building and running tests, linters, and" +" code formatters. This is an optional but highly suggested way to organize " +"and install dependencies. This section can replace a requirements.txt file." +" [Learn more about adding these to your package in the PyPA guide " "here.](https://packaging.python.org/en/latest/specifications/dependency-" "groups/)" msgstr "" +"**dependency-groups:** " +"依存関係グループは、寄稿者または開発者がパッケージで作業する必要があるパッケージとツールを整理します。これらの依存関係には、テスト、リンター、コード " +"フォーマッタを構築および実行するためのツールが含まれる場合があります。これはオプションですが、依存関係を整理してインストールするために強く推奨される方法です。このセクションは、requirements.txt" +" ファイルを置き換えることができます。 [これらをパッケージに追加する方法については、こちらの PyPA " +"ガイドをご覧ください。](https://packaging.python.org/en/latest/specations/dependency-" +"groups/)" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:148 msgid "" -"**keywords:** These are the keywords that will appear on your PyPI " -"landing page. Think of them as words that people might use to search for " -"your package." +"**keywords:** These are the keywords that will appear on your PyPI landing " +"page. Think of them as words that people might use to search for your " +"package." msgstr "" "**keywords:** これらはPyPIのランディングページに表示されるキーワードです。 " "人々があなたのパッケージを検索するときに使う言葉だと考えてください。" @@ -2923,15 +3416,15 @@ msgstr "" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:149 #, fuzzy msgid "" -"**classifiers:** The classifiers section of your metadata is also " -"important for the landing page of your package in PyPI and for filtering " -"of packages in PyPI. A list of [all options for classifiers can be found " +"**classifiers:** The classifiers section of your metadata is also important" +" for the landing page of your package in PyPI and for filtering of packages" +" in PyPI. A list of [all options for classifiers can be found " "here](https://PyPI.org/classifiers/). Some of the classifiers that you " "should consider including" msgstr "" "**classifiers:** " -"メタデータのclassifiersセクションは、PyPIでのパッケージのランディングページや、PyPIでのパッケージのフィルタリングにも重要です。" -" [分類子の全オプションはこちらです](https://PyPI.org/classifiers/) 。 " +"メタデータのclassifiersセクションは、PyPIでのパッケージのランディングページや、PyPIでのパッケージのフィルタリングにも重要です。 " +"[分類子の全オプションはこちらです](https://PyPI.org/classifiers/) 。 " "以下のようなクラシファイアを検討する必要があります。" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:150 @@ -2956,10 +3449,10 @@ msgstr "pyproject.tomlファイルの高度なオプション" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:157 msgid "" -"**`[project.scripts]` (Entry points):** Entry points are optional. If you" -" have a command line tool that runs a specific script hosted in your " -"package, you may include an entry point to call that script directly at " -"the command line (rather than at the Python shell)." +"**`[project.scripts]` (Entry points):** Entry points are optional. If you " +"have a command line tool that runs a specific script hosted in your " +"package, you may include an entry point to call that script directly at the" +" command line (rather than at the Python shell)." msgstr "" "**`[project.scripts]` (Entry points):** エントリーポイントは任意です。 " "パッケージでホストされている特定のスクリプトを実行するコマンドラインツールがある場合、そのスクリプトを(Pythonシェルではなく)コマンドラインで直接呼び出すためのエントリポイントを含めることができます" @@ -2980,10 +3473,10 @@ msgstr "" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:160 #, fuzzy msgid "" -"Use **Dynamic Fields** If you have fields that are dynamically populated." -" For example, you may wish to automatically update your package's version" -" using Git tags (SCM/version control-based versioning). Example: " -"**dynamic = [\"version\"]**" +"Use **Dynamic Fields** If you have fields that are dynamically populated. " +"For example, you may wish to automatically update your package's version " +"using Git tags (SCM/version control-based versioning). Example: **dynamic " +"= [\"version\"]**" msgstr "" "**ダイナミックフィールド:** 動的に入力されるフィールドがある場合。 " "`setuptooms_scm`のようなツールでscm/バージョン管理ベースのバージョンを使用している場合、ダイナミックフィールドを使用することができます。" @@ -2999,15 +3492,15 @@ msgstr "pyproject.tomlファイルに依存関係を追加" msgid "" "The `pyproject.toml` file is a modern replacement for the " "`requirements.txt` file, which has been traditionally used to store " -"development dependencies and also configuration for tools such as pytest," -" black, and others." +"development dependencies and also configuration for tools such as pytest, " +"black, and others." msgstr "pyproject.tomlファイルは、従来pytestのような開発依存ファイル、Blackのようなコードフォーマッタ、sphinxのようなドキュメントツールを保存するために使われてきたrequirements.txtファイルの代わりとして使うこともできます。" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:166 #, fuzzy msgid "" -"To add development dependencies to your build, add a `[dependency-" -"groups]` array to your pyproject.toml file." +"To add development dependencies to your build, add a `[dependency-groups]` " +"array to your pyproject.toml file." msgstr "" "ビルドに依存関係を追加するには、 `[project.optional-dependencies]` " "テーブルをpyproject.tomlファイルに追加します。" @@ -3026,7 +3519,7 @@ msgstr "`python -m pip install -e .[tests]`" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:180 msgid "pip install --group test _# requires pip 25.1 or greater_" -msgstr "" +msgstr "pip install --group test _# には pip 25.1 以降が必要です_" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:182 msgid "" @@ -3051,9 +3544,8 @@ msgstr "再帰的依存関係" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:192 msgid "" -"You can also setup sets of recursive dependencies. [See this blog post " -"for more.](https://hynek.me/articles/python-recursive-optional-" -"dependencies/)" +"You can also setup sets of recursive dependencies. [See this blog post for " +"more.](https://hynek.me/articles/python-recursive-optional-dependencies/)" msgstr "" "再帰的依存関係のセットをセットアップすることもできます。 [詳しくはこのブログ記事を参照。](https://hynek.me/articles" "/python-recursive-optional-dependencies/)" @@ -3064,13 +3556,12 @@ msgstr "hatchlingを使用してビルドするpyproject.tomlの例" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:197 msgid "" -"Below is an example build configuration for a Python project. This " -"example package setup uses **hatchling** to build the [package's sdist " -"and wheels](python-package-distribution-files-sdist-wheel)." +"Below is an example build configuration for a Python project. This example " +"package setup uses **hatchling** to build the [package's sdist and wheels" +"](python-package-distribution-files-sdist-wheel)." msgstr "" -"以下は Python プロジェクトのビルド設定の例です。 このパッケージの設定例では、 [パッケージの sdist と wheel" -"](python-package-distribution-files-sdist-wheel) をビルドするのに **hatchling** " -"を使っています。" +"以下は Python プロジェクトのビルド設定の例です。 このパッケージの設定例では、 [パッケージの sdist と wheel](python-" +"package-distribution-files-sdist-wheel) をビルドするのに **hatchling** を使っています。" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:205 msgid "Notice that dependencies are specified in this file." @@ -3082,10 +3573,10 @@ msgstr "setuptoolsを使ってビルドするpyproject.tomlの例" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:209 msgid "" -"The package metadata including authors, keywords, etc is also easy to " -"read. Below you can see the same TOML file that uses a different build " -"system (setuptools). Notice how simple it is to swap out the tools needed" -" to build this package!" +"The package metadata including authors, keywords, etc is also easy to read." +" Below you can see the same TOML file that uses a different build system " +"(setuptools). Notice how simple it is to swap out the tools needed to build" +" this package!" msgstr "" "作者やキーワードなどを含むパッケージのメタデータも読みやすいです。 " "下の図は、異なるビルドシステム(setuptools)を使った同じTOMLファイルです。 " @@ -3105,14 +3596,14 @@ msgstr "" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:216 msgid "" -"**setuptools_scm** to manage package version updates using version " -"control tags" +"**setuptools_scm** to manage package version updates using version control " +"tags" msgstr "**setuptools_scm** は、バージョン管理タグを使ってパッケージのバージョン更新を管理します。" #: ../../package-structure-code/pyproject-toml-python-package-metadata.md:218 msgid "" -"In the example below `[build-system]` is the first table of values. It " -"has two keys that specify the build backend API and containing package:" +"In the example below `[build-system]` is the first table of values. It has " +"two keys that specify the build backend API and containing package:" msgstr "" "以下の例では、`[build-system]` が最初の値のテーブルです。 " "このテーブルには2つのキーがあり、ビルドバックエンドAPIとそれを含むパッケージを指定します:" @@ -3144,13 +3635,12 @@ msgstr "パッケージ構築のためのツール" #: ../../package-structure-code/python-package-build-tools.md:6 msgid "" -"There are a several different build tools that you can use to [create " -"your Python package's _sdist_ and _wheel_ distributions](python-package-" -"distribution-files-sdist-wheel). Below, we discuss the features, benefits" -" and limitations of the most commonly used Python packaging tools. We " -"focus on pure-python packages in this guide. However, we also highlight " -"tools that currently support packages with C/C++ and other language " -"extensions." +"There are a several different build tools that you can use to [create your " +"Python package's _sdist_ and _wheel_ distributions](python-package-" +"distribution-files-sdist-wheel). Below, we discuss the features, benefits " +"and limitations of the most commonly used Python packaging tools. We focus " +"on pure-python packages in this guide. However, we also highlight tools " +"that currently support packages with C/C++ and other language extensions." msgstr "" "[Python パッケージの _sdist_ ディストリビューションと _wheel_ ディストリビューションを作成する](python-" "package-distribution-files-sdist-wheel) ために使えるビルドツールはいくつかあります。 " @@ -3161,10 +3651,10 @@ msgstr "" msgid "" "Decision tree diagram showing the various front and back end packaging " "tools. You can decide what packaging tool to use by thinking about what " -"features you need. PDM and Hatch are currently the most flexible tools " -"as they also using different build back-ends. As such currently PDM and " -"Hatch are the tools we think beginners might appreciate most with Poetry " -"being a close second. Poetry is nice for pure Python projects." +"features you need. PDM and Hatch are currently the most flexible tools as " +"they also using different build back-ends. As such currently PDM and Hatch " +"are the tools we think beginners might appreciate most with Poetry being a " +"close second. Poetry is nice for pure Python projects." msgstr "" "さまざまなフロントエンドとバックエンドのパッケージングツールを示すデシジョンツリー図。 " "どのパッケージングツールを使うかは、どんな機能が必要かを考えることで決めることができます。 " @@ -3173,17 +3663,17 @@ msgstr "" #: ../../package-structure-code/python-package-build-tools.md:16 msgid "" -"Diagram showing the different front end build tools available to use in " -"the Python package ecosystem that you can select from. We selected tools " -"to include in this diagram based upon the PyPI survey which helped us " +"Diagram showing the different front end build tools available to use in the" +" Python package ecosystem that you can select from. We selected tools to " +"include in this diagram based upon the PyPI survey which helped us " "understand the most populate tools in the ecosystem. Each tool has " "different features as highlighted below." msgstr "Pythonパッケージのエコシステムで利用可能な、さまざまなフロントエンドビルドツールを示す図です。この図に含めるツールは、エコシステムで最も利用されているツールを理解するのに役立ったPyPI調査に基づいて選択しました。各ツールには、以下のように異なる特徴があります。" #: ../../package-structure-code/python-package-build-tools.md:19 msgid "" -"If you want to know more about Python packages that have extensions " -"written in other languages, [check out the page on complex package builds" +"If you want to know more about Python packages that have extensions written" +" in other languages, [check out the page on complex package builds" ".](complex-python-package-builds)" msgstr "" "他の言語で書かれた拡張機能を持つPythonパッケージについてもっと知りたい場合は、 [複雑なパッケージのビルドのページをチェックしてください" @@ -3196,8 +3686,8 @@ msgstr "ここでレビューするツール" #: ../../package-structure-code/python-package-build-tools.md:24 msgid "" "In this section we have selected tools that were returned as the most " -"popular packaging tools in the PyPA survey. You will learn more about the" -" following tools on this page:" +"popular packaging tools in the PyPA survey. You will learn more about the " +"following tools on this page:" msgstr "このセクションでは、PyPAのアンケートで最も人気のあったパッケージングツールを紹介します。 このページでは以下のツールについて詳しく説明します:" #: ../../package-structure-code/python-package-build-tools.md:28 @@ -3237,9 +3727,9 @@ msgstr "簡単な要約をお探しの方は、以下をお読みください。 #: ../../package-structure-code/python-package-build-tools.md:39 msgid "" -"In general, any modern tool that you select from this page will be great " -"to build your package. Selecting a tool comes down to the features that " -"you are looking for in your workflow." +"In general, any modern tool that you select from this page will be great to" +" build your package. Selecting a tool comes down to the features that you " +"are looking for in your workflow." msgstr "一般的に、このページから選択した最新のツールは、パッケージを構築するのに適しています。 ツールの選択は、ワークフローに求める機能によって決まります。" #: ../../package-structure-code/python-package-build-tools.md:40 @@ -3250,11 +3740,11 @@ msgstr "初心者の方は、 setuptools の複雑な操作ではなく、PDMの #: ../../package-structure-code/python-package-build-tools.md:41 msgid "" -"If you are going to use Poetry (it is the most popular tool and does have" -" the best documentation) beware of the upper bounds dependency additions " -"and consider overriding dependencies when you add them. If you do that " -"Poetry will work well for pure-python builds! Poetry also has an active " -"discord where you can ask questions." +"If you are going to use Poetry (it is the most popular tool and does have " +"the best documentation) beware of the upper bounds dependency additions and" +" consider overriding dependencies when you add them. If you do that Poetry " +"will work well for pure-python builds! Poetry also has an active discord " +"where you can ask questions." msgstr "" "Poetryを使うのであれば (最も人気のあるツールであり、最高のドキュメントを持っています) " "、依存関係の追加上限値に注意し、依存関係を追加する際にオーバーライドすることを検討してください。 " @@ -3273,8 +3763,7 @@ msgstr "PDM:" msgid "" "Supports other back-ends making it ideal for builds that are not pure " "Python. This means PDM is a great option for both pure python and more " -"complex Python builds as it supports meson-python and other build " -"backends." +"complex Python builds as it supports meson-python and other build backends." msgstr "" "他のバックエンドをサポートしているので、純粋な Python ではないビルドに最適です。 つまり、PDMはmeson-" "pythonや他のビルドバックエンドをサポートしているので、純粋なPythonにも、より複雑なPythonビルドにも最適なオプションです。" @@ -3294,8 +3783,8 @@ msgstr "Hatch:" #: ../../package-structure-code/python-package-build-tools.md:53 msgid "" "Offers matrix environment management that allows you to run tests across " -"Python versions. If this feature is important to you, then Hatch is a " -"clear winner." +"Python versions. If this feature is important to you, then Hatch is a clear" +" winner." msgstr "" "Pythonのバージョンにまたがってテストを実行できるマトリックス環境管理を提供します。 もしこの機能があなたにとって重要なら、Hatch " "が明らかに勝者です。" @@ -3303,8 +3792,8 @@ msgstr "" #: ../../package-structure-code/python-package-build-tools.md:54 msgid "" "Offers a Nox / Make file like tool to streamline your build workflow. If " -"you are looking to reduce the number of tools in your workflow, Hatch " -"might be for you." +"you are looking to reduce the number of tools in your workflow, Hatch might" +" be for you." msgstr "" "ビルドワークフローを効率化するNox/Makeファイルのようなツールを提供します。 " "ワークフローにおけるツールの数を減らしたいのであれば、Hatchはうってつけかもしれません。" @@ -3316,8 +3805,8 @@ msgstr "フロントエンド構築ツールとバックエンド構築ツール #: ../../package-structure-code/python-package-build-tools.md:59 msgid "" "To better understand your options, when it comes to building a Python " -"package, it's important to first understand the difference between a " -"build tool front-end and build back-end." +"package, it's important to first understand the difference between a build " +"tool front-end and build back-end." msgstr "Pythonパッケージのビルドに関して、あなたの選択肢をよりよく理解するためには、まずビルドツールのフロントエンドとビルドのバックエンドの違いを理解することが重要です。" #: ../../package-structure-code/python-package-build-tools.md:64 @@ -3326,30 +3815,30 @@ msgstr "バックエンドのビルド" #: ../../package-structure-code/python-package-build-tools.md:66 msgid "" -"Most packaging tools have a back-end build tool that builds you package " -"and creates associated [(sdist and wheel) distribution files](python-" -"package-distribution-files-sdist-wheel). Some tools, such as **Flit**, " -"only support pure-Python package builds. A pure-Python build refers to a " -"package build that does not have extensions that are written in another " -"programming language (such as `C` or `C++`)." +"Most packaging tools have a back-end build tool that builds you package and" +" creates associated [(sdist and wheel) distribution files](python-package-" +"distribution-files-sdist-wheel). Some tools, such as **Flit**, only support" +" pure-Python package builds. A pure-Python build refers to a package build " +"that does not have extensions that are written in another programming " +"language (such as `C` or `C++`)." msgstr "" "ほとんどのパッケージングツールには、パッケージをビルドし、関連する [(sdistとwheel)配布ファイル](python-package-" "distribution-files-sdist-wheel) を作成するバックエンドビルドツールがあります。 **Flit** " -"のようないくつかのツールは、純粋なPythonパッケージのビルドのみをサポートしています。 純粋な Python " -"のビルドとは、他のプログラミング言語 (`C` や `C++` など) で書かれた拡張機能を持たないパッケージのビルドを指します。" +"のようないくつかのツールは、純粋なPythonパッケージのビルドのみをサポートしています。 純粋な Python のビルドとは、他のプログラミング言語" +" (`C` や `C++` など) で書かれた拡張機能を持たないパッケージのビルドを指します。" #: ../../package-structure-code/python-package-build-tools.md:73 msgid "" -"Other packages that have C and C++ extensions (or that wrap other " -"languages such as fortran) require additional code compilation steps when" -" built. Back-ends such as **setuptools.build**, **meson.build** and " -"**scikit-build** support complex builds with custom steps. If your build " -"is particularly complex (i.e. you have more than a few `C`/`C++` " -"extensions), then we suggest you use **meson.build** or **scikit-build**." +"Other packages that have C and C++ extensions (or that wrap other languages" +" such as fortran) require additional code compilation steps when built. " +"Back-ends such as **setuptools.build**, **meson.build** and **scikit-" +"build** support complex builds with custom steps. If your build is " +"particularly complex (i.e. you have more than a few `C`/`C++` extensions), " +"then we suggest you use **meson.build** or **scikit-build**." msgstr "" "C や C++の拡張を持つ他のパッケージ(あるいは fortran " -"のような他の言語を包含するパッケージ)は、ビルド時に追加のコードコンパイルステップを必要とします。 **setuptools.build** 、" -" **meson.build** 、 **scikit-build** " +"のような他の言語を包含するパッケージ)は、ビルド時に追加のコードコンパイルステップを必要とします。 **setuptools.build** 、 " +"**meson.build** 、 **scikit-build** " "などのバックエンドは、カスタムステップによる複雑なビルドをサポートしています。ビルドが特に複雑な場合（つまり `C`/`C++` " "拡張モジュールが数個以上ある場合）は、 **meson.build** または **scikit-build** を使用することをお勧めします。" @@ -3359,8 +3848,8 @@ msgstr "Pythonパッケージビルドフロントエンド" #: ../../package-structure-code/python-package-build-tools.md:81 msgid "" -"A packaging front-end tool refers to a tool that makes it easier for you " -"to perform common packaging tasks using similar commands. These tasks " +"A packaging front-end tool refers to a tool that makes it easier for you to" +" perform common packaging tasks using similar commands. These tasks " "include:" msgstr "" "パッケージングフロントエンドツールとは、同様のコマンドを使用して一般的なパッケージングタスクを簡単に実行できるようにするツールのことです。 " @@ -3394,41 +3883,40 @@ msgstr "ドキュメントの作成" #: ../../package-structure-code/python-package-build-tools.md:89 msgid "" -"Managing an environment or multiple environments in which you need to run" -" tests and develop your package" +"Managing an environment or multiple environments in which you need to run " +"tests and develop your package" msgstr "テストの実行やパッケージの開発が必要な環境、または複数の環境の管理" #: ../../package-structure-code/python-package-build-tools.md:91 msgid "" -"There are several Python packaging tools that you can use for pure Python" -" builds. Each front-end tool discussed below supports a slightly " -"different set of Python packaging tasks." +"There are several Python packaging tools that you can use for pure Python " +"builds. Each front-end tool discussed below supports a slightly different " +"set of Python packaging tasks." msgstr "" -"純粋な Python のビルドに使える Python パッケージングツールがいくつかあります。 " -"以下で説明する各フロントエンドツールは、少しずつ異なる Python パッケージングタスクをサポートしています。" +"純粋な Python のビルドに使える Python パッケージングツールがいくつかあります。 以下で説明する各フロントエンドツールは、少しずつ異なる" +" Python パッケージングタスクをサポートしています。" #: ../../package-structure-code/python-package-build-tools.md:95 msgid "" "For instance, you can use the packaging tools **Flit**, **Hatch** or " "**PDM** to both build and publish your package to PyPI. However while " "**Hatch** and **PDM** support versioning and environment management, " -"**Flit** does not. If you want a tool that supports dependency locking, " -"you can use **PDM** or **Poetry** but not **Hatch**. If you only need to " -"build your package's sdist and wheel distribution files, then you can " -"stick with PyPA's Build. You'd then use Twine to publish to PyPI." +"**Flit** does not. If you want a tool that supports dependency locking, you" +" can use **PDM** or **Poetry** but not **Hatch**. If you only need to build" +" your package's sdist and wheel distribution files, then you can stick with" +" PyPA's Build. You'd then use Twine to publish to PyPI." msgstr "" "例えば、パッケージングツールの **Flit**、**Hatch**、**PDM** を使って、パッケージのビルドと PyPI " -"への公開の両方を行うことができます。 しかし、**Hatch**と**PDM**はバージョン管理と環境管理をサポートしていますが、 " -"**Flit** はサポートしていません。 " -"依存性ロックをサポートするツールが欲しい場合は、**PDM**や**Poetry**を使うことができますが、 **Hatch** は使えません。 " -"パッケージのsdistとwheelの配布ファイルをビルドするだけなら、PyPAのBuildで十分です。 " +"への公開の両方を行うことができます。 しかし、**Hatch**と**PDM**はバージョン管理と環境管理をサポートしていますが、 **Flit** " +"はサポートしていません。 依存性ロックをサポートするツールが欲しい場合は、**PDM**や**Poetry**を使うことができますが、 " +"**Hatch** は使えません。 パッケージのsdistとwheelの配布ファイルをビルドするだけなら、PyPAのBuildで十分です。 " "その後、Twineを使ってPyPIに公開します。" #: ../../package-structure-code/python-package-build-tools.md:102 msgid "" "If you are using **Setuptools**, there is no default user-friendly build " -"front-end that performs multiple tasks. You will need to use **build** to" -" build your package and **twine** to publish to PyPI." +"front-end that performs multiple tasks. You will need to use **build** to " +"build your package and **twine** to publish to PyPI." msgstr "" "**Setuptools** を使用している場合、複数のタスクを実行するデフォルトのユーザーフレンドリーなビルドフロントエンドはありません。 " "パッケージをビルドするには **build** を、PyPI に公開するには **twine** を使う必要があります。" @@ -3439,8 +3927,8 @@ msgstr "フロントエンドツールを使って簡略化できるビルド手 #: ../../package-structure-code/python-package-build-tools.md:107 msgid "" -"Below, you can see how a build tool streamlines your packaging " -"experience. Example to build your package with **Hatch**:" +"Below, you can see how a build tool streamlines your packaging experience. " +"Example to build your package with **Hatch**:" msgstr "以下に、ビルドツールがパッケージングをどのように効率化するかを示します。 **Hatch** でパッケージをビルドする例です:" #: ../../package-structure-code/python-package-build-tools.md:117 @@ -3454,9 +3942,9 @@ msgstr "ビルドバックエンドの選択" #: ../../package-structure-code/python-package-build-tools.md:129 msgid "" "Most front-end packaging tools have their own back-end build tool. The " -"build tool creates your package's (sdist and wheel) distribution files. " -"For pure Python packages, the main difference between the different build" -" back-ends discussed below is:" +"build tool creates your package's (sdist and wheel) distribution files. For" +" pure Python packages, the main difference between the different build " +"back-ends discussed below is:" msgstr "" "ほとんどのフロントエンドパッケージングツールは、独自のバックエンドビルドツールを持っています。 ビルドツールはパッケージの " "(sdistやwheelの) 配布ファイルを作成します。 " @@ -3480,8 +3968,8 @@ msgstr "純粋なPythonパッケージ以外のバックエンドサポートの #: ../../package-structure-code/python-package-build-tools.md:139 msgid "" -"It is important to note that some build back-ends, such as **Flit-core**," -" only support pure Python builds. Other back-ends support C and C++ " +"It is important to note that some build back-ends, such as **Flit-core**, " +"only support pure Python builds. Other back-ends support C and C++ " "extensions as follows:" msgstr "" "**Flit-core** " @@ -3493,8 +3981,8 @@ msgstr "setuptools は、C / C++ 拡張モジュールを使用したビルド #: ../../package-structure-code/python-package-build-tools.md:143 msgid "" -"Hatchling (hatch's back-end) supports C / C++ extensions via plugins that" -" the developer creates to customize a build" +"Hatchling (hatch's back-end) supports C / C++ extensions via plugins that " +"the developer creates to customize a build" msgstr "" "Hatchling (hatchのバックエンド) " "は、開発者がビルドをカスタマイズするために作成するプラグインによって、C/C++の拡張機能をサポートしています。" @@ -3505,9 +3993,9 @@ msgstr "PDMのバックエンドは、setuptoolsを使用してC / C++拡張を #: ../../package-structure-code/python-package-build-tools.md:145 msgid "" -"Poetry's back-end supports C/C++ extensions however this functionality is" -" currently undocumented. As such we don't recommend using Poetry for " -"complex or non pure Python builds until it is documented." +"Poetry's back-end supports C/C++ extensions however this functionality is " +"currently undocumented. As such we don't recommend using Poetry for complex" +" or non pure Python builds until it is documented." msgstr "" "PoetryのバックエンドはC/C++拡張をサポートしていますが、この機能は現在ドキュメント化されていません。 " "そのため、ドキュメント化されるまでは、複雑なビルドや純粋なPython以外のビルドにPoetryを使うことはお勧めしません。" @@ -3524,9 +4012,9 @@ msgstr "Pythonビルドツールのエコシステム" #: ../../package-structure-code/python-package-build-tools.md:152 msgid "" -"Below we introduce several of the most commonly used Python packaging " -"build front-end tools. We highlight the features that each tool offers as" -" a way to help you decide what tool might be best for your workflow." +"Below we introduce several of the most commonly used Python packaging build" +" front-end tools. We highlight the features that each tool offers as a way " +"to help you decide what tool might be best for your workflow." msgstr "" "以下では、最もよく使われる Python パッケージングビルドフロントエンドツールをいくつか紹介します。 " "どのツールがあなたのワークフローに最適かを決める手助けとして、各ツールが提供する機能を強調します。" @@ -3537,24 +4025,22 @@ msgstr "setuptools の使用はお勧めしません" #: ../../package-structure-code/python-package-build-tools.md:159 msgid "" -"We suggest that you pick one of the modern tools listed above rather than" -" setuptools because setuptools will require some additional knowledge to " -"set up correctly." +"We suggest that you pick one of the modern tools listed above rather than " +"setuptools because setuptools will require some additional knowledge to set" +" up correctly." msgstr "setuptoolsは、正しくセットアップするためにいくつかの追加知識を必要とするため、setuptoolsではなく、上記の近代的なツールのいずれかを選択することをお勧めします。" #: ../../package-structure-code/python-package-build-tools.md:163 msgid "" -"We review setuptools as a back-end because it is still popular. However " -"it is not the most user friendly option." -msgstr "" -"バックエンドとしてsetuptoolsをレビューするのは、今でも人気があるからです。 " -"しかし、それは最もユーザーフレンドリーなオプションではありません。" +"We review setuptools as a back-end because it is still popular. However it " +"is not the most user friendly option." +msgstr "バックエンドとしてsetuptoolsをレビューするのは、今でも人気があるからです。 しかし、それは最もユーザーフレンドリーなオプションではありません。" #: ../../package-structure-code/python-package-build-tools.md:167 msgid "" -"The most commonly used tools in the ecosystem are setuptools back-end " -"(with build) and Poetry (a front end tool with numerous features and " -"excellent documentation)." +"The most commonly used tools in the ecosystem are setuptools back-end (with" +" build) and Poetry (a front end tool with numerous features and excellent " +"documentation)." msgstr "エコシステムで最もよく使われるツールは、setuptoolsのバックエンド（ビルド機能付き）とPoetry（多数の機能と優れたドキュメントを備えたフロントエンドツール）です。" #: ../../package-structure-code/python-package-build-tools.md:173 @@ -3565,14 +4051,14 @@ msgstr "2022年のPyPAによるPythonパッケージングツールの調査結 #: ../../package-structure-code/python-package-build-tools.md:175 msgid "" -"The Python developers survey results (n=>8,000 PyPI users) show " -"setuptools and poetry as the most commonly used Python packaging tools. " -"The core tools that we've seen being used in the scientific community are" -" included here. [You can view the full survey results by clicking " +"The Python developers survey results (n=>8,000 PyPI users) show setuptools " +"and poetry as the most commonly used Python packaging tools. The core tools" +" that we've seen being used in the scientific community are included here. " +"[You can view the full survey results by clicking " "here.](https://drive.google.com/file/d/1U5d5SiXLVkzDpS0i1dJIA4Hu5Qg704T9/view)" -" NOTE: this data represent maintainers across domains and is likely " -"heavily represented by those in web development. So this represents a " -"snapshot across the broader Python ecosystem." +" NOTE: this data represent maintainers across domains and is likely heavily" +" represented by those in web development. So this represents a snapshot " +"across the broader Python ecosystem." msgstr "" "Python developers survey results (n=>8,000 PyPI " "users)では、最もよく使われているPythonパッケージングツールとしてsetuptoolsとpoetryが挙げられています。 " @@ -3623,14 +4109,14 @@ msgstr "Poetry" #: ../../package-structure-code/python-package-build-tools.md:188 msgid "" -"When you are selecting a tool, you might consider this general workflow " -"of questions:" +"When you are selecting a tool, you might consider this general workflow of " +"questions:" msgstr "ツールを選ぶ際には、このような一般的な質問の流れを考慮するとよいでしょう:" #: ../../package-structure-code/python-package-build-tools.md:191 msgid "" -"**Is your tool pure python? Yes?** You can use any tool that you wish! " -"Pick the tool that has the features that you want to use in your build " +"**Is your tool pure python? Yes?** You can use any tool that you wish! Pick" +" the tool that has the features that you want to use in your build " "workflow. We suggest:" msgstr "" "**あなたのツールは純粋なパイソンですか？はい？** お好きなツールをお使いください！ " @@ -3642,12 +4128,12 @@ msgstr "Flit、Hatch、PDM、またはPoetry (詳しくは以下をお読みく #: ../../package-structure-code/python-package-build-tools.md:195 msgid "" -"**Does your tool have a few C or C++ extensions?** Great, we suggest " -"using **PDM** for the time being. It is the only tool in the list below " -"that has both documented workflow to support such extensions and support " -"for other back-ends in the case that build hooks are not enough for your " -"workflow. PDM supports other back-ends such as scikit-build and meson-" -"python that will allow you to fully customize your package's build." +"**Does your tool have a few C or C++ extensions?** Great, we suggest using " +"**PDM** for the time being. It is the only tool in the list below that has " +"both documented workflow to support such extensions and support for other " +"back-ends in the case that build hooks are not enough for your workflow. " +"PDM supports other back-ends such as scikit-build and meson-python that " +"will allow you to fully customize your package's build." msgstr "" "**あなたのツールはCやC++の拡張機能をいくつか持っていますか？** 当面は **PDM** を使うことをお勧めします。 " "以下のリストの中で、このような拡張をサポートするワークフローが文書化されており、ビルドフックだけではワークフローが不十分な場合に他のバックエンドをサポートする唯一のツールです。" @@ -3656,12 +4142,12 @@ msgstr "" #: ../../package-structure-code/python-package-build-tools.md:199 msgid "" -"NOTE: You can also use Hatch for non pure python builds. Hatch, similar " -"to PDM, allows you to write your own build hooks or plugins to support " -"custom build steps. But currently, hatch does not support other build " -"back ends. Many of the core scientific packages are moving to meson-" -"python to build their packages. Thus, we appreciate that PDM can work " -"with meson-python specifically." +"NOTE: You can also use Hatch for non pure python builds. Hatch, similar to " +"PDM, allows you to write your own build hooks or plugins to support custom " +"build steps. But currently, hatch does not support other build back ends. " +"Many of the core scientific packages are moving to meson-python to build " +"their packages. Thus, we appreciate that PDM can work with meson-python " +"specifically." msgstr "" "注: 純粋なpython以外のビルドにもHatchを使うことができます。 Hatch は PDM " "と同様に、独自のビルドフックやプラグインを書くことができます。 " @@ -3676,11 +4162,11 @@ msgstr "Pythonパッケージングツールまとめ" msgid "" "Below, we summarize features offered by the most popular build front end " "tools. It is important to keep in mind that these front-end tools remove " -"the need to use other core tools in your workflow. For example if you use" -" setuptools, you will need to also use Build and Twine to build your " -"package and publish to PyPI. But if you use Poetry, Hatch or PDM you can " -"do all of those things using the same tool (e.g. `hatch build`, `hatch " -"publish` or `pdm build`, `pdm publish`)." +"the need to use other core tools in your workflow. For example if you use " +"setuptools, you will need to also use Build and Twine to build your package" +" and publish to PyPI. But if you use Poetry, Hatch or PDM you can do all of" +" those things using the same tool (e.g. `hatch build`, `hatch publish` or " +"`pdm build`, `pdm publish`)." msgstr "" "以下に、最も人気のあるビルドフロントエンドツールが提供する機能を要約します。これらのフロントエンドツールは、あなたのワークフローにおいて他のコアツールを使う必要性をなくすということを覚えておくことが重要です。" " 例えばsetuptoolsを使う場合、パッケージをビルドしてPyPIに公開するためにBuildとTwineも使う必要があります。 " @@ -3781,9 +4267,8 @@ msgstr "_Hatch は将来的に従属性管理をサポートする予定です_" #: ../../package-structure-code/python-package-build-tools.md:230 msgid "" -"Poetry supports semantic versioning. Thus, it will support version " -"bumping following commit messages if you use a tool such as Python " -"Semantic Release" +"Poetry supports semantic versioning. Thus, it will support version bumping " +"following commit messages if you use a tool such as Python Semantic Release" msgstr "" "Poetry はセマンティックバージョニングをサポートしています。 したがって、Python Semantic " "Releaseのようなツールを使えば、コミットメッセージに続くバージョンバンプをサポートします。" @@ -3792,9 +4277,9 @@ msgstr "" #, fuzzy msgid "" "[PDM is a Python packaging and dependency management tool](https://pdm-" -"project.org/latest/). PDM supports builds for pure Python projects. It " -"also provides multiple layers of support for projects that have C and C++" -" extensions." +"project.org/latest/). PDM supports builds for pure Python projects. It also" +" provides multiple layers of support for projects that have C and C++ " +"extensions." msgstr "" "[PDMはPythonのパッケージングと依存関係の管理ツールです](https://pdm.fming.dev/latest/) 。 " "PDMは純粋なPythonプロジェクトのビルドをサポートします。また、CやC++の拡張を持つプロジェクトに対しても、多層的なサポートを提供します。" @@ -3805,10 +4290,10 @@ msgstr "CおよびC++拡張のPDMサポート" #: ../../package-structure-code/python-package-build-tools.md:241 msgid "" -"PDM supports using the PDM-back-end and setuptools at the same time. This" -" means that you can run setuptools to compile and build C extensions. " -"PDM's build back-end receives the compiled extension files (.so, .pyd) " -"and packages them with the pure Python files." +"PDM supports using the PDM-back-end and setuptools at the same time. This " +"means that you can run setuptools to compile and build C extensions. PDM's " +"build back-end receives the compiled extension files (.so, .pyd) and " +"packages them with the pure Python files." msgstr "" "PDMはPDM-back-endとsetuptoolsの同時使用をサポートしています。 つまり、setuptools を実行して C " "拡張モジュールをコンパイルビルドすることができます。 PDMのビルドバックエンドはコンパイルされた拡張ファイル(.so, " @@ -3829,9 +4314,9 @@ msgstr "注釈:" #: ../../package-structure-code/python-package-build-tools.md:254 msgid "" -"When you setup PDM it allows you to select one of several build back ends" -" including: PDM-core, flit-core and hatchling. PDM also can work with " -"Meson-Python which supports move complex python builds." +"When you setup PDM it allows you to select one of several build back ends " +"including: PDM-core, flit-core and hatchling. PDM also can work with Meson-" +"Python which supports move complex python builds." msgstr "" "PDMをセットアップする際、いくつかのビルドバックエンドから1つを選択することができます: PDM-core、flit-" "core、hatchlingなどです。 PDMはまた、複雑なPythonビルドをサポートするMeson-Pythonとも連携できます。" @@ -3843,15 +4328,15 @@ msgstr "依存仕様" #: ../../package-structure-code/python-package-build-tools.md:254 #, fuzzy msgid "" -"PDM has flexible support for managing dependencies. PDM defaults to " -"using an open bound (e.g. `requests >=1.2`) approach to dependencies. " -"However you can [customize how you want to add dependencies in case you " -"prefer another approach such as that of Poetry which uses an upper bound " +"PDM has flexible support for managing dependencies. PDM defaults to using " +"an open bound (e.g. `requests >=1.2`) approach to dependencies. However you" +" can [customize how you want to add dependencies in case you prefer " +"another approach such as that of Poetry which uses an upper bound " "limit](https://pdm-project.org/en/latest/usage/dependency/#about-update-" "strategy).**" msgstr "" -"PDMは依存関係の管理を柔軟にサポートしています。 PDMはデフォルトで依存関係に対してオープンバウンド(例えば `requests >=1.2`" -" )アプローチを使用します。 しかし、 " +"PDMは依存関係の管理を柔軟にサポートしています。 PDMはデフォルトで依存関係に対してオープンバウンド(例えば `requests >=1.2` " +")アプローチを使用します。 しかし、 " "[Poetryのような上限を使用する別のアプローチを好む場合、依存関係を追加する方法をカスタマイズする](https://pdm.fming.dev/latest/usage/dependency" "/#about-update-strategy) ことができます。" @@ -3863,13 +4348,12 @@ msgstr "環境ロックファイル" msgid "" "PDM and Poetry are currently the only tools that create environment lock " "files. Lock files are often most useful to developers creating web apps " -"where locking the environment is critical for consistent user experience." -" For community-used packages, you will likely never want to use a lock " -"file." +"where locking the environment is critical for consistent user experience. " +"For community-used packages, you will likely never want to use a lock file." msgstr "" "PDMとPoetryは現在、環境ロックファイルを作成する唯一のツールです。 " -"ロックファイルは、一貫したユーザーエクスペリエンスのために環境をロックすることが重要なウェブアプリを作成する開発者にとって、しばしば最も有用です。" -" コミュニティで使われるパッケージでは、ロックファイルを使うことはないでしょう。" +"ロックファイルは、一貫したユーザーエクスペリエンスのために環境をロックすることが重要なウェブアプリを作成する開発者にとって、しばしば最も有用です。 " +"コミュニティで使われるパッケージでは、ロックファイルを使うことはないでしょう。" #: ../../package-structure-code/python-package-build-tools.md:254 #: ../../package-structure-code/python-package-build-tools.md:398 @@ -3892,8 +4376,8 @@ msgstr "インストール時に環境タイプを選択" #: ../../package-structure-code/python-package-build-tools.md:254 msgid "" -"When you run `PDM init`, PDM will discover environments that are already " -"on your system and allow you to select one to use for your project." +"When you run `PDM init`, PDM will discover environments that are already on" +" your system and allow you to select one to use for your project." msgstr "`PDM init` を実行すると、PDMがあなたのシステム上にある環境を検出し、プロジェクトに使用する環境を選択できるようになります。" #: ../../package-structure-code/python-package-build-tools.md:254 @@ -3953,8 +4437,8 @@ msgstr "sdistとwheelディストリビューションの構築" #: ../../package-structure-code/python-package-build-tools.md:254 msgid "" -"Similar to all of the other tools PDM builds your packages sdist and " -"wheel files for you." +"Similar to all of the other tools PDM builds your packages sdist and wheel " +"files for you." msgstr "他のツール同様、PDMはパッケージのsdistとwheelファイルをビルドしてくれます。" #: ../../package-structure-code/python-package-build-tools.md:267 @@ -3964,9 +4448,9 @@ msgstr "PDM vs. Poetry" #: ../../package-structure-code/python-package-build-tools.md:268 msgid "" "The functionality of PDM is similar to Poetry. However, PDM also offers " -"additional, documented support for C extensions and version control based" -" versioning. As such, PDM is preferred for those working on non pure-" -"Python packages." +"additional, documented support for C extensions and version control based " +"versioning. As such, PDM is preferred for those working on non pure-Python " +"packages." msgstr "" "PDMの機能はPoetryに似ています。 しかし、PDMはC拡張やバージョン管理ベースのバージョニングを文書でサポートしています。 " "そのため、純粋なPython以外のパッケージで作業する場合は、PDMを使うことをお勧めします。" @@ -3979,16 +4463,16 @@ msgstr "もしあなたがPoetryとPDMのどちらを選ぶか決めているの #: ../../package-structure-code/python-package-build-tools.md:274 msgid "" -"Poetry by default follows strict semantic versioning adding dependencies " -"to your pyproject.toml file [using an upper bounds constraint " -"(`^`)](https://python-poetry.org/docs/dependency-specification/#version-" -"constraints). Upper bounds lock means that Poetry will never bump a " -"dependency to the next major version (i.e. from 1.2 to 2.0). However, you" -" can tell Poetry to use an open bound approach by explicitly adding the " -"package like this: `poetry add requests >= 1.2` rather than just using " -"`poetry add requests` which will result in a upper bound locked (ie Upper" -" bound locks means that requests 2.0 could never be installed even if it " -"came out and your package could benefit from it)." +"Poetry by default follows strict semantic versioning adding dependencies to" +" your pyproject.toml file [using an upper bounds constraint (`^`)](https" +"://python-poetry.org/docs/dependency-specification/#version-constraints). " +"Upper bounds lock means that Poetry will never bump a dependency to the " +"next major version (i.e. from 1.2 to 2.0). However, you can tell Poetry to " +"use an open bound approach by explicitly adding the package like this: " +"`poetry add requests >= 1.2` rather than just using `poetry add requests` " +"which will result in a upper bound locked (ie Upper bound locks means that " +"requests 2.0 could never be installed even if it came out and your package " +"could benefit from it)." msgstr "" "Poetryはデフォルトで、pyproject.tomlファイルに [上界制約(`^`)を使って](https://python-" "poetry.org/docs/dependency-specification/#version-constraints) " @@ -4004,13 +4488,12 @@ msgstr "" msgid "" "PDM defaults to open-bounds (`>=`) dependency additions which is the " "preferred approach in the scientific python ecosystem. However, PDM also " -"allows you to specify the way dependencies are added by default. As such," -" you can also specify upper-bounds (`^`) using PDM if require that " -"approach." +"allows you to specify the way dependencies are added by default. As such, " +"you can also specify upper-bounds (`^`) using PDM if require that approach." msgstr "" "PDMのデフォルトはオープンバウンド(`>=`)依存性の追加で、これは科学的なpythonのエコシステムでは好ましいアプローチです。 " -"しかし、PDMではデフォルトで依存関係を追加する方法を指定することもできます。 そのため、その方法が必要であれば、PDMを使用して上限 (`^`)" -" を指定することもできます。" +"しかし、PDMではデフォルトで依存関係を追加する方法を指定することもできます。 そのため、その方法が必要であれば、PDMを使用して上限 (`^`) " +"を指定することもできます。" #: ../../package-structure-code/python-package-build-tools.md:277 msgid "" @@ -4023,16 +4506,14 @@ msgid "Challenges with PDM" msgstr "PDMの課題" #: ../../package-structure-code/python-package-build-tools.md:282 -msgid "" -"PDM is a full-featured packaging tool. However it is not without " -"challenges:" +msgid "PDM is a full-featured packaging tool. However it is not without challenges:" msgstr "PDMはフル機能のパッケージングツールです。しかし、課題がないわけではありません:" #: ../../package-structure-code/python-package-build-tools.md:284 msgid "" -"Its documentation can be confusing, especially if you are new to " -"packaging. For example, PDM doesn't provide an end to end beginning " -"workflow in its documentation." +"Its documentation can be confusing, especially if you are new to packaging." +" For example, PDM doesn't provide an end to end beginning workflow in its " +"documentation." msgstr "" "PDMのドキュメントは、特に初めてパッケージングを行う場合、混乱する可能性があります。 " "例えば、PDMのドキュメントには、最初から最後までのワークフローが記載されていません。" @@ -4051,9 +4532,9 @@ msgstr "" #: ../../package-structure-code/python-package-build-tools.md:291 msgid "" "[You can view an example of a package that uses PDM " -"here](https://github.com/pyOpenSci/examplePy/tree/main/example4_pdm). The" -" README file for this directly provides you with an overview of what the " -"PDM command line interface looks like when you use it." +"here](https://github.com/pyOpenSci/examplePy/tree/main/example4_pdm). The " +"README file for this directly provides you with an overview of what the PDM" +" command line interface looks like when you use it." msgstr "" "[PDMを使用したパッケージの例はこちらからご覧いただけます](https://github.com/pyOpenSci/examplePy/tree/main/example4_pdm)" " 。 このREADMEファイルでは、PDMコマンドラインインターフェイスを使用する際にどのように見えるかの概要を直接説明しています。" @@ -4092,8 +4573,8 @@ msgstr "**pyproject.toml** ファイルにメタデータを追加するのに #: ../../package-structure-code/python-package-build-tools.md:307 msgid "" -"Flit does support adding metadata to your **pyproject.toml** file " -"following modern packaging standards." +"Flit does support adding metadata to your **pyproject.toml** file following" +" modern packaging standards." msgstr "Flitは **pyproject.toml** ファイルにメタデータを追加することをサポートしています。" #: ../../package-structure-code/python-package-build-tools.md:307 @@ -4112,11 +4593,11 @@ msgstr "Flitはsdistとwheelのディストリビューションパッケージ #: ../../package-structure-code/python-package-build-tools.md:314 msgid "" -"NOTE: _If you are using the most current version of pip, it supports both" -" a symlink approach `flit install -s` and `python -m pip install -e .`_" +"NOTE: _If you are using the most current version of pip, it supports both a" +" symlink approach `flit install -s` and `python -m pip install -e .`_" msgstr "" -"注: _最新バージョンのpipを使用している場合、シンボリックリンクを使った `flit install -s` と `python -m pip" -" install -e .`_ の両方をサポートしています。" +"注: _最新バージョンのpipを使用している場合、シンボリックリンクを使った `flit install -s` と `python -m pip " +"install -e .`_ の両方をサポートしています。" #: ../../package-structure-code/python-package-build-tools.md:316 msgid "Learn more about flit" @@ -4132,12 +4613,10 @@ msgstr "Flitを使いたくない理由" #: ../../package-structure-code/python-package-build-tools.md:323 msgid "" -"Because Flit is no frills, it is best for basic, quick builds. If you are" -" a beginner you may want to select Hatch or PDM which will offer you more" -" support in common operations." -msgstr "" -"Flitは飾り気がないので、基本的で素早いビルドに最適です。 " -"初心者の方は、一般的な操作をよりサポートしてくれるHatchやPDMを選ぶとよいでしょう。" +"Because Flit is no frills, it is best for basic, quick builds. If you are a" +" beginner you may want to select Hatch or PDM which will offer you more " +"support in common operations." +msgstr "Flitは飾り気がないので、基本的で素早いビルドに最適です。 初心者の方は、一般的な操作をよりサポートしてくれるHatchやPDMを選ぶとよいでしょう。" #: ../../package-structure-code/python-package-build-tools.md:327 msgid "You may NOT want to use flit if:" @@ -4150,9 +4629,7 @@ msgid "" msgstr "より高度なバージョン追跡と管理をセットアップしたい場合 (バージョン管理を使ってバージョンバンプを行う)" #: ../../package-structure-code/python-package-build-tools.md:330 -msgid "" -"You want a tool that handles dependency versions (use PDM or Poetry " -"instead)" +msgid "You want a tool that handles dependency versions (use PDM or Poetry instead)" msgstr "依存性のあるバージョンを処理するツールが必要（代わりにPDMやPoetryを使用する）" #: ../../package-structure-code/python-package-build-tools.md:331 @@ -4167,17 +4644,17 @@ msgstr "環境を管理したい（PDM、Hatch、またはPoetryを使用する msgid "" "[**Hatch**](https://hatch.pypa.io/latest/), similar to Poetry and PDM, " "provides a unified command line interface. To separate Hatch from Poetry " -"and PDM, it also provides an environment manager for testing that will " -"make it easier for you to run tests locally across different versions of " +"and PDM, it also provides an environment manager for testing that will make" +" it easier for you to run tests locally across different versions of " "Python. It also offers a nox / makefile like feature that allows you to " -"create custom build workflows such as building your documentation " -"locally. This means that you could potentially drop a tool like **Make** " -"or **Nox** from your workflow and use Hatch instead." +"create custom build workflows such as building your documentation locally. " +"This means that you could potentially drop a tool like **Make** or **Nox** " +"from your workflow and use Hatch instead." msgstr "" "[**Hatch**](https://hatch.pypa.io/latest/) " "は、ポエトリーやPDMと同様、統一されたコマンドラインインターフェイスを提供する。HatchをPoetryやPDMから切り離すために、Pythonの異なるバージョン間でローカルにテストを実行しやすくするテスト用の環境マネージャーも提供しています。" -" また、nox / makefileのような機能もあり、ドキュメントをローカルでビルドするようなカスタムビルドワークフローを作成することができる。" -" つまり、ワークフローから **Make** や **Nox** " +" また、nox / makefileのような機能もあり、ドキュメントをローカルでビルドするようなカスタムビルドワークフローを作成することができる。 " +"つまり、ワークフローから **Make** や **Nox** " "のようなツールを削除して、代わりにHatchを使うことができる可能性があるということだ。" #: ../../package-structure-code/python-package-build-tools.md:345 @@ -4186,8 +4663,8 @@ msgstr "Hatchの特徴" #: ../../package-structure-code/python-package-build-tools.md:353 msgid "" -"Hatch is used with the backend Hatchling by default, but allows you to " -"use another backend by switching the declaration in pyproject.toml." +"Hatch is used with the backend Hatchling by default, but allows you to use " +"another backend by switching the declaration in pyproject.toml." msgstr "HatchはデフォルトでHatchlingバックエンドと一緒に使われますが、pyproject.tomlの宣言を切り替えることで別のバックエンドを使うことができます。" #: ../../package-structure-code/python-package-build-tools.md:353 @@ -4201,10 +4678,10 @@ msgstr "" #: ../../package-structure-code/python-package-build-tools.md:353 msgid "" -"Hatch supports Python virtual environments. If you wish to use other " -"types of environments such as Conda, you will need to [install a plugin " -"such as hatch-conda for conda support](https://github.com/OldGrumpyViking" -"/hatch-conda)." +"Hatch supports Python virtual environments. If you wish to use other types " +"of environments such as Conda, you will need to [install a plugin such as " +"hatch-conda for conda support](https://github.com/OldGrumpyViking/hatch-" +"conda)." msgstr "" "HatchはPython仮想環境をサポートしています。 Condaのような他の環境を使いたい場合は、 [condaをサポートするhatch-" "condaのようなプラグインをインストールする](https://github.com/OldGrumpyViking/hatch-conda) " @@ -4240,14 +4717,14 @@ msgstr "Hatchは、 **pyproject.toml** ファイルにメタデータを追加 #: ../../package-structure-code/python-package-build-tools.md:353 msgid "" -"Hatch will install your package into any of its environments by default " -"in editable mode. You can install your package in editable mode manually " -"using `python -m pip install -e .` Hatch mentions [editable " -"installs](https://hatch.pypa.io/latest/config/build/#dev-mode) but refers" -" to pip in its documentation." +"Hatch will install your package into any of its environments by default in " +"editable mode. You can install your package in editable mode manually using" +" `python -m pip install -e .` Hatch mentions [editable " +"installs](https://hatch.pypa.io/latest/config/build/#dev-mode) but refers " +"to pip in its documentation." msgstr "" -"Hatchはデフォルトで編集可能なモードで、あなたのパッケージをどの環境にもインストールします。 `python -m pip install " -"-e .` を使って、編集可能モードでパッケージを手動でインストールできます。Hatchは [editable " +"Hatchはデフォルトで編集可能なモードで、あなたのパッケージをどの環境にもインストールします。 `python -m pip install -e " +".` を使って、編集可能モードでパッケージを手動でインストールできます。Hatchは [editable " "installs](https://hatch.pypa.io/latest/config/build/#dev-mode) " "に言及していますが、ドキュメントではpipを参照しています。" @@ -4261,8 +4738,8 @@ msgstr "✨Pythonのバージョンをまたいだテストをサポートする #: ../../package-structure-code/python-package-build-tools.md:353 msgid "" -"The matrix environment creation is a feature that is unique to Hatch in " -"the packaging ecosystem. This feature is useful if you wish to test your " +"The matrix environment creation is a feature that is unique to Hatch in the" +" packaging ecosystem. This feature is useful if you wish to test your " "package locally across Python versions (instead of using a tool such as " "tox)." msgstr "" @@ -4280,9 +4757,9 @@ msgstr "" #: ../../package-structure-code/python-package-build-tools.md:353 msgid "" "This feature is also unique to Hatch. This functionality allows you to " -"create workflows in the **pyproject.toml** configuration to do things " -"like serve docs locally and clean your package build directory. This " -"means you may have one less tool in your build workflow." +"create workflows in the **pyproject.toml** configuration to do things like " +"serve docs locally and clean your package build directory. This means you " +"may have one less tool in your build workflow." msgstr "" "これもHatchならではの特徴だ。この機能により、**pyproject.toml** " "設定にワークフローを作成し、ドキュメントをローカルに提供したり、パッケージのビルドディレクトリをクリーニングしたりすることができます。これは、ビルドワークフローのツールが1つ減ることを意味します。" @@ -4300,10 +4777,10 @@ msgstr "**Hatchのメンテナが提供するhatchlingビルドバックエン #: ../../package-structure-code/python-package-build-tools.md:367 msgid "" -"_There is some argument about this approach placing a burden on " -"maintainers to create a custom build system. But others appreciate the " -"flexibility. The Hatch build hook approach is also comparable with the " -"features offered by PDM._" +"_There is some argument about this approach placing a burden on maintainers" +" to create a custom build system. But others appreciate the flexibility. " +"The Hatch build hook approach is also comparable with the features offered " +"by PDM._" msgstr "" "_このアプローチは、メンテナにカスタムビルドシステムを作る負担を強いるという議論があリマス。 しかし、柔軟性を高く評価する人もいます。 " "ハッチのビルドフックアプローチは、PDMが提供する機能にも匹敵します。_" @@ -4340,9 +4817,9 @@ msgstr "Hatchは、PDMやFlitと同様、現在1人のメンテナしかいま #: ../../package-structure-code/python-package-build-tools.md:382 msgid "" -"[Poetry is a full-featured build tool.](https://python-poetry.org/) It is" -" also the second most popular front-end packaging tool (based upon the " -"PyPA survey). Poetry is user-friendly and has clean and easy-to-read " +"[Poetry is a full-featured build tool.](https://python-poetry.org/) It is " +"also the second most popular front-end packaging tool (based upon the PyPA " +"survey). Poetry is user-friendly and has clean and easy-to-read " "documentation." msgstr "" "[Poetry はフル機能のビルドツールです。](https://python-poetry.org/) " @@ -4351,9 +4828,9 @@ msgstr "" #: ../../package-structure-code/python-package-build-tools.md:387 msgid "" -"While some have used Poetry for Python builds with C/C++ extensions, this" -" support is currently undocumented. Thus, we don't recommend using Poetry" -" for more complex builds." +"While some have used Poetry for Python builds with C/C++ extensions, this " +"support is currently undocumented. Thus, we don't recommend using Poetry " +"for more complex builds." msgstr "" "C/C++ 拡張を含む Python のビルドに Poetry を使っている人もいますが、このサポートは現在のところ文書化されていません。 " "したがって、より複雑なビルドに Poetry を使うことはお勧めしません。" @@ -4373,23 +4850,21 @@ msgstr "依存仕様" #: ../../package-structure-code/python-package-build-tools.md:398 msgid "" -"Poetry allows you to be specific about version of dependencies that you " -"add to your package's pyproject.toml file. However, it's default upper " -"bound approach can be problematic for some packages (We suggest you " -"override the default setting when adding dependencies). Read below for " -"more." +"Poetry allows you to be specific about version of dependencies that you add" +" to your package's pyproject.toml file. However, it's default upper bound " +"approach can be problematic for some packages (We suggest you override the " +"default setting when adding dependencies). Read below for more." msgstr "" "Poetryはパッケージのpyproject.tomlファイルに追加する依存関係のバージョンを指定することができます。 " -"しかし、デフォルトの上限アプローチはパッケージによっては問題があります(依存関係を追加するときはデフォルトの設定を上書きすることをお勧めします)。" -" 詳しくは以下をお読みください。" +"しかし、デフォルトの上限アプローチはパッケージによっては問題があります(依存関係を追加するときはデフォルトの設定を上書きすることをお勧めします)。 " +"詳しくは以下をお読みください。" #: ../../package-structure-code/python-package-build-tools.md:398 msgid "" -"Poetry allows you to either use its built in environment or you can " -"select the environment type that you want to use for managing your " -"package. [Read more about its built in environment management " -"options](https://python-poetry.org/docs/basic-usage/#using-your-virtual-" -"environment)." +"Poetry allows you to either use its built in environment or you can select " +"the environment type that you want to use for managing your package. [Read " +"more about its built in environment management options](https://python-" +"poetry.org/docs/basic-usage/#using-your-virtual-environment)." msgstr "" "Poetryでは、ビルトイン環境を使用するか、パッケージ管理に使用する環境タイプを選択することができます。 " "[内蔵された環境管理オプションについての詳細はこちら](https://python-poetry.org/docs/basic-usage" @@ -4401,8 +4876,8 @@ msgstr "ファイルのロック" #: ../../package-structure-code/python-package-build-tools.md:398 msgid "" -"Poetry creates a **poetry.lock** file that you can use if you need a lock" -" file for your build." +"Poetry creates a **poetry.lock** file that you can use if you need a lock " +"file for your build." msgstr "Poetryは **poetry.lock** ファイルを作成するので、ビルドにロックファイルが必要な場合に使用します。" #: ../../package-structure-code/python-package-build-tools.md:398 @@ -4412,8 +4887,7 @@ msgstr "Poetry は test PyPI と PyPI の両方への公開をサポートして #: ../../package-structure-code/python-package-build-tools.md:398 msgid "" "The plugin [Poetry dynamic versioning](https://github.com/mtkennerly" -"/poetry-dynamic-versioning) supports versioning using git tags with " -"Poetry." +"/poetry-dynamic-versioning) supports versioning using git tags with Poetry." msgstr "" "[Poetry dynamic versioning](https://github.com/mtkennerly/poetry-dynamic-" "versioning) プラグインは、Poetryでgitタグを使ったバージョン管理をサポートします。" @@ -4428,10 +4902,13 @@ msgstr "" #: ../../package-structure-code/python-package-build-tools.md:398 msgid "" -"Since version 2.0, Poetry supports most current project metadata " -"standards. However, not all standards are supported, and it also supports" -" the legacy Poetry format. Read below for more." +"Since version 2.0, Poetry supports most current project metadata standards." +" However, not all standards are supported, and it also supports the legacy " +"Poetry format. Read below for more." msgstr "" +"バージョン 2.0 以降、Poetry は最新のプロジェクト " +"メタデータ標準をサポートしています。ただし、すべての標準がサポートされているわけではなく、従来の Poetry " +"形式もサポートされています。詳細については以下をお読みください。" #: ../../package-structure-code/python-package-build-tools.md:398 #, fuzzy @@ -4453,34 +4930,39 @@ msgstr "Poetryの課題には次のようなものがある:" #: ../../package-structure-code/python-package-build-tools.md:417 msgid "" "Poetry has its own concept of grouped dependencies (`poetry add " -"--group=GROUP_NAME DEPENDENCY`). Dependencies added as grouped " -"dependencies are not optional and there is no Python standard for this " -"type of dependency. This should not be confused with \"optional\" " -"dependencies (`poetry add --optional=GROUP_NAME DEPENDENCY`), which is " -"standardised and lets you group your dependencies into several optional " -"groups." +"--group=GROUP_NAME DEPENDENCY`). Dependencies added as grouped dependencies" +" are not optional and there is no Python standard for this type of " +"dependency. This should not be confused with \"optional\" dependencies " +"(`poetry add --optional=GROUP_NAME DEPENDENCY`), which is standardised and " +"lets you group your dependencies into several optional groups." msgstr "" +"詩には、グループ化された依存関係という独自の概念があります (`poetry add --group=GROUP_NAME " +"DEPENDENCY`)。グループ化された依存関係として追加される依存関係はオプションではなく、このタイプの依存関係に対する Python " +"標準はありません。これを「オプションの」依存関係 (`poetry add --optional=GROUP_NAME DEPENDENCY`) " +"と混同しないでください。これは標準化されており、依存関係をいくつかのオプションのグループにグループ化できます。" #: ../../package-structure-code/python-package-build-tools.md:418 msgid "" -"While Poetry supports \"development\" dependencies (i.e. dependencies you" -" use for development but not running the code, such as `pytest`), Poetry " +"While Poetry supports \"development\" dependencies (i.e. dependencies you " +"use for development but not running the code, such as `pytest`), Poetry " "does not yet follow the standardised format for specifying such " "dependencies." msgstr "" +"Poetry は「開発」依存関係 (つまり、「pytest」など、開発には使用するがコードを実行しない依存関係) をサポートしていますが、Poetry" +" はそのような依存関係を指定するための標準化された形式にはまだ準拠していません。" #: ../../package-structure-code/python-package-build-tools.md:419 #, fuzzy msgid "" -"Poetry, by default, pins dependencies using an \"upper bound\" limit " -"(which is specified with the `^` symbol in the legacy format). However, " -"this behavior can be over-written by specifying the dependency when you " -"use `poetry add` as follows: `poetry add \"requests>=2.1\"` See breakout " -"below for more discussion on issues surrounding upper-bounds pinning." +"Poetry, by default, pins dependencies using an \"upper bound\" limit (which" +" is specified with the `^` symbol in the legacy format). However, this " +"behavior can be over-written by specifying the dependency when you use " +"`poetry add` as follows: `poetry add \"requests>=2.1\"` See breakout below " +"for more discussion on issues surrounding upper-bounds pinning." msgstr "" -"Poetryは、デフォルトでは、`^`シンボルで指定された \"上限\" 制限を使用して依存関係をピンします。 しかし、この動作は `Poetry" -" add` を使うときに依存関係を以下のように指定することで上書きすることができます: `poetry add " -"\"requests>=2.1\"` アッパーバウンドピニングをめぐる問題については、以下のブレイクアウトを参照のしてください。" +"Poetryは、デフォルトでは、`^`シンボルで指定された \"上限\" 制限を使用して依存関係をピンします。 しかし、この動作は `Poetry " +"add` を使うときに依存関係を以下のように指定することで上書きすることができます: `poetry add \"requests>=2.1\"` " +"アッパーバウンドピニングをめぐる問題については、以下のブレイクアウトを参照のしてください。" #: ../../package-structure-code/python-package-build-tools.md:421 #, fuzzy @@ -4501,12 +4983,12 @@ msgstr "Poetry依存のピン留めの課題" #: ../../package-structure-code/python-package-build-tools.md:429 msgid "" -"By default, Poetry pins dependencies using `^` by default. This `^` " -"symbol means that there is an \"upper bound\" to the dependency. Thus " -"poetry won't bump a dependency version to a new major version. Thus, if " -"your package uses a dependency that is at version 1.2.3, Poetry will " -"never bump the dependency to 2.0 even if there is a new major version of " -"the package. Poetry will instead bump up to 1.9.x." +"By default, Poetry pins dependencies using `^` by default. This `^` symbol " +"means that there is an \"upper bound\" to the dependency. Thus poetry won't" +" bump a dependency version to a new major version. Thus, if your package " +"uses a dependency that is at version 1.2.3, Poetry will never bump the " +"dependency to 2.0 even if there is a new major version of the package. " +"Poetry will instead bump up to 1.9.x." msgstr "" "デフォルトでは、Poetry は `^` を使って依存関係をピン留めします。 このシンボル `^` は依存関係に \"上限\" " "があることを意味します。 従って、poetryは依存バージョンを新しいメジャーバージョンにバンプすることはありません。 " @@ -4516,11 +4998,11 @@ msgstr "" #: ../../package-structure-code/python-package-build-tools.md:435 msgid "" "Poetry does this because it adheres to strict semantic versioning which " -"states that a major version bump (from 1.0 to 2.0 for example) means " -"there are breaking changes in the tool. However, not all tools follow " -"strict semantic versioning. [This approach has been found to be " -"problematic by many of our core scientific " -"packages.](https://iscinumpy.dev/post/bound-version-constraints/)" +"states that a major version bump (from 1.0 to 2.0 for example) means there " +"are breaking changes in the tool. However, not all tools follow strict " +"semantic versioning. [This approach has been found to be problematic by " +"many of our core scientific packages.](https://iscinumpy.dev/post/bound-" +"version-constraints/)" msgstr "" "Poetryは、メジャーバージョンアップ（例えば1.0から2.0へ）は、ツールに破壊的な変更があることを意味するという、厳密なセマンティックバージョニングを遵守しているからです。" " しかし、すべてのツールが厳密なセマンティックバージョニングに従っているわけではありません。 " @@ -4545,14 +5027,14 @@ msgid "" "Python packaging build tool with [development dating back to 2009 and " "earlier](https://setuptools.pypa.io/en/latest/history.html#). Setuptools " "also has the largest number of community users (according to the PyPA " -"survey). Setuptools does not offer a user front-end like Flit, Poetry and" -" Hatch offer. As such you will need to use other tools such as **build** " -"to create your package distributions and **twine** to publish to PyPI." +"survey). Setuptools does not offer a user front-end like Flit, Poetry and " +"Hatch offer. As such you will need to use other tools such as **build** to " +"create your package distributions and **twine** to publish to PyPI." msgstr "" "[Setuptools](https://setuptools.pypa.io/en/latest/)は最も成熟したPythonパッケージングビルドツールで、[開発は2009年以前にさかのぼります](https://setuptools.pypa.io/en/latest/history.html#)。" " また、（PyPAの調査によると）Setuptoolsは最も多くのコミュニティユーザを抱えています。 " -"Setuptoolsは、Flit、Poetry、Hatchのようなユーザーフロントエンドを提供していません。そのため、パッケージの配布を作成するには" -" **build** を、PyPI に公開するには **twine** などの他のツールを使用する必要があります。" +"Setuptoolsは、Flit、Poetry、Hatchのようなユーザーフロントエンドを提供していません。そのため、パッケージの配布を作成するには " +"**build** を、PyPI に公開するには **twine** などの他のツールを使用する必要があります。" #: ../../package-structure-code/python-package-build-tools.md:455 msgid "" @@ -4563,8 +5045,8 @@ msgstr "setuptoolsは最もよく使われるツールですが、パッケー #: ../../package-structure-code/python-package-build-tools.md:458 msgid "" -"We discuss setuptools here because it's commonly found in the ecosystem " -"and contributors may benefit from understanding it." +"We discuss setuptools here because it's commonly found in the ecosystem and" +" contributors may benefit from understanding it." msgstr "ここでsetuptoolsについて説明するのは、それがエコシステムでよく見られるものであり、貢献者がそれを理解することで恩恵を受けるかもしれないからです。" #: ../../package-structure-code/python-package-build-tools.md:461 @@ -4585,9 +5067,7 @@ msgid "Many scientific Python packages use it." msgstr "多くの科学的Pythonパッケージがこれを使用しています。" #: ../../package-structure-code/python-package-build-tools.md:467 -msgid "" -"It offers version control based package versioning using " -"**setuptools_scm**" +msgid "It offers version control based package versioning using **setuptools_scm**" msgstr "**setuptools_scm** を使用したバージョン管理ベースのパッケージのバージョン管理を提供します。" #: ../../package-structure-code/python-package-build-tools.md:468 @@ -4609,33 +5089,32 @@ msgstr "Setuptoolsにはいくつかの課題があります:" #: ../../package-structure-code/python-package-build-tools.md:477 msgid "" "Setuptools does not support interactive features such as auto / tab " -"completion by default if you are working in an IDE like VSCODE and using " -"an editable install for development. [See notes here about pylance " +"completion by default if you are working in an IDE like VSCODE and using an" +" editable install for development. [See notes here about pylance " "support](https://github.com/microsoft/pylance-" -"release/blob/main/TROUBLESHOOTING.md#editable-install-modules-not-found)." -" In comparison, tools such as flit, hatch, PDM support interactive " -"features such as tab / auto completion when using an IDE like VSCODE or " -"pycharm (as long as your version of pip is current!)." +"release/blob/main/TROUBLESHOOTING.md#editable-install-modules-not-found). " +"In comparison, tools such as flit, hatch, PDM support interactive features " +"such as tab / auto completion when using an IDE like VSCODE or pycharm (as " +"long as your version of pip is current!)." msgstr "" "Setuptoolsは、VSCODEのようなIDEで作業し、編集可能なインストーラを開発に使用している場合、デフォルトでは自動/タブ補完のようなインタラクティブな機能をサポートしていません。" " [pylanceのサポートについてはこちらを参照](https://github.com/microsoft/pylance-" -"release/blob/main/TROUBLESHOOTING.md#editable-install-modules-not-found) " -"。 " +"release/blob/main/TROUBLESHOOTING.md#editable-install-modules-not-found) 。 " "それに比べて、flit、hatch、PDMのようなツールは、VSCODEやpycharmのようなIDE（pipのバージョンが最新である限り!）を使っているときに、タブや自動補完のようなインタラクティブな機能をサポートしています。" #: ../../package-structure-code/python-package-build-tools.md:478 msgid "" "Because **setuptools** has to maintain backwards compatibility across a " -"range of packages, it is not as flexible in its adoption of modern Python" -" packaging standards." +"range of packages, it is not as flexible in its adoption of modern Python " +"packaging standards." msgstr "" "**setuptools** " "は様々なパッケージの後方互換性を維持しなければならないため、最新のPythonパッケージング標準を採用する柔軟性がありません。" #: ../../package-structure-code/python-package-build-tools.md:481 msgid "" -"The above-mentioned backwards compatibility makes for a more complex " -"code-base." +"The above-mentioned backwards compatibility makes for a more complex code-" +"base." msgstr "上記の後方互換性は、より複雑なコードベースとなります。" #: ../../package-structure-code/python-package-build-tools.md:482 @@ -4646,8 +5125,8 @@ msgstr "このページで説明する他のツールに比べ、setuptoolsを #: ../../package-structure-code/python-package-build-tools.md:484 msgid "" -"There are also some problematic default settings that users should be " -"aware of when using setuptools. For instance:" +"There are also some problematic default settings that users should be aware" +" of when using setuptools. For instance:" msgstr "また、setuptoolsを使用する際にユーザーが注意すべき、問題のあるデフォルト設定がいくつかあります。 例えば:" #: ../../package-structure-code/python-package-build-tools.md:487 @@ -4660,9 +5139,9 @@ msgstr "" #: ../../package-structure-code/python-package-build-tools.md:489 msgid "" -"setuptools also will include all of the files in your package repository " -"if you do not explicitly tell it to exclude files using a **MANIFEST.in**" -" file" +"setuptools also will include all of the files in your package repository if" +" you do not explicitly tell it to exclude files using a **MANIFEST.in** " +"file" msgstr "" "setuptoolsは、 **MANIFEST.in** " "ファイルを使ってファイルを除外するように明示的に指示しなければ、パッケージリポジトリ内のすべてのファイルも含めます。" @@ -4673,11 +5152,11 @@ msgstr "Pythonパッケージのビルドについて学ぶ" #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:8 msgid "" -"Once you have published both package distributions (the source " -"distribution and the wheel) to PyPI, you can then publish to conda-forge." -" The conda-forge requires an source distribution on PyPI in order to " -"build your package on conda-forge. You do not need to rebuild your " -"package to publish to conda-forge." +"Once you have published both package distributions (the source distribution" +" and the wheel) to PyPI, you can then publish to conda-forge. The conda-" +"forge requires an source distribution on PyPI in order to build your " +"package on conda-forge. You do not need to rebuild your package to publish " +"to conda-forge." msgstr "" "両方のパッケージ配布(ソース配布とホイール)をPyPIに公開したら、次にconda-forgeに公開します。conda-" "forgeでパッケージをビルドするには、PyPIでのソース配布が必要です。conda-" @@ -4685,12 +5164,11 @@ msgstr "" #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:11 msgid "" -"You need to build your Python package in order to publish it to PyPI (or " -"a conda channel). The build process organizes your code and metadata into" -" a distribution format that can be uploaded to PyPI and subsequently " +"You need to build your Python package in order to publish it to PyPI (or a " +"conda channel). The build process organizes your code and metadata into a " +"distribution format that can be uploaded to PyPI and subsequently " "downloaded and installed by users. NOTE: you need to publish a sdist to " -"PyPI in order for conda-forge to properly build your package " -"automatically." +"PyPI in order for conda-forge to properly build your package automatically." msgstr "" "PythonパッケージをPyPI（またはcondaチャンネル）に公開するには、ビルドする必要があります。ビルドプロセスは、あなたのコードとメタデータをPyPIにアップロードできる配布フォーマットに整理し、その後ユーザーがダウンロードしてインストールできるようにします。" " 注意: conda-forgeが適切にパッケージを自動ビルドするためには、sdistをPyPIに公開する必要があります。" @@ -4713,11 +5191,11 @@ msgstr "しかし、Pythonのパッケージを作るとは何ですか？" #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:20 msgid "" -"[As shown in the figure above](#pypi-conda-channels), when you build your" -" Python package, you convert the source files into something called a " -"distribution package. A distribution package contains your source code " -"and metadata about the package, in the format required by the Python " -"Package Index, so that it can be installed by tools like pip." +"[As shown in the figure above](#pypi-conda-channels), when you build your " +"Python package, you convert the source files into something called a " +"distribution package. A distribution package contains your source code and " +"metadata about the package, in the format required by the Python Package " +"Index, so that it can be installed by tools like pip." msgstr "" "[上の図のように](#pypi-conda-channels), " "Pythonパッケージをビルドするとき、ソースファイルをディストリビューションパッケージと呼ばれるものに変換します。 " @@ -4726,18 +5204,18 @@ msgstr "" #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:23 msgid "" "The term package used to mean many different things in Python and other " -"languages. On this page, we adapt the convention of the [Python Packaging" -" Authority](https://www.pypa.io/en/latest/) and refer to the product of " -"the build step as a **distribution package**." +"languages. On this page, we adapt the convention of the [Python Packaging " +"Authority](https://www.pypa.io/en/latest/) and refer to the product of the " +"build step as a **distribution package**." msgstr "" "Pythonや他の言語では、パッケージという言葉は様々な意味で使われています。 このページでは、　[Python Packaging " -"Authority](https://www.pypa.io/en/latest/) の慣例に合わせ、ビルドステップの成果物を " -"**配布パッケージ** と呼ぶことにします。" +"Authority](https://www.pypa.io/en/latest/) の慣例に合わせ、ビルドステップの成果物を **配布パッケージ**" +" と呼ぶことにします。" #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:27 msgid "" -"This process of organizing and formatting your code, documentation, tests" -" and metadata into a format that both pip and PyPI can use, is called a " +"This process of organizing and formatting your code, documentation, tests " +"and metadata into a format that both pip and PyPI can use, is called a " "build step." msgstr "あなたのコード、ドキュメント、テスト、メタデータをpipとPyPIの両方が使える形式に整理し、フォーマットするこのプロセスは、ビルドステップと呼ばれます。" @@ -4747,21 +5225,19 @@ msgstr "プロジェクトのメタデータとPyPI" #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:33 msgid "" -"The metadata that both build tools and PyPI uses to describe and " -"understand your package is generally stored in a [pyproject.toml file" -"](pyproject-toml-python-package-metadata). This metadata is used for " -"several purposes:" +"The metadata that both build tools and PyPI uses to describe and understand" +" your package is generally stored in a [pyproject.toml file](pyproject-" +"toml-python-package-metadata). This metadata is used for several purposes:" msgstr "" "ビルドツールとPyPIの両方があなたのパッケージを説明し理解するために使うメタデータは、一般的に [pyproject.tomlファイル" -"](pyproject-toml-python-package-metadata) に格納されます。 " -"このメタデータはいくつかの目的で使用されます:" +"](pyproject-toml-python-package-metadata) に格納されます。 このメタデータはいくつかの目的で使用されます:" #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:35 msgid "" "It helps whatever tool you use to build your package (pip, [pypa's " "Build](https://pypi.org/project/build/) or an end-to-end tool such as " -"poetry, PDM or Hatch) understand how to build your package. Information " -"it provides to your build tool includes:" +"poetry, PDM or Hatch) understand how to build your package. Information it " +"provides to your build tool includes:" msgstr "" "パッケージのビルドに使用するツール(pip、 [pypa's Build](https://pypi.org/project/build/) " "、またはpoetry、PDM、Hatchのようなエンドツーエンドツール)があなたのパッケージのビルド方法を理解するのに役立ちます。ビルドツールに提供される情報には以下のものがあります:" @@ -4772,21 +5248,20 @@ msgid "" "[build backend tool](build_backends) you wish to use for creating your " "sdist and wheel distributions." msgstr "" -"pyproject.tomlファイルの `[build-system]` " -"テーブルは、sdistとwheelディストリビューションの作成に使用したい [ビルドバックエンドツール](build_backends) " -"をpipに伝えます。" +"pyproject.tomlファイルの `[build-system]` テーブルは、sdistとwheelディストリビューションの作成に使用したい " +"[ビルドバックエンドツール](build_backends) をpipに伝えます。" #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:45 msgid "" -"And the dependencies section of your project table tells the build tool " -"and PyPI what dependencies your project requires." +"And the dependencies section of your project table tells the build tool and" +" PyPI what dependencies your project requires." msgstr "また、プロジェクトテーブルの dependencies セクションは、ビルドツールと PyPI にプロジェクトが必要とする依存関係を伝えます。" #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:54 msgid "" -"When the build tool creates your package distribution file (the file that" -" you publish on PyPI), it also creates a METADATA file which PyPI can " -"read and use to help users find your package. For example:" +"When the build tool creates your package distribution file (the file that " +"you publish on PyPI), it also creates a METADATA file which PyPI can read " +"and use to help users find your package. For example:" msgstr "" "ビルドツールがパッケージ配布ファイル（PyPIで公開するファイル）を作成するとき、PyPIが読み込んでユーザがあなたのパッケージを見つけるのに役立つMETADATAファイルも作成します。" " 例えば:" @@ -4796,8 +5271,8 @@ msgstr "" msgid "" "The `classifiers = ` section of your `[project]` table in the " "pyproject.toml file provides information that users on PyPI can use to " -"filter for packages that address different topics or that support " -"specific versions of python." +"filter for packages that address different topics or that support specific " +"versions of python." msgstr "" "pyproject.tomlファイルの `[project]` テーブルの `classifiers = ` " "セクションは、PyPIのユーザが特定のライセンスを含むパッケージや特定のバージョンのpythonをサポートするパッケージをフィルタリングするための情報を提供します。" @@ -4808,15 +5283,14 @@ msgstr "メタデータのsetup.pyとsetup.cfgはどうなったのですか？" #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:75 msgid "" -"Project metadata used to be stored in either a setup.py file or a " -"setup.cfg file. The current recommended practice for storing package " -"metadata is to use a pyproject.toml file. [Learn more about the " -"pyproject.toml file here.](pyproject-toml-python-package-metadata)" +"Project metadata used to be stored in either a setup.py file or a setup.cfg" +" file. The current recommended practice for storing package metadata is to " +"use a pyproject.toml file. [Learn more about the pyproject.toml file here" +".](pyproject-toml-python-package-metadata)" msgstr "" "プロジェクトのメタデータは、以前は setup.py ファイルか setup.cfg " "ファイルに保存されていました。パッケージのメタデータを保存するために現在推奨されている方法は、pyproject.tomlファイルを使用することです。" -" [pyproject.tomlファイルについての詳細はこちらです。](pyproject-toml-python-package-" -"metadata)" +" [pyproject.tomlファイルについての詳細はこちらです。](pyproject-toml-python-package-metadata)" #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:78 msgid "An example - xclim" @@ -4825,16 +5299,16 @@ msgstr "例 - xclim" #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:80 msgid "" "When you publish to PyPI, you will notice that each package has metadata " -"listed. Let's have a look at [xclim](https://pypi.org/project/xclim/), " -"one of our [pyOpenSci packages](https://www.pyopensci.org/python-" -"packages.html). Notice that on the PyPI landing page you see some " -"metadata about the package including python, maintainer information and " -"more. PyPI is able to populate this metadata because it was defined using" -" correct syntax and classifiers by Xclim's maintainers, [pyproject.toml " -"file](https://github.com/Ouranosinc/xclim/blob/master/pyproject.toml). " -"This metadata when the xclim package is built, is translated into a " -"distribution file that allows PyPI to read the metadata and print it out " -"on their website." +"listed. Let's have a look at [xclim](https://pypi.org/project/xclim/), one " +"of our [pyOpenSci packages](https://www.pyopensci.org/python-" +"packages.html). Notice that on the PyPI landing page you see some metadata " +"about the package including python, maintainer information and more. PyPI " +"is able to populate this metadata because it was defined using correct " +"syntax and classifiers by Xclim's maintainers, [pyproject.toml " +"file](https://github.com/Ouranosinc/xclim/blob/master/pyproject.toml). This" +" metadata when the xclim package is built, is translated into a " +"distribution file that allows PyPI to read the metadata and print it out on" +" their website." msgstr "" "PyPIに公開すると、各パッケージにメタデータがリストされていることに気づくでしょう。[pyOpenSciパッケージ](https://www.pyopensci.org" "/python-packages.html) の一つである [xclim](https://pypi.org/project/xclim/) " @@ -4846,13 +5320,13 @@ msgstr "" #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:93 msgid "" "Graphic showing the high level packaging workflow. On the left you see a " -"graphic with code, metadata and tests in it. Those items all go into your" -" package. Documentation and data are below that box because they aren't " +"graphic with code, metadata and tests in it. Those items all go into your " +"package. Documentation and data are below that box because they aren't " "normally published in your packaging wheel distribution. An arrow to the " "right takes you to a build distribution files box. That box leads you to " "either publishing to TestPyPI or the real PyPI. From PyPI you can then " -"connect to conda-forge for an automated build that sends distributions " -"from PyPI to conda-forge." +"connect to conda-forge for an automated build that sends distributions from" +" PyPI to conda-forge." msgstr "" "ハイレベルなパッケージングのワークフローを示すグラフィックです。左側には、コード、メタデータ、テストが入ったグラフィックがあります。ドキュメンテーションやデータは、通常、パッケージホイールの配布物には掲載されないため、そのボックスの下にあります。右の矢印は、ビルド配布ファイルのボックスに移動します。このボックスは、TestPyPIか本物のPyPIのどちらかに公開するように導きます" "。PyPIからconda-forgeに接続し、ディストリビューションをPyPIからconda-forgeに送る自動ビルドを行うことができます。" @@ -4863,18 +5337,17 @@ msgid "" "Conda). The build process organizes your code and metadata into a " "distribution format that can be uploaded to PyPI and subsequently " "downloaded and installed by users. NOTE: you need to publish a sdist to " -"PyPI in order for conda-forge to properly build your package " -"automatically." +"PyPI in order for conda-forge to properly build your package automatically." msgstr "" "PythonパッケージをPyPI（またはConda）に公開するには、ビルドする必要があります。ビルドプロセスは、あなたのコードとメタデータをPyPIにアップロードできる配布フォーマットに整理し、その後ユーザーがダウンロードしてインストールできるようにします。" " 注意: conda-forgeが適切にパッケージを自動ビルドするためには、sdistをPyPIに公開する必要があります。" #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:100 msgid "" -"This screenshot shows the metadata on PyPI for the xclim package. On it " -"you can see the name of the license, the author and maintainer names " -"keywords associated with the package and the base python version it " -"requires which is 3.8." +"This screenshot shows the metadata on PyPI for the xclim package. On it you" +" can see the name of the license, the author and maintainer names keywords " +"associated with the package and the base python version it requires which " +"is 3.8." msgstr "このスクリーンショットは、PyPI上のxclimパッケージのメタデータを示しています。そこには、ライセンスの名前、そのパッケージに関連する作者とメンテナの名前のキーワード、そしてそのパッケージが必要とするpythonの基本バージョン3.8が表示されています。" #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:102 @@ -4883,17 +5356,17 @@ msgstr "xclimパッケージのメタデータを示すPyPIのスクリーンシ #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:109 msgid "" -"Here you see the maintainer metadata as it is displayed on PyPI. For " -"xclim there are three maintainers listed with their profile pictures and " -"github user names to the right." +"Here you see the maintainer metadata as it is displayed on PyPI. For xclim " +"there are three maintainers listed with their profile pictures and github " +"user names to the right." msgstr "ここでは、PyPIに表示されているメインテナメタデータを見ることができます。xclimの場合、3人のメンテナがリストアップされており、右側にプロフィール写真とgithubユーザー名が表示されています。" #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:111 msgid "" "Maintainer names and GitHub usernames for the xclim package as they are " -"displayed on PyPI. This information is recorded in your pyproject.toml " -"and then processed by your build tool and stored in your packages sdist " -"and wheel distributions." +"displayed on PyPI. This information is recorded in your pyproject.toml and " +"then processed by your build tool and stored in your packages sdist and " +"wheel distributions." msgstr "" "PyPI に表示されている xclim パッケージのメンテナ名と GitHub ユーザ名。 " "この情報はpyproject.tomlに記録され、ビルドツールで処理され、パッケージのsdistとwheelディストリビューションに保存されます。" @@ -4904,11 +5377,11 @@ msgstr "PyPIやPipが期待する配布フォーマットを作るには？" #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:116 msgid "" -"You could in theory create your own scripts to organize your code the way" -" PyPI wants it to be. However, just like there are packages that handle " -"known structures such as Pandas for data frames and Numpy for arrays, " -"there are packages and tools that help you create package build " -"distribution files." +"You could in theory create your own scripts to organize your code the way " +"PyPI wants it to be. However, just like there are packages that handle " +"known structures such as Pandas for data frames and Numpy for arrays, there" +" are packages and tools that help you create package build distribution " +"files." msgstr "" "理論的には、PyPIが望むようにコードを整理する独自のスクリプトを作成することができます。 " "しかし、データフレーム用のPandasや配列用のNumpyのような既知の構造を扱うパッケージがあるように、パッケージのビルド配布ファイルの作成を支援するパッケージやツールがあります。" @@ -4918,8 +5391,8 @@ msgid "" "There are a suite of packaging tools that can either help you with the " "entire packaging process or just one step of the process. For instance " "setuptools is a commonly used build back end that can be used to create " -"your sdist and wheel. Whereas tools like Hatch, PDM, Poetry and flit help" -" with other parts of the packaging process." +"your sdist and wheel. Whereas tools like Hatch, PDM, Poetry and flit help " +"with other parts of the packaging process." msgstr "" "パッケージングツールには、パッケージングプロセス全体を支援するものもあれば、プロセスの1ステップだけを支援するものもあります。 " "例えばsetuptoolsはよく使われるビルドバックエンドで、sdistやwheelの作成に使うことができます。 " @@ -4929,8 +5402,8 @@ msgstr "" msgid "" "While this can cause some confusion and complexity in the packaging " "ecosystem - for the most part, each tool provides the same distribution " -"output (with minor differences that most users may not care about). Learn" -" more about those tools on this page." +"output (with minor differences that most users may not care about). Learn " +"more about those tools on this page." msgstr "" "これは、パッケージングエコシステムに混乱と複雑さをもたらす可能性がありますが、ほとんどの場合、各ツールは同じ配布出力を提供します（ほとんどのユーザーが気にしないような小さな違いはあります）。" " これらのツールの詳細については、このページを参照してください。" @@ -4938,8 +5411,8 @@ msgstr "" #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:132 msgid "" "Below, you will learn about the two distribution files that PyPI expects " -"you to publish: sdist and wheel. You will learn about their structure and" -" what files belong in each." +"you to publish: sdist and wheel. You will learn about their structure and " +"what files belong in each." msgstr "" "以下では、PyPIが公開することを期待している2つの配布ファイル、sdistとwheelについて学びます。 " "sdistとwheelです。それぞれの構造と、どのようなファイルがあるのかについて学びます。" @@ -4947,10 +5420,10 @@ msgstr "" #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:135 msgid "" "There are two core distribution files that you need to create to publish " -"your Python package to PyPI source distribution (often called an sdist) " -"and wheel. The sdist contains the raw source code for your package. The " -"wheel (.whl) contains the built / compiled files that can be directly " -"installed onto anyones' computer." +"your Python package to PyPI source distribution (often called an sdist) and" +" wheel. The sdist contains the raw source code for your package. The wheel " +"(.whl) contains the built / compiled files that can be directly installed " +"onto anyones' computer." msgstr "" "PythonパッケージをPyPIに公開するために作成する必要がある配布ファイルは、ソース配布(sdist)とwheelの2つです。 " "sdistにはパッケージの生のソースコードが含まれています。 " @@ -4963,10 +5436,9 @@ msgstr "両ディストリビューションの詳細は以下の通りです。 #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:144 msgid "" "If your package is a pure python package with no additional build / " -"compilation steps then the sdist and wheel distributions will have " -"similar content. However if your package has extensions in other " -"languages or is more complex in its build, the two distributions will be " -"very different." +"compilation steps then the sdist and wheel distributions will have similar " +"content. However if your package has extensions in other languages or is " +"more complex in its build, the two distributions will be very different." msgstr "" "もし、あなたのパッケージが追加のビルド/コンパイルステップのない純粋なpythonパッケージであれば、sdistとwheelのディストリビューションは似たような内容になるでしょう。" " " @@ -4975,8 +5447,8 @@ msgstr "" #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:149 #, fuzzy msgid "" -"Also note that we are not discussing conda build workflows in this " -"section. [You can learn more about conda builds " +"Also note that we are not discussing conda build workflows in this section." +" [You can learn more about conda builds " "here.](https://docs.conda.io/projects/conda-build/en/latest/user-" "guide/tutorials/index.html)" msgstr "" @@ -4990,9 +5462,9 @@ msgstr "ソースディストリビューションとは (sdist)" #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:156 msgid "" -"**Source files** are the unbuilt files needed to build your package. " -"These are the \"raw / as-is\" files that you store on GitHub or whatever " -"platform you use to manage your code." +"**Source files** are the unbuilt files needed to build your package. These " +"are the \"raw / as-is\" files that you store on GitHub or whatever platform" +" you use to manage your code." msgstr "" "**ソースファイル** は、パッケージをビルドするために必要な、ビルドされていないファイルです。 " "これらは、GitHubやあなたがコードを管理するために使っているプラットフォームに保存する \"raw / as-is\" ファイルです。" @@ -5002,8 +5474,8 @@ msgid "" "Source Distributions (**S** + **Dist**) are referred to as sdist. As the " "name implies, a SDIST contains the source code; it has not been built or " "compiled in any way. Thus, when a user installs your source distribution " -"using pip, pip needs to run a build step first. For this reason, you " -"could define a source distribution as a compressed archive that contains " +"using pip, pip needs to run a build step first. For this reason, you could " +"define a source distribution as a compressed archive that contains " "everything required to build a wheel (except for project dependencies) " "without network access." msgstr "" @@ -5018,9 +5490,8 @@ msgid "" "\"tarball\"). Thus, when a user installs your source distribution using " "pip, pip needs to run a build step first." msgstr "" -"Sdist は通常、 `.tar.gz` アーカイブ (しばしば \"tarball\" と呼ばれます) として保存されます。 " -"そのため、ユーザーが pip を使用してソースディストリビューションをインストールする場合、pip " -"は最初にビルドステップを実行する必要があります。" +"Sdist は通常、 `.tar.gz` アーカイブ (しばしば \"tarball\" と呼ばれます) として保存されます。 そのため、ユーザーが " +"pip を使用してソースディストリビューションをインストールする場合、pip は最初にビルドステップを実行する必要があります。" #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:166 msgid "Below is an example sdist for the stravalib Python package:" @@ -5032,12 +5503,11 @@ msgstr "GitHubアーカイブとsdistの比較" #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:220 msgid "" -"When you make a release on GitHub, it creates a `git archive` that " -"contains all of the files in your GitHub repository. While these files " -"are similar to an sdist, these two archives are not the same. The sdist " -"contains a few other items including a metadata directory and if you use " -"`setuptools_scm` or `hatch_vcs` the sdist may also contain a file that " -"stores the version." +"When you make a release on GitHub, it creates a `git archive` that contains" +" all of the files in your GitHub repository. While these files are similar " +"to an sdist, these two archives are not the same. The sdist contains a few " +"other items including a metadata directory and if you use `setuptools_scm` " +"or `hatch_vcs` the sdist may also contain a file that stores the version." msgstr "" "GitHub でリリースを作成すると、GitHub リポジトリ内のすべてのファイルを含む `git archive` " "が作成されます。これらのファイルはsdistと似ているが、これら2つのアーカイブは同じではない。sdistには、メタデータ・ディレクトリーや、 " @@ -5050,11 +5520,11 @@ msgstr "Python wheel (whl)とは何ですか？" #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:230 msgid "" "A wheel file is a ZIP-format archive whose filename follows a specific " -"format (below) and has the extension `.whl`. The `.whl` archive contains " -"a specific set of files, including metadata that are generated from your " -"project's pyproject.toml file. The pyproject.toml and other files that " -"may be included in source distributions are not included in wheels " -"because it is a built distribution." +"format (below) and has the extension `.whl`. The `.whl` archive contains a " +"specific set of files, including metadata that are generated from your " +"project's pyproject.toml file. The pyproject.toml and other files that may " +"be included in source distributions are not included in wheels because it " +"is a built distribution." msgstr "" "ホイールファイルはZIP形式のアーカイブで、ファイル名は特定のフォーマット（下記）に従い、拡張子は `.whl` です。 `.whl` " "アーカイブには、プロジェクトのpyproject.tomlファイルから生成されたメタデータを含む特定のファイル群が含まれています。 " @@ -5063,24 +5533,23 @@ msgstr "" #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:237 msgid "" "The wheel (.whl) is your built binary distribution. **Binary files** are " -"the built / compiled source files. These files are ready to be installed." -" A wheel (**.whl**) is a **zip** file containing all of the files needed " -"to directly install your package. All of the files in a wheel are " -"binaries - this means that code is already compiled / built. Wheels are " -"thus faster to install - particularly if you have a package that requires" -" build steps." +"the built / compiled source files. These files are ready to be installed. A" +" wheel (**.whl**) is a **zip** file containing all of the files needed to " +"directly install your package. All of the files in a wheel are binaries - " +"this means that code is already compiled / built. Wheels are thus faster to" +" install - particularly if you have a package that requires build steps." msgstr "" "wheel（.whl）は、ビルドされたバイナリーディストリビューションです。 **バイナリファイル** " "は、ビルド/コンパイルされたソースファイルです。 これらのファイルはすぐにインストールできます。 wheel (**.whl**) " "は、パッケージを直接インストールするために必要な すべてのファイルを含む **zip** ファイルです。 " -"wheelに含まれるファイルはすべてバイナリで、これはコードがすでにコンパイル/ビルドされていることを意味します。 " -"wheelの取り付けがより迅速に - 特にビルド・ステップが必要なパッケージの場合はそうなります。" +"wheelに含まれるファイルはすべてバイナリで、これはコードがすでにコンパイル/ビルドされていることを意味します。 wheelの取り付けがより迅速に " +"- 特にビルド・ステップが必要なパッケージの場合はそうなります。" #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:239 msgid "" -"The wheel does not contain any of your package's configuration files such" -" as **setup.cfg** or **pyproject.toml**. This distribution is already " -"built so it's ready to install." +"The wheel does not contain any of your package's configuration files such " +"as **setup.cfg** or **pyproject.toml**. This distribution is already built " +"so it's ready to install." msgstr "" "ホイールには、**setup.cfg** や **pyproject.toml** のようなパッケージの設定ファイルは含まれていません。 " "このディストリビューションはすでにビルドされていますので、すぐにインストールできます。" @@ -5095,10 +5564,10 @@ msgstr "" #: ../../package-structure-code/python-package-distribution-files-sdist-wheel.md:251 msgid "" -"Wheels are also useful in the case that a package needs a **setup.py** " -"file to support a more complex build. In this case, because the files in " -"the wheel bundle are pre built, the user installing doesn't have to worry" -" about malicious code injections when it is installed." +"Wheels are also useful in the case that a package needs a **setup.py** file" +" to support a more complex build. In this case, because the files in the " +"wheel bundle are pre built, the user installing doesn't have to worry about" +" malicious code injections when it is installed." msgstr "" "ウィールは、パッケージがより複雑なビルドをサポートするために **setup.py** ファイルを必要とする場合にも便利です。 " "この場合、wheelバンドルのファイルはあらかじめビルドされているので、インストールするユーザはインストール時に悪意のあるコードインジェクションを心配する必要がありません。" @@ -5163,14 +5632,14 @@ msgstr "" #: ../../package-structure-code/python-package-structure.md:8 msgid "" -"We strongly suggest, but do not require, that you use the **src/** layout" -" (discussed below) for creating your Python package. This layout is also " +"We strongly suggest, but do not require, that you use the **src/** layout " +"(discussed below) for creating your Python package. This layout is also " "recommended in the [PyPA packaging guide " "tutorial](https://packaging.python.org/en/latest/tutorials/packaging-" "projects/)." msgstr "" -"Python パッケージの作成には **src/** レイアウト (後述) を使うことを強く推奨しますが、必須ではありません。 このレイアウトは、" -" [PyPA packaging guide " +"Python パッケージの作成には **src/** レイアウト (後述) を使うことを強く推奨しますが、必須ではありません。 このレイアウトは、 " +"[PyPA packaging guide " "tutorial](https://packaging.python.org/en/latest/tutorials/packaging-" "projects/) でも推奨されています。" @@ -5186,10 +5655,10 @@ msgstr "新しいレイアウトに移行することは、既存のメンテナ #: ../../package-structure-code/python-package-structure.md:18 msgid "" -"The overview on this page presents recommendations that we think are best" -" for someone getting started with Python packaging or someone who's " -"package has a simple build and might be open to moving to a more fail-" -"proof approach." +"The overview on this page presents recommendations that we think are best " +"for someone getting started with Python packaging or someone who's package " +"has a simple build and might be open to moving to a more fail-proof " +"approach." msgstr "" "このページの概要では、これから Python " "のパッケージングを始める人や、パッケージがシンプルなビルドで、より失敗のないアプローチに移行することに前向きな人に最適だと思われる推奨事項を紹介します。" @@ -5201,8 +5670,8 @@ msgstr "他のリソースもチェックできます:" #: ../../package-structure-code/python-package-structure.md:24 msgid "" "[PyPA's overview of src vs flat " -"layouts](https://packaging.python.org/en/latest/discussions/src-layout-" -"vs-flat-layout/)" +"layouts](https://packaging.python.org/en/latest/discussions/src-layout-vs-" +"flat-layout/)" msgstr "" "[PyPAによるsrcレイアウトとフラットレイアウトの概要](https://packaging.python.org/en/latest/discussions" "/src-layout-vs-flat-layout/)" @@ -5211,14 +5680,10 @@ msgstr "" msgid "" "You can use tools like Hatch to quickly create a modern Python package " "structure. Check out our quickstart tutorial:" -msgstr "" -"Hatch のようなツールを使って、最新の Python パッケージ構造を素早く作成することができます。 " -"クイックスタートチュートリアルをご覧ください:" +msgstr "Hatch のようなツールを使って、最新の Python パッケージ構造を素早く作成することができます。 クイックスタートチュートリアルをご覧ください:" #: ../../package-structure-code/python-package-structure.md:29 -msgid "" -"Want to learn how to create the structure to build your package? Click " -"here." +msgid "Want to learn how to create the structure to build your package? Click here." msgstr "パッケージを構築するための仕組み作りを学びたいですか？ こちらをクリックしてください。" #: ../../package-structure-code/python-package-structure.md:38 @@ -5236,8 +5701,8 @@ msgstr "上の例では、以下のディレクトリの位置に注意してく #: ../../package-structure-code/python-package-structure.md:64 msgid "" "**docs/:** Discussed in our docs chapter, this directory contains your " -"user-facing documentation website. In a **src/** layout docs/ are " -"normally included at the same directory level as the **src/** folder." +"user-facing documentation website. In a **src/** layout docs/ are normally " +"included at the same directory level as the **src/** folder." msgstr "" "**docs/:** docsの章で説明したように、このディレクトリにはユーザー向けのドキュメントサイトが含まれます。 **src/** " "レイアウトでは、通常 docs/ は **src/** フォルダの同じディレクトリレベルに含まれます。" @@ -5245,11 +5710,11 @@ msgstr "" #: ../../package-structure-code/python-package-structure.md:65 msgid "" "**tests/** This directory contains the tests for your project code. In a " -"**src/** layout, tests are normally included at the same directory level " -"as the **src/** folder." +"**src/** layout, tests are normally included at the same directory level as" +" the **src/** folder." msgstr "" -"**tests/** このディレクトリには、プロジェクトコードのテストが含まれます。 **src/** レイアウトでは、テストは通常 " -"**src/** フォルダの同じディレクトリレベルに含まれます。" +"**tests/** このディレクトリには、プロジェクトコードのテストが含まれます。 **src/** レイアウトでは、テストは通常 **src/**" +" フォルダの同じディレクトリレベルに含まれます。" #: ../../package-structure-code/python-package-structure.md:66 msgid "" @@ -5261,12 +5726,12 @@ msgstr "" #: ../../package-structure-code/python-package-structure.md:68 msgid "" -"Also in the above example, notice that all of the core documentation " -"files that pyOpenSci requires live in the root of your project directory." -" These files include:" +"Also in the above example, notice that all of the core documentation files " +"that pyOpenSci requires live in the root of your project directory. These " +"files include:" msgstr "" -"また、上記の例では、pyOpenSciが必要とするすべてのコアドキュメントファイルがプロジェクトディレクトリのルートにあることに注意してください。" -" これらのファイルには以下が含まれています:" +"また、上記の例では、pyOpenSciが必要とするすべてのコアドキュメントファイルがプロジェクトディレクトリのルートにあることに注意してください。 " +"これらのファイルには以下が含まれています:" #: ../../package-structure-code/python-package-structure.md:72 msgid "CHANGELOG.md" @@ -5290,7 +5755,7 @@ msgstr "README.md" #: ../../package-structure-code/python-package-structure.md:80 msgid "Click here to read about our packaging documentation requirements." -msgstr "" +msgstr "パッケージング文書の要件については、ここをクリックしてください。" #: ../../package-structure-code/python-package-structure.md:87 #, fuzzy @@ -5324,63 +5789,75 @@ msgstr "[pandas](https://github.com/pandas-dev/pandas)" #: ../../package-structure-code/python-package-structure.md:98 msgid "The src layout and testing" -msgstr "" +msgstr "ソースのレイアウトとテスト" #: ../../package-structure-code/python-package-structure.md:100 msgid "" "The benefit of using the **src/package** layout is that it ensures tests " -"are run against the installed version of your package rather than the " -"files in your package working directory. If you run your tests on your " -"files rather than the installed version of your package, you may be " -"missing issues that users encounter when your package is installed." +"are run against the installed version of your package rather than the files" +" in your package working directory. If you run your tests on your files " +"rather than the installed version of your package, you may be missing " +"issues that users encounter when your package is installed." msgstr "" +"**src/package** " +"レイアウトを使用する利点は、パッケージの作業ディレクトリ内のファイルではなく、インストールされているバージョンのパッケージに対してテストが確実に実行されることです。インストールされたバージョンのパッケージではなく、ファイルに対してテストを実行すると、パッケージのインストール時にユーザーが遭遇する問題が見逃される可能性があります。" #: ../../package-structure-code/python-package-structure.md:106 msgid "" -"If `tests/` are outside the **src/package** directory, they aren't " -"included in the package's [wheel](python-wheel). This makes your package " -"size slightly smaller, which places a smaller storage burden on PyPI, and" -" makes them faster to fetch." +"If `tests/` are outside the **src/package** directory, they aren't included" +" in the package's [wheel](python-wheel). This makes your package size " +"slightly smaller, which places a smaller storage burden on PyPI, and makes " +"them faster to fetch." msgstr "" +"`tests/` が **src/package** ディレクトリの外にある場合、それらはパッケージの [wheel](python-wheel) " +"には含まれません。これにより、パッケージのサイズがわずかに小さくなり、PyPI にかかるストレージの負担が軽減され、フェッチが速くなります。" #: ../../package-structure-code/python-package-structure.md:108 msgid "" "[Read more about reasons to use the **src/package** " "layout](https://hynek.me/articles/testing-packaging/)" msgstr "" +"[**src/package** レイアウトを使用する理由について詳しく読む](https://hynek.me/articles/testing-" +"packaging/)" #: ../../package-structure-code/python-package-structure.md:110 msgid "How Python discovers and prioritizes importing modules" -msgstr "" +msgstr "Python がモジュールのインポートを検出して優先順位を付ける方法" #: ../../package-structure-code/python-package-structure.md:112 msgid "" -"By default, Python adds a module in your current working directory to the" -" front of the Python module search path." -msgstr "" +"By default, Python adds a module in your current working directory to the " +"front of the Python module search path." +msgstr "デフォルトでは、Python は現在の作業ディレクトリ内のモジュールを Python モジュール検索パスの先頭に追加します。" #: ../../package-structure-code/python-package-structure.md:114 msgid "" -"This means that if you run your tests in your package's working " -"directory, using a flat layout, `/package/module.py`, Python will " -"discover `package/module.py` file before it discovers the installed " -"package." +"This means that if you run your tests in your package's working directory, " +"using a flat layout, `/package/module.py`, Python will discover " +"`package/module.py` file before it discovers the installed package." msgstr "" +"これは、フラット レイアウト `/package/module.py` を使用してパッケージの作業ディレクトリでテストを実行すると、Python " +"はインストールされたパッケージを検出する前に `package/module.py` ファイルを検出することを意味します。" #: ../../package-structure-code/python-package-structure.md:116 msgid "" "However, if your package lives in a src/ directory structure " -"**src/package**, then it won't be added to the Python path by default. " -"This means that when you import your package, Python will be forced to " -"search the active environment (which has your package installed)." +"**src/package**, then it won't be added to the Python path by default. This" +" means that when you import your package, Python will be forced to search " +"the active environment (which has your package installed)." msgstr "" +"ただし、パッケージが src/ ディレクトリ構造 **src/package** に存在する場合、デフォルトでは Python " +"パスに追加されません。これは、パッケージをインポートすると、Python はアクティブな環境 (パッケージがインストールされている環境) " +"を強制的に検索することを意味します。" #: ../../package-structure-code/python-package-structure.md:118 msgid "" "Note: Python versions 3.11 and above have a path setting that can be " -"adjusted to ensure the priority is to use installed packages first (e.g.," -" `PYTHONSAFEPATH`)." +"adjusted to ensure the priority is to use installed packages first (e.g., " +"`PYTHONSAFEPATH`)." msgstr "" +"注: Python バージョン 3.11 以降には、インストールされたパッケージを優先的に使用するように調整できるパス設定があります (例: " +"「PYTHONSAFEPATH」)。" #: ../../package-structure-code/python-package-structure.md:121 #, fuzzy @@ -5389,16 +5866,20 @@ msgstr "**テストスイートのデータセットをパッケージに含め #: ../../package-structure-code/python-package-structure.md:123 msgid "" -"Writing [tests](tests-intro) for your package is important; however, we " -"do not recommend including tests as part of your [package wheel](python-" -"wheel) by default. However, not including tests in your package " -"distribution will make it harder for people other than yourself to test " -"whether your package runs properly on their system. If you have a small " -"test suite (Python files + data), and think your users may want to run " -"tests locally on their systems, you can include tests by moving the " -"`tests/` directory into the **src/package** directory (see example " -"below)." -msgstr "" +"Writing [tests](tests-intro) for your package is important; however, we do " +"not recommend including tests as part of your [package wheel](python-wheel)" +" by default. However, not including tests in your package distribution will" +" make it harder for people other than yourself to test whether your package" +" runs properly on their system. If you have a small test suite (Python " +"files + data), and think your users may want to run tests locally on their " +"systems, you can include tests by moving the `tests/` directory into the " +"**src/package** directory (see example below)." +msgstr "" +"パッケージに [tests](tests-intro) を記述することは重要です。ただし、デフォルトで [パッケージ ホイール](python-" +"wheel) " +"の一部としてテストを含めることはお勧めしません。ただし、パッケージの配布にテストを含めないと、自分以外の人がパッケージが自分のシステムで適切に動作するかどうかをテストすることが難しくなります。小規模なテスト" +" スイート (Python ファイル + データ) があり、ユーザーがシステム上でローカルにテストを実行したいと考えている場合は、`tests/` " +"ディレクトリを **src/package** ディレクトリに移動することでテストを含めることができます (以下の例を参照)。" #: ../../package-structure-code/python-package-structure.md:132 msgid "" @@ -5411,8 +5892,8 @@ msgstr "" #: ../../package-structure-code/python-package-structure.md:134 msgid "" -"Be sure to read the [pytest documentation for more about including tests " -"in your package " +"Be sure to read the [pytest documentation for more about including tests in" +" your package " "distribution](https://docs.pytest.org/en/7.2.x/explanation/goodpractices.html#choosing-a" "-test-layout-import-rules)." msgstr "" @@ -5455,9 +5936,9 @@ msgstr "**テストスイートのデータセットをパッケージに含め msgid "" "If you include your tests in your package distribution, we strongly " "discourage you from including data in your test suite directory. Rather, " -"host your test data in a repository such as Figshare or Zenodo. Use a " -"tool such as [Pooch](https://www.fatiando.org/pooch/latest/) to access " -"the data when you (or a user) runs tests." +"host your test data in a repository such as Figshare or Zenodo. Use a tool " +"such as [Pooch](https://www.fatiando.org/pooch/latest/) to access the data " +"when you (or a user) runs tests." msgstr "" "テストをパッケージ配布に含める場合、テストスイートディレクトリにデータを含めることは強くお勧めしません。 " "そうではなく、FigshareやZenodoのようなリポジトリでテストデータをホストします。 " @@ -5466,15 +5947,15 @@ msgstr "" #: ../../package-structure-code/python-package-structure.md:155 msgid "" -"For more information about Python package tests, see the [tests section " -"of our guide](tests-intro)." +"For more information about Python package tests, see the [tests section of " +"our guide](tests-intro)." msgstr "Python パッケージテストの詳細については、 [ガイドの tests のセクション](tests-intro) を参照してください。" #: ../../package-structure-code/python-package-structure.md:157 msgid "" -"The **src/package** layout is semantically more clear. Code is always " -"found in the **src/package** directory, `tests/` and `docs/`are in the " -"root directory." +"The **src/package** layout is semantically more clear. Code is always found" +" in the **src/package** directory, `tests/` and `docs/`are in the root " +"directory." msgstr "" "**src/package** レイアウトの方が意味的に明確である。 コードは常に **src/package** ディレクトリにあり、　" "`tests/` と `docs/` はルートディレクトリにあります。" @@ -5482,10 +5963,10 @@ msgstr "" #: ../../package-structure-code/python-package-structure.md:161 msgid "" "If your package tests require data, do NOT include that data within your " -"package structure. Including data in your package structure increases the" -" size of your distribution files. This places a maintenance toll on " -"repositories like PyPI and Anaconda.org that have to deal with thousands " -"of package uploads." +"package structure. Including data in your package structure increases the " +"size of your distribution files. This places a maintenance toll on " +"repositories like PyPI and Anaconda.org that have to deal with thousands of" +" package uploads." msgstr "" "パッケージのテストにデータが必要な場合は、そのデータをパッケージ構造に含めないでください。 " "パッケージ構造にデータをインクルードすると、配布ファイルのサイズが大きくなります。 これは PyPI や Anaconda.org " @@ -5505,24 +5986,24 @@ msgstr "多くの科学的パッケージは **flat-layout** を使用してい #: ../../package-structure-code/python-package-structure.md:180 msgid "" -"This layout is used by many core scientific Python packages such as " -"NumPy, SciPy, and Matplotlib." +"This layout is used by many core scientific Python packages such as NumPy, " +"SciPy, and Matplotlib." msgstr "このレイアウトは、NumPy、SciPy、Matplotlibのような多くの科学的Pythonパッケージで使用されています。" #: ../../package-structure-code/python-package-structure.md:181 msgid "" "Many Python tools depend upon tools in other languages and/or complex " -"builds with compilation steps. Many maintainers prefer features of the " -"flat layout for more complex builds." +"builds with compilation steps. Many maintainers prefer features of the flat" +" layout for more complex builds." msgstr "" "多くのPythonツールは、他の言語のツールや、コンパイルステップを含む複雑なビルドに依存しています。 " "多くのメンテナーは、より複雑なビルドのためにフラットレイアウトの機能を好みます。" #: ../../package-structure-code/python-package-structure.md:185 msgid "" -"While we suggest that you use the **src/package** layout discussed above," -" it's important to also understand the flat layout, especially if you " -"plan to contribute to a package that uses this layout." +"While we suggest that you use the **src/package** layout discussed above, " +"it's important to also understand the flat layout, especially if you plan " +"to contribute to a package that uses this layout." msgstr "" "上述した **src/package** " "レイアウトを使用することを推奨しますが、特にこのレイアウトを使用するパッケージに貢献する予定がある場合は、フラットレイアウトも理解することが重要です。" @@ -5535,25 +6016,25 @@ msgstr "ほとんどの科学的Pythonパッケージがソースを使わない #: ../../package-structure-code/python-package-structure.md:191 #, fuzzy msgid "" -"Migrating larger scientific packages that already use a flat layout would" -" consume significant time and resources." +"Migrating larger scientific packages that already use a flat layout would " +"consume significant time and resources." msgstr "" "ほとんどの場合、すでにフラットレイアウトを使用している大規模な科学パッケージの **src/package** " "レイアウトへの移行は、かなりの時間を消費します。" #: ../../package-structure-code/python-package-structure.md:193 msgid "" -"However, the advantages of using the **src/package** layout for a " -"beginner are significant. As such, we recommend that you use the " -"**src/package** layout if you are creating a new package." +"However, the advantages of using the **src/package** layout for a beginner" +" are significant. As such, we recommend that you use the **src/package** " +"layout if you are creating a new package." msgstr "" "しかし、初心者にとって**src/package**レイアウトを使う利点は大きいです。そのため、新しいパッケージを作成する場合は、 " "**src/package** レイアウトを使用することをお勧めします。" #: ../../package-structure-code/python-package-structure.md:196 msgid "" -"Numerous packages in the ecosystem [have had to move to a **src/package**" -" layout](https://github.com/scikit-build/cmake-python-" +"Numerous packages in the ecosystem [have had to move to a **src/package** " +"layout](https://github.com/scikit-build/cmake-python-" "distributions/pull/145)." msgstr "" "エコシステムの中で数多くのパッケージが [**src/package** " @@ -5570,8 +6051,8 @@ msgstr "フラットレイアウトの主な特徴は以下の通りです:" #: ../../package-structure-code/python-package-structure.md:204 msgid "" -"The source code for your package lives in a directory with your package's" -" name in the root of your directory" +"The source code for your package lives in a directory with your package's " +"name in the root of your directory" msgstr "パッケージのソースコードは、ディレクトリのルートにあるパッケージ名のディレクトリに格納されます" #: ../../package-structure-code/python-package-structure.md:206 @@ -5582,8 +6063,8 @@ msgstr "多くの場合、 `tests/` ディレクトリも同じ `package` ディ #: ../../package-structure-code/python-package-structure.md:208 msgid "" -"Below you can see the recommended structure of a scientific Python " -"package using the flat layout." +"Below you can see the recommended structure of a scientific Python package " +"using the flat layout." msgstr "以下に、フラットレイアウトを使った科学的Pythonパッケージの推奨構造を示します。" #: ../../package-structure-code/python-package-structure.md:230 @@ -5598,17 +6079,17 @@ msgstr "フラットレイアウトを採用することは、科学コミュニ #: ../../package-structure-code/python-package-structure.md:234 msgid "" -"This structure has historically been used across the ecosystem and " -"packages using it are unlikely to change." +"This structure has historically been used across the ecosystem and packages" +" using it are unlikely to change." msgstr "この構造は歴史的にエコシステム全体で使われてきたものであり、これを使うパッケージが変わることはないでしょう。" #: ../../package-structure-code/python-package-structure.md:236 msgid "" -"You can import the package directly from the root directory. For some " -"this is engrained in their respective workflows. However, for a beginner " -"the danger of doing this is that you are not developing and testing " -"against the installed version of your package. Rather, you are working " -"directly with the flat files." +"You can import the package directly from the root directory. For some this " +"is engrained in their respective workflows. However, for a beginner the " +"danger of doing this is that you are not developing and testing against the" +" installed version of your package. Rather, you are working directly with " +"the flat files." msgstr "" "ルートディレクトリからパッケージを直接インポートすることができます。これがそれぞれのワークフローに組み込まれている人もいるでしょう。しかし、初心者がこの方法をとる危険性は、インストールされたバージョンのパッケージに対して開発やテストを行っていないことにあります。" " むしろ、フラットファイルを直接扱うことになります。" @@ -5647,25 +6128,28 @@ msgstr "[scikit-learn](https://github.com/scikit-learn/scikit-learn)" #: ../../package-structure-code/python-package-structure.md:253 msgid "" -"It would be a significant maintenance cost and burden to move all of " -"these packages to a different layout. The potential benefits of the " -"source layout for these tools are not worth the maintenance investment." +"It would be a significant maintenance cost and burden to move all of these " +"packages to a different layout. The potential benefits of the source layout" +" for these tools are not worth the maintenance investment." msgstr "" "これらのパッケージをすべて別のレイアウトに移行するのは、かなりのメンテナンスコストと負担になるでしょう。 " "これらのツールのソースレイアウトの潜在的な利点は、メンテナンスの投資に見合うものではありません。" #: ../../package-structure-code/python-package-structure.md:258 msgid "Multiple packages in a src/ folder" -msgstr "" +msgstr "src/ フォルダー内の複数のパッケージ" #: ../../package-structure-code/python-package-structure.md:261 msgid "" "In some more advanced cases, you may have more than one package in your " "**src/** directory. See [Black's GitHub " -"repo](https://github.com/psf/black/tree/main/src) for an example of this." -" However, for most beginners you will likely only have one sub-directory " -"in your **src/** folder." +"repo](https://github.com/psf/black/tree/main/src) for an example of this. " +"However, for most beginners you will likely only have one sub-directory in " +"your **src/** folder." msgstr "" +"より高度なケースでは、**src/** ディレクトリに複数のパッケージが存在する場合があります。この例については、[Black の GitHub " +"リポジトリ](https://github.com/psf/black/tree/main/src) " +"を参照してください。ただし、ほとんどの初心者の場合、**src/** フォルダー内にサブディレクトリは 1 つしかないでしょう。" #: ../../package-structure-code/python-package-versions.md:1 msgid "Creating New Versions of Your Python Package" @@ -5677,10 +6161,10 @@ msgstr "キーポイント" #: ../../package-structure-code/python-package-versions.md:8 msgid "" -"Follow [semantic versioning guidelines (SemVer) " -"rules](https://semver.org/) when bumping (increasing) your Python's " -"package version; for example a major version bump (version 1.0 --> 2.0) " -"equates to breaking changes in your package's code for a user." +"Follow [semantic versioning guidelines (SemVer) rules](https://semver.org/)" +" when bumping (increasing) your Python's package version; for example a " +"major version bump (version 1.0 --> 2.0) equates to breaking changes in " +"your package's code for a user." msgstr "" "Pythonのパッケージのバージョンを(上げる)ときは [semantic versioning guidelines " "(SemVer)のルール](https://semver.org/) に従ってください。例えばメジャーバージョンアップ(バージョン1.0 --> " @@ -5697,8 +6181,8 @@ msgstr "" #: ../../package-structure-code/python-package-versions.md:10 msgid "" -"Otherwise most major package build tools such as Hatch, Flit and PDM have" -" a version feature that will help you update your package's version" +"Otherwise most major package build tools such as Hatch, Flit and PDM have a" +" version feature that will help you update your package's version" msgstr "その他、Hatch、Flit、PDMなどの主要なパッケージビルドツールには、パッケージのバージョンを更新するためのバージョン機能があります。" #: ../../package-structure-code/python-package-versions.md:11 @@ -5709,14 +6193,14 @@ msgstr "パッケージのバージョン番号をコード内で手作業で更 msgid "" "pyOpenSci recommends that you follow the [Python PEP " "440](https://peps.python.org/pep-0440) which recommends using [semantic " -"versioning guidelines](https://www.python.org/dev/peps/pep-0440" -"/#semantic-versioning) when assigning release values to new versions of " -"your Python package." +"versioning guidelines](https://www.python.org/dev/peps/pep-0440/#semantic-" +"versioning) when assigning release values to new versions of your Python " +"package." msgstr "" "pyOpenSciでは、Pythonパッケージの新しいバージョンにリリース値を割り当てる際に、 [semantic versioning " -"guidelines](https://www.python.org/dev/peps/pep-0440/#semantic-" -"versioning) を使用することを推奨している [Python PEP " -"440](https://peps.python.org/pep-0440) に従うことを推奨しています。" +"guidelines](https://www.python.org/dev/peps/pep-0440/#semantic-versioning) " +"を使用することを推奨している [Python PEP 440](https://peps.python.org/pep-0440) " +"に従うことを推奨しています。" #: ../../package-structure-code/python-package-versions.md:18 msgid "" @@ -5736,8 +6220,8 @@ msgstr "これは、あなたのユーザ (あなたのパッケージに依存 #: ../../package-structure-code/python-package-versions.md:24 msgid "" -"It helps your development team make decisions about when to bump a " -"package version based on standard rules." +"It helps your development team make decisions about when to bump a package " +"version based on standard rules." msgstr "標準的なルールに基づいて、開発チームがパッケージのバージョンを上げるタイミングを判断するのに役立ちます。" #: ../../package-structure-code/python-package-versions.md:26 @@ -5746,8 +6230,8 @@ msgid "" "your package version explain the extent of the changes made in the code " "base from version to version. Thus your package version numbers become " "\"expressive\" in the same way that naming code variables well can [make " -"code expressive](https://medium.com/@daniel.oliver.king/writing-" -"expressive-code-b69ef7a5a2fa)." +"code expressive](https://medium.com/@daniel.oliver.king/writing-expressive-" +"code-b69ef7a5a2fa)." msgstr "" "センバーのルールに従った一貫したバージョンの増加とは、パッケージのバージョンの値が、バージョンごとにコードベースで行われた変更の程度を説明することを意味します。こうしてパッケージのバージョン番号は、コードの変数にうまく名前をつけることで" " [コードを表現豊かにする](https://medium.com/@daniel.oliver.king/writing-expressive-" @@ -5759,10 +6243,10 @@ msgstr "バージョン管理について" #: ../../package-structure-code/python-package-versions.md:29 msgid "" -"In some cases even small version changes can turn a package update into a" -" breaking change for some users. What is also important is that you " -"document how you version your code and if you can, also document your " -"deprecation policy for code." +"In some cases even small version changes can turn a package update into a " +"breaking change for some users. What is also important is that you document" +" how you version your code and if you can, also document your deprecation " +"policy for code." msgstr "" "場合によっては、小さなバージョン変更でさえも、パッケージのアップデートを一部のユーザーにとって破壊的な変更に変えてしまう可能性があります。 " "さらに重要なのは、コードのバージョンアップ方法を文書化することであり、可能であればコードの非推奨ポリシーも文書化することです。" @@ -5807,9 +6291,9 @@ msgstr "後方互換性のある方法で機能を追加する場合の **MINOR #: ../../package-structure-code/python-package-versions.md:52 msgid "" -"**PATCH version** when you make backwards compatible bug fixes Additional" -" labels for pre-release and build metadata are available as extensions to" -" the MAJOR.MINOR.PATCH format." +"**PATCH version** when you make backwards compatible bug fixes Additional " +"labels for pre-release and build metadata are available as extensions to " +"the MAJOR.MINOR.PATCH format." msgstr "" "**PATCH version** 後方互換性のあるバグ修正を行う場合 " "プレリリースとビルドのメタデータ用の追加ラベルは、MAJOR.MINOR.PATCHフォーマットの拡張として利用できます。" @@ -5818,9 +6302,9 @@ msgstr "" msgid "" "Some people prefer to use [calver](https://calver.org/index.html) for " "versioning. It may be a simpler-to-use system given it relies upon date " -"values associated with released versions. However, calver does not " -"provide a user with a sense of when a new version might break an existing" -" build. As such we still suggest semver." +"values associated with released versions. However, calver does not provide " +"a user with a sense of when a new version might break an existing build. As" +" such we still suggest semver." msgstr "" "バージョン管理には[calver](https://calver.org/index.html)を好んで使う人もいます。リリースされたバージョンに関連する日付の値に依存することを考えれば、より使いやすいシステムかもしれません。" " しかし、calverは、新しいバージョンがいつ既存のビルドを壊すかもしれないという感覚をユーザーに提供しません。 " @@ -5828,8 +6312,8 @@ msgstr "" #: ../../package-structure-code/python-package-versions.md:60 msgid "" -"pyOpenSci will never require semver in a peer review as long as a package" -" has a reasonable approach to versioning!" +"pyOpenSci will never require semver in a peer review as long as a package " +"has a reasonable approach to versioning!" msgstr "pyOpenSciは、パッケージがバージョニングに対して合理的なアプローチを持っている限り、査読でsemverを要求することはありません！" #: ../../package-structure-code/python-package-versions.md:64 @@ -5847,12 +6331,10 @@ msgstr "" #: ../../package-structure-code/python-package-versions.md:71 msgid "" -"We recommend that you avoid manual updates of your package version number" -" to avoid human-error. It is better practice to keep your version number " -"in one location." -msgstr "" -"ヒューマンエラーを避けるため、パッケージのバージョン番号の手動更新は 避けることをお勧めします。 " -"バージョン番号は一箇所にまとめておく方がよいでしょう。" +"We recommend that you avoid manual updates of your package version number " +"to avoid human-error. It is better practice to keep your version number in " +"one location." +msgstr "ヒューマンエラーを避けるため、パッケージのバージョン番号の手動更新は 避けることをお勧めします。 バージョン番号は一箇所にまとめておく方がよいでしょう。" #: ../../package-structure-code/python-package-versions.md:75 msgid "" @@ -5874,13 +6356,13 @@ msgstr "Pythonパッケージのバージョンを管理するツール" #: ../../package-structure-code/python-package-versions.md:87 msgid "" "There are a handful of tools that are widely used in the scientific " -"ecosystem that you can use to manage your package versions. Some of these" -" tools are built into or work with your chosen [packaging build tools " -"that discussed in this chapter.](python-package-build-tools)" +"ecosystem that you can use to manage your package versions. Some of these " +"tools are built into or work with your chosen [packaging build tools that " +"discussed in this chapter.](python-package-build-tools)" msgstr "" "パッケージのバージョンを管理するために使用できる、科学的なエコシステムで広く使われているツールがいくつかあります。 " -"これらのツールのいくつかは、あなたが選択した [この章で議論するパッケージングビルドツール](python-package-build-" -"tools) に組み込まれているか、それらと連携しています。" +"これらのツールのいくつかは、あなたが選択した [この章で議論するパッケージングビルドツール](python-package-build-tools) " +"に組み込まれているか、それらと連携しています。" #: ../../package-structure-code/python-package-versions.md:93 msgid "Below, we provide an overview of these tools." @@ -5888,29 +6370,28 @@ msgstr "以下に、これらのツールの概要を示します。" #: ../../package-structure-code/python-package-versions.md:99 msgid "" -"There are three general groups of tools that you can use to manage " -"package versions:" +"There are three general groups of tools that you can use to manage package " +"versions:" msgstr "パッケージのバージョンを管理するために使用できるツールには、一般的に3つのグループがあります:" #: ../../package-structure-code/python-package-versions.md:102 msgid "" -"**semantic release tools:** These tools will automagically determine what" -" type of version bump to use using the text in your commit messages. " -"Below we discuss [Python Semantic Release](https://python-semantic-" +"**semantic release tools:** These tools will automagically determine what " +"type of version bump to use using the text in your commit messages. Below " +"we discuss [Python Semantic Release](https://python-semantic-" "release.readthedocs.io/en/latest/) as a Python tool that implements a " "semantic versioning approach." msgstr "" -"**セマンティックリリースツール:** これらのツールは、コミットメッセージのテキストから、使用するバージョンバンプのタイプを自動的に判断します。" -" 以下では、セマンティックバージョニングアプローチを実装したPythonツールとして、 [Python Semantic " -"Release](https://python-semantic-release.readthedocs.io/en/latest/) " -"を取り上げます。" +"**セマンティックリリースツール:** これらのツールは、コミットメッセージのテキストから、使用するバージョンバンプのタイプを自動的に判断します。 " +"以下では、セマンティックバージョニングアプローチを実装したPythonツールとして、 [Python Semantic Release](https" +"://python-semantic-release.readthedocs.io/en/latest/) を取り上げます。" #: ../../package-structure-code/python-package-versions.md:104 msgid "" "**Manual incremental bump tools:** Tools like " -"[Hatch](https://hatch.pypa.io/latest/version/) offer version bumping " -"within your package. Normally this is implemented at the command link for" -" instance `hatch version major` would bump your project from 0.x to 1.0." +"[Hatch](https://hatch.pypa.io/latest/version/) offer version bumping within" +" your package. Normally this is implemented at the command link for " +"instance `hatch version major` would bump your project from 0.x to 1.0." msgstr "" "**手動インクリメンタルバンプツール:** " "[Hatch](https://hatch.pypa.io/latest/version/)のようなツールは、パッケージ内でのバージョンバンプを提供します。通常、これはコマンドリンクで実装されます。例えば、" @@ -5918,11 +6399,11 @@ msgstr "" #: ../../package-structure-code/python-package-versions.md:105 msgid "" -"**Version Control System tools:** Finally there are tools that rely on " -"your version control system to track versions. These tools often are " -"plugins to your package build tool (ex: setuptools build or hatchling). " -"We discuss this option below assuming that you are using **.git tags** " -"and **GitHub** to manage your package repository." +"**Version Control System tools:** Finally there are tools that rely on your" +" version control system to track versions. These tools often are plugins to" +" your package build tool (ex: setuptools build or hatchling). We discuss " +"this option below assuming that you are using **.git tags** and **GitHub** " +"to manage your package repository." msgstr "" "**バージョン管理システムツール:** 最後に、バージョンを追跡するためにバージョン管理システムに依存するツールがある。 " "これらのツールは、パッケージビルドツールのプラグインであることが多いです (例：setuptools build または hatchling)。 " @@ -5935,10 +6416,10 @@ msgstr "セマンティックリリース、バージョン管理ベースと手 #: ../../package-structure-code/python-package-versions.md:109 msgid "" -"Generally semantic release and version control system tools can be setup " -"to run automatically on GitHub using GitHub Actions. This means that you " -"can create a workflow where a GitHub release and associated new version " -"tag is used to trigger an automated build that:" +"Generally semantic release and version control system tools can be setup to" +" run automatically on GitHub using GitHub Actions. This means that you can " +"create a workflow where a GitHub release and associated new version tag is " +"used to trigger an automated build that:" msgstr "" "一般的に、セマンティックリリースツールやバージョン管理システムツールは、GitHub " "Actionsを使ってGitHub上で自動的に実行するように設定することができる。 つまり、GitHub " @@ -5967,8 +6448,8 @@ msgstr "" #: ../../package-structure-code/python-package-versions.md:124 msgid "" -"Using semantic versioning, there are three main \"levels\" of versions " -"that you might consider:" +"Using semantic versioning, there are three main \"levels\" of versions that" +" you might consider:" msgstr "セマンティックバージョニングを使用する場合、3つの主な \"レベル\" が考えられます:" #: ../../package-structure-code/python-package-versions.md:127 @@ -6013,9 +6494,9 @@ msgid "" "implement version. Rather, they allow you to update the version at the " "command line using commands such as:" msgstr "" -"最近のビルドツールのフロントエンドツールの多くは、セマンティックバージョン管理のルールに従ったバージョンサポートを提供しています。 " -"これらのツールは Python Semantic Version とは異なり、バージョンを実装するために特定のコミットメッセージを必要としません。" -" そうではなく、コマンドラインで次のようなコマンドを使ってバージョンを更新することができます:" +"最近のビルドツールのフロントエンドツールの多くは、セマンティックバージョン管理のルールに従ったバージョンサポートを提供しています。 これらのツールは " +"Python Semantic Version とは異なり、バージョンを実装するために特定のコミットメッセージを必要としません。 " +"そうではなく、コマンドラインで次のようなコマンドを使ってバージョンを更新することができます:" #: ../../package-structure-code/python-package-versions.md:148 msgid "`tool-name version update major`" @@ -6027,10 +6508,10 @@ msgstr "`tool-name version update minor`" #: ../../package-structure-code/python-package-versions.md:151 msgid "" -"[Hatch](https://hatch.pypa.io/latest/version/), for instance offers " -"`hatch version minor` which will modify the version of your package " -"incrementally. With **Hatch** the version value will be found in your " -"`pyproject.toml` file. " +"[Hatch](https://hatch.pypa.io/latest/version/), for instance offers `hatch " +"version minor` which will modify the version of your package incrementally." +" With **Hatch** the version value will be found in your `pyproject.toml` " +"file. " msgstr "" "例えば、[Hatch](https://hatch.pypa.io/latest/version/) " "は、パッケージのバージョンをインクリメンタルに変更する `hatch version minor` を提供しています。 **Hatch** " @@ -6063,9 +6544,9 @@ msgstr "ツール 2: Hatch_vcs & hatchling ビルドバックエンド" #: ../../package-structure-code/python-package-versions.md:164 msgid "" "[hatch_vcs](https://github.com/ofek/hatch-vcs) is a versioning tool that " -"allows you to manage package versions using **git tags**. Hatch_vcs " -"creates a **\\_version.py** file in your package ecosystem that keeps " -"track of the package's current version." +"allows you to manage package versions using **git tags**. Hatch_vcs creates" +" a **\\_version.py** file in your package ecosystem that keeps track of the" +" package's current version." msgstr "" "[hatch_vcs](https://github.com/ofek/hatch-vcs)は、 **git tags** " "を使ってパッケージのバージョンを管理できるバージョン管理ツールです。Hatch_vcs はパッケージの現在のバージョンを追跡する " @@ -6074,10 +6555,10 @@ msgstr "" #: ../../package-structure-code/python-package-versions.md:169 msgid "" "Hatch keeps track of your package's version in a `_version.py` file. " -"Storing the version in a single file managed by Hatch provides your " -"package with a \"single source of truth\" value for the version number. " -"This in turn eliminates potential error associated with manually updating" -" your package's version." +"Storing the version in a single file managed by Hatch provides your package" +" with a \"single source of truth\" value for the version number. This in " +"turn eliminates potential error associated with manually updating your " +"package's version." msgstr "" "Hatch はパッケージのバージョンを `_version.py` ファイルに記録しています。 " "Hatchが管理する単一のファイルにバージョンを保存することで、パッケージにバージョン番号の \"単一の真のソース\" 値を提供します。 " @@ -6085,8 +6566,8 @@ msgstr "" #: ../../package-structure-code/python-package-versions.md:175 msgid "" -"When you (or your CI system) build your package, hatch checks the current" -" tag number for your package. If it has increased, it will update the " +"When you (or your CI system) build your package, hatch checks the current " +"tag number for your package. If it has increased, it will update the " "**\\_version.py** file with the new value." msgstr "" "あなた（またはあなたのCIシステム）がパッケージをビルドするとき、hatchはあなたのパッケージの現在のタグ番号をチェックします。 " @@ -6094,15 +6575,13 @@ msgstr "" #: ../../package-structure-code/python-package-versions.md:178 msgid "" -"Thus, when you create a new tag or a new release with a tag and build " -"your package, Hatch will access the new tag value and use it to update " -"your package version." +"Thus, when you create a new tag or a new release with a tag and build your " +"package, Hatch will access the new tag value and use it to update your " +"package version." msgstr "このように、新しいタグを作成したり、タグ付きの新しいリリースを作成してパッケージをビルドすると、Hatchは新しいタグの値にアクセスし、それを使ってパッケージのバージョンを更新します。" #: ../../package-structure-code/python-package-versions.md:181 -msgid "" -"To use **hatch_vcs** you will need to use the **hatchling** build back " -"end." +msgid "To use **hatch_vcs** you will need to use the **hatchling** build back end." msgstr "**hatch_vcs** を使用するには、 **hatchling** ビルドバックエンドを使用する必要があります。" #: ../../package-structure-code/python-package-versions.md:184 @@ -6119,9 +6598,7 @@ msgstr "pyproject.tomlでのHatchのセットアップ例" msgid "" "**Hatch_vcs** supports a fully automated package release and build, and " "push to PyPI workflow on GitHub." -msgstr "" -"**Hatch_vcs** " -"は完全に自動化されたパッケージのリリースとビルド、GitHub上のPyPIへのプッシュのワークフローをサポートしています。" +msgstr "**Hatch_vcs** は完全に自動化されたパッケージのリリースとビルド、GitHub上のPyPIへのプッシュのワークフローをサポートしています。" #: ../../package-structure-code/python-package-versions.md:208 msgid "" @@ -6168,16 +6645,16 @@ msgstr "純粋にGitHubベースのリリースワークフローをサポート #: ../../package-structure-code/python-package-versions.md:218 #: ../../package-structure-code/python-package-versions.md:244 msgid "" -"Version number is updated in your package via a hidden `_version.py` " -"file. There is no manual configuration updates required." +"Version number is updated in your package via a hidden `_version.py` file. " +"There is no manual configuration updates required." msgstr "バージョン番号は隠された `_version.py` ファイルを通してパッケージ内で更新されます。 手動で設定を更新する必要はありません。" #: ../../package-structure-code/python-package-versions.md:219 #: ../../package-structure-code/python-package-versions.md:245 msgid "" -"While we like detailed commit messages (See Python Semantic Version " -"below), we know that sometimes when maintaining a package specific " -"guidelines around commit messages can be hard to apply and manage." +"While we like detailed commit messages (See Python Semantic Version below)," +" we know that sometimes when maintaining a package specific guidelines " +"around commit messages can be hard to apply and manage." msgstr "" "私たちは詳細なコミットメッセージを好みますが(下記のPython Semantic " "Versionを参照してください)、パッケージを管理する際にコミットメッセージに関する特定のガイドラインを適用したり管理したりするのが難しい場合があることも知っています。" @@ -6189,9 +6666,9 @@ msgstr "hatch_vcs Cons" #: ../../package-structure-code/python-package-versions.md:223 msgid "" -"In a CI workflow you will end up manually entering or creating the " -"version number via a tag on GitHub. But you could locally develop a build" -" to \"bump\" tag versions" +"In a CI workflow you will end up manually entering or creating the version " +"number via a tag on GitHub. But you could locally develop a build to " +"\"bump\" tag versions" msgstr "" "CIワークフローでは、GitHubのタグを使ってバージョン番号を手動で入力したり作成したりすることになります。 しかし、タグのバージョンを " "\"bump\" するビルドをローカルで開発することもできます。" @@ -6202,11 +6679,11 @@ msgstr "ツール3: gitタグを使ったsetuptools-scmのバージョン管理" #: ../../package-structure-code/python-package-versions.md:228 msgid "" -"[`Setuptools_scm`](https://github.com/pypa/setuptools-scm/) is an " -"extension that you can use with setuptools to manage package versions. " +"[`Setuptools_scm`](https://github.com/pypa/setuptools-scm/) is an extension" +" that you can use with setuptools to manage package versions. " "**Setuptools_scm** operates the same way that **hatch_vcs** (discussed " -"above) does. It stores a version in a **\\_version.py** file and relies " -"on (**git**) tags to determine the package's current version." +"above) does. It stores a version in a **\\_version.py** file and relies on " +"(**git**) tags to determine the package's current version." msgstr "" "[`Setuptools_scm`](https://github.com/pypa/setuptools-scm/) " "は、パッケージのバージョンを管理するために setuptools と一緒に使うことができる拡張機能です。 " @@ -6234,8 +6711,8 @@ msgstr "setuptools_scm Cons" #: ../../package-structure-code/python-package-versions.md:250 msgid "" -"In a CI workflow you will end up manually entering or creating the " -"version number via a tag on GitHub." +"In a CI workflow you will end up manually entering or creating the version " +"number via a tag on GitHub." msgstr "CIワークフローでは、GitHubのタグを使って手動でバージョン番号を入力したり作成したりすることになります。" #: ../../package-structure-code/python-package-versions.md:251 @@ -6244,14 +6721,14 @@ msgstr "文書化されていません" #: ../../package-structure-code/python-package-versions.md:252 msgid "" -"Because setuptools will always have to support backwards compatibility it" -" will always be slower in adopting modern Python packaging conventions." +"Because setuptools will always have to support backwards compatibility it " +"will always be slower in adopting modern Python packaging conventions." msgstr "setuptools は常に後方互換性をサポートしなければならないので、最新の Python パッケージング規約を採用するのは常に遅くなります。" #: ../../package-structure-code/python-package-versions.md:254 msgid "" -"As such you might consider using a more modern tool such as **hatch_vcs**" -" and **hatchling** to build your package and manage package versions." +"As such you might consider using a more modern tool such as **hatch_vcs** " +"and **hatchling** to build your package and manage package versions." msgstr "" "そのため、パッケージのビルドやパッケージのバージョン管理には、 **hatch_vcs** や **hatchling** " "のような、より現代的なツールの使用を検討してください。" @@ -6267,9 +6744,8 @@ msgstr "" #: ../../package-structure-code/python-package-versions.md:268 msgid "" "Python semantic release uses a commit message workflow that updates the " -"version of your package based on keywords found in your commit messages. " -"As the name implies, Python Semantic Release follows semver release " -"rules." +"version of your package based on keywords found in your commit messages. As" +" the name implies, Python Semantic Release follows semver release rules." msgstr "" "Python semantic release " "はコミットメッセージのワークフローを使い、コミットメッセージに含まれるキーワードに基づいてパッケージのバージョンを更新します。 " @@ -6284,10 +6760,10 @@ msgstr "Python Semantic Release では、git のコミットメッセージに #: ../../package-structure-code/python-package-versions.md:276 msgid "" "For example, the words `fix(attribute_warning):` trigger Python Semantic " -"Release to implement a **patch** version bump. For instance if your " -"package was at version 1.1.0 and you made the commit below with the words" -" fix(text-here), Python Semantic Release would bump your package to " -"version 1.1.1." +"Release to implement a **patch** version bump. For instance if your package" +" was at version 1.1.0 and you made the commit below with the words fix" +"(text-here), Python Semantic Release would bump your package to version " +"1.1.1." msgstr "" "例えば、 `fix(attribute_warning):` という言葉は、Python Semantic Releaseが **patch** " "バージョンバンプを実装する引き金になります。 例えば、あなたのパッケージのバージョンが1.1.0で、fix(text-here) " @@ -6295,17 +6771,17 @@ msgstr "" #: ../../package-structure-code/python-package-versions.md:286 msgid "" -"Similarly a feature (`feat()`) triggers a minor version bump. For example" -" from version 1.1 to version 1.2" +"Similarly a feature (`feat()`) triggers a minor version bump. For example " +"from version 1.1 to version 1.2" msgstr "同様に、機能（`feat()`）はマイナーバージョンアップの引き金となります。 例えばバージョン1.1からバージョン1.2へ" #: ../../package-structure-code/python-package-versions.md:294 msgid "" "You can find a thoughtful discussion of python semantic version [in this " "Python package guide](https://py-pkgs.org/07-releasing-versioning" -"#automatic-version-bumping). Note that the guide hasn't been updated " -"since 2020 and will potentially be updated in the future! But for now, " -"some of the commands are dated but the content is still excellent." +"#automatic-version-bumping). Note that the guide hasn't been updated since " +"2020 and will potentially be updated in the future! But for now, some of " +"the commands are dated but the content is still excellent." msgstr "" "[このPythonパッケージガイド](https://py-pkgs.org/07-releasing-versioning#automatic-" "version-bumping) " @@ -6322,9 +6798,8 @@ msgstr "センバーのバージョニングに忠実に従う" #: ../../package-structure-code/python-package-versions.md:300 msgid "" -"Enforces maintainers using descriptive commit messages which can simplify" -" troubleshooting and ensure a cleaner and more self-describing git " -"history." +"Enforces maintainers using descriptive commit messages which can simplify " +"troubleshooting and ensure a cleaner and more self-describing git history." msgstr "説明的なコミットメッセージを使ってメンテナを強制します。これにより、トラブルシューティングを簡素化し、よりクリーンで自己記述的なgit履歴を確保することができます。" #: ../../package-structure-code/python-package-versions.md:302 @@ -6340,14 +6815,14 @@ msgid "" "commit messages in a repo)" msgstr "" "動作させるには、非常に特殊なコミット言語が必要です。 " -"実際には、メンテナや貢献者の中にはコミットメッセージにそのレベルの具体性を保てない人もいるでしょう (注意: リポジトリ内の git commit" -" メッセージをチェックするボットがあります)。" +"実際には、メンテナや貢献者の中にはコミットメッセージにそのレベルの具体性を保てない人もいるでしょう (注意: リポジトリ内の git commit " +"メッセージをチェックするボットがあります)。" #: ../../package-structure-code/python-package-versions.md:305 msgid "" "Release happens at the command line. This makes is harder to implement a " -"GitHub based release workflow as the wrong commit message could trigger a" -" release." +"GitHub based release workflow as the wrong commit message could trigger a " +"release." msgstr "" "リリースはコマンドラインで行われます。 このため、GitHub " "ベースのリリースワークフローを実装するのが難しくなります。間違ったコミットメッセージがリリースのトリガーになってしまう可能性があるからです。" @@ -6377,55 +6852,54 @@ msgstr "" #~ msgid "" #~ "Poetry helps you add dependencies to " -#~ "your `pyproject.toml` metadata. _NOTE: " -#~ "currently Poetry adds dependencies using " -#~ "an approach that is slightly out " -#~ "of alignment with current Python peps" -#~ " - however there is a plan to" -#~ " fix this in an upcoming release._" -#~ " Poetry also allows you to organize" -#~ " dependencies in groups such as " -#~ "documentation, packaging and tests." +#~ "your `pyproject.toml` metadata. _NOTE: currently" +#~ " Poetry adds dependencies using an " +#~ "approach that is slightly out of " +#~ "alignment with current Python peps - " +#~ "however there is a plan to fix " +#~ "this in an upcoming release._ Poetry " +#~ "also allows you to organize dependencies" +#~ " in groups such as documentation, " +#~ "packaging and tests." #~ msgstr "" -#~ "Poetry は `pyproject.toml` メタデータに依存関係を追加するのに役立ちます。" -#~ " _NOTE: 現在のところ、Poetry は現在の Python peps " -#~ "とは少しずれたアプローチで依存関係を追加しています - しかし、今後のリリースでこれを修正する予定です。 " -#~ "_ Poetryでは、ドキュメント、パッケージング、テストなどのグループに依存関係を整理することもできます。" +#~ "Poetry は `pyproject.toml` メタデータに依存関係を追加するのに役立ちます。 " +#~ "_NOTE: 現在のところ、Poetry は現在の Python peps " +#~ "とは少しずれたアプローチで依存関係を追加しています - しかし、今後のリリースでこれを修正する予定です。 _" +#~ " Poetryでは、ドキュメント、パッケージング、テストなどのグループに依存関係を整理することもできます。" #~ msgid "✖✅" #~ msgstr "✖✅" #~ msgid "" -#~ "Poetry does not quite support current" -#~ " packaging standards for adding metadata" -#~ " to the **pyproject.toml** file but " -#~ "plans to fix this in an upcoming" -#~ " release." +#~ "Poetry does not quite support current " +#~ "packaging standards for adding metadata to" +#~ " the **pyproject.toml** file but plans " +#~ "to fix this in an upcoming release." #~ msgstr "" #~ "Poetryは **pyproject.toml** " #~ "ファイルにメタデータを追加する現在のパッケージング標準を完全にサポートしているわけではありませんが、今後のリリースでこれを修正する予定です。" #~ msgid "" -#~ "Poetry supports installing your package " -#~ "in editable mode using `--editable`" +#~ "Poetry supports installing your package in" +#~ " editable mode using `--editable`" #~ msgstr "Poetry は `--editable` を使った編集可能モードでのパッケージのインストールをサポートしています。" #~ msgid "" #~ "_Minor Challenge:_ The way Poetry " #~ "currently adds metadata to your " #~ "pyproject.toml file does not follow " -#~ "current Python standards. However, this " -#~ "is going to be addressed with " -#~ "Poetry release version 2.0." +#~ "current Python standards. However, this is" +#~ " going to be addressed with Poetry " +#~ "release version 2.0." #~ msgstr "" #~ "_マイナーチェンジ:_ " #~ "Poetryが現在pyproject.tomlファイルにメタデータを追加する方法は、現在のPythonの標準に従っていません。 " #~ "しかし、これは Poetry リリースバージョン 2.0 で対処される予定です。" #~ msgid "" -#~ "A Python package dependency refers to" -#~ " an external package or software that" -#~ " your Python project:" +#~ "A Python package dependency refers to " +#~ "an external package or software that " +#~ "your Python project:" #~ msgstr "Pythonパッケージ依存とは、Pythonプロジェクトが使用する外部パッケージやソフトウェアのことです:" #~ msgid "Needs to function properly." @@ -6438,51 +6912,50 @@ msgstr "" #~ msgstr "もし、あなたのパッケージをローカルで開発したり、改良したりしたい人がいるか" #~ msgid "" -#~ "Requires if a user wants to add" -#~ " additional functionality (that is not " +#~ "Requires if a user wants to add " +#~ "additional functionality (that is not " #~ "core) to your package" #~ msgstr "ユーザが（コアではない）追加機能をパッケージに追加したい場合に必要です。" #~ msgid "" #~ "You can think about dependencies as " -#~ "being either optional or required. If" -#~ " they are required, they will be " +#~ "being either optional or required. If " +#~ "they are required, they will be " #~ "listed in the `dependencies` key in " #~ "the `project` table of your " #~ "`pyproject.toml` file. If they are " -#~ "optional, they will be listed in " -#~ "the `[project.optional-dependencies]` table of your" -#~ " `pyproject.toml`." +#~ "optional, they will be listed in the" +#~ " `[project.optional-dependencies]` table of " +#~ "your `pyproject.toml`." #~ msgstr "" -#~ "依存関係はオプションか必須であると考えることができます。 必須であれば、 `pyproject` " -#~ "テーブルの `dependencies` キーにリストされます。 オプションの場合は、 " -#~ "`pyproject.toml` の `[project.optional-dependencies]` " -#~ "テーブルにリストされます。" +#~ "依存関係はオプションか必須であると考えることができます。 必須であれば、 `pyproject` テーブルの" +#~ " `dependencies` キーにリストされます。 オプションの場合は、 " +#~ "`pyproject.toml` の `[project.optional-dependencies]`" +#~ " テーブルにリストされます。" #~ msgid "You will learn about both below." #~ msgstr "両者については後述します。" #~ msgid "" -#~ "There are two broad groups of " -#~ "Python package dependencies: those that " -#~ "are optional and those that are " -#~ "required. Required packages are those " -#~ "that a user needs to use your " -#~ "package. Optional dependencies are packages" -#~ " a user can chose to install to" -#~ " add functionality to your package. " -#~ "Within those 2 groups, there are " -#~ "three use cases that you can think" -#~ " about. 1. Core dependencies are " -#~ "**required** for a user to use " -#~ "your package. 2. Development dependencies " -#~ "are optional and only needed if " -#~ "someone wants to work on your " -#~ "package locally. 3. Finally feature " -#~ "dependencies are optional and add " -#~ "additional functionality to your package. " -#~ "Not all packages will have feature " -#~ "dependencies." +#~ "There are two broad groups of Python" +#~ " package dependencies: those that are " +#~ "optional and those that are required. " +#~ "Required packages are those that a " +#~ "user needs to use your package. " +#~ "Optional dependencies are packages a user" +#~ " can chose to install to add " +#~ "functionality to your package. Within " +#~ "those 2 groups, there are three use" +#~ " cases that you can think about. " +#~ "1. Core dependencies are **required** for" +#~ " a user to use your package. 2." +#~ " Development dependencies are optional and" +#~ " only needed if someone wants to " +#~ "work on your package locally. 3. " +#~ "Finally feature dependencies are optional " +#~ "and add additional functionality to your" +#~ " package. Not all packages will have" +#~ " feature dependencies." #~ msgstr "" #~ "Pythonパッケージの依存関係には、オプションのものと必須のものの2つの大きなグループがあります。必須パッケージとは、ユーザがあなたのパッケージを使うために必要なパッケージのことです。オプションの依存関係とは、パッケージの機能を追加するために、ユーザーがインストールを選択できるパッケージのことです。この2つのグループの中で、3つのユースケースを考えることができます。1." #~ " コアの依存関係は、ユーザがあなたのパッケージを使うために **必須** です。2. " @@ -6497,11 +6970,11 @@ msgstr "" #~ "within your package's code. On this " #~ "page we refer to these dependencies " #~ "as **core dependencies** as they are " -#~ "needed in order to run your " -#~ "package. You should place your core " -#~ "or required dependencies in the " -#~ "`dependencies` key of the `[project]` " -#~ "table of your `pyproject.toml` file." +#~ "needed in order to run your package." +#~ " You should place your core or " +#~ "required dependencies in the `dependencies` " +#~ "key of the `[project]` table of your" +#~ " `pyproject.toml` file." #~ msgstr "" #~ "必要な依存関係は、パッケージのコード内で直接呼び出されます。このページでは、パッケージを実行するために必要なこれらの依存関係を " #~ "**コア依存関係** と呼びます。 `pyproject.toml` ファイルの " @@ -6519,14 +6992,13 @@ msgstr "" #~ msgid "" #~ "**Development dependencies**: These are " -#~ "dependencies that are required to " -#~ "support development of your package. " -#~ "They include tools to run tests " -#~ "such as `pytest`, linters (like `flake8`" -#~ " and `ruff`) and code formatters such" -#~ " as `black` and even automation tools" -#~ " such as `nox` or `tox` that " -#~ "run tasks." +#~ "dependencies that are required to support" +#~ " development of your package. They " +#~ "include tools to run tests such as" +#~ " `pytest`, linters (like `flake8` and " +#~ "`ruff`) and code formatters such as " +#~ "`black` and even automation tools such " +#~ "as `nox` or `tox` that run tasks." #~ msgstr "" #~ "**開発依存** :これらは、あなたのパッケージの開発をサポートするために必要な依存関係です。pytest` " #~ "のようなテストを実行するツールや、 ( `flake8` や `ruff` " @@ -6534,13 +7006,10 @@ msgstr "" #~ " や `tox` のような自動化ツールも含まれます。" #~ msgid "" -#~ "**Feature dependencies:** These are " -#~ "dependencies that a user can chose " -#~ "to install to add functionality to " -#~ "your package." -#~ msgstr "" -#~ "**Feature dependencies:** これらは、パッケージに機能を追加するために、ユーザーが " -#~ "インストールを選択できる依存関係です。" +#~ "**Feature dependencies:** These are dependencies" +#~ " that a user can chose to install" +#~ " to add functionality to your package." +#~ msgstr "**Feature dependencies:** これらは、パッケージに機能を追加するために、ユーザーが インストールを選択できる依存関係です。" #~ msgid "" #~ "When a Python project is installed, " @@ -6551,8 +7020,8 @@ msgstr "" #~ " specific dependency, it is available " #~ "in your user's environment." #~ msgstr "" -#~ "Python プロジェクトがインストールされると、Python パッケージマネージャ (`pip`" -#~ " または `conda`) " +#~ "Python プロジェクトがインストールされると、Python パッケージマネージャ (`pip` " +#~ "または `conda`) " #~ "はパッケージの依存関係を自動的にインストールします。これにより、特定の依存関係にある関数を呼び出すと、ユーザーの環境でその関数が利用できるようになります。" #~ msgid "Dependencies can be added to your pyproject.toml file" @@ -6563,9 +7032,9 @@ msgstr "" #~ " `requirements.txt` file to declare package" #~ " dependencies. However in recent years, " #~ "the ecosystem has moved to storing " -#~ "this information in your **pyproject.toml**" -#~ " file. You may notice however that" -#~ " some projects still maintain a " +#~ "this information in your **pyproject.toml** " +#~ "file. You may notice however that " +#~ "some projects still maintain a " #~ "`requirements.txt` file for specific local " #~ "development needs." #~ msgstr "" @@ -6579,31 +7048,30 @@ msgstr "" #~ msgstr "パッケージが依存関係を保存する他の方法" #~ msgid "" -#~ "Your core project dependencies need to" -#~ " be installed by a package manager" -#~ " such as `pip` or `conda` when " -#~ "a user installs your package. You " -#~ "can add those dependencies to the " +#~ "Your core project dependencies need to " +#~ "be installed by a package manager " +#~ "such as `pip` or `conda` when a " +#~ "user installs your package. You can " +#~ "add those dependencies to the " #~ "`dependencies` array located within the " -#~ "`[project]` table of your **pyproject.toml**" -#~ " file. This looks something like " -#~ "this:" +#~ "`[project]` table of your **pyproject.toml** " +#~ "file. This looks something like this:" #~ msgstr "" #~ "コアプロジェクトの依存関係は、ユーザがパッケージをインストールするときに `pip` や `conda`" #~ " のようなパッケージマネージャによってインストールされる必要があります。 " -#~ "これらの依存関係は、**pyproject.toml** ファイルの `[project]` " -#~ "テーブルにある `dependencies` 配列に追加することができます。 これは次のようになります:" +#~ "これらの依存関係は、**pyproject.toml** ファイルの `[project]` テーブルにある" +#~ " `dependencies` 配列に追加することができます。 これは次のようになります:" #~ msgid "" #~ "Ideally, you should only list the " -#~ "packages that are necessary to install" -#~ " and use your package in the " +#~ "packages that are necessary to install " +#~ "and use your package in the " #~ "`dependencies` key in the `[project]` " #~ "table. This minimizes the number of " #~ "additional packages that your users must" -#~ " install as well as the number " -#~ "of packages that depend upon your " -#~ "package must also install." +#~ " install as well as the number of" +#~ " packages that depend upon your package" +#~ " must also install." #~ msgstr "" #~ "理想的には、 `[project]` テーブルの `dependencies` " #~ "キーに、あなたのパッケージをインス トールして使用するために必要なパッケージだけをリストするようにしま す。 " @@ -6617,11 +7085,11 @@ msgstr "" #~ "Let's pretend you have a package " #~ "called `plotMe` that creates beautiful " #~ "plots of data stored in `numpy` " -#~ "arrays. To create your plots in " -#~ "the `plotMe` package, you use the " -#~ "`seaborn` package to stylize our plots" -#~ " and also `numpy` to process array" -#~ " formatted data." +#~ "arrays. To create your plots in the" +#~ " `plotMe` package, you use the " +#~ "`seaborn` package to stylize our plots " +#~ "and also `numpy` to process array " +#~ "formatted data." #~ msgstr "" #~ "`numpy` 配列に格納されたデータの美しいプロットを作成する `plotMe` " #~ "というパッケージがあるとしましょう。 `plotMe` パッケージでプロットを作成するには、 " @@ -6638,29 +7106,29 @@ msgstr "" #~ msgstr "numpy" #~ msgid "" -#~ "This means that in order for " -#~ "plotMe to work in a user's " -#~ "`environment` when installed, you also " -#~ "need to ensure that they have both" -#~ " of those required `dependencies` installed" -#~ " in their environment too." +#~ "This means that in order for plotMe" +#~ " to work in a user's `environment` " +#~ "when installed, you also need to " +#~ "ensure that they have both of those" +#~ " required `dependencies` installed in their" +#~ " environment too." #~ msgstr "" -#~ "つまり、plotMeをインストールしたユーザーの `環境` で動作させるためには、そのユーザーの環境にも必要な" -#~ " `依存関係` の両方がインストールされていることを確認する必要があります。" +#~ "つまり、plotMeをインストールしたユーザーの `環境` で動作させるためには、そのユーザーの環境にも必要な " +#~ "`依存関係` の両方がインストールされていることを確認する必要があります。" #~ msgid "" #~ "Declaring a dependency in your " -#~ "`pyproject.toml` file will ensure that " -#~ "it is listed as a required " -#~ "dependency when your package is " -#~ "published to PyPI and that a " -#~ "package manager (`pip` or `conda`) will" -#~ " automatically install it into a " -#~ "user's environment alongside your package:" +#~ "`pyproject.toml` file will ensure that it" +#~ " is listed as a required dependency " +#~ "when your package is published to " +#~ "PyPI and that a package manager " +#~ "(`pip` or `conda`) will automatically " +#~ "install it into a user's environment " +#~ "alongside your package:" #~ msgstr "" #~ "依存関係を `pyproject.toml` ファイルで宣言することで、あなたのパッケージが PyPI" -#~ " に公開されるときに必須の依存関係としてリストされ、パッケージマネージャ ( `pip` や" -#~ " `conda` ) があなたのパッケージと一緒にユーザーの環境に自動的にインストールするようになります:" +#~ " に公開されるときに必須の依存関係としてリストされ、パッケージマネージャ ( `pip` や " +#~ "`conda` ) があなたのパッケージと一緒にユーザーの環境に自動的にインストールするようになります:" #~ msgid "`python -m pip install plotMe`" #~ msgstr "`python -m pip install plotMe`" @@ -6672,22 +7140,21 @@ msgstr "" #~ "are often referred to as development " #~ "dependencies. These are the dependencies " #~ "that a user needs to work on " -#~ "your package locally and perform tasks" -#~ " such as:" +#~ "your package locally and perform tasks " +#~ "such as:" #~ msgstr "" -#~ "ドキュメントの構築、テストの実行、パッケージの配布ファイルの構築のための " -#~ "オプションの依存関係は、しばしば開発依存関係と呼ばれます。 " -#~ "これらは、ユーザがあなたのパッケージをローカルで作業し、以下のようなタスクを実行するために必要な依存関係です:" +#~ "ドキュメントの構築、テストの実行、パッケージの配布ファイルの構築のための オプションの依存関係は、しばしば開発依存関係と呼ばれます。" +#~ " これらは、ユーザがあなたのパッケージをローカルで作業し、以下のようなタスクを実行するために必要な依存関係です:" #~ msgid "linting and other code cleanup tools" #~ msgstr "リンティングとその他のコードクリーンナップツール" #~ msgid "" -#~ "These dependencies are considered optional," -#~ " because they are not required to " -#~ "install and use your package. Feature" -#~ " dependencies are considered optional and" -#~ " should also be placed in the " +#~ "These dependencies are considered optional, " +#~ "because they are not required to " +#~ "install and use your package. Feature " +#~ "dependencies are considered optional and " +#~ "should also be placed in the " #~ "`[project.optional-dependencies]` table." #~ msgstr "" #~ "これらの依存関係はオプションとみなされます。なぜなら、あなたのパッケ ージをインストールして使用するのに必要ではないからです。" @@ -6695,23 +7162,23 @@ msgstr "" #~ " テーブルに置く必要があります。" #~ msgid "" -#~ "Optional dependencies can be stored in" -#~ " an `[project.optional-dependencies]` table " -#~ "in your **pyproject.toml** file." +#~ "Optional dependencies can be stored in " +#~ "an `[project.optional-dependencies]` table in" +#~ " your **pyproject.toml** file." #~ msgstr "" #~ "オプションの依存関係は **pyproject.toml** ファイルの `[project" #~ ".optional-dependencies]` テーブルに格納することができます。" #~ msgid "" #~ "It's important to note that within " -#~ "the `[project.optional-dependencies]` table, " -#~ "you can store additional, optional " -#~ "dependencies within named sub-groups. " -#~ "This is a different table than the" -#~ " dependencies array located within the " -#~ "`[project]` table discussed above which " -#~ "contains a single array with a " -#~ "single list of required packages." +#~ "the `[project.optional-dependencies]` table, you" +#~ " can store additional, optional dependencies" +#~ " within named sub-groups. This is " +#~ "a different table than the dependencies" +#~ " array located within the `[project]` " +#~ "table discussed above which contains a " +#~ "single array with a single list of" +#~ " required packages." #~ msgstr "" #~ "ここで重要なのは、 `[project.optional-dependencies]` " #~ "テーブルの中で、名前付きサブグループの中に追加のオプションの依存関係を格納できることです。これは、上で説明した " @@ -6731,9 +7198,9 @@ msgstr "" #~ msgid "" #~ "Below we've created three sets of " -#~ "optional development dependencies named: " -#~ "tests, docs and lint. We've also " -#~ "added a set of feature dependencies." +#~ "optional development dependencies named: tests," +#~ " docs and lint. We've also added " +#~ "a set of feature dependencies." #~ msgstr "以下では、tests、docs、lintという3つのオプションの開発依存関係を作成しました。また、機能依存のセットも追加しました。" #~ msgid "Using `python -m pip install` vs. `pip install`" @@ -6749,10 +7216,10 @@ msgstr "" #~ msgstr "`python -m pip`" #~ msgid "" -#~ "To ensure this works as you want" -#~ " it to, activate your package's " -#~ "development environment prior to installing" -#~ " anything using `pip`." +#~ "To ensure this works as you want " +#~ "it to, activate your package's development" +#~ " environment prior to installing anything " +#~ "using `pip`." #~ msgstr "これが思い通りに動くようにするには、 `pip` を使って何かをインストールする前に、パッケージの開発環境を有効にしてください。" #~ msgid "" @@ -6778,8 +7245,8 @@ msgstr "" #~ msgid "" #~ "using pip. Below you install your " -#~ "package, required dependencies and optional" -#~ " test dependencies." +#~ "package, required dependencies and optional " +#~ "test dependencies." #~ msgstr "pipを使います。 以下では、パッケージ、必要な依存関係、オプションのテスト依存関係をインストールします。" #~ msgid "`python -m pip install \".[docs, tests, lint]\"`" @@ -6790,8 +7257,8 @@ msgstr "" #~ msgid "" #~ "There are different shell applications " -#~ "that you and your package contributors" -#~ " might use." +#~ "that you and your package contributors " +#~ "might use." #~ msgstr "あなたやパッケージの貢献者が使うかもしれません、さまざまなシェルアプリケーションがあります。" #~ msgid "zsh is the shell that comes by default on newer Mac OS computers" @@ -6827,17 +7294,17 @@ msgstr "" #~ msgid "" #~ "Above we reviewed how to install " -#~ "dependencies from your `pyproject.toml`. In" -#~ " some cases you may want to " -#~ "group sets of dependencies like so:" +#~ "dependencies from your `pyproject.toml`. In " +#~ "some cases you may want to group " +#~ "sets of dependencies like so:" #~ msgstr "" #~ "上記では、 `pyproject.toml` から依存関係をインストールする方法を説明しました。 " #~ "場合によっては、依存関係のセットをこのようにグループ化したいこともあるでしょう:" #~ msgid "" -#~ "The above allows you to install " -#~ "both the tests and docs dependency " -#~ "lists using the command:" +#~ "The above allows you to install both" +#~ " the tests and docs dependency lists" +#~ " using the command:" #~ msgstr "上記のコマンドを使えば、testsとdocsの両方の依存リストをインストールできます:" #~ msgid "`python -m pip install \".[dev]\"`" @@ -6855,31 +7322,29 @@ msgstr "" #~ msgid "" #~ "The `pyproject.toml` file allows you to" #~ " list any Python package published on" -#~ " PyPI (or on GitHub/ GitLab) as " -#~ "a dependency. Once you create this " -#~ "file, declare dependencies, [build your " -#~ "package](python-package-distribution-files-" -#~ "sdist-wheel.md) and [publish your package" -#~ " to PyPI](publish-python-package-pypi-" -#~ "conda.md), people can install both your" -#~ " package and all of it's dependencies" -#~ " with one command." +#~ " PyPI (or on GitHub/ GitLab) as a" +#~ " dependency. Once you create this file," +#~ " declare dependencies, [build your package" +#~ "](python-package-distribution-files-sdist-" +#~ "wheel.md) and [publish your package to " +#~ "PyPI](publish-python-package-pypi-conda.md), " +#~ "people can install both your package " +#~ "and all of it's dependencies with " +#~ "one command." #~ msgstr "" #~ "`pyproject.toml` ファイルを使うと、PyPI(またはGitHub/ " #~ "GitLab)で公開されているPythonパッケージを依存関係として列挙することができます。 " #~ "このファイルを作成し、依存関係を宣言し、 [パッケージをビルドする](python-package-" #~ "distribution-files-sdist-wheel.md) 、 " #~ "[パッケージをPyPIに公開する](publish-python-package-pypi-" -#~ "conda.md) " -#~ "とすると、1つのコマンドであなたのパッケージと依存関係のあるパッケージの両方をインストールすることができます。" +#~ "conda.md) とすると、1つのコマンドであなたのパッケージと依存関係のあるパッケージの両方をインストールすることができます。" #~ msgid "`python -m pip install your-package`" #~ msgstr "`python -m pip install your-package`" #~ msgid "" -#~ "This works great if your package " -#~ "is pure-python (no other languages " -#~ "used)." +#~ "This works great if your package is" +#~ " pure-python (no other languages used)." #~ msgstr "これは、パッケージが純粋なpython (他の言語が使われていない) のであれば、とてもうまくいきます。" #~ msgid "Support conda users with environment.yml files" @@ -6892,8 +7357,8 @@ msgstr "" #~ " to conda-forge (optionally), [by " #~ "submitting a recipe using " #~ "grayskull](https://www.pyopensci.org/python-package-guide" -#~ "/package-structure-code/publish-python-" -#~ "package-pypi-conda.html)." +#~ "/package-structure-code/publish-python-package-" +#~ "pypi-conda.html)." #~ msgstr "" #~ "上記のワークフローは、PyPIでパッケージを公開することを想定しています。そして、 " #~ "[grayskullを使ってレシピを投稿する](https://www.pyopensci.org/python-" @@ -6902,41 +7367,39 @@ msgstr "" #~ "forgeに(オプションで)公開する予定です。" #~ msgid "" -#~ "If you want to support conda " -#~ "users, you may want to also " -#~ "maintain a conda environment that they" -#~ " can use to install your package. " -#~ "Maintaining a conda environment will " -#~ "also help you test that your " -#~ "package installs as you expect into " -#~ "a conda environment." +#~ "If you want to support conda users," +#~ " you may want to also maintain a" +#~ " conda environment that they can use" +#~ " to install your package. Maintaining a" +#~ " conda environment will also help you" +#~ " test that your package installs as " +#~ "you expect into a conda environment." #~ msgstr "" #~ "conda ユーザーをサポートしたいのであれば、彼らがあなたのパッケージをインス トールするのに使える " -#~ "conda 環境も管理した方が良いでしょう。 conda 環境を維持することは、あなたのパッケージが" -#~ " conda 環境に期待通りにインストールされるかをテストするのにも役立ちます。" +#~ "conda 環境も管理した方が良いでしょう。 conda 環境を維持することは、あなたのパッケージが " +#~ "conda 環境に期待通りにインストールされるかをテストするのにも役立ちます。" #~ msgid "" #~ "If you use a conda environment for" -#~ " developing your tool, keep in mind" -#~ " that when you install your package" -#~ " using `python -m pip install -e " -#~ ".` (or using pip in general), " +#~ " developing your tool, keep in mind " +#~ "that when you install your package " +#~ "using `python -m pip install -e .`" +#~ " (or using pip in general), " #~ "dependencies will be installed from PyPI" #~ " rather than conda." #~ msgstr "" -#~ "ツールの開発にconda環境を使用している場合、 `python -m pip " -#~ "install -e .` " +#~ "ツールの開発にconda環境を使用している場合、 `python -m pip install" +#~ " -e .` " #~ "を使用してパッケージをインストールするとき（または一般的にpipを使用するとき）、依存関係はcondaではなくPyPIからインストールされることに注意してください。" #~ msgid "" -#~ "Thus, if you are running a conda" -#~ " environment, installing your package in" -#~ " \"editable\" mode risks dependency " -#~ "conflicts. This is particularly important " -#~ "if you have a spatial package that" -#~ " requires geospatial system libraries like" -#~ " GDAL or another system-level " -#~ "dependency." +#~ "Thus, if you are running a conda " +#~ "environment, installing your package in " +#~ "\"editable\" mode risks dependency conflicts." +#~ " This is particularly important if you" +#~ " have a spatial package that requires" +#~ " geospatial system libraries like GDAL " +#~ "or another system-level dependency." #~ msgstr "" #~ "したがって、conda環境を実行している場合、パッケージを \"editable \"モードでインス " #~ "トールすると、依存関係が衝突する危険性があります。 " @@ -6945,10 +7408,10 @@ msgstr "" #~ msgid "" #~ "Alternatively, you can install your " #~ "package using `python -m pip install " -#~ "-e . --no-deps` to only install" -#~ " the package. And install the rest" -#~ " of your dependencies using a conda" -#~ " environment file." +#~ "-e . --no-deps` to only install " +#~ "the package. And install the rest of" +#~ " your dependencies using a conda " +#~ "environment file." #~ msgstr "" #~ "あるいは、 `python -m pip install -e ." #~ " --no-deps` " @@ -6956,10 +7419,9 @@ msgstr "" #~ msgid "" #~ "If you are using Read the Docs " -#~ "to build your documentation, then you" -#~ " may need to install your " -#~ "dependencies using a **readthedocs.yaml** " -#~ "file." +#~ "to build your documentation, then you " +#~ "may need to install your dependencies " +#~ "using a **readthedocs.yaml** file." #~ msgstr "" #~ "Read the Docsを使用してドキュメントを構築している場合、 " #~ "**readthedocs.yaml** ファイルを使用して依存関係をインストールする必要があるかもしれません。" @@ -6980,27 +7442,27 @@ msgstr "" #~ msgstr "これは隠されています。TO" #~ msgid "" -#~ "This section provides guidance on your" -#~ " Python package's structure, code format," -#~ " and style. It also reviews the " +#~ "This section provides guidance on your " +#~ "Python package's structure, code format, " +#~ "and style. It also reviews the " #~ "various [packaging tools](python-package-" #~ "build-tools) you can use to [build" #~ "](python-package-distribution-files-sdist-" -#~ "wheel) and [publish](publish-python-" -#~ "package-pypi-conda) your Python package." +#~ "wheel) and [publish](publish-python-package-" +#~ "pypi-conda) your Python package." #~ msgstr "" #~ "このセクションでは、Python " #~ "パッケージの構造、コードフォーマット、スタイルに関するガイダンスを提供します。また、Pythonパッケージの [build" #~ "](python-package-distribution-files-sdist-" #~ "wheel) や [publish](publish-python-package-" -#~ "pypi-conda) に使える様々な [packaging tools" -#~ "](python-package-build-tools) もレビューしています。" +#~ "pypi-conda) に使える様々な [packaging tools](python-" +#~ "package-build-tools) もレビューしています。" #~ msgid "" #~ "If you want end-to-end tutorials," -#~ " check out our tutorial series that" -#~ " starts by introducing [what a Python" -#~ " package is](what-is-a-package)." +#~ " check out our tutorial series that " +#~ "starts by introducing [what a Python " +#~ "package is](what-is-a-package)." #~ msgstr "" #~ "チュートリアルが必要な場合は、 [Python パッケージとは](what-is-a-package)" #~ " 何かを紹介するところから始まるチュートリアルシリーズをご覧ください。" @@ -7008,12 +7470,11 @@ msgstr "" #~ msgid "" #~ "If you are confused by Python " #~ "packaging, you are not alone! The " -#~ "good news is that some great " -#~ "modern packaging tools ensure you follow" -#~ " best practices. Here, we review tool" -#~ " features and suggest tools you can" -#~ " use for your Python packaging " -#~ "workflow." +#~ "good news is that some great modern" +#~ " packaging tools ensure you follow best" +#~ " practices. Here, we review tool " +#~ "features and suggest tools you can " +#~ "use for your Python packaging workflow." #~ msgstr "" #~ "Python のパッケージングに戸惑っているのはあなただけではありません！ " #~ "良いニュースは、あなたがベストプラクティスに従っていることを保証する、いくつかの素晴らしい最新のパッケージングツールがあるということです。" @@ -7025,10 +7486,10 @@ msgstr "" #~ msgid "" #~ "src layout, flat layout and where " #~ "should tests folders live? No matter " -#~ "what your level of packaging knowledge" -#~ " is, this page will help you " -#~ "decide upon a package structure that " -#~ "follows modern python best practices." +#~ "what your level of packaging knowledge " +#~ "is, this page will help you decide" +#~ " upon a package structure that follows" +#~ " modern python best practices." #~ msgstr "" #~ "src レイアウト、フラットレイアウト、テストフォルダはどこに置くべきか？ " #~ "あなたのパッケージング知識のレベルに関係なく、このページは最新のpythonのベストプラクティスに従ったパッケージ構造を決める助けになるでしょう。" @@ -7039,8 +7500,8 @@ msgstr "" #~ msgid "" #~ "To publish your Python package on " #~ "PyPI, you will need to first build" -#~ " it. The act of \"building\" refers" -#~ " to the process of placing your " +#~ " it. The act of \"building\" refers " +#~ "to the process of placing your " #~ "package code and metadata into a " #~ "format that can be published on " #~ "PyPI. Learn more about building your " @@ -7061,13 +7522,11 @@ msgstr "" #~ msgid "" #~ "If you have a pure Python package," -#~ " it's a straight forward process to" -#~ " publish to both PyPI and then " -#~ "a Conda channel such as conda-" -#~ "forge. Learn more here." -#~ msgstr "" -#~ "純粋なPythonパッケージであれば、PyPIとconda-forgeのようなCondaチャネルの両方に公開するのは簡単です。" -#~ " 詳しくはこちら。" +#~ " it's a straight forward process to " +#~ "publish to both PyPI and then a " +#~ "Conda channel such as conda-forge. " +#~ "Learn more here." +#~ msgstr "純粋なPythonパッケージであれば、PyPIとconda-forgeのようなCondaチャネルの両方に公開するのは簡単です。 詳しくはこちら。" #~ msgid "" #~ "Semver (numeric versioning) and Calver " @@ -7091,8 +7550,8 @@ msgstr "" #~ "オプションの詳細と、なぜこれが重要なのかについては、こちらをご覧ください。" #~ msgid "" -#~ "Diagram showing the various front-end" -#~ " build tools that you can select " +#~ "Diagram showing the various front-end " +#~ "build tools that you can select " #~ "from. See the packaging tools page " #~ "to learn more about each tool." #~ msgstr "選択可能な様々なフロントエンドビルドツールを示す図。 各ツールの詳細については、パッケージングツールのページを参照してください。" @@ -7107,39 +7566,39 @@ msgstr "" #~ msgstr "コードをパッケージングする際に利用可能なオプションの概要を説明します。" #~ msgid "" -#~ "Suggest tools and approaches that both" -#~ " meet your needs and also support " +#~ "Suggest tools and approaches that both " +#~ "meet your needs and also support " #~ "existing standards." #~ msgstr "ニーズを満たし、かつ既存の基準をサポートするツールやアプローチを提案します。" #~ msgid "" -#~ "Suggest tools and approaches that will" -#~ " allow you to expand upon a " -#~ "workflow that may begin as a pure" -#~ " Python code and evolve into code " -#~ "that requires addition layers of " -#~ "complexity in the packaging build." +#~ "Suggest tools and approaches that will " +#~ "allow you to expand upon a workflow" +#~ " that may begin as a pure Python" +#~ " code and evolve into code that " +#~ "requires addition layers of complexity in" +#~ " the packaging build." #~ msgstr "純粋なPythonツールから始まり、パッケージングビルドに複雑なレイヤーを追加する必要のあるコードへと進化するワークフローを拡張することを可能にするコードやアプローチを提案します。" #~ msgid "" #~ "Align our suggestions with the most " -#~ "current, accepted [PEPs (Python Enhancement" -#~ " Protocols)](https://peps.python.org/pep-0000/) and the" -#~ " [Scientific Python community SPECs](https" +#~ "current, accepted [PEPs (Python Enhancement " +#~ "Protocols)](https://peps.python.org/pep-0000/) and the " +#~ "[Scientific Python community SPECs](https" #~ "://scientific-python.org/specs/)." #~ msgstr "" #~ "私たちの提案を、現在受け入れられている [PEPs (Python Enhancement " -#~ "Protocols)](https://peps.python.org/pep-0000/) と " -#~ "[Scientific Python community SPECs](https" -#~ "://scientific-python.org/specs/) に合わせます。" +#~ "Protocols)](https://peps.python.org/pep-0000/) と [Scientific" +#~ " Python community SPECs](https://scientific-" +#~ "python.org/specs/) に合わせます。" #~ msgid "" #~ "In an effort to maintain consistency " #~ "within our community, we also align " #~ "with existing best practices being " #~ "implemented by developers of core " -#~ "Scientific Python packages such as " -#~ "Numpy, SciPy and others." +#~ "Scientific Python packages such as Numpy," +#~ " SciPy and others." #~ msgstr "" #~ "私たちのコミュニティ内での一貫性を維持するために、NumpyやSciPyなどのScientific " #~ "Pythonのコアパッケージの開発者によって実装されている既存のベストプラクティスとも連携しています。" @@ -7148,17 +7607,16 @@ msgstr "" #~ msgstr "pyOpenSciのパッケージング推奨のガイドライン" #~ msgid "" -#~ "The flexibility of the Python " -#~ "programming language lends itself to a" -#~ " diverse range of tool options for" -#~ " creating a Python package. Python is" -#~ " so flexible that it is one of" -#~ " the few languages that can be " -#~ "used to wrap around other languages. " -#~ "The ability of Python to wrap " -#~ "other languages is one the reasons " -#~ "you will often hear Python described " -#~ "as a [\"glue\" " +#~ "The flexibility of the Python programming" +#~ " language lends itself to a diverse " +#~ "range of tool options for creating a" +#~ " Python package. Python is so flexible" +#~ " that it is one of the few " +#~ "languages that can be used to wrap" +#~ " around other languages. The ability of" +#~ " Python to wrap other languages is " +#~ "one the reasons you will often hear" +#~ " Python described as a [\"glue\" " #~ "language](https://numpy.org/doc/stable/user/c-info.python-as-" #~ "glue.html)\"" #~ msgstr "" @@ -7168,20 +7626,20 @@ msgstr "" #~ msgid "" #~ "If you are building a pure Python" -#~ " package, then your packaging setup " -#~ "can be simple. However, some scientific" -#~ " packages have complex requirements as " -#~ "they may need to support extensions " -#~ "or tools written in other languages " -#~ "such as C or C++." +#~ " package, then your packaging setup can" +#~ " be simple. However, some scientific " +#~ "packages have complex requirements as they" +#~ " may need to support extensions or " +#~ "tools written in other languages such " +#~ "as C or C++." #~ msgstr "純粋なPythonパッケージを構築するのであれば、パッケージングのセットアップは単純でよいです。しかし、科学的なパッケージの中には、CやC++のような他の言語で書かれた拡張機能やツールをサポートする必要があり、複雑な要件を持つものがあります。" #~ msgid "" #~ "To support the many different uses " #~ "of Python, there are many ways to" #~ " create a Python package. In this " -#~ "guide, we suggest packaging approaches " -#~ "and tools based on:" +#~ "guide, we suggest packaging approaches and" +#~ " tools based on:" #~ msgstr "" #~ "Python の様々な使い方をサポートするために、Python パッケージを作成する方法はたくさんあります。 " #~ "このガイドでは、パッケージングのアプローチとツールを提案します:" @@ -7205,21 +7663,20 @@ msgstr "" #~ msgstr "このガイドの提案はpyOpenSciのレビュー要件ではありません" #~ msgid "" -#~ "The suggestions for package layout in" -#~ " this section are made with the " +#~ "The suggestions for package layout in " +#~ "this section are made with the " #~ "intent of being helpful; they are " -#~ "not specific requirements for your " -#~ "package to be reviewed and accepted " -#~ "into our pyOpenSci open source " -#~ "ecosystem." +#~ "not specific requirements for your package" +#~ " to be reviewed and accepted into " +#~ "our pyOpenSci open source ecosystem." #~ msgstr "" #~ "このセクションのパッケージレイアウトの提案は、参考になることを意図しています。 " #~ "これらは、あなたのパッケージがpyOpenSciオープンソースエコシステムにレビューされ、受け入れられるための特定の要件ではありません。" #~ msgid "" -#~ "**python-requires**: is important to " -#~ "have in your `pyproject.toml` file as" -#~ " it helps pip install your package." +#~ "**python-requires**: is important to have" +#~ " in your `pyproject.toml` file as it" +#~ " helps pip install your package." #~ msgstr "" #~ "**python-requires**: `pyproject.toml`ファイルに記述することが重要です。 " #~ "これはpipがパッケージをインストールするのに役立つからです。" @@ -7230,12 +7687,12 @@ msgstr "" #~ msgid "" #~ "Prior to August 2017, Python package " #~ "metadata was stored either in the " -#~ "`setup.py` file or a `setup.cfg` file." -#~ " In recent years, there has been " -#~ "a shift to storing Python package " +#~ "`setup.py` file or a `setup.cfg` file. " +#~ "In recent years, there has been a" +#~ " shift to storing Python package " #~ "metadata in a much more user-" -#~ "readable `pyproject.toml` format. Having all" -#~ " metadata in a single file:" +#~ "readable `pyproject.toml` format. Having all " +#~ "metadata in a single file:" #~ msgstr "" #~ "2017年8月以前は、Pythonパッケージのメタデータは `setup.py` ファイルか " #~ "`setup.cfg` ファイルに保存されていました。 近年、Python " @@ -7253,24 +7710,24 @@ msgstr "" #~ "ends) such as (flit-core, hatchling, " #~ "pdm-build), and" #~ msgstr "" -#~ "(flit-core, hatchling, pdm-build)のような一連の異なる" -#~ " [ビルドバックエンド](https://www.pyopensci.org/python-package-" -#~ "guide/package-structure-code/python-package-" -#~ "build-tools.html#build-back-ends) を使うことができます。" +#~ "(flit-core, hatchling, pdm-build)のような一連の異なる " +#~ "[ビルドバックエンド](https://www.pyopensci.org/python-package-guide" +#~ "/package-structure-code/python-package-build-" +#~ "tools.html#build-back-ends) を使うことができます。" #~ msgid "aligns with modern best practices." #~ msgstr "現代のベストプラクティスに合致しています。" #~ msgid "" -#~ "The standard file that Python packages" -#~ " use to [specify build requirements " -#~ "and metadata is called a " +#~ "The standard file that Python packages " +#~ "use to [specify build requirements and " +#~ "metadata is called a " #~ "**pyproject.toml**](https://packaging.python.org/en/latest/specifications" -#~ "/declaring-project-metadata/). Adding metadata," -#~ " build requirements and package " -#~ "dependencies to a **pyproject.toml** file " -#~ "replaces storing that information in a" -#~ " setup.py or setup.cfg file." +#~ "/declaring-project-metadata/). Adding metadata, " +#~ "build requirements and package dependencies " +#~ "to a **pyproject.toml** file replaces " +#~ "storing that information in a setup.py " +#~ "or setup.cfg file." #~ msgstr "" #~ "Python パッケージが [ビルド要件とメタデータを指定するために使う標準のファイルは " #~ "**pyproject.toml** " @@ -7280,15 +7737,15 @@ msgstr "" #~ "setup.cfg ファイルに情報を格納することに取って代わります。" #~ msgid "" -#~ "**dependencies:** dependencies are optional " -#~ "but we strongly suggest you include " -#~ "them in your pyproject.toml. Dependencies " -#~ "will be installed by pip when your" -#~ " project is installed creating a " -#~ "better user-experience." +#~ "**dependencies:** dependencies are optional but" +#~ " we strongly suggest you include them" +#~ " in your pyproject.toml. Dependencies will" +#~ " be installed by pip when your " +#~ "project is installed creating a better " +#~ "user-experience." #~ msgstr "" -#~ "**dependencies:** 依存関係はオプションですが、pyproject.tomlに含めることを強く推奨します。" -#~ " 依存関係はプロジェクトがインストールされるときにpipによってインストールされ、より良いユーザーエクスペリエンスを提供します。" +#~ "**dependencies:** 依存関係はオプションですが、pyproject.tomlに含めることを強く推奨します。 " +#~ "依存関係はプロジェクトがインストールされるときにpipによってインストールされ、より良いユーザーエクスペリエンスを提供します。" #~ msgid "License" #~ msgstr "License" @@ -7326,14 +7783,14 @@ msgstr "" #~ msgid "" #~ "The benefit of using the **src/package**" #~ " layout is that it ensures tests " -#~ "are run against the installed version" -#~ " of your package rather than the " +#~ "are run against the installed version " +#~ "of your package rather than the " #~ "files in your package working directory." #~ " If you run your tests on your" #~ " files rather than the installed " -#~ "version of your package, you may " -#~ "be missing issues that users encounter" -#~ " when your package is installed." +#~ "version of your package, you may be" +#~ " missing issues that users encounter " +#~ "when your package is installed." #~ msgstr "" #~ "**src/package** " #~ "レイアウトを使用する利点は、パッケージの作業ディレクトリ内のファイルではなく、インストールされたバージョンのパッケージに対してテストが実行されることを保証することです。" @@ -7342,57 +7799,56 @@ msgstr "" #~ msgid "" #~ "If `tests/` are outside the " -#~ "**src/package** directory, they aren't " -#~ "included in the package's [wheel](python-" -#~ "wheel). This makes your package size " -#~ "slightly smaller, which places a smaller" -#~ " storage burden on PyPI, and makes" -#~ " them faster to fetch." +#~ "**src/package** directory, they aren't included" +#~ " in the package's [wheel](python-wheel). " +#~ "This makes your package size slightly " +#~ "smaller, which places a smaller storage" +#~ " burden on PyPI, and makes them " +#~ "faster to fetch." #~ msgstr "" #~ "`tests/` が **src/package** ディレクトリの外にある場合、それらはパッケージの" #~ " [wheel](python-wheel) " #~ "には含まれません。これにより、パッケージのサイズがわずかに小さくなり、PyPIにかかるストレージの負担が小さくなり、フェッチが速くなります。" #~ msgid "" -#~ "[Read more about reasons to use " -#~ "the **src/package** layout](https://hynek.me/articles" -#~ "/testing-packaging/)" -#~ msgstr "" -#~ "[**src/package** " -#~ "レイアウトを使用する理由についてもっと読む](https://hynek.me/articles/testing-" +#~ "[Read more about reasons to use the" +#~ " **src/package** layout](https://hynek.me/articles/testing-" #~ "packaging/)" +#~ msgstr "" +#~ "[**src/package** レイアウトを使用する理由についてもっと読む](https://hynek.me/articles" +#~ "/testing-packaging/)" #~ msgid "How Python discovers and prioritizes importing modules" #~ msgstr "Pythonはどのようにインポートモジュールを検出し、優先順位をつけるか" #~ msgid "" -#~ "By default, Python adds a module " -#~ "in your current working directory to " -#~ "the front of the Python module " -#~ "search path." +#~ "By default, Python adds a module in" +#~ " your current working directory to the" +#~ " front of the Python module search " +#~ "path." #~ msgstr "デフォルトでは、Pythonは現在の作業ディレクトリにあるモジュールをPythonモジュール検索パスの先頭に追加します。" #~ msgid "" -#~ "This means that if you run your" -#~ " tests in your package's working " -#~ "directory, using a flat layout, " -#~ "`/package/module.py`, Python will discover " -#~ "`package/module.py` file before it discovers" -#~ " the installed package." +#~ "This means that if you run your " +#~ "tests in your package's working directory," +#~ " using a flat layout, `/package/module.py`," +#~ " Python will discover `package/module.py` " +#~ "file before it discovers the installed " +#~ "package." #~ msgstr "" #~ "つまり、パッケージの作業ディレクトリでフラットレイアウトの `/package/module.py` " #~ "を使ってテストを実行すると、Python はインストールされたパッケージを検出する前に " #~ "`package/module.py` ファイルを検出します。" #~ msgid "" -#~ "However, if your package lives in " -#~ "a src/ directory structure **src/package**," -#~ " then it won't be added to the" -#~ " Python path by default. This means" -#~ " that when you import your package," -#~ " Python will be forced to search " -#~ "the active environment (which has your" -#~ " package installed)." +#~ "However, if your package lives in a" +#~ " src/ directory structure **src/package**, " +#~ "then it won't be added to the " +#~ "Python path by default. This means " +#~ "that when you import your package, " +#~ "Python will be forced to search the" +#~ " active environment (which has your " +#~ "package installed)." #~ msgstr "" #~ "しかし、あなたのパッケージが src/ ディレクトリ構造の **src/package** " #~ "にある場合、デフォルトでは Python のパスに追加されません。 " @@ -7401,14 +7857,14 @@ msgstr "" #~ msgid "" #~ "Note: Python versions 3.11 and above " -#~ "have a path setting that can be" -#~ " adjusted to ensure the priority is" -#~ " to use installed packages first " -#~ "(e.g., `PYTHONSAFEPATH`)." +#~ "have a path setting that can be " +#~ "adjusted to ensure the priority is " +#~ "to use installed packages first (e.g., " +#~ "`PYTHONSAFEPATH`)." #~ msgstr "" #~ "注意: " -#~ "Pythonのバージョン3.11以上では、インストールされているパッケージを優先的に使うようにパスの設定を調整することができます " -#~ "( `PYTHONSAFEPATH` など)。" +#~ "Pythonのバージョン3.11以上では、インストールされているパッケージを優先的に使うようにパスの設定を調整することができます (" +#~ " `PYTHONSAFEPATH` など)。" #~ msgid "Don't include tests in your package wheel" #~ msgstr "パッケージホイールにテストを含めない" @@ -7416,23 +7872,23 @@ msgstr "" #~ msgid "" #~ "Writing [tests](tests-intro) for your " #~ "package is important; however, we do " -#~ "not recommend including tests as part" -#~ " of your [package wheel](python-wheel) " -#~ "by default. However, not including tests" -#~ " in your package distribution will " -#~ "make it harder for people other " -#~ "than yourself to test whether your " -#~ "package runs properly on their system." -#~ " If you have a small test suite" -#~ " (Python files + data), and think " -#~ "your users may want to run tests" -#~ " locally on their systems, you can" -#~ " include tests by moving the `tests/`" -#~ " directory into the **src/package** " -#~ "directory (see example below)." +#~ "not recommend including tests as part " +#~ "of your [package wheel](python-wheel) by" +#~ " default. However, not including tests " +#~ "in your package distribution will make " +#~ "it harder for people other than " +#~ "yourself to test whether your package " +#~ "runs properly on their system. If " +#~ "you have a small test suite (Python" +#~ " files + data), and think your " +#~ "users may want to run tests locally" +#~ " on their systems, you can include " +#~ "tests by moving the `tests/` directory " +#~ "into the **src/package** directory (see " +#~ "example below)." #~ msgstr "" -#~ "パッケージに [tests](tests-intro) " -#~ "を書くことは重要です、しかし、デフォルトでテストを [パッケージホイール](python-wheel) " +#~ "パッケージに [tests](tests-intro) を書くことは重要です、しかし、デフォルトでテストを" +#~ " [パッケージホイール](python-wheel) " #~ "の一部として含めることはお勧めしません。しかし、パッケージの配布にテストを含めないと、自分以外の人が自分のシステムでパッケージが正しく機能しているかどうかをテストすることが難しくなります。小さなテストスイート" #~ " (Python ファイル + データ) " #~ "を持っていて、ユーザが自分のシステムでローカルにテストを実行したいと思う場合、`tests/` ディレクトリを " @@ -7442,67 +7898,75 @@ msgstr "" #~ msgid "" #~ "Click here to read about our " #~ "packaging documentation requirements. ::: " -#~ ":::{admonition} Example scientific packages " -#~ "that use src/package layout * Sourmash" -#~ " * bokeh * openscm * awkward *" -#~ " poliastro ::: (src-layout-test)= " -#~ "## The src/ layout and testing " -#~ "The benefit of using the src/package " -#~ "layout is that it ensures tests " -#~ "are run against the installed version" -#~ " of your package rather than the " -#~ "files in your package working directory." -#~ " If you run your tests on your" -#~ " files rather than the installed " -#~ "version of your package, you may " -#~ "be missing issues that users encounter" -#~ " when your package is installed. If" -#~ " tests/ are outside the src/package " -#~ "directory, they aren't included in the" -#~ " package's wheel. This makes your " -#~ "package size slightly smaller, which " -#~ "places a smaller storage burden on " -#~ "PyPI, and makes them faster to " -#~ "fetch. - Read more about reasons " -#~ "to use the src/package layout " +#~ ":::{admonition} Example scientific packages that" +#~ " use src/package layout * Sourmash *" +#~ " bokeh * openscm * awkward * " +#~ "poliastro ::: (src-layout-test)= ## " +#~ "The src/ layout and testing The " +#~ "benefit of using the src/package layout" +#~ " is that it ensures tests are run" +#~ " against the installed version of your" +#~ " package rather than the files in " +#~ "your package working directory. If you " +#~ "run your tests on your files rather" +#~ " than the installed version of your " +#~ "package, you may be missing issues " +#~ "that users encounter when your package " +#~ "is installed. If tests/ are outside " +#~ "the src/package directory, they aren't " +#~ "included in the package's wheel. This " +#~ "makes your package size slightly smaller," +#~ " which places a smaller storage burden" +#~ " on PyPI, and makes them faster " +#~ "to fetch. - Read more about reasons" +#~ " to use the src/package layout " #~ ":::{admonition} How Python discovers and " #~ "prioritizes importing modules By default, " -#~ "Python adds a module in your " -#~ "current working directory to the front" -#~ " of the Python module search path." -#~ " This means that if you run " -#~ "your tests in your package's working " -#~ "directory, using a flat layout, " -#~ "/package/module.py, Python will discover " -#~ "package/module.py file before it discovers " -#~ "the installed package. However, if your" -#~ " package lives in a src/ directory" -#~ " structure src/package, then it won't " -#~ "be added to the Python path by " -#~ "default. This means that when you " -#~ "import your package, Python will be " -#~ "forced to search the active environment" -#~ " (which has your package installed). " -#~ "Note: Python versions 3.11 and above " -#~ "have a path setting that can be" -#~ " adjusted to ensure the priority is" -#~ " to use installed packages first " -#~ "(e.g., PYTHONSAFEPATH). ::: ### Don't " -#~ "include tests in your package wheel " -#~ "Writing tests for your package is " -#~ "important; however, we do not recommend" -#~ " including tests as part of your " -#~ "package wheel by default. However, not" -#~ " including tests in your package " -#~ "distribution will make it harder for " -#~ "people other than yourself to test " -#~ "whether your package runs properly on" -#~ " their system. If you have a " -#~ "small test suite (Python files + " -#~ "data), and think your users may " -#~ "want to run tests locally on their" -#~ " systems, you can include tests by" -#~ " moving the tests/ directory into the" -#~ " src/package directory (see example below)." -#~ " ```bash src/ package/ tests/ docs/" +#~ "Python adds a module in your current" +#~ " working directory to the front of " +#~ "the Python module search path. This " +#~ "means that if you run your tests " +#~ "in your package's working directory, using" +#~ " a flat layout, /package/module.py, Python" +#~ " will discover package/module.py file before" +#~ " it discovers the installed package. " +#~ "However, if your package lives in a" +#~ " src/ directory structure src/package, then" +#~ " it won't be added to the Python" +#~ " path by default. This means that " +#~ "when you import your package, Python " +#~ "will be forced to search the active" +#~ " environment (which has your package " +#~ "installed). Note: Python versions 3.11 " +#~ "and above have a path setting that" +#~ " can be adjusted to ensure the " +#~ "priority is to use installed packages " +#~ "first (e.g., PYTHONSAFEPATH). ::: ### " +#~ "Don't include tests in your package " +#~ "wheel Writing tests for your package " +#~ "is important; however, we do not " +#~ "recommend including tests as part of " +#~ "your package wheel by default. However," +#~ " not including tests in your package" +#~ " distribution will make it harder for" +#~ " people other than yourself to test " +#~ "whether your package runs properly on " +#~ "their system. If you have a small" +#~ " test suite (Python files + data), " +#~ "and think your users may want to " +#~ "run tests locally on their systems, " +#~ "you can include tests by moving the" +#~ " tests/ directory into the src/package " +#~ "directory (see example below). ```bash " +#~ "src/ package/ tests/ docs/" +#~ msgstr "" + +#~ msgid "" +#~ "**Feature Dependencies:** These are dependencies" +#~ " that are required if a user " +#~ "wants to access additional functionality " +#~ "(that is not core) to your package." +#~ " Store these in the `[project.optional-" +#~ "dependencies]` table of your pyproject.toml " +#~ "file." #~ msgstr "" diff --git a/locales/ja/LC_MESSAGES/tests.po b/locales/ja/LC_MESSAGES/tests.po index 554c1830..9a6c1ecf 100644 --- a/locales/ja/LC_MESSAGES/tests.po +++ b/locales/ja/LC_MESSAGES/tests.po @@ -28,10 +28,10 @@ msgstr "Pythonパッケージのテストスイートのコードカバレッジ #: ../../tests/code-cov.md:3 msgid "" -"Code coverage measures how much of your package's code runs during " -"testing. Achieving high coverage can help ensure the reliability of your " -"codebase, but it’s not a guarantee of quality. Below, we outline key " -"considerations for using code coverage effectively." +"Code coverage measures how much of your package's code runs during testing." +" Achieving high coverage can help ensure the reliability of your codebase, " +"but it’s not a guarantee of quality. Below, we outline key considerations " +"for using code coverage effectively." msgstr "" "コードカバレッジは、テスト中にパッケージのコードがどれだけ実行されるかを測定します。 " "高いカバレッジを達成することは、コードベースの信頼性を確保するのに役立ちますが、品質を保証するものではありません。 " @@ -50,8 +50,8 @@ msgstr "良い習慣は、テストスイートの間に、コードのすべて #: ../../tests/code-cov.md:13 #, fuzzy msgid "" -"**Identify untested parts:** Parts of your codebase that are not covered " -"by tests." +"**Identify untested parts:** Parts of your codebase that are not covered by" +" tests." msgstr "コードベースのテストされていない部分を特定します。" #: ../../tests/code-cov.md:15 @@ -74,8 +74,8 @@ msgstr "高いコードカバレッジは価値がありますが、それには #: ../../tests/code-cov.md:22 msgid "" -"**Difficult-to-test code:** Some parts of your code might be challenging " -"to test, either due to complexity or limited resources." +"**Difficult-to-test code:** Some parts of your code might be challenging to" +" test, either due to complexity or limited resources." msgstr "**テストしにくいコード:** コードの中には、複雑さや限られたリソースのために、テストが難しい部分があるかもしれません。" #: ../../tests/code-cov.md:24 @@ -101,24 +101,23 @@ msgid "" "Some common services for analyzing code coverage are " "[codecov.io](https://about.codecov.io/) and " "[coveralls.io](https://coveralls.io/). These projects are free for open " -"source tools and provide dashboards that show how much of your codebase " -"is covered during your tests. We recommend setting up an account (on " -"either CodeCov or Coveralls) and using it to keep track of your code " -"coverage." +"source tools and provide dashboards that show how much of your codebase is " +"covered during your tests. We recommend setting up an account (on either " +"CodeCov or Coveralls) and using it to keep track of your code coverage." msgstr "" "コードカバレッジを分析するための一般的なサービスには、 [codecov.io](https://codecov.io/) と " "[coveralls.io](https://coveralls.io/) があります。 " -"これらのプロジェクトはオープンソースのツールで無料であり、テスト中にコードベースがどの程度カバーされているかを示すダッシュボードを提供してくれます。" -" (CodeCovまたはCoverallsで) アカウントを設定し、コード・カバレッジを追跡するために使用することをお勧めします。" +"これらのプロジェクトはオープンソースのツールで無料であり、テスト中にコードベースがどの程度カバーされているかを示すダッシュボードを提供してくれます。 " +"(CodeCovまたはCoverallsで) アカウントを設定し、コード・カバレッジを追跡するために使用することをお勧めします。" #: ../../tests/code-cov.md:39 #, python-format msgid "" "Screenshot of the code cov service - showing test coverage for the " "stravalib package. This image shows a list of package modules and the " -"associated number of lines and % lines covered by tests. At the top of " -"the image, you can see what branch is being evaluated and the path to the" -" repository." +"associated number of lines and % lines covered by tests. At the top of the " +"image, you can see what branch is being evaluated and the path to the " +"repository." msgstr "" "code covサービスのスクリーンショット - stravalibパッケージのテストカバレッジを示します。 " "この画像は、パッケージモジュールのリストと、関連する行数およびテスト対象行の割合を示しています。 " @@ -128,11 +127,11 @@ msgstr "" #, fuzzy msgid "" "The CodeCov platform is a useful tool if you wish to track code coverage " -"visually. Using it, you can get the same summary information that you can" -" get with the **pytest-cov** extension. You can also see what lines are " +"visually. Using it, you can get the same summary information that you can " +"get with the **pytest-cov** extension. You can also see what lines are " "covered by your tests and which are not. Code coverage is useful for " -"evaluating [unit tests](test-types.md#unit-tests) and/or how much of your" -" package code is \"covered\". It, however, will not evaluate things like " +"evaluating [unit tests](test-types.md#unit-tests) and/or how much of your " +"package code is \"covered\". It, however, will not evaluate things like " "[integration tests](test-types.md#integration-tests) and [end-to-end " "workflows](test-types.md)." msgstr "" @@ -154,10 +153,10 @@ msgstr "ローカルカバレッジレポートのエクスポート" #: ../../tests/code-cov.md:62 msgid "" -"In addition to using services like CodeCov or Coveralls, you can generate" -" local coverage reports directly using the **coverage.py** tool. This can" -" be especially useful if you want to create reports in Markdown or HTML " -"format for offline use or documentation." +"In addition to using services like CodeCov or Coveralls, you can generate " +"local coverage reports directly using the **coverage.py** tool. This can be" +" especially useful if you want to create reports in Markdown or HTML format" +" for offline use or documentation." msgstr "" "CodeCovやCoverallsのようなサービスを利用するだけでなく、 **coverage.py** " "ツールを使って直接ローカルカバレッジレポートを作成することもできます。 " @@ -183,15 +182,15 @@ msgstr "どの行がカバーされているか、詳細でインタラクティ #: ../../tests/code-cov.md:83 #, fuzzy msgid "" -"The generated HTML report will be saved in a directory named `htmlcov` by" -" default. Open the `index.html` file in your browser to explore your " +"The generated HTML report will be saved in a directory named `htmlcov` by " +"default. Open the `index.html` file in your browser to explore your " "coverage results." msgstr "生成されたHTMLレポートは、デフォルトでhtmlcovというディレクトリに保存されます。index.htmlファイルをブラウザで開き、カバレッジ結果をご覧ください。" #: ../../tests/code-cov.md:87 msgid "" -"These local reports are an excellent way to quickly review coverage " -"without setting up an external service." +"These local reports are an excellent way to quickly review coverage without" +" setting up an external service." msgstr "このようなローカルレポートは、外部サービスを立ち上げることなくカバレッジを素早く確認する優れた方法です。" #: ../../tests/code-cov.md:90 ../../tests/run-tests-nox.md:168 @@ -203,11 +202,14 @@ msgstr "単体テスト" #: ../../tests/code-cov.md:92 msgid "" -"Writing meaningful tests is the foundation of useful coverage. See [Write" -" tests](write-tests.md) and [Test types](test-types.md) to learn more " -"about developing better test suites. Learn how to run your tests both " -"[locally](run-tests.md) and in [continuous integration](tests-ci.md)." +"Writing meaningful tests is the foundation of useful coverage. See [Write " +"tests](write-tests.md) and [Test types](test-types.md) to learn more about " +"developing better test suites. Learn how to run your tests both [locally" +"](run-tests.md) and in [continuous integration](tests-ci.md)." msgstr "" +"意味のあるテストを作成することは、有用なカバレッジの基礎です。より良いテスト スイートの開発の詳細については、[テストの書き込み](write-" +"tests.md) および [テストの種類](test-types.md) を参照してください。 [ローカル](run-tests.md) と " +"[継続的統合](tests-ci.md) の両方でテストを実行する方法を学びます。" #: ../../tests/index.md:70 msgid "Intro" @@ -249,8 +251,8 @@ msgstr "Pythonパッケージのテストとデータ" #: ../../tests/index.md:4 #, fuzzy msgid "" -"Adding tests to your package provides a set of checks that ensure that " -"its functioning how you expect it to." +"Adding tests to your package provides a set of checks that ensure that its " +"functioning how you expect it to." msgstr "" "テストは Python " "パッケージの重要な一部です。なぜなら、テストはパッケージが期待通りに動作しているかどうかを確認するための一連のチェック機能を提供するからです。" @@ -258,10 +260,10 @@ msgstr "" #: ../../tests/index.md:7 #, fuzzy msgid "" -"In this section, you will learn about the importance of writing tests for" -" your Python package, different [types of tests that you should consider" -"](test-types) and how you can set up infrastructure to run your tests " -"both [locally](run-tests) and [on GitHub](tests-ci)." +"In this section, you will learn about the importance of writing tests for " +"your Python package, different [types of tests that you should consider" +"](test-types) and how you can set up infrastructure to run your tests both " +"[locally](run-tests) and [on GitHub](tests-ci)." msgstr "" "このセクションでは、Python パッケージのテストを書くことの重要性と、ローカルと GitHub " "の両方でテストを実行するためのインフラストラクチャの設定方法について学びます。" @@ -273,8 +275,8 @@ msgstr "✨テストを書く理由✨" #: ../../tests/index.md:21 #, fuzzy msgid "" -"Learn about the importance of writing tests for your Python package and " -"how they help you and potential contributors." +"Learn about the importance of writing tests for your Python package and how" +" they help you and potential contributors." msgstr "" "Python パッケージのテストを書く技術についてもっと学びましょう。 " "なぜテストを書く必要があるのか、そしてテストがどのようにあなたやあなたのプロジェクトへの将来の貢献者の助けになるのかを学びましょう。" @@ -285,9 +287,9 @@ msgstr "✨テストの種類✨" #: ../../tests/index.md:30 msgid "" -"Get to know the three test types: unit, integration, and end-to-end " -"tests. Learn when and how to use each." -msgstr "" +"Get to know the three test types: unit, integration, and end-to-end tests. " +"Learn when and how to use each." +msgstr "単体テスト、統合テスト、エンドツーエンド テストの 3 つのテスト タイプについて理解します。それぞれをいつどのように使用するかを学びます。" #: ../../tests/index.md:34 msgid "✨ Run tests locally ✨" @@ -296,9 +298,12 @@ msgstr "✨ローカルでテストを実行する✨" #: ../../tests/index.md:39 msgid "" "Learn about testing tools like pytest, nox, and tox to run tests across " -"different Python versions on your computer. And explore examples of using" -" Hatch with UV as a task runner to run tests across Python versions." +"different Python versions on your computer. And explore examples of using " +"Hatch with UV as a task runner to run tests across Python versions." msgstr "" +"コンピューター上のさまざまな Python バージョン間でテストを実行するための、pytest、nox、tox などのテスト " +"ツールについて学びます。また、タスク ランナーとして Hatch with UV を使用して、Python " +"バージョン間でテストを実行する例を調べてください。" #: ../../tests/index.md:43 #, fuzzy @@ -309,7 +314,7 @@ msgstr "✨オンラインでテストを実行する(CIを使用する)✨" msgid "" "Nox is a python powered task runner that can be used to run tests. Learn " "how to use nox to run tests." -msgstr "" +msgstr "Nox は、テストの実行に使用できる Python を利用したタスク ランナーです。 nox を使用してテストを実行する方法を学びます。" #: ../../tests/index.md:51 msgid "✨ Run tests online (using CI) ✨" @@ -319,7 +324,7 @@ msgstr "✨オンラインでテストを実行する(CIを使用する)✨" msgid "" "Set up continuous integration with GitHub Actions to run tests across " "Python versions and operating systems." -msgstr "" +msgstr "GitHub Actions との継続的統合を設定して、Python のバージョンとオペレーティング システム間でテストを実行します。" #: ../../tests/index.md:60 #, fuzzy @@ -328,9 +333,9 @@ msgstr "コードカバレッジ" #: ../../tests/index.md:65 msgid "" -"Measure how much of your package code runs during tests. Learn to " -"generate local reports and visualize coverage online." -msgstr "" +"Measure how much of your package code runs during tests. Learn to generate " +"local reports and visualize coverage online." +msgstr "テスト中に実行されるパッケージ コードの量を測定します。ローカル レポートを生成し、オンラインでカバレッジを視覚化する方法を学びます。" #: ../../tests/run-tests.md:7 #, fuzzy @@ -339,21 +344,28 @@ msgstr "Pythonパッケージのテストを書く" #: ../../tests/run-tests.md:9 msgid "" -"Running your tests across different Python versions and operating systems" -" is critical to ensuring your package works for your users. Your users " -"may be running different versions of Python and operating systems than " -"you are." +"Running your tests across different Python versions and operating systems " +"is critical to ensuring your package works for your users. Your users may " +"be running different versions of Python and operating systems than you are." msgstr "" +"パッケージがユーザーに対して確実に動作するようにするには、さまざまな Python バージョンおよびオペレーティング " +"システム間でテストを実行することが重要です。ユーザーは、あなたとは異なるバージョンの Python やオペレーティング " +"システムを実行している可能性があります。" #: ../../tests/run-tests.md:13 msgid "" -"This page teaches you how to run tests locally in isolated environments " -"and across multiple Python versions. You'll learn about two main " -"automation tools: [**Hatch**](https://hatch.pypa.io/) and " -"[**Nox**](https://nox.thea.codes/en/stable/index.html). In the next " -"lesson, you will learn about running your tests online in [continuous " -"integration (CI)](tests-ci)." +"This page teaches you how to run tests locally in isolated environments and" +" across multiple Python versions. You'll learn about two main automation " +"tools: [**Hatch**](https://hatch.pypa.io/) and " +"[**Nox**](https://nox.thea.codes/en/stable/index.html). In the next lesson," +" you will learn about running your tests online in [continuous integration " +"(CI)](tests-ci)." msgstr "" +"このページでは、隔離された環境でローカルにテストを実行し、複数の Python バージョンにわたってテストを実行する方法を説明します。 " +"[**Hatch**](https://hatch.pypa.io/) と " +"[**Nox**](https://nox.thea.codes/en/stable/index.html) という 2 " +"つの主要な自動化ツールについて学習します。次のレッスンでは、[継続的インテグレーション (CI)](tests-ci) " +"でオンラインでテストを実行する方法を学習します。" #: ../../tests/run-tests.md:20 #, fuzzy @@ -363,12 +375,14 @@ msgstr "隔離された環境でのテストの実行" #: ../../tests/run-tests.md:22 msgid "" "When you develop a package on your computer, it works in one specific " -"environment: your Python version, your operating system, and your " -"installed dependencies. Your users, however, will run your code in many " -"different environments. By running your tests across multiple Python " -"versions and operating systems, you catch compatibility issues before " -"users do." +"environment: your Python version, your operating system, and your installed" +" dependencies. Your users, however, will run your code in many different " +"environments. By running your tests across multiple Python versions and " +"operating systems, you catch compatibility issues before users do." msgstr "" +"コンピューター上でパッケージを開発すると、パッケージは 1 つの特定の環境 (Python バージョン、オペレーティング " +"システム、インストールされている依存関係) で動作します。ただし、ユーザーはさまざまな環境でコードを実行します。複数の Python " +"バージョンとオペレーティング システムでテストを実行することで、ユーザーが発見する前に互換性の問題を発見できます。" #: ../../tests/run-tests.md:28 msgid "" @@ -376,36 +390,36 @@ msgid "" "tests pass because of your code, not because of unexpected dependencies " "installed on your computer. This gives you confidence that your package " "will work when others install it." -msgstr "" +msgstr "さらに、隔離された環境でテストを実行すると、コンピューターに予期しない依存関係がインストールされているためではなく、コードによってテストが合格することが保証されます。これにより、他の人がインストールしたときに自分のパッケージが動作するという確信が得られます。" #: ../../tests/run-tests.md:33 msgid "" -"On this page, you will learn about the tools that you can use to both run" -" tests in isolated environments and across Python versions." +"On this page, you will learn about the tools that you can use to both run " +"tests in isolated environments and across Python versions." msgstr "このページでは、隔離された環境でテストを実行したり、Python のバージョンを越えてテストを実行したりするために使えるツールについて学びます。" #: ../../tests/run-tests.md:37 msgid "**Related pages:**" -msgstr "" +msgstr "**関連ページ:**" #: ../../tests/run-tests.md:39 msgid "[Write tests](write-tests.md) for best practices on writing test suites" -msgstr "" +msgstr "テスト スイートの作成に関するベスト プラクティスについては、[テストの作成](write-tests.md)" #: ../../tests/run-tests.md:41 #, fuzzy msgid "" -"[Test types](test-types.md) to understand unit, integration, and end-to-" -"end tests" +"[Test types](test-types.md) to understand unit, integration, and end-to-end" +" tests" msgstr "ユニットテスト、統合テスト、エンドツーエンドテストの比較" #: ../../tests/run-tests.md:43 msgid "[Run tests online with CI](tests-ci.md) for GitHub Actions setup" -msgstr "" +msgstr "[CI を使用してオンラインでテストを実行する](tests-ci.md) (GitHub Actions セットアップ用)" #: ../../tests/run-tests.md:44 msgid "[Code coverage](code-cov.md) to measure how much code your tests cover" -msgstr "" +msgstr "[コード カバレッジ](code-cov.md) は、テストがカバーするコードの量を測定します。" #: ../../tests/run-tests.md:48 #, fuzzy @@ -415,18 +429,18 @@ msgstr "テストを実行するためのツール" #: ../../tests/run-tests.md:50 #, fuzzy msgid "" -"There are three categories of tools that will make it easier to setup and" -" run your tests in various environments:" +"There are three categories of tools that will make it easier to setup and " +"run your tests in various environments:" msgstr "さまざまな環境でのテストのセットアップと実行を容易にするツールには、3つのカテゴリーがあります:" #: ../../tests/run-tests.md:53 #, fuzzy msgid "" -"**Testing framework (pytest):** Provides the syntax and tools for writing" -" and running your tests. Learn more from the [pytest " +"**Testing framework (pytest):** Provides the syntax and tools for writing " +"and running your tests. Learn more from the [pytest " "documentation](https://docs.pytest.org/). Below you will learn about " -"pytest, the most commonly used testing framework in the scientific Python" -" ecosystem. Testing frameworks are essential for running tests, but they " +"pytest, the most commonly used testing framework in the scientific Python " +"ecosystem. Testing frameworks are essential for running tests, but they " "don't provide an easy way to run tests across Python versions or in " "isolated environments—that's where automation tools come in." msgstr "" @@ -438,29 +452,37 @@ msgstr "" #: ../../tests/run-tests.md:61 msgid "" -"**Automation tools (Nox, Tox, Hatch):** Allow you to run tests in " -"isolated environments and across multiple Python versions with a single " -"command. We focus on [**Hatch**](https://hatch.pypa.io/) and " +"**Automation tools (Nox, Tox, Hatch):** Allow you to run tests in isolated " +"environments and across multiple Python versions with a single command. We " +"focus on [**Hatch**](https://hatch.pypa.io/) and " "[**Nox**](https://nox.thea.codes/) below. These tools create virtual " -"environments automatically and ensure your tests run consistently. " -"However, they typically only test on your local operating system." +"environments automatically and ensure your tests run consistently. However," +" they typically only test on your local operating system." msgstr "" +"**自動化ツール (Nox、Tox、Hatch):** 単一のコマンドで、隔離された環境で複数の Python " +"バージョンにわたってテストを実行できます。以下では、[**Hatch**](https://hatch.pypa.io/) と " +"[**Nox**](https://nox.thea.codes/) " +"に焦点を当てます。これらのツールは仮想環境を自動的に作成し、テストが一貫して実行されることを保証します。ただし、通常はローカル オペレーティング " +"システム上でのみテストされます。" #: ../../tests/run-tests.md:69 msgid "" "**Continuous Integration (CI):** Runs your tests online across different " "operating systems (Windows, Mac, and Linux) and Python versions. CI " -"integrates with platforms like GitHub Actions to automatically test every" -" pull request and code change." +"integrates with platforms like GitHub Actions to automatically test every " +"pull request and code change." msgstr "" +"**継続的インテグレーション (CI):** さまざまなオペレーティング システム (Windows、Mac、Linux) および Python " +"バージョン間でオンラインでテストを実行します。 CI は GitHub Actions などのプラットフォームと統合して、すべてのプル " +"リクエストとコード変更を自動的にテストします。" #: ../../tests/run-tests.md:74 msgid "[Learn about CI here](ci-cd)." -msgstr "" +msgstr "[CI についてはこちらをご覧ください](ci-cd)。" #: ../../tests/run-tests.md:76 msgid "Quick comparison: what each tool does" -msgstr "" +msgstr "簡単な比較: 各ツールの機能" #: ../../tests/run-tests.md:78 #, fuzzy @@ -469,15 +491,15 @@ msgstr "テストフレームワーク (pytest)" #: ../../tests/run-tests.md:80 msgid "Runs your tests locally in your current Python environment" -msgstr "" +msgstr "現在の Python 環境でローカルにテストを実行します" #: ../../tests/run-tests.md:81 msgid "Provides the core syntax for writing tests (assertions, fixtures, etc.)" -msgstr "" +msgstr "テスト (アサーション、フィクスチャなど) を作成するためのコア構文を提供します。" #: ../../tests/run-tests.md:83 msgid "Can be extended with plugins (like pytest-cov for coverage)" -msgstr "" +msgstr "プラグインで拡張可能 (カバレッジ用の pytest-cov など)" #: ../../tests/run-tests.md:85 #, fuzzy @@ -491,15 +513,15 @@ msgstr "Pythonのバージョンにまたがってテストを実行する" #: ../../tests/run-tests.md:88 msgid "Create and manage isolated virtual environments automatically" -msgstr "" +msgstr "隔離された仮想環境を自動的に作成および管理する" #: ../../tests/run-tests.md:89 msgid "Can automate other tasks like building documentation" -msgstr "" +msgstr "ドキュメントの作成などの他のタスクを自動化できます" #: ../../tests/run-tests.md:90 msgid "Make it easy to reproduce test environments" -msgstr "" +msgstr "テスト環境を簡単に再現できるようにする" #: ../../tests/run-tests.md:92 #, fuzzy @@ -508,7 +530,7 @@ msgstr "継続的インテグレーション（GitHub Actions）" #: ../../tests/run-tests.md:94 msgid "Runs tests online automatically for every pull request" -msgstr "" +msgstr "プルリクエストごとにオンラインでテストを自動的に実行します" #: ../../tests/run-tests.md:95 #, fuzzy @@ -522,7 +544,7 @@ msgstr "Pythonのバージョンにまたがってテストを実行する" #: ../../tests/run-tests.md:97 msgid "Can automate deployments, releases, and other workflows" -msgstr "" +msgstr "導入、リリース、その他のワークフローを自動化できます" #: ../../tests/run-tests.md:99 msgid "What testing framework / package should I use to run tests?" @@ -530,16 +552,16 @@ msgstr "テストを実行するには、どのテストフレームワーク/ #: ../../tests/run-tests.md:101 msgid "" -"We recommend using `Pytest` to build and run your package tests. Pytest " -"is the most common testing tool used in the Python ecosystem." +"We recommend using `Pytest` to build and run your package tests. Pytest is " +"the most common testing tool used in the Python ecosystem." msgstr "" "パッケージテストのビルドと実行には `Pytest` を使うことを推奨します。 Pytest は Python " "のエコシステムで最もよく使われているテストツールです。" #: ../../tests/run-tests.md:103 msgid "" -"[The Pytest package](https://docs.pytest.org/en/latest/) also has a " -"number of extensions that can be used to add functionality such as:" +"[The Pytest package](https://docs.pytest.org/en/latest/) also has a number " +"of extensions that can be used to add functionality such as:" msgstr "" "[Pytestパッケージ](https://docs.pytest.org/en/latest/) " "には、以下のような機能を追加するために使用できる多くの拡張機能もあります：" @@ -548,9 +570,8 @@ msgstr "" #, fuzzy msgid "" "[pytest-cov](https://pytest-cov.readthedocs.io/en/latest/) allows you to " -"analyze the code coverage of your package during your tests, and " -"generates a report that you can [upload to " -"codecov](https://about.codecov.io/)." +"analyze the code coverage of your package during your tests, and generates " +"a report that you can [upload to codecov](https://about.codecov.io/)." msgstr "" "[pytest-cov](https://pytest-cov.readthedocs.io/en/latest/) " "を使うと、テスト中にパッケージのコードカバレッジを分析し、 [codecov](https://codecov.io/) " @@ -567,8 +588,8 @@ msgstr "コードカバレッジについてはこちらをご覧ください。 #: ../../tests/run-tests.md:113 msgid "" "Your editor or IDE may add additional convenience for running tests, " -"setting breakpoints, and toggling the `–no-cov` flag. Check your editor's" -" documentation for more information." +"setting breakpoints, and toggling the `–no-cov` flag. Check your editor's " +"documentation for more information." msgstr "" "お使いのエディタや IDE には、テストを実行したり、ブレークポイントを設定したり、 `-no-cov` " "フラグを切り替えたりするための便利な機能が追加されているかもしれません。 詳しくはエディタのドキュメントを参照してください。" @@ -589,9 +610,7 @@ msgstr "`pytest`" msgid "" "Or if you want to run a specific test file - let's call this file " "\"`test_module.py`\" - you can run:" -msgstr "" -"また、特定のテストファイル - このファイルを \"`test_module.py`\" と呼ぶことにします - " -"を実行したい場合は、次のようにします:" +msgstr "また、特定のテストファイル - このファイルを \"`test_module.py`\" と呼ぶことにします - を実行したい場合は、次のようにします:" #: ../../tests/run-tests.md:125 msgid "`pytest test_module.py`" @@ -603,15 +622,15 @@ msgid "" "Learn more about pytest [here](https://docs.pytest.org/en/stable/getting-" "started.html)." msgstr "" -"詳しくは [ドキュメントスタートガイド](https://docs.pytest.org/en/7.1.x/getting-" -"started.html) をご覧ください。" +"詳しくは [ドキュメントスタートガイド](https://docs.pytest.org/en/7.1.x/getting-started.html)" +" をご覧ください。" #: ../../tests/run-tests.md:129 msgid "" "Running pytest on your computer is going to run your tests in whatever " -"Python environment you currently have activated. This means that tests " -"will be run on a single version of Python and only on the operating " -"system that you are running locally." +"Python environment you currently have activated. This means that tests will" +" be run on a single version of Python and only on the operating system that" +" you are running locally." msgstr "" "あなたのコンピュータで pytest を実行すると、現在有効になっている Python 環境でテストが実行されます。 " "つまり、テストは単一のバージョンのPythonで、ローカルで実行しているオペレーティングシステム上でのみ実行されます。" @@ -641,15 +660,15 @@ msgstr "テストの実行を自動化するツール" #: ../../tests/run-tests.md:143 msgid "" -"To run tests on various Python versions or in various specific " -"environments with a single command, you can use an automation tool such " -"as `nox` or `tox`. Both `nox` and `tox` can create an isolated virtual " -"environments. This allows you to easily run your tests in multiple " -"environments and across Python versions." +"To run tests on various Python versions or in various specific environments" +" with a single command, you can use an automation tool such as `nox` or " +"`tox`. Both `nox` and `tox` can create an isolated virtual environments. " +"This allows you to easily run your tests in multiple environments and " +"across Python versions." msgstr "" "一つのコマンドで様々な Python のバージョンや特定の環境でテストを実行するには、 `nox` や `tox` " -"のような自動化ツールを使うことができます。 `nox` も `tox` も、隔離された仮想環境を作成することができます。 これにより、複数の環境や" -" Python のバージョンをまたいだテストを簡単に実行することができます。" +"のような自動化ツールを使うことができます。 `nox` も `tox` も、隔離された仮想環境を作成することができます。 これにより、複数の環境や " +"Python のバージョンをまたいだテストを簡単に実行することができます。" #: ../../tests/run-tests.md:146 msgid "" @@ -657,17 +676,20 @@ msgid "" "use in our [tutorials](create-pure-python-package) and for our [Python " "package template](https://github.com/pyOpenSci/pyos-package-template)." msgstr "" +"Hatch は [チュートリアル](create-pure-python-package) および [Python パッケージ " +"テンプレート](https://github.com/pyOpenSci/pyos-package-template) で使用するデフォルト " +"ツールであるため、このページでは Hatch に焦点を当てます。" #: ../../tests/run-tests.md:149 #, fuzzy msgid "" "If you are not a hatch fan, then [Nox](https://nox.thea.codes/) is an " -"alternative tool that we cover in the next lesson. `nox` is a Python-" -"based automation tool that builds upon the features of both `make` and " -"`tox`. `nox` is designed to simplify and streamline testing and " -"development workflows. Everything that you do with `nox` can be " -"implemented using a Python-based interface. You will learn more about " -"using nox [here](run-tests-nox)." +"alternative tool that we cover in the next lesson. `nox` is a Python-based " +"automation tool that builds upon the features of both `make` and `tox`. " +"`nox` is designed to simplify and streamline testing and development " +"workflows. Everything that you do with `nox` can be implemented using a " +"Python-based interface. You will learn more about using nox [here](run-" +"tests-nox)." msgstr "" "このガイドでは、 [Nox](https://nox.thea.codes/) に焦点を当てます。 `nox` は Python " "ベースの自動化ツールで、 `make` と `tox` の機能をベースにしています。 `nox` " @@ -681,8 +703,8 @@ msgstr "その他の自動化ツール" #: ../../tests/run-tests.md:154 msgid "" "**[Tox](https://tox.wiki/en/latest/index.html#useful-links)** is an " -"automation tool that supports common steps such as building " -"documentation, running tests across various versions of Python, and more." +"automation tool that supports common steps such as building documentation, " +"running tests across various versions of Python, and more." msgstr "" "**[Tox](https://tox.wiki/en/latest/index.html#useful-links)** " "は自動化ツールで、ドキュメントのビルドや、Pythonの様々なバージョン間でのテストの実行など、一般的なステップをサポートしています。" @@ -690,10 +712,10 @@ msgstr "" #: ../../tests/run-tests.md:159 #, fuzzy msgid "" -"**[Make](https://www.gnu.org/software/make/manual/make.html)** is a build" -" automation tool that some developers use for running tests due to its " -"versatility. However, Make's unique syntax can be challenging to learn, " -"and it won't manage environments for you like Hatch and Nox do." +"**[Make](https://www.gnu.org/software/make/manual/make.html)** is a build " +"automation tool that some developers use for running tests due to its " +"versatility. However, Make's unique syntax can be challenging to learn, and" +" it won't manage environments for you like Hatch and Nox do." msgstr "" "[**make:**](https://www.gnu.org/software/make/manual/make.html) " "ビルド自動化ツールであるMakeは汎用性が高いため、テストの実行に使う開発者もいます; " @@ -708,31 +730,34 @@ msgstr "pytest を使ってテストを実行する" #: ../../tests/run-tests.md:168 msgid "" "**Hatch** is a modern Python packaging and environment manager that " -"integrates test running capabilities directly into your `pyproject.toml`." -" Unlike Nox (which uses a separate `noxfile.py`), Hatch keeps all your " -"project configuration in one place, making it ideal if you're already " -"using Hatch for packaging workflows." +"integrates test running capabilities directly into your `pyproject.toml`. " +"Unlike Nox (which uses a separate `noxfile.py`), Hatch keeps all your " +"project configuration in one place, making it ideal if you're already using" +" Hatch for packaging workflows." msgstr "" +"**Hatch** は、テスト実行機能を `pyproject.toml` に直接統合する、最新の Python " +"パッケージングおよび環境マネージャーです。 Nox (別の `noxfile.py` を使用する) とは異なり、Hatch " +"はすべてのプロジェクト構成を 1 か所に保持するため、ワークフローのパッケージ化にすでに Hatch を使用している場合に最適です。" #: ../../tests/run-tests.md:174 msgid "Why Hatch for testing?" -msgstr "" +msgstr "なぜテストのためにハッチするのか?" #: ../../tests/run-tests.md:176 msgid "Configuration lives in `pyproject.toml` alongside your project metadata" -msgstr "" +msgstr "設定はプロジェクトのメタデータとともに `pyproject.toml` に保存されます" #: ../../tests/run-tests.md:178 msgid "Integrates seamlessly with Hatch's packaging and build workflows" -msgstr "" +msgstr "Hatch のパッケージ化およびビルド ワークフローとシームレスに統合" #: ../../tests/run-tests.md:179 msgid "No separate Python file needed (unlike Nox)" -msgstr "" +msgstr "(Nox とは異なり) 別の Python ファイルは必要ありません" #: ../../tests/run-tests.md:180 msgid "Easy to share standardized test environments across your team" -msgstr "" +msgstr "標準化されたテスト環境をチーム全体で簡単に共有" #: ../../tests/run-tests.md:182 #, fuzzy @@ -745,24 +770,29 @@ msgid "" "duplicating dependencies, use `dependency-groups` to reference your test " "dependencies:" msgstr "" +"ハッチ環境は `pyproject.toml` で定義されます。依存関係を複製するのではなく、「dependency-" +"groups」を使用してテストの依存関係を参照します。" #: ../../tests/run-tests.md:205 msgid "" "This approach keeps your test dependencies in one place and avoids " "duplication. For a complete example, see our [packaging template " -"tutorial](https://www.pyopensci.org/tutorials/create-python-package.html)" -" which shows a full `pyproject.toml` configuration." +"tutorial](https://www.pyopensci.org/tutorials/create-python-package.html) " +"which shows a full `pyproject.toml` configuration." msgstr "" +"このアプローチでは、テストの依存関係を 1 か所に保持し、重複を避けます。完全な例については、完全な `pyproject.toml` 構成を示す " +"[パッケージング テンプレート チュートリアル](https://www.pyopensci.org/tutorials/create-python-" +"package.html) を参照してください。" #: ../../tests/run-tests.md:210 msgid "Running tests with Hatch" -msgstr "" +msgstr "Hatch を使用したテストの実行" #: ../../tests/run-tests.md:212 msgid "" "Once you've defined your test environment, you can run tests with simple " "commands:" -msgstr "" +msgstr "テスト環境を定義したら、簡単なコマンドでテストを実行できます。" #: ../../tests/run-tests.md:215 #, fuzzy @@ -771,7 +801,7 @@ msgstr "テスト環境" #: ../../tests/run-tests.md:221 msgid "**Run pytest in the test environment:**" -msgstr "" +msgstr "**テスト環境で pytest を実行します:**" #: ../../tests/run-tests.md:228 #, fuzzy @@ -782,56 +812,63 @@ msgstr "Pythonのバージョンにまたがってテストを実行する" msgid "" "To test across multiple Python versions, define a matrix in your " "`pyproject.toml`:" -msgstr "" +msgstr "複数の Python バージョンにわたってテストするには、`pyproject.toml` でマトリックスを定義します。" #: ../../tests/run-tests.md:249 msgid "Then run all versions with a single command:" -msgstr "" +msgstr "次に、単一のコマンドですべてのバージョンを実行します。" #: ../../tests/run-tests.md:255 msgid "" -"Hatch will automatically run your tests on Python 3.10, 3.11, and 3.12. " -"If you only want to test a specific Python version:" +"Hatch will automatically run your tests on Python 3.10, 3.11, and 3.12. If " +"you only want to test a specific Python version:" msgstr "" +"Hatch は、Python 3.10、3.11、および 3.12 でテストを自動的に実行します。特定の Python " +"バージョンのみをテストしたい場合:" #: ../../tests/run-tests.md:262 msgid "Using Hatch in GitHub Actions" -msgstr "" +msgstr "GitHub アクションでのハッチの使用" #: ../../tests/run-tests.md:264 msgid "Hatch integrates well with CI/CD. Here's a minimal GitHub Actions setup:" -msgstr "" +msgstr "ハッチは CI/CD とうまく統合されます。最小限の GitHub Actions セットアップは次のとおりです。" #: ../../tests/run-tests.md:288 msgid "" -"Since all of your test dependencies are declared in the `dependency-" -"group` table of your `pyproject.toml`, your CI environment is " -"reproducible and consistent with the environments that you are using for " -"local testing." +"Since all of your test dependencies are declared in the `dependency-group` " +"table of your `pyproject.toml`, your CI environment is reproducible and " +"consistent with the environments that you are using for local testing." msgstr "" +"テストの依存関係はすべて `pyproject.toml` の `dependency-group` テーブルで宣言されているため、CI " +"環境は再現可能であり、ローカル テストに使用している環境と一貫性があります。" #: ../../tests/run-tests.md:292 msgid "Nox vs Hatch: choosing the right tool" -msgstr "" +msgstr "Nox と Hatch: 適切なツールの選択" #: ../../tests/run-tests.md:294 msgid "" "Both Hatch and Nox are excellent automation tools / task runners for " -"running tests across Python versions. Here's how they compare to help you" -" decide which fits your workflow:" +"running tests across Python versions. Here's how they compare to help you " +"decide which fits your workflow:" msgstr "" +"Hatch と Nox は両方とも、Python バージョン間でテストを実行するための優れた自動化ツール/タスク " +"ランナーです。どちらがワークフローに適しているかを判断するために、これらを比較する方法は次のとおりです。" #: ../../tests/run-tests.md:298 msgid "Hatch" -msgstr "" +msgstr "ハッチ" #: ../../tests/run-tests.md:300 msgid "" -"**Configuration:** Hatch uses a `declarative` configuration approach. You" -" tell it what goes into an environment and that empowers Hatch to create " -"the environment for you. All configuration settings live in your " +"**Configuration:** Hatch uses a `declarative` configuration approach. You " +"tell it what goes into an environment and that empowers Hatch to create the" +" environment for you. All configuration settings live in your " "`pyproject.toml` alongside your project metadata" msgstr "" +"**構成:** Hatch は「宣言的」構成アプローチを使用します。環境に何が入るかを伝えると、Hatch " +"が環境を作成できるようになります。すべての構成設定は、プロジェクトのメタデータとともに「pyproject.toml」内に存在します。" #: ../../tests/run-tests.md:302 msgid "" @@ -839,12 +876,14 @@ msgid "" "integrated automation / task runner. Using Hatch means you are using the " "same tool for all of your packaging and automation needs." msgstr "" +"**統合:** Hatch は、統合された自動化/タスク ランナーも備えたパッケージ管理ツールです。 Hatch " +"を使用すると、パッケージ化と自動化のすべてのニーズに同じツールを使用することになります。" #: ../../tests/run-tests.md:303 msgid "" -"**Learning curve:** Easier if you prefer declarative configuration over a" -" code based workflow" -msgstr "" +"**Learning curve:** Easier if you prefer declarative configuration over a " +"code based workflow" +msgstr "**学習曲線:** コードベースのワークフローよりも宣言的な構成を好む場合は簡単です" #: ../../tests/run-tests.md:304 msgid "" @@ -853,65 +892,73 @@ msgid "" "non pure python package you might prefer Nox. The scientific Python " "development guide has more details on this." msgstr "" +"**パッケージ化の範囲** Hatch " +"は、テストとパッケージ化に重点を置いた単純なワークフローに適しています。より複雑なビルドを使用している場合、または非純粋な Python " +"パッケージを作成している場合は、Nox を使用することをお勧めします。これについては、科学的な Python 開発ガイドに詳細が記載されています。" #: ../../tests/run-tests.md:305 msgid "" "**Best for:** Teams using Hatch for packaging, or those who want " "standardized configuration in one place" -msgstr "" +msgstr "**最適な用途:** パッケージ化に Hatch を使用しているチーム、または 1 か所で標準化された構成を必要としているチーム" #: ../../tests/run-tests.md:308 msgid "Nox" -msgstr "" +msgstr "ノックス" #: ../../tests/run-tests.md:310 msgid "**Configuration:** Python-driven via `noxfile.py` for maximum flexibility" -msgstr "" +msgstr "**構成:** 最大限の柔軟性を実現する「noxfile.py」経由の Python 駆動" #: ../../tests/run-tests.md:311 msgid "**Customization:** Great for complex workflows that need custom logic" -msgstr "" +msgstr "**カスタマイズ:** カスタム ロジックが必要な複雑なワークフローに最適" #: ../../tests/run-tests.md:312 msgid "" "**Learning curve:** Easier if you already know Python and want flexible " "session control" -msgstr "" +msgstr "**学習曲線:** すでに Python を知っており、柔軟なセッション制御が必要な場合は簡単です" #: ../../tests/run-tests.md:314 msgid "" -"**Best for:** Complex automation needs, building docs alongside tests, or" -" workflows that don't fit the standard model" -msgstr "" +"**Best for:** Complex automation needs, building docs alongside tests, or " +"workflows that don't fit the standard model" +msgstr "**最適な用途:** 複雑な自動化のニーズ、テストと並行してドキュメントを構築する、または標準モデルに適合しないワークフロー" #: ../../tests/run-tests.md:317 msgid "What we recommend" -msgstr "" +msgstr "私たちが推奨するもの" #: ../../tests/run-tests.md:319 msgid "" -"**If you're using Hatch for packaging:** Use Hatch for testing too. You " -"get everything in one place and one consistent tool." +"**If you're using Hatch for packaging:** Use Hatch for testing too. You get" +" everything in one place and one consistent tool." msgstr "" +"**パッケージ化に Hatch を使用している場合:** テストにも Hatch を使用します。すべてを 1 か所で、一貫した 1 " +"つのツールで入手できます。" #: ../../tests/run-tests.md:322 msgid "" -"**If you need maximum flexibility:** Choose Nox. Its Python-driven " -"approach lets you implement almost any workflow." -msgstr "" +"**If you need maximum flexibility:** Choose Nox. Its Python-driven approach" +" lets you implement almost any workflow." +msgstr "**最大限の柔軟性が必要な場合:** Nox を選択してください。 Python ベースのアプローチにより、ほぼすべてのワークフローを実装できます。" #: ../../tests/run-tests.md:325 msgid "" -"**If you're just starting out:** Start with Hatch. It's simpler to set up" -" and understand, and you can always switch to Nox later if you need to." -msgstr "" +"**If you're just starting out:** Start with Hatch. It's simpler to set up " +"and understand, and you can always switch to Nox later if you need to." +msgstr "**始めたばかりの場合:** Hatch から始めます。設定も理解も簡単で、必要に応じていつでも Nox に切り替えることができます。" #: ../../tests/run-tests.md:328 msgid "" -"**Both tools are good choices.** For a more comprehensive guide to using" -" Nox, see [Run tests with Nox](run-tests-nox.md) and the [Scientific " -"Python testing guide](https://scientific-python.org/tools/testing)." +"**Both tools are good choices.** For a more comprehensive guide to using " +"Nox, see [Run tests with Nox](run-tests-nox.md) and the [Scientific Python " +"testing guide](https://scientific-python.org/tools/testing)." msgstr "" +"**どちらのツールも良い選択です。** Nox を使用するためのより包括的なガイドについては、[Nox でテストを実行する](run-tests-" +"nox.md) および [科学的 Python テスト ガイド](https://scientific-" +"python.org/tools/testing) を参照してください。" #: ../../tests/run-tests.md:334 msgid "" @@ -920,25 +967,32 @@ msgid "" "continuous integration](tests-ci). You can also review [test types](test-" "types) and [write tests](write-tests) for your package." msgstr "" +"Python のバージョン間でテストをローカルで実行する方法を理解したので、[継続的インテグレーションを使用した GitHub Actions " +"でのテストの自動実行](tests-ci) について学習できます。パッケージの [テスト タイプ](test-types) および [書き込みテスト" +"](write-tests) を確認することもできます。" #: ../../tests/run-tests-nox.md:9 msgid "" -"**Nox** is a Python-based automation tool for running tests across " -"multiple Python versions and managing isolated test environments. If you " -"prefer Python-driven configuration over TOML, or need complex automation " +"**Nox** is a Python-based automation tool for running tests across multiple" +" Python versions and managing isolated test environments. If you prefer " +"Python-driven configuration over TOML, or need complex automation " "workflows, Nox is an excellent choice." msgstr "" +"**Nox** は、複数の Python バージョン間でテストを実行し、分離されたテスト環境を管理するための Python ベースの自動化ツールです。" +" TOML よりも Python ベースの構成を好む場合、または複雑な自動化ワークフローが必要な場合は、Nox が最適な選択肢です。" #: ../../tests/run-tests-nox.md:14 msgid "" "For more information about Nox, see the [official Nox " -"documentation](https://nox.thea.codes/) or the [Scientific Python guide " -"to testing](https://scientific-python.org/tools/testing)." +"documentation](https://nox.thea.codes/) or the [Scientific Python guide to " +"testing](https://scientific-python.org/tools/testing)." msgstr "" +"Nox の詳細については、[公式 Nox ドキュメント](https://nox.thea.codes/) または [Scientific " +"Python テスト ガイド](https://scientific-python.org/tools/testing) を参照してください。" #: ../../tests/run-tests-nox.md:18 msgid "Why Nox?" -msgstr "" +msgstr "なぜノックスなのか？" #: ../../tests/run-tests-nox.md:20 #, fuzzy @@ -957,11 +1011,11 @@ msgstr "ワークフローを実行するための隔離された環境を構築 #: ../../tests/run-tests-nox.md:24 msgid "Supports complex, custom automation beyond standard testing" -msgstr "" +msgstr "標準テストを超えた複雑なカスタム自動化をサポート" #: ../../tests/run-tests-nox.md:25 msgid "Is flexible and powerful for intricate build and test scenarios" -msgstr "" +msgstr "複雑なビルドおよびテストのシナリオに柔軟かつ強力です" #: ../../tests/run-tests-nox.md:27 #, fuzzy @@ -975,13 +1029,13 @@ msgstr "" #: ../../tests/run-tests-nox.md:31 msgid "Set up Nox" -msgstr "" +msgstr "Noxをセットアップする" #: ../../tests/run-tests-nox.md:33 #, fuzzy msgid "" -"To get started with Nox, you create a `noxfile.py` file at the root of " -"your project directory. You then define commands using Python functions." +"To get started with Nox, you create a `noxfile.py` file at the root of your" +" project directory. You then define commands using Python functions." msgstr "" "noxを使い始めるには、プロジェクトディレクトリのルートに `noxfile.py` ファイルを作成します。 " "そして、Pythonの関数を使ってコマンドを定義します。 以下にその例をいくつか挙ます。" @@ -994,13 +1048,13 @@ msgstr "Noxのインストール" #: ../../tests/run-tests-nox.md:39 #, fuzzy msgid "" -"When you install and use Nox to run tests across different Python " -"versions, Nox will create and manage individual `venv` environments for " -"each Python version that you specify in the Nox function. Nox will manage" -" each environment on its own." +"When you install and use Nox to run tests across different Python versions," +" Nox will create and manage individual `venv` environments for each Python " +"version that you specify in the Nox function. Nox will manage each " +"environment on its own." msgstr "" -"異なる Python バージョン間でテストを実行するために nox をインストールして使用する場合、nox は nox 関数で指定した " -"Python バージョンごとに個別の `venv` 環境を作成して管理します。" +"異なる Python バージョン間でテストを実行するために nox をインストールして使用する場合、nox は nox 関数で指定した Python " +"バージョンごとに個別の `venv` 環境を作成して管理します。" #: ../../tests/run-tests-nox.md:45 #, fuzzy @@ -1024,12 +1078,12 @@ msgid "" "By default, `nox` uses Python's built-in `venv` environment manager. A " "virtual environment (`venv`) is a self-contained Python environment that " "allows you to isolate and manage dependencies for different Python " -"projects. It helps ensure that project-specific libraries and packages do" -" not interfere with each other, promoting a clean and organized " -"development environment." +"projects. It helps ensure that project-specific libraries and packages do " +"not interfere with each other, promoting a clean and organized development " +"environment." msgstr "" -"デフォルトでは、 `nox` は Python 組み込みの `venv` 環境マネージャを使用します。 仮想環境 (`venv`) は自己完結型の" -" Python 環境で、異なる Python プロジェクトの依存関係を分離して管理することができます。 " +"デフォルトでは、 `nox` は Python 組み込みの `venv` 環境マネージャを使用します。 仮想環境 (`venv`) は自己完結型の " +"Python 環境で、異なる Python プロジェクトの依存関係を分離して管理することができます。 " "プロジェクト固有のライブラリやパッケージが互いに干渉しないようにし、クリーンで整理された開発環境を促進します。" #: ../../tests/run-tests-nox.md:58 @@ -1039,8 +1093,8 @@ msgstr "venv環境のnox" #: ../../tests/run-tests-nox.md:60 #, fuzzy msgid "" -"Below is an example of setting up Nox to run tests using `venv`, which is" -" the built-in environment manager that comes with base Python." +"Below is an example of setting up Nox to run tests using `venv`, which is " +"the built-in environment manager that comes with base Python." msgstr "以下は、Pythonに組み込まれている環境マネージャーである `venv` を使ってテストを実行するようにnoxをセットアップする例です。" #: ../../tests/run-tests-nox.md:63 @@ -1050,35 +1104,37 @@ msgid "" "`pyproject.toml` to declare test dependencies using `project.optional-" "dependencies`:" msgstr "" -"以下の例では、 [pipが理解できる方法でテストの依存関係を宣言するように`pyproject.toml`をセットアップする" -"](../package-structure-code/declare-dependencies.md) " -"ことを前提としていることに注意してください。 そのセットアップの例を以下に示します。" +"以下の例では、 [pipが理解できる方法でテストの依存関係を宣言するように`pyproject.toml`をセットアップする](../package-" +"structure-code/declare-dependencies.md) ことを前提としていることに注意してください。 " +"そのセットアップの例を以下に示します。" #: ../../tests/run-tests-nox.md:83 #, fuzzy msgid "" "With this setup, you can use `session.install(\".[tests]\")` to install " -"your test dependencies. Notice that below one single Nox session allows " -"you to run your tests on 4 different Python environments (Python 3.9, " -"3.10, 3.11, and 3.12)." +"your test dependencies. Notice that below one single Nox session allows you" +" to run your tests on 4 different Python environments (Python 3.9, 3.10, " +"3.11, and 3.12)." msgstr "" -"上記の設定ができていれば、 `session.install(\".[tests]\")` " -"を使ってテストの依存関係をインストールすることができます。 以下のように、1つのnoxセッションで4つの異なるPython環境（Python " +"上記の設定ができていれば、 `session.install(\".[tests]\")` を使ってテストの依存関係をインストールすることができます。" +" 以下のように、1つのnoxセッションで4つの異なるPython環境（Python " "3.9、3.10、3.11、3.12）でテストを実行できることに注意してください。" #: ../../tests/run-tests-nox.md:89 msgid "" "For this to run you will need to have python3.9, python3.10, python3.11, " -"and python3.12 installed on your computer. Otherwise nox will skip " -"running tests for whatever versions are missing." +"and python3.12 installed on your computer. Otherwise nox will skip running " +"tests for whatever versions are missing." msgstr "" +"これを実行するには、コンピューターに python3.9、python3.10、python3.11、および python3.12 " +"がインストールされている必要があります。それ以外の場合、nox は不足しているバージョンのテストの実行をスキップします。" #: ../../tests/run-tests-nox.md:107 #, fuzzy msgid "" "Above you create a Nox session in the form of a function with a " -"`@nox.session` decorator. Notice that within the decorator you declare " -"the versions of Python that you wish to run." +"`@nox.session` decorator. Notice that within the decorator you declare the " +"versions of Python that you wish to run." msgstr "" "上の例では、 `@nox.session` デコレーターを使って関数の形で nox セッションを作成しています。 デコレータの中で、実行したい " "python のバージョンを宣言していることに注意してください。" @@ -1087,8 +1143,8 @@ msgstr "" #, fuzzy msgid "" "To run the above, you'd execute the following command, specifying which " -"session with `--session` (sometimes shortened to `-s`). Your function " -"above is called `test`, therefore the session name is `test`:" +"session with `--session` (sometimes shortened to `-s`). Your function above" +" is called `test`, therefore the session name is `test`:" msgstr "" "上記を実行するには、 `--session` （ `-s` " "と短縮されることもある）でセッションを指定し、以下のコマンドを実行します。上記の関数はtestという名前なので、セッション名はtestです。" @@ -1110,8 +1166,8 @@ msgstr "" #: ../../tests/run-tests-nox.md:127 msgid "" -"For `conda` to work with `nox`, you will need to ensure that either " -"`conda` or `mamba` is installed on your computer." +"For `conda` to work with `nox`, you will need to ensure that either `conda`" +" or `mamba` is installed on your computer." msgstr "" "`nox` で `conda` を動作させるには、コンピュータに `conda` か `mamba` " "のどちらかがインストールされていることを確認する必要があります。" @@ -1122,36 +1178,40 @@ msgstr "上記のセッションを実行するには、次のようにします #: ../../tests/run-tests-nox.md:156 msgid "Hatch vs Nox" -msgstr "" +msgstr "ハッチvsノックス" #: ../../tests/run-tests-nox.md:158 msgid "" -"If you're trying to decide between Hatch and Nox, see the [comparison and" -" recommendations on the main testing page](run-tests.md)." +"If you're trying to decide between Hatch and Nox, see the [comparison and " +"recommendations on the main testing page](run-tests.md)." msgstr "" +"Hatch と Nox のどちらを選択するか迷っている場合は、[メインのテスト ページの比較と推奨事項](run-tests.md) " +"を参照してください。" #: ../../tests/run-tests-nox.md:161 msgid "In summary" -msgstr "" +msgstr "要約すれば" #: ../../tests/run-tests-nox.md:163 msgid "" "**Choose Hatch** if you're already using Hatch for packaging and want " "everything in one place" -msgstr "" +msgstr "**すでにパッケージングに Hatch を使用していて、すべてを 1 か所にまとめたい場合は、Hatch を選択してください**" #: ../../tests/run-tests-nox.md:165 msgid "" "**Choose Nox** if you need maximum flexibility, prefer Python-driven " "configuration, or need complex automation workflows" -msgstr "" +msgstr "**最大限の柔軟性が必要な場合、Python ベースの構成を好む場合、または複雑な自動化ワークフローが必要な場合は、Nox を選択してください**" #: ../../tests/run-tests-nox.md:170 msgid "" "Now that you understand how to run tests locally with Nox, you can learn " -"about [running tests automatically with continuous integration](tests-ci)" -" or [running tests with Hatch](run-tests.md)." +"about [running tests automatically with continuous integration](tests-ci) " +"or [running tests with Hatch](run-tests.md)." msgstr "" +"Nox を使用してローカルでテストを実行する方法を理解したので、[継続的インテグレーションを使用してテストを自動的に実行する](tests-ci) " +"または [Hatch を使用してテストを実行する](run-tests.md) について学ぶことができます。" #: ../../tests/test-types.md:1 msgid "Test Types for Python packages" @@ -1164,8 +1224,8 @@ msgstr "3種類のテスト: 単体テスト、統合テスト、機能テスト #: ../../tests/test-types.md:5 msgid "" -"There are different types of tests that you want to consider when " -"creating your test suite:" +"There are different types of tests that you want to consider when creating " +"your test suite:" msgstr "テストスイートを作成する際に考慮したいテストには、さまざまなタイプがあります:" #: ../../tests/test-types.md:8 ../../tests/test-types.md:15 @@ -1184,25 +1244,25 @@ msgstr "エンドツーエンド(機能テストとも呼ばれる)テスト" #: ../../tests/test-types.md:12 #, fuzzy msgid "" -"Each type of test has a different purpose. Here, you will learn about all" -" three types of tests by working through simple examples." +"Each type of test has a different purpose. Here, you will learn about all " +"three types of tests by working through simple examples." msgstr "それぞれのテストには異なる目的があります。 ここでは、3種類のテストすべてについて学びます。" #: ../../tests/test-types.md:17 msgid "" "A unit test involves testing individual components or units of code in " -"isolation to ensure that they work correctly. The goal of unit testing is" -" to verify that each part of the software, typically at the function or " +"isolation to ensure that they work correctly. The goal of unit testing is " +"to verify that each part of the software, typically at the function or " "method level, performs its intended task correctly." msgstr "単体テストは、個々のコンポーネントやコードの単位を分離してテストし、それらが正しく動作することを確認するものです。単体テストの目的は、ソフトウェアの各部分、通常は関数やメソッドのレベルが、意図したタスクを正しく実行することを検証することです。" #: ../../tests/test-types.md:22 #, fuzzy msgid "" -"Unit tests can be compared to examining each piece of your puzzle to " -"ensure parts or subsections of it are not broken. If all of the pieces of" -" that section of your puzzle don't fit together, you will never complete " -"it. Similarly, when working with code, tests ensure that each function, " +"Unit tests can be compared to examining each piece of your puzzle to ensure" +" parts or subsections of it are not broken. If all of the pieces of that " +"section of your puzzle don't fit together, you will never complete it. " +"Similarly, when working with code, tests ensure that each function, " "attribute, class, and method works properly when isolated." msgstr "単体テストは、パズルの各パーツが壊れていないかどうかを調べることに例えることができます。パズルのピースがすべて合わなければ、完成することはありません。同様に、コードを扱う場合、テストは各関数、プロパティ、クラス、メソッドが分離されたときに正しく機能することを保証します。" @@ -1210,9 +1270,9 @@ msgstr "単体テストは、パズルの各パーツが壊れていないかど #, fuzzy msgid "" "**Unit test example:** Suppose you have a function that adds two numbers " -"together. A unit test for that function ensures that when provided with " -"two numbers, it returns the correct sum. This is a unit test because it " -"checks a single unit (function) in isolation." +"together. A unit test for that function ensures that when provided with two" +" numbers, it returns the correct sum. This is a unit test because it checks" +" a single unit (function) in isolation." msgstr "" "**ユニットテスト例:** " "温度値を摂氏から華氏に変換する関数があるとします。その関数のテストは、摂氏の値が提供されたとき、その関数が正しい華氏の値を返すことを保証するかもしれません。この関数はユニットテストです。これは、コード内の1つのユニット(関数)をチェックします。" @@ -1227,70 +1287,71 @@ msgstr "上記の関数のユニットテスト例。このテストは、 **tes msgid "" "Notice that the tests above don't just test one case where numbers are " "added together. Instead, they test multiple scenarios: adding positive " -"numbers, adding a negative number, and adding zero. This helps ensure " -"that the `add_numbers` function behaves correctly in different situations" -" and is the beginning of thinking about programming defensively." +"numbers, adding a negative number, and adding zero. This helps ensure that " +"the `add_numbers` function behaves correctly in different situations and is" +" the beginning of thinking about programming defensively." msgstr "" +"上記のテストは、数値を加算する 1 " +"つのケースだけをテストするわけではないことに注意してください。代わりに、正の数の追加、負の数の追加、ゼロの追加などの複数のシナリオをテストします。これは、「add_numbers」関数がさまざまな状況で正しく動作することを保証するのに役立ち、防御的なプログラミングについて考える始まりになります。" #: ../../tests/test-types.md:83 msgid "" "You can run this test from your terminal using `pytest " "tests/test_math_utils.py`." -msgstr "" +msgstr "`pytest testing/test_math_utils.py` を使用してターミナルからこのテストを実行できます。" #: ../../tests/test-types.md:86 ../../tests/test-types.md:215 msgid "" -"image of puzzle pieces that all fit together nicely. The puzzle pieces " -"are colorful - purple, green and teal." +"image of puzzle pieces that all fit together nicely. The puzzle pieces are " +"colorful - purple, green and teal." msgstr "パズルのピースがうまく組み合わさったような画像です。パズルのピースは紫色、緑色、鴨の羽色とカラフルです。" #: ../../tests/test-types.md:90 msgid "" -"Your unit tests should ensure each part of your code works as expected on" -" its own." +"Your unit tests should ensure each part of your code works as expected on " +"its own." msgstr "ユニットテストでは、コードの各部分がそれ自体で期待通りに動作することを確認する必要があります。" #: ../../tests/test-types.md:95 msgid "" -"Integration tests involve testing how parts of your package work together" -" or integrate. Integration tests can be compared to connecting a bunch of" -" puzzle pieces together to form a whole picture. Integration tests focus " -"on how different pieces of your code fit and work together." +"Integration tests involve testing how parts of your package work together " +"or integrate. Integration tests can be compared to connecting a bunch of " +"puzzle pieces together to form a whole picture. Integration tests focus on " +"how different pieces of your code fit and work together." msgstr "統合テストでは、パッケージの各パーツがどのように連動するか、あるいは統合されるかをテストします。統合テストは、パズルのピースをつなげて全体像を作るようなものです。統合テストは、コードのさまざまな部分がどのように適合し、連携して動作するかに焦点を当てます。" #: ../../tests/test-types.md:100 msgid "" "For example, suppose you have functions that convert temperatures and " -"calculate statistics. An integration test would ensure that these " -"functions work together correctly in a workflow where you convert " -"temperatures and then analyze them." -msgstr "" +"calculate statistics. An integration test would ensure that these functions" +" work together correctly in a workflow where you convert temperatures and " +"then analyze them." +msgstr "たとえば、温度を変換し、統計を計算する関数があるとします。統合テストでは、温度を変換して分析するワークフロー内でこれらの機能が正しく連携して動作することを確認します。" #: ../../tests/test-types.md:178 msgid "" "Here's an integration test that checks how the conversion and statistics " "functions work together:" -msgstr "" +msgstr "以下は、変換関数と統計関数がどのように連携するかをチェックする統合テストです。" #: ../../tests/test-types.md:204 msgid "" -"This integration test verifies that the conversion and averaging " -"functions work together as expected in a real workflow." -msgstr "" +"This integration test verifies that the conversion and averaging functions " +"work together as expected in a real workflow." +msgstr "この統合テストでは、変換関数と平均化関数が実際のワークフローで期待どおりに連携して動作することを検証します。" #: ../../tests/test-types.md:207 msgid "" -"image of two puzzle pieces with some missing parts. The puzzle pieces are" -" purple teal yellow and blue. The shapes of each piece don’t fit " -"together." +"image of two puzzle pieces with some missing parts. The puzzle pieces are " +"purple teal yellow and blue. The shapes of each piece don’t fit together." msgstr "パズルのピースが2つあり、一部欠けている画像です。パズルのピースは紫・鴨の羽色・黄色・青色。 それぞれのピースの形が合いません。" #: ../../tests/test-types.md:212 msgid "" "If puzzle pieces have missing ends, they can’t work together with other " -"elements in the puzzle. The same is true with individual functions, " -"methods and classes in your software. The code needs to work both " -"individually and together to perform certain sets of tasks." +"elements in the puzzle. The same is true with individual functions, methods" +" and classes in your software. The code needs to work both individually and" +" together to perform certain sets of tasks." msgstr "パズルのピースの両端が欠けていると、パズルの他の要素と連動することができません。ソフトウェアの個々の関数、メソッド、クラスについても同様です。コードは、ある一連のタスクを実行するために、個々に、そして一緒に働く必要があります。" #: ../../tests/test-types.md:220 @@ -1306,8 +1367,8 @@ msgstr "エンドツーエンド(機能)テスト" #: ../../tests/test-types.md:226 #, fuzzy msgid "" -"End-to-end tests (also referred to as functional tests) in Python are " -"like comprehensive checklists for your software. They simulate real user " +"End-to-end tests (also referred to as functional tests) in Python are like " +"comprehensive checklists for your software. They simulate real user " "workflows to make sure the code base supports real-life applications and " "use-cases from start to finish. These tests help catch issues that might " "not show up in smaller tests and ensure your entire application behaves " @@ -1333,26 +1394,29 @@ msgstr "エンドツーエンドテストまたは機能テストは、パッケ msgid "" "**End-to-end test example:** Let's say your package opens and " "processes/converts temperature data from Celsius to Fahrenheit and then " -"calculates the average temperature. An end-to-end test would simulate " -"this entire workflow, ensuring that the package correctly handles the " -"input temperature data and returns a summary average value. An end-to-end" -" test would provide sample data, run the entire workflow, and verify that" -" the final output is correct." +"calculates the average temperature. An end-to-end test would simulate this " +"entire workflow, ensuring that the package correctly handles the input " +"temperature data and returns a summary average value. An end-to-end test " +"would provide sample data, run the entire workflow, and verify that the " +"final output is correct." msgstr "" +"**エンドツーエンドのテスト例:** " +"パッケージを開いて温度データを摂氏から華氏に処理/変換し、平均温度を計算するとします。エンドツーエンドのテストでは、このワークフロー全体をシミュレートし、パッケージが入力温度データを正しく処理し、要約平均値を返すことを確認します。エンドツーエンドのテストでは、サンプル" +" データを提供し、ワークフロー全体を実行して、最終出力が正しいことを確認します。" #: ../../tests/test-types.md:274 msgid "" -"This end-to-end test exercises the entire user workflow: providing sample" -" data, converting and averaging it, and verifying the output is correct." -msgstr "" +"This end-to-end test exercises the entire user workflow: providing sample " +"data, converting and averaging it, and verifying the output is correct." +msgstr "このエンドツーエンドのテストでは、サンプル データの提供、変換と平均化、出力が正しいことの確認というユーザー ワークフロー全体を実行します。" #: ../../tests/test-types.md:278 #, fuzzy msgid "" "End-to-end tests also verify how a program runs from start to finish. A " "tutorial that you add to your documentation and run in CI is another " -"example of an end-to-end test. For example, a Jupyter (`.ipynb`) notebook" -" or `.md` file with embedded code that demonstrates a complete user " +"example of an end-to-end test. For example, a Jupyter (`.ipynb`) notebook " +"or `.md` file with embedded code that demonstrates a complete user " "workflow." msgstr "エンドツーエンドのテストも、プログラムが最初から最後までどのように実行されるかをテストします。ドキュメントに追加するチュートリアルは、分離された環境のCIで実行され、エンドツーエンドのテストのもう一つの例です。" @@ -1360,49 +1424,48 @@ msgstr "エンドツーエンドのテストも、プログラムが最初から #, fuzzy msgid "" "For scientific packages, creating short tutorials that highlight core " -"workflows that your package supports, that are run when your " -"documentation is built, could also serve as end-to-end tests." +"workflows that your package supports, that are run when your documentation " +"is built, could also serve as end-to-end tests." msgstr "科学的なパッケージの場合、パッケージがサポートする中核的なワークフローを強調する短いチュートリアルを作成し、ドキュメントのビルド時に実行することで、エンドツーエンドのテストを兼ねることができます。" #: ../../tests/test-types.md:290 msgid "When to use which test type" -msgstr "" +msgstr "どのテストタイプをいつ使用するか" #: ../../tests/test-types.md:292 msgid "" -"If you’re new to testing, start with unit tests. They are the simplest to" -" write, fastest to run, and easiest to debug. As your package grows, you " -"can then add integration and end-to-end tests where they add the most " -"value." -msgstr "" +"If you’re new to testing, start with unit tests. They are the simplest to " +"write, fastest to run, and easiest to debug. As your package grows, you can" +" then add integration and end-to-end tests where they add the most value." +msgstr "テストが初めての場合は、単体テストから始めてください。これらは最も簡単に作成でき、最も速く実行でき、デバッグも簡単です。パッケージが成長するにつれて、最も価値が高まる統合テストとエンドツーエンドのテストを追加できます。" #: ../../tests/test-types.md:294 msgid "Start by writing unit tests" -msgstr "" +msgstr "単体テストを作成することから始めます" #: ../../tests/test-types.md:296 msgid "Are you testing a single function, method, or class in isolation?" -msgstr "" +msgstr "単一の関数、メソッド、またはクラスを分離してテストしていますか?" #: ../../tests/test-types.md:298 msgid "→ Yes: Write a [unit test](test-types.md#unit-tests)." -msgstr "" +msgstr "→ はい: [単体テスト](test-types.md#unit-tests) を作成します。" #: ../../tests/test-types.md:300 msgid "Example: Check that add_numbers(2, 3) returns 5" -msgstr "" +msgstr "例: add_numbers(2, 3) が 5 を返すことを確認します。" #: ../../tests/test-types.md:301 msgid "Unit tests don’t rely on other parts of your code" -msgstr "" +msgstr "単体テストはコードの他の部分に依存しません" #: ../../tests/test-types.md:302 msgid "These tests form the foundation of your test suite" -msgstr "" +msgstr "これらのテストはテスト スイートの基礎を形成します" #: ../../tests/test-types.md:303 msgid "If something breaks, unit tests make it easy to find where" -msgstr "" +msgstr "何かが壊れた場合、単体テストによりどこが壊れているかを簡単に見つけることができます。" #: ../../tests/test-types.md:305 #, fuzzy @@ -1411,53 +1474,53 @@ msgstr "統合テスト" #: ../../tests/test-types.md:307 msgid "Are you testing how multiple components work together?" -msgstr "" +msgstr "複数のコンポーネントがどのように連携して動作するかをテストしていますか?" #: ../../tests/test-types.md:309 msgid "→ **Yes:** Write [integration tests](test-types.md#integration-tests)." -msgstr "" +msgstr "→ **はい:** [統合テスト](test-types.md#integration-tests) と書き込みます。" #: ../../tests/test-types.md:311 msgid "Example: Converting temperatures and then computing their average" -msgstr "" +msgstr "例: 温度を変換し、その平均を計算する" #: ../../tests/test-types.md:312 msgid "Integration tests assume individual pieces already work" -msgstr "" +msgstr "統合テストは、個々の部分がすでに機能していることを前提としています" #: ../../tests/test-types.md:313 msgid "These tests verify that components interact correctly" -msgstr "" +msgstr "これらのテストは、コンポーネントが正しく相互作用することを検証します。" #: ../../tests/test-types.md:315 msgid "Use end-to-end tests for core workflows" -msgstr "" +msgstr "コアワークフローにエンドツーエンドテストを使用する" #: ../../tests/test-types.md:317 msgid "Are you testing a complete, realistic user workflow from start to finish?" -msgstr "" +msgstr "完全で現実的なユーザー ワークフローを最初から最後までテストしていますか?" #: ../../tests/test-types.md:319 msgid "" "→ **Yes:** Use an [end-to-end test](test-types.md#end-to-end-functional-" "tests)." -msgstr "" +msgstr "→ **はい:** [エンドツーエンド テスト](test-types.md#end-to-end-function-tests) を使用します。" #: ../../tests/test-types.md:321 msgid "Example: Run a full data-processing workflow a user would follow" -msgstr "" +msgstr "例: ユーザーが従うであろう完全なデータ処理ワークフローを実行する" #: ../../tests/test-types.md:322 msgid "These tests often mirror examples in your documentation" -msgstr "" +msgstr "これらのテストは多くの場合、ドキュメント内の例を反映しています。" #: ../../tests/test-types.md:323 msgid "Use them sparingly for the most important workflows." -msgstr "" +msgstr "最も重要なワークフローには慎重に使用してください。" #: ../../tests/test-types.md:324 msgid "Tutorials run during documentation builds can serve as end-to-end tests." -msgstr "" +msgstr "ドキュメントのビルド中に実行されるチュートリアルは、エンドツーエンドのテストとして機能します。" #: ../../tests/test-types.md:326 #, fuzzy @@ -1468,9 +1531,9 @@ msgstr "ユニットテスト、統合テスト、エンドツーエンドテス #, fuzzy msgid "" "Unit tests, integration tests, and end-to-end tests have complementary " -"advantages and disadvantages. The fine-grained nature of unit tests makes" -" them well-suited for isolating where errors are occurring. However, unit" -" tests are not useful for verifying that different sections of code work " +"advantages and disadvantages. The fine-grained nature of unit tests makes " +"them well-suited for isolating where errors are occurring. However, unit " +"tests are not useful for verifying that different sections of code work " "together." msgstr "" "単体テスト、統合テスト、エンドツーエンドテストには、それぞれ相補的な長所と短所があります。 " @@ -1483,29 +1546,33 @@ msgid "" "program work together, but are less valuable for immediately isolating " "exactly where errors are occurring." msgstr "" +"統合テストとエンドツーエンド " +"テストは、プログラムのさまざまな部分が連携して動作することを検証しますが、エラーが発生している場所を正確に即座に特定することにはあまり価値がありません。" #: ../../tests/test-types.md:338 msgid "Tests don't have to be perfect" -msgstr "" +msgstr "テストは完璧である必要はない" #: ../../tests/test-types.md:339 #, fuzzy msgid "" -"It is important to note that you don't need to spend energy worrying " -"about the specifics of test types. When you begin to work on your test " -"suite, consider what your package does and how you may need to test parts" -" of it. Being familiar with different test types provides a framework to " -"help you think about writing tests and how they can complement each " -"other." +"It is important to note that you don't need to spend energy worrying about " +"the specifics of test types. When you begin to work on your test suite, " +"consider what your package does and how you may need to test parts of it. " +"Being familiar with different test types provides a framework to help you " +"think about writing tests and how they can complement each other." msgstr "重要なのは、さまざまな種類のテストにまつわる詳細について心配することにエネルギーを費やす必要はないということです。テストスイートの作成に取りかかるときには、パッケージが何をするのか、そしてパッケージの一部をどのようにテストする必要があるのかを考えてください。さまざまな種類のテストに慣れ親しむことは、テストの書き方や、さまざまな種類のテストが互いにどのように補完し合えるかを考える際のフレームワークとなります。" #: ../../tests/test-types.md:348 msgid "" "Now that you understand test types, learn how to [write effective tests" "](write-tests) for your package. Then explore how to [run tests locally" -"](run-tests) and in [continuous integration](tests-ci). You can also " -"learn about tracking test coverage using tools like [CodeCov](code-cov)." +"](run-tests) and in [continuous integration](tests-ci). You can also learn " +"about tracking test coverage using tools like [CodeCov](code-cov)." msgstr "" +"テストの種類を理解したので、パッケージの [効果的なテストを作成する](テストの作成) 方法を学びましょう。次に、[ローカルでテストを実行する" +"](run-tests) および [継続的インテグレーション](tests-ci) で行う方法を調べます。 [CodeCov](code-cov) " +"などのツールを使用してテスト カバレッジの追跡について学ぶこともできます。" #: ../../tests/tests-ci.md:1 msgid "Run tests with Continuous Integration" @@ -1513,24 +1580,23 @@ msgstr "継続的インテグレーションによるテストの実行" #: ../../tests/tests-ci.md:3 msgid "" -"Running your [test suite locally](run-tests) is useful as you develop " -"code and also test new features or changes to the code base. However, you" -" also will want to setup Continuous Integration (CI) to run your tests " -"online. CI allows you to run all of your tests in the cloud. While you " -"may only be able to run tests locally on a specific operating system, " -"using CI you can specify tests to run both on various versions of Python " -"and across different operating systems." +"Running your [test suite locally](run-tests) is useful as you develop code " +"and also test new features or changes to the code base. However, you also " +"will want to setup Continuous Integration (CI) to run your tests online. CI" +" allows you to run all of your tests in the cloud. While you may only be " +"able to run tests locally on a specific operating system, using CI you can " +"specify tests to run both on various versions of Python and across " +"different operating systems." msgstr "" "[テストスイートをローカルで実行する](run-tests) " "ことは、コードを開発したり、新しい機能やコード・ベースの変更をテストしたりするときに便利です。しかし、テストをオンラインで実行するために、継続的インテグレーション（CI）もセットアップしたいです。CIを使えば、すべてのテストをクラウド上で実行できます。特定のオペレーティングシステム上でしかローカルにテストを実行できないかもしれませんが、CIを使用すると、Pythonのさまざまなバージョンや異なるオペレーティングシステム間で実行するテストを指定できます。" #: ../../tests/tests-ci.md:5 msgid "" -"CI can also be triggered for pull requests and pushes to your repository." -" This means that every pull request that you, your maintainer team or a " -"contributor submit, can be tested. In the end CI testing ensures your " -"code continues to run as expected even as changes are made to the code " -"base." +"CI can also be triggered for pull requests and pushes to your repository. " +"This means that every pull request that you, your maintainer team or a " +"contributor submit, can be tested. In the end CI testing ensures your code " +"continues to run as expected even as changes are made to the code base." msgstr "" "CIは、プルリクエストやリポジトリへのプッシュをトリガーすることもできます。 " "これは、あなた、あなたのメンテナチーム、またはコントリビューターが提出するすべてのプルリクエストをテストできることを意味します。 " @@ -1538,8 +1604,8 @@ msgstr "" #: ../../tests/tests-ci.md:9 msgid "" -"Learn more about Continuous Integration and how it can be used, here. " -"(add link)" +"Learn more about Continuous Integration and how it can be used, here. (add " +"link)" msgstr "継続的インテグレーションとその使用方法については、こちらをご覧ください。 (リンクを追加)" #: ../../tests/tests-ci.md:13 @@ -1548,12 +1614,12 @@ msgstr "CIとプルリクエスト" #: ../../tests/tests-ci.md:15 msgid "" -"CI is invaluable if you have outside people contributing to your " -"software. You can setup CI to run on all pull requests submitted to your " -"repository. CI can make your repository more friendly to new potential " -"contributors. It allows users to contribute code, documentation fixes and" -" more without having to create development environments, run tests and " -"build documentation locally." +"CI is invaluable if you have outside people contributing to your software. " +"You can setup CI to run on all pull requests submitted to your repository. " +"CI can make your repository more friendly to new potential contributors. It" +" allows users to contribute code, documentation fixes and more without " +"having to create development environments, run tests and build " +"documentation locally." msgstr "" "CIは、外部の人があなたのソフトウェアに貢献している場合、非常に貴重です。 " "リポジトリに投稿されたすべてのプルリクエストに対してCIを実行するように設定できます。 " @@ -1574,8 +1640,8 @@ msgstr "" #: ../../tests/tests-ci.md:28 msgid "" -"To work properly, this file should be located in a root directory of your" -" GitHub repository:" +"To work properly, this file should be located in a root directory of your " +"GitHub repository:" msgstr "正しく動作させるには、このファイルをGitHubリポジトリのルートディレクトリに置く必要があります:" #: ../../tests/write-tests.md:1 @@ -1585,11 +1651,11 @@ msgstr "Pythonパッケージのテストを書く" #: ../../tests/write-tests.md:3 #, fuzzy msgid "" -"**Writing code** that tests your package code, also known as test suites," -" is important for you as a maintainer, your users, and package " -"contributors. Test suites consist of sets of functions, methods, and " -"classes that are written with the intention of making sure a specific " -"part of your code works as you expected it to." +"**Writing code** that tests your package code, also known as test suites, " +"is important for you as a maintainer, your users, and package contributors." +" Test suites consist of sets of functions, methods, and classes that are " +"written with the intention of making sure a specific part of your code " +"works as you expected it to." msgstr "" "パッケージのコードをテストするコードを書くことは、テスト・スイートとしても知られています。 " "テスト・スイートは、関数、メソッド、クラスのセットで構成され、コードの特定の部分が期待通りに動作することを確認することを意図して書かれます。" @@ -1601,9 +1667,9 @@ msgstr "なぜパッケージのテストを書くのか？" #: ../../tests/write-tests.md:11 #, fuzzy msgid "" -"Tests act as a safety net for code changes. They help you identify and " -"fix bugs before they affect users. Tests also instill confidence that " -"code changes from contributors won't break existing functionality." +"Tests act as a safety net for code changes. They help you identify and fix " +"bugs before they affect users. Tests also instill confidence that code " +"changes from contributors won't break existing functionality." msgstr "" "テストはコード変更のセーフティネットとして機能します。 バグがユーザーに影響を与える前に発見し、修正するのに役立ちます。 " "テストはまた、貢献者によるコード改変が既存の機能を壊さないという確信を与えます。" @@ -1625,9 +1691,9 @@ msgstr "" #: ../../tests/write-tests.md:20 #, fuzzy msgid "" -"**Save time:** Imagine you have a magic button that can automatically " -"check if your package is still working properly. Tests are like that " -"magic button! They can run all those checks for you, saving you time." +"**Save time:** Imagine you have a magic button that can automatically check" +" if your package is still working properly. Tests are like that magic " +"button! They can run all those checks for you, saving you time." msgstr "" "**時間を節約する:** " "あなたのパッケージがまだ正常に動作しているかどうかを自動的にチェックできる魔法のボタンがあるとしましょう。テストは魔法のボタンのようなものです！ " @@ -1637,9 +1703,9 @@ msgstr "" #, fuzzy msgid "" "**Easier collaboration:** If you're working with others or have outside " -"contributors, tests help everyone stay on the same page. Your tests " -"explain how your package is supposed to work, making it easier for others" -" to understand and contribute to your project." +"contributors, tests help everyone stay on the same page. Your tests explain" +" how your package is supposed to work, making it easier for others to " +"understand and contribute to your project." msgstr "" "**より容易なコラボレーション:** " "他の人と一緒に仕事をしていたり、外部の協力者がいる場合、テストは全員が同じページにとどまるのに役立ちます。テストは、パッケージがどのように動作するかを説明し、他の人が理解しやすくし、プロジェクトに貢献しやすくします。" @@ -1659,8 +1725,8 @@ msgstr "" msgid "" "**Documentation:** Tests serve as technical examples of how to use your " "package. This can be helpful for new technical contributors who want to " -"contribute code to your package. They can look at your tests to " -"understand how parts of your code functionality fits together." +"contribute code to your package. They can look at your tests to understand " +"how parts of your code functionality fits together." msgstr "" "**文書化:** テストは、あなたのパッケージの使い方の技術的な例となります。 " "これは、あなたのパッケージにコードを提供しようとする新しい技術的貢献者にとって役に立ちます。 " @@ -1681,12 +1747,12 @@ msgid "" "**Easier pull request reviews:** By running your tests in a CI framework " "such as GitHub Actions, each time you or a contributor makes a change to " "your code-base, you can catch issues and things that may have changed in " -"your code base. This ensures that your software behaves the way you " -"expect it to." +"your code base. This ensures that your software behaves the way you expect " +"it to." msgstr "" "**より簡単なプルリクエストのレビュー:** GitHub Actionsのような CI " -"フレームワークでテストを実行することで、あなたや貢献者がコードベースに変更を加えるたびに、コードベースの問題や変更点をキャッチすることができます。" -" これにより、あなたのソフトウェアが期待通りに動作することが保証されます。" +"フレームワークでテストを実行することで、あなたや貢献者がコードベースに変更を加えるたびに、コードベースの問題や変更点をキャッチすることができます。 " +"これにより、あなたのソフトウェアが期待通りに動作することが保証されます。" #: ../../tests/write-tests.md:44 msgid "Tests for user edge cases" @@ -1694,12 +1760,12 @@ msgstr "ユーザーエッジケースのテスト" #: ../../tests/write-tests.md:46 msgid "" -"Edge cases refer to unexpected or \"outlier\" ways that some users may " -"use your package. Tests enable you to address various edge cases that " -"could impair your package's functionality. For example, what occurs if a " -"function expects a pandas `dataframe` but a user supplies a numpy " -"`array`? Does your code gracefully handle this situation, providing clear" -" feedback, or does it leave users frustrated by an unexplained failure?" +"Edge cases refer to unexpected or \"outlier\" ways that some users may use " +"your package. Tests enable you to address various edge cases that could " +"impair your package's functionality. For example, what occurs if a function" +" expects a pandas `dataframe` but a user supplies a numpy `array`? Does " +"your code gracefully handle this situation, providing clear feedback, or " +"does it leave users frustrated by an unexplained failure?" msgstr "" "エッジケースとは、あるユーザがあなたのパッケージを使用する際の、予期せぬ、あるいは \"外れ値\" の使い方を指します。 " "テストによって、パッケージの機能を損なう可能性のある様々なエッジケースに対処することができます。 例えば、ある関数がpandasの " @@ -1726,8 +1792,8 @@ msgstr "例えば、2つの数値aとbを足し合わせるPython関数がある #: ../../tests/write-tests.md:84 msgid "" -"A test to ensure that function runs as you might expect when provided " -"with different numbers might look like this:" +"A test to ensure that function runs as you might expect when provided with " +"different numbers might look like this:" msgstr "異なる数値が与えられたときに、その関数が期待通りに実行されることを確認するテストは次のようになります:" #: ../../tests/write-tests.md:103 @@ -1744,13 +1810,11 @@ msgstr "なぜパッケージのテストを書くのか？" msgid "" "there are [three types of tests Test Types for Python Packages](test-" "types.md) that can help guide your development." -msgstr "" +msgstr "開発のガイドに役立つ [3 種類のテスト Python パッケージのテスト タイプ](test-types.md) があります。" #: ../../tests/write-tests.md:108 -msgid "" -"your tests should consider how a user might use (and misuse!) your " -"package." -msgstr "" +msgid "your tests should consider how a user might use (and misuse!) your package." +msgstr "テストでは、ユーザーがパッケージをどのように使用 (そして悪用!) するかを考慮する必要があります。" #: ../../tests/write-tests.md:111 #, fuzzy @@ -1768,10 +1832,10 @@ msgstr "この時点で、あなたは疑問に思うかもしれません-あ #: ../../tests/write-tests.md:118 msgid "" -"**Test some typical cases:** Test that the package functions as you " -"expect it to when users use it. For instance, if your package is supposed" -" to add two numbers, test that the outcome value of adding those two " -"numbers is correct." +"**Test some typical cases:** Test that the package functions as you expect " +"it to when users use it. For instance, if your package is supposed to add " +"two numbers, test that the outcome value of adding those two numbers is " +"correct." msgstr "" "**いくつかの典型的なケースをテスト:** " "パッケージが、ユーザーが使用したときに期待通りに機能することをテストします。例えば、パッケージが2つの数値を足すことになっている場合、その2つの数値を足した結果が正しいかどうかをテストします。" @@ -1779,10 +1843,10 @@ msgstr "" #: ../../tests/write-tests.md:123 #, fuzzy msgid "" -"**Test special cases:** Sometimes there are special or outlier cases. For" -" instance, if a function performs a specific calculation that may become " -"problematic closer to the value of 0, test it with the input of both 0 " -"and nearby values." +"**Test special cases:** Sometimes there are special or outlier cases. For " +"instance, if a function performs a specific calculation that may become " +"problematic closer to the value of 0, test it with the input of both 0 and " +"nearby values." msgstr "" "**特別なケースをテストする:** " "時には特殊なケースや異常なケースもあります。例えば、ある関数が特定の計算を実行し、その計算が値=0に近いほど問題になる可能性がある場合、その関数の入力を0と" @@ -1791,59 +1855,59 @@ msgstr "" #, fuzzy msgid "" "**Test at and near expected boundaries:** If a function requires a value " -"that is greater than or equal to 1, make sure that the function still " -"works with the values 1 and 0.999, as well as 1.001 (values close to the " +"that is greater than or equal to 1, make sure that the function still works" +" with the values 1 and 0.999, as well as 1.001 (values close to the " "constraint). Make sure that the function fails gracefully when given " -"unexpected values and that the user can easily understand why it failed " -"by providing a useful error message." +"unexpected values and that the user can easily understand why it failed by " +"providing a useful error message." msgstr "" "**コードが正しく失敗するかテストする** 関数が1以上の値を必要とする場合は、0.999でテストします。 " "予期しない値やヘルプが与えられたときに、関数が差し障り無く失敗し、ユーザが失敗した理由を簡単に理解できるようにします(有用なエラーメッセージを提供します)。" #: ../../tests/write-tests.md:138 msgid "" -"Now that you understand what and why to test, explore the [three types of" -" tests](test-types.md) (unit, integration, and end-to-end) to determine " -"which style of tests best fits your package. Then, learn how to [run your" -" tests locally](run-tests.md) and [in continuous integration](tests-" -"ci.md). Finally, track your progress with [code coverage](code-cov.md) " -"metrics." +"Now that you understand what and why to test, explore the [three types of " +"tests](test-types.md) (unit, integration, and end-to-end) to determine " +"which style of tests best fits your package. Then, learn how to [run your " +"tests locally](run-tests.md) and [in continuous integration](tests-ci.md). " +"Finally, track your progress with [code coverage](code-cov.md) metrics." msgstr "" +"何をテストするのか、なぜテストするのかが理解できたので、[3 種類のテスト](test-types.md) (単体、統合、エンドツーエンド) " +"を調べて、パッケージに最適なテストのスタイルを決定します。次に、[ローカルでテストを実行する](run-tests.md) および " +"[継続的インテグレーションで](tests-ci.md) する方法を学びます。最後に、[コード カバレッジ](code-cov.md) " +"メトリクスを使用して進捗状況を追跡します。" #~ msgid "" #~ "There are three general types of " #~ "tests that you can write for your" -#~ " Python package: unit tests, integration" -#~ " tests and end-to-end (or " -#~ "functional) tests. Learn about all " -#~ "three." +#~ " Python package: unit tests, integration " +#~ "tests and end-to-end (or functional)" +#~ " tests. Learn about all three." #~ msgstr "" #~ "Python パッケージで書くことのできるテストには、ユニットテスト、統合テスト、エンドツーエンドテスト " #~ "(あるいは機能テスト) の 3 種類があります。 この 3 " #~ "つについて学びましょう。" #~ msgid "" -#~ "If you expect your users to use" -#~ " your package across different versions " -#~ "of Python, then using an automation " -#~ "tool such as nox to run your " -#~ "tests is useful. Learn about the " -#~ "various tools that you can use to" -#~ " run your tests across python " -#~ "versions here." +#~ "If you expect your users to use " +#~ "your package across different versions of" +#~ " Python, then using an automation tool" +#~ " such as nox to run your tests" +#~ " is useful. Learn about the various " +#~ "tools that you can use to run " +#~ "your tests across python versions here." #~ msgstr "" -#~ "もしユーザがあなたのパッケージを異なるバージョンの Python " -#~ "で使うことを想定しているなら、テストを実行するために nox のような自動化ツールを使うと便利です。 " -#~ "Python のバージョンにまたがってテストを実行するために使える様々なツールについては、こちらを参照してください。" +#~ "もしユーザがあなたのパッケージを異なるバージョンの Python で使うことを想定しているなら、テストを実行するために" +#~ " nox のような自動化ツールを使うと便利です。 Python " +#~ "のバージョンにまたがってテストを実行するために使える様々なツールについては、こちらを参照してください。" #~ msgid "" #~ "Continuous integration platforms such as " #~ "GitHub Actions can be useful for " #~ "running your tests across both different" -#~ " Python versions and different operating" -#~ " systems. Learn about setting up " -#~ "tests to run in Continuous Integration" -#~ " here." +#~ " Python versions and different operating " +#~ "systems. Learn about setting up tests " +#~ "to run in Continuous Integration here." #~ msgstr "" #~ "GitHub Actionsのような継続的インテグレーションプラットフォームは、Python " #~ "のバージョンやオペレーティングシステムの違いを問わずテストを実行するのに便利です。 " @@ -1859,12 +1923,12 @@ msgstr "" #~ "Running your tests is important to " #~ "ensure that your package is working " #~ "as expected. It's good practice to " -#~ "consider that tests will run on " -#~ "your computer and your users' computers" -#~ " that may be running a different " +#~ "consider that tests will run on your" +#~ " computer and your users' computers " +#~ "that may be running a different " #~ "Python version and operating systems. " -#~ "Think about the following when running" -#~ " your tests:" +#~ "Think about the following when running " +#~ "your tests:" #~ msgstr "" #~ "テストを実行することは、パッケージが期待通りに動作していることを確認するために重要です。 " #~ "テストは、あなたのコンピュータと、Python " @@ -1872,10 +1936,10 @@ msgstr "" #~ "テストを実行する際には、以下のことを考慮してください:" #~ msgid "" -#~ "Run your test suite in a matrix" -#~ " of environments that represent the " -#~ "Python versions and operating systems " -#~ "your users are likely to have." +#~ "Run your test suite in a matrix " +#~ "of environments that represent the Python" +#~ " versions and operating systems your " +#~ "users are likely to have." #~ msgstr "テストスイートは、Python のバージョンとユーザーが使用する可能性のあるオペレーティングシステムを表す環境のマトリックスで実行します。" #~ msgid "" @@ -1885,13 +1949,12 @@ msgstr "" #~ "ensures that tests do not pass " #~ "randomly due to your computer's specific" #~ " setup. For instance, you might have" -#~ " unexpectedly installed dependencies on " -#~ "your local system that are not " -#~ "declared in your package's dependency " -#~ "list. This oversight could lead to " -#~ "issues when others try to install " -#~ "or run your package on their " -#~ "computers." +#~ " unexpectedly installed dependencies on your" +#~ " local system that are not declared " +#~ "in your package's dependency list. This" +#~ " oversight could lead to issues when" +#~ " others try to install or run " +#~ "your package on their computers." #~ msgstr "" #~ "隔離された環境でテストを実行することで、テストとその再現性に自信を持つことができます。 " #~ "これにより、あなたのコンピュータの設定によってテストがランダムにパスすることがなくなります。 " @@ -1900,22 +1963,21 @@ msgstr "" #~ "ピュータにインストールしたり実行しようとしたときに、問題につながる可能性 があります。" #~ msgid "" -#~ "**Automation tools** allow you to " -#~ "automate running workflows such as tests" -#~ " in specific ways using user-defined" -#~ " commands. For instance it's useful " -#~ "to be able to run tests across " -#~ "different Python versions with a single" -#~ " command. Tools such as " +#~ "**Automation tools** allow you to automate" +#~ " running workflows such as tests in " +#~ "specific ways using user-defined commands." +#~ " For instance it's useful to be " +#~ "able to run tests across different " +#~ "Python versions with a single command. " +#~ "Tools such as " #~ "[**nox**](https://nox.thea.codes/en/stable/index.html) and " -#~ "[**tox**](https://tox.wiki/en/latest/index.html) also " -#~ "allow you to run tests across " -#~ "Python versions. However, it will be " -#~ "difficult to test your build on " -#~ "different operating systems using only " -#~ "nox and tox - this is where " -#~ "continuous integration (CI) comes into " -#~ "play." +#~ "[**tox**](https://tox.wiki/en/latest/index.html) also allow" +#~ " you to run tests across Python " +#~ "versions. However, it will be difficult" +#~ " to test your build on different " +#~ "operating systems using only nox and " +#~ "tox - this is where continuous " +#~ "integration (CI) comes into play." #~ msgstr "" #~ "**自動化ツール** " #~ "を使うと、ユーザー定義のコマンドを使って、テストのようなワークフローを特定の方法で実行することを自動化できます。 " @@ -1936,8 +1998,8 @@ msgstr "" #~ "Python environments. It will also allow" #~ " you to run your tests on " #~ "different operating systems (Windows, Mac " -#~ "and Linux). [We discuss using CI " -#~ "to run tests here](tests-ci)." +#~ "and Linux). [We discuss using CI to" +#~ " run tests here](tests-ci)." #~ msgstr "" #~ "**継続的インテグレーション (CI):** は、テストを実行するために必要な最後のツールです。 CI" #~ " は、nox や tox を使って作成した自動ビルドを複製して、異なる Python" @@ -1967,17 +2029,16 @@ msgstr "" #~ msgstr "その他の自動化タスクに使用する（ドキュメントの作成など）" #~ msgid "" -#~ "**[Hatch](https://github.com/pypa/hatch)** is a " -#~ "modern end-to-end packaging tool " -#~ "that works with the popular build " -#~ "backend called hatchling. `hatch` offers " -#~ "a `tox`-like setup where you can " -#~ "run tests locally using different Python" -#~ " versions. If you are using `hatch`" -#~ " to support your packaging workflow, " -#~ "you may want to also use its " -#~ "testing capabilities rather than using " -#~ "`nox`." +#~ "**[Hatch](https://github.com/pypa/hatch)** is a modern" +#~ " end-to-end packaging tool that " +#~ "works with the popular build backend " +#~ "called hatchling. `hatch` offers a " +#~ "`tox`-like setup where you can run " +#~ "tests locally using different Python " +#~ "versions. If you are using `hatch` " +#~ "to support your packaging workflow, you" +#~ " may want to also use its testing" +#~ " capabilities rather than using `nox`." #~ msgstr "" #~ "**[Hatch](https://github.com/pypa/hatch)** " #~ "は、hatchlingと呼ばれる人気のあるビルドバックエンドで動作する最新のエンドツーエンドパッケージングツールです。 " @@ -1995,78 +2056,77 @@ msgstr "" #~ msgid "" #~ "An example of using nox to run " #~ "tests in `venv` environments for Python" -#~ " versions 3.9, 3.10, 3.11 and 3.12" -#~ " is below." +#~ " versions 3.9, 3.10, 3.11 and 3.12 " +#~ "is below." #~ msgstr "noxを使ってPythonバージョン3.9、3.10、3.11、3.12の `venv` 環境でテストを実行する例を以下に示します。" #~ msgid "" -#~ "Note that for the code below to" -#~ " work, you need to have all 4" -#~ " versions of Python installed on your" -#~ " computer for `nox` to find." +#~ "Note that for the code below to " +#~ "work, you need to have all 4 " +#~ "versions of Python installed on your " +#~ "computer for `nox` to find." #~ msgstr "" #~ "以下のコードが動作するためには、 `nox` " #~ "が見つけることができる4つのバージョンのPythonがコンピュータにインストールされている必要があることに注意してください。" #~ msgid "" -#~ "TODO: add some tests above and " -#~ "show what the output would look " -#~ "like in the examples below..." +#~ "TODO: add some tests above and show" +#~ " what the output would look like " +#~ "in the examples below..." #~ msgstr "TODO: 上記のテストをいくつか追加し、以下の例で出力がどのようになるかを示す..." #~ msgid "Integration" #~ msgstr "統合" #~ msgid "" -#~ "I think this page would be " -#~ "stronger if we did have some " -#~ "examples from our package here: " +#~ "I think this page would be stronger" +#~ " if we did have some examples " +#~ "from our package here: " #~ "https://github.com/pyOpenSci/pyosPackage" #~ msgstr "" #~ "私たちのパッケージからの例があれば、このページはもっと強くなると思います: " #~ "https://github.com/pyOpenSci/pyosPackage " #~ msgid "" -#~ "For example, if you had a series" -#~ " of steps that collected temperature " -#~ "data in a spreadsheet, converted it " -#~ "from degrees celsius to Fahrenheit and" -#~ " then provided an average temperature " -#~ "for a particular time period. An " -#~ "integration test would ensure that all" -#~ " parts of that workflow behaved as" -#~ " expected." +#~ "For example, if you had a series " +#~ "of steps that collected temperature data" +#~ " in a spreadsheet, converted it from" +#~ " degrees celsius to Fahrenheit and then" +#~ " provided an average temperature for a" +#~ " particular time period. An integration " +#~ "test would ensure that all parts of" +#~ " that workflow behaved as expected." #~ msgstr "例えば、スプレッドシートに温度データを収集し、摂氏から華氏に変換し、特定の期間の平均温度を提供する一連のステップがあったとします。統合テストは、そのワークフローのすべての部分が期待通りに動作することを保証します。" #~ msgid "" #~ "Integration and end-to-end tests " -#~ "verify that the different portions of" -#~ " the program work together, but are" -#~ " less well-suited for isolating where" -#~ " errors are occurring. For example, " -#~ "when you refactor your code, it is" -#~ " possible that that your end-to-" -#~ "end tests will break. But if the" -#~ " refactor didn't introduce new behavior " -#~ "to your existing code, then you " -#~ "can rely on your unit tests to " -#~ "continue to pass, testing the original" -#~ " functionality of your code." +#~ "verify that the different portions of " +#~ "the program work together, but are " +#~ "less well-suited for isolating where " +#~ "errors are occurring. For example, when" +#~ " you refactor your code, it is " +#~ "possible that that your end-to-end" +#~ " tests will break. But if the " +#~ "refactor didn't introduce new behavior to" +#~ " your existing code, then you can " +#~ "rely on your unit tests to continue" +#~ " to pass, testing the original " +#~ "functionality of your code." #~ msgstr "統合テストとエンドツーエンドテストは、プログラムのさまざまな部分が連携して動作することを検証しますが、どこでエラーが発生しているかを切り分けるにはあまり適していません。例えば、コードをリファクタリングすると、エンドツーエンドのテストが壊れる可能性があります。しかし、リファクタリングによって既存のコードに新しい動作が導入されなかったのであれば、コードの元の機能をテストするユニットテストがパスし続けることに頼ることができます。" #~ msgid "" #~ "Imagine you're working on a puzzle " #~ "where each puzzle piece represents a " #~ "function, method, class or attribute in" -#~ " your Python package that you want" -#~ " other people to be able to " -#~ "use. Would you want to give " -#~ "someone a puzzle that has missing " -#~ "pieces or pieces that don't fit " -#~ "together? Providing people with the " -#~ "right puzzle pieces that work together" -#~ " can be compared to writing tests " -#~ "for your Python package." +#~ " your Python package that you want " +#~ "other people to be able to use. " +#~ "Would you want to give someone a " +#~ "puzzle that has missing pieces or " +#~ "pieces that don't fit together? Providing" +#~ " people with the right puzzle pieces" +#~ " that work together can be compared " +#~ "to writing tests for your Python " +#~ "package." #~ msgstr "" #~ "パズルのピースが、あなたのPythonパッケージの関数、メソッド、クラス、属性を表しているとしましょう。 " #~ "そしてあなたは他の人に使ってもらいたいと思っています。 " @@ -2078,9 +2138,9 @@ msgstr "" #~ msgid "" #~ "**Test at and near the expected " -#~ "boundaries:** If a function requires a" -#~ " value that is greater than or " -#~ "equal to 1, make sure that the " +#~ "boundaries:** If a function requires a " +#~ "value that is greater than or equal" +#~ " to 1, make sure that the " #~ "function still works with both the " #~ "values 1 and less than one and " #~ "1.001 as well (something close to " diff --git a/locales/ja/LC_MESSAGES/tutorials.po b/locales/ja/LC_MESSAGES/tutorials.po index 6df75054..092c8445 100644 --- a/locales/ja/LC_MESSAGES/tutorials.po +++ b/locales/ja/LC_MESSAGES/tutorials.po @@ -69,8 +69,8 @@ msgstr "パッケージリポジトリに `CODE_OF_CONDUCT` ファイルを追 #: ../../tutorials/add-license-coc.md:21 msgid "" -"How you can use the Contributors Covenant website to add generic language" -" as a starting place for your `CODE_OF_CONDUCT`." +"How you can use the Contributors Covenant website to add generic language " +"as a starting place for your `CODE_OF_CONDUCT`." msgstr "" "`CODE_OF_CONDUCT` の出発点として一般的な言語を追加するために、Contributors " "Covenantのウェブサイトをどのように利用できるか。" @@ -103,11 +103,11 @@ msgstr "メタデータが設定されている `pyproject.toml` データでそ #: ../../tutorials/add-license-coc.md:31 #, fuzzy msgid "" -"By adding this metadata to your [pyproject.toml](pyproject-toml) file, " -"the choice of license will be included in your package's metadata which " -"is used to populate your package's PyPI landing page. The `LICENSE` file " -"is also used in your GitHub repository's landing page interface, and " -"makes its way into your distributions." +"By adding this metadata to your [pyproject.toml](pyproject-toml) file, the " +"choice of license will be included in your package's metadata which is used" +" to populate your package's PyPI landing page. The `LICENSE` file is also " +"used in your GitHub repository's landing page interface, and makes its way " +"into your distributions." msgstr "" "`LICENSE` ファイルを `pyproject.toml` ファイルに追加することで、 `LICENSE` " "がパッケージのメタデータに含まれるようになります。 `LICENSE` は GitHub " @@ -121,15 +121,15 @@ msgstr "どのライセンスを使うべきか？" #, fuzzy msgid "" "We suggest that you use a permissive license that accommodates the other " -"most commonly used licenses in the scientific Python ecosystem (MIT[^mit]" -" and BSD-3-Clause[^bsd3]). If you are unsure, use MIT given it's the " +"most commonly used licenses in the scientific Python ecosystem (MIT[^mit] " +"and BSD-3-Clause[^bsd3]). If you are unsure, use MIT given it's the " "generally recommended license on " "[choosealicense.com](https://choosealicense.com/)." msgstr "" "科学的なPythonのエコシステムで最もよく使われるライセンス (MIT[^mit]とBSD-3[^bsd3]) " "に対応した寛容なライセンスを使うことをお勧めします。 よくわからない場合は、 " -"[choosealicense.com](https://choosealicense.com/) で一般的に推奨されているライセンスである " -"MIT を使ってください。" +"[choosealicense.com](https://choosealicense.com/) で一般的に推奨されているライセンスである MIT " +"を使ってください。" #: ../../tutorials/add-license-coc.md:41 msgid "Licenses for the scientific Python ecosystem" @@ -140,8 +140,8 @@ msgid "" "[We discuss licenses for the scientific Python ecosystem in more detail " "here in our guidebook.](../documentation/repository-files/license-files)" msgstr "" -"[科学的Pythonエコシステムのライセンスについては、ガイドブックで詳しく説明しています](../documentation" -"/repository-files/license-files)" +"[科学的Pythonエコシステムのライセンスについては、ガイドブックで詳しく説明しています](../documentation/repository-" +"files/license-files)" #: ../../tutorials/add-license-coc.md:45 msgid "Where should the `LICENSE` file live" @@ -158,18 +158,16 @@ msgstr "" "が魔法のごとく自動的にそれを検出し、GitHub リポジトリ内の `LICENSE` ファイルへの直接リンクをユーザーに提供します。" #: ../../tutorials/add-license-coc.md:53 -msgid "" -"Image showing the GitHub repository for SunPy an accepted pyOpenSci " -"package." +msgid "Image showing the GitHub repository for SunPy an accepted pyOpenSci package." msgstr "pyOpenSci パッケージに採用された SunPy 用のGitHubリポジトリを示す画像。" #: ../../tutorials/add-license-coc.md:55 msgid "" -"Notice at the top of the README portion of the GitHub landing page, there" -" are three tabs directly linking to the `README` file which is visible, " -"the `CODE_OF_CONDUCT` file and one that specifies the license that SunPy " -"uses. These files are discovered by GitHub because they are placed in the" -" root of the project directory using standard naming conventions." +"Notice at the top of the README portion of the GitHub landing page, there " +"are three tabs directly linking to the `README` file which is visible, the " +"`CODE_OF_CONDUCT` file and one that specifies the license that SunPy uses. " +"These files are discovered by GitHub because they are placed in the root of" +" the project directory using standard naming conventions." msgstr "" "GitHubのランディングページのREADME部分の一番上に、 `README` ファイル、 `CODE_OF_CONDUCT` " "ファイル、そしてSunPyが使用するライセンスを指定するタブの3つに直接リンクしていることに注目してください。 " @@ -185,9 +183,9 @@ msgstr "`LICENSE` ファイルを追加するにはいくつかの方法があ #: ../../tutorials/add-license-coc.md:66 msgid "" -"When you create a new repository on GitHub, it will ask you if you wish " -"to add a `LICENSE` file at that time. If you select yes, it will create " -"the file for you." +"When you create a new repository on GitHub, it will ask you if you wish to " +"add a `LICENSE` file at that time. If you select yes, it will create the " +"file for you." msgstr "" "GitHub で新しいリポジトリを作成すると、そのときに `LICENSE` ファイルを追加するかどうかを尋ねられます。 yes " "を選ぶと、ファイルを作成してくれます。" @@ -222,9 +220,9 @@ msgstr "[PyPIへのパッケージの公開](publish-pypi.md)" #: ../../tutorials/add-license-coc.md:76 msgid "" -"then you already have a `LICENSE` file containing text for the MIT " -"license in your Python package. Thus you can skip to the next section of " -"this tutorial which walks you through adding a `CODE_OF_CONDUCT`." +"then you already have a `LICENSE` file containing text for the MIT license " +"in your Python package. Thus you can skip to the next section of this " +"tutorial which walks you through adding a `CODE_OF_CONDUCT`." msgstr "" "は、Python パッケージの中に MIT ライセンスのテキストを含む `LICENSE` ファイルが既にあるということです。 " "従って、このチュートリアルの次のセクションの `CODE_OF_CONDUCT` の追加に進むことができます。" @@ -242,8 +240,7 @@ msgstr "パッケージに `LICENSE` を追加する方法 - 手動の方法" #: ../../tutorials/add-license-coc.md:83 msgid "" "If you don't already have a `LICENSE` file, and you are not yet using a " -"platform such as GitHub or GitLab, then you can create a `LICENSE` file " -"by" +"platform such as GitHub or GitLab, then you can create a `LICENSE` file by" msgstr "" "まだ `LICENSE` ファイルがなく、GitHub や GitLab などのプラットフォームを使っていない場合は、次のようにして " "`LICENSE` ファイルを作成します。" @@ -284,24 +281,24 @@ msgstr "科学的Pythonエコシステムにおけるライセンスの概要" msgid "" "In the pyOpenSci [packaging guidebook](../documentation/repository-files" "/license-files), we provide an overview of licenses in the scientific " -"Python ecosystem. We review why license files are important, which ones " -"are most commonly used for scientific software and how to select the " -"correct license." +"Python ecosystem. We review why license files are important, which ones are" +" most commonly used for scientific software and how to select the correct " +"license." msgstr "" -"pyOpenSci [パッケージングガイドブック](../documentation/repository-files/license-" -"files) では、科学的Pythonエコシステムにおけるライセンスの概要を提供します。 " +"pyOpenSci [パッケージングガイドブック](../documentation/repository-files/license-files) " +"では、科学的Pythonエコシステムにおけるライセンスの概要を提供します。 " "なぜライセンスファイルが重要なのか、どのライセンスファイルが科学ソフトウェアに最もよく使われるのか、正しいライセンスを選択する方法についてレビューします。" #: ../../tutorials/add-license-coc.md:103 msgid "" -"If you want a broad overview of why licenses are important for protecting" -" open source software, [check out this blog post that overviews the legal" -" side of things.](https://opensource.guide/legal/#just-give-me-the-tldr-" -"on-what-i-need-to-protect-my-project)" +"If you want a broad overview of why licenses are important for protecting " +"open source software, [check out this blog post that overviews the legal " +"side of things.](https://opensource.guide/legal/#just-give-me-the-tldr-on-" +"what-i-need-to-protect-my-project)" msgstr "" "なぜライセンスがオープンソースソフトウェアを保護するために重要なのか、その大まかな概要をお知りになりたい方は、 " -"[法的側面を概観したこのブログ記事をご覧ください](https://opensource.guide/legal/#just-give-me-" -"the-tldr-on-what-i-need-to-protect-my-project)" +"[法的側面を概観したこのブログ記事をご覧ください](https://opensource.guide/legal/#just-give-me-the-" +"tldr-on-what-i-need-to-protect-my-project)" #: ../../tutorials/add-license-coc.md msgid "Instructions for adding a `LICENSE` file within the GitHub interface" @@ -319,13 +316,13 @@ msgstr "GitHub リポジトリを新規作成する際に、GitHub インター #: ../../tutorials/add-license-coc.md:119 msgid "" -"Screenshot of the create new repository interface that GitHub provides. " -"The elements of this are the owner and repository name for the new repo. " -"Below that you can add a description of the repository. Below that you " -"can set it to be public or private. At the bottom of the interface there " -"is an Add a README checkbox where it will add a blank readme file for " -"you. At the very bottom there is a line to add a .gitignore file and " -"another to choose a license." +"Screenshot of the create new repository interface that GitHub provides. The" +" elements of this are the owner and repository name for the new repo. Below" +" that you can add a description of the repository. Below that you can set " +"it to be public or private. At the bottom of the interface there is an Add " +"a README checkbox where it will add a blank readme file for you. At the " +"very bottom there is a line to add a .gitignore file and another to choose " +"a license." msgstr "" "GitHub が提供する新しいリポジトリの作成インターフェイスのスクリーンショット。 " "このインターフェイスの要素は、新しいリポジトリのオーナーとリポジトリ名です。 その下にリポジトリの説明を追加できます。 " @@ -335,8 +332,8 @@ msgstr "" #: ../../tutorials/add-license-coc.md:121 msgid "" -"Image showing the GitHub interface that allows you to add a `LICENSE` and" -" `README` file when you create a new repository." +"Image showing the GitHub interface that allows you to add a `LICENSE` and " +"`README` file when you create a new repository." msgstr "新規リポジトリ作成時に `LICENSE` と `README` ファイルを追加できる GitHub インターフェイスのイメージ。" #: ../../tutorials/add-license-coc.md @@ -345,8 +342,8 @@ msgstr "`LICENSE` を追加する: 既存のGitHubリポジトリ" #: ../../tutorials/add-license-coc.md:127 msgid "" -"If you already have a GitHub repository for your package, then you can " -"add a `LICENSE` using the GitHub interface by adding a new file to the " +"If you already have a GitHub repository for your package, then you can add " +"a `LICENSE` using the GitHub interface by adding a new file to the " "repository." msgstr "" "パッケージ用のGitHubリポジトリが既にある場合は、GitHubのインターフェースで新しいファイルを追加することで `LICENSE` " @@ -354,32 +351,32 @@ msgstr "" #: ../../tutorials/add-license-coc.md:129 msgid "" -"Follow the instructions to select and add a license to your repository on" -" the [GitHub LICENSE page](https://docs.github.com/en/communities" -"/setting-up-your-project-for-healthy-contributions/adding-a-license-" -"to-a-repository) ." +"Follow the instructions to select and add a license to your repository on " +"the [GitHub LICENSE page](https://docs.github.com/en/communities/setting-" +"up-your-project-for-healthy-contributions/adding-a-license-to-a-repository)" +" ." msgstr "" -"[GitHubのLICENSEページ](https://docs.github.com/en/communities/setting-up-" -"your-project-for-healthy-contributions/adding-a-license-to-a-repository) " +"[GitHubのLICENSEページ](https://docs.github.com/en/communities/setting-up-your-" +"project-for-healthy-contributions/adding-a-license-to-a-repository) " "の指示に従って、リポジトリにライセンスを選択し追加してください。" #: ../../tutorials/add-license-coc.md:130 msgid "" "Once you have added your `LICENSE` file, be sure to sync your git local " -"repository with the repository on GitHub.com. This means running `git " -"pull` to update your local branch." +"repository with the repository on GitHub.com. This means running `git pull`" +" to update your local branch." msgstr "" "`LICENSE`ファイルを追加したら、必ずローカルのgitリポジトリをGitHub.com上のリポジトリと同期してください。これは、`git " "pull`を実行してローカルブランチを更新することを意味します。" #: ../../tutorials/add-license-coc.md:133 msgid "" -"Image showing what the LICENSE file looks like in the GItHub interface. " -"At the top you can see the actual license which in this image is BSD " -"3-clause New or revised license. Then there is some text describing both " -"what the license is and the associated permissions for that specific " -"license. At the bottom of the image, the actual text for the license is " -"shown in the LICENSE file." +"Image showing what the LICENSE file looks like in the GItHub interface. At " +"the top you can see the actual license which in this image is BSD 3-clause " +"New or revised license. Then there is some text describing both what the " +"license is and the associated permissions for that specific license. At the" +" bottom of the image, the actual text for the license is shown in the " +"LICENSE file." msgstr "" "GItHubインターフェイスでLICENSEファイルがどのように見えるかを示す画像。この画像では、BSD 3-clause New or " "revised " @@ -439,10 +436,10 @@ msgstr "`CODE_OF_CONDUCT` ファイルに書くべきこと" #: ../../tutorials/add-license-coc.md:162 msgid "" -"If you are unsure of what language to add to your `CODE_OF_CONDUCT` file," -" we suggest that you adopt the [contributor covenant " -"language](https://www.contributor-" -"covenant.org/version/2/1/code_of_conduct/) as a starting place." +"If you are unsure of what language to add to your `CODE_OF_CONDUCT` file, " +"we suggest that you adopt the [contributor covenant language](https://www" +".contributor-covenant.org/version/2/1/code_of_conduct/) as a starting " +"place." msgstr "" "どの言語を `CODE_OF_CONDUCT` ファイルに追加すればよいかわからない場合、 [contributor covenant " "language](https://www.contributor-" @@ -482,12 +479,12 @@ msgid "" "covenant.org/) and add [the markdown version of their code of " "conduct](https://www.contributor-" "covenant.org/version/2/1/code_of_conduct/code_of_conduct.md) to your " -"`CODE_OF_CONDUCT.md` file. Be sure to fill in any placeholder " -"information. Read the text closely to ensure you both understand it and " -"also agree with its contents!" +"`CODE_OF_CONDUCT.md` file. Be sure to fill in any placeholder information. " +"Read the text closely to ensure you both understand it and also agree with " +"its contents!" msgstr "" -"[contributor covenant website](https://www.contributor-covenant.org/) " -"を訪れ、 `CODE_OF_CONDUCT.md` ファイルに [the markdown version of their code of " +"[contributor covenant website](https://www.contributor-covenant.org/) を訪れ、 " +"`CODE_OF_CONDUCT.md` ファイルに [the markdown version of their code of " "conduct](https://www.contributor-" "covenant.org/version/2/1/code_of_conduct/code_of_conduct.md) を追加します。 " "プレースホルダーの情報は必ず記入してください。 本文をよく読み、内容を理解し、同意すること！" @@ -503,8 +500,8 @@ msgstr "行動規範に関するその他のリソース" #: ../../tutorials/add-license-coc.md:184 msgid "" "[ Guide: `CODE_OF_CONDUCT.md` " -"files](https://docs.github.com/en/communities/setting-up-your-project-" -"for-healthy-contributions/adding-a-code-of-conduct-to-your-project)" +"files](https://docs.github.com/en/communities/setting-up-your-project-for-" +"healthy-contributions/adding-a-code-of-conduct-to-your-project)" msgstr "" "[ ガイド: `CODE_OF_CONDUCT.md` " "ファイル](https://docs.github.com/en/communities/setting-up-your-project-for-" @@ -545,8 +542,8 @@ msgstr "`CODE_OF_CONDUCT` ファイル。" #: ../../tutorials/add-license-coc.md:196 msgid "" "These are fundamental files needed for every scientific Python package " -"repository. These files help users understand how to use your package and" -" interact with package maintainers." +"repository. These files help users understand how to use your package and " +"interact with package maintainers." msgstr "" "これらはすべての科学的なPythonパッケージリポジトリに必要な基本的なファイルです。 " "これらのファイルは、ユーザがあなたのパッケージの使い方を理解し、パッケージメンテナとやりとりするのに役立ちます。" @@ -572,8 +569,7 @@ msgstr "あなたのPythonパッケージの新しいバージョンをテスト #: ../../tutorials/add-license-coc.md:208 #: ../../tutorials/create-python-package.md:550 -#: ../../tutorials/publish-conda-forge.md:487 -#: ../../tutorials/publish-pypi.md:419 +#: ../../tutorials/publish-conda-forge.md:487 ../../tutorials/publish-pypi.md:419 #: ../../tutorials/trusted-publishing.md:347 msgid "Footnotes" msgstr "脚注" @@ -626,8 +622,8 @@ msgstr "README ファイルとは何か？" #: ../../tutorials/add-readme.md:25 #, fuzzy, python-brace-format msgid "" -"The `README.md` file is the project's {term}`README` and is located at " -"the root of your project directory. It helps a user understand:" +"The `README.md` file is the project's {term}`README` and is located at the " +"root of your project directory. It helps a user understand:" msgstr "`README.md` ファイルはプロジェクトディレクトリのルートにあるマークダウンファイルで、ユーザーの理解を助けるものです:" #: ../../tutorials/add-readme.md:29 @@ -636,9 +632,8 @@ msgstr "パッケージ名" #: ../../tutorials/add-readme.md:30 msgid "" -"What the package does. Your README file should clearly state the " -"problem(s) that your software is designed to solve and its target " -"audience." +"What the package does. Your README file should clearly state the problem(s)" +" that your software is designed to solve and its target audience." msgstr "" "パッケージが何をするのか。 " "READMEファイルには、あなたのソフトウェアが解決するために設計された(複数の)問題と、その対象読者を明確に記述してください。" @@ -662,17 +657,17 @@ msgstr "パッケージの引用方法" #: ../../tutorials/add-readme.md:36 msgid "" "Your **README.md** file is important as it is often the first thing that " -"someone sees before they install your package. The README file is also " -"used to populate your PyPI landing page." +"someone sees before they install your package. The README file is also used" +" to populate your PyPI landing page." msgstr "" "**README.md** ファイルは、誰かがあなたのパッケージをインストールする前に、最初に目にすることが多いので重要です。 " "READMEファイルはPyPIのランディングページに入力するためにも使われます。" #: ../../tutorials/add-readme.md:38 msgid "" -"Note that there is no specific content structure for README files. " -"However, this tutorial outlines the sections that we suggest that you " -"include in your README file." +"Note that there is no specific content structure for README files. However," +" this tutorial outlines the sections that we suggest that you include in " +"your README file." msgstr "" "READMEファイルには特定のコンテンツ構造はないことに注意してください。 " "しかし、このチュートリアルでは、READMEファイルに含めることを推奨するセクションの概要を説明します。" @@ -691,8 +686,8 @@ msgstr "ステップ0: READMEファイルの作成" #: ../../tutorials/add-readme.md:47 msgid "" -"To get started, if you don't already have a README.md file in your " -"project directory, create one." +"To get started, if you don't already have a README.md file in your project " +"directory, create one." msgstr "まず、プロジェクトディレクトリにまだREADME.mdファイルがない場合は、作成してください。" #: ../../tutorials/add-readme.md:50 @@ -721,8 +716,8 @@ msgstr "`README.md` ファイルの先頭に、パッケージ名を追加しま #: ../../tutorials/add-readme.md:65 msgid "" -"If you are using markdown it should be a header 1 (H1) tag which is " -"denoted with a single `#` sign." +"If you are using markdown it should be a header 1 (H1) tag which is denoted" +" with a single `#` sign." msgstr "マークダウンを使用している場合は、 `#` 記号1つで示されるヘッダー1 (H1) タグでなければなりません。" #: ../../tutorials/add-readme.md:67 @@ -735,8 +730,8 @@ msgstr "ステップ2: READMEファイルの先頭にバッジを追加する" #: ../../tutorials/add-readme.md:71 msgid "" -"It's common for maintainers to add badges to the top of their README " -"files. Badges allow you and your package users to track things like:" +"It's common for maintainers to add badges to the top of their README files." +" Badges allow you and your package users to track things like:" msgstr "" "メンテナが README ファイルの先頭にバッジを追加するのはよくあることです。 " "バッジをつけることで、あなたとあなたのパッケージのユーザは以下のようなことを追跡できるようになります:" @@ -751,8 +746,8 @@ msgstr "PyPIとcondaにあるあなたのパッケージのバージョン。" #: ../../tutorials/add-readme.md:75 msgid "" -"Whether your package has been reviewed and vetted by an organization such" -" as pyOpenSci and/or JOSS." +"Whether your package has been reviewed and vetted by an organization such " +"as pyOpenSci and/or JOSS." msgstr "あなたのパッケージがpyOpenSciやJOSSのような組織によってレビューされ、審査されたかどうか。" #: ../../tutorials/add-readme.md:77 @@ -768,8 +763,8 @@ msgstr "" #: ../../tutorials/add-readme.md:79 msgid "" -"If not, you can leave the top empty for now and add badges to your README" -" at a later point as they make sense." +"If not, you can leave the top empty for now and add badges to your README " +"at a later point as they make sense." msgstr "そうでない場合は、今のところ上部を空にしておいて、後でREADMEにバッジを追加することができます。" #: ../../tutorials/add-readme.md:81 @@ -778,8 +773,8 @@ msgstr "ステップ 3: パッケージの説明を追加する" #: ../../tutorials/add-readme.md:83 msgid "" -"Below the badges (if you have them), add a section of text that provides " -"an easy-to-understand overview of what your package does." +"Below the badges (if you have them), add a section of text that provides an" +" easy-to-understand overview of what your package does." msgstr "バッジの下に（バッジがある場合）、あなたのパッケージが何をするのかをわかりやすく説明するテキストのセクションを追加します。" #: ../../tutorials/add-readme.md:87 @@ -792,14 +787,14 @@ msgstr "専門用語はなるべく避けてください。" #: ../../tutorials/add-readme.md:89 msgid "" -"Define technical terms that you use to make the description accessible to" -" more people." +"Define technical terms that you use to make the description accessible to " +"more people." msgstr "説明をより多くの人が理解できるように、使用する専門用語を定義します。" #: ../../tutorials/add-readme.md:91 msgid "" -"Remember that the more people understand what your package does, the more" -" people will use it." +"Remember that the more people understand what your package does, the more " +"people will use it." msgstr "あなたのパッケージが何をするものなのか、より多くの人が理解すればするほど、より多くの人がそれを使うようになることを忘れないでください。" #: ../../tutorials/add-readme.md:93 @@ -813,8 +808,8 @@ msgstr "次に、ユーザーにパッケージのインストール方法を説 #: ../../tutorials/add-readme.md:97 #, fuzzy, python-brace-format msgid "" -"For example, can they use {term}`pip` to install your package? `python -m" -" pip install packagename`" +"For example, can they use {term}`pip` to install your package? `python -m " +"pip install packagename`" msgstr "" "例えば、彼らはあなたのパッケージをインストールするためにpipを使うことができますか？ `python -m pip install " "packagename`" @@ -839,17 +834,17 @@ msgstr "ステップ5：追加設定" #: ../../tutorials/add-readme.md:110 msgid "" -"In some cases, your package users may need to manually install other " -"tools in order to use your package. If that is the case, be sure to add a" -" section on additional setup to your README file." +"In some cases, your package users may need to manually install other tools " +"in order to use your package. If that is the case, be sure to add a section" +" on additional setup to your README file." msgstr "" "場合によっては、あなたのパッケージを使用するために、あなたのパッケージのユーザーが他のツールを手動でインストールする必要があるかもしれません。 " "その場合は、READMEファイルに追加セットアップのセクションを追加してください。" #: ../../tutorials/add-readme.md:115 msgid "" -"Here, briefly document (or link to documentation for) any additional " -"setup that is required to use your package. This might include:" +"Here, briefly document (or link to documentation for) any additional setup " +"that is required to use your package. This might include:" msgstr "ここで、あなたのパッケージを使うために必要な追加設定を簡単に文書化 (または文書へのリンク) をしてください。これには以下が含まれます:" #: ../../tutorials/add-readme.md:119 @@ -873,8 +868,8 @@ msgstr "ステップ6: スタートセクションの追加" #: ../../tutorials/add-readme.md:130 msgid "" "Next add a get-started section. Within this section, add a small code " -"example that demonstrates importing and using some of the functionality " -"in your package." +"example that demonstrates importing and using some of the functionality in " +"your package." msgstr "" "次に、get-started セクションを追加します。 " "このセクションに、パッケージの機能の一部をインポートして使用することを示す、小さなコード例を追加します。" @@ -897,8 +892,8 @@ msgstr "可能であれば、Jupyter Notebookや.pyファイルに貼り付け #: ../../tutorials/add-readme.md:140 msgid "" -"If there are tokens and other steps needed to run your package, be sure " -"to be clear about what those steps are." +"If there are tokens and other steps needed to run your package, be sure to " +"be clear about what those steps are." msgstr "あなたのパッケージを実行するために必要なトークンや他のステップがある場合、それらのステップが何であるかを明確にするようにしてください。" #: ../../tutorials/add-readme.md:143 @@ -910,14 +905,12 @@ msgid "" "Or it could simply be a link to a getting started tutorial that you have " "created. If you don't have this yet, you can leave it empty for the time " "being." -msgstr "" -"あるいは、あなたが作成したチュートリアルへのリンクでもかまいません。 " -"まだチュートリアルをお持ちでない場合は、当分の間、空欄のままにしておいてください。" +msgstr "あるいは、あなたが作成したチュートリアルへのリンクでもかまいません。 まだチュートリアルをお持ちでない場合は、当分の間、空欄のままにしておいてください。" #: ../../tutorials/add-readme.md:154 msgid "" -"This would also be a great place to add links to tutorials that help " -"users understand how to use your package for common workflows." +"This would also be a great place to add links to tutorials that help users " +"understand how to use your package for common workflows." msgstr "また、一般的なワークフローでのパッケージの使い方を理解するのに役立つチュートリアルへのリンクを追加するのにも最適な場所です。" #: ../../tutorials/add-readme.md:159 @@ -926,9 +919,9 @@ msgstr "ステップ7: コミュニティセクション" #: ../../tutorials/add-readme.md:161 msgid "" -"The community section of your README file is a place to include " -"information for users who may want to engage with your project. This " -"engagement will likely happen on a platform like GitHub or GitLab." +"The community section of your README file is a place to include information" +" for users who may want to engage with your project. This engagement will " +"likely happen on a platform like GitHub or GitLab." msgstr "" "READMEファイルのコミュニティセクションは、あなたのプロジェクトに参加したいユーザーのための情報を含める場所です。 この参加は、おそらく " "GitHub や GitLab のようなプラットフォームで行われるでしょう。" @@ -936,18 +929,18 @@ msgstr "" #: ../../tutorials/add-readme.md:163 #, fuzzy msgid "" -"In the community section, you will add links to your contributing guide " -"and `CODE_OF_CONDUCT.md`. You will create a code of conduct file in the " -"[next lesson](add-license-coc)." +"In the community section, you will add links to your contributing guide and" +" `CODE_OF_CONDUCT.md`. You will create a code of conduct file in the [next " +"lesson](add-license-coc)." msgstr "" "コミュニティセクションでは、あなたの貢献ガイドと `CODE_OF_CONDUCT.md` へのリンクを追加します。 [次のレッスンでは " "`CODE_OF_CONDUCT.md` ファイル](add-license-coc) を作成することになります。" #: ../../tutorials/add-readme.md:167 msgid "" -"As your package grows you may also have a link to a development guide " -"that contributors and your maintainer team will follow. The development " -"guide outlines how to perform maintenance tasks such as:" +"As your package grows you may also have a link to a development guide that " +"contributors and your maintainer team will follow. The development guide " +"outlines how to perform maintenance tasks such as:" msgstr "パッケージが大きくなるにつれて、貢献者やメンテナチームが従う開発ガイドへのリンクを持つこともできます。この開発ガイドには、次のようなメンテナンス作業の方法が概説されています:" #: ../../tutorials/add-readme.md:170 @@ -972,15 +965,15 @@ msgstr "ステップ8: 引用情報" #: ../../tutorials/add-readme.md:179 msgid "" -"Finally it is important to let users know how to cite your package. You " -"can communicate citation information in a few different ways." +"Finally it is important to let users know how to cite your package. You can" +" communicate citation information in a few different ways." msgstr "最後に、ユーザーにあなたのパッケージの引用方法を知らせることが重要です。 引用情報を伝える方法はいくつかあります。" #: ../../tutorials/add-readme.md:182 msgid "" -"You can use a tool such as zenodo to create a DOI and associated citation" -" information for your package if it is hosted on a platform such as " -"GitHub. [Check out this short tutorial that covers setting that " +"You can use a tool such as zenodo to create a DOI and associated citation " +"information for your package if it is hosted on a platform such as GitHub. " +"[Check out this short tutorial that covers setting that " "up.](https://coderefinery.github.io/github-without-command-line/doi/)" msgstr "" "GitHubのようなプラットフォームでホストされている場合、zenodoのようなツールを使ってパッケージのDOIと関連する引用情報を作成することができます。" @@ -989,19 +982,18 @@ msgstr "" #: ../../tutorials/add-readme.md:186 msgid "" -"Alternatively if you send your package through a peer review process such" -" as the [one lead by pyOpenSci](https://www.pyopensci.org/about-peer-" -"review/index.html). After being accepted by pyOpenSci, if your package is" -" in scope, you can be accepted by the Journal of Open Source Software and" -" get a cross-ref DOI through [our partnership with the Journal of Open " +"Alternatively if you send your package through a peer review process such " +"as the [one lead by pyOpenSci](https://www.pyopensci.org/about-peer-" +"review/index.html). After being accepted by pyOpenSci, if your package is " +"in scope, you can be accepted by the Journal of Open Source Software and " +"get a cross-ref DOI through [our partnership with the Journal of Open " "Source Software.](https://www.pyopensci.org/about-peer-review/index.html)" msgstr "" "あるいは、 [pyOpenSciが主導するような査読プロセスを通して](https://www.pyopensci.org/about-peer-" "review/index.html) パッケージを送ることもできます。 " -"pyOpenSciに受理された後、あなたのパッケージがスコープ内であれば、Journal of Open Source " -"Softwareに受理され、 [Journal of Open Source " -"Softwareとの提携により](https://www.pyopensci.org/about-peer-review/index.html) " -"相互参照DOIを得ることができます。" +"pyOpenSciに受理された後、あなたのパッケージがスコープ内であれば、Journal of Open Source Softwareに受理され、" +" [Journal of Open Source Softwareとの提携により](https://www.pyopensci.org/about-" +"peer-review/index.html) 相互参照DOIを得ることができます。" #: ../../tutorials/add-readme.md:190 msgid "The finished README file" @@ -1013,12 +1005,12 @@ msgstr "完成した `README.md` ファイルは次のようになるはずで #: ../../tutorials/add-readme.md:242 msgid "" -"It's important to consider the information that a new user or contributor" -" might need when creating your `README.md` file. While there is no " -"perfect template, above is a set of recommendations as you are just " -"getting started. You may find the need for other elements to be added to " -"this file as you further develop your package and as a community begins " -"to use your package." +"It's important to consider the information that a new user or contributor " +"might need when creating your `README.md` file. While there is no perfect " +"template, above is a set of recommendations as you are just getting " +"started. You may find the need for other elements to be added to this file " +"as you further develop your package and as a community begins to use your " +"package." msgstr "" "`README.md` ファイルを作成する際には、新しいユーザーや貢献者が必要とするかもしれない情報を考慮することが重要です。 " "完璧なテンプレートは存在しないが、上記はこれから始めようとしているあなたへの推奨事項です。 " @@ -1027,8 +1019,8 @@ msgstr "" #: ../../tutorials/add-readme.md:248 msgid "" "In the [next lesson](add-license-coc.md), you will add a LICENSE file to " -"your Python package. A license file is critical as it tells users how " -"they legally can (and can't) use your package. It also:" +"your Python package. A license file is critical as it tells users how they " +"legally can (and can't) use your package. It also:" msgstr "" "[次のレッスン](add-license-coc.md) では、 LICENSEファイルをPythonパッケージに追加します。 " "ライセンスファイルは、ユーザーがあなたのパッケージを合法的にどのように使うことができるのか（そして使うことができないのか）を示す重要なものです。また:" @@ -1048,22 +1040,22 @@ msgstr "コマンドラインリファレンスガイド" #: ../../tutorials/command-line-reference.md:9 #, fuzzy msgid "" -"**What these tables are:** These tables summarize the command line inputs" -" (e.g., `pipx install hatch`, `hatch build` or `python -m build`) " -"necessary to complete all steps in the package creation process, from " -"installing [Hatch](get-to-know-hatch) to publishing the package on [PyPI" -"](publish-pypi) and conda-forge." +"**What these tables are:** These tables summarize the command line inputs " +"(e.g., `pipx install hatch`, `hatch build` or `python -m build`) necessary " +"to complete all steps in the package creation process, from installing " +"[Hatch](get-to-know-hatch) to publishing the package on [PyPI](publish-" +"pypi) and conda-forge." msgstr "" "**これらの表は何であるか:** これらの表は、Hatch のインストールから PyPI や conda-forge " -"でのパッケージの公開まで、パッケージ作成プロセスのすべてのステップを完了するために必要なコマンドライン入力 (e.g., `pipx " -"install hatch`, `hatch build`) をまとめたものです。" +"でのパッケージの公開まで、パッケージ作成プロセスのすべてのステップを完了するために必要なコマンドライン入力 (e.g., `pipx install " +"hatch`, `hatch build`) をまとめたものです。" #: ../../tutorials/command-line-reference.md:14 #, fuzzy, python-brace-format msgid "" -"**What these tables are not:** These tables do not cover the manual or " -"non-automated steps (e.g., create a PyPI account, create a {term}`API " -"token`) you have to complete throughout the package creation process." +"**What these tables are not:** These tables do not cover the manual or non-" +"automated steps (e.g., create a PyPI account, create a {term}`API token`) " +"you have to complete throughout the package creation process." msgstr "" "**これらの表は何でないか:** これらの表は、パッケージの作成プロセスを通して完了しなければならない手動/非自動ステップ " "(PyPIアカウントの作成、PyPI APIトークンの作成など) をカバーしていません。" @@ -1072,9 +1064,9 @@ msgstr "" msgid "" "**Operating system note:** The current iteration of this guide has been " "tested on the Windows OS only. Many commands are Windows-specific. OS-" -"specific commands are indicated with parentheses after the description of" -" the command, e.g., [COMMAND_DESCRIPTION] (Windows). Corresponding " -"commands for macOS and Linux will be added in the future." +"specific commands are indicated with parentheses after the description of " +"the command, e.g., [COMMAND_DESCRIPTION] (Windows). Corresponding commands " +"for macOS and Linux will be added in the future." msgstr "" "**オペレーティングシステム:** 本ガイドの現在のバージョンは、Windows " "OSのみでテストされています。多くのコマンドはWindows固有のものでス。OS固有のコマンドは、コマンドの説明の後に　" @@ -1110,11 +1102,14 @@ msgstr "このレッスンについて" #: ../../tutorials/create-python-package.md:13 #, python-brace-format msgid "" -"This lesson uses the pyOpenSci Python package copier template to create a" -" {term}`Python package` quickly. Your package will be installable both " +"This lesson uses the pyOpenSci Python package copier template to create a " +"{term}`Python package` quickly. Your package will be installable both " "locally and remotely from a website such as GitHub (or GitLab) into a " "Python environment." msgstr "" +"このレッスンでは、pyOpenSci Python パッケージ コピー機テンプレートを使用して、{term}`Python パッケージ` " +"をすばやく作成します。パッケージは、ローカルにもリモートにも GitHub (または GitLab) などの Web サイトから Python " +"環境にインストールできます。" #: ../../tutorials/create-python-package.md:18 #: ../../tutorials/setup-py-to-pyproject-toml.md:23 @@ -1125,25 +1120,23 @@ msgstr "このレッスンで学ぶこと:" #: ../../tutorials/create-python-package.md:20 #, fuzzy msgid "" -"How to make your code installable into any Python environment, both " -"locally and from GitHub" +"How to make your code installable into any Python environment, both locally" +" and from GitHub" msgstr "ローカルとGitHubの両方で、あなたのコードをあらゆるPython環境にインストール可能にする方法" #: ../../tutorials/create-python-package.md:21 #, fuzzy msgid "" -"How to update a [pyproject.toml file](pyproject-toml), which contains the" -" metadata needed to build, install, and publish your package." +"How to update a [pyproject.toml file](pyproject-toml), which contains the " +"metadata needed to build, install, and publish your package." msgstr "最後のレッスンでは、パッケージのビルドに必要なコア要素を含む、素のpyproject.tomlファイルを作成しました:" #: ../../tutorials/create-python-package.md:23 #, fuzzy, python-brace-format msgid "" -"How to declare a {term}`Build backend` which will be used to [build" -"](build-package) and install your package" -msgstr "" -"パッケージの [ビルド](build-package) とインストールに使用する [ビルドバックエンド](build_backends) " -"を宣言する方法" +"How to declare a {term}`Build backend` which will be used to [build](build-" +"package) and install your package" +msgstr "パッケージの [ビルド](build-package) とインストールに使用する [ビルドバックエンド](build_backends) を宣言する方法" #: ../../tutorials/create-python-package.md:25 msgid "How to install your package in editable mode for interactive development" @@ -1156,8 +1149,8 @@ msgstr "**このレッスンを完了するために必要なもの**" #: ../../tutorials/create-python-package.md:30 #, fuzzy msgid "" -"To complete this lesson, you will need a local Python environment and " -"shell on your computer. You will need to have " +"To complete this lesson, you will need a local Python environment and shell" +" on your computer. You will need to have " "[Copier](https://copier.readthedocs.io/en/stable/) and [Hatch installed" "](get-to-know-hatch) to complete the lesson successfully." msgstr "" @@ -1168,22 +1161,20 @@ msgstr "" #, fuzzy msgid "" "If you are using Windows or are not familiar with Shell, you may want to " -"check out the Carpentries shell lesson[^shell-lesson]. Windows users will" -" likely need to configure a tool such as " -"[gitbash](https://gitforwindows.org/) for any Shell and git-related " -"steps." +"check out the Carpentries shell lesson[^shell-lesson]. Windows users will " +"likely need to configure a tool such as " +"[gitbash](https://gitforwindows.org/) for any Shell and git-related steps." msgstr "" "Windowsを使用している、またはシェルに精通していない場合は、Carpentriesのシェルレッスン[^shell-lesson] " -"をチェックアウトすることをお勧めします。 " -"Windowsユーザーは、Shellやgitに関連するステップのためにツールを設定する必要があるでしょう。" +"をチェックアウトすることをお勧めします。 Windowsユーザーは、Shellやgitに関連するステップのためにツールを設定する必要があるでしょう。" #: ../../tutorials/create-python-package.md:41 msgid "" -"This diagram has two smaller boxes with arrows pointing to the right to a" -" Python environment. The small boxes read your-package and pip install " -"package. The environment box on the right reads - your Python " -"environment. It them lists your-package along with a few other core " -"packages such as Matplotlib, NumPy, Pandas, Xarray and GeoPandas." +"This diagram has two smaller boxes with arrows pointing to the right to a " +"Python environment. The small boxes read your-package and pip install " +"package. The environment box on the right reads - your Python environment. " +"It them lists your-package along with a few other core packages such as " +"Matplotlib, NumPy, Pandas, Xarray and GeoPandas." msgstr "" "この図には2つの小さなボックスがあり、右側にPython環境を示す矢印があります。 小さなボックスには、your-packageとpip " "install packageと書かれています。 右側の環境欄には「あなたのPython環境」と書かれています。 " @@ -1194,12 +1185,12 @@ msgstr "" #, fuzzy msgid "" "In a [previous lesson, you learned what a Python package is](intro). " -"Creating a Python package allows you to install your code into any Python" -" environment on your computer. You can then import it into workflows in " -"the same way that you might import a package such as Pandas or GeoPandas." -" If you push your code to GitHub or GitLab, you can also install it " -"directly from there. [Scroll to the bottom of the page to learn more " -"about the basic elements of a Python package.](package-overview)." +"Creating a Python package allows you to install your code into any Python " +"environment on your computer. You can then import it into workflows in the " +"same way that you might import a package such as Pandas or GeoPandas. If " +"you push your code to GitHub or GitLab, you can also install it directly " +"from there. [Scroll to the bottom of the page to learn more about the basic" +" elements of a Python package.](package-overview)." msgstr "" "あなたのコードをインストール可能にすることは、公開可能なPythonパッケージを作成するための最初のステップです。 " "あなたのコードがインストール可能になると、それはPythonパッケージとなり、あなたのコンピュータ上の任意のPython環境に追加し、PandasやGeoPandasなどのパッケージをインポートするのと同じ方法でインポートすることができます。あなたのコードがGitHubやGitLabにあるなら、そこから直接インストールすることもできます。" @@ -1212,12 +1203,16 @@ msgstr "Pythonパッケージを作成しましょう！" #: ../../tutorials/create-python-package.md:51 msgid "" "Below, you will create a pure Python package using the [pyOpenSci copier " -"template](https://github.com/pyOpenSci/pyos-package-template). Our " -"template uses Hatch as the default packaging tool. At the bottom of this " -"lesson, you'll learn more about the basics of the Python package " -"directory structure, and associated key files (`__init__.py` and " -"`pyproject.toml`)." +"template](https://github.com/pyOpenSci/pyos-package-template). Our template" +" uses Hatch as the default packaging tool. At the bottom of this lesson, " +"you'll learn more about the basics of the Python package directory " +"structure, and associated key files (`__init__.py` and `pyproject.toml`)." msgstr "" +"以下では、[pyOpenSci コピーテンプレート](https://github.com/pyOpenSci/pyos-package-" +"template) を使用して純粋な Python " +"パッケージを作成します。私たちのテンプレートは、デフォルトのパッケージ化ツールとしてハッチを使用します。このレッスンの最後では、Python " +"パッケージのディレクトリ構造の基本と、関連するキー ファイル (`__init__.py` と `pyproject.toml`) " +"について詳しく学びます。" #: ../../tutorials/create-python-package.md:53 msgid "Step 1: Set Up the Package Directory Structure" @@ -1230,9 +1225,9 @@ msgstr "シェルまたはお好みのターミナルを開きます。" #: ../../tutorials/create-python-package.md:56 #, fuzzy msgid "" -"Use the shell `cd` command to navigate in your shell to the location " -"where you'd like your package to live. Our template will create the " -"package directory structure for you" +"Use the shell `cd` command to navigate in your shell to the location where " +"you'd like your package to live. Our template will create the package " +"directory structure for you" msgstr "シェルで `cd` コマンドを使い、パッケージのディレクトリを置く場所に移動します。 Hatchがパッケージディレクトリを作成してくれます。" #: ../../tutorials/create-python-package.md:57 @@ -1253,35 +1248,39 @@ msgstr "すべて小文字を使用 (*推奨*)。 このチュートリアルで #: ../../tutorials/create-python-package.md:60 #, fuzzy msgid "" -"Only use letters and the characters _ or - in the name. This means that " -"the name `pyos*package` is not an acceptable name. However, the names " +"Only use letters and the characters _ or - in the name. This means that the" +" name `pyos*package` is not an acceptable name. However, the names " "`pyos_package` or `pyos-package` are both OK." msgstr "" -"名前にはアルファベットと _ または - " -"のみを使用してください。これは、`pyos*package`という名前は使えないことを意味します。しかし、 `pyos_package` または " -"`pyos-package` という名前であれば、どちらでも構いません。" +"名前にはアルファベットと _ または - のみを使用してください。これは、`pyos*package`という名前は使えないことを意味します。しかし、 " +"`pyos_package` または `pyos-package` という名前であれば、どちらでも構いません。" #: ../../tutorials/create-python-package.md:62 msgid "" "In your terminal, **run the command below**. This will begin a series of " -"prompts that will ask you questions and help you to customize your Python" -" package." +"prompts that will ask you questions and help you to customize your Python " +"package." msgstr "" +"ターミナルで、**以下のコマンドを実行**します。これにより、質問をし、Python " +"パッケージをカスタマイズするのに役立つ一連のプロンプトが開始されます。" #: ../../tutorials/create-python-package.md:68 msgid "" "After running the command above, the template will walk you through a " "series of questions." -msgstr "" +msgstr "上記のコマンドを実行すると、テンプレートによって一連の質問が表示されます。" #: ../../tutorials/create-python-package.md:70 msgid "" "Note that when you reach the prompt \"Do you want to answer one more " "question, and skip the rest, using the default values?\" you can choose " -"Yes, but with a minimal setup to create the most basic version" -" of your package that contains documentation, tests and a example module " -"for you to use." +"Yes, but with a minimal setup to create the most basic version " +"of your package that contains documentation, tests and a example module for" +" you to use." msgstr "" +"「デフォルト値を使用して、もう 1 つの質問に答えて残りをスキップしますか?」というプロンプトが表示されることに注意してください。 " +"はい、ただし最小限のセットアップを使用します を選択すると、使用するドキュメント、テスト、サンプル " +"モジュールを含むパッケージの最も基本的なバージョンを作成できます。" #: ../../tutorials/create-python-package.md:72 msgid "" @@ -1289,12 +1288,14 @@ msgid "" "username and will then create a package with basic tests, documentation, " "and GitHub configuration setup for you." msgstr "" +"この質問の後、テンプレートは希望の GitHub ユーザー名を尋ね、基本的なテスト、ドキュメント、GitHub " +"構成セットアップを含むパッケージを作成します。" #: ../../tutorials/create-python-package.md:93 msgid "" "The template will then begin to copy files into the directory that used " "above. (`.` means current working directory.)" -msgstr "" +msgstr "テンプレートは、上で使用したディレクトリへのファイルのコピーを開始します。 (「.」は現在の作業ディレクトリを意味します。)" #: ../../tutorials/create-python-package.md:101 #, fuzzy @@ -1307,13 +1308,17 @@ msgstr "テスト、ドキュメント、GitHubインフラストラクチャを #: ../../tutorials/create-python-package.md:119 msgid "" -"If you use the \"bells and whistles\" default option when working through" -" the template prompts, our template will create a complete package setup " -"with GitHub CI actions, typing, tests, environments, and more using " -"Hatch. If you customize the entire package, then you can select what " -"platform you wish to host it on (GitHub vs GitLab), whether you want " -"typing, what documentation engine you want to use, and more." +"If you use the \"bells and whistles\" default option when working through " +"the template prompts, our template will create a complete package setup " +"with GitHub CI actions, typing, tests, environments, and more using Hatch. " +"If you customize the entire package, then you can select what platform you " +"wish to host it on (GitHub vs GitLab), whether you want typing, what " +"documentation engine you want to use, and more." msgstr "" +"テンプレートのプロンプトを操作するときに「付加機能」のデフォルト オプションを使用すると、テンプレートは Hatch を使用して GitHub CI " +"アクション、入力、テスト、環境などを含む完全なパッケージ " +"セットアップを作成します。パッケージ全体をカスタマイズする場合は、どのプラットフォームでホストするか (GitHub か " +"GitLab)、入力するかどうか、使用するドキュメント エンジンなどを選択できます。" #: ../../tutorials/create-python-package.md:123 #, fuzzy @@ -1330,6 +1335,9 @@ msgid "" "/hosting-tools/sphinx-python-package-documentation-tools.html) with the " "PyData Sphinx Theme for documentation" msgstr "" +"[Sphinx](https://www.pyopensci.org/python-package-guide/documentation" +"/hosting-tools/sphinx-python-package-documentation-tools.html) ドキュメント用の " +"PyData Sphinx テーマ" #: ../../tutorials/create-python-package.md:149 msgid "pytest for testing" @@ -1343,9 +1351,11 @@ msgstr "Hatchと環境" #: ../../tutorials/create-python-package.md:152 msgid "" "**Full customization** If you want to customize any elements of your " -"package setup, choose `No, I want to fully customize the template.`. " -"This will allow you to select:" +"package setup, choose `No, I want to fully customize the template.`. This " +"will allow you to select:" msgstr "" +"**完全なカスタマイズ** パッケージ設定の要素をカスタマイズしたい場合は、「いいえ、テンプレートを完全にカスタマイズします。」を選択します。 " +"これにより、以下を選択できるようになります。" #: ../../tutorials/create-python-package.md:155 #, fuzzy @@ -1374,10 +1384,10 @@ msgstr "ステップ 2: パッケージにモジュールを追加する" #: ../../tutorials/create-python-package.md:163 #, fuzzy, python-brace-format msgid "" -"A {term}`Module` refers to a `.py` file containing the code that you want" -" your package to access and run. Within the `pyospackage` subdirectory, " -"you have an `example.py` module that you can use to test out your package" -" quickly." +"A {term}`Module` refers to a `.py` file containing the code that you want " +"your package to access and run. Within the `pyospackage` subdirectory, you " +"have an `example.py` module that you can use to test out your package " +"quickly." msgstr "" "Python モジュールとは、パッケージにアクセスさせ、実行させたいコードを含む `.py` ファイルを指します。 `pyospackage` " "サブディレクトリに、少なくとも1つのPythonモジュール (.py ファイル) を追加します。" @@ -1396,17 +1406,16 @@ msgstr "[typing](type-hints) を使用します。" #: ../../tutorials/create-python-package.md:171 msgid "" -"At the top of the module, there is a docstring explaining what the module" -" does." -msgstr "" +"At the top of the module, there is a docstring explaining what the module " +"does." +msgstr "モジュールの先頭には、モジュールの機能を説明するドキュメント文字列があります。" #: ../../tutorials/create-python-package.md:173 #, fuzzy msgid "" -"Python supports different docstring formats. The most popular formats for" -" documenting Python objects are NumPy Style Docstring[^numpydoc], Google " -"Style Docstring[^googledoc], and the Epytext Style " -"Docstrings[^epytextdoc]." +"Python supports different docstring formats. The most popular formats for " +"documenting Python objects are NumPy Style Docstring[^numpydoc], Google " +"Style Docstring[^googledoc], and the Epytext Style Docstrings[^epytextdoc]." msgstr "" "Pythonは、使いたいドキュメントのビルドシステムに応じて、多くの異なるdocstringsフォーマットをサポートすることができます。 " "Pythonオブジェクトを文書化するために最もよくサポートされている形式は、NumPy Style " @@ -1419,9 +1428,9 @@ msgstr "**pyOpenSciは、NumPyのDocstring規約を使用することを推奨 #: ../../tutorials/create-python-package.md:177 msgid "" -"[Learn more about docstrings here](api-docstrings) for an overview of " -"both topics." -msgstr "" +"[Learn more about docstrings here](api-docstrings) for an overview of both " +"topics." +msgstr "両方のトピックの概要については、[docstrings の詳細については、こちらをご覧ください](api-docstrings) を参照してください。" #: ../../tutorials/create-python-package.md:206 msgid "Python modules and the `__init__.py` file" @@ -1434,9 +1443,9 @@ msgstr "モジュールという言葉を目にしたとき、私たちはPython #: ../../tutorials/create-python-package.md:212 msgid "" -"The `__init__.py` allows Python to recognize that a directory contains " -"at least one module that may be imported and used in your code. A package" -" can have multiple modules[^python-modules]." +"The `__init__.py` allows Python to recognize that a directory contains at " +"least one module that may be imported and used in your code. A package can " +"have multiple modules[^python-modules]." msgstr "" "`__init__.py` は、Pythonがディレクトリに少なくとも1つのモジュールが含まれていることを認識できるようにします。 " "パッケージは複数のモジュール [^python-modules] を持つことができます。" @@ -1448,10 +1457,12 @@ msgstr "ステップ3: モジュールにコードを追加する" #: ../../tutorials/create-python-package.md:219 msgid "" -"If you want, add a second function to the `example.py` module. It can be " -"a simple function. For example, write a second function that multiplies " +"If you want, add a second function to the `example.py` module. It can be a " +"simple function. For example, write a second function that multiplies " "numbers." msgstr "" +"必要に応じて、2 番目の関数を `example.py` モジュールに追加します。単純な関数でも構いません。たとえば、数値を乗算する 2 " +"番目の関数を作成します。" #: ../../tutorials/create-python-package.md:222 #, fuzzy @@ -1465,12 +1476,14 @@ msgid "" "to-know-hatch), which will build your package. You can also specify " "metadata for your package." msgstr "" +"[pyproject.toml](pyproject-toml) ファイルには、パッケージを構築する [Hatch](get-to-know-" +"hatch) など、対話するさまざまなツールに指示を与えるメタデータが保存されます。パッケージのメタデータを指定することもできます。" #: ../../tutorials/create-python-package.md:229 #, fuzzy msgid "" -"You will learn more about the `pyproject.toml` format in the [next lesson" -" when you add additional metadata/information to this file.](pyproject-" +"You will learn more about the `pyproject.toml` format in the [next lesson " +"when you add additional metadata/information to this file.](pyproject-" "toml.md)" msgstr "" "`pyproject.toml` フォーマットについては、 [このファイルにメタデータや情報を追加する次のレッスン](pyproject-" @@ -1480,7 +1493,7 @@ msgstr "" msgid "" "The metadata in your generated `pyproject.toml` is already setup for you " "using the information you provided the copier template above." -msgstr "" +msgstr "生成された `pyproject.toml` 内のメタデータは、上記のコピー テンプレートで提供した情報を使用してすでにセットアップされています。" #: ../../tutorials/create-python-package.md:234 msgid "Brief overview of the TOML file" @@ -1499,9 +1512,9 @@ msgstr "`[this-is-a-table]`." #: ../../tutorials/create-python-package.md:241 #, fuzzy msgid "" -"Tables can contain variables within them defined by a variable name and " -"an `=` sign. For instance, a `build-system` table most often holds two " -"(2) variables:" +"Tables can contain variables within them defined by a variable name and an " +"`=` sign. For instance, a `build-system` table most often holds two (2) " +"variables:" msgstr "" "テーブルには、変数名と `=` 記号で定義された変数を入れることができます。 例えば、`build-system` " "テーブルは以下の2(つの)変数を保持することが多いです:" @@ -1540,22 +1553,24 @@ msgstr "" #: ../../tutorials/create-python-package.md:261 msgid "" -"Open up the `pyproject.toml` file that Hatch created in your favorite " -"text editor. It should look something like the example below." +"Open up the `pyproject.toml` file that Hatch created in your favorite text " +"editor. It should look something like the example below." msgstr "Hatchが作成した `pyproject.toml` ファイルをお好みのテキストエディタで開いてください。 下の例のようになるはずです。" #: ../../tutorials/create-python-package.md:262 msgid "" -"Make sure the package version, package name, and author name look " -"correct. The email is optional." -msgstr "" +"Make sure the package version, package name, and author name look correct. " +"The email is optional." +msgstr "パッケージのバージョン、パッケージ名、作成者名が正しいことを確認してください。電子メールはオプションです。" #: ../../tutorials/create-python-package.md:300 msgid "" -"At the bottom of the template-generated `pyproject.toml` file, you will " -"see a section that defines Hatch environments. We will cover Hatch " +"At the bottom of the template-generated `pyproject.toml` file, you will see" +" a section that defines Hatch environments. We will cover Hatch " "environments in a later lesson." msgstr "" +"テンプレートで生成された `pyproject.toml` " +"ファイルの下部に、ハッチ環境を定義するセクションが表示されます。ハッチ環境については後のレッスンで説明します。" #: ../../tutorials/create-python-package.md:302 msgid "The bare minimum needed in a pyproject.toml file" @@ -1564,19 +1579,18 @@ msgstr "pyproject.tomlファイルに最低限必要なもの" #: ../../tutorials/create-python-package.md:305 #, fuzzy msgid "" -"The core information that you need in a `pyproject.toml` file to publish " -"on PyPI is your **package's name** and the **version**. However, we " -"suggest that you flesh out your metadata early on in the `pyproject.toml`" -" file." +"The core information that you need in a `pyproject.toml` file to publish on" +" PyPI is your **package's name** and the **version**. However, we suggest " +"that you flesh out your metadata early on in the `pyproject.toml` file." msgstr "" -"PyPIで公開するために `pyproject.toml` ファイルに必要な情報は、 **パッケージ名** と **バージョン** です。 " -"しかし、 `pyproject.toml` ファイルの早い段階でメタデータを具体化することをお勧めします。" +"PyPIで公開するために `pyproject.toml` ファイルに必要な情報は、 **パッケージ名** と **バージョン** です。 しかし、 " +"`pyproject.toml` ファイルの早い段階でメタデータを具体化することをお勧めします。" #: ../../tutorials/create-python-package.md:307 #, fuzzy msgid "" -"Once you have your project metadata in the `pyproject.toml` file, you " -"will rarely update it." +"Once you have your project metadata in the `pyproject.toml` file, you will " +"rarely update it." msgstr "一度pyproject.tomlファイルにプロジェクトのメタデータがあれば、それを更新することはほとんどありません。次のレッスンでは、このファイルにさらにメタデータと構造を追加します。" #: ../../tutorials/create-python-package.md:311 @@ -1608,16 +1622,15 @@ msgstr "これで Python パッケージをインストール（ビルド）す #: ../../tutorials/create-python-package.md:321 #, fuzzy msgid "" -"While you can do this using Hatch, we will use pip for this lesson, so " -"you can see how to install your tool into your preferred environment." +"While you can do this using Hatch, we will use pip for this lesson, so you " +"can see how to install your tool into your preferred environment." msgstr "hatchを使ってもできますが、このレッスンではpipを使います、そうすれば、あなたの好みの環境にツールをインストールする方法を見ることができます。" #: ../../tutorials/create-python-package.md:323 #, fuzzy msgid "" "First, open your preferred shell (Windows users may use something like " -"GitBash) and `cd` into your project directory if you are not already " -"there." +"GitBash) and `cd` into your project directory if you are not already there." msgstr "" "まず、お好みのシェルを開き (Windowsユーザーはgitbashのようなものを使っているかもしれません) " "、まだプロジェクトディレクトリにいなければ、 `cd` してください。" @@ -1645,8 +1658,8 @@ msgstr "レッスンが公開されたら、これを追加してください。 #: ../../tutorials/create-python-package.md:329 msgid "" -"Activate the Python environment that you wish to use. If you need help " -"with working with virtual environments check out this lesson (add link)." +"Activate the Python environment that you wish to use. If you need help with" +" working with virtual environments check out this lesson (add link)." msgstr "使用したいPython環境をアクティブにします。 仮想環境での作業で助けが必要な場合は、このレッスンをチェックしてください（リンクを追加）。" #: ../../tutorials/create-python-package.md:355 @@ -1656,12 +1669,12 @@ msgstr "`python -m pip install -e .` は何をしているのか？" #: ../../tutorials/create-python-package.md:358 #, fuzzy msgid "" -"`python -m pip install -e .` installs your package into the current " -"active Python environment in **editable mode** (`-e`). Installing your " -"package in editable mode, allows you to work on your code and then test " -"the updates interactively in your favorite Python interface. One " -"important caveat of editable mode is that every time you update your " -"code, you need to restart Python." +"`python -m pip install -e .` installs your package into the current active " +"Python environment in **editable mode** (`-e`). Installing your package in " +"editable mode, allows you to work on your code and then test the updates " +"interactively in your favorite Python interface. One important caveat of " +"editable mode is that every time you update your code, you need to restart " +"Python." msgstr "" "`python -m pip install -e .` は、 **編集可能モード** (`-e`) で、現在のアクティブな Python " "環境にパッケージをインストールします。 " @@ -1671,8 +1684,8 @@ msgstr "" #: ../../tutorials/create-python-package.md:363 msgid "" -"If you wish to install the package regularly (not in editable mode) you " -"can use:" +"If you wish to install the package regularly (not in editable mode) you can" +" use:" msgstr "(編集可能モードではなく) 定期的にパッケージをインストールしたい場合は、次のようにします:" #: ../../tutorials/create-python-package.md:366 @@ -1686,19 +1699,19 @@ msgstr "**`pip` を呼び出す際に `python -m` を使用する**" #: ../../tutorials/create-python-package.md:370 msgid "" "Above, you use`python -m` to call the version of pip installed into your " -"current active environment. `python -m` is important to ensure that you " -"are calling the version of pip installed in your current environment." +"current active environment. `python -m` is important to ensure that you are" +" calling the version of pip installed in your current environment." msgstr "" -"上記では、 `python -m` を使用して、現在アクティブな環境にインストールされている pip のバージョンを呼び出します。 `python" -" -m` は、現在の環境にインストールされているバージョンの pip を呼び出していることを確認するために重要です。" +"上記では、 `python -m` を使用して、現在アクティブな環境にインストールされている pip のバージョンを呼び出します。 `python " +"-m` は、現在の環境にインストールされているバージョンの pip を呼び出していることを確認するために重要です。" #: ../../tutorials/create-python-package.md:374 msgid "" -"IMPORTANT: pip can also be used to install packages from PyPI. However, " -"in this case, you are telling pip to install your package from a local " -"folder by using the `.`. You could also specify a path to the project " -"directory on your computer instead of the `.` which tells pip to use the " -"current working directory." +"IMPORTANT: pip can also be used to install packages from PyPI. However, in " +"this case, you are telling pip to install your package from a local folder " +"by using the `.`. You could also specify a path to the project directory on" +" your computer instead of the `.` which tells pip to use the current " +"working directory." msgstr "" "重要: " "pipはPyPIからパッケージをインストールするためにも使用できます。しかし、この場合、`.`を使用してローカルフォルダからパッケージをインストールするようpipに指示しています。`.`の代わりにコンピュータ上のプロジェクトディレクトリへのパスを指定することもできます。`.`はpipに現在の作業ディレクトリを使用するよう指示します。" @@ -1711,8 +1724,8 @@ msgstr "あなたの環境でpyospackageを探す" #, fuzzy msgid "" "Once you have installed your package, you can view it in your current " -"environment. If you are using `venv` or `conda`, `pip` list will return a" -" list of packages in the current active environment." +"environment. If you are using `venv` or `conda`, `pip` list will return a " +"list of packages in the current active environment." msgstr "" "パッケージをインストールしたら、現在の環境でそれを見ることができます。 `venv` または `conda` を使用している場合、 `pip` " "list で現在インストールされているパッケージを確認することができます。" @@ -1720,8 +1733,8 @@ msgstr "" #: ../../tutorials/create-python-package.md:383 #, fuzzy msgid "" -"Note that because `pyospackage` is installed in editable mode (`-e`), pip" -" will show you the directory path to your project's code" +"Note that because `pyospackage` is installed in editable mode (`-e`), pip " +"will show you the directory path to your project's code" msgstr "" "pyospackageは編集可能モード (`-e`) " "でインストールされるため、pipはプロジェクトのコードへのディレクトリパスを表示することに注意してください。" @@ -1732,8 +1745,8 @@ msgstr "ステップ 6: 新しいパッケージをテストする" #: ../../tutorials/create-python-package.md:413 msgid "" -"After installing your package, type “python” at the command prompt in " -"your chosen terminal to start a Python session in your active Python " +"After installing your package, type “python” at the command prompt in your " +"chosen terminal to start a Python session in your active Python " "environment." msgstr "" "パッケージをインストールした後、選択したターミナルのコマンドプロンプトで“python”と入力して、アクティブなPython環境でPythonセッションを開始します。パッケージをインストールしたら、選択したターミナルのコマンドプロンプトで" @@ -1763,15 +1776,13 @@ msgid "Create a new GitHub repository" msgstr "新しいGitHubリポジトリを作成する" #: ../../tutorials/create-python-package.md:440 -msgid "" -"Push the contents of the project directory that you created above, to " -"GitHub" +msgid "Push the contents of the project directory that you created above, to GitHub" msgstr "上記で作成したプロジェクトディレクトリの内容をGitHubにプッシュします" #: ../../tutorials/create-python-package.md:441 msgid "" -"Finally install the package from GitHub using the command above. When you" -" use the command above, don't forget to substitute the user, repo, and " +"Finally install the package from GitHub using the command above. When you " +"use the command above, don't forget to substitute the user, repo, and " "branch_or_tag with your specific values." msgstr "" "最後に、上記のコマンドを使ってGitHubからパッケージをインストールします。 " @@ -1779,8 +1790,8 @@ msgstr "" #: ../../tutorials/create-python-package.md:443 msgid "" -"For instance below you install the pyospackage from the main branch of " -"the pyOpenSci repository." +"For instance below you install the pyospackage from the main branch of the " +"pyOpenSci repository." msgstr "例えば、以下のようにpyOpenSciリポジトリのmainブランチからpyospackageをインストールします。" #: ../../tutorials/create-python-package.md:446 @@ -1794,8 +1805,8 @@ msgstr "おめでとうございます！ あなたは最初のPythonパッケ #: ../../tutorials/create-python-package.md:452 #, fuzzy msgid "" -"You have now created a Python package that you can install into any " -"Python environment." +"You have now created a Python package that you can install into any Python " +"environment." msgstr "やったね！ これでどんなPython環境にもインストールできるPythonパッケージができました。" #: ../../tutorials/create-python-package.md:457 @@ -1808,17 +1819,15 @@ msgstr "[READMEファイル](add-readme.md) と [LICENSE](add-license-coc.md) msgid "" "[Add more metadata to your `pyproject.toml`](pyproject-toml.md) file to " "support PyPI publication." -msgstr "" -"PyPI での公開をサポートするために [ `pyproject.toml` ファイルにメタデータを追加します。](pyproject-" -"toml.md)" +msgstr "PyPI での公開をサポートするために [ `pyproject.toml` ファイルにメタデータを追加します。](pyproject-toml.md)" #: ../../tutorials/create-python-package.md:459 msgid "" "[Learn how to build your package distribution](publish-pypi) files " "(**sdist** and **wheel**) and publish to **test PyPI**." msgstr "" -"[パッケージ配布ファイルをビルド](publish-pypi) して (**sdist** と **wheel**) 、 **test " -"PyPI** に公開する方法を学びます。" +"[パッケージ配布ファイルをビルド](publish-pypi) して (**sdist** と **wheel**) 、 **test PyPI** " +"に公開する方法を学びます。" #: ../../tutorials/create-python-package.md:460 msgid "" @@ -1858,9 +1867,9 @@ msgstr "このレッスンで作成するディレクトリ構造は次のよう #: ../../tutorials/create-python-package.md:488 msgid "" -"Diagram showing the basic steps to creating an installable package. There" -" are 4 boxes with arrows pointing towards the right. The boxes read, your" -" code, create package structure, add metadata to pyproject.toml and pip " +"Diagram showing the basic steps to creating an installable package. There " +"are 4 boxes with arrows pointing towards the right. The boxes read, your " +"code, create package structure, add metadata to pyproject.toml and pip " "install package." msgstr "" "インストール可能なパッケージを作成する基本的な手順を示した図です。 右を向いた矢印の箱が4つあります。 " @@ -1888,29 +1897,28 @@ msgid "" "Your package code lives within a `src/packagename` directory. We suggest " "that you use `src` (short for **source code**) directory as it [ensures " "that you are running tests on the installed version of your " -"code](https://www.pyopensci.org/python-package-guide/package-structure-" -"code/python-package-structure.html#the-src-layout-and-testing)." +"code](https://www.pyopensci.org/python-package-guide/package-structure-code" +"/python-package-structure.html#the-src-layout-and-testing)." msgstr "" "パッケージのコードは `src/packagename` " "ディレクトリにある。[インストールされたバージョンのコードでテストを実行していることを確認するため、](https://www.pyopensci.org" -"/python-package-guide/package-structure-code/python-package-" -"structure.html#the-src-layout-and-testing) `src`（ **source code** " +"/python-package-guide/package-structure-code/python-package-structure.html" +"#the-src-layout-and-testing) `src`（ **source code** " "の略）ディレクトリを使用することをお勧めします。" #: ../../tutorials/create-python-package.md:498 msgid "" "Within the `src` directory you have a package directory called " -"`pyospackage`. Use the name of your package for that directory name. This" -" will be the name for importing your package in Python code once " -"installed." +"`pyospackage`. Use the name of your package for that directory name. This " +"will be the name for importing your package in Python code once installed." msgstr "" -"`src` ディレクトリの中に `pyospackage` というパッケージディレクトリがあります。 ディレクトリ名にはパッケージ名を使用します。" -" これは、インストール後にPythonコードでパッケージをインポートする際の名前になります。" +"`src` ディレクトリの中に `pyospackage` というパッケージディレクトリがあります。 ディレクトリ名にはパッケージ名を使用します。 " +"これは、インストール後にPythonコードでパッケージをインポートする際の名前になります。" #: ../../tutorials/create-python-package.md:499 msgid "" -"In your package directory, you have an `__init__.py` file and all of your" -" Python modules. You will learn more about the `__init__.py` file below." +"In your package directory, you have an `__init__.py` file and all of your " +"Python modules. You will learn more about the `__init__.py` file below." msgstr "" "パッケージディレクトリには `__init__.py` ファイルと Python モジュールがあります。以下に `__init__.py` " "ファイルについて詳しく説明します。" @@ -1921,10 +1929,10 @@ msgstr "`pyproject.toml` ファイルはパッケージのルートディレク #: ../../tutorials/create-python-package.md:501 msgid "" -"The name of the root directory for the package is **pyospackage** which " -"is the name of the package. This is not a requirement but you will often " -"see that the GitHub / GitLab repository and the root directory name are " -"the same as the package name." +"The name of the root directory for the package is **pyospackage** which is " +"the name of the package. This is not a requirement but you will often see " +"that the GitHub / GitLab repository and the root directory name are the " +"same as the package name." msgstr "" "パッケージのルートディレクトリの名前は、パッケージ名である **pyospackage** です。これは必須ではありませんが、GitHub / " "GitLabのリポジトリ名とルートディレクトリ名がパッケージ名と同じであることをよく見かけます。" @@ -1935,9 +1943,9 @@ msgstr "`__init__.py` ファイルとは何ですか？" #: ../../tutorials/create-python-package.md:505 msgid "" -"The `__init__.py` file tells Python that a directory should be treated as" -" a Python package. As such, a directory with an `__init__.py` file can be" -" imported directly into Python. The `__init__.py` file does not need to " +"The `__init__.py` file tells Python that a directory should be treated as a" +" Python package. As such, a directory with an `__init__.py` file can be " +"imported directly into Python. The `__init__.py` file does not need to " "contain any code in order for Python to recognize it; it can be empty." msgstr "" "`__init__.py` ファイルは Python にディレクトリを Python パッケージとして扱うように指示します。 " @@ -1971,9 +1979,9 @@ msgstr "依存関係 (依存するパッケージ) を定義します。" #: ../../tutorials/create-python-package.md:521 msgid "" -"Used to specify and configure what build backend you want to use to " -"[build your package](../package-structure-code/python-package-" -"distribution-files-sdist-wheel)." +"Used to specify and configure what build backend you want to use to [build " +"your package](../package-structure-code/python-package-distribution-files-" +"sdist-wheel)." msgstr "" "[パッケージのビルド](../package-structure-code/python-package-distribution-files-" "sdist-wheel) に使用するビルドバックエンドを指定し、設定します。" @@ -1981,10 +1989,9 @@ msgstr "" #: ../../tutorials/create-python-package.md:523 msgid "" "After the `__init__.py` and `pyproject.toml` files have been added, your " -"package can be built and distributed as an installable Python package " -"using tools such as pip. Note that the `pyproject.toml` file needs to " -"have a few basic items defined for the package to be installable " -"including:" +"package can be built and distributed as an installable Python package using" +" tools such as pip. Note that the `pyproject.toml` file needs to have a few" +" basic items defined for the package to be installable including:" msgstr "" "`__init__.py` と `pyproject.toml` " "ファイルが追加されたら、pipなどのツールを使ってパッケージをビルドし、インストール可能なPythonパッケージとして配布することができます。 " @@ -2007,8 +2014,8 @@ msgstr "pyproject.tomlファイルが重要な理由" #, fuzzy msgid "" "The `pyproject.toml` file replaces some of the functionality of both the " -"`setup.py` file and `setup.cfg` files. If you try to pip install a " -"package with no `pyproject.toml`, you will get the following error:" +"`setup.py` file and `setup.cfg` files. If you try to pip install a package " +"with no `pyproject.toml`, you will get the following error:" msgstr "" "`pyproject.toml` ファイルは `setup.py` ファイルと `setup.cfg` ファイルの機能の一部を置き換えます。 " "`pyproject.toml` がないパッケージをpipインストールしようとすると、以下のエラーが発生します:" @@ -2027,23 +2034,21 @@ msgstr "" msgid "" "See [Using Hatch to Migrate setup.py to a pyproject.toml](setup-py-to-" "pyproject-toml.md)" -msgstr "" -"[Hatchを使ってsetup.pyをpyproject.tomlに移行する ](setup-py-to-pyproject-toml.md) " -"を参照" +msgstr "[Hatchを使ってsetup.pyをpyproject.tomlに移行する ](setup-py-to-pyproject-toml.md) を参照" #: ../../tutorials/create-python-package.md:561 msgid "" -"Is it clear where to add commands? Bash vs. Python console Bash vs. Zsh " -"is different" +"Is it clear where to add commands? Bash vs. Python console Bash vs. Zsh is " +"different" msgstr "コマンドを追加する場所は明確ですか？ BashとPythonのコンソールの違い BashとZshの違い" #: ../../tutorials/create-python-package.md:563 msgid "" "ADD: note about what makes something \"package worthy\", with a common " -"misconception being that a package should be production-ready code that's" -" valuable to a broad audience. This may not be a pervasive misconception " -"in Python, but a quick break-out with an explanation of what a package " -"can consist of would be helpful." +"misconception being that a package should be production-ready code that's " +"valuable to a broad audience. This may not be a pervasive misconception in " +"Python, but a quick break-out with an explanation of what a package can " +"consist of would be helpful." msgstr "" "追加: 何をもって \"パッケージに値する\" とするのかについて、 " "一般的な誤解は、パッケージは幅広いオーディエンスにとって価値のある、生産可能なコードであるべきだというものです。これはPythonに蔓延している誤解ではないかもしれませんが、パッケージがどのようなもので構成されるかを簡単に説明することは役に立つでしょう。" @@ -2095,17 +2100,20 @@ msgstr "Pythonパッケージの要素" msgid "" "[In a previous lesson](create-pure-python-package), you learned how to " "create a Python package using the pyOpenSci copier template. In this " -"lesson, you'll learn how to manage and use the Hatch environments set up " -"by de **What you need to complete this lesson**" +"lesson, you'll learn how to manage and use the Hatch environments set up by" +" de **What you need to complete this lesson**" msgstr "" +"[前のレッスン](create-pure-python-package)では、pyOpenSci コピーテンプレートを使用して Python " +"パッケージを作成する方法を学びました。このレッスンでは、**このレッスンを完了するために必要なもの** によってセットアップされた Hatch " +"環境を管理および使用する方法を学習します。" #: ../../tutorials/develop-python-package-hatch.md:16 #, fuzzy msgid "" -"To complete this lesson, you will need a local Python environment and " -"shell on your computer. You will need to have created a package using " -"our pyOpenSci copier template. You should also have [Hatch installed" -"](get-to-know-hatch)." +"To complete this lesson, you will need a local Python environment and shell" +" on your computer. You will need to have created a package using our " +"pyOpenSci copier template. You should also have [Hatch installed](get-to-" +"know-hatch)." msgstr "" "このレッスンを完了するには、あなたのコンピュータにローカルのPython環境とシェルが必要です。　[Hatchのインストール](get-to-" "know-hatch) も必要です。" @@ -2115,28 +2123,31 @@ msgstr "" msgid "" "If you are using Windows or are not familiar with Shell, you may want to " "check out the [Carpentries shell lesson](https://swcarpentry.github.io" -"/shell-novice/). Windows users will likely need to configure a tool such " -"as [GitBash](https://gitforwindows.org/) for any Shell and git-related " -"steps." +"/shell-novice/). Windows users will likely need to configure a tool such as" +" [GitBash](https://gitforwindows.org/) for any Shell and git-related steps." msgstr "" "Windowsを使用している、またはシェルに精通していない場合は、Carpentriesのシェルレッスン[^shell-lesson] " -"をチェックアウトすることをお勧めします。 " -"Windowsユーザーは、Shellやgitに関連するステップのためにツールを設定する必要があるでしょう。" +"をチェックアウトすることをお勧めします。 Windowsユーザーは、Shellやgitに関連するステップのためにツールを設定する必要があるでしょう。" #: ../../tutorials/develop-python-package-hatch.md:23 msgid "" -"Welcome to your shiny new package! This page will help you get started " -"with using [Hatch](get-to-know-hatch) to run tests, build and check your " +"Welcome to your shiny new package! This page will help you get started with" +" using [Hatch](get-to-know-hatch) to run tests, build and check your " "package, and build your documentation." msgstr "" +"ピカピカの新しいパッケージへようこそ!このページは、[Hatch](ハッチを知る) " +"を使用してテストを実行し、パッケージをビルドおよびチェックし、ドキュメントをビルドする方法を開始するのに役立ちます。" #: ../../tutorials/develop-python-package-hatch.md:27 #, python-brace-format msgid "" -"To begin, have a look at the [pyproject.toml](pyproject-toml) file in " -"your package directory. This file contains the configuration for your " -"package and is written using {term}`TOML` format. Here's the TL&DR:" +"To begin, have a look at the [pyproject.toml](pyproject-toml) file in your " +"package directory. This file contains the configuration for your package " +"and is written using {term}`TOML` format. Here's the TL&DR:" msgstr "" +"まず、パッケージ ディレクトリ内の [pyproject.toml](pyproject-toml) " +"ファイルを見てください。このファイルにはパッケージの構成が含まれており、{term}`TOML` 形式を使用して書かれています。 " +"TL&DRは次のとおりです。" #: ../../tutorials/develop-python-package-hatch.md:31 msgid "Each `[]` section in the toml file is called a table." @@ -2147,68 +2158,76 @@ msgid "You can nest tables with double brackets like this`[[]]`" msgstr "このように二重括弧`[[]]`でテーブルをネストできます" #: ../../tutorials/develop-python-package-hatch.md:33 -msgid "" -"Tables contain information about a certain thing that you want to " -"configure." -msgstr "" +msgid "Tables contain information about a certain thing that you want to configure." +msgstr "テーブルには、構成したい特定の内容に関する情報が含まれています。" #: ../../tutorials/develop-python-package-hatch.md:36 msgid "" -"You can configure Hatch to use UV by default for environment management. " -"UV is a package manager built in Rust. It is fast and will significantly " +"You can configure Hatch to use UV by default for environment management. UV" +" is a package manager built in Rust. It is fast and will significantly " "speed up environment creation." msgstr "" +"環境管理にデフォルトで UV を使用するように Hatch を構成できます。 UV は Rust に組み込まれたパッケージ " +"マネージャーです。これは高速であり、環境の作成を大幅にスピードアップします。" #: ../../tutorials/develop-python-package-hatch.md:38 msgid "" "To use UV with Hatch, configure Hatch in the \"tools\" section of your " "`pyproject.toml` file." -msgstr "" +msgstr "ハッチングで UV を使用するには、`pyproject.toml` ファイルの「tools」セクションでハッチングを設定します。" #: ../../tutorials/develop-python-package-hatch.md:46 msgid "" "Using Hatch for developing, building, and maintaining your pure Python " "package" -msgstr "" +msgstr "Hatch を使用した純粋な Python パッケージの開発、構築、保守" #: ../../tutorials/develop-python-package-hatch.md:48 #, python-brace-format msgid "" "In the pyOpenSci Python package template, we have set up {term}`Hatch " "environment` definitions. You will notice at the bottom of the file, a " -"[hatch environment](https://hatch.pypa.io/1.13/environment/) section, " -"that looks like this:" +"[hatch environment](https://hatch.pypa.io/1.13/environment/) section, that " +"looks like this:" msgstr "" +"pyOpenSci Python パッケージ テンプレートでは、{term}「ハッチ環境」定義をセットアップしました。ファイルの下部に、次のような " +"[hatch 環境](https://hatch.pypa.io/1.13/environment/) セクションがあることに気づくでしょう。" #: ../../tutorials/develop-python-package-hatch.md:59 msgid "" -"Hatch allows you to configure and run environments and scripts similar to" -" a workflow tool like tox or nox." -msgstr "" +"Hatch allows you to configure and run environments and scripts similar to a" +" workflow tool like tox or nox." +msgstr "Hatch を使用すると、tox や nox などのワークフロー ツールと同様の環境とスクリプトを構成して実行できます。" #: ../../tutorials/develop-python-package-hatch.md:62 msgid "" "Hatch defaults to using `venv` to manage environments. However, you can " "configure it to use other environment tools, such as conda or mamba." msgstr "" +"Hatch はデフォルトで `venv` を使用して環境を管理します。ただし、conda や mamba " +"などの他の環境ツールを使用するように構成できます。" #: ../../tutorials/develop-python-package-hatch.md:64 msgid "" "[Read the hatch documentation to learn more about environments. " "](https://hatch.pypa.io/1.13/tutorials/environment/basic-usage/)" msgstr "" +"[環境について詳しくは、ハッチングのドキュメントを参照してください。 " +"](https://hatch.pypa.io/1.13/tutorials/environment/basic-usage/)" #: ../../tutorials/develop-python-package-hatch.md:68 msgid "" -"Below is the Hatch environment used to build and test your package. " -"Anytime you see: `tool.hatch.envs.test`, it tells Hatch:" +"Below is the Hatch environment used to build and test your package. Anytime" +" you see: `tool.hatch.envs.test`, it tells Hatch:" msgstr "" +"以下は、パッケージのビルドとテストに使用される Hatch 環境です。 「tool.hatch.envs.test」が表示されるたびに、Hatch " +"に次のように指示します。" #: ../../tutorials/develop-python-package-hatch.md:71 msgid "" -"\"Hey, Hatch, this is the definition for an environment.`test` is the " -"name of the environment that I want you to create.\"" -msgstr "" +"\"Hey, Hatch, this is the definition for an environment.`test` is the name " +"of the environment that I want you to create.\"" +msgstr "「ねえ、ハッチ、これは環境の定義です。`test` はあなたに作成してほしい環境の名前です。」" #: ../../tutorials/develop-python-package-hatch.md:73 msgid "So `tool.hatch.envs.build` will create an environment called `build`." @@ -2216,9 +2235,9 @@ msgstr "つまり `tool.hatch.envs.build` は `build` という環境を作成 #: ../../tutorials/develop-python-package-hatch.md:75 msgid "" -"Below the environment \"declaration,\" you can see the definition of what" -" should be in that environment." -msgstr "" +"Below the environment \"declaration,\" you can see the definition of what " +"should be in that environment." +msgstr "環境の「宣言」の下に、その環境にあるべきものの定義が表示されます。" #: ../../tutorials/develop-python-package-hatch.md:77 #, fuzzy @@ -2229,19 +2248,25 @@ msgstr "パッケージのインストール" #, python-brace-format msgid "" "Below is a Hatch environment definition that you will find in your new " -"project's [pyproject.toml](pyproject-toml) file. It is set up to build " -"your package's {term}`Distribution files` ({term}`Source distribution " -"(sdist)` and {term}`Wheel (.whl)`)." +"project's [pyproject.toml](pyproject-toml) file. It is set up to build your" +" package's {term}`Distribution files` ({term}`Source distribution (sdist)` " +"and {term}`Wheel (.whl)`)." msgstr "" +"以下は、新しいプロジェクトの [pyproject.toml](pyproject-toml) ファイルにある Hatch " +"環境定義です。これは、パッケージの {term}`配布ファイル` ({term}`ソース配布 (sdist)` および {term}`ホイール " +"(.whl)`) をビルドするように設定されています。" #: ../../tutorials/develop-python-package-hatch.md:84 #, python-brace-format msgid "" -"Notice that the environment definition declares two {term}`Dependencies`:" -" `pip` and `twine`, which the environment needs to run successfully. This" -" declaration is similar to declaring dependencies for your package at the" -" top of your [pyproject.toml](pyproject-toml)." +"Notice that the environment definition declares two {term}`Dependencies`: " +"`pip` and `twine`, which the environment needs to run successfully. This " +"declaration is similar to declaring dependencies for your package at the " +"top of your [pyproject.toml](pyproject-toml)." msgstr "" +"環境定義では、環境が正常に実行されるために必要な 2 つの {term}`Dependency`、`pip` と `twine` " +"が宣言されていることに注意してください。この宣言は、[pyproject.toml](pyproject-toml) " +"の先頭でパッケージの依存関係を宣言するのと似ています。" #: ../../tutorials/develop-python-package-hatch.md:99 #, fuzzy @@ -2255,6 +2280,9 @@ msgid "" "environment it creates. `detached=True` tells it not to install your " "package into the environment." msgstr "" +"環境の下部にある「detached = True」フラグに注目してください。デフォルトでは、hatch " +"は作成した環境にパッケージを編集可能モードでインストールします。 `detached=True` " +"は、パッケージを環境にインストールしないように指示します。" #: ../../tutorials/develop-python-package-hatch.md:104 msgid "Hatch scripts" @@ -2270,15 +2298,17 @@ msgstr "Hatchは特定のHatch環境で実行されるスクリプトの定義 #: ../../tutorials/develop-python-package-hatch.md:109 msgid "" "Above, you have defined a new environment called 'build' that Hatch will " -"create as a virtual environment (venv). Because `detached = True` in that" -" environment, Hatch won't install your package into it." +"create as a virtual environment (venv). Because `detached = True` in that " +"environment, Hatch won't install your package into it." msgstr "" +"上記では、Hatch が仮想環境 (venv) として作成する「build」という新しい環境を定義しました。その環境では「detached = " +"True」なので、Hatch はパッケージをその環境にインストールしません。" #: ../../tutorials/develop-python-package-hatch.md:111 msgid "" -"You can then use that environment to run \"scripts\". The definition " -"below tells Hatch to run the following scripts in the build environment." -msgstr "" +"You can then use that environment to run \"scripts\". The definition below " +"tells Hatch to run the following scripts in the build environment." +msgstr "`scripts`: 実行するスクリプトを定義します。この場合、Hatch はシェル スクリプトを実行します。" #: ../../tutorials/develop-python-package-hatch.md:113 msgid "`[tool.hatch.envs.build.scripts]`" @@ -2298,15 +2328,13 @@ msgstr "`envs.build`: 定義されたビルド環境を使用します。" #: ../../tutorials/develop-python-package-hatch.md:119 msgid "" -"`scripts`: Define what scripts to run. In this case, Hatch will run shell" -" scripts." -msgstr "" +"`scripts`: Define what scripts to run. In this case, Hatch will run shell " +"scripts." +msgstr "以下は、実行される 3 つのシェル コマンドを定義する `build.scripts` テーブルです。" #: ../../tutorials/develop-python-package-hatch.md:122 -msgid "" -"Below is the `build.scripts` table that defines 3 shell commands to be " -"run:" -msgstr "" +msgid "Below is the `build.scripts` table that defines 3 shell commands to be run:" +msgstr "`twine check dist/*` #twine を使用して、パッケージの sdist (ソース配布) が正常であることを確認します。" #: ../../tutorials/develop-python-package-hatch.md:124 msgid "`pip check` # verifies your dependencies" @@ -2319,16 +2347,20 @@ msgstr "ステップ 2: パッケージのsdistとwheelディストリビュー #: ../../tutorials/develop-python-package-hatch.md:126 msgid "" -"`twine check dist/*` # use twine to check that your package's sdist " -"(source distribution) is ok." +"`twine check dist/*` # use twine to check that your package's sdist (source" +" distribution) is ok." msgstr "" +"Hatch はデフォルトで、作成した仮想環境 (venv) にパッケージを編集可能モードでインストールします。 `detached=True` " +"が設定されている場合、そのステップはスキップされます。" #: ../../tutorials/develop-python-package-hatch.md:140 msgid "" "Hatch, by default, will install your package in editable mode into any " -"virtual environment (venv) that it creates. If `detached=True` is set, " -"then it will skip that step." +"virtual environment (venv) that it creates. If `detached=True` is set, then" +" it will skip that step." msgstr "" +"デフォルトでは、Hatchはパッケージを編集可能なモードで、作成した任意の仮想環境（ venv ）にインストールします。「detached = " +"True」が設定されている場合、そのステップはスキップされます。" #: ../../tutorials/develop-python-package-hatch.md:143 #, fuzzy @@ -2347,7 +2379,7 @@ msgstr "`hatch run build:check`" msgid "" "This step updates the build environment and then builds and checks the " "output distributions of your package." -msgstr "" +msgstr "この手順では、ビルド環境を更新し、パッケージの出力ディストリビューションをビルドして確認します。" #: ../../tutorials/develop-python-package-hatch.md:151 msgid "You can enter the build environment in your shell to check it out:" @@ -2374,6 +2406,8 @@ msgid "" "expect your users to be using. In this section, you'll explore the test " "environment setup in the pyOpenSci template package." msgstr "" +"ユーザーが使用すると予想される Python バージョンでテストを実行すると、常に役立ちます。このセクションでは、pyOpenSci テンプレート " +"パッケージでのテスト環境のセットアップについて説明します。" #: ../../tutorials/develop-python-package-hatch.md:173 msgid "Below, you see the Hatch environment test table." @@ -2381,10 +2415,10 @@ msgstr "以下に、Hatch環境テストテーブルが表示されます。" #: ../../tutorials/develop-python-package-hatch.md:175 msgid "" -"Similar to the above build environment, the environment below defines the" -" dependencies that Hatch needs to install into the test environment " +"Similar to the above build environment, the environment below defines the " +"dependencies that Hatch needs to install into the test environment " "(required to run your tests)." -msgstr "" +msgstr "上記のビルド環境と同様に、以下の環境は、Hatch がテスト環境にインストールする必要がある (テストを実行するために必要な) 依存関係を定義します。" #: ../../tutorials/develop-python-package-hatch.md:189 msgid "Your test environment has a matrix associated with it" @@ -2392,32 +2426,37 @@ msgstr "テスト環境にはマトリックスが関連付けられています #: ../../tutorials/develop-python-package-hatch.md:191 msgid "" -"If the environment has a matrix associated with it, that tells Hatch to " -"run the tests across different Python versions. Below, you are running " -"tests on versions 3.10 through 3.13." +"If the environment has a matrix associated with it, that tells Hatch to run" +" the tests across different Python versions. Below, you are running tests " +"on versions 3.10 through 3.13." msgstr "" +"環境にマトリックスが関連付けられている場合は、異なる Python バージョン間でテストを実行するように Hatch " +"に指示します。以下では、バージョン 3.10 ～ 3.13 でテストを実行しています。" #: ../../tutorials/develop-python-package-hatch.md:194 msgid "" "Hatch by default will install Python [using " -"UV](https://docs.astral.sh/uv/guides/install-python/) both when you " -"install Hatch and also when you declare a matrix environment like the one" -" below" +"UV](https://docs.astral.sh/uv/guides/install-python/) both when you install" +" Hatch and also when you declare a matrix environment like the one below" msgstr "" +"Hatch は、Hatch をインストールするときと、以下のようなマトリックス環境を宣言するときの両方で、デフォルトで Python [UV " +"を使用して](https://docs.astral.sh/uv/guides/install-python/) をインストールします。" #: ../../tutorials/develop-python-package-hatch.md:202 msgid "" "In your project, if you run `hatch shell test`, you will see the output " "below. This means that because there is a matrix of Python versions to " -"choose from, you need to select the environment with the Python version " -"you want to use." +"choose from, you need to select the environment with the Python version you" +" want to use." msgstr "" +"プロジェクトで「hatch Shell test」を実行すると、以下の出力が表示されます。これは、選択できる Python " +"バージョンのマトリックスがあるため、使用する Python バージョンが含まれる環境を選択する必要があることを意味します。" #: ../../tutorials/develop-python-package-hatch.md:215 msgid "" "Pick the Python test environment that you want to use and enter it, like " "this (this will open Python 3.13):" -msgstr "" +msgstr "使用する Python テスト環境を選択し、次のように入力します (これにより、Python 3.13 が開きます)。" #: ../../tutorials/develop-python-package-hatch.md:227 #, fuzzy @@ -2426,16 +2465,20 @@ msgstr "`hatch publish -r test` を実行します" #: ../../tutorials/develop-python-package-hatch.md:229 msgid "" -"In that same tests section, you will see a `tool.hatch.envs.test.scripts`" -" section. Similar to what you saw above with the build steps, this is " -"where the \"script\" to run your tests is defined." +"In that same tests section, you will see a `tool.hatch.envs.test.scripts` " +"section. Similar to what you saw above with the build steps, this is where " +"the \"script\" to run your tests is defined." msgstr "" +"同じテスト " +"セクションに、「tool.hatch.envs.test.scripts」セクションがあります。上記のビルド手順と同様に、ここでテストを実行する「スクリプト」が定義されます。" #: ../../tutorials/develop-python-package-hatch.md:232 msgid "" "Notice that below, the script has a script called `run`. And that script " "runs pytest with a set of arguments, including generating code coverage." msgstr "" +"以下のスクリプトには「run」というスクリプトがあることに注意してください。そして、そのスクリプトは、コード " +"カバレッジの生成を含む一連の引数を指定して pytest を実行します。" #: ../../tutorials/develop-python-package-hatch.md:239 msgid "To run this script in your terminal, use the syntax:" @@ -2451,25 +2494,26 @@ msgid "Reminder" msgstr "おすすめ" #: ../../tutorials/develop-python-package-hatch.md:246 -msgid "" -"`hatch run`: this calls hatch and tells it that it will be running a " -"command" -msgstr "" +msgid "`hatch run`: this calls hatch and tells it that it will be running a command" +msgstr "`hatch run`: これはハッチを呼び出し、コマンドを実行することを伝えます。" #: ../../tutorials/develop-python-package-hatch.md:247 msgid "" "`test:run` defines the environment you want it to run (`test`) in this " "case, and the script is defined as `run`" -msgstr "" +msgstr "この場合、`test:run` は実行する環境 (`test`) を定義し、スクリプトは `run` として定義されます。" #: ../../tutorials/develop-python-package-hatch.md:250 msgid "" -"If you have a matrix setup for tests, then it will both install the " -"needed Python version using UV and run your tests in each version of the " -"Python environment. In this case, since there are four Python versions in" -" the environment, your tests will be run four times, once in each Python " -"version listed in the matrix table." +"If you have a matrix setup for tests, then it will both install the needed " +"Python version using UV and run your tests in each version of the Python " +"environment. In this case, since there are four Python versions in the " +"environment, your tests will be run four times, once in each Python version" +" listed in the matrix table." msgstr "" +"テスト用のマトリックス セットアップがある場合は、UV を使用して必要な Python バージョンをインストールし、Python " +"環境の各バージョンでテストを実行します。この場合、環境には 4 つの Python バージョンがあるため、テストはマトリックス " +"テーブルにリストされている各 Python バージョンで 1 回ずつ、計 4 回実行されます。" #: ../../tutorials/develop-python-package-hatch.md:280 msgid "Build your documentation with Hatch environments" @@ -2477,9 +2521,9 @@ msgstr "Hatch環境でドキュメントをビルドする" #: ../../tutorials/develop-python-package-hatch.md:282 msgid "" -"Finally, you can build and serve your documentation using hatch. To build" -" a static HTML version of the docs run:" -msgstr "" +"Finally, you can build and serve your documentation using hatch. To build a" +" static HTML version of the docs run:" +msgstr "最後に、ハッチを使用してドキュメントを構築して提供できます。静的 HTML バージョンのドキュメントを構築するには、次のコマンドを実行します。" #: ../../tutorials/develop-python-package-hatch.md:285 msgid "`hatch run docs:build`" @@ -2489,7 +2533,7 @@ msgstr "`hatch run docs:build`" msgid "" "To run a local server with your docs updated as you update your markdown " "files, run:" -msgstr "" +msgstr "マークダウン ファイルの更新に応じてドキュメントも更新された状態でローカル サーバーを実行するには、次のコマンドを実行します。" #: ../../tutorials/develop-python-package-hatch.md:289 msgid "`hatch run docs:serve`" @@ -2515,14 +2559,14 @@ msgid "" "there, we have selected Hatch because:" msgstr "" "私たちの Python パッケージングチュートリアルは [Hatch](https://hatch.pypa.io/latest/) " -"というツールを使っています。 世の中には [たくさんの素晴らしいパッケージングツール](/package-structure-code" -"/python-package-build-tools) があります、私たちはHatchを選ぶ理由は:" +"というツールを使っています。 世の中には [たくさんの素晴らしいパッケージングツール](/package-structure-code/python-" +"package-build-tools) があります、私たちはHatchを選ぶ理由は:" #: ../../tutorials/get-to-know-hatch.md:13 msgid "" -"It is an end-to-end tool that supports most of the steps required to " -"create a quality Python package. Beginners will have fewer tools to learn" -" if they use Hatch." +"It is an end-to-end tool that supports most of the steps required to create" +" a quality Python package. Beginners will have fewer tools to learn if they" +" use Hatch." msgstr "高品質なPythonパッケージを作成するために必要なステップのほとんどをサポートするエンドツーエンドのツールです。Hatchを使えば、初心者は覚えるツールが少なくて済みます。" #: ../../tutorials/get-to-know-hatch.md:16 @@ -2540,8 +2584,8 @@ msgstr "コミュニティとして、pyOpenSciはHatchが多くの異なる科 #: ../../tutorials/get-to-know-hatch.md:21 msgid "" -"In this tutorial, you will install and get to know Hatch a bit more " -"before starting to use it." +"In this tutorial, you will install and get to know Hatch a bit more before " +"starting to use it." msgstr "このチュートリアルでは、Hatchをインストールし、使い始める前にもう少しHatchについて知ってもらいます。" #: ../../tutorials/get-to-know-hatch.md:24 @@ -2558,8 +2602,8 @@ msgstr "Hatchをインストールする必要があります。" #: ../../tutorials/get-to-know-hatch.md:30 msgid "" -"If you don't already have Python installed on your computer, Hatch will " -"do it for you when you install Hatch." +"If you don't already have Python installed on your computer, Hatch will do " +"it for you when you install Hatch." msgstr "Pythonがまだインストールされていない場合は、Hatchをインストールする際にPythonがインストールされます。" #: ../../tutorials/get-to-know-hatch.md:34 @@ -2633,8 +2677,8 @@ msgstr "" #, fuzzy, python-brace-format msgid "" "Hatch can also be installed directly using {term}`pip` or " -"[conda](https://hatch.pypa.io/latest/install/#conda). We encourage you to" -" follow the instructions above because we have found that the Hatch " +"[conda](https://hatch.pypa.io/latest/install/#conda). We encourage you to " +"follow the instructions above because we have found that the Hatch " "installers for Windows and Mac are the easiest and most efficient." msgstr "" "Hatchは [pip](https://hatch.pypa.io/latest/install/#pip) や " @@ -2650,9 +2694,8 @@ msgstr "私たちのLinuxユーザーは、すでにapt installを使ってい #: ../../tutorials/get-to-know-hatch.md:83 msgid "" "Both approaches (using a graphical installer on Windows/Mac and pipx) " -"ensure that you have Hatch installed globally. A global install means " -"that Hatch is available across all of your Python environments on your " -"computer." +"ensure that you have Hatch installed globally. A global install means that " +"Hatch is available across all of your Python environments on your computer." msgstr "" "どちらのアプローチ（Windows/Macでグラフィカルインストーラを使う方法とpipxを使う方法）も、Hatchがグローバルにインストールされていることを保証します。" " グローバルインストールとは、コンピュータ上の全てのPython環境でHatchが利用できることを意味します。" @@ -2663,8 +2706,8 @@ msgstr "hatchが正しく取り付けられているか確認します" #: ../../tutorials/get-to-know-hatch.md:90 msgid "" -"Once you have completed the installation instructions above, you can open" -" your terminal, and make sure that Hatch installed correctly using the " +"Once you have completed the installation instructions above, you can open " +"your terminal, and make sure that Hatch installed correctly using the " "command below:" msgstr "上記のインストール手順が完了したら、ターミナルを開き、以下のコマンドを使用してHatchが正しくインストールされたことを確認してください:" @@ -2681,8 +2724,8 @@ msgstr "Hatchの設定" #: ../../tutorials/get-to-know-hatch.md:103 msgid "" "Once you have installed Hatch, you can customize its configuration. This " -"includes setting the default name and setup for every package you create." -" While this step is not required, we suggest that you do it." +"includes setting the default name and setup for every package you create. " +"While this step is not required, we suggest that you do it." msgstr "" "Hatchをインストールしたら、その設定をカスタマイズすることができます。 " "これには、作成するすべてのパッケージにデフォルト名とセットアップを設定することも含まれます。 " @@ -2693,14 +2736,14 @@ msgid "" "Hatch stores your configuration in a [`config.toml` " "file](https://hatch.pypa.io/latest/config/project-templates/)." msgstr "" -"Hatchは設定を [`config.toml`ファイル](https://hatch.pypa.io/latest/config" -"/project-templates/) に保存します。" +"Hatchは設定を [`config.toml`ファイル](https://hatch.pypa.io/latest/config/project-" +"templates/) に保存します。" #: ../../tutorials/get-to-know-hatch.md:109 msgid "" "While you can update the `config.toml` file through the command line, it " -"might be easier to look at and update it in a text editor if you are " -"using it for the first time." +"might be easier to look at and update it in a text editor if you are using " +"it for the first time." msgstr "" "コマンドラインから `config.toml` ファイルを更新することができます, " "初めて使う場合は、テキストエディタで見て更新する方が簡単かもしれません。" @@ -2711,8 +2754,8 @@ msgstr "ステップ 1: `config.toml` ファイルを開いて編集する" #: ../../tutorials/get-to-know-hatch.md:115 msgid "" -"To open the config file in your file browser, run the following command " -"in your shell:" +"To open the config file in your file browser, run the following command in " +"your shell:" msgstr "ファイルブラウザで設定ファイルを開くには、シェルで以下のコマンドを実行します:" #: ../../tutorials/get-to-know-hatch.md:118 @@ -2721,14 +2764,14 @@ msgstr "`hatch config explore`" #: ../../tutorials/get-to-know-hatch.md:120 msgid "" -"This will open up a directory window that allows you to double-click on " -"the file and open it in your favorite text editor." +"This will open up a directory window that allows you to double-click on the" +" file and open it in your favorite text editor." msgstr "ディレクトリウィンドウが開き、ファイルをダブルクリックして好きなテキストエディタで開くことができます。" #: ../../tutorials/get-to-know-hatch.md:123 msgid "" -"You can also retrieve the location of the Hatch config file by running " -"the following command in your shell:" +"You can also retrieve the location of the Hatch config file by running the " +"following command in your shell:" msgstr "シェルで以下のコマンドを実行すれば、Hatchのコンフィグファイルの場所を取得することもできます:" #: ../../tutorials/get-to-know-hatch.md:131 @@ -2757,9 +2800,9 @@ msgstr "次に、 `[template.plugins.default]` テーブルでtestsをfalseに #: ../../tutorials/get-to-know-hatch.md:148 msgid "" "While tests are important, setting the tests configuration in Hatch to " -"`true` will create a more complex `pyproject.toml` file. You won't need " -"to use this feature in this beginner friendly tutorial series but we will" -" introduce it in later tutorials." +"`true` will create a more complex `pyproject.toml` file. You won't need to " +"use this feature in this beginner friendly tutorial series but we will " +"introduce it in later tutorials." msgstr "" "テストは重要ですが、Hatchのtests設定を `true` にすると、より複雑な `pyproject.toml` " "ファイルが作成されます。この初心者向けチュートリアルシリーズではこの機能を使う必要はありませんが、後のチュートリアルで紹介します。" @@ -2771,11 +2814,11 @@ msgstr "あなたの `config.toml` ファイルは以下のようになるはず #: ../../tutorials/get-to-know-hatch.md:191 #, fuzzy msgid "" -"Also notice that the default license option is MIT. While we will discuss" -" license in more detail in a later lesson, the MIT license is the " +"Also notice that the default license option is MIT. While we will discuss " +"license in more detail in a later lesson, the MIT license is the " "recommended permissive license from " -"[choosealicense.com](https://choosealicense.com/) and as such we will use" -" it for this tutorial series." +"[choosealicense.com](https://choosealicense.com/) and as such we will use " +"it for this tutorial series." msgstr "" "また、デフォルトのライセンスオプションがMITであることにも注目してください。 ライセンスについては後のレッスンで詳しく説明しますが、 " "MITライセンスは [choosealicense.com](https://www.choosealicense.com) " @@ -2787,8 +2830,8 @@ msgstr "もちろん、他のライセンスを選択することも歓迎しま #: ../../tutorials/get-to-know-hatch.md:200 msgid "" -"I think we'd need the SPDX license options here if they want to chose " -"bsd-3 for instance" +"I think we'd need the SPDX license options here if they want to chose bsd-3" +" for instance" msgstr "例えばbsd-3を選びたいのであれば、SPDXライセンスのオプションが必要だと思います。" #: ../../tutorials/get-to-know-hatch.md:203 @@ -2797,8 +2840,8 @@ msgstr "ステップ4: 設定ファイルを閉じて、 `hatch config show` を #: ../../tutorials/get-to-know-hatch.md:205 msgid "" -"Once you have completed the steps above run the following command in your" -" shell." +"Once you have completed the steps above run the following command in your " +"shell." msgstr "上記の手順が完了したら、シェルで以下のコマンドを実行します。" #: ../../tutorials/get-to-know-hatch.md:207 @@ -2807,9 +2850,9 @@ msgstr "`hatch config show`" #: ../../tutorials/get-to-know-hatch.md:209 msgid "" -"`hatch config show` will print out the contents of your `config.toml` " -"file in your shell. Look at the values and ensure that your name, email " -"is set. Also make sure that `tests=false`." +"`hatch config show` will print out the contents of your `config.toml` file " +"in your shell. Look at the values and ensure that your name, email is set. " +"Also make sure that `tests=false`." msgstr "" "`hatch config show` はシェルの `config.toml` ファイルの内容を出力します。 " "値を見て、あなたの名前とEメールが設定されていることを確認してください。また、 `tests=false` であることを確認すること。" @@ -2830,8 +2873,8 @@ msgstr "他のツールとの比較" #: ../../tutorials/get-to-know-hatch.md:220 msgid "" -"[We compared Hatch to several of the other popular packaging tools in the" -" ecosystem including flit, pdm and poetry. Learn more here](package-" +"[We compared Hatch to several of the other popular packaging tools in the " +"ecosystem including flit, pdm and poetry. Learn more here](package-" "features)" msgstr "" "[私たちはHatchを、flit、pdm、poetryなど、エコシステムで人気のある他のパッケージングツールと比較しました。 詳細はこちら" @@ -2851,9 +2894,9 @@ msgid "" "pyproject.toml file for you (see [Migrating setup.py to pyproject.toml " "using Hatch](setup-py-to-pyproject-toml.md ))" msgstr "" -"これは `setup.py` または `setup.cfg` ファイルに保存されたメタデータを pyproject.toml " -"ファイルに変換します。 ([Hatchを使用してsetup.pyをpyproject.tomlに移行する](setup-py-to-" -"pyproject-toml.md ) を参照)" +"これは `setup.py` または `setup.cfg` ファイルに保存されたメタデータを pyproject.toml ファイルに変換します。 " +"([Hatchを使用してsetup.pyをpyproject.tomlに移行する](setup-py-to-pyproject-toml.md ) " +"を参照)" #: ../../tutorials/get-to-know-hatch.md:229 msgid "" @@ -2881,7 +2924,7 @@ msgstr "Hatchを知る" #: ../../tutorials/intro.md:34 ../../tutorials/run-python-scripts-hatch.md:8 msgid "Run standalone Python scripts with Hatch" -msgstr "" +msgstr "HatchでスタンドアロンのPythonスクリプトを実行する" #: ../../tutorials/intro.md:34 msgid "Python Packaging Tutorial Setup" @@ -2907,6 +2950,8 @@ msgstr "conda-forgeに公開する" #: ../../tutorials/intro.md:42 msgid "Publish using GitHub Actions and Trusted Publishing" msgstr "" +"トークンを使用して GitHub Action から公開することも可能ですが、セキュリティと使いやすさに大きな利点があるため、_Trusted " +"Publishing_ アプローチをお勧めします。" #: ../../tutorials/intro.md:42 msgid "Create and publish a Python Package" @@ -2956,8 +3001,8 @@ msgstr "_初心者にやさしいチュートリアル_" #: ../../tutorials/intro.md:11 #, fuzzy, python-brace-format msgid "" -"Welcome to the pyOpenSci Python packaging tutorial series. The lessons on" -" the upcoming pages walk you through the core steps needed to create a " +"Welcome to the pyOpenSci Python packaging tutorial series. The lessons on " +"the upcoming pages walk you through the core steps needed to create a " "{term}`Python package`." msgstr "" "pyOpenSci Pythonパッケージングチュートリアルシリーズへようこそ。 " @@ -2965,10 +3010,10 @@ msgstr "" #: ../../tutorials/intro.md:17 msgid "" -"Diagram showing the lessons in our packaging tutorial. There are 6 total " -"- what is a Python package, make code pip installable, publish your " -"package to PyPI, add a README and LICENSE file, add metadata for PyPI and" -" finally publish to conda forge." +"Diagram showing the lessons in our packaging tutorial. There are 6 total - " +"what is a Python package, make code pip installable, publish your package " +"to PyPI, add a README and LICENSE file, add metadata for PyPI and finally " +"publish to conda forge." msgstr "" "パッケージングチュートリアルのレッスンを示す図。Pythonパッケージとは何か、コードをpipでインストール可能にする、パッケージをPyPIに公開する、READMEとLICENSEファイルを追加する、PyPI用のメタデータを追加する、最後にconda" " forgeに公開する、の6つです。" @@ -2985,10 +3030,10 @@ msgstr "このチュートリアルは誰のためのものですか？" #: ../../tutorials/intro.md:24 msgid "" -"The content in this tutorial series is beginner friendly and assumes that" -" you have not created a Python package before. However, the content will " -"still be valuable if you are interested in better understanding the steps" -" involved in creating a Python package." +"The content in this tutorial series is beginner friendly and assumes that " +"you have not created a Python package before. However, the content will " +"still be valuable if you are interested in better understanding the steps " +"involved in creating a Python package." msgstr "" "このチュートリアルシリーズの内容は初心者に優しく、Pythonパッケージを作成したことがないことを前提としています。 " "しかし、Pythonパッケージの作成に関わるステップをよりよく理解することに興味があるのであれば、このコンテンツはまだ価値があるでしょう。" @@ -3004,8 +3049,8 @@ msgstr "" #: ../../tutorials/intro.md:32 msgid "" -"In the second series, you will learn about infrastructure and " -"documentation needed to support package maintenance." +"In the second series, you will learn about infrastructure and documentation" +" needed to support package maintenance." msgstr "第2シリーズでは、パッケージのメンテナンスをサポートするために必要なインフラとドキュメントについて学びます。" #: ../../tutorials/intro.md:77 ../../tutorials/publish-conda-forge.md:22 @@ -3031,39 +3076,39 @@ msgstr "Pythonパッケージの5つのコアコンポーネントを列挙で #: ../../tutorials/intro.md:84 msgid "" -"Be able to explain the difference between generalizable code and code " -"that supports a specific scientific application" +"Be able to explain the difference between generalizable code and code that " +"supports a specific scientific application" msgstr "一般化可能なコードと特定の科学的アプリケーションをサポートするコードの違いを説明できます。" #: ../../tutorials/intro.md:91 msgid "" -"At a high level, you can think about a Python package as a toolbox that " -"you can use to perform various tasks." +"At a high level, you can think about a Python package as a toolbox that you" +" can use to perform various tasks." msgstr "高レベルでは、Pythonパッケージは、様々なタスクを実行するために使用できるツールボックスと考えることができます。" #: ../../tutorials/intro.md:94 #, fuzzy, python-brace-format msgid "" -"A Python package is basically a directory with a specific file structure." -" Within the package directory structure, there are {term}`Module` objects" -" which are files that end in `.py` (the same extension you'd see in a " -"Python script). These modules allow you to group and structure your " -"Python code. Each module contains functions and classes, that you can " -"think about as the tools in your toolbox." +"A Python package is basically a directory with a specific file structure. " +"Within the package directory structure, there are {term}`Module` objects " +"which are files that end in `.py` (the same extension you'd see in a Python" +" script). These modules allow you to group and structure your Python code. " +"Each module contains functions and classes, that you can think about as the" +" tools in your toolbox." msgstr "" "Pythonパッケージは基本的に特定のファイル構造を持つディレクトリです。 パッケージのディレクトリ構造の中に、`.py` " "で終わるファイル(Pythonスクリプトで見られるのと同じ拡張子)のモジュールがあります。これらのモジュールによって、Pythonコードをグループ化し、構造化することができます。各モジュールには関数とクラスが含まれており、それらはあなたの道具箱の中の道具だと考えることができます。" #: ../../tutorials/intro.md:103 msgid "" -"Diagram showing a sketch of a toolbox filled with different tools " -"including a hammer and a saw." +"Diagram showing a sketch of a toolbox filled with different tools including" +" a hammer and a saw." msgstr "ハンマーやノコギリなど、さまざまな工具が入った工具箱のスケッチを示す図。" #: ../../tutorials/intro.md:105 msgid "" -"You can think about a package as a toolbox filled with coding tools. A " -"tool may be a function or a class. Each tool does a specific thing well." +"You can think about a package as a toolbox filled with coding tools. A tool" +" may be a function or a class. Each tool does a specific thing well." msgstr "" "パッケージとは、コーディングツールが詰まった道具箱のようなものだと考えることができます。 ツールは関数かもしれないし、クラスかもしれません。 " "それぞれのツールは特定のことをよくします。" @@ -3076,8 +3121,8 @@ msgstr "Pythonパッケージはインストール可能" msgid "" "A package is installable, which means that you can add the functionality " "within the package's code to any Python environment and import that " -"functionality like you would import core scientific Python packages such " -"as NumPy or Matplotlib." +"functionality like you would import core scientific Python packages such as" +" NumPy or Matplotlib." msgstr "パッケージはインストール可能で、パッケージのコード内の機能をどのPython環境にも追加でき、NumPyやMatplotlibのような科学的なPythonのコアパッケージをインポートするように、その機能をインポートできます。" #: ../../tutorials/intro.md:121 @@ -3100,8 +3145,8 @@ msgstr "Pythonパッケージを作りたいから作るかもしれません:" msgid "" "**Use your code across different projects:** At its most basic level, " "creating a package allows you to install your code into a Python " -"environment. This allows you to then import functions and classes into " -"any workflows both locally and in the cloud." +"environment. This allows you to then import functions and classes into any " +"workflows both locally and in the cloud." msgstr "" "**異なるプロジェクト間でコードを使用する:** " "最も基本的なレベルでは、パッケージを作成することで、あなたのコードをPython環境にインストールすることができます。 " @@ -3110,22 +3155,22 @@ msgstr "" #: ../../tutorials/intro.md:131 #, fuzzy, python-brace-format msgid "" -"**Share your code:** If you publish a package on a public repository such" -" as PyPI or conda-forge, your package can be installed on any machine " -"using {term}`pip` or conda with a single command." +"**Share your code:** If you publish a package on a public repository such " +"as PyPI or conda-forge, your package can be installed on any machine using " +"{term}`pip` or conda with a single command." msgstr "" "**Share your code:** PyPIやcondaのような公開リポジトリでパッケージを公開する場合、 " "あなたのパッケージは、pipやcondaを使ってどのマシンにもコマンドひとつでインストールできます。" #: ../../tutorials/intro.md:134 msgid "" -"**Build community around your code:** Packages make it easier for " -"multiple people to work on the same project (particularly when published " -"on GitHub). A version control system such as git (the system used by " -"GitHub), further makes it easier to track changes to the codebase over " -"time. Tools such as issues and pull requests make it easier for outside " -"users to contribute bug fixes and to establish review processes for " -"accepting changes to the code base." +"**Build community around your code:** Packages make it easier for multiple " +"people to work on the same project (particularly when published on GitHub)." +" A version control system such as git (the system used by GitHub), further " +"makes it easier to track changes to the codebase over time. Tools such as " +"issues and pull requests make it easier for outside users to contribute bug" +" fixes and to establish review processes for accepting changes to the code " +"base." msgstr "" "**コードの周りにコミュニティを構築する:** パッケージは、 (特にGitHubで公開されている場合) " "複数の人が同じプロジェクトで作業することを容易にします。 git (GitHubで使われているシステム) " @@ -3139,8 +3184,8 @@ msgid "" "structure can help with both maintaining the codebase and with making it " "easier to understand." msgstr "" -"**コードを整理する:** パッケージは、大規模なコード・プロジェクトを整理し、より小さく管理しやすいコンポーネントに分割するために使用できます。" -" この構造は、コードベースを維持する上でも、理解しやすくする上でも役立ちます。" +"**コードを整理する:** パッケージは、大規模なコード・プロジェクトを整理し、より小さく管理しやすいコンポーネントに分割するために使用できます。 " +"この構造は、コードベースを維持する上でも、理解しやすくする上でも役立ちます。" #: ../../tutorials/intro.md:137 msgid "What to consider before you create a package" @@ -3166,9 +3211,9 @@ msgstr "ドキュメントやテストなどを追加する時間があるかど #: ../../tutorials/intro.md:145 msgid "" -"How long you might be able to maintain it: remember that once people " -"begin using your package they will depend on your maintainer team to " -"update it, fix bugs and answer questions." +"How long you might be able to maintain it: remember that once people begin " +"using your package they will depend on your maintainer team to update it, " +"fix bugs and answer questions." msgstr "" "メンテナンスできる可能性のある期間: " "いったん人々があなたのパッケージを使い始めると、彼らはそれを更新し、バグを修正し、質問に答えるために、あなたのメンテナチームに依存することになることを忘れないでください。" @@ -3190,9 +3235,9 @@ msgstr "図......これが残ればもっとここに。" #: ../../tutorials/intro.md:155 msgid "" "The elements of a Python package include code, documentation, tests, an " -"OSI-approved license and infrastructure. Maintainers are at the core " -"making sure everything works and is up to date while fixing bugs and " -"addressing user concerns." +"OSI-approved license and infrastructure. Maintainers are at the core making" +" sure everything works and is up to date while fixing bugs and addressing " +"user concerns." msgstr "" "Pythonパッケージの要素には、コード、ドキュメント、テスト、OSIが承認したライセンス、インフラが含まれます。 " "メインテナーは、バグを修正し、ユーザーの懸念に対処しながら、すべてが機能し、最新であることを確認する中核を担っています。" @@ -3209,8 +3254,8 @@ msgstr "**コード:** パッケージのユーザーに機能を提供する関 #: ../../tutorials/intro.md:164 msgid "" -"**Documentation:** Installation instructions, tutorials, and examples " -"that both help users get started using your package and contributors and " +"**Documentation:** Installation instructions, tutorials, and examples that " +"both help users get started using your package and contributors and " "maintainers fix bugs and maintain the package." msgstr "" "**ドキュメンテーション:** " @@ -3232,9 +3277,9 @@ msgstr "" #: ../../tutorials/intro.md:167 msgid "" -"**Tests:** that make sure your code works as it should and makes it " -"easier for you and others to contribute to, modify and update the code in" -" the future" +"**Tests:** that make sure your code works as it should and makes it easier " +"for you and others to contribute to, modify and update the code in the " +"future" msgstr "**テスト:** これは、あなたのコードが本来の機能を発揮し、あなたや他の人が貢献しやすくなるようにするものです、 将来的にコードを修正更新します" #: ../../tutorials/intro.md:168 @@ -3250,10 +3295,10 @@ msgstr "" #: ../../tutorials/intro.md:169 msgid "" -"**Infrastructure** that automates updates, publication workflows and runs" -" test suites. Infrastructure includes a suite of things such as platforms" -" like GitHub and GitLab, tools to run tests and tools locally such as nox" -" and tox and continuous integration that automates package maintenance " +"**Infrastructure** that automates updates, publication workflows and runs " +"test suites. Infrastructure includes a suite of things such as platforms " +"like GitHub and GitLab, tools to run tests and tools locally such as nox " +"and tox and continuous integration that automates package maintenance " "steps." msgstr "" "**インフラ** 更新、公開ワークフロー、テストスイートの実行を自動化します。 " @@ -3267,8 +3312,8 @@ msgstr "pyOpenSciがパッケージで探すもの" msgid "" "pyOpenSci performs an [initial set of editor " "checks](https://www.pyopensci.org/software-peer-review/how-to/editor-in-" -"chief-guide.html#editor-checklist-template) for any package submitted to " -"us for peer review. You may find these checks useful as you create your " +"chief-guide.html#editor-checklist-template) for any package submitted to us" +" for peer review. You may find these checks useful as you create your " "package as a baseline for things that you package should have." msgstr "" "pyOpenSciは、査読のために提出されたパッケージに対して、 [最初のエディタチェック](https://www.pyopensci.org" @@ -3282,9 +3327,9 @@ msgstr "パッケージは単なるコードではありません - インフラ #: ../../tutorials/intro.md:182 msgid "" "A package in any language is more than just code. If you expect other " -"people to use your package, besides yourself, you should consider not " -"only writing high quality code, but also the various elements of a " -"package that make it a useful community resource." +"people to use your package, besides yourself, you should consider not only " +"writing high quality code, but also the various elements of a package that " +"make it a useful community resource." msgstr "" "どの言語でも、パッケージは単なるコードではありません。 " "自分以外の人があなたのパッケージを使うことを期待するのであれば、高品質のコードを書くだけでなく、パッケージが有用なコミュニティリソースとなるための様々な要素も考慮すべきです。" @@ -3298,9 +3343,9 @@ msgid "" "Most Python packages live in an online version control platform such as " "GitHub or GitLab. GitHub and GitLab both run [git](https://git-scm.com/) " "for version control. Having your software under version control is " -"important because it allows you to both track changes over time while " -"also going back in history and undoing changes in the case that a change " -"to the code base unexpectedly breaks something." +"important because it allows you to both track changes over time while also " +"going back in history and undoing changes in the case that a change to the " +"code base unexpectedly breaks something." msgstr "" "ほとんどのPythonパッケージは、GitHubやGitLabのようなオンラインバージョン管理プラットフォームにあります。 " "GitHubとGitLabはどちらもバージョン管理のために [git](https://git-scm.com/) を実行しています。 " @@ -3309,9 +3354,9 @@ msgstr "" #: ../../tutorials/intro.md:194 msgid "" "By publishing your package on GitHub or GitLab, you are making your code " -"public facing. This means that others can both see your code and also " -"make contributions using a pull request (GitHub) / merge request (GitLab)" -" / code review workflow." +"public facing. This means that others can both see your code and also make " +"contributions using a pull request (GitHub) / merge request (GitLab) / code" +" review workflow." msgstr "" "あなたのパッケージをGitHubやGitLabで公開することで、あなたはコードを公開することになります。 " "これは、他の人があなたのコードを見ることができ、プルリクエスト(GitHub)/マージリクエスト(GitLab)/コードレビューワークフローを使って貢献することもできることを意味します。" @@ -3324,12 +3369,12 @@ msgstr "GitHub & GitLab vs. Git" msgid "" "GitHub and GitLab are online (cloud) platforms that run `git` (version " "control software) on the backend. Running git locally on your computer " -"allows you to upload (`git push`) and download (`git pull`) files to " -"GitHub and GitLab." +"allows you to upload (`git push`) and download (`git pull`) files to GitHub" +" and GitLab." msgstr "" -"GitHubとGitLabは、バックエンドで `git` (バージョン管理ソフトウェア) を実行するオンライン (クラウド) " -"プラットフォームです。 コンピュータ上でローカルに git を実行すると、GitHub や GitLab にファイルをアップロード (`git " -"push`) したりダウンロード (`git pull`) したりすることができます。" +"GitHubとGitLabは、バックエンドで `git` (バージョン管理ソフトウェア) を実行するオンライン (クラウド) プラットフォームです。 " +"コンピュータ上でローカルに git を実行すると、GitHub や GitLab にファイルをアップロード (`git push`) " +"したりダウンロード (`git pull`) したりすることができます。" #: ../../tutorials/intro.md:204 msgid "Issues or Ticket Trackers" @@ -3351,8 +3396,8 @@ msgstr "ユーザーによるバグ報告、質問、新機能のリクエスト #: ../../tutorials/intro.md:210 msgid "" -"you to publicly keep track of enhancements and features you want to work " -"on for your package." +"you to publicly keep track of enhancements and features you want to work on" +" for your package." msgstr "あなたのパッケージのために取り組みたい機能強化や機能を公的に追跡することができます。" #: ../../tutorials/intro.md:212 @@ -3362,13 +3407,13 @@ msgstr "継続的インテグレーションと継続的デプロイメント" #: ../../tutorials/intro.md:214 msgid "" "GitHub and GitLab also provide continuous integration and continuous " -"deployment (CI/CD). Continuous integration (CI) refers to a platform that" -" automatically runs a specific job when a certain event occurs, whereas " +"deployment (CI/CD). Continuous integration (CI) refers to a platform that " +"automatically runs a specific job when a certain event occurs, whereas " "continuous deployment (CD) is an extension of CI that refers to not only " "running or building but also to publishing the final outputs somewhere." msgstr "" -"GitHubとGitLabは、継続的インテグレーションと継続的デプロイメント (CI/CD) も提供しています。継続的インテグレーション (CI)" -" とは、特定のイベントが発生したときに特定のジョブを自動的に実行するプラットフォームのことを指し、継続的デプロイメント " +"GitHubとGitLabは、継続的インテグレーションと継続的デプロイメント (CI/CD) も提供しています。継続的インテグレーション (CI) " +"とは、特定のイベントが発生したときに特定のジョブを自動的に実行するプラットフォームのことを指し、継続的デプロイメント " "(CD)とは、実行や構築だけでなく、最終的なアウトプットをどこかに公開することを指すCIの拡張です。" #: ../../tutorials/intro.md:216 @@ -3378,8 +3423,7 @@ msgstr "**継続的インテグレーションの例:**" #: ../../tutorials/intro.md:218 msgid "" "When someone submits a change to your code, your tests will run across " -"different operating systems and the code will be checked for format " -"issues." +"different operating systems and the code will be checked for format issues." msgstr "誰かがあなたのコードに変更を加えた場合、あなたのテストは異なるオペレーティングシステム上で実行され、コードはフォーマットの問題がないかチェックされます。" #: ../../tutorials/intro.md:220 @@ -3388,17 +3432,16 @@ msgstr "**継続的デプロイの例:**" #: ../../tutorials/intro.md:222 msgid "" -"When you are ready to release your package to PyPI, a continuous " -"deployment operation might be triggered on release to publish your " -"package to PyPI." +"When you are ready to release your package to PyPI, a continuous deployment" +" operation might be triggered on release to publish your package to PyPI." msgstr "PyPIにパッケージをリリースする準備ができたら、リリース時に継続的デプロイ操作をトリガーしてパッケージをPyPIに公開することがあります。" #: ../../tutorials/intro.md:224 msgid "" "Integrated CI/CD will help you maintain your software, ensuring that " -"changes to the code don't break things unexpectedly. They can also help " -"you maintain code style and format consistency for every new change to " -"your code." +"changes to the code don't break things unexpectedly. They can also help you" +" maintain code style and format consistency for every new change to your " +"code." msgstr "" "統合されたCI/CDは、コードの変更が予期せぬ事態を引き起こさないよう、ソフトウェアの保守を支援します。 " "また、コードに新しい変更が加えられるたびに、コードのスタイルや書式の一貫性を維持するのにも役立ちます。" @@ -3415,9 +3458,7 @@ msgstr "あなたのコードをPythonパッケージにするタイミングは msgid "" "You may be wondering, what types of code should become a Python package " "that is both on GitHub and published to PyPI and/or conda-forge." -msgstr "" -"どのようなコードをPythonのパッケージにして、GitHubに置き、PyPIやconda-" -"forgeに公開すればいいのか、疑問に思うかもしれません。" +msgstr "どのようなコードをPythonのパッケージにして、GitHubに置き、PyPIやconda-forgeに公開すればいいのか、疑問に思うかもしれません。" #: ../../tutorials/intro.md:240 msgid "There are a few use cases to consider:" @@ -3426,11 +3467,11 @@ msgstr "考慮すべき使用例がいくつかあります:" #: ../../tutorials/intro.md:242 msgid "" "**Creating a basic package for yourself:** Sometimes you want create a " -"package for your own personal use. This might mean making your code " -"locally pip installable and you may also want to publish it to GitHub. In" -" that case you don't expect others to use your code, and as such you may " -"only have documentation for you and your future self if you need to " -"update the package." +"package for your own personal use. This might mean making your code locally" +" pip installable and you may also want to publish it to GitHub. In that " +"case you don't expect others to use your code, and as such you may only " +"have documentation for you and your future self if you need to update the " +"package." msgstr "" "**自分用の基本パッケージを作ります:** 個人的に使用するためにパッケージを作成したいこともあるでしょう。 " "これは、コードをローカルにpipでインストールできるようにすることを意味するかもしれませんし、GitHubに公開したいと思うかもしれません。その場合、他の人があなたのコードを使うことを期待していないので、パッケージを更新する必要がある場合に、あなた自身と将来の自分のためのドキュメントしか用意できないかもしれません。" @@ -3438,8 +3479,8 @@ msgstr "" #: ../../tutorials/intro.md:244 msgid "" "An example of this type of package might be a set of functions that you " -"write that are useful across several of your projects. It could be useful" -" to have those functions available to all of your projects." +"write that are useful across several of your projects. It could be useful " +"to have those functions available to all of your projects." msgstr "" "この種のパッケージの例としては、いくつかのプロジェクトにまたがって有用な関数のセットを書くことができます。 " "これらの機能をすべてのプロジェクトで利用できれば便利でしょう。" @@ -3451,14 +3492,14 @@ msgstr "レッスンが公開されたら、pipでインストールできるよ #: ../../tutorials/intro.md:250 msgid "" "**Creating a package for the community:** In other cases, you may create " -"some code that you soon realize might also be useful to not just you, but" -" to other people as well. In that case, you might consider both creating " -"the package, publishing it on GitHub, and because other users may be " -"using it, you may make use of GitHub's infrastructure including CI/CD " -"pipelines and issue trackers. Because you want other people to use your " -"package, you will want to also include LICENSE information, documentation" -" for users and contributors and tests. This type of package is most often" -" published to PyPI." +"some code that you soon realize might also be useful to not just you, but " +"to other people as well. In that case, you might consider both creating the" +" package, publishing it on GitHub, and because other users may be using it," +" you may make use of GitHub's infrastructure including CI/CD pipelines and " +"issue trackers. Because you want other people to use your package, you will" +" want to also include LICENSE information, documentation for users and " +"contributors and tests. This type of package is most often published to " +"PyPI." msgstr "" "**コミュニティ向けパッケージの作成:** また、自分だけでなく他の人にとっても有用なコードを作成することもあるでしょう。 " "その場合は、パッケージを作成してGitHubで公開し、他のユーザーもそれを使うかもしれないので、CI/CDパイプラインや課題トラッカーなどのGitHubのインフラを利用することも検討できるでしょう。あなたのパッケージを他の人たちにも使ってもらいたいので、LICENSE情報、ユーザーや貢献者のための文書、テストも含めておきたいです。" @@ -3467,11 +3508,11 @@ msgstr "" #: ../../tutorials/intro.md:253 msgid "" "For example, all of the [pyOpenSci packages](https://www.pyopensci.org" -"/python-packages.html) are public facing with an intended audience beyond" -" just the maintainers." +"/python-packages.html) are public facing with an intended audience beyond " +"just the maintainers." msgstr "" -"例えば、すべての [pyOpenSciパッケージ](https://www.pyopensci.org/python-packages.html)" -" は、メンテナ以外の読者を想定して公開されています。" +"例えば、すべての [pyOpenSciパッケージ](https://www.pyopensci.org/python-packages.html) " +"は、メンテナ以外の読者を想定して公開されています。" #: ../../tutorials/intro.md:255 msgid "Packages that you expect others to use should be well-scoped" @@ -3479,8 +3520,8 @@ msgstr "他の人が使用することを想定しているパッケージは、 #: ../../tutorials/intro.md:257 msgid "" -"Ideally the code in your Python package is focused on a specific theme or" -" use case. This theme is important as it's a way to scope the content of " +"Ideally the code in your Python package is focused on a specific theme or " +"use case. This theme is important as it's a way to scope the content of " "your package." msgstr "" "Pythonパッケージのコードは、特定のテーマやユースケースにフォーカスしているのが理想的です。 " @@ -3488,11 +3529,10 @@ msgstr "" #: ../../tutorials/intro.md:259 msgid "" -"It can be tricky to decide when your code becomes something that might be" -" more broadly useful to others. But one question you can ask yourself is " -"- is your code written specifically for a single research project? Or " -"could it have a broader application across multiple projects in your " -"domain?" +"It can be tricky to decide when your code becomes something that might be " +"more broadly useful to others. But one question you can ask yourself is - " +"is your code written specifically for a single research project? Or could " +"it have a broader application across multiple projects in your domain?" msgstr "" "自分のコードが、いつ他の人に広く役立つものになるかを決めるのは、難しいことです。 " "しかし、自分自身に問いかけることができる質問が一つあります。それは、あなたのコードは特定の研究プロジェクトのために書かれたものですか？あるいは、あなたのドメインにおける複数のプロジェクトにまたがるより広範な応用が可能でしょうか？" @@ -3506,8 +3546,8 @@ msgstr "研究プロジェクトのコードとの関連は？" msgid "" "A [Research Compendium](https://book.the-turing-way.org/reproducible-" "research/compendia.html) is an organized set of code, data and " -"documentation that supports a specific research project. It aims to " -"enhance the reproducibility and transparency of research by providing a " +"documentation that supports a specific research project. It aims to enhance" +" the reproducibility and transparency of research by providing a " "comprehensive record of the methods, data, and analyses used in a study." msgstr "" "[Research Compendium](https://the-turing-way.netlify.app/reproducible-" @@ -3516,14 +3556,14 @@ msgstr "" #: ../../tutorials/intro.md:269 msgid "" -"A Python package is a collection of modules that can be used to perform a" -" specific set of tasks. These tasks should be applicable to numerous " -"workflows. As such a Python package is more generalizable than a Research" -" Compendium which supports a specific project." +"A Python package is a collection of modules that can be used to perform a " +"specific set of tasks. These tasks should be applicable to numerous " +"workflows. As such a Python package is more generalizable than a Research " +"Compendium which supports a specific project." msgstr "" "Pythonパッケージは、特定のタスクを実行するために使用できるモジュールのコレクションです。 " -"これらのタスクは、数多くのワークフローに適用できるはずです。 そのため、Pythonパッケージは、特定のプロジェクトをサポートするResearch" -" Compendiumよりも汎用性が高いです。" +"これらのタスクは、数多くのワークフローに適用できるはずです。 そのため、Pythonパッケージは、特定のプロジェクトをサポートするResearch " +"Compendiumよりも汎用性が高いです。" #: ../../tutorials/intro.md:274 msgid "" @@ -3535,13 +3575,13 @@ msgstr "" #: ../../tutorials/intro.md:275 msgid "" -"[Learn more about research compendia (also called repo-packs) in this " -"blog post.](https://lorenabarba.com/blog/how-repro-packs-can-save-your-" -"future-self/)" +"[Learn more about research compendia (also called repo-packs) in this blog " +"post.](https://lorenabarba.com/blog/how-repro-packs-can-save-your-future-" +"self/)" msgstr "" "[リサーチコンペンディア (レポパックとも呼ばれる) " -"については、こちらのブログ記事で詳しくご紹介しています。](https://lorenabarba.com/blog/how-repro-" -"packs-can-save-your-future-self/)" +"については、こちらのブログ記事で詳しくご紹介しています。](https://lorenabarba.com/blog/how-repro-packs-" +"can-save-your-future-self/)" #: ../../tutorials/intro.md:278 msgid "Below are a few examples well scoped pyOpenSci packages:" @@ -3551,18 +3591,18 @@ msgstr "以下はよくスコープされたpyOpenSciパッケージの例です msgid "" "[Crowsetta](https://crowsetta.readthedocs.io/en/latest/): is a package " "designed to work with annotating animal vocalizations and bioacoustics " -"data. This package helps scientists process different types of " -"bioacoustic data rather than focusing on a specific individual research " -"application associated with a user-specific research workflow." +"data. This package helps scientists process different types of bioacoustic " +"data rather than focusing on a specific individual research application " +"associated with a user-specific research workflow." msgstr "" "[Crowsetta](https://crowsetta.readthedocs.io/en/latest/): " "は、動物の発声や生物音響データの注釈付けを行うために設計されたパッケージです。このパッケージは、ユーザー固有の研究ワークフローに関連する特定の個々の研究アプリケーションに焦点を当てるのではなく、科学者がさまざまなタイプの生体音響データを処理するのを支援します。" #: ../../tutorials/intro.md:281 msgid "" -"[Pandera](https://www.union.ai/pandera) is another more broadly used " -"Python package. Pandera supports data testing and thus also has a broader" -" research application." +"[Pandera](https://www.union.ai/pandera) is another more broadly used Python" +" package. Pandera supports data testing and thus also has a broader " +"research application." msgstr "" "[Pandera](https://www.union.ai/pandera) もまた、より広く使われているPythonパッケージです。 " "Panderaはデータの検査をサポートしているため、広範な研究用途にも使用できます。" @@ -3584,9 +3624,9 @@ msgstr "_データの視覚的なプロットを作成します。_" #: ../../tutorials/intro.md:290 msgid "" "Thousands of people use Matplotlib for different plotting applications " -"using different types of data. While few scientific packages will have " -"the same broad application and large user base that Matplotlib has, the " -"idea of scoping out what your package does is still important." +"using different types of data. While few scientific packages will have the " +"same broad application and large user base that Matplotlib has, the idea of" +" scoping out what your package does is still important." msgstr "" "Matplotlibは、何千人もの人々が、様々な種類のデータを使った様々なプロットアプリケーションに利用しています。 " "Matplotlibのような広範なアプリケーションと大規模なユーザーベースを持つ科学パッケージはほとんどないでしょうが、自分のパッケージが何をするのかを調べるという考え方は依然として重要です。" @@ -3612,24 +3652,22 @@ msgstr "" #: ../../tutorials/intro.md:304 msgid "" -"**Readable code:** readable code is code written with a consistent style." -" You can use linters and code formatters such as black and flake8 to " -"ensure this consistency throughout your entire package. [Learn more about" -" code formatters here.](../package-structure-code/code-style-linting-" -"format)" +"**Readable code:** readable code is code written with a consistent style. " +"You can use linters and code formatters such as black and flake8 to ensure " +"this consistency throughout your entire package. [Learn more about code " +"formatters here.](../package-structure-code/code-style-linting-format)" msgstr "" "**読みやすいコード:** " "読みやすいコードとは、一貫したスタイルで書かれたコードのことです。blackやflake8などのリンターやコードフォーマッターを使用することで、パッケージ全体の一貫性を確保することができます。" -" [コードフォーマッタの詳細はこちらです。](../package-structure-code/code-style-linting-" -"format)" +" [コードフォーマッタの詳細はこちらです。](../package-structure-code/code-style-linting-format)" #: ../../tutorials/intro.md:308 msgid "" -"**Documented code:** documented code is written using docstrings that " -"help a user understand both what the functions and methods in your code " -"do and also what the input and output elements of each function are. [You" -" can learn more about docstrings in our guide, here.](../documentation" -"/write-user-documentation/document-your-code-api-docstrings)" +"**Documented code:** documented code is written using docstrings that help " +"a user understand both what the functions and methods in your code do and " +"also what the input and output elements of each function are. [You can " +"learn more about docstrings in our guide, here.](../documentation/write-" +"user-documentation/document-your-code-api-docstrings)" msgstr "" "**文書化されたコード:** " "ドキュメント化されたコードは、ユーザーがコード内の関数やメソッドが何をするのか、また各関数の入出力要素が何なのかを理解するのに役立つdocstringを使って記述されます。" @@ -3646,8 +3684,8 @@ msgstr "Pythonのパッケージと環境" #: ../../tutorials/intro.md:316 msgid "" -"You can install a Python package into a Python environment in the same " -"way you might install NumPy or Pandas. Installing your package into an " +"You can install a Python package into a Python environment in the same way " +"you might install NumPy or Pandas. Installing your package into an " "environment allows you to access it from any code run with that specific " "Python environment activated." msgstr "" @@ -3658,10 +3696,10 @@ msgstr "" msgid "" "Diagram showing the steps associated with creating a package and then " "installing it. The first arrow says your package and the second says pip " -"install package. The second arrow leads to a box that represents a Python" -" environment that already has some packages installed such as Pandas and " -"NumPy. Your package will also get installed into that same environment " -"when you pip install it." +"install package. The second arrow leads to a box that represents a Python " +"environment that already has some packages installed such as Pandas and " +"NumPy. Your package will also get installed into that same environment when" +" you pip install it." msgstr "" "パッケージを作成し、それをインストールする手順を示す図です。 最初の矢印はあなたのパッケージ、2番目はpip install " "packageと書かれています。2つ目の矢印は、PandasやNumPyなどのいくつかのパッケージがすでにインストールされているPython環境を表すボックスにつながります。あなたのパッケージも、pip" @@ -3669,11 +3707,11 @@ msgstr "" #: ../../tutorials/intro.md:324 msgid "" -"You don't have to publish to PyPI to make your code installable. With the" -" correct file structure and project metadata you can make your code " -"installable locally on your computer and use it for projects that you are" -" working on without having to ever publish to PyPI. Publishing to PyPI is" -" useful when you want to make your code public-facing and share it with " +"You don't have to publish to PyPI to make your code installable. With the " +"correct file structure and project metadata you can make your code " +"installable locally on your computer and use it for projects that you are " +"working on without having to ever publish to PyPI. Publishing to PyPI is " +"useful when you want to make your code public-facing and share it with " "others." msgstr "" "あなたのコードをインストール可能にするためにPyPIに公開する必要はありません。 " @@ -3687,8 +3725,8 @@ msgstr "PyPI / Conda-Forgeへのパッケージの公開" #: ../../tutorials/intro.md:333 msgid "" "If you want to make your package directly installable without having to " -"download the code to your computer locally then you need to publish it in" -" a repository such as **PyPI** or **conda-forge**." +"download the code to your computer locally then you need to publish it in a" +" repository such as **PyPI** or **conda-forge**." msgstr "" "コードをローカルにダウンロードすることなく、パッケージを直接インストールできるようにしたい場合は、 **PyPI** や **conda-" "forge** のようなリポジトリで公開する必要があります。" @@ -3702,8 +3740,8 @@ msgstr "[このチュートリアルでは、パッケージをPyPIに公開す #: ../../tutorials/intro.md:339 msgid "" "Then you can create a conda-forge recipe using the " -"[Grayskull](https://github.com/conda/grayskull) tool. You can then submit" -" this recipe to conda-forge." +"[Grayskull](https://github.com/conda/grayskull) tool. You can then submit " +"this recipe to conda-forge." msgstr "" "その後、 [Grayskull](https://github.com/conda/grayskull) ツールを使ってconda-" "forgeレシピを作成することができます。 このレシピをconda-forgeに投稿することができます。" @@ -3717,27 +3755,27 @@ msgstr "[conda-forgeの公開プロセスについてはこちらをご覧くだ #: ../../tutorials/intro.md:344 msgid "" "Graphic showing the high level packaging workflow. On the left you see a " -"graphic with code, metadata and tests in it. Those items all go into your" -" package. Documentation and data are below that box because they aren't " +"graphic with code, metadata and tests in it. Those items all go into your " +"package. Documentation and data are below that box because they aren't " "normally published in your packaging wheel distribution. An arrow to the " "right takes you to a build distribution files box. That box leads you to " "either publishing to TestPyPI or the real PyPI. From PyPI you can then " -"connect to conda-forge for an automated build that sends distributions " -"from PyPI to conda-forge." +"connect to conda-forge for an automated build that sends distributions from" +" PyPI to conda-forge." msgstr "" "ハイレベルなパッケージングのワークフローを示すグラフィックです。左側には、コード、メタデータ、テストが入ったグラフィックがあります。ドキュメンテーションやデータは、通常、パッケージホイールの配布物には掲載されないため、そのボックスの下にあります。右の矢印は、ビルド配布ファイルのボックスに移動します。このボックスは、TestPyPIか本物のPyPIのどちらかに公開するように導きます" "。PyPIからconda-forgeに接続し、ディストリビューションをPyPIからconda-forgeに送る自動ビルドを行うことができます。" #: ../../tutorials/intro.md:346 msgid "" -"In the image above, you can see the steps associated with publishing your" -" package on PyPI and conda-forge. PyPI supports [sdist](#python-source-" -"distribution) and [wheel](#python-wheel) files. Once you are ready to " -"make your code publicly installable, you can publish it on PyPI. Once " -"your code is on PyPI it is straight forward to then publish to conda-" -"forge. You create a recipe using the Grayskull package and then you open " -"a pr in the conda-forge recipe repository. You will learn more about this" -" process in the [conda-forge lesson](/tutorials/publish-conda-forge)." +"In the image above, you can see the steps associated with publishing your " +"package on PyPI and conda-forge. PyPI supports [sdist](#python-source-" +"distribution) and [wheel](#python-wheel) files. Once you are ready to make " +"your code publicly installable, you can publish it on PyPI. Once your code " +"is on PyPI it is straight forward to then publish to conda-forge. You " +"create a recipe using the Grayskull package and then you open a pr in the " +"conda-forge recipe repository. You will learn more about this process in " +"the [conda-forge lesson](/tutorials/publish-conda-forge)." msgstr "" "上の画像では、PyPIとconda-forgeでパッケージを公開する手順を見ることができます。 PyPIが要求する配布ファイルは [sdist" "](#python-source-distribution) と [wheel](#python-wheel) " @@ -3755,9 +3793,8 @@ msgid "" "As the community using your package grows, you may also find yourself " "managing users, contributors, and others who want to interact with your " "package. It’s important to consider all this before you dive into " -"development. Once you have a user base in the community, people will " -"depend upon your code to work and will need direction regarding how to " -"use it." +"development. Once you have a user base in the community, people will depend" +" upon your code to work and will need direction regarding how to use it." msgstr "" "あなたのパッケージを使うコミュニティが大きくなるにつれて、あなたはユーザーや貢献者、その他あなたのパッケージと交流したい人たちを管理することになるかもしれません。開発に飛び込む前に、これらすべてを考慮することが重要です。" " コミュニティーの中にユーザーベースができれば、人々はあなたのコードに依存するようになり、その使い方の指示を必要とするようになります。" @@ -3771,25 +3808,25 @@ msgid "" "[a development guide that documents your maintainer workflow process " "](/documentation/repository-files/development-guide.md)" msgstr "" -"[メンテナーのワークフロープロセスを文書化した開発ガイド](/documentation/repository-files" -"/development-guide.md)" +"[メンテナーのワークフロープロセスを文書化した開発ガイド](/documentation/repository-files/development-" +"guide.md)" #: ../../tutorials/intro.md:357 msgid "" "[a code of conduct to defines community interaction standards and " "expectations](/documentation/repository-files/code-of-conduct-file.md)" msgstr "" -"[コミュニティとの交流の基準と期待を定める行動規範](/documentation/repository-files/code-of-" -"conduct-file.md)" +"[コミュニティとの交流の基準と期待を定める行動規範](/documentation/repository-files/code-of-conduct-" +"file.md)" #: ../../tutorials/intro.md:358 msgid "" -"[a contributing guide that helps users understand expectations associated" -" with making contributions to your project](/documentation/repository-" -"files/contributing-file.md)" +"[a contributing guide that helps users understand expectations associated " +"with making contributions to your project](/documentation/repository-files" +"/contributing-file.md)" msgstr "" -"[プロジェクトに貢献する際にユーザーが期待されることを理解するのに役立つ貢献ガイド](/documentation/repository-" -"files/contributing-file.md)" +"[プロジェクトに貢献する際にユーザーが期待されることを理解するのに役立つ貢献ガイド](/documentation/repository-files" +"/contributing-file.md)" #: ../../tutorials/intro.md:360 msgid "Support for contributors and maintainers" @@ -3797,23 +3834,23 @@ msgstr "コントリビューターとメンテナーのサポート" #: ../../tutorials/intro.md:362 msgid "" -"If you intend for others to use and contribute to your code, consider who" -" will maintain it over time. You will want a **contributing and " +"If you intend for others to use and contribute to your code, consider who " +"will maintain it over time. You will want a **contributing and " "development** guide to help new potential contributors get started with " "contributing to your package, as well as a **code of conduct** to ensure " "community interactions remain healthy both for you and your contributors " "and maintainer team." msgstr "" "他の人があなたのコードを使用し、貢献することを意図しているのであれば、誰がそれを長期にわたって保守するかを検討しましょう。あなたは、新しい貢献者候補があなたのパッケージへの貢献を始められるようにするための" -" **貢献と開発** ガイドと、コミュニティの交流があなたにとっても貢献者やメンテナチームにとっても健全であり続けるようにするための " -"**行動規範** が欲しいでしょう。" +" **貢献と開発** ガイドと、コミュニティの交流があなたにとっても貢献者やメンテナチームにとっても健全であり続けるようにするための **行動規範**" +" が欲しいでしょう。" #: ../../tutorials/intro.md:364 msgid "" "The elements above are also important for future maintenance of your " "package. In the case that you are no long able to maintain it or simply " -"want extra help, development, and contributing documentation will help " -"you onboard new maintainers." +"want extra help, development, and contributing documentation will help you " +"onboard new maintainers." msgstr "" "上記の要素は、今後のパッケージのメンテナンスにおいても重要です。 " "メンテナンスができなくなった場合、あるいは単に追加的な助けが欲しい場合、開発、そしてドキュメントの貢献は、新しいメンテナへの参加を支援します。" @@ -3825,19 +3862,19 @@ msgstr "次のレッスン" #: ../../tutorials/intro.md:371 msgid "" "In future lessons you will learn more about the infrastructure around a " -"published Python package that makes it both easier to maintain, easier " -"for others to contribute to and easier for other scientists to use. " -"However, first we want to get you to your initial goal of publishing a " -"Python package." +"published Python package that makes it both easier to maintain, easier for " +"others to contribute to and easier for other scientists to use. However, " +"first we want to get you to your initial goal of publishing a Python " +"package." msgstr "今後のレッスンでは、公開された、メンテナンスが容易になり、他の人が貢献しやすくなり、他の科学者が使いやすくなるPythonパッケージのインフラについて学びます。しかし、まずはPythonパッケージを公開するという最初のゴールに到達してもらいたいと思います。" #: ../../tutorials/intro.md:373 msgid "" -"In this next lesson you will learn how to create a basic installable " -"Python package. Make your code pip installable " +"In this next lesson you will learn how to create a basic installable Python" +" package. Make your code pip installable " msgstr "" -"この次のレッスンでは、インストール可能な Python パッケージの基本的な作り方を学びます。コードをpipインストール可能にします " -"" +"この次のレッスンでは、インストール可能な Python パッケージの基本的な作り方を学びます。コードをpipインストール可能にします " #: ../../tutorials/publish-conda-forge.md:6 msgid "Publish your Python package that is on PyPI to conda-forge" @@ -3899,23 +3936,23 @@ msgstr "Grayskullを使用してパッケージのconda-forge yamlレシピを #: ../../tutorials/publish-conda-forge.md:29 msgid "" -"Submit the recipe (yaml file) to the conda-forge staged recipes " -"repository as a pull request" +"Submit the recipe (yaml file) to the conda-forge staged recipes repository " +"as a pull request" msgstr "レシピ(yamlファイル)をconda-forge staged recipesリポジトリにプルリクエストとして提出します。" #: ../../tutorials/publish-conda-forge.md:30 msgid "" -"Maintain your conda-forge package by creating new releases for your " -"package on PyPI" +"Maintain your conda-forge package by creating new releases for your package" +" on PyPI" msgstr "PyPIでパッケージの新しいリリースを作成することで、conda-forgeパッケージを維持します。" #: ../../tutorials/publish-conda-forge.md:33 #, fuzzy, python-brace-format msgid "" -"Once your package is on PyPI you can then easily publish it to conda-" -"forge using the [grayskull](https://conda.github.io/grayskull/) tool. You" -" do not need to build the package specifically for conda, conda-forge " -"will build from your PyPI {term}`Source distribution (sdist)` file." +"Once your package is on PyPI you can then easily publish it to conda-forge " +"using the [grayskull](https://conda.github.io/grayskull/) tool. You do not " +"need to build the package specifically for conda, conda-forge will build " +"from your PyPI {term}`Source distribution (sdist)` file." msgstr "" "パッケージがPyPIに登録されたら、 [grayskull](https://conda.github.io/grayskull/) " "ツールを使って簡単にconda-forgeに公開することができます。conda専用のパッケージをビルドする必要はない、conda-" @@ -3923,12 +3960,12 @@ msgstr "" #: ../../tutorials/publish-conda-forge.md:41 msgid "" -"Image showing the progression of creating a Python package, building it " -"and then publishing to PyPI and conda-forge. You take your code and turn " -"it into distribution files (sdist and wheel) that PyPI accepts. Then " -"there is an arrow towards the PyPI repository where ou publish both " -"distributions. From PyPI if you create a conda-forge recipe you can then " -"publish to conda-forge." +"Image showing the progression of creating a Python package, building it and" +" then publishing to PyPI and conda-forge. You take your code and turn it " +"into distribution files (sdist and wheel) that PyPI accepts. Then there is " +"an arrow towards the PyPI repository where ou publish both distributions. " +"From PyPI if you create a conda-forge recipe you can then publish to conda-" +"forge." msgstr "" "Pythonパッケージの作成、ビルド、そしてPyPIとconda-" "forgeへの公開の流れを示す画像です。あなたのコードをPyPIが受け付ける配布ファイル(sdistとwheel)に変換します。そして、両方のディストリビューションを公開しているPyPIリポジトリへの矢印があります" @@ -3938,10 +3975,10 @@ msgstr "" #, fuzzy, python-brace-format msgid "" "Once you have published both package distributions (the {term}`Source " -"distribution (sdist)` and the {term}`Wheel (.whl)`) to PyPI, you can then" -" publish to conda-forge. Conda-forge requires a source distribution on " -"PyPI in order to build your package on conda-forge. You do not need to " -"rebuild your package to publish to conda-forge." +"distribution (sdist)` and the {term}`Wheel (.whl)`) to PyPI, you can then " +"publish to conda-forge. Conda-forge requires a source distribution on PyPI " +"in order to build your package on conda-forge. You do not need to rebuild " +"your package to publish to conda-forge." msgstr "" "両方のパッケージ配布(ソース配布とホイール)をPyPIに公開したら、次にconda-forgeに公開します。conda-" "forgeでパッケージをビルドするには、PyPIでのソース配布が必要です。conda-" @@ -3953,8 +3990,8 @@ msgstr "conda-forgeとは何ですか？" #: ../../tutorials/publish-conda-forge.md:52 msgid "" -"conda is an open source package and environment management tool that can " -"be used to install tools from the different channels on Anaconda.org." +"conda is an open source package and environment management tool that can be" +" used to install tools from the different channels on Anaconda.org." msgstr "" "conda はオープンソースのパッケージと環境管理ツールで、Anaconda.org " "のさまざまなチャンネルからツールをインストールするために使用できます。" @@ -3963,14 +4000,13 @@ msgstr "" msgid "" "You can think about a channel as a specific location where a group of " "packages are stored and can be installed from using a command such as " -"`conda install packagename`. In the case of conda channels, some of these" -" channels such as the `defaults` channel, is managed by Anaconda (the " +"`conda install packagename`. In the case of conda channels, some of these " +"channels such as the `defaults` channel, is managed by Anaconda (the " "company). Only Anaconda can decide what packages are available in the " "`defaults` channel. However, the conda-forge (and bioconda) channel are " -"community-managed channels. Anyone can submit a package to these channels" -" however they must pass a technical review in the [staged-recipes GitHub " -"repository](https://github.com/conda-forge/staged-recipes) to be " -"published." +"community-managed channels. Anyone can submit a package to these channels " +"however they must pass a technical review in the [staged-recipes GitHub " +"repository](https://github.com/conda-forge/staged-recipes) to be published." msgstr "" "チャンネルとは、パッケージ群が保存され、 `conda install packagename` " "のようなコマンドでインストールできる特定の場所と考えることができます。 conda チャンネルの場合、`defaults` " @@ -3986,14 +4022,14 @@ msgstr "[condaチャンネルについて詳しくはこちら。](#about-conda) #: ../../tutorials/publish-conda-forge.md:62 msgid "" -"Graphic with the title Python package repositories. Below it says " -"anything hosted on PyPI can be installed using pip install. Packaging " -"hosted on a conda channel can be installed using conda install. Below " -"that there are two rows. The top row says conda channels. Next to it are " -"three boxes one with conda-forge, community maintained; bioconda and then" -" default - managed by the Anaconda team. Below that there is a row that " -"says PyPI servers. PyPI - anyone can publish to PyPI and test PyPI (a " -"testbed server for you to practice)." +"Graphic with the title Python package repositories. Below it says anything " +"hosted on PyPI can be installed using pip install. Packaging hosted on a " +"conda channel can be installed using conda install. Below that there are " +"two rows. The top row says conda channels. Next to it are three boxes one " +"with conda-forge, community maintained; bioconda and then default - managed" +" by the Anaconda team. Below that there is a row that says PyPI servers. " +"PyPI - anyone can publish to PyPI and test PyPI (a testbed server for you " +"to practice)." msgstr "" "Python package repositoriesというタイトルのグラフィック。 PyPI でホストされているものは pip install " "でインストールできます。 condaチャンネルでホストされているパッケージはconda installを使ってインストールできます。 " @@ -4004,11 +4040,11 @@ msgstr "" #: ../../tutorials/publish-conda-forge.md:64 msgid "" -"Conda channels represent various repositories that you can install " -"packages from. Because conda-forge is community maintained, anyone can " -"submit a recipe there. PyPI is also a community maintained repository. " -"Anyone can submit a package to PyPI and test PyPI. Unlike conda-forge " -"there are no manual checks of packages submitted to PyPI." +"Conda channels represent various repositories that you can install packages" +" from. Because conda-forge is community maintained, anyone can submit a " +"recipe there. PyPI is also a community maintained repository. Anyone can " +"submit a package to PyPI and test PyPI. Unlike conda-forge there are no " +"manual checks of packages submitted to PyPI." msgstr "" "Condaチャンネルは、パッケージをインストールできる様々なリポジトリです。 conda-forge " "はコミュニティによって管理されているため、誰でもレシピを投稿することができます。 PyPIもコミュニティによって管理されているリポジトリです。 " @@ -4022,11 +4058,11 @@ msgstr "conda-forgeに公開する理由" #: ../../tutorials/publish-conda-forge.md:69 msgid "" "There are many users, especially in the scientific Python ecosystem that " -"use conda as their primary package manager / environment tool. Thus, " -"having packages available to these users on the conda-forge channel is " -"useful. In some cases packages on conda-forge can minimize dependency " -"conflicts that can occur when mixing installations using pip and conda. " -"This is particularly important for the spatial ecosystem." +"use conda as their primary package manager / environment tool. Thus, having" +" packages available to these users on the conda-forge channel is useful. In" +" some cases packages on conda-forge can minimize dependency conflicts that " +"can occur when mixing installations using pip and conda. This is " +"particularly important for the spatial ecosystem." msgstr "" "特に科学的なPythonのエコシステムでは、condaを主要なパッケージマネージャ / 環境ツールとして使っているユーザーがたくさんいます。 " "したがって、conda-forgeチャンネルでこれらのユーザーがパッケージを利用できるようにすることは有用です。 場合によっては、conda-" @@ -4038,18 +4074,18 @@ msgstr "conda-forgeへの公開の仕組み" #: ../../tutorials/publish-conda-forge.md:73 msgid "" -"Once you have built and published your package to PyPI, you have " -"everything that you need to publish to conda-forge. There is no " -"additional build step needed to publish to conda-forge." +"Once you have built and published your package to PyPI, you have everything" +" that you need to publish to conda-forge. There is no additional build step" +" needed to publish to conda-forge." msgstr "" "パッケージをビルドしてPyPIに公開したら、conda-forgeに公開するために必要なものはすべて揃っています。 conda-" "forgeに公開するための追加のビルドステップは必要ありません。" #: ../../tutorials/publish-conda-forge.md:75 msgid "" -"Conda-forge will build your package from the source distribution which " -"you [published to PyPI in the previous lesson](publish-pypi) using the " -"recipe that you will create below." +"Conda-forge will build your package from the source distribution which you " +"[published to PyPI in the previous lesson](publish-pypi) using the recipe " +"that you will create below." msgstr "" "Conda-forgeは、 [前のレッスンでPyPIに公開した](publish-pypi) " "ソースディストリビューションから、以下で作成するレシピを使ってパッケージをビルドします。" @@ -4066,11 +4102,11 @@ msgstr "conda-forgeへの公開に関連する手順を示す画像です。 詳 #: ../../tutorials/publish-conda-forge.md:82 msgid "" -"The steps for publishing to conda-forge begin with publishing your Python" -" package to PyPI. Once you have published to PyPI you can then create a " -"yaml file recipe that can be submitted to the conda-forge staged recipes " -"repository for review. Once that recipe is accepted, your package will " -"get it's on repository (known as a feedstock) on conda-forge." +"The steps for publishing to conda-forge begin with publishing your Python " +"package to PyPI. Once you have published to PyPI you can then create a yaml" +" file recipe that can be submitted to the conda-forge staged recipes " +"repository for review. Once that recipe is accepted, your package will get " +"it's on repository (known as a feedstock) on conda-forge." msgstr "" "conda-forgeに公開する手順は、PythonパッケージをPyPIに公開することから始まります。 " "PyPIに公開したら、yamlファイルのレシピを作成し、conda-forge staged " @@ -4087,38 +4123,36 @@ msgstr "Pythonパッケージの配布ファイル (sdistとwheel) をPyPIに公 #: ../../tutorials/publish-conda-forge.md:88 msgid "" -"Create a conda-forge recipe, which is a yaml file with instructions on " -"how to build your package on conda-forge, using the grayskull[^grayskull]" -" package." +"Create a conda-forge recipe, which is a yaml file with instructions on how " +"to build your package on conda-forge, using the grayskull[^grayskull] " +"package." msgstr "" "これは、 grayskull[^grayskull] パッケージを使用して、conda-" "forge上でパッケージをビルドする方法を説明したyamlファイルです。" #: ../../tutorials/publish-conda-forge.md:89 msgid "" -"Submit the recipe (yaml file) to the conda-forge staged recipes " -"repository as a pull request for review. [Click here for an example " -"submission from pyOpenSci.](https://github.com/conda-forge/staged-" -"recipes/pull/25173)" +"Submit the recipe (yaml file) to the conda-forge staged recipes repository " +"as a pull request for review. [Click here for an example submission from " +"pyOpenSci.](https://github.com/conda-forge/staged-recipes/pull/25173)" msgstr "" -"レシピ (yamlファイル) をconda-forge staged " -"recipesリポジトリにプルリクエストとして提出し、レビューを受けてください。 " -"[pyOpenSciからの投稿例はこちらをクリックしてください](https://github.com/conda-forge/staged-" +"レシピ (yamlファイル) をconda-forge staged recipesリポジトリにプルリクエストとして提出し、レビューを受けてください。" +" [pyOpenSciからの投稿例はこちらをクリックしてください](https://github.com/conda-forge/staged-" "recipes/pull/25173)" #: ../../tutorials/publish-conda-forge.md:91 msgid "" -"Once someone from the conda-forge team reviews your pull request, you may" -" need to make some changes. Eventually the pull request will be approved " -"and merged." +"Once someone from the conda-forge team reviews your pull request, you may " +"need to make some changes. Eventually the pull request will be approved and" +" merged." msgstr "" "conda-" "forgeチームの誰かがあなたのプルリクエストをレビューしたら、いくつかの変更が必要になるかもしれません。最終的にプルリクエストは承認され、マージされます。" #: ../../tutorials/publish-conda-forge.md:93 msgid "" -"Once your recipe is accepted and merged on conda-forge, users can install" -" your package using:" +"Once your recipe is accepted and merged on conda-forge, users can install " +"your package using:" msgstr "あなたのレシピがconda-forgeで承認され、マージされると、ユーザーはあなたのパッケージをインストールできます:" #: ../../tutorials/publish-conda-forge.md:95 @@ -4139,8 +4173,8 @@ msgstr "conda-forge パッケージのメンテナンス" msgid "" "Once your package is on conda-forge, the repository will track release " "activity on the package's PyPI repository. Any time you make a new PyPI " -"release with a new source distribution, conda-forge will build and update" -" your conda-forge repository (also known as a feedstock)." +"release with a new source distribution, conda-forge will build and update " +"your conda-forge repository (also known as a feedstock)." msgstr "" "あなたのパッケージがconda-forgeに登録されると、リポジトリはそのパッケージのPyPIリポジトリのリリースアクティビティを追跡します。 " "新しいソースディストリビューションで新しい PyPI リリースを作成すると、conda-forge はあなたの conda-forge " @@ -4160,15 +4194,15 @@ msgstr "そのプルリクエストをレビューし、継続的インテグレ #: ../../tutorials/publish-conda-forge.md:107 msgid "" -" How to Publish your package" -" on conda-forge" +" How to Publish your package " +"on conda-forge" msgstr " conda-forgeでパッケージを公開する方法" #: ../../tutorials/publish-conda-forge.md:109 msgid "" "It's time to add your package to the conda-forge channel. Remember that " -"your package needs to be on PyPI before the steps below will work. And " -"also remember that the team managing conda-forge are all volunteers." +"your package needs to be on PyPI before the steps below will work. And also" +" remember that the team managing conda-forge are all volunteers." msgstr "" "あなたのパッケージをconda-forgeチャンネルに追加しましょう。 " "以下の手順が動作する前に、あなたのパッケージがPyPI上にある必要があることを覚えておいてください。また、conda-" @@ -4182,15 +4216,15 @@ msgstr "conda-forgeに公開する前に、あなたのパッケージが（test #: ../../tutorials/publish-conda-forge.md:115 msgid "" -"Only submit your package to conda-forge if you intend to maintain it over" -" time." +"Only submit your package to conda-forge if you intend to maintain it over " +"time." msgstr "パッケージをconda-forgeに投稿するのは、長期的にメンテナンスするつもりである場合だけにしてください。" #: ../../tutorials/publish-conda-forge.md:118 msgid "" "Note - this is a tutorial aimed to help you get your package onto conda-" -"forge. The official conda documentation for this processed [is " -"here](https://conda-forge.org/docs/maintainer/adding_pkgs.html)." +"forge. The official conda documentation for this processed [is here](https" +"://conda-forge.org/docs/maintainer/adding_pkgs.html)." msgstr "" "ノート - このチュートリアルは、あなたのパッケージをconda-" "forgeに載せる手助けをすることを目的としています。この処理に関するcondaの公式ドキュメントは [こちら](https://conda-" @@ -4207,8 +4241,8 @@ msgid "" "install it using either pip:" msgstr "" "まず、 " -"[grayskullをインストールします](https://conda.github.io/grayskull/user_guide.html) " -"。 pip を使用してインストールできます:" +"[grayskullをインストールします](https://conda.github.io/grayskull/user_guide.html) 。 " +"pip を使用してインストールできます:" #: ../../tutorials/publish-conda-forge.md:128 msgid "or conda" @@ -4216,8 +4250,8 @@ msgstr "それともconda" #: ../../tutorials/publish-conda-forge.md:134 msgid "" -"To run this command, use the same shell / terminal that you have been " -"using to run hatch commands in the previous tutorials." +"To run this command, use the same shell / terminal that you have been using" +" to run hatch commands in the previous tutorials." msgstr "このコマンドを実行するには、前のチュートリアルでhatchコマンドを実行するのに使ったのと同じシェル/ターミナルを使います。" #: ../../tutorials/publish-conda-forge.md:139 @@ -4281,8 +4315,8 @@ msgstr "次に、レシピディレクトリに移動します。" #: ../../tutorials/publish-conda-forge.md:173 msgid "" -"If you run `ls` here, you will notice there is an example directory with " -"an example recipe for you to look at." +"If you run `ls` here, you will notice there is an example directory with an" +" example recipe for you to look at." msgstr "ここで `ls` を実行すると、レシピ例のあるexampleディレクトリがあることに気づくでしょう。" #: ../../tutorials/publish-conda-forge.md:185 @@ -4291,8 +4325,8 @@ msgstr "次に、 `grayskull pypi your-package-name` を実行してレシピを #: ../../tutorials/publish-conda-forge.md:229 msgid "" -"Grayskull will pull metadata about your package from PyPI. It does not " -"use your local installation of the package." +"Grayskull will pull metadata about your package from PyPI. It does not use " +"your local installation of the package." msgstr "Grayskull はあなたのパッケージのメタデータを PyPI から取得します。ローカルにインストールしたパッケージは使用しません。" #: ../../tutorials/publish-conda-forge.md:230 @@ -4319,8 +4353,8 @@ msgstr "`recipes/packagename/meta.yaml`" #: ../../tutorials/publish-conda-forge.md:239 msgid "" -"At the very bottom of the grayskull output, it will also tell you where " -"it saved the recipe file." +"At the very bottom of the grayskull output, it will also tell you where it " +"saved the recipe file." msgstr "grayskull 出力の一番下にある、レシピファイルの保存場所も教えてくれます。" #: ../../tutorials/publish-conda-forge.md:242 @@ -4335,11 +4369,11 @@ msgstr "ステップ 3b: バグフィクス - about:セクションにホームU #: ../../tutorials/publish-conda-forge.md:291 msgid "" -"There is currently a small bug in Grayskull where it doesn't populate the" -" home: element of the recipe. If you don't include this, [you will " -"receive an error message](https://github.com/conda-forge/staged-" -"recipes/pull/25173#issuecomment-1917916528) from the friendly conda-forge" -" linter bot." +"There is currently a small bug in Grayskull where it doesn't populate the " +"home: element of the recipe. If you don't include this, [you will receive " +"an error message](https://github.com/conda-forge/staged-" +"recipes/pull/25173#issuecomment-1917916528) from the friendly conda-forge " +"linter bot." msgstr "" "現在Grayskullには、レシピの home: 要素が入力されないという小さなバグがあります。これを入れないと、フレンドリーな conda-" "forge linter bot から [エラーメッセージが表示されます](https://github.com/conda-forge" @@ -4372,16 +4406,16 @@ msgstr "ステップ 4: conda-forgeのテスト" #: ../../tutorials/publish-conda-forge.md:331 msgid "" "Next, have a look at the tests section in your **meta.yaml** file. At a " -"minimum you should import your package or the main modules associated " -"with your package and run `pip check`." +"minimum you should import your package or the main modules associated with " +"your package and run `pip check`." msgstr "" "次に、 **meta.yaml** ファイルのtestsセクションを見てください。 " "最低限、自分のパッケージか、そのパッケージに関連する主要なモジュールをインポートして `pip check` を実行する必要があります。" #: ../../tutorials/publish-conda-forge.md:333 msgid "" -"`pip check` will ensure that your package installs properly with all of " -"the proper dependencies." +"`pip check` will ensure that your package installs properly with all of the" +" proper dependencies." msgstr "`pip check` は、あなたのパッケージが適切な依存関係をすべて持って正しくインストールされることを保証します。" #: ../../tutorials/publish-conda-forge.md:345 @@ -4396,8 +4430,8 @@ msgstr "ステップ 4: staged-recipesリポジトリにプルリクエストを #: ../../tutorials/publish-conda-forge.md:349 msgid "" -"Once you have completed all of the above, you are ready to open up a pull" -" request in the `conda-forge/staged-recipes repository`." +"Once you have completed all of the above, you are ready to open up a pull " +"request in the `conda-forge/staged-recipes repository`." msgstr "上記がすべて完了したら、 `conda-forge/staged-recipes repository` でプルリクエストを開く準備ができました。" #: ../../tutorials/publish-conda-forge.md:351 @@ -4438,8 +4472,8 @@ msgstr "プルリクエストテンプレートのチェックリストのヒン #: ../../tutorials/publish-conda-forge.md:367 msgid "" -"-[x] Title of this PR is meaningful: e.g. \"Adding my_nifty_package\", " -"not \"updated meta.yaml\"." +"-[x] Title of this PR is meaningful: e.g. \"Adding my_nifty_package\", not " +"\"updated meta.yaml\"." msgstr "" "-[x] このPRのタイトルは意味があります: 例 \"updated meta.yaml\" ではなく \"Adding " "my_nifty_package\" 。" @@ -4459,19 +4493,18 @@ msgid "" "recipes/blob/5eddbd7fc9d1502169089da06c3688d9759be978/recipes/example/meta.yaml#L64-L73)" " for an example)." msgstr "" -"-[x] ライセンスファイルは例としてパッケージされています([ここ](https://github.com/conda-forge" -"/staged-" +"-[x] ライセンスファイルは例としてパッケージされています([ここ](https://github.com/conda-forge/staged-" "recipes/blob/5eddbd7fc9d1502169089da06c3688d9759be978/recipes/example/meta.yaml#L64-L73" " を参照)) 。" #: ../../tutorials/publish-conda-forge.md:374 msgid "" -"**Translation:** You should have a LICENSE file included in your " -"package's source distribution. If you have followed the pyOpenSci " -"tutorials then you already have a LICENSE file and are likely using the " -"MIT license. When you run `hatch build`, it will bundle that file into " -"the output [source distribution file (which is the tar.gz file)](python-" -"source-distribution) that conda-forge will use to build your package." +"**Translation:** You should have a LICENSE file included in your package's " +"source distribution. If you have followed the pyOpenSci tutorials then you " +"already have a LICENSE file and are likely using the MIT license. When you " +"run `hatch build`, it will bundle that file into the output [source " +"distribution file (which is the tar.gz file)](python-source-distribution) " +"that conda-forge will use to build your package." msgstr "" "**翻訳:** パッケージのソース配布物にLICENSEファイルを含める必要があります。 " "pyOpenSciチュートリアルに従ったのであれば、すでにLICENSEファイルがあり、MITライセンスを使っていると思われます。 `hatch " @@ -4484,10 +4517,10 @@ msgstr "[x] ソースは公式ソースより。" #: ../../tutorials/publish-conda-forge.md:378 msgid "" -"**Translation:** If your package is on PyPI as you learned in the " -"[previous lesson on publishing your Python package](publish-pypi) then " -"you are in good shape. conda-forge prefers that your distribution is " -"published to a known repository." +"**Translation:** If your package is on PyPI as you learned in the [previous" +" lesson on publishing your Python package](publish-pypi) then you are in " +"good shape. conda-forge prefers that your distribution is published to a " +"known repository." msgstr "" "**翻訳:** [Pythonパッケージの公開に関する前回のレッスン](publish-pypi) " "で学んだように、あなたのパッケージがPyPI上にあるのであれば、問題はありません。 conda-" @@ -4495,9 +4528,9 @@ msgstr "" #: ../../tutorials/publish-conda-forge.md:380 msgid "" -"-[x] Package does not vendor other packages. (If a package uses the " -"source of another package, they should be separate packages or the " -"licenses of all packages need to be packaged)." +"-[x] Package does not vendor other packages. (If a package uses the source " +"of another package, they should be separate packages or the licenses of all" +" packages need to be packaged)." msgstr "" "-[x] パッケージは他のパッケージをベンダリングしません。 " "(あるパッケージが他のパッケージのソースを使用している場合、これらは別々のパッケージにするか、すべてのパッケージのライセンスをパッケージ化する必要があります)。" @@ -4505,18 +4538,18 @@ msgstr "" #: ../../tutorials/publish-conda-forge.md:382 msgid "" "**Translation:** If the code base in your package is your own and it all " -"shares the same LICENSE then you are in good shape. If you have code " -"taken from other packages then you may need to declare that and include " -"licenses for that code if it is different. If you followed these " -"tutorials then you do not have any vendored code." +"shares the same LICENSE then you are in good shape. If you have code taken " +"from other packages then you may need to declare that and include licenses " +"for that code if it is different. If you followed these tutorials then you " +"do not have any vendored code." msgstr "" "**翻訳:** " "あなたのパッケージのコードベースがあなた自身のものであり、それがすべて同じライセンスを共有しているのであれば、問題はありません。他のパッケージから取得したコードがある場合は、そのコードを宣言し、異なる場合はそのライセンスも含める必要があるかもしれません。これらのチュートリアルに従ったのであれば、あなたはベンダーのコードを持っていません。" #: ../../tutorials/publish-conda-forge.md:384 msgid "" -"-[x] If static libraries are linked in, the license of the static library" -" is packaged." +"-[x] If static libraries are linked in, the license of the static library " +"is packaged." msgstr "-[x] スタティックライブラリーがリンクされている場合、スタティックライブラリーのライセンスがパッケージされます。" #: ../../tutorials/publish-conda-forge.md:386 @@ -4530,26 +4563,26 @@ msgstr "" #: ../../tutorials/publish-conda-forge.md:388 msgid "" -"**Translation:** A static library refers to a copy of a package built " -"into your package. If your package is a pure Python package, then you can" -" check that your package does not ship static libraries as this does not " -"apply to you." +"**Translation:** A static library refers to a copy of a package built into " +"your package. If your package is a pure Python package, then you can check " +"that your package does not ship static libraries as this does not apply to " +"you." msgstr "" "**翻訳:** " "スタティックライブラリーは、パッケージに組み込まれたパッケージのコピーを指します。もしあなたのパッケージが純粋なPythonパッケージであれば、スタティックライブラリが同梱されていないことを確認してください。" #: ../../tutorials/publish-conda-forge.md:390 msgid "" -"The pyOpenSci tutorials are all pure Python and as such do not use static" -" libraries in a linked or shipped (included in the package distribution) " +"The pyOpenSci tutorials are all pure Python and as such do not use static " +"libraries in a linked or shipped (included in the package distribution) " "format." msgstr "pyOpenSciチュートリアルはすべて純粋なPythonであり、リンクされた、あるいは出荷された(パッケージ配布に含まれる)形式の静的ライブラリは使用しません。" #: ../../tutorials/publish-conda-forge.md:392 msgid "" -"If your package has a more complex build that includes links to " -"extensions written in other languages such as C++, then be sure to " -"include the proper licenses for those extensions in your metadata." +"If your package has a more complex build that includes links to extensions " +"written in other languages such as C++, then be sure to include the proper " +"licenses for those extensions in your metadata." msgstr "あなたのパッケージが、C++のような他の言語で書かれた拡張機能へのリンクを含む、より複雑なビルドを持つ場合は、メタデータにそれらの拡張機能の適切なライセンスを含めるようにしてください。" #: ../../tutorials/publish-conda-forge.md:397 @@ -4569,17 +4602,17 @@ msgstr "-[ ] ビルド番号は0。" #: ../../tutorials/publish-conda-forge.md:402 msgid "" -"**Translation:** The build number in your recipe is right below the " -"source location of your package's source distribution. `number: 0` is " -"what you should see in that section of your recipe." +"**Translation:** The build number in your recipe is right below the source " +"location of your package's source distribution. `number: 0` is what you " +"should see in that section of your recipe." msgstr "" "**翻訳:** レシピのビルド番号は、パッケージのソース配布場所のすぐ下にあります。 `number: 0` " "は、レシピのそのセクションに表示されるべきものです。" #: ../../tutorials/publish-conda-forge.md:415 msgid "" -"[x] A tarball (`url`) rather than a repo (e.g. `git_url`) is used in your" -" recipe (see [here](https://conda-" +"[x] A tarball (`url`) rather than a repo (e.g. `git_url`) is used in your " +"recipe (see [here](https://conda-" "forge.org/docs/maintainer/adding_pkgs.html) for more details)." msgstr "" "[x] レシピでは、リポジトリ (例 `git_url` ) ではなく、tarball (`url`) を使用します。 (詳細は " @@ -4589,9 +4622,9 @@ msgstr "" msgid "" "**Translation:** Here conda wants you to provide a link to the source " "distribution on PyPI rather than a link to your GitHub repository " -"distribution. Notice above in the Source section of your recipe there is " -"a `url:` section that provides a PyPI url that ends in tar.gz. That is a " -"link to your source distribution that conda-forge will use." +"distribution. Notice above in the Source section of your recipe there is a " +"`url:` section that provides a PyPI url that ends in tar.gz. That is a link" +" to your source distribution that conda-forge will use." msgstr "" "**翻訳:** " "ここでcondaは、あなたのGitHubリポジトリ配布へのリンクではなく、PyPI上のソース配布へのリンクを提供することを望んでいます。レシピのSourceセクションに" @@ -4616,9 +4649,9 @@ msgstr "" #: ../../tutorials/publish-conda-forge.md:427 msgid "" -"[x] When in trouble, please check our [knowledge base " -"documentation](https://conda-" -"forge.org/docs/maintainer/knowledge_base.html) before pinging a team." +"[x] When in trouble, please check our [knowledge base documentation](https" +"://conda-forge.org/docs/maintainer/knowledge_base.html) before pinging a " +"team." msgstr "" "[x] 問題が発生した場合は、チームに問い合わせる前に [ナレッジベースのドキュメント](https://conda-" "forge.org/docs/maintainer/knowledge_base.html) を確認してください。" @@ -4634,8 +4667,8 @@ msgstr "" #: ../../tutorials/publish-conda-forge.md:431 msgid "" -"This is also why we don't suggest you publish to conda-forge as a " -"practice run." +"This is also why we don't suggest you publish to conda-forge as a practice " +"run." msgstr "これが、練習としてconda-forgeに公開することをお勧めしない理由でもあります。" #: ../../tutorials/publish-conda-forge.md:435 @@ -4655,8 +4688,8 @@ msgstr "プルリクエストを作成した後、GitHubのインターフェイ #: ../../tutorials/publish-conda-forge.md:441 msgid "" -"Wait until all of the CI steps in your pull request have run. At that " -"point your pull request is ready for review by a conda-forge maintainer." +"Wait until all of the CI steps in your pull request have run. At that point" +" your pull request is ready for review by a conda-forge maintainer." msgstr "" "プルリクエストのCIステップがすべて実行されるまで待ちます。 この時点で、あなたのプルリクエストはconda-" "forgeのメンテナによるレビューの準備が整いました。" @@ -4667,8 +4700,8 @@ msgid "" "take a bit of work. If you are struggling to get your recipe to build " "properly, you can ping the conda-forge maintainer team for help." msgstr "" -"場合によっては、CIですべてのチェックを成功させるには、少し手間がかかるかもしれません。 レシピがうまくビルドできない場合は、conda-" -"forge メンテナチームに助けを求めてください。" +"場合によっては、CIですべてのチェックを成功させるには、少し手間がかかるかもしれません。 レシピがうまくビルドできない場合は、conda-forge " +"メンテナチームに助けを求めてください。" #: ../../tutorials/publish-conda-forge.md:446 msgid "Please be patient and wait for them to respond." @@ -4680,30 +4713,29 @@ msgstr "conda-forgeのステージレシピとCIの失敗" #: ../../tutorials/publish-conda-forge.md:451 msgid "" -"If your package is a pure Python package that can be installed on any " -"type of computer (Windows, mac, linux) and has no architecture " -"requirements (known as noarch: Python or no architecture requirements) " -"then the conda-forge team only requires tests for Linux CI to pass." +"If your package is a pure Python package that can be installed on any type " +"of computer (Windows, mac, linux) and has no architecture requirements " +"(known as noarch: Python or no architecture requirements) then the conda-" +"forge team only requires tests for Linux CI to pass." msgstr "" "もしあなたのパッケージが純粋なPythonパッケージで、どのタイプのコンピュータ (Windows、mac、linux) " -"にもインストールでき、アーキテクチャの要求がない場合 (noarch: " -"Pythonまたはアーキテクチャの要求がないパッケージとして知られています) 、conda-forgeチームはLinux " -"CI用のテストのみがパスすることを要求します。" +"にもインストールでき、アーキテクチャの要求がない場合 (noarch: Pythonまたはアーキテクチャの要求がないパッケージとして知られています) " +"、conda-forgeチームはLinux CI用のテストのみがパスすることを要求します。" #: ../../tutorials/publish-conda-forge.md:453 msgid "" "So if tests for Windows and MAC OS fail, that is to be expected. In this " -"case, don't worry about failing tests, the maintainer team can help you " -"get your package published." +"case, don't worry about failing tests, the maintainer team can help you get" +" your package published." msgstr "" "そのため、WindowsとMAC OSのテストが失敗したとしても、それは予想されることです。 " "この場合、テストの失敗を心配する必要はありません。メンテナチームが、あなたのパッケージが公開されるよう手助けしてくれます。" #: ../../tutorials/publish-conda-forge.md:456 msgid "" -"Once you have submitted your recipe, you can wait for the CI build to " -"pass. If it's not passing, and you aren't sure why, a conda-forge " -"maintainer can likely help you figure things out." +"Once you have submitted your recipe, you can wait for the CI build to pass." +" If it's not passing, and you aren't sure why, a conda-forge maintainer can" +" likely help you figure things out." msgstr "" "レシピを提出したら、CIビルドが通過するのを待つことができます。 もしそれが通らず、その理由がわからない場合は、conda-" "forgeのメンテナーが解決してくれるでしょう。" @@ -4729,8 +4761,8 @@ msgstr "" #: ../../tutorials/publish-conda-forge.md:462 msgid "" -"The last part of this process is maintaining the repository. We cover " -"that next." +"The last part of this process is maintaining the repository. We cover that " +"next." msgstr "このプロセスの最後の部分は、リポジトリの管理です。次はそれを取り上げます。" #: ../../tutorials/publish-conda-forge.md:465 @@ -4740,8 +4772,8 @@ msgstr "conda-forgeフィードストックのメンテナンス" #: ../../tutorials/publish-conda-forge.md:467 msgid "" "Every time you create a new release on PyPI, the conda-forge bots will " -"recognize the release and will rebuild the newly released version of your" -" package. This process may take a day or two to complete so be patient." +"recognize the release and will rebuild the newly released version of your " +"package. This process may take a day or two to complete so be patient." msgstr "" "PyPIで新しいリリースを作成するたびに、conda-" "forgeボットはそのリリースを認識し、新しくリリースされたバージョンのパッケージをリビルドします。このプロセスには1-2日かかることがありますので、気長にお待ちください。" @@ -4749,8 +4781,8 @@ msgstr "" #: ../../tutorials/publish-conda-forge.md:469 msgid "" "Once the conda-forge build is complete, all of the maintainers of your " -"conda-forge feedstock will get a ping on GitHub that a new pull request " -"has been opened." +"conda-forge feedstock will get a ping on GitHub that a new pull request has" +" been opened." msgstr "" "conda-forgeのビルドが完了すると、 conda-forge feedstock " "の全メンテナにGitHubで新しいプルリクエストが開かれたことが通知されます。" @@ -4798,9 +4830,9 @@ msgstr "パッケージをconda-forgeに公開する方法を知ります" #: ../../tutorials/publish-conda-forge.md:485 msgid "" -"The above are the basic steps that you need to take to create and publish" -" a Python package. In a future tutorial series we will cover that basics " -"of maintaining your package." +"The above are the basic steps that you need to take to create and publish a" +" Python package. In a future tutorial series we will cover that basics of " +"maintaining your package." msgstr "" "以上が、Pythonパッケージを作成して公開するために必要な基本的な手順です。 " "今後のチュートリアルシリーズでは、パッケージのメンテナンスの基本について取り上げます。" @@ -4821,8 +4853,8 @@ msgstr "PythonパッケージをPyPIに公開する" #, fuzzy msgid "Make sure they add /dist to their .gitignore file. Where does that fit?" msgstr "" -".gitignoreファイルに/distが追加されていることを確認してください。GitHubのワークフローについては、まだどこにも触れていません。" -" それはどこに当てはまりますか？" +".gitignoreファイルに/distが追加されていることを確認してください。GitHubのワークフローについては、まだどこにも触れていません。 " +"それはどこに当てはまりますか？" #: ../../tutorials/publish-pypi.md:15 msgid "In the previous Python packaging lessons, you've learned:" @@ -4839,9 +4871,11 @@ msgstr "コードをインストール可能にします。" #: ../../tutorials/publish-pypi.md:26 #, python-brace-format msgid "" -"Build your package's {term}`Source distribution (sdist)` and {term}`Wheel" -" (.whl)` {term}`Distribution files`" +"Build your package's {term}`Source distribution (sdist)` and {term}`Wheel " +"(.whl)` {term}`Distribution files`" msgstr "" +"パッケージの {term}`Source distribution (sdist)` と {term}`Wheel (.whl)` " +"{term}`Distribution files` をビルドします" #: ../../tutorials/publish-pypi.md:28 msgid "Setup an account on TestPyPI (the process is similar for PyPI)" @@ -4854,35 +4888,34 @@ msgstr "パッケージをTestPyPIとPyPIに公開する" #: ../../tutorials/publish-pypi.md:31 #, fuzzy msgid "" -"You will do all of your development work in this lesson using [Hatch" -"](get-to-know-hatch)." +"You will do all of your development work in this lesson using [Hatch](get-" +"to-know-hatch)." msgstr "このレッスンでは、すべての開発作業を [Hatch](https://hatch.pypa.io/latest/) を使って行います。" #: ../../tutorials/publish-pypi.md:34 msgid "" -"Once your package is on PyPI you can publish it to conda-forge (which is " -"a channel on conda) using " -"[Grayskull](https://conda.github.io/grayskull/)." +"Once your package is on PyPI you can publish it to conda-forge (which is a " +"channel on conda) using [Grayskull](https://conda.github.io/grayskull/)." msgstr "" -"パッケージがPyPIに載ったら、 [Grayskull](https://conda.github.io/grayskull/) " -"を使ってconda-forge (condaのチャンネルです) に公開できます。" +"パッケージがPyPIに載ったら、 [Grayskull](https://conda.github.io/grayskull/) を使ってconda-" +"forge (condaのチャンネルです) に公開できます。" #: ../../tutorials/publish-pypi.md:37 msgid "" -"You will learn how to publish to conda-forge in the [next lesson" -"](publish-conda-forge)." +"You will learn how to publish to conda-forge in the [next lesson](publish-" +"conda-forge)." msgstr "conda-forgeに公開する方法は [次のレッスン](publish-conda-forge) で学びます。" #: ../../tutorials/publish-pypi.md:41 msgid "" "Graphic showing the high level packaging workflow. On the left you see a " -"graphic with code, metadata and tests in it. Those items all go into your" -" package. An arrow to the right takes you to a build distribution files " -"box. Another arrow to the right takes you to a publish to PyPI box which " -"has an arrow containing sdist and wheel that notes those files go to PyPI" -" for hosting. From PyPI is an arrow containing sdist since you can then " -"connect to conda-forge for an automated build that sends distributions " -"from PyPI to conda-forge." +"graphic with code, metadata and tests in it. Those items all go into your " +"package. An arrow to the right takes you to a build distribution files box." +" Another arrow to the right takes you to a publish to PyPI box which has an" +" arrow containing sdist and wheel that notes those files go to PyPI for " +"hosting. From PyPI is an arrow containing sdist since you can then connect " +"to conda-forge for an automated build that sends distributions from PyPI to" +" conda-forge." msgstr "" "ハイレベルなパッケージングのワークフローを示すグラフィック。左側には、コード、メタデータ、テストが入ったグラフィックがあります。 " "これらのアイテムはすべてディストリビューションファイルボックスに入ります。 " @@ -4923,12 +4956,12 @@ msgstr "" #: ../../tutorials/publish-pypi.md:52 msgid "" -"**[PyPI](https://pypi.org):** This is the live, production PyPI " -"repository where you can officially publish your Python package, and from" -" which users will get your package. IMPORTANT: Only publish your package " -"to PyPI when you are ready for it to be used by others and/or confident " -"that it will become a package that you will maintain. PyPI is not a place" -" to practice learning how to publish a Python package." +"**[PyPI](https://pypi.org):** This is the live, production PyPI repository " +"where you can officially publish your Python package, and from which users " +"will get your package. IMPORTANT: Only publish your package to PyPI when " +"you are ready for it to be used by others and/or confident that it will " +"become a package that you will maintain. PyPI is not a place to practice " +"learning how to publish a Python package." msgstr "" "**[PyPI](https://pypi.org):** これは、あなたが公式に Python " "パッケージを公開でき、ユーザがあなたのパッケージを取得できる、本番用の PyPI リポジトリです。重要: " @@ -4947,9 +4980,9 @@ msgstr "TestPyPI (またはPyPI)でPythonパッケージを公開するための #: ../../tutorials/publish-pypi.md:59 msgid "" -"In this lesson you will learn how to publish your package to TestPyPI " -"using [Hatch](https://hatch.pypa.io/latest/). There are 4 things that you" -" need to do to publish your Python package: to TestPyPI. You need to:" +"In this lesson you will learn how to publish your package to TestPyPI using" +" [Hatch](https://hatch.pypa.io/latest/). There are 4 things that you need " +"to do to publish your Python package: to TestPyPI. You need to:" msgstr "" "このレッスンでは、 [Hatch](https://hatch.pypa.io/latest/) " "を使ってパッケージをTestPyPIに公開する方法を学びます。 Pythonパッケージを公開するために必要なことは4つあります: " @@ -4963,15 +4996,15 @@ msgstr "**パッケージ開発環境の構築**" #, fuzzy, python-brace-format msgid "" "[**Build your package using `hatch build`**](../package-structure-code" -"/python-package-distribution-files-sdist-wheel). Building a package is " -"the process of turning your code into two types of distribution files: " -"sdist and wheel. The wheel distribution file is particularly important " -"for users who will use {term}`pip` to install your package." +"/python-package-distribution-files-sdist-wheel). Building a package is the " +"process of turning your code into two types of distribution files: sdist " +"and wheel. The wheel distribution file is particularly important for users " +"who will use {term}`pip` to install your package." msgstr "" "[**`hatch build` を使ってパッケージをビルドします**](../package-structure-code/python-" "package-distribution-files-sdist-wheel)。 " -"パッケージのビルドは、コードを2種類の配布ファイルに変換するプロセスです: sdistとwheel。wheel配布ファイルは、あなたのパッケージを" -" `pip install` するユーザーにとって特に重要です。" +"パッケージのビルドは、コードを2種類の配布ファイルに変換するプロセスです: sdistとwheel。wheel配布ファイルは、あなたのパッケージを " +"`pip install` するユーザーにとって特に重要です。" #: ../../tutorials/publish-pypi.md:66 #, fuzzy, python-brace-format @@ -4992,9 +5025,9 @@ msgstr "** `hatch publish` を使用してTestPyPIにパブリッシュする**" #: ../../tutorials/publish-pypi.md:69 #, fuzzy msgid "" -"In a [future lesson](trusted-publishing), you will learn how to create an" -" automated GitHub Actions workflow that publishes an updated version of " -"your package to PyPI every time you create a GitHub release." +"In a [future lesson](trusted-publishing), you will learn how to create an " +"automated GitHub Actions workflow that publishes an updated version of your" +" package to PyPI every time you create a GitHub release." msgstr "" "今後のレッスンでは、GitHub リリースを作成するたびにパッケージの更新版を PyPI に公開する、自動化された GitHub Actions " "のワークフローを作成する方法を学びます。" @@ -5005,22 +5038,22 @@ msgstr "Pythonパッケージのビルドについては、ガイドを参照し #: ../../tutorials/publish-pypi.md:75 msgid "" -"[Learn more about what building a Python package is](../package-" -"structure-code/python-package-distribution-files-sdist-wheel)" +"[Learn more about what building a Python package is](../package-structure-" +"code/python-package-distribution-files-sdist-wheel)" msgstr "" "[Pythonパッケージのビルドについてもっと知る](../package-structure-code/python-package-" "distribution-files-sdist-wheel)" #: ../../tutorials/publish-pypi.md:76 msgid "" -"[Learn more about the package distribution file that PyPI needs called " -"the wheel](#python-wheel)" +"[Learn more about the package distribution file that PyPI needs called the " +"wheel](#python-wheel)" msgstr "[PyPIが必要とするwheelと呼ばれるパッケージ配布ファイルについての詳細はこちら](#python-wheel)" #: ../../tutorials/publish-pypi.md:77 msgid "" -"[Learn more about the package distribution file that conda-forge will " -"need on PyPI called the sdist (source distribution)](#python-source-" +"[Learn more about the package distribution file that conda-forge will need " +"on PyPI called the sdist (source distribution)](#python-source-" "distribution)" msgstr "" "[PyPIでconda-forgeが必要とするsdist (ソースディストリビューション) " @@ -5047,8 +5080,8 @@ msgstr "次に、Hatchがアクセスできる現在の環境をすべて表示 #: ../../tutorials/publish-pypi.md:104 msgid "" -"Then activate the environment. Note that when you call a shell from a " -"Hatch environment, it will automatically install your package into the " +"Then activate the environment. Note that when you call a shell from a Hatch" +" environment, it will automatically install your package into the " "environment in development or editable mode." msgstr "" "そして環境をアクティブにします。 " @@ -5068,9 +5101,9 @@ msgstr "Hatchと環境" #: ../../tutorials/publish-pypi.md:146 msgid "" -"Behind the scenes when hatch creates a new virtual environment, by " -"default it uses venv[^venv] which is the default environment management " -"tool that comes with Python installations." +"Behind the scenes when hatch creates a new virtual environment, by default " +"it uses venv[^venv] which is the default environment management tool that " +"comes with Python installations." msgstr "" "hatchが新しい仮想環境を作るときの裏側では、デフォルトではPythonのインストールに付属しているデフォルトの環境管理ツールである " "venv[^venv] を使います。" @@ -5086,8 +5119,8 @@ msgstr "コンピュータ上に新しい仮想環境 (venv) を作成します #: ../../tutorials/publish-pypi.md:152 msgid "" "Install your package into the environment in editable mode (similar to " -"`python -m pip install -e`). This means it installs both your project and" -" your project's dependencies as declared in your pyproject.toml file." +"`python -m pip install -e`). This means it installs both your project and " +"your project's dependencies as declared in your pyproject.toml file." msgstr "" "編集可能モードでパッケージを環境にインストールします ( `python -m pip install -e` と同様) 。 " "これは、pyproject.tomlファイルで宣言されているように、あなたのプロジェクトとプロジェクトの依存関係の両方をインストールすることを意味します。" @@ -5099,8 +5132,8 @@ msgstr "ステップ 2: パッケージのsdistとwheelディストリビュー #: ../../tutorials/publish-pypi.md:156 msgid "" "Once you have your development environment setup, you are ready to build " -"your package using Hatch. Remember that building is the process of " -"turning your Python package file structure into two distribution files:" +"your package using Hatch. Remember that building is the process of turning " +"your Python package file structure into two distribution files:" msgstr "" "開発環境のセットアップが完了したら、Hatchを使ってパッケージをビルドする準備ができました。 " "ビルドとは、Pythonパッケージのファイル構造を2つの配布ファイルにするプロセスであることを覚えておいてください:" @@ -5108,16 +5141,16 @@ msgstr "" #: ../../tutorials/publish-pypi.md:158 msgid "" "The [wheel distribution](#python-wheel) is a pre-built version of your " -"package. It useful for users as it can be directly installed using a tool" -" such as `pip`. This file has the extension `.whl`." +"package. It useful for users as it can be directly installed using a tool " +"such as `pip`. This file has the extension `.whl`." msgstr "" "[wheelディストリビューション](#python-wheel) は、あなたのパッケージのビルド済みバージョンです。 `pip` " "などのツールを使って直接インストールできるので、ユーザーにとっては便利です。このファイルの拡張子は `.whl` です。" #: ../../tutorials/publish-pypi.md:159 msgid "" -"The [source distribution](#python-source-distribution) contains the files" -" that make up your package in an unbuilt format. This file will have the " +"The [source distribution](#python-source-distribution) contains the files " +"that make up your package in an unbuilt format. This file will have the " "extension `.tar.gz`." msgstr "" "[ソースディストリビューション](#python-source-distribution) " @@ -5126,15 +5159,13 @@ msgstr "" #: ../../tutorials/publish-pypi.md:161 #, fuzzy msgid "" -"You will use Hatch as a **Front end** tool that builds your package's " -"sdist and wheel using the [hatchling](https://hatch.pypa.io/latest/) " -"build back-end. The hatchling build back-end is used because you declared" -" it in your pyproject.toml file in the [previous lesson](create-python-" -"package)." +"You will use Hatch as a **Front end** tool that builds your package's sdist" +" and wheel using the [hatchling](https://hatch.pypa.io/latest/) build back-" +"end. The hatchling build back-end is used because you declared it in your " +"pyproject.toml file in the [previous lesson](create-python-package)." msgstr "" -"Hatchを **フロントエンド** " -"ツールとして使い、hatchlingビルドバックエンドを使ってパッケージのsdistとwheelをビルドします。 " -"[hatchling](https://hatch.pypa.io/latest/) ビルドバックエンドを使用するのは、 [前のレッスン" +"Hatchを **フロントエンド** ツールとして使い、hatchlingビルドバックエンドを使ってパッケージのsdistとwheelをビルドします。" +" [hatchling](https://hatch.pypa.io/latest/) ビルドバックエンドを使用するのは、 [前のレッスン" "](create-python-package)でpyproject.tomlファイルで宣言したからです。" #: ../../tutorials/publish-pypi.md:165 @@ -5147,17 +5178,16 @@ msgstr "Pythonパッケージのビルドについて" #: ../../tutorials/publish-pypi.md:178 msgid "" -"You can learn more about building in the [build page of our packaging " -"guide](../package-structure-code/python-package-distribution-files-sdist-" -"wheel)." +"You can learn more about building in the [build page of our packaging guide" +"](../package-structure-code/python-package-distribution-files-sdist-wheel)." msgstr "" "ビルドについては、 [パッケージングガイドのビルドのページ](../package-structure-code/python-package-" "distribution-files-sdist-wheel) で詳しく説明しています。" #: ../../tutorials/publish-pypi.md:182 msgid "" -"The sdist is important if you wish to [publish your package to conda-" -"forge](publish-conda-forge). You will learn about this in a later lesson." +"The sdist is important if you wish to [publish your package to conda-forge" +"](publish-conda-forge). You will learn about this in a later lesson." msgstr "" "sdistは、conda-forgeにパッケージを [公開する場合に重要です](publish-conda-forge) " "。これについては後のレッスンで学びます。" @@ -5178,19 +5208,18 @@ msgstr "" #: ../../tutorials/publish-pypi.md:193 msgid "" -" Congratulations - " -"you've created your Python package distribution files " +" Congratulations - you've " +"created your Python package distribution files " msgstr "" " おめでとう - " -"Pythonパッケージの配布ファイルを作成しました " +"Pythonパッケージの配布ファイルを作成しました " #: ../../tutorials/publish-pypi.md:195 msgid "" -"You've now built your Python package and created your package " -"distribution files. The next step is to setup your account on TestPyPI so" -" you can publish your package." +"You've now built your Python package and created your package distribution " +"files. The next step is to setup your account on TestPyPI so you can " +"publish your package." msgstr "" "これで Python " "パッケージをビルドし、パッケージ配布ファイルを作成しました。次のステップは、TestPyPIのアカウントをセットアップして、パッケージを公開できるようにすることです。" @@ -5216,13 +5245,13 @@ msgstr "TestPyPI vs. PyPI" #: ../../tutorials/publish-pypi.md:205 msgid "" "If you have a package that you are confident belongs on PyPI, all of the " -"steps below will also work for you. When you publish using Hatch, you " -"will call `hatch publish` to publish directly to PyPI instead of `hatch " -"publish -r test` which publishes to TestPyPI." +"steps below will also work for you. When you publish using Hatch, you will " +"call `hatch publish` to publish directly to PyPI instead of `hatch publish " +"-r test` which publishes to TestPyPI." msgstr "" "もしあなたがPyPIに属していると確信しているパッケージを持っているなら、以下の手順はすべてあなたにも有効です。 Hatch " -"を使って公開する場合、TestPyPI に公開する `hatch publish -r test` ではなく、直接 PyPI に公開する " -"`hatch publish` を呼び出します。" +"を使って公開する場合、TestPyPI に公開する `hatch publish -r test` ではなく、直接 PyPI に公開する `hatch" +" publish` を呼び出します。" #: ../../tutorials/publish-pypi.md:208 msgid "" @@ -5232,8 +5261,8 @@ msgstr "[ウェブブラウザを開き、TestPyPIのウェブサイトにアク #: ../../tutorials/publish-pypi.md:209 msgid "" -"[Create an account](https://test.pypi.org/account/register/) if you don't" -" already have one. Be sure to store your password in a safe place!" +"[Create an account](https://test.pypi.org/account/register/) if you don't " +"already have one. Be sure to store your password in a safe place!" msgstr "" "まだアカウントをお持ちでない方は、 " "[アカウントを作成してください。](https://test.pypi.org/account/register/) " @@ -5248,8 +5277,8 @@ msgid "" "Search on [https://test.pypi.org/](https://test.pypi.org/) (and also on " "[https://pypi.org/](https://pypi.org/)) to ensure that the package name " "that you have selected doesn't already exist. If you are using our test " -"pyosPackage, then we suggest that you add your name or GitHub username to" -" the end of the package name to ensure it's unique." +"pyosPackage, then we suggest that you add your name or GitHub username to " +"the end of the package name to ensure it's unique." msgstr "" "[https://test.pypi.org/](https://test.pypi.org/) で検索して ( " "[https://pypi.org/](https://pypi.org/) でも検索して) " @@ -5264,7 +5293,7 @@ msgstr "例: `pyosPackage_yourNameHere`." msgid "" "How to rename your Python package if the name is already taken in (test) " "PyPI" -msgstr "" +msgstr "（テスト） PyPIですでに名前が取得されている場合、Pythonパッケージの名前を変更する方法" #: ../../tutorials/publish-pypi.md:219 msgid "Required" @@ -5272,8 +5301,8 @@ msgstr "要件" #: ../../tutorials/publish-pypi.md:221 msgid "" -"Search your publishing location(s) to make sure your new name isn't taken" -" ([TestPyPI](https://test.pypi.org/), [PyPI](https://pypi.org/), [conda-" +"Search your publishing location(s) to make sure your new name isn't taken " +"([TestPyPI](https://test.pypi.org/), [PyPI](https://pypi.org/), [conda-" "forge](https://conda-forge.org/packages/))" msgstr "" "デプロイする (複数) 箇所を検索し、新しい名前が取られていないことを確認します " @@ -5322,9 +5351,9 @@ msgstr "他のファイル (例えば `README.md` ) のリポジトリ名の記 #: ../../tutorials/publish-pypi.md:235 msgid "" -"This is a screenshot of the TestPyPI website. At the top in the search " -"bar, you can see the search for pyosPackage. The search return says there" -" were no results for pyosPackage Did you mean probpackage" +"This is a screenshot of the TestPyPI website. At the top in the search bar," +" you can see the search for pyosPackage. The search return says there were " +"no results for pyosPackage Did you mean probpackage" msgstr "" "これはTestPyPIのウェブサイトのスクリーンショットです。 検索バーの一番上にpyosPackageの検索があります。pyosPackage " "の検索結果はありませんでした。 probpackageのことですか？" @@ -5332,8 +5361,8 @@ msgstr "" #: ../../tutorials/publish-pypi.md:237 msgid "" "Before you try to upload to TestPyPI, check to see if the name of your " -"package is already taken. You can do that using the search box at the top" -" of the TestPyPI website." +"package is already taken. You can do that using the search box at the top " +"of the TestPyPI website." msgstr "TestPyPIにアップロードしようとする前に、あなたのパッケージの名前がすでに使われていないか確認してください。TestPyPIのウェブサイトの上部にある検索ボックスを使って検索することができます。" #: ../../tutorials/publish-pypi.md:241 @@ -5342,27 +5371,26 @@ msgstr "2ファクタ (2FA) 認証の設定" #: ../../tutorials/publish-pypi.md:243 msgid "" -"2-factor authentication is a secure login process that allows you to use " -"a backup device that only you can access to validate that the person " -"logging in is really you. It addresses the issue of password phishing " -"where someone else gains access to a password and can login to your " -"account." +"2-factor authentication is a secure login process that allows you to use a " +"backup device that only you can access to validate that the person logging " +"in is really you. It addresses the issue of password phishing where someone" +" else gains access to a password and can login to your account." msgstr "2要素認証とは、自分だけがアクセスできるバックアップデバイスを使用して、ログインする人が本当に自分であることを確認できる安全なログインプロセスです。他人がパスワードにアクセスし、あなたのアカウントにログインできるようにするパスワードフィッシングの問題に対処します。" #: ../../tutorials/publish-pypi.md:246 msgid "" -"This matters on PyPI because someone could login to your account and " -"upload a version of your package that has security issues. These issues " -"will then impact all of your users when they download and install that " -"version of the package." +"This matters on PyPI because someone could login to your account and upload" +" a version of your package that has security issues. These issues will then" +" impact all of your users when they download and install that version of " +"the package." msgstr "" "なぜなら、誰かがあなたのアカウントにログインして、セキュリティ上の問題があるバージョンのパッケージをアップロードする可能性があるからです。 " "これらの問題は、そのバージョンのパッケージをダウンロードしてインストールする際に、すべてのユーザーに影響を与えます。" #: ../../tutorials/publish-pypi.md:248 msgid "" -"2-factor authentication is required for PyPI authentication as of 1 " -"January 2024." +"2-factor authentication is required for PyPI authentication as of 1 January" +" 2024." msgstr "2024年1月1日からPyPI認証に2要素認証が必要になりました。" #: ../../tutorials/publish-pypi.md:252 @@ -5385,15 +5413,15 @@ msgstr "なぜパッケージ固有のトークンを作るのか？" #: ../../tutorials/publish-pypi.md:258 msgid "" -"It's ideal to create a package-specific token. When you create an " -"account-wide token this allows anyone with access to the account to then " -"access all of your TestPyPI (or PyPI) projects. By creating a package-" -"specific token, you are limiting the scope of the token to only your " -"specific package. This is just a safe way to set things up for you " -"particularly if you are collaborating with others on package development." +"It's ideal to create a package-specific token. When you create an account-" +"wide token this allows anyone with access to the account to then access all" +" of your TestPyPI (or PyPI) projects. By creating a package-specific token," +" you are limiting the scope of the token to only your specific package. " +"This is just a safe way to set things up for you particularly if you are " +"collaborating with others on package development." msgstr "" -"パッケージ固有のトークンを作るのが理想的です。 アカウントワイドトークンを作成すると、そのアカウントにアクセスできる人なら誰でも、TestPyPI" -" (またはPyPI) のすべてのプロジェクトにアクセスできるようになります。 " +"パッケージ固有のトークンを作るのが理想的です。 アカウントワイドトークンを作成すると、そのアカウントにアクセスできる人なら誰でも、TestPyPI " +"(またはPyPI) のすべてのプロジェクトにアクセスできるようになります。 " "パッケージ固有のトークンを作成することで、トークンのスコープを特定のパッケージのみに限定することができます。これは、特にパッケージ開発で他の人と共同作業する場合に、安全な設定方法です。" #: ../../tutorials/publish-pypi.md:261 @@ -5415,15 +5443,15 @@ msgstr "**APIトークンの追加** ボタンをクリックしてください" #: ../../tutorials/publish-pypi.md:266 msgid "" -"If you are new to using TestPyPI and don't have any packages there yet, " -"OR if you have other packages on TestPyPI but are uploading a new " -"package, you will need to create an account-wide token." +"If you are new to using TestPyPI and don't have any packages there yet, OR " +"if you have other packages on TestPyPI but are uploading a new package, you" +" will need to create an account-wide token." msgstr "TestPyPIを使うのが初めてで、まだパッケージを持っていない場合、またはTestPyPIに他のパッケージを持っていて、新しいパッケージをアップロードする場合、アカウントワイドトークンを作成する必要があります。" #: ../../tutorials/publish-pypi.md:267 msgid "" -"When you create your token, be sure to copy the token value and store it " -"in a secure place before closing that browser." +"When you create your token, be sure to copy the token value and store it in" +" a secure place before closing that browser." msgstr "トークンを作成したら、ブラウザを閉じる前に必ずトークンの値をコピーし、安全な場所に保管してください。" #: ../../tutorials/publish-pypi.md:269 @@ -5471,17 +5499,17 @@ msgstr "`Enter your credentials` プロンプトで TestPyPI トークンの値 #: ../../tutorials/publish-pypi.md:296 msgid "" -"If your credentials are valid, and you have already run `hatch build` and" -" thus have your 2 distribution files in a `dist/` directory then Hatch " -"will publish your package to TestPyPI." +"If your credentials are valid, and you have already run `hatch build` and " +"thus have your 2 distribution files in a `dist/` directory then Hatch will " +"publish your package to TestPyPI." msgstr "" "あなたの認証情報が有効で、すでに `hatch build` を実行し、2つの配布ファイルが `dist/` ディレクトリにあれば、Hatch " "はあなたのパッケージを TestPyPI に公開します。" #: ../../tutorials/publish-pypi.md:300 msgid "" -"Hatch also has a caching system so once you enter your credentials it " -"will remember them." +"Hatch also has a caching system so once you enter your credentials it will " +"remember them." msgstr "Hatchにはキャッシュシステムもあり、一度入力した認証情報は記憶されます。" #: ../../tutorials/publish-pypi.md:303 @@ -5490,16 +5518,16 @@ msgstr "TestPyPIからパッケージをインストールする" #: ../../tutorials/publish-pypi.md:305 msgid "" -"Once your package upload is complete, you can install it from TestPyPI. " -"You can find the installation instructions on the TestPyPI landing page " -"for your newly uploaded package." +"Once your package upload is complete, you can install it from TestPyPI. You" +" can find the installation instructions on the TestPyPI landing page for " +"your newly uploaded package." msgstr "パッケージのアップロードが完了したら、TestPyPIからインストールできます。新しくアップロードしたパッケージのTestPyPIランディングページにインストール手順があります。" #: ../../tutorials/publish-pypi.md:310 msgid "" "A screenshot of the TestPyPI page for pyosPackage. It says pyosPackage " -"0.1.0 at the top with the pip install instructions below. The landing " -"page of the package has information from the package's README file." +"0.1.0 at the top with the pip install instructions below. The landing page " +"of the package has information from the package's README file." msgstr "" "pyosPackageのTestPyPIページのスクリーンショット。 一番上にpyosPackage " "0.1.0と書いてあり、その下にpipのインストール方法が書いてあります。 " @@ -5507,10 +5535,10 @@ msgstr "" #: ../../tutorials/publish-pypi.md:312 msgid "" -"This is an example landing page for the pyosPackage that was just " -"uploaded. Notice at the top of the page there are instructions for how to" -" install the package from TestPyPI. You can simply copy that code and use" -" it to install your package from TestPyPI locally." +"This is an example landing page for the pyosPackage that was just uploaded." +" Notice at the top of the page there are instructions for how to install " +"the package from TestPyPI. You can simply copy that code and use it to " +"install your package from TestPyPI locally." msgstr "" "これはアップロードされたばかりのpyosPackageのランディングページの例です。 " "ページの一番上に、TestPyPIからパッケージをインストールする方法の説明があります。 " @@ -5519,13 +5547,13 @@ msgstr "" #: ../../tutorials/publish-pypi.md:315 msgid "" "As an example, [check out our pyOpenSci pyosPackage landing page on " -"TestPyPI](https://test.pypi.org/project/pyosPackage/). Notice that the " -"page has information about the current package version and also " -"installation instructions as follows:" +"TestPyPI](https://test.pypi.org/project/pyosPackage/). Notice that the page" +" has information about the current package version and also installation " +"instructions as follows:" msgstr "" "例として、 [TestPyPIのpyOpenSci " -"pyosPackageランディングページをご覧ください](https://test.pypi.org/project/pyosPackage/) " -"。 このページには、現在のパッケージのバージョンに関する情報と、次のようなインストール手順が記載されていることに注意してください:" +"pyosPackageランディングページをご覧ください](https://test.pypi.org/project/pyosPackage/) 。 " +"このページには、現在のパッケージのバージョンに関する情報と、次のようなインストール手順が記載されていることに注意してください:" #: ../../tutorials/publish-pypi.md:319 msgid "`python -m pip install -i https://test.pypi.org/simple/ pyosPackage`" @@ -5533,13 +5561,13 @@ msgstr "`python -m pip install -i https://test.pypi.org/simple/ pyosPackage`" #: ../../tutorials/publish-pypi.md:322 msgid "" -"Publishing to TestPyPI vs PyPI While you can install from TestPyPI it's " -"not recommended that you publish to TestPyPI as a permanent way to " -"install your package. In fact, you cannot, because TestPyPI may delete " -"accounts after a time. TestPyPI is a perfect place to learn how to " -"publish your package and test the installation process. But your end goal" -" should be to publish to PyPI once you have figured out your workflow and" -" your package is ready to deploy." +"Publishing to TestPyPI vs PyPI While you can install from TestPyPI it's not" +" recommended that you publish to TestPyPI as a permanent way to install " +"your package. In fact, you cannot, because TestPyPI may delete accounts " +"after a time. TestPyPI is a perfect place to learn how to publish your " +"package and test the installation process. But your end goal should be to " +"publish to PyPI once you have figured out your workflow and your package is" +" ready to deploy." msgstr "" "TestPyPIへの公開 vs PyPI " "TestPyPIからインストールすることはできますが、パッケージをインストールする恒久的な方法としてTestPyPIに公開することはお勧めしません。なぜなら、TestPyPIは時間が経つとアカウントを削除するかもしれないからです。TestPyPIは、パッケージを公開し、インストールプロセスをテストする方法を学ぶのに最適な場所です。しかし、最終的なゴールは、ワークフローを把握し、パッケージがデプロイできる状態になったら、PyPIに公開することです。" @@ -5583,22 +5611,22 @@ msgstr "" #: ../../tutorials/publish-pypi.md:359 msgid "" -"teach them to setup trusted publisher for actions... in the actions " -"lesson https://pypi.org/help/#twofa" +"teach them to setup trusted publisher for actions... in the actions lesson " +"https://pypi.org/help/#twofa" msgstr "" "actionsのレッスン https://pypi.org/help/#twofa " "で、信頼できるactionsのパブリッシャーを設定することを教えます..." #: ../../tutorials/publish-pypi.md:362 msgid "" -"from PyPI: https://pypi.org/help/#apitoken - You can create a token for " -"an entire PyPI account, in which case, the token will work for all " -"projects associated with that account. Alternatively, you can limit a " -"token's scope to a specific project." +"from PyPI: https://pypi.org/help/#apitoken - You can create a token for an " +"entire PyPI account, in which case, the token will work for all projects " +"associated with that account. Alternatively, you can limit a token's scope " +"to a specific project." msgstr "" "PyPIから: https://pypi.org/help/#apitoken - " -"PyPIアカウント全体に対してトークンを作成することができ、その場合、トークンはそのアカウントに関連付けられているすべてのプロジェクトで動作します。" -" また、トークンの範囲を特定のプロジェクトに限定することもできます。" +"PyPIアカウント全体に対してトークンを作成することができ、その場合、トークンはそのアカウントに関連付けられているすべてのプロジェクトで動作します。 " +"また、トークンの範囲を特定のプロジェクトに限定することもできます。" #: ../../tutorials/publish-pypi.md:365 msgid "Package-specific token vs trusted publisher" @@ -5606,15 +5634,15 @@ msgstr "パッケージ固有のトークンと信頼できるパブリッシャ #: ../../tutorials/publish-pypi.md:367 msgid "" -"For long run maintenance of your package, you have two options related to" -" PyPI publication." +"For long run maintenance of your package, you have two options related to " +"PyPI publication." msgstr "パッケージの長期的なメンテナンスのために、PyPI公開に関する2つのオプションがあります。" #: ../../tutorials/publish-pypi.md:370 msgid "" -"You can create a package-specific token which you will use to publish " -"your package (manually) to PyPI. This is a great option if you don't wish" -" to automate your PyPI publication workflow." +"You can create a package-specific token which you will use to publish your " +"package (manually) to PyPI. This is a great option if you don't wish to " +"automate your PyPI publication workflow." msgstr "" "PyPIにパッケージを (手動で) " "公開する際に使用する、パッケージ固有のトークンを作成することができます。これはPyPI公開のワークフローを自動化したくない場合に最適なオプションです。" @@ -5622,16 +5650,16 @@ msgstr "" #: ../../tutorials/publish-pypi.md:371 msgid "" "You can also create an automated publication workflow on GitHub using " -"GitHub Actions. This is a great way to make the publication process " -"easier and it also supports a growing maintainer team. In this case we " -"suggest you don't worry about the token and instead setup a specific " -"GitHub Actions that publishes your package when you make a release. You " -"can then create a \"trusted publisher\" workflow on PyPI." +"GitHub Actions. This is a great way to make the publication process easier " +"and it also supports a growing maintainer team. In this case we suggest you" +" don't worry about the token and instead setup a specific GitHub Actions " +"that publishes your package when you make a release. You can then create a " +"\"trusted publisher\" workflow on PyPI." msgstr "" "GitHub Actionsを使って、GitHub上で自動公開ワークフローを作成することもできます。 " "これは、出版プロセスをより簡単にする素晴らしい方法であり、また、成長するメンテナーチームをサポートするものでもあります。 " -"この場合、トークンのことは気にせず、リリース時にパッケージを公開する GitHub Actionsを設定することをお勧めします。 " -"その後、PyPIで \"trusted publisher\" ワークフローを作成することができます。" +"この場合、トークンのことは気にせず、リリース時にパッケージを公開する GitHub Actionsを設定することをお勧めします。 その後、PyPIで " +"\"trusted publisher\" ワークフローを作成することができます。" #: ../../tutorials/publish-pypi.md:373 #, fuzzy @@ -5640,38 +5668,42 @@ msgstr "パッケージパブリッシング" #: ../../tutorials/publish-pypi.md:376 msgid "" -"While publishing from GitHub Action is possible using tokens, we " -"recommend the _Trusted Publishing_ approach as it also confers " -"significant security and usability benefits." +"While publishing from GitHub Action is possible using tokens, we recommend " +"the _Trusted Publishing_ approach as it also confers significant security " +"and usability benefits." msgstr "" +"GitHub Actionからの公開はトークンを使用して行うことができますが、セキュリティと使いやすさにも大きなメリットがあるため、_Trusted " +"Publishing_アプローチをお勧めします。" #: ../../tutorials/publish-pypi.md:378 msgid "" -"On the usability front, when Trusted Publishing is enabled, users no " -"longer need to manually create API tokens on PyPI and store them in the " -"GitHub release workflow." +"On the usability front, when Trusted Publishing is enabled, users no longer" +" need to manually create API tokens on PyPI and store them in the GitHub " +"release workflow." msgstr "" +"ユーザビリティの面では、Trusted " +"Publishingが有効になっている場合、ユーザーはPyPIでAPIトークンを手動で作成し、GitHubリリースワークフローに保存する必要がなくなります。" #: ../../tutorials/publish-pypi.md:380 msgid "" -"On the security front, Trusted Publishing reduces a risk related to the " -"API token being long lived: with API tokens, as soon as an attacker gets " +"On the security front, Trusted Publishing reduces a risk related to the API" +" token being long lived: with API tokens, as soon as an attacker gets " "access to it, they can publish many packages and versions in your name " "(depending on the scope of the token), until you discover the token " "compromise and rotate the credential. Trusted Publishing avoids this " "problem by minting very short lived tokens which expire automatically." -msgstr "" +msgstr "トークンベースの出版ではなく信頼できる出版" #: ../../tutorials/publish-pypi.md:382 msgid "" "For these benefits, it is recommended that users use _only_ the GitHub " "Actions release workflow to publish packages." -msgstr "" +msgstr "これらの利点のために、ユーザーはGitHub Actionsリリースワークフローを使用してパッケージを公開することをお勧めします。" #: ../../tutorials/publish-pypi.md:385 msgid "" -"You will learn how to create the automated trusted publisher workflow in " -"a followup lesson." +"You will learn how to create the automated trusted publisher workflow in a " +"followup lesson." msgstr "自動化された信頼できるパブリッシャーワークフローの作成方法については、次のレッスンで学びます。" #: ../../tutorials/publish-pypi.md:387 @@ -5681,8 +5713,8 @@ msgstr "オプション: 手動トークンベースの発行ワークフロー #: ../../tutorials/publish-pypi.md:389 msgid "" "If you plan to use your token regularly to publish to PyPI, we strongly " -"recommend going through the above steps again to create a token specific " -"to your new package." +"recommend going through the above steps again to create a token specific to" +" your new package." msgstr "トークンを定期的に使ってPyPIに公開する予定がある場合、新しいパッケージに固有のトークンを作成するために、上記の手順をもう一度行うことを強くお勧めします。" #: ../../tutorials/publish-pypi.md:392 @@ -5698,9 +5730,7 @@ msgid "Navigate to the \"Your Projects\" section of your account" msgstr "アカウントの \"Your Projects\" セクションに移動します" #: ../../tutorials/publish-pypi.md:395 -msgid "" -"Click on the manage button for the project that you wish to add a token " -"for" +msgid "Click on the manage button for the project that you wish to add a token for" msgstr "トークンを追加したいプロジェクトの管理ボタンをクリックします" #: ../../tutorials/publish-pypi.md:396 @@ -5713,8 +5743,8 @@ msgstr "\"パッケージ名のトークンを作成する\" をクリックし #: ../../tutorials/publish-pypi.md:398 msgid "" -"Create the token and follow the steps above publish your package using " -"the repository specific token." +"Create the token and follow the steps above publish your package using the " +"repository specific token." msgstr "トークンを作成し、上記の手順に従って、リポジトリ固有のトークンを使用してパッケージを公開します。" #: ../../tutorials/publish-pypi.md:400 @@ -5723,15 +5753,17 @@ msgstr "そして、すべて終わりました！" #: ../../tutorials/publish-pypi.md:402 msgid "Trusted Publishing instead of token-based publication" -msgstr "" +msgstr "トークンベースのパブリケーションではなく、信頼できるパブリッシング" #: ../../tutorials/publish-pypi.md:405 msgid "" -"Trusted Publishing will generate short lived tokens, scoped to the " -"project, on demand, only when a specific release workflows gets " -"triggered. This solves all the security and usability issues associated " -"with storing credentials in files/GitHub secrets." +"Trusted Publishing will generate short lived tokens, scoped to the project," +" on demand, only when a specific release workflows gets triggered. This " +"solves all the security and usability issues associated with storing " +"credentials in files/GitHub secrets." msgstr "" +"Trusted " +"Publishingは、特定のリリースワークフローがトリガーされた場合にのみ、プロジェクトに適用される短期間のトークンをオンデマンドで生成します。これにより、ファイル/GitHubシークレットに資格情報を保存することに関連するすべてのセキュリティとユーザビリティの問題が解決されます。" #: ../../tutorials/publish-pypi.md:411 msgid "You have published your package to TestPyPI!" @@ -5741,8 +5773,8 @@ msgstr "あなたはTestPyPIにパッケージを公開しました!" msgid "" "Congratulations. You have now successfully published your package to " "TestPyPI. If you have a package that is ready for real-world use on the " -"real PyPI, then you can follow the same steps (with the differences noted" -" above) to publish it on PyPI." +"real PyPI, then you can follow the same steps (with the differences noted " +"above) to publish it on PyPI." msgstr "" "おめでとうございます。これで、TestPyPIへのパッケージの公開が成功しました。実際のPyPIで利用できる準備が整ったパッケージがあれば、同じ手順で" " (上記の違いはありますが) PyPIに公開することができます。" @@ -5772,10 +5804,10 @@ msgstr "PythonパッケージをPyPIに対応させる - pyproject.toml" #: ../../tutorials/pyproject-toml.md:8 #, fuzzy msgid "" -"In [the installable code lesson](create-python-package), you learned how " -"to add the bare minimum information to a `pyproject.toml` file to make it" -" installable. You then learned how to publish a bare minimum version of " -"your package to [PyPI](publish-pypi)." +"In [the installable code lesson](create-python-package), you learned how to" +" add the bare minimum information to a `pyproject.toml` file to make it " +"installable. You then learned how to publish a bare minimum version of your" +" package to [PyPI](publish-pypi)." msgstr "" "[インストール可能なコードのレッスン](create-python-package) では、 `pyproject.toml` " "ファイルに最低限の情報を追加してインストール可能にする方法を学びました。その後、 [PyPIにパッケージの最小限のバージョンを公開する" @@ -5806,23 +5838,23 @@ msgid "" "To enhance the visibility of your package on PyPI and provide more " "information about its compatibility with Python versions, project " "development status, and project maintainers, you should add additional " -"metadata to your `pyproject.toml` file. This lesson will guide you " -"through the process." +"metadata to your `pyproject.toml` file. This lesson will guide you through " +"the process." msgstr "" "PyPI 上でのパッケージの可視性を高め、Python " -"のバージョンとの互換性、プロジェクトの開発状況、プロジェクトのメンテナーについてより多くの情報を提供するために、 `pyproject.toml`" -" ファイルに追加のメタデータを追加する必要があります。このレッスンでは、そのプロセスについて説明します。" +"のバージョンとの互換性、プロジェクトの開発状況、プロジェクトのメンテナーについてより多くの情報を提供するために、 `pyproject.toml` " +"ファイルに追加のメタデータを追加する必要があります。このレッスンでは、そのプロセスについて説明します。" #: ../../tutorials/pyproject-toml.md:32 msgid "" -"More about the `pyproject.toml` file and how it's used to store different" -" types of metadata about your package" +"More about the `pyproject.toml` file and how it's used to store different " +"types of metadata about your package" msgstr "`pyproject.toml` ファイルの詳細と、パッケージに関するさまざまな種類のメタデータを格納するためにどのように使用されるかについて" #: ../../tutorials/pyproject-toml.md:33 msgid "" -"How to declare information (metadata) about your project to help users " -"find and understand it on PyPI." +"How to declare information (metadata) about your project to help users find" +" and understand it on PyPI." msgstr "ユーザーがPyPIでプロジェクトを見つけ、理解しやすくするために、プロジェクトに関する情報 (メタデータ) を宣言する方法。" #: ../../tutorials/pyproject-toml.md:35 @@ -5883,14 +5915,13 @@ msgstr "" #: ../../tutorials/pyproject-toml.md:51 msgid "" -"When you are adding classifiers to the **[project]** table, only use " -"valid values from [PyPI's classifier " -"page](https://PyPI.org/classifiers/). An invalid value here will raise an" -" error when you build and publish your package on PyPI." +"When you are adding classifiers to the **[project]** table, only use valid " +"values from [PyPI's classifier page](https://PyPI.org/classifiers/). An " +"invalid value here will raise an error when you build and publish your " +"package on PyPI." msgstr "" -"**[project]** テーブルに分類を追加するときは、 " -"[PyPIの分類ページ](https://PyPI.org/classifiers/) にある有効な値のみを使用してください。 " -"ここで無効な値を指定すると、パッケージをビルドするときやPyPIに公開するときにエラーが発生します。" +"**[project]** テーブルに分類を追加するときは、 [PyPIの分類ページ](https://PyPI.org/classifiers/) " +"にある有効な値のみを使用してください。 ここで無効な値を指定すると、パッケージをビルドするときやPyPIに公開するときにエラーが発生します。" #: ../../tutorials/pyproject-toml.md:52 msgid "" @@ -5909,8 +5940,8 @@ msgstr "**[build-system]** テーブルを `pyproject.toml` ファイルの先 #: ../../tutorials/pyproject-toml.md:58 msgid "" -"The `pyproject.toml` file is a human and machine-readable file that " -"serves as the primary configuration file for your Python package." +"The `pyproject.toml` file is a human and machine-readable file that serves " +"as the primary configuration file for your Python package." msgstr "`pyproject.toml` ファイルは人間や機械が読めるファイルで、Pythonパッケージの主要な設定ファイルとして機能します。" #: ../../tutorials/pyproject-toml.md:63 @@ -5926,21 +5957,20 @@ msgstr ".toml フォーマットについて" #: ../../tutorials/pyproject-toml.md:69 #, fuzzy, python-brace-format msgid "" -"The **pyproject.toml** file is written in {term}`TOML` format. TOML is an" -" easy-to-read structure that is based on key/value pairs. Each section in" -" the **pyproject.toml** file contains a `[table identifier]`. The TOML " +"The **pyproject.toml** file is written in {term}`TOML` format. TOML is an " +"easy-to-read structure that is based on key/value pairs. Each section in " +"the **pyproject.toml** file contains a `[table identifier]`. The TOML " "format can be compared to other structured formats such as `.json`." msgstr "" "**pyproject.toml** ファイルは [TOML (Tom's Obvious, Minimal Language) " "format](https://toml.io/en/) で書かれています。TOMLは、キーと値のペアに基づいた読みやすい構造です。 " -"**pyproject.toml** ファイルの各セクションには `[table identifier]` " -"が含まれています。TOMLフォーマットは、 `.json` " -"などの他の構造化フォーマットと比較することができます。しかし、TOMLフォーマットは人間が読みやすいように設計されています。" +"**pyproject.toml** ファイルの各セクションには `[table identifier]` が含まれています。TOMLフォーマットは、" +" `.json` などの他の構造化フォーマットと比較することができます。しかし、TOMLフォーマットは人間が読みやすいように設計されています。" #: ../../tutorials/pyproject-toml.md:74 msgid "" -"Below you can see the `[build-system]` table. Within that table there are" -" two required key/value pairs." +"Below you can see the `[build-system]` table. Within that table there are " +"two required key/value pairs." msgstr "以下に `[build-system]` テーブルを示す。そのテーブルの中には、2つのキーと値のペアが必要です。" #: ../../tutorials/pyproject-toml.md:77 @@ -5948,8 +5978,8 @@ msgid "" "`requires =` is the key and the value is `[\"hatchling\"]` within the " "`[build-system]` array specified by square brackets `[]`." msgstr "" -"`requires =` がキーで、値は角括弧 `[]` で指定された `[build-system]` 配列内の " -"`[\"hatchling\"]` です。" +"`requires =` がキーで、値は角括弧 `[]` で指定された `[build-system]` 配列内の `[\"hatchling\"]`" +" です。" #: ../../tutorials/pyproject-toml.md:87 msgid "What is the pyproject.toml used for?" @@ -5979,8 +6009,8 @@ msgstr "**静的** ここで、バージョン `version = \"0.1.0\"` または" #: ../../tutorials/pyproject-toml.md:96 msgid "" -"**dynamically** where the tool looks to the most recent tag in your " -"history to determine the current version." +"**dynamically** where the tool looks to the most recent tag in your history" +" to determine the current version." msgstr "**動的** このツールは、現在のバージョンを決定するために、履歴の最新のタグを検索します。" #: ../../tutorials/pyproject-toml.md:97 @@ -6018,19 +6048,19 @@ msgstr "誰がメンテナンスするのか" #: ../../tutorials/pyproject-toml.md:108 msgid "" -"Finally, the pyproject.toml file is also often used to configure tools " -"such as static type checkers (e.g. mypy) and code formatters/linters " -"(e.g. black, ruff)." +"Finally, the pyproject.toml file is also often used to configure tools such" +" as static type checkers (e.g. mypy) and code formatters/linters (e.g. " +"black, ruff)." msgstr "" -"最後に、pyproject.tomlファイルは、静的タイプチェッカー (mypyなど) やコードフォーマッタ/リンタ (blackやruffなど)" -" のようなツールを設定するためにもよく使われます。" +"最後に、pyproject.tomlファイルは、静的タイプチェッカー (mypyなど) やコードフォーマッタ/リンタ (blackやruffなど) " +"のようなツールを設定するためにもよく使われます。" #: ../../tutorials/pyproject-toml.md:111 msgid "" "Check out the [PyPA " -"documentation](https://packaging.python.org/en/latest/tutorials" -"/packaging-projects/#choosing-a-build-backend) if you are interested in " -"setting build configurations for other tools." +"documentation](https://packaging.python.org/en/latest/tutorials/packaging-" +"projects/#choosing-a-build-backend) if you are interested in setting build " +"configurations for other tools." msgstr "" "他のツールのビルド設定の設定に興味があれば、 " "[PyPAのドキュメント](https://packaging.python.org/en/latest/tutorials/packaging-" @@ -6038,11 +6068,11 @@ msgstr "" #: ../../tutorials/pyproject-toml.md:113 msgid "" -"Note that some build tools may deviate in how they store project " -"metadata. As such you may want to refer to their documentation if you " -"decide to use a tool other than Hatch and hatchling. We have selected " -"hatchling and hatch as our tool of choice for this tutorial as it adheres" -" to PyPA rules and guidelines." +"Note that some build tools may deviate in how they store project metadata. " +"As such you may want to refer to their documentation if you decide to use a" +" tool other than Hatch and hatchling. We have selected hatchling and hatch " +"as our tool of choice for this tutorial as it adheres to PyPA rules and " +"guidelines." msgstr "" "ビルドツールによっては、プロジェクトのメタデータを保存する方法が異なる場合があります。そのため、Hatch " "とhatchling以外のツールを使用する場合は、それらのドキュメントを参照することをお勧めします。このチュートリアルでは、PyPAのルールとガイドラインに準拠したツールであるhatchlingとhatchを選択しました。" @@ -6053,11 +6083,11 @@ msgstr "pyproject.tomlのメタデータはどのように使用されますか #: ../../tutorials/pyproject-toml.md:119 msgid "" -"The pyproject.toml file is the file that your build tool uses to populate" -" a `METADATA` that is included in your Python distribution files that get" -" published to PyPI. This `METADATA` file is then used by PyPI to populate" -" your package's PyPI landing page and help users filter through the tens " -"of thousands of packages published there." +"The pyproject.toml file is the file that your build tool uses to populate a" +" `METADATA` that is included in your Python distribution files that get " +"published to PyPI. This `METADATA` file is then used by PyPI to populate " +"your package's PyPI landing page and help users filter through the tens of " +"thousands of packages published there." msgstr "" "pyproject.tomlファイルは、PyPIに公開されるPythonの配布ファイルに含まれる `METADATA` " "を生成するためにビルドツールが使用するファイルです。 この `METADATA` ファイルは、PyPI によってあなたのパッケージの PyPI " @@ -6065,22 +6095,22 @@ msgstr "" #: ../../tutorials/pyproject-toml.md:122 msgid "" -"Image showing the left side bar of PyPI for the package xclim. The " -"section at the top says Classifier. Below there is a list of items " -"including Development status, intended audience, License, natural " -"language, operating system, programming language and topic. Below each of" -" those sections are various classifier options.\" width=\"300px\">" +"Image showing the left side bar of PyPI for the package xclim. The section " +"at the top says Classifier. Below there is a list of items including " +"Development status, intended audience, License, natural language, operating" +" system, programming language and topic. Below each of those sections are " +"various classifier options.\" width=\"300px\">" msgstr "" "xclimパッケージのPyPI左サイドバーの画像です。一番上のセクションにはClassifierとあります。その下に、開発状況、対象読者、ライセンス、自然言語、オペレーティングシステム、プログラミング言語、トピックなどの項目があります。" " これらの各セクションの下には、さまざまな分類オプションがあります。 \" width=\"300px\">" #: ../../tutorials/pyproject-toml.md:127 msgid "" -"When you add the classifier section to your pyproject.toml and your " -"package is built, the build tool organizes the metadata into a format " -"that PyPI can understand and represent on your PyPI landing page. These " -"classifiers also allow users to sort through packages by version of " -"python they support, categories and more." +"When you add the classifier section to your pyproject.toml and your package" +" is built, the build tool organizes the metadata into a format that PyPI " +"can understand and represent on your PyPI landing page. These classifiers " +"also allow users to sort through packages by version of python they " +"support, categories and more." msgstr "" "pyproject.tomlにclassifierセクションを追加してパッケージがビルドされると、ビルドツールはメタデータをPyPIが理解できる形式に整理し、PyPIのランディングページに表示します。" " これらの分類子により、ユーザはサポートするpythonのバージョンやカテゴリなどでパッケージをソートすることもできます。" @@ -6091,8 +6121,8 @@ msgstr "pyproject.tomlファイルのより詳細な概要" #: ../../tutorials/pyproject-toml.md:135 msgid "" -"[Our guidebook page has a more in depth overview of this file" -"](../package-structure-code/pyproject-toml-python-package-metadata/)" +"[Our guidebook page has a more in depth overview of this file](../package-" +"structure-code/pyproject-toml-python-package-metadata/)" msgstr "" "[ガイドブックページでは、このファイルについてより詳しく説明しています](../package-structure-code/pyproject-" "toml-python-package-metadata/)" @@ -6123,11 +6153,11 @@ msgstr "あなたが作成した `pyproject.toml` ファイルは次のような #: ../../tutorials/pyproject-toml.md:159 msgid "" -"Your next step is to add additional recommended metadata fields that will" -" both help users find your package on PyPI and also better describe the " -"scope of your package. Once you add this metadata, you don't have to do " -"it again. These metadata fields will only be updated periodically when " -"you do something such as:" +"Your next step is to add additional recommended metadata fields that will " +"both help users find your package on PyPI and also better describe the " +"scope of your package. Once you add this metadata, you don't have to do it " +"again. These metadata fields will only be updated periodically when you do " +"something such as:" msgstr "" "次のステップでは、PyPI " "であなたのパッケージを見つけるのに役立ち、またあなたのパッケージの範囲をよりよく説明するために、推奨されるメタデータフィールドを追加します。 " @@ -6161,8 +6191,8 @@ msgstr "ステップ1: 作者、メンテナ、プロジェクトの説明を追 #: ../../tutorials/pyproject-toml.md:173 msgid "" "After completing the [installable code tutorial](create-python-package), " -"you should have a pyproject.toml file with a project name and a version " -"in the `[project]` table." +"you should have a pyproject.toml file with a project name and a version in " +"the `[project]` table." msgstr "" "[インストール可能なコードのチュートリアル](create-python-package) を完了すると、 `[project]` " "テーブルにプロジェクト名とバージョンを持つpyproject.tomlファイルができるはずです。" @@ -6173,9 +6203,9 @@ msgstr "テーブルに以下を追加します:" #: ../../tutorials/pyproject-toml.md:183 msgid "" -"A **description** of your package. This should be a single line and " -"should briefly describe the goal of your package using non technical " -"terms if as all possible!" +"A **description** of your package. This should be a single line and should " +"briefly describe the goal of your package using non technical terms if as " +"all possible!" msgstr "パッケージの**説明** これは1行で、可能な限り専門用語を使わず、あなたのパッケージの目標を簡潔に記述してください！" #: ../../tutorials/pyproject-toml.md:184 @@ -6203,16 +6233,16 @@ msgstr "著者名とEメール" #: ../../tutorials/pyproject-toml.md:216 msgid "" "There is a quirk with PyPI for authors that have names but not emails in " -"the pyproject.toml. If you are missing the email for one or more authors " -"or maintainers, like this:" +"the pyproject.toml. If you are missing the email for one or more authors or" +" maintainers, like this:" msgstr "" "PyPIには、pyproject.tomlに名前があってもメールがない作者のための癖があります。 " "もし、1人以上の作者やメンテナのEメールが見つからない場合は、次のようにしてください:" #: ../../tutorials/pyproject-toml.md:225 msgid "" -"Then we suggest that you only provide names in your list of names to " -"ensure that everything renders properly on your PyPI page - like this:" +"Then we suggest that you only provide names in your list of names to ensure" +" that everything renders properly on your PyPI page - like this:" msgstr "PyPIページですべてが正しく表示されるようにするために、名前のリストには名前のみを入力することをお勧めします - このように:" #: ../../tutorials/pyproject-toml.md:234 @@ -6221,9 +6251,9 @@ msgstr "全員のEメールを持っていない場合は、名前だけを追 #: ../../tutorials/pyproject-toml.md:237 msgid "" -"Your `pyproject.toml` file now should look like the example below. It is " -"OK if you only have 1 author and the same author is also maintainer of " -"your package:" +"Your `pyproject.toml` file now should look like the example below. It is OK" +" if you only have 1 author and the same author is also maintainer of your " +"package:" msgstr "" "これで `pyproject.toml` ファイルは以下の例のようになるはずです。 " "作者が1人しかおらず、同じ作者がパッケージのメンテナでもある場合は問題ありません:" @@ -6254,9 +6284,9 @@ msgstr "パッケージに新しい機能を追加する人たち。" #: ../../tutorials/pyproject-toml.md:271 msgid "" -"Whereas maintainers are the people that are currently, actively working " -"on the project. It is often the case that there is overlap in authors and" -" maintainers. As such these lists may be similar or the same." +"Whereas maintainers are the people that are currently, actively working on " +"the project. It is often the case that there is overlap in authors and " +"maintainers. As such these lists may be similar or the same." msgstr "" "一方、メンテナーは、現在、積極的にプロジェクトに取り組んでいる人々です。 作者とメンテナーが重なることはよくあることです。 " "そのため、これらのリストは似たり寄ったりかもしれません。" @@ -6277,9 +6307,9 @@ msgstr "重要なのは、作者とメンテナを定義する方法はたくさ #: ../../tutorials/pyproject-toml.md:277 msgid "" -"However, we encourage you to consider carefully, for PyPI publication, " -"who you want to have listed as authors and maintainers on your PyPI " -"landing page." +"However, we encourage you to consider carefully, for PyPI publication, who " +"you want to have listed as authors and maintainers on your PyPI landing " +"page." msgstr "しかし、PyPIで公開する際には、PyPIのランディングページに作者やメンテナとして誰を掲載するか、慎重に検討することをお勧めします。" #: ../../tutorials/pyproject-toml.md:281 @@ -6289,11 +6319,11 @@ msgstr "ステップ2: READMEとライセンスの追加" #: ../../tutorials/pyproject-toml.md:283 #, fuzzy msgid "" -"In the previous lessons, you added both a [README.md](add-readme) file " -"and a [LICENSE](add-license-coc) to your package repository. Once you " -"have those files, you can refer to the README from your pyproject.toml " -"file, and add a short code indicating your choice of LICENSE following " -"the example below." +"In the previous lessons, you added both a [README.md](add-readme) file and " +"a [LICENSE](add-license-coc) to your package repository. Once you have " +"those files, you can refer to the README from your pyproject.toml file, and" +" add a short code indicating your choice of LICENSE following the example " +"below." msgstr "" "前のレッスンでは、 [README.md](add-readme) ファイルと [LICENSE](add-license-coc) " "の両方をパッケージリポジトリーに追加しました。これらのファイルを手に入れたら、以下の例に従ってpyproject.tomlファイルにリンクとして追加します。" @@ -6302,26 +6332,35 @@ msgstr "" msgid "" "The license entry in your pyproject.toml file must use the [license " "expression syntax](https://packaging.python.org/en/latest/specifications" -"/license-expression/). Often this is a short name (with no spaces) for " -"the license, such as \"MIT\", \"BSD-3-Clause\" or \"Apache-2.0\". More " -"precisely, it must be a valid SPDX license expression, as documented in " -"the [SPDX specification](https://spdx.github.io/spdx-spec/v2.2.2/SPDX-" -"license-expressions/), either version 2.2 or a later compatible version." -msgstr "" +"/license-expression/). Often this is a short name (with no spaces) for the " +"license, such as \"MIT\", \"BSD-3-Clause\" or \"Apache-2.0\". More " +"precisely, it must be a valid SPDX license expression, as documented in the" +" [SPDX specification](https://spdx.github.io/spdx-spec/v2.2.2/SPDX-license-" +"expressions/), either version 2.2 or a later compatible version." +msgstr "" +"Pyproject.tomlファイルのライセンスエントリは、[ライセンス式構文]( " +"https://packaging.python.org/en/latest/specifications/license-" +"expression/)を使用する必要があります。多くの場合、これは「MIT」、「BSD -3 - " +"Clause」、「Apache-2.0」など、ライセンスの短い名前（スペースなし）です。より正確には、バージョン2.2以降の互換バージョンの[SPDX仕様](" +" https://spdx.github.io/spdx-spec/v2.2.2/SPDX-license-" +"expressions/)に記載されているように、有効なSPDXライセンス式である必要があります。" #: ../../tutorials/pyproject-toml.md:314 msgid "" "If you have multiple licenses, or a custom license, you can also express " "these using a license expression." -msgstr "" +msgstr "複数のライセンスまたはカスタムライセンスをお持ちの場合は、ライセンス式を使用してこれらを表現することもできます。" #: ../../tutorials/pyproject-toml.md:316 msgid "" "If you want to distribute license files, or other files containing legal " -"information, with your package, you can include these using the " -"[`license-files`](https://packaging.python.org/en/latest/guides/writing-" -"pyproject-toml/#license-files) entry, but this is not required." +"information, with your package, you can include these using the [`license-" +"files`](https://packaging.python.org/en/latest/guides/writing-pyproject-" +"toml/#license-files) entry, but this is not required." msgstr "" +"ライセンスファイル、または法的情報を含むその他のファイルをパッケージに配布する場合は、[' license - files ']（ " +"https://packaging.python.org/en/latest/guides/writing-pyproject-toml" +"/#license-files ）エントリを使用してこれらを含めることができますが、これは必須ではありません。" #: ../../tutorials/pyproject-toml.md:318 msgid "Step 3: Specify Python version with `requires-python`" @@ -6329,16 +6368,15 @@ msgstr "ステップ 3: `requires-python` でPythonのバージョンを指定 #: ../../tutorials/pyproject-toml.md:320 msgid "" -"Add the `requires-python` field to your `pyproject.toml` `[project]` " -"table. The `requires-python` field helps pip identify which Python " -"versions that your package supports. It is set to a single value. The " -"[packaging " -"specification](https://packaging.python.org/en/latest/specifications" -"/core-metadata/#core-metadata-requires-python) defines`requires-python` " -"as a string that uses version specifiers. Most projects will specify the " -"oldest Python version supported by the package. In some advanced cases, " -"an upper bound is set to indicate which future Python versions, if any, " -"will be supported." +"Add the `requires-python` field to your `pyproject.toml` `[project]` table." +" The `requires-python` field helps pip identify which Python versions that " +"your package supports. It is set to a single value. The [packaging " +"specification](https://packaging.python.org/en/latest/specifications/core-" +"metadata/#core-metadata-requires-python) defines`requires-python` as a " +"string that uses version specifiers. Most projects will specify the oldest " +"Python version supported by the package. In some advanced cases, an upper " +"bound is set to indicate which future Python versions, if any, will be " +"supported." msgstr "" "`pyproject.toml` の `[project]` テーブルに `requires-python` フィールドを追加します。 " "`requires-python` フィールドは、pipがあなたのパッケージがサポートする Pythonのバージョンを特定するのに役立ちます。 " @@ -6356,25 +6394,31 @@ msgstr "パッケージがサポートしているPythonのバージョンを変 msgid "" "Good question. The Python developer guide provides a [status " "page](https://devguide.python.org/versions/) (and a handy visualization) " -"that explains the status of each Python release. Python releases go " -"through several different phases that are explained in [PEP " +"that explains the status of each Python release. Python releases go through" +" several different phases that are explained in [PEP " "602](https://peps.python.org/pep-0602/)." msgstr "" +"良い質問です。Python開発者ガイドには、各Pythonリリースのステータスを説明する[ステータスページ]( " +"https://devguide.python.org/versions/ " +")(および便利な視覚化)が用意されています。Pythonのリリースは、[PEP 602 ]( " +"https://peps.python.org/pep-0602/)で説明されているいくつかの異なるフェーズを経ています。" #: ../../tutorials/pyproject-toml.md:329 msgid "" "We recommend that you use the latest Python release in the **bugfix** " "phase. If your Python release is in the **security** phase, we recommend " "migrating to a newer version of Python." -msgstr "" +msgstr "**バグ修正**フェーズでは、最新のPythonリリースを使用することをお勧めします。Pythonリリースが**セキュリティ**フェーズにある場合は、新しいバージョンのPythonに移行することをお勧めします。" #: ../../tutorials/pyproject-toml.md:331 msgid "" -"[SPEC 0](https://scientific-python.org/specs/spec-0000/) of the " -"Scientific Python project suggests a common schedule for dependencies, " -"including Python release versions, and is also worth considering for your" -" project." +"[SPEC 0](https://scientific-python.org/specs/spec-0000/) of the Scientific " +"Python project suggests a common schedule for dependencies, including " +"Python release versions, and is also worth considering for your project." msgstr "" +"Scientific Pythonプロジェクトの[SPEC 0 ]（ https://scientific-" +"python.org/specs/spec-0000/ " +"）は、Pythonリリースバージョンを含む依存関係の共通スケジュールを提案しており、プロジェクトでも検討する価値があります。" #: ../../tutorials/pyproject-toml.md:360 msgid "Step 4: Specify Dependencies" @@ -6382,15 +6426,15 @@ msgstr "ステップ4: 依存関係の指定" #: ../../tutorials/pyproject-toml.md:362 msgid "" -"Next add your dependencies table to the project table. The `dependencies " -"=` section contains a list (or array in the toml language) of the Python " +"Next add your dependencies table to the project table. The `dependencies =`" +" section contains a list (or array in the toml language) of the Python " "packages that your package requires to run properly in a Python " "environment. Similar to the requirements listed in the `[build-system]` " "table above:" msgstr "" "次に、依存関係テーブルをプロジェクトテーブルに追加します。 `dependencies =` " -"セクションには、あなたのパッケージがPython環境で正しく動作するために必要なPythonパッケージのリスト（toml言語では配列）を記述します。" -" 上記の `[build-system]` の表に記載されている要件と同様です:" +"セクションには、あなたのパッケージがPython環境で正しく動作するために必要なPythonパッケージのリスト（toml言語では配列）を記述します。 " +"上記の `[build-system]` の表に記載されている要件と同様です:" #: ../../tutorials/pyproject-toml.md:370 msgid "dependencies are added in an array (similar to a Python list) structure." @@ -6400,11 +6444,11 @@ msgstr "依存関係は配列（Pythonのリストに似ている）構造で追 msgid "" "A dependency can be limited to specific versions using a **version " "specifier.** If the dependency has no version specifier after the " -"dependency name, your package can use any version of the dependent " -"package. Code changes over time, bugs are fixed, APIs change, and so it's" -" good to be clear about which version of the dependency you wrote your " -"code to be compatible with - a package you wrote this year probably isn't" -" compatible with numpy v0.0.1!" +"dependency name, your package can use any version of the dependent package." +" Code changes over time, bugs are fixed, APIs change, and so it's good to " +"be clear about which version of the dependency you wrote your code to be " +"compatible with - a package you wrote this year probably isn't compatible " +"with numpy v0.0.1!" msgstr "" "依存関係は、 **バージョン指定子** を使って特定のバージョンに限定することができます。 " "依存関係の名前の後にバージョン指定子がない場合、あなたのパッケージは依存パッケージのどのバージョンでも使うことができます。 " @@ -6423,10 +6467,10 @@ msgstr "" #: ../../tutorials/pyproject-toml.md:382 msgid "" "The most common version specifier is a **lower bound,** allowing any " -"version higher than the specified version. Ideally you should set this to" -" the lowest version that is still compatible with your package, but in " -"practice for new packages this is often set at the version that was " -"current at the time the package was written[^lowerbound]." +"version higher than the specified version. Ideally you should set this to " +"the lowest version that is still compatible with your package, but in " +"practice for new packages this is often set at the version that was current" +" at the time the package was written[^lowerbound]." msgstr "" "最も一般的なバージョン指定子は **lower bound** " "で、指定されたバージョンより上位のバージョンを許可します。理想的には、あなたのパッケージとまだ互換性のある最も低いバージョンに設定すべきですが、実際には新しいパッケージの場合、パッケージが書かれた時点での最新バージョンに設定されることがよくあります" @@ -6439,8 +6483,7 @@ msgstr "下限は次のようになります:" #: ../../tutorials/pyproject-toml.md:393 msgid "" "Commas are used to separate individual dependencies, and each package in " -"your `dependencies` section can use different types of version " -"specifiers:" +"your `dependencies` section can use different types of version specifiers:" msgstr "" "カンマは、個々の依存関係を区切るために使用します、 そして、`dependencies` " "セクションの各パッケージは異なるタイプのバージョン指定子を使うことができます:" @@ -6454,9 +6497,7 @@ msgid "Pin dependencies with caution" msgstr "依存関係のピン止めは慎重に" #: ../../tutorials/pyproject-toml.md:435 -msgid "" -"\"Pinning\" a dependency means setting it to a specific version, like " -"this:" +msgid "\"Pinning\" a dependency means setting it to a specific version, like this:" msgstr "依存関係を \"Pinning\" することは、次のように特定のバージョンに設定することを意味します:" #: ../../tutorials/pyproject-toml.md:437 @@ -6466,13 +6507,13 @@ msgstr "`numpy == 1.0` 。" #: ../../tutorials/pyproject-toml.md:439 msgid "" "If you are building a library package that other developers will depend " -"upon, you must be cautious before pinning to a precise dependency " -"version. Applications, such as production websites, will often pin their " -"dependencies since other packages will not depend on their project. This " -"is because users will be installing your package into various " -"environments. A dependency pinned to a single specific version can make " -"resolving a Python environment more challenging. As such only pin " -"dependencies to a specific version if you absolutely need to do so." +"upon, you must be cautious before pinning to a precise dependency version. " +"Applications, such as production websites, will often pin their " +"dependencies since other packages will not depend on their project. This is" +" because users will be installing your package into various environments. A" +" dependency pinned to a single specific version can make resolving a Python" +" environment more challenging. As such only pin dependencies to a specific " +"version if you absolutely need to do so." msgstr "" "他の開発者が依存するライブラリパッケージを構築する場合、正確な依存バージョンに固定する前に慎重にならなければなりません。 " "本番用ウェブサイトのようなアプリケーションは、他のパッケージがそのプロジェクトに依存しないため、依存関係を固定することが多いです。 " @@ -6500,11 +6541,11 @@ msgstr "ステップ5: PyPI classifiersを追加する" #: ../../tutorials/pyproject-toml.md:460 msgid "" -"Next you will add classifiers to your `pyproject.toml` file. The value " -"for each classifier that you add to your `pyproject.toml` file must come " -"from the list of [PyPI accepted classifier values found " -"here](https://PyPI.org/classifiers/). Any deviations in spelling and " -"format will cause issues when you publish to PyPI." +"Next you will add classifiers to your `pyproject.toml` file. The value for " +"each classifier that you add to your `pyproject.toml` file must come from " +"the list of [PyPI accepted classifier values found " +"here](https://PyPI.org/classifiers/). Any deviations in spelling and format" +" will cause issues when you publish to PyPI." msgstr "" "次に、`pyproject.toml`ファイルに分類子を追加します。 `pyproject.toml` ファイルに追加する各分類子の値は、 " "[ここにあるPyPIで認められている分類子](https://PyPI.org/classifiers/) " @@ -6518,8 +6559,8 @@ msgstr "間違った分類子を使うとどうなりますか？" msgid "" "If you do not [use standard classifier " "values](https://PyPI.org/classifiers/), when you try to publish your " -"package on PyPI it will be rejected. 😔 Don't worry if PyPI rejects you on" -" your first try! It has happened to all of us." +"package on PyPI it will be rejected. 😔 Don't worry if PyPI rejects you on " +"your first try! It has happened to all of us." msgstr "" "もし [標準的な分類器の値を使う](https://PyPI.org/classifiers/) のでなければ、 " "PyPIでパッケージを公開しようとすると拒否されます。 最初のトライでPyPIに拒否されても心配しないでください！ " @@ -6555,11 +6596,11 @@ msgstr "classifierのキーは、下の例のようになるはずです。 い #, fuzzy msgid "" "Your classifier values might be different depending upon your intended " -"audience, development status of your package and the Python versions that" -" you support" +"audience, development status of your package and the Python versions that " +"you support" msgstr "" -"分類器の値は、パッケージに選択したライセンスによって異なる場合があります、 あなたの意図する読者、パッケージの開発状況とサポートしている " -"Python のバージョンです。" +"分類器の値は、パッケージに選択したライセンスによって異なる場合があります、 あなたの意図する読者、パッケージの開発状況とサポートしている Python" +" のバージョンです。" #: ../../tutorials/pyproject-toml.md:478 msgid "" @@ -6569,9 +6610,9 @@ msgstr "[指定されたPyPIの分類子の値](https://PyPI.org/classifiers/) #: ../../tutorials/pyproject-toml.md:517 msgid "" -"Note that while classifiers are not required in your `pyproject.toml` " -"file, they will help users find your package. As such we strongly " -"recommend that you add them." +"Note that while classifiers are not required in your `pyproject.toml` file," +" they will help users find your package. As such we strongly recommend that" +" you add them." msgstr "" "分類子は `pyproject.toml` " "ファイルでは必須ではありませんが、ユーザーがあなたのパッケージを見つけるのに役立つことに注意してください。そのため、追加することを強くお勧めします。" @@ -6586,15 +6627,15 @@ msgstr "最後に、pyproject.tomlファイルにproject.urlsテーブルを追 #: ../../tutorials/pyproject-toml.md:523 msgid "" -"`project.urls` contains links that are relevant for your project. You " -"might want to include:" +"`project.urls` contains links that are relevant for your project. You might" +" want to include:" msgstr "`project.urls` には、プロジェクトに関連するリンクが含まれています。以下を含めるとよいでしょう:" #: ../../tutorials/pyproject-toml.md:525 msgid "" -"**Homepage:** A link to your published documentation for your project. If" -" you are working through this tutorial, then you may not have this link " -"yet. That's ok, you can skip it for the time being." +"**Homepage:** A link to your published documentation for your project. If " +"you are working through this tutorial, then you may not have this link yet." +" That's ok, you can skip it for the time being." msgstr "" "**ホームページ:** プロジェクトの公開ドキュメントへのリンク。 " "このチュートリアルを進めているのであれば、このリンクはまだ持っていないかもしれません。 大丈夫、当分は飛ばしてもいいです。" @@ -6612,12 +6653,11 @@ msgstr "**ソース:** プロジェクトのGitHub / GitLabリンク。" #: ../../tutorials/pyproject-toml.md:572 msgid "" -"There are many other urls that you can add here. Check out the [README " -"file here for an overview](https://github.com/patrick91/links-demo)." +"There are many other urls that you can add here. Check out the [README file" +" here for an overview](https://github.com/patrick91/links-demo)." msgstr "" -"ここに追加できるURLは他にもたくさんある。 " -"[概要についてはこちらのREADMEファイル](https://github.com/patrick91/links-demo) " -"をチェックしてください。" +"ここに追加できるURLは他にもたくさんある。 [概要についてはこちらのREADMEファイル](https://github.com/patrick91" +"/links-demo) をチェックしてください。" #: ../../tutorials/pyproject-toml.md:575 msgid "Putting it all together - your completed pyproject.toml file" @@ -6625,8 +6665,8 @@ msgstr "すべてをまとめます - 完成したpyproject.tomlファイル" #: ../../tutorials/pyproject-toml.md:577 msgid "" -"Below is an example of a complete `pyproject.toml` file that is commented" -" with all of the sections we discussed above." +"Below is an example of a complete `pyproject.toml` file that is commented " +"with all of the sections we discussed above." msgstr "以下は、上で説明したすべてのセクションがコメントされた `pyproject.toml` ファイルの完全な例です。" #: ../../tutorials/pyproject-toml.md @@ -6645,8 +6685,8 @@ msgstr "例 `pyproject.toml` ファイル" #: ../../tutorials/pyproject-toml.md:694 msgid "" -"Below are some examples of `pyproject.toml` files from various packages " -"in the scientific and pyOpenSci ecosystem." +"Below are some examples of `pyproject.toml` files from various packages in " +"the scientific and pyOpenSci ecosystem." msgstr "以下は、scientificとpyOpenSciエコシステムの様々なパッケージの `pyproject.toml` ファイルの例です。" #: ../../tutorials/pyproject-toml.md:695 @@ -6683,9 +6723,7 @@ msgstr "" "ファイルは、人々があなたのソフトウェアをどのように使用できるか、また使用できないかに関する法的な境界線を提供します。" #: ../../tutorials/pyproject-toml.md:708 -msgid "" -"You also learned [how to publish your package to (test)PyPI](publish-" -"pypi)." +msgid "You also learned [how to publish your package to (test)PyPI](publish-pypi)." msgstr "また、 [パッケージを(test)PyPIに公開する方法](publish-pypi) も学びました。" #: ../../tutorials/pyproject-toml.md:710 @@ -6694,9 +6732,9 @@ msgstr "新しいバージョンのパッケージをPyPIに公開する" #: ../../tutorials/pyproject-toml.md:712 msgid "" -"You are now ready to publish a new version of your Python package to " -"(test) PyPI. When you do this you will see that the landing page for your" -" package now contains a lot more information." +"You are now ready to publish a new version of your Python package to (test)" +" PyPI. When you do this you will see that the landing page for your package" +" now contains a lot more information." msgstr "" "これで、Pythonパッケージの新しいバージョンを(test)PyPIに公開する準備ができました。 " "そうすると、パッケージのランディングページに、より多くの情報が掲載されていることがわかります。" @@ -6709,9 +6747,7 @@ msgstr "今すぐ再公開を試みます。" msgid "" "First, update the version of your package in your pyproject toml file. " "Below version is updated from `0.1` to `0.1.1`." -msgstr "" -"まず、pyprojectのtomlファイルでパッケージのバージョンを更新します。以下のバージョンが `0.1` から `0.1.1` " -"に更新されました。" +msgstr "まず、pyprojectのtomlファイルでパッケージのバージョンを更新します。以下のバージョンが `0.1` から `0.1.1` に更新されました。" #: ../../tutorials/pyproject-toml.md:729 msgid "Now use hatch to publish the new version of your package to test.PyPI.org." @@ -6729,9 +6765,9 @@ msgstr "これであなたのパッケージをPyPIに公開するために必 #: ../../tutorials/pyproject-toml.md:741 msgid "" -"If you also want to publish your package on conda-forge (which is a " -"channel within the conda ecosystem), you will learn how to do that in the" -" next lesson." +"If you also want to publish your package on conda-forge (which is a channel" +" within the conda ecosystem), you will learn how to do that in the next " +"lesson." msgstr "あなたのパッケージを(condaエコシステム内のチャンネルである)conda-forgeで公開したい場合 、 その方法は次のレッスンで学びます。" #: ../../tutorials/pyproject-toml.md:745 @@ -6740,29 +6776,31 @@ msgid "" "https://daniel.feldroy.com/posts/2023-08-pypi-project-urls-cheatsheet " "useful (and the linked links-demo even more so)" msgstr "" -"jeremiah からの本当に良い情報源 https://daniel.feldroy.com/posts/2023-08-pypi-" -"project-urls-cheatsheet が役に立ちます (リンク先のデモはなおさら)。" +"jeremiah からの本当に良い情報源 https://daniel.feldroy.com/posts/2023-08-pypi-project-" +"urls-cheatsheet が役に立ちます (リンク先のデモはなおさら)。" #: ../../tutorials/pyproject-toml.md:385 msgid "" -"Some packaging tools will do this for you when you add a dependency using" -" their cli interface. For example [`poetry add`](https://python-" +"Some packaging tools will do this for you when you add a dependency using " +"their cli interface. For example [`poetry add`](https://python-" "poetry.org/docs/cli/#add) will add the most recent version with a `^` " "specifier, and [`pdm add`](https://pdm-" "project.org/latest/reference/cli/#add) will add the most recent version " "with `>=`." msgstr "" -"パッケージングツールの中には、cliインターフェイスを使って依存関係を追加するときに、これをやってくれるものもあります。 例えば、 " -"[`poetry add`](https://python-poetry.org/docs/cli/#add) は `^` " -"指定子で最新バージョンを追加し、 [`pdm add`](https://pdm-" -"project.org/latest/reference/cli/#add) は `>=` 指定子で最新バージョンを追加します。" +"パッケージングツールの中には、cliインターフェイスを使って依存関係を追加するときに、これをやってくれるものもあります。 例えば、 [`poetry " +"add`](https://python-poetry.org/docs/cli/#add) は `^` 指定子で最新バージョンを追加し、 [`pdm" +" add`](https://pdm-project.org/latest/reference/cli/#add) は `>=` " +"指定子で最新バージョンを追加します。" #: ../../tutorials/run-python-scripts-hatch.md:10 msgid "" -"Python supports inline metadata for scripts (a feature added in 2024). " -"This makes it possible to run standalone scripts with dependencies and " -"Python versions managed automatically." +"Python supports inline metadata for scripts (a feature added in 2024). This" +" makes it possible to run standalone scripts with dependencies and Python " +"versions managed automatically." msgstr "" +"Pythonは、スクリプトのインラインメタデータをサポートしています（ " +"2024年に追加された機能）。これにより、依存関係とPythonバージョンを自動的に管理するスタンドアロンスクリプトを実行できます。" #: ../../tutorials/run-python-scripts-hatch.md:14 #, python-brace-format @@ -6771,38 +6809,43 @@ msgid "" "hatch), and {term}`uv`. In this tutorial, we focus on Hatch and UV. The " "same metadata format can also be used with other tools." msgstr "" +"PDM、[Hatch ]（ get - to - know - hatch ）、{term} " +"`uv`など、多くのツールがこのワークフローをサポートしています。このチュートリアルでは、HatchとUVに焦点を当てます。同じメタデータ形式を他のツールで使用することもできます。" #: ../../tutorials/run-python-scripts-hatch.md:22 msgid "" -"[Hatch: How to run Python scripts](https://hatch.pypa.io/latest/how-" -"to/run/python-scripts/)" +"[Hatch: How to run Python scripts](https://hatch.pypa.io/latest/how-to/run" +"/python-scripts/)" msgstr "" +"[Hatch: Pythonスクリプトの実行方法]( https://hatch.pypa.io/latest/how-to/run/python-" +"scripts/)" #: ../../tutorials/run-python-scripts-hatch.md:23 msgid "" -"[uv: Running " -"scripts](https://docs.astral.sh/uv/guides/scripts/#creating-a-python-" -"script)" +"[uv: Running scripts](https://docs.astral.sh/uv/guides/scripts/#creating-a" +"-python-script)" msgstr "" +"[uv:実行中のスクリプト]( https://docs.astral.sh/uv/guides/scripts/#creating-a" +"-python-script)" #: ../../tutorials/run-python-scripts-hatch.md:26 msgid "How to create a reproducible script" -msgstr "" +msgstr "再現可能なスクリプトの作成方法" #: ../../tutorials/run-python-scripts-hatch.md:28 #, python-brace-format msgid "" -"Sometimes you want to share or run a single script without creating a " -"full {term}`Python package`. To do this, you can use inline script " -"metadata. This format lets you specify dependencies and Python versions " -"at the top of your script in a comment block." -msgstr "" +"Sometimes you want to share or run a single script without creating a full " +"{term}`Python package`. To do this, you can use inline script metadata. " +"This format lets you specify dependencies and Python versions at the top of" +" your script in a comment block." +msgstr "完全な{term}「Pythonパッケージ」を作成せずに単一のスクリプトを共有または実行したい場合があります。これを行うには、インラインスクリプトメタデータを使用できます。この形式では、コメントブロック内のスクリプトの上部に依存関係とPythonのバージョンを指定できます。" #: ../../tutorials/run-python-scripts-hatch.md:34 msgid "" -"When you add metadata at the top of a script, Hatch (or PDM or uv) will " -"use that metadata to:" -msgstr "" +"When you add metadata at the top of a script, Hatch (or PDM or uv) will use" +" that metadata to:" +msgstr "スクリプトの上部にメタデータを追加すると、Hatch （またはPDMまたはUV ）はそのメタデータを使用して次のことを行います。" #: ../../tutorials/run-python-scripts-hatch.md:37 #, fuzzy @@ -6811,20 +6854,18 @@ msgstr "使用したいPython環境をアクティブにします。" #: ../../tutorials/run-python-scripts-hatch.md:38 #, python-brace-format -msgid "" -"Install the {term}`Dependencies` listed in the script into that " -"environment." -msgstr "" +msgid "Install the {term}`Dependencies` listed in the script into that environment." +msgstr "スクリプトに記載されている{term} `依存関係`をその環境にインストールします。" #: ../../tutorials/run-python-scripts-hatch.md:39 msgid "Use the required Python version that you specify in the metadata." -msgstr "" +msgstr "メタデータで指定した必要なPythonバージョンを使用します。" #: ../../tutorials/run-python-scripts-hatch.md:41 msgid "" -"This approach is useful for workflows that you want to make reproducible," -" but that do not need to become full Python packages." -msgstr "" +"This approach is useful for workflows that you want to make reproducible, " +"but that do not need to become full Python packages." +msgstr "このアプローチは、再現可能にしたいが、完全なPythonパッケージになる必要のないワークフローに役立ちます。" #: ../../tutorials/run-python-scripts-hatch.md:44 #, fuzzy @@ -6837,113 +6878,120 @@ msgid "" "script without manually creating a new environment or guessing which " "dependencies it needs. Hatch takes care of installing dependencies and " "using the correct Python version." -msgstr "" +msgstr "インラインメタデータは、スクリプトを再現可能にするのに役立ちます。新しい環境を手動で作成したり、必要な依存関係を推測したりすることなく、誰でもスクリプトを実行できます。Hatchは、依存関係のインストールと正しいPythonバージョンの使用を担当します。" #: ../../tutorials/run-python-scripts-hatch.md:51 msgid "How to add inline metadata to your script" -msgstr "" +msgstr "スクリプトにインラインメタデータを追加する方法" #: ../../tutorials/run-python-scripts-hatch.md:53 msgid "" -"You will use Hatch in this example, but you can also use uv if that is " -"your preferred tool." -msgstr "" +"You will use Hatch in this example, but you can also use uv if that is your" +" preferred tool." +msgstr "この例ではHatchを使用しますが、好みのツールであればUVを使用することもできます。" #: ../../tutorials/run-python-scripts-hatch.md:56 #, python-brace-format msgid "" -"First, create a new file named `script.py` with the block below at the " -"top. The metadata block starts with `# /// script` and ends with `# ///`." -" Everything in between must be {term}`TOML` metadata written as comments." +"First, create a new file named `script.py` with the block below at the top." +" The metadata block starts with `# /// script` and ends with `# ///`. " +"Everything in between must be {term}`TOML` metadata written as comments." msgstr "" +"まず、上部に以下のブロックを持つ「script.py」という名前の新しいファイルを作成します。メタデータブロックは'#/// script " +"`で始まり、'#////'で終わります。その間のすべては、コメントとして書かれた{term}` TOML 'メタデータでなければなりません。" #: ../../tutorials/run-python-scripts-hatch.md:60 msgid "" -"In the example below, the script requires Python 3.11 or newer, and NumPy" -" is declared as a dependency." -msgstr "" +"In the example below, the script requires Python 3.11 or newer, and NumPy " +"is declared as a dependency." +msgstr "以下の例では、スクリプトにはPython 3.11以降が必要であり、NumPyは依存関係として宣言されています。" #: ../../tutorials/run-python-scripts-hatch.md:81 msgid "Run the script with Hatch" -msgstr "" +msgstr "Hatchでスクリプトを実行する" #: ../../tutorials/run-python-scripts-hatch.md:83 msgid "" "Open your terminal and change to the directory where `script.py` lives. " "Then run:" -msgstr "" +msgstr "ターミナルを開き、`script.py`が存在するディレクトリに変更します。次に次を実行します。" #: ../../tutorials/run-python-scripts-hatch.md:90 msgid "" -"On first run, Hatch will create an environment and install dependencies. " -"On later runs, Hatch will reuse that environment so startup is faster." -msgstr "" +"On first run, Hatch will create an environment and install dependencies. On" +" later runs, Hatch will reuse that environment so startup is faster." +msgstr "最初の実行時に、Hatchは環境を作成し、依存関係をインストールします。後で実行すると、Hatchはその環境を再利用するため、起動が速くなります。" #: ../../tutorials/run-python-scripts-hatch.md:94 msgid "" -"The environment name is based on the script path. If you move the script " -"to a new location, Hatch will treat it as a new script environment." -msgstr "" +"The environment name is based on the script path. If you move the script to" +" a new location, Hatch will treat it as a new script environment." +msgstr "環境名は、スクリプトパスに基づいています。スクリプトを新しい場所に移動すると、Hatchは新しいスクリプト環境として扱います。" #: ../../tutorials/run-python-scripts-hatch.md:98 msgid "Optional: configure script environment behavior" -msgstr "" +msgstr "オプション:スクリプト環境の動作を構成する" #: ../../tutorials/run-python-scripts-hatch.md:100 msgid "" -"You can control script-specific Hatch behavior in the same metadata " -"block. For example, to use `pip` instead of `uv` as the installer:" -msgstr "" +"You can control script-specific Hatch behavior in the same metadata block. " +"For example, to use `pip` instead of `uv` as the installer:" +msgstr "同じメタデータブロック内のスクリプト固有のハッチ動作を制御できます。たとえば、インストーラとして'uv'の代わりに`pip`を使用するには、次のようにします。" #: ../../tutorials/run-python-scripts-hatch.md:113 msgid "Run the same script with uv" -msgstr "" +msgstr "UVで同じスクリプトを実行する" #: ../../tutorials/run-python-scripts-hatch.md:115 msgid "If you prefer uv, you can run the same inline-metadata script with:" -msgstr "" +msgstr "UVを好む場合は、次のように同じインラインメタデータスクリプトを実行できます。" #: ../../tutorials/run-python-scripts-hatch.md:121 msgid "" -"The same `# /// script` metadata block works with uv, including " -"`requires-python` and `dependencies`." +"The same `# /// script` metadata block works with uv, including `requires-" +"python` and `dependencies`." msgstr "" +"同じ'#/// script `メタデータブロックは、` requires - python 'や' dependencies " +"`などのuvで動作します。" #: ../../tutorials/run-python-scripts-hatch.md:124 msgid "" -"For more on using uv to run scripts, see the guide: [Running scripts with" -" uv](https://docs.astral.sh/uv/guides/scripts/#creating-a-python-script)." +"For more on using uv to run scripts, see the guide: [Running scripts with " +"uv](https://docs.astral.sh/uv/guides/scripts/#creating-a-python-script)." msgstr "" +"Uvを使用してスクリプトを実行する方法の詳細については、[Running scripts with uv ]( " +"https://docs.astral.sh/uv/guides/scripts/#creating-a-python-" +"script)のガイドを参照してください。" #: ../../tutorials/run-python-scripts-hatch.md:128 msgid "When to use scripts vs. packages" -msgstr "" +msgstr "スクリプトを使用する場合とパッケージを使用する場合" #: ../../tutorials/run-python-scripts-hatch.md:130 msgid "You may be wondering when to use scripts versus creating a package." -msgstr "" +msgstr "パッケージを作成するのではなく、スクリプトを使用するタイミングを考えているかもしれません。" #: ../../tutorials/run-python-scripts-hatch.md:132 msgid "This depends on your use case. Scripts are often useful when:" -msgstr "" +msgstr "これはユースケースによって異なります。スクリプトは、次のような場合に役立つことがよくあります。" #: ../../tutorials/run-python-scripts-hatch.md:134 msgid "You have one small task, or a specific workflow that is not generalizable." -msgstr "" +msgstr "小さなタスクが1つある、または一般化できない特定のワークフローがある。" #: ../../tutorials/run-python-scripts-hatch.md:135 msgid "" -"Your workflow is still evolving, but you want to run it in a reproducible" -" environment." -msgstr "" +"Your workflow is still evolving, but you want to run it in a reproducible " +"environment." +msgstr "ワークフローはまだ進化していますが、再現可能な環境で実行したいと考えています。" #: ../../tutorials/run-python-scripts-hatch.md:137 msgid "You want reproducible dependencies quickly." -msgstr "" +msgstr "再現性のある依存関係をすばやく必要としています。" #: ../../tutorials/run-python-scripts-hatch.md:138 msgid "You are sharing a single file with collaborators." -msgstr "" +msgstr "コラボレーターと1つのファイルを共有しています。" #: ../../tutorials/run-python-scripts-hatch.md:140 #, fuzzy @@ -6952,15 +7000,15 @@ msgstr "なぜPythonパッケージを作るのか？" #: ../../tutorials/run-python-scripts-hatch.md:142 msgid "You are building reusable modules for multiple projects." -msgstr "" +msgstr "複数のプロジェクト用に再利用可能なモジュールを構築しています。" #: ../../tutorials/run-python-scripts-hatch.md:143 msgid "You need tests, documentation, releases, and long-term maintenance." -msgstr "" +msgstr "テスト、ドキュメント、リリース、長期メンテナンスが必要です。" #: ../../tutorials/run-python-scripts-hatch.md:144 msgid "Your codebase is growing beyond one or two scripts." -msgstr "" +msgstr "コードベースは、1つまたは2つのスクリプトを超えて拡大しています。" #: ../../tutorials/run-python-scripts-hatch.md:148 #, fuzzy @@ -6996,15 +7044,15 @@ msgstr "注釈" #: ../../tutorials/setup-py-to-pyproject-toml.md:16 #, fuzzy msgid "" -"This step is not necessary and is only helpful if your project already " -"has a `setup.py` file defined." +"This step is not necessary and is only helpful if your project already has " +"a `setup.py` file defined." msgstr "このステップは必要なく、プロジェクトに既に `setup.py` ファイルが定義されている場合にのみ有用です。" #: ../../tutorials/setup-py-to-pyproject-toml.md:17 #, fuzzy msgid "" -"If your project does not already define a `setup.py` see [Make your " -"Python code installable](create-python-package)" +"If your project does not already define a `setup.py` see [Make your Python " +"code installable](create-python-package)" msgstr "" "プロジェクトで `setup.py` が定義されていない場合は、 [Python コードをインストール可能にする](installable-" "code.md) を参照してください。" @@ -7031,8 +7079,8 @@ msgid "" "publishing packages to repositories like [PyPI](publish-pypi)." msgstr "" "HatchはPythonパッケージマネージャで、Pythonパッケージの作成、管理、配布のプロセスを効率化するように設計されています。 " -"新しいプロジェクトの作成、依存関係の管理、ディストリビューションのビルド、PyPI " -"のようなリポジトリへのパッケージの公開といったタスクのための便利な CLI (Command-Line Interface) を提供します。" +"新しいプロジェクトの作成、依存関係の管理、ディストリビューションのビルド、PyPI のようなリポジトリへのパッケージの公開といったタスクのための便利な" +" CLI (Command-Line Interface) を提供します。" #: ../../tutorials/setup-py-to-pyproject-toml.md:40 #, fuzzy @@ -7045,8 +7093,8 @@ msgstr "前提条件" #: ../../tutorials/setup-py-to-pyproject-toml.md:45 msgid "" -"Before we begin, ensure that you have Hatch installed on your system. You" -" can install it via pip:" +"Before we begin, ensure that you have Hatch installed on your system. You " +"can install it via pip:" msgstr "始める前に、システムにHatchがインストールされていることを確認してください。pipでインストールできます:" #: ../../tutorials/setup-py-to-pyproject-toml.md:51 @@ -7069,8 +7117,8 @@ msgstr "`hatch init` 後" #: ../../tutorials/setup-py-to-pyproject-toml.md:89 msgid "" -"As you can see, the main change after running `hatch init` is the " -"addition of the `pyproject.toml` file in the project directory." +"As you can see, the main change after running `hatch init` is the addition " +"of the `pyproject.toml` file in the project directory." msgstr "" "ご覧のように、 `hatch init` を実行した後の主な変化は、プロジェクトディレクトリに `pyproject.toml` " "ファイルが追加されたことです。" @@ -7081,21 +7129,20 @@ msgstr "ステップバイステップガイド" #: ../../tutorials/setup-py-to-pyproject-toml.md:93 msgid "" -"Now, let's walk through the steps to use Hatch to create a " -"`pyproject.toml` file for your project." +"Now, let's walk through the steps to use Hatch to create a `pyproject.toml`" +" file for your project." msgstr "では、Hatchを使ってプロジェクトの `pyproject.toml` ファイルを作成する手順を説明しましょう。" #: ../../tutorials/setup-py-to-pyproject-toml.md:95 msgid "" "**Navigate to Your Project Directory**: Open your terminal or command " -"prompt and navigate to the directory where your Python project is " -"located." +"prompt and navigate to the directory where your Python project is located." msgstr "**プロジェクトディレクトリに移動する**: ターミナルかコマンドプロンプトを開き、Pythonプロジェクトがあるディレクトリに移動します。" #: ../../tutorials/setup-py-to-pyproject-toml.md:97 msgid "" -"**Initialize Hatch**: Run the following command to initialize Hatch in " -"your project directory:" +"**Initialize Hatch**: Run the following command to initialize Hatch in your" +" project directory:" msgstr "**Hatchの初期化**: 以下のコマンドを実行し、プロジェクトディレクトリのHatchを初期化します:" #: ../../tutorials/setup-py-to-pyproject-toml.md:103 @@ -7104,10 +7151,9 @@ msgid "" "**Review and Customize**: After running the previous command, Hatch will " "automatically generate a `pyproject.toml` file based on your existing " "project configuration. Take some time to review the contents of the " -"generated `pyproject.toml` file. You may want to customize certain " -"settings or dependencies based on your project's requirements (see " -"[pyproject.toml tutorial](pyproject-toml) for more information about the " -"`pyproject.toml`)." +"generated `pyproject.toml` file. You may want to customize certain settings" +" or dependencies based on your project's requirements (see [pyproject.toml " +"tutorial](pyproject-toml) for more information about the `pyproject.toml`)." msgstr "" "**レビューとカスタマイズ**: 先ほどのコマンドを実行すると、Hatchは既存のプロジェクト構成に基づいて `pyproject.toml` " "ファイルを自動的に生成します。 生成された `pyproject.toml` " @@ -7118,9 +7164,9 @@ msgstr "" #: ../../tutorials/setup-py-to-pyproject-toml.md:105 #, fuzzy msgid "" -"**Verify**: Verify that the `pyproject.toml` file accurately reflects " -"your project configuration and dependencies. You can manually edit the " -"file, but be cautious and ensure that the syntax is correct." +"**Verify**: Verify that the `pyproject.toml` file accurately reflects your " +"project configuration and dependencies. You can manually edit the file, but" +" be cautious and ensure that the syntax is correct." msgstr "" "**検証**: `pyproject.toml` ファイルがプロジェクト構成と依存関係を正確に反映していることを確認します。 " "必要であればファイルを手動で編集することもできますが、慎重を期して構文が正しいことを確認してください。" @@ -7128,8 +7174,8 @@ msgstr "" #: ../../tutorials/setup-py-to-pyproject-toml.md:107 msgid "" "**Delete setup.py**: Since we're migrating to using `pyproject.toml` " -"exclusively, the `setup.py` file becomes unnecessary. You can safely " -"delete it from your project directory." +"exclusively, the `setup.py` file becomes unnecessary. You can safely delete" +" it from your project directory." msgstr "" "**setup.py を削除する**: `pyproject.toml` のみを使用するように移行するので、 `setup.py` " "ファイルは不要になります。 プロジェクトディレクトリから安全に削除できます。" @@ -7137,8 +7183,8 @@ msgstr "" #: ../../tutorials/setup-py-to-pyproject-toml.md:109 msgid "" "**Test Build**: Before proceeding further, it's essential to ensure that " -"your project builds successfully using only the `pyproject.toml` file. " -"Run the following command to build your project:" +"your project builds successfully using only the `pyproject.toml` file. Run " +"the following command to build your project:" msgstr "" "**テストビルド**: 先に進む前に、 `pyproject.toml` " "ファイルだけを使ってプロジェクトが正常にビルドされることを確認する必要がある。 以下のコマンドを実行してプロジェクトをビルドします:" @@ -7146,18 +7192,18 @@ msgstr "" #: ../../tutorials/setup-py-to-pyproject-toml.md:115 msgid "" "This command will build your project based on the specifications in the " -"`pyproject.toml` file. Make sure to check for any errors or warnings " -"during the build process." +"`pyproject.toml` file. Make sure to check for any errors or warnings during" +" the build process." msgstr "" "このコマンドは `pyproject.toml` ファイルの仕様に基づいてプロジェクトをビルドします。 " "ビルドの過程でエラーや警告がないか、必ず確認してください。" #: ../../tutorials/setup-py-to-pyproject-toml.md:117 msgid "" -"**Test Existing Functionality**: After successfully building your project" -" with `pyproject.toml`, it's crucial to ensure that your project's " -"existing functionality remains intact. Run any pre-existing tests to " -"verify that everything still works as expected." +"**Test Existing Functionality**: After successfully building your project " +"with `pyproject.toml`, it's crucial to ensure that your project's existing " +"functionality remains intact. Run any pre-existing tests to verify that " +"everything still works as expected." msgstr "" "**既存機能のテスト**: `pyproject.toml` でプロジェクトのビルドに成功したら、 " "プロジェクトの既存の機能が損なわれないようにすることが重要です。既存のテストを実行し、すべてが期待通りに動作することを確認します。" @@ -7166,7 +7212,7 @@ msgstr "" msgid "" "Setup Trusted Publishing for secure and automated publishing via GitHub " "Actions" -msgstr "" +msgstr "GitHubアクションを介した安全で自動化された発行のための信頼された発行の設定" #: ../../tutorials/trusted-publishing.md:8 #, fuzzy @@ -7181,8 +7227,8 @@ msgstr "[コードをインストール可能にする](create-python-package)" #: ../../tutorials/trusted-publishing.md:11 #, fuzzy msgid "" -"How to publish the code to [PyPI](publish-pypi) and [Conda](publish-" -"conda-forge)" +"How to publish the code to [PyPI](publish-pypi) and [Conda](publish-conda-" +"forge)" msgstr "[パッケージをconda-forgeに公開する方法](publish-conda-forge.md)" #: ../../tutorials/trusted-publishing.md:16 @@ -7192,51 +7238,57 @@ msgstr "このレッスンで学ぶこと:" #: ../../tutorials/trusted-publishing.md:18 msgid "Automate building and publishing the package on GitHub Actions" -msgstr "" +msgstr "GitHubアクションでパッケージの構築と公開を自動化する" #: ../../tutorials/trusted-publishing.md:19 #, python-brace-format msgid "Configure {term}`Trusted publishing` for the project" -msgstr "" +msgstr "プロジェクトの{term}「信頼できる発行」を構成する" #: ../../tutorials/trusted-publishing.md:20 msgid "" "Secure your workflow using GitHub action hashes and versions in your " "workflow file" -msgstr "" +msgstr "ワークフローファイル内のGitHubアクションハッシュとバージョンを使用してワークフローを保護する" #: ../../tutorials/trusted-publishing.md:22 msgid "" "This tutorial assumes that your project is hosted on GitHub and that you " "want to publish a package from your project to PyPI." -msgstr "" +msgstr "このチュートリアルでは、プロジェクトがGitHubでホストされており、プロジェクトからPyPIにパッケージを公開することを前提としています。" #: ../../tutorials/trusted-publishing.md:26 msgid "Configure a release job on GitHub Actions" -msgstr "" +msgstr "GitHubアクションでリリースジョブを構成する" #: ../../tutorials/trusted-publishing.md:28 msgid "" "GitHub Actions[^gha] is an infrastructure provided by GitHub to automate " -"software workflows, straight from the GitHub repository of the project. " -"You can configure automated testing for every pull request, automate " +"software workflows, straight from the GitHub repository of the project. You" +" can configure automated testing for every pull request, automate " "publishing of documentation, automate creation of web pages for the " "project, and even automate the release process. For this lesson, we will " -"focus on using actions to release and publish your Python package " -"securely to [PyPI](publish-pypi)." +"focus on using actions to release and publish your Python package securely " +"to [PyPI](publish-pypi)." msgstr "" +"GitHubアクション[^ " +"gha]は、プロジェクトのGitHubリポジトリから直接、ソフトウェアワークフローを自動化するためにGitHubが提供するインフラストラクチャです。プルリクエストごとに自動テストを構成したり、ドキュメントの公開を自動化したり、プロジェクトのWebページの作成を自動化したり、リリースプロセスを自動化したりできます。このレッスンでは、Pythonパッケージを[PyPI" +" ]( publish - pypi)に安全にリリースして公開するためのアクションの使用に焦点を当てます。" #: ../../tutorials/trusted-publishing.md:36 msgid "Why Trusted Publishing Matters" -msgstr "" +msgstr "信頼できる出版が重要な理由" #: ../../tutorials/trusted-publishing.md:38 msgid "" "If you are wondering why trusted publishing is so important, [check out " -"this blog post:](https://www.pyopensci.org/blog/python-packaging-" -"security-publish-pypi.html) that dives deeper into what can happen when " -"you don't lock down your publishing workflows." +"this blog post:](https://www.pyopensci.org/blog/python-packaging-security-" +"publish-pypi.html) that dives deeper into what can happen when you don't " +"lock down your publishing workflows." msgstr "" +"信頼できるパブリッシングがなぜそれほど重要なのか疑問に思っている方は、[こちらのブログ記事をご覧ください：]( " +"https://www.pyopensci.org/blog/python-packaging-security-publish-" +"pypi.html)をご覧ください。この記事では、パブリッシングワークフローをロックしないと何が起こるかについて詳しく説明します。" #: ../../tutorials/trusted-publishing.md:41 #, fuzzy @@ -7246,15 +7298,18 @@ msgstr "ステップ0: READMEファイルの作成" #: ../../tutorials/trusted-publishing.md:43 msgid "" "To get started, create a file named `release.yaml` under the " -"`.github/workflows` directory of your project. If the `.github/workflows`" -" directory does not exist, you can create it. It is GitHub's convention " -"that all GitHub Actions are configured via YAML files in the " +"`.github/workflows` directory of your project. If the `.github/workflows` " +"directory does not exist, you can create it. It is GitHub's convention that" +" all GitHub Actions are configured via YAML files in the " "`.github/workflows` directory." msgstr "" +"開始するには、プロジェクトの'.github/workflows `ディレクトリの下に` release.yaml " +"'という名前のファイルを作成します。'.github/workflows`ディレクトリが存在しない場合は、作成できます。すべてのGitHubアクションは、'.github/workflows" +" `ディレクトリのYAMLファイルを介して構成されることがGitHubの規則です。" #: ../../tutorials/trusted-publishing.md:48 msgid "Naming your workflow file" -msgstr "" +msgstr "ワークフローファイルに名前を付ける" #: ../../tutorials/trusted-publishing.md:51 msgid "" @@ -7262,11 +7317,11 @@ msgid "" "something simple and expressive like `release.yaml` so you, your future " "self, and contributors who work on your project know exactly what the " "workflow does." -msgstr "" +msgstr "ワークフローファイルには任意の名前を付けることができます。「release.yaml」のようなシンプルで表現力豊かなものを使用することをおすすめします。そうすれば、あなた自身、あなたの将来の自分、そしてあなたのプロジェクトに取り組むコントリビューターは、ワークフローが何をしているのかを正確に知ることができます。" #: ../../tutorials/trusted-publishing.md:56 msgid "Step 1: Name the workflow" -msgstr "" +msgstr "ステップ1 ：ワークフローに名前を付ける" #: ../../tutorials/trusted-publishing.md:58 #, fuzzy @@ -7275,21 +7330,19 @@ msgstr "`README.md` ファイルの先頭に、パッケージ名を追加しま #: ../../tutorials/trusted-publishing.md:64 msgid "" -"This provides a name to the workflow that you can use to quickly find all" -" runs of this GitHub Action on the \"Actions\" tab in the GitHub " -"repository." -msgstr "" +"This provides a name to the workflow that you can use to quickly find all " +"runs of this GitHub Action on the \"Actions\" tab in the GitHub repository." +msgstr "これにより、GitHubリポジトリの[アクション]タブでこのGitHubアクションのすべての実行をすばやく見つけるために使用できるワークフローの名前が提供されます。" #: ../../tutorials/trusted-publishing.md:68 msgid "" -"Graphic showing an example of a configured workflow for the release. On " -"the top, in the red box labeled \"1\" you see the \"Actions\" tab of the " +"Graphic showing an example of a configured workflow for the release. On the" +" top, in the red box labeled \"1\" you see the \"Actions\" tab of the " "GitHub repository. On the left, in the red box labeled \"2\" you can see " -"the name of the workflow, \"Release,\" as configured in this step. " -"Finally, in the center, in the red box labeled \"3\" you can see several " -"runs of the workflow, for the \"1.0\" and \"1.0.1\" releases of the " -"package." -msgstr "" +"the name of the workflow, \"Release,\" as configured in this step. Finally," +" in the center, in the red box labeled \"3\" you can see several runs of " +"the workflow, for the \"1.0\" and \"1.0.1\" releases of the package." +msgstr "リリース用に構成されたワークフローの例を示す図。上部の「1」という赤いボックスには、GitHubリポジトリの「アクション」タブが表示されます。左側の「2」という赤いボックスには、この手順で設定したワークフローの名前「Release」が表示されます。最後に、中央の「3」という赤いボックスには、パッケージの「1.0」および「1.0.1」リリースのワークフローのいくつかの実行が表示されます。" #: ../../tutorials/trusted-publishing.md:70 msgid "" @@ -7299,35 +7352,41 @@ msgid "" "the name of the workflow, as configured in this step. Finally, in the " "center, in the red box labeled \"3\" you can see several runs of the " "workflow, for the \"1.0\" and \"1.0.1\" releases of the package." -msgstr "" +msgstr "この画像は、リリース用に構成されたワークフローの例を示しています。上部の「1」という赤いボックスには、GitHubリポジトリの「アクション」タブが表示されます。左側の「2」という赤いボックスには、この手順で設定したワークフローの名前が表示されます。最後に、中央の「3」という赤いボックスには、パッケージの「1.0」および「1.0.1」リリースのワークフローのいくつかの実行が表示されます。" #: ../../tutorials/trusted-publishing.md:73 msgid "Step 2: Add triggers to the workflow" -msgstr "" +msgstr "ステップ2 ：ワークフローにトリガーを追加する" #: ../../tutorials/trusted-publishing.md:75 msgid "" "Every GitHub Actions workflow runs when [certain " "conditions](https://docs.github.com/en/actions/reference/events-that-" -"trigger-workflows) are met. In this case, we assume that a release " -"workflow should only run when the repository owner creates a new " +"trigger-workflows) are met. In this case, we assume that a release workflow" +" should only run when the repository owner creates a new " "[release](https://docs.github.com/en/repositories/releasing-projects-on-" "github/managing-releases-in-a-repository) for the package. Add the " -"following to the `release.yaml` file to ensure it runs when you create " -"and publish a release:" +"following to the `release.yaml` file to ensure it runs when you create and " +"publish a release:" msgstr "" +"すべてのGitHubアクションワークフローは、[特定の条件]( " +"https://docs.github.com/en/actions/reference/events-that-trigger-" +"workflows)が満たされたときに実行されます。この場合、リリースワークフローは、リポジトリの所有者がパッケージの新しい[リリース]( " +"https://docs.github.com/en/repositories/releasing-projects-on-github" +"/managing-releases-" +"in-a-repository)を作成したときにのみ実行する必要があると想定しています。リリースを作成して公開するときに実行されることを確認するために、`release.yaml`ファイルに次のものを追加します。" #: ../../tutorials/trusted-publishing.md:87 msgid "Step 3: Configure the jobs in the workflow" -msgstr "" +msgstr "ステップ3 ：ワークフローのジョブを構成する" #: ../../tutorials/trusted-publishing.md:89 msgid "" "A GitHub Actions *workflow* file can contain multiple *jobs* that run " -"independently; each job can also have multiple *steps.* When triggered, " -"the GitHub Action runs all the jobs in a workflow (excluding any steps " -"that have conditional requirements)." -msgstr "" +"independently; each job can also have multiple *steps.* When triggered, the" +" GitHub Action runs all the jobs in a workflow (excluding any steps that " +"have conditional requirements)." +msgstr "GitHubアクション*ワークフロー*ファイルには、独立して実行される複数の*ジョブ*を含めることができます。各ジョブには複数の*ステップを含めることもできます。*トリガーされると、GitHubアクションはワークフロー内のすべてのジョブを実行します（条件付き要件を持つステップを除く）。" #: ../../tutorials/trusted-publishing.md:93 msgid "" @@ -7335,96 +7394,110 @@ msgid "" "logic](https://docs.github.com/en/actions/reference/workflow-syntax-for-" "github-actions#jobsjob_idif) that allows them only to run if specific " "criteria exist. For instance, you may want only to have a job step to " -"publish to PyPI if a release was made for the package. But you might want" -" to test building the package every time you merge a new pull request." +"publish to PyPI if a release was made for the package. But you might want " +"to test building the package every time you merge a new pull request." msgstr "" +"ジョブとステップは、特定の基準が存在する場合にのみ実行できる[条件付きロジック]( " +"https://docs.github.com/en/actions/reference/workflow-syntax-for-github-" +"actions#jobsjob_idif)を持つこともできます。たとえば、パッケージのリリースが行われた場合にのみ、PyPIに公開するジョブステップが必要な場合があります。ただし、新しいプルリクエストをマージするたびに、パッケージの構築をテストすることをお勧めします。" #: ../../tutorials/trusted-publishing.md:96 msgid "" -"For a release job, you need to clone or check out the repository. You can" -" use the `actions/checkout` action to check out the code. You then " -"install and use [Hatch](get-to-know-hatch) to build your package." +"For a release job, you need to clone or check out the repository. You can " +"use the `actions/checkout` action to check out the code. You then install " +"and use [Hatch](get-to-know-hatch) to build your package." msgstr "" +"リリースジョブの場合は、リポジトリのクローンを作成するか、チェックアウトする必要があります。「アクション/チェックアウト」アクションを使用して、コードをチェックアウトできます。次に、[Hatch" +" ]（ get - to - know - hatch ）をインストールして使用し、パッケージを構築します。" #: ../../tutorials/trusted-publishing.md:101 msgid "" -"You also need to make sure to set up Hatch on the machine GitHub is using" -" to run the workflow." -msgstr "" +"You also need to make sure to set up Hatch on the machine GitHub is using " +"to run the workflow." +msgstr "また、ワークフローを実行するためにGitHubが使用しているマシンでHatchを設定する必要があります。" #: ../../tutorials/trusted-publishing.md:104 msgid "A minimal job definition would look like this:" -msgstr "" +msgstr "最小限のジョブ定義は次のようになります。" #: ../../tutorials/trusted-publishing.md:124 msgid "" "Notice that above, you provide a version for each action step. " -"`action/checkout@v5` tells GitHub to use version 5 of the checkout " -"action. The checkout action checks out the code from your repository. In " -"this case, the code will be used to build your package." +"`action/checkout@v5` tells GitHub to use version 5 of the checkout action. " +"The checkout action checks out the code from your repository. In this case," +" the code will be used to build your package." msgstr "" +"上記では、各アクションステップのバージョンを指定しています。`action/checkout @ v " +"5`は、GitHubにチェックアウトアクションのバージョン5を使用するように指示します。チェックアウトアクションは、リポジトリからコードをチェックアウトします。この場合、コードはパッケージのビルドに使用されます。" #: ../../tutorials/trusted-publishing.md:126 msgid "" "Next, you will learn about a better way to secure (or \"harden\") your " "workflow" -msgstr "" +msgstr "次に、ワークフローを保護（または「強化」）するためのより良い方法について学びます" #: ../../tutorials/trusted-publishing.md:128 msgid "Step 4: Secure the GitHub Actions workflow" -msgstr "" +msgstr "ステップ4 ： GitHub Actionsワークフローを保護する" #: ../../tutorials/trusted-publishing.md:130 msgid "" -"There are several improvements you can make to the GitHub Actions " -"workflow you just configured to improve security and readability." -msgstr "" +"There are several improvements you can make to the GitHub Actions workflow " +"you just configured to improve security and readability." +msgstr "セキュリティと読みやすさを向上させるために構成したGitHubアクションワークフローには、いくつかの改善点があります。" #: ../../tutorials/trusted-publishing.md:133 msgid "" -"First, we can give names to relevant steps in the process to increase the" -" readability of the logs generated during the workflow run. This can be " +"First, we can give names to relevant steps in the process to increase the " +"readability of the logs generated during the workflow run. This can be " "achieved using `name: ` lines." msgstr "" +"まず、ワークフロー実行中に生成されたログの読みやすさを高めるために、プロセスの関連ステップに名前を付けることができます。これは、`name :'行を使用して達成できます。" #: ../../tutorials/trusted-publishing.md:137 msgid "" "More importantly, each time you use an existing action (via `uses`) you " -"should pin that action to a commit hash. Pinning your action ensures that" -" if a malicious user takes over the action, they won't be able to impact " -"your repository (an example of a supply chain attack due to GitHub " -"Actions is the recent `tj-actions/changed-files` attack[^changed-files-" -"supply-chain-attack])." +"should pin that action to a commit hash. Pinning your action ensures that " +"if a malicious user takes over the action, they won't be able to impact " +"your repository (an example of a supply chain attack due to GitHub Actions " +"is the recent `tj-actions/changed-files` attack[^changed-files-supply-" +"chain-attack])." msgstr "" +"さらに重要なことに、既存のアクションを使用するたびに（「使用」を介して）、そのアクションをコミットハッシュにピン留めする必要があります。アクションを固定すると、悪意のあるユーザーがアクションを引き継いだ場合、リポジトリに影響を与えることはできません（" +" GitHubアクションによるサプライチェーン攻撃の例は、最近の「tj - actions/changed - files」攻撃[^ changed " +"- files - supply - chain - attack]です）。" #: ../../tutorials/trusted-publishing.md:144 msgid "" "Enabling Dependabot[^dependabot] in the repository will ensure that your " -"actions stay up to date. The dependabot tool will open pull requests that" -" update your action versions at whatever frequency you want." +"actions stay up to date. The dependabot tool will open pull requests that " +"update your action versions at whatever frequency you want." msgstr "" +"リポジトリでDependabot [^ " +"dependabot]を有効にすると、アクションが最新の状態に保たれます。dependabotツールは、アクションバージョンを任意の頻度で更新するプルリクエストを開きます。" #: ../../tutorials/trusted-publishing.md:149 msgid "Thus, the workflow that you should use should be similar to:" -msgstr "" +msgstr "したがって、使用すべきワークフローは次のようにする必要があります。" #: ../../tutorials/trusted-publishing.md:157 msgid "" "Now, you can commit the `.github/workflows/release.yaml` file to the " "repository and push to GitHub." -msgstr "" +msgstr "これで、'.github/workflows/release.yaml `ファイルをリポジトリにコミットし、GitHubにプッシュできます。" #: ../../tutorials/trusted-publishing.md:159 msgid "" -"At this point, if you create a new release for your project on GitHub, " -"the configured workflow should run and build a wheel for you. " -"Unfortunately, the wheel is only available on the runner and will be " -"deleted at the end of the workflow run." -msgstr "" +"At this point, if you create a new release for your project on GitHub, the " +"configured workflow should run and build a wheel for you. Unfortunately, " +"the wheel is only available on the runner and will be deleted at the end of" +" the workflow run." +msgstr "この時点で、GitHubでプロジェクトの新しいリリースを作成すると、構成されたワークフローが実行され、ホイールが構築されます。残念ながら、ホイールはランナーでのみ使用でき、ワークフロー実行の最後に削除されます。" #: ../../tutorials/trusted-publishing.md:163 msgid "Step 5: Upload the built artifact to GitHub Artifacts" -msgstr "" +msgstr "ステップ5 ：構築されたアーティファクトをGitHubアーティファクトにアップロードする" #: ../../tutorials/trusted-publishing.md:165 msgid "" @@ -7432,39 +7505,42 @@ msgid "" "the wheel. You will upload it to the artifacts temporary area[^github-" "artifacts]. Add the following to the `release.yaml` file:" msgstr "" +"ホイールにアクセスできるようにするには、ジョブ定義にもう1つステップを追加する必要があります。アーティファクト一時エリア[^ github - " +"artifacts]にアップロードします。次のものを`release.yaml`ファイルに追加します。" #: ../../tutorials/trusted-publishing.md:175 msgid "Upload artifacts parameters" -msgstr "" +msgstr "アーティファクトパラメータのアップロード" #: ../../tutorials/trusted-publishing.md:178 msgid "" "Above, you have configured the artifact to be deleted after 1 day. The " -"artifacts storage on GitHub actions is temporary; users should not " -"download your package from the GitHub artifacts." -msgstr "" +"artifacts storage on GitHub actions is temporary; users should not download" +" your package from the GitHub artifacts." +msgstr "上記では、1日後に削除されるようにアーティファクトを設定しました。GitHubアクション上のアーティファクトストレージは一時的なものです。ユーザーはGitHubアーティファクトからパッケージをダウンロードしないでください。" #: ../../tutorials/trusted-publishing.md:181 msgid "" -"You have also configured the release job to error if the `dist/` " -"directory does not exist. This means that `hatch build` (from the " -"previous step) failed to build our package, so there is nothing to " -"release." +"You have also configured the release job to error if the `dist/` directory " +"does not exist. This means that `hatch build` (from the previous step) " +"failed to build our package, so there is nothing to release." msgstr "" +"また、`dist " +"/'ディレクトリが存在しない場合にエラーが発生するようにリリースジョブを設定しました。これは、（前のステップからの）「ハッチビルド」がパッケージのビルドに失敗したため、リリースするものがないことを意味します。" #: ../../tutorials/trusted-publishing.md:186 msgid "" "At this point, if you push the `release.yaml` to GitHub and create a new " "release, the GitHub Actions job will:" -msgstr "" +msgstr "この時点で、'release.yaml`をGitHubにプッシュして新しいリリースを作成すると、GitHubアクションジョブは次のようになります。" #: ../../tutorials/trusted-publishing.md:189 msgid "run," -msgstr "" +msgstr "hashite" #: ../../tutorials/trusted-publishing.md:190 msgid "clone your repository," -msgstr "" +msgstr "リポジトリのクローンを作成し、" #: ../../tutorials/trusted-publishing.md:191 #, fuzzy @@ -7478,110 +7554,110 @@ msgstr "パッケージをビルドするには `hatch build` を実行します #: ../../tutorials/trusted-publishing.md:193 msgid "upload your package as an archive to the artifacts storage." -msgstr "" +msgstr "パッケージをアーカイブとしてアーティファクトストレージにアップロードします。" #: ../../tutorials/trusted-publishing.md:196 msgid "" "Graphic showing an example of a release workflow that has just finished " "running. Each step in the log is matched to one step in the workflow " "definition." -msgstr "" +msgstr "実行が完了したばかりのリリースワークフローの例を示す図。ログの各ステップは、ワークフロー定義の1つのステップと一致します。" #: ../../tutorials/trusted-publishing.md:198 msgid "" -"This figure shows an example of a release workflow that has just finished" -" running. Each step in the log is matched to one step in the workflow " +"This figure shows an example of a release workflow that has just finished " +"running. Each step in the log is matched to one step in the workflow " "definition." -msgstr "" +msgstr "この図は、実行が完了したばかりのリリースワークフローの例を示しています。ログの各ステップは、ワークフロー定義の1つのステップと一致します。" #: ../../tutorials/trusted-publishing.md:201 msgid "" -"At the bottom of the workflow run page on GitHub, you should see a " -"section for the artifacts produced during runtime and uploaded to this " -"storage area:" -msgstr "" +"At the bottom of the workflow run page on GitHub, you should see a section " +"for the artifacts produced during runtime and uploaded to this storage " +"area:" +msgstr "GitHubのワークフロー実行ページの下部に、実行時に生成され、このストレージ領域にアップロードされたアーティファクトのセクションが表示されます。" #: ../../tutorials/trusted-publishing.md:205 -msgid "" -"Graphic showing an example of an artifact produced by the release " -"workflow." -msgstr "" +msgid "Graphic showing an example of an artifact produced by the release workflow." +msgstr "リリースワークフローによって生成されたアーティファクトの例を示す図。" #: ../../tutorials/trusted-publishing.md:207 msgid "" -"This figure shows the artifact produced by the above release workflow. It" -" is now marked as expired since the workflow ran more than a day ago." -msgstr "" +"This figure shows the artifact produced by the above release workflow. It " +"is now marked as expired since the workflow ran more than a day ago." +msgstr "この図は、上記のリリースワークフローによって生成されたアーティファクトを示しています。1日以上前にワークフローが実行されたため、期限切れとしてマークされました。" #: ../../tutorials/trusted-publishing.md:210 msgid "" "You can download the artifact (before it expires), unzip it, and install " -"the wheel contained within. However, this should only be done if you want" -" to test the built wheel. Next, you will configure uploading to PyPI " -"using trusted publishing." -msgstr "" +"the wheel contained within. However, this should only be done if you want " +"to test the built wheel. Next, you will configure uploading to PyPI using " +"trusted publishing." +msgstr "アーティファクトを（期限が切れる前に）ダウンロードし、解凍して、中に入っているホイールを取り付けることができます。ただし、これは、構築されたホイールをテストする場合にのみ行う必要があります。次に、信頼できる発行を使用してPyPIへのアップロードを設定します。" #: ../../tutorials/trusted-publishing.md:215 msgid "Configure automatic publishing to PyPI" -msgstr "" +msgstr "PyPIへの自動発行を設定する" #: ../../tutorials/trusted-publishing.md:217 msgid "" -"The job you configured above using GitHub Actions builds your package " -"using your code. You still need to upload it to PyPI. You could upload " -"the package from the same job, but it is better to create a separate one " -"to maintain a separation of tasks. This is why, in the previous section, " -"we uploaded the artifact to the temporary storage." +"The job you configured above using GitHub Actions builds your package using" +" your code. You still need to upload it to PyPI. You could upload the " +"package from the same job, but it is better to create a separate one to " +"maintain a separation of tasks. This is why, in the previous section, we " +"uploaded the artifact to the temporary storage." msgstr "" +"GitHub " +"Actionsを使用して上記で構成したジョブは、コードを使用してパッケージをビルドします。まだPyPIにアップロードする必要があります。同じジョブからパッケージをアップロードすることもできますが、タスクの分離を維持するために別のものを作成することをお勧めします。これが、前のセクションでアーティファクトを一時ストレージにアップロードした理由です。" #: ../../tutorials/trusted-publishing.md:223 msgid "" -"In the new job, you will download the package from there and upload it to" -" PyPI. Since the `build` job does nothing else, there is no possibility " -"that the package could get compromised before the release." -msgstr "" +"In the new job, you will download the package from there and upload it to " +"PyPI. Since the `build` job does nothing else, there is no possibility that" +" the package could get compromised before the release." +msgstr "新しいジョブでは、そこからパッケージをダウンロードし、PyPIにアップロードします。「ビルド」ジョブは他に何もしないので、リリース前にパッケージが危険にさらされる可能性はありません。" #: ../../tutorials/trusted-publishing.md:227 msgid "Step 1: Add the upload job" -msgstr "" +msgstr "ステップ1 ：アップロードジョブを追加する" #: ../../tutorials/trusted-publishing.md:229 msgid "" "In the `release.yaml` file, add the following new job, after the job " "defined in the previous section:" -msgstr "" +msgstr "'release.yaml`ファイルで、前のセクションで定義したジョブの後に次の新しいジョブを追加します。" #: ../../tutorials/trusted-publishing.md:238 msgid "Make sure to change the URL" -msgstr "" +msgstr "必ずURLを変更してください" #: ../../tutorials/trusted-publishing.md:240 msgid "Remember to change the `url:` value to the URL for your package on PyPI!" -msgstr "" +msgstr "PyPI上のパッケージのURLに`url :'値を変更することを忘れないでください！" #: ../../tutorials/trusted-publishing.md:243 msgid "This job has two steps:" -msgstr "" +msgstr "このジョブには2つのステップがあります。" #: ../../tutorials/trusted-publishing.md:245 msgid "" -"It uses `download-artifact` to download the artifacts built in the " -"previous job" -msgstr "" +"It uses `download-artifact` to download the artifacts built in the previous" +" job" +msgstr "「download - artifact」を使用して、前のジョブで構築されたアーティファクトをダウンロードします" #: ../../tutorials/trusted-publishing.md:247 msgid "It uses `gh-action-pypi-publish` to publish the package to PyPI." -msgstr "" +msgstr "パッケージをPyPIに公開するために`gh - action - pypi - publish'を使用します。" #: ../../tutorials/trusted-publishing.md:249 msgid "" -"You are almost there!! Now, you just need to enable trusted publishing " -"for your project on PyPI. And then, your work is done!" -msgstr "" +"You are almost there!! Now, you just need to enable trusted publishing for " +"your project on PyPI. And then, your work is done!" +msgstr "あと少しです！ ！これで、PyPIでプロジェクトの信頼できる公開を有効にするだけです。そして、あなたの仕事は完了しました！" #: ../../tutorials/trusted-publishing.md:252 msgid "Step 2: Enable trusted publishing on PyPI" -msgstr "" +msgstr "ステップ2 ： PyPIで信頼できる公開を有効にする" #: ../../tutorials/trusted-publishing.md:256 msgid "" @@ -7590,46 +7666,62 @@ msgid "" "Step 3 securely uploads to PyPI. Shows chain of trust with lock icon " "connecting GitHub Action to Python Package Index." msgstr "" +"PyPIの信頼できるパブリッシャーワークフローを示す図：ステップ1はGitHubを介して配布ファイルをビルド、ステップ2は信頼できる環境（PyPI）を使用、ステップ3は安全にPyPIにアップロード。GitHub" +" ActionsからPython Package Indexに接続する錠前アイコンで信頼の連鎖を表示。" #: ../../tutorials/trusted-publishing.md:261 msgid "" "Before trusted publishing was created, in order to upload to PyPI from " "GitHub actions you would have needed to add the username and password as " "arguments to the `gh-action-pypi-publish` step. While documentation " -"recommends using the GitHub's `secrets` environment for the " -"password/token, in several cases, users were pasting the password " -"directly into the workflow file. Furthermore, accidental leakage of the " -"password or token could allow attackers to publish new packages using " -"your account, until you discover the compromise and revoke the leaked " -"credentials." -msgstr "" +"recommends using the GitHub's `secrets` environment for the password/token," +" in several cases, users were pasting the password directly into the " +"workflow file. Furthermore, accidental leakage of the password or token " +"could allow attackers to publish new packages using your account, until you" +" discover the compromise and revoke the leaked credentials." +msgstr "" +"信頼された公開が作成される前は、GitHub Actions から PyPI にアップロードするためには、`gh-action-pypi-" +"publish` ステップにユーザー名とパスワードを引数として追加する必要がありました。 While documentation recommends" +" using the GitHub's `secrets` environment for the password/token, in " +"several cases, users were pasting the password directly into the workflow " +"file. Furthermore, accidental leakage of the password or token could allow " +"attackers to publish new packages using your account, until you discover " +"the compromise and revoke the leaked credentials." #: ../../tutorials/trusted-publishing.md:269 msgid "" "To prevent these incidents and improve supply chain security, developers " "created [Trusted Publishing](https://docs.pypi.org/trusted-publishers/). " -"Trusted publishing allows you to register a publishing workflow on PyPI " -"and then map that workflow to an automation workflow (e.g., GitHub " -"Actions) that is allowed to publish the package." +"Trusted publishing allows you to register a publishing workflow on PyPI and" +" then map that workflow to an automation workflow (e.g., GitHub Actions) " +"that is allowed to publish the package." msgstr "" +"これらの事故を防ぎ、サプライチェーンのセキュリティを向上させるために、開発者は[Trusted " +"Publishing](https://docs.pypi.org/trusted-publishers/)を作成しました。Trusted " +"Publishingを使用すると、PyPIで公開ワークフローを登録し、そのワークフローをパッケージの公開を許可された自動化ワークフロー（例：GitHub" +" Actions）にマッピングすることができます。" #: ../../tutorials/trusted-publishing.md:274 msgid "" -"You do not need to enter a token or password value in a trusted publisher" -" workflow. It's a secure connection between your" -msgstr "" +"You do not need to enter a token or password value in a trusted publisher " +"workflow. It's a secure connection between your" +msgstr "信頼された発行者のワークフローでは、トークンやパスワードの値を入力する必要はありません。それはあなたの間の安全な接続です" #: ../../tutorials/trusted-publishing.md:277 msgid "Trusted Publishing outside of GitHub Actions" -msgstr "" +msgstr "GitHub Actions 以外での信頼された公開" #: ../../tutorials/trusted-publishing.md:280 msgid "" "Trusted Publishing supports other automation platforms, beyond GitHub " -"Actions. It is also possible to configure a trusted publisher for " -"multiple workflows or multiple publishers for the same package. These are" -" advanced uses, out of scope for this lesson." +"Actions. It is also possible to configure a trusted publisher for multiple " +"workflows or multiple publishers for the same package. These are advanced " +"uses, out of scope for this lesson." msgstr "" +"Trusted Publishing supports other automation platforms, beyond GitHub " +"Actions. It is also possible to configure a trusted publisher for multiple " +"workflows or multiple publishers for the same package. " +"これらは高度な使用例であり、このレッスンの範囲外です。" #: ../../tutorials/trusted-publishing.md:286 msgid "" @@ -7638,6 +7730,8 @@ msgid "" "PyPI publishing](create-python-package), you should have this project " "already created." msgstr "" +"このレッスンでは、すでにPyPIに存在するプロジェクトのために信頼できる公開者を設定することに焦点を当てます。[PyPI公開に関するレッスン" +"](create-python-package)を完了していれば、このプロジェクトはすでに作成済みのはずです。" #: ../../tutorials/trusted-publishing.md:288 msgid "" @@ -7645,49 +7739,49 @@ msgid "" "releases will only run the GitHub Actions workflow we are configuring in " "`release.yaml`." msgstr "" +"このセットアップ手順は、プロジェクトに対して一度だけ実行する必要があります。今後のリリースでは、`release.yaml`で設定しているGitHub" +" Actionsのワークフローのみが実行されます。" #: ../../tutorials/trusted-publishing.md:291 msgid "" -"On the [\"Your projects\" page on " -"PyPI](https://pypi.org/manage/projects/), click \"Manage\" on any project" -" you want to configure." -msgstr "" +"On the [\"Your projects\" page on PyPI](https://pypi.org/manage/projects/)," +" click \"Manage\" on any project you want to configure." +msgstr "PyPIの[「あなたのプロジェクト」ページ](https://pypi.org/manage/projects/)で、設定したいプロジェクトの「管理」をクリックしてください。" #: ../../tutorials/trusted-publishing.md:295 msgid "" "Graphic showing a screenshot of the \"Your projects\" page on PyPI. The " "\"Manage\" button for one of the projects is highlighted." -msgstr "" +msgstr "PyPI の「Your projects」ページのスクリーンショットを示すグラフィック。あるプロジェクトの「Manage」ボタンが強調表示されている。" #: ../../tutorials/trusted-publishing.md:297 msgid "" -"This image shows several projects. The \"Manage\" button is highlighted " -"for one of the projects, the one we want to configure trusted publishing " -"for." -msgstr "" +"This image shows several projects. The \"Manage\" button is highlighted for" +" one of the projects, the one we want to configure trusted publishing for." +msgstr "この画像にはいくつかのプロジェクトが表示されています。信頼された公開の設定を行いたいプロジェクトの「管理」ボタンが強調表示されています。" #: ../../tutorials/trusted-publishing.md:300 msgid "Then click \"Publishing\" in the project's sidebar." -msgstr "" +msgstr "次に、プロジェクトのサイドバーで「公開」をクリックします。" #: ../../tutorials/trusted-publishing.md:303 msgid "" "Graphic showing the management page for one project. The \"Publishing\" " "link in the sidebar is highlighted." -msgstr "" +msgstr "1つのプロジェクトの管理ページを示すグラフィック。サイドバーの「公開」リンクが強調表示されている。" #: ../../tutorials/trusted-publishing.md:305 msgid "" -"Once clicking on the \"Manage\" button we got to the project's page. In " -"the sidebar, we have the \"publishing\" option, as highlighted here." -msgstr "" +"Once clicking on the \"Manage\" button we got to the project's page. In the" +" sidebar, we have the \"publishing\" option, as highlighted here." +msgstr "「管理」ボタンをクリックすると、プロジェクトのページに移動します。サイドバーには、「公開」オプションがあり、ここで強調表示されています。" #: ../../tutorials/trusted-publishing.md:309 msgid "" "This will take you to the publisher configuration page for the project. " -"Trusted publishers can be configured via the forms here. Fill in the " -"GitHub form with the following information:" -msgstr "" +"Trusted publishers can be configured via the forms here. Fill in the GitHub" +" form with the following information:" +msgstr "これにより、プロジェクトのパブリッシャー設定ページに移動します。信頼されたパブリッシャーは、ここでのフォームを通じて設定できます。次の情報を使用してGitHubフォームに記入してください:" #: ../../tutorials/trusted-publishing.md:313 msgid "" @@ -7695,90 +7789,101 @@ msgid "" "project. If this is your personal project, then use your GitHub username " "here." msgstr "" +"オーナー: " +"プロジェクトを所有する組織のGitHub組織名。これがあなたの個人プロジェクトの場合は、ここにあなたのGitHubユーザー名を使用してください。" #: ../../tutorials/trusted-publishing.md:315 msgid "Repository name: the name of the repository that contains the project." -msgstr "" +msgstr "リポジトリ名：プロジェクトを含むリポジトリの名前。" #: ../../tutorials/trusted-publishing.md:316 msgid "" -"Workflow name: Should be `release.yaml` if you followed this guide, it is" -" the workflow we just configured." -msgstr "" +"Workflow name: Should be `release.yaml` if you followed this guide, it is " +"the workflow we just configured." +msgstr "ワークフロー名: このガイドに従った場合、`release.yaml` であるべきです。これは、先ほど設定したワークフローです。" #: ../../tutorials/trusted-publishing.md:318 msgid "" "Environment name: Should be `pypi`, as that is what we configured in " "`release.yaml`." -msgstr "" +msgstr "環境名: `release.yaml`で設定したので、`pypi`であるべきです。" #: ../../tutorials/trusted-publishing.md:321 msgid "" "Once you fill in this form and click \"Add\" the publisher is configured " "and can be used to publish new releases of your package." -msgstr "" +msgstr "このフォームに入力して「追加」をクリックすると、パブリッシャーが設定され、パッケージの新しいリリースの公開に使用できるようになります。" #: ../../tutorials/trusted-publishing.md:324 msgid "Fully hardened GitHub Actions release workflow" -msgstr "" +msgstr "完全に強化されたGitHub Actionsリリースワークフロー" #: ../../tutorials/trusted-publishing.md:326 msgid "" -"For better security, it is also recommended to control the permissions of" -" the GitHub token used within each job of the workflow. The permissions " +"For better security, it is also recommended to control the permissions of " +"the GitHub token used within each job of the workflow. The permissions " "should be scoped at job level and be as minimal as possible. A workflow " "that configures trusted publishing and also does this is the following:" msgstr "" +"より良いセキュリティのために、ワークフロー内の各ジョブで使用される GitHub " +"トークンの権限を制御することも推奨されます。権限はジョブレベルでスコープされ、可能な限り最小限にするべきです。信頼された公開を設定し、これも行うワークフローは次のとおりです。" #: ../../tutorials/trusted-publishing.md:336 msgid "" "You can copy the above into your `release.yaml` file. You only need to " "update the `url:` field and configure trusted publishing on PyPI." -msgstr "" +msgstr "上記を `release.yaml` ファイルにコピーできます。`url:` フィールドを更新し、PyPI で信頼できる公開設定を行うだけで済みます。" #: ../../tutorials/trusted-publishing.md:340 msgid "" -"The workflow above should be up to date with the current versions of " -"GitHub actions. However, it's good to turn on Dependabot to update the " -"action versions in the future." -msgstr "" +"The workflow above should be up to date with the current versions of GitHub" +" actions. However, it's good to turn on Dependabot to update the action " +"versions in the future." +msgstr "上記のワークフローは、現在のGitHubアクションのバージョンに合わせて最新であるはずです。ただし、将来的にアクションのバージョンを更新するためにDependabotを有効にしておくと良いでしょう。" #: ../../tutorials/trusted-publishing.md:343 msgid "You have enabled trusted publishing for your project" -msgstr "" +msgstr "あなたはプロジェクトに対して信頼できる公開を有効にしました" #: ../../tutorials/trusted-publishing.md:345 msgid "" "Congratulations!! You have now configured your project to do secure " -"releases when a new version is being tagged on GitHub. The workflow we " -"have configured builds the package from the exact version of code that we" -" are tagging. This provides a guarantee for your users that the package " -"that you have released does precisely what the code states it does. There" -" is little to no potential for supply chain related vulnerabilities " -"arising from your package! If you have a package that is ready for real-" -"world use on the real PyPI, then you can follow the same steps to publish" -" it securely." -msgstr "" +"releases when a new version is being tagged on GitHub. The workflow we have" +" configured builds the package from the exact version of code that we are " +"tagging. This provides a guarantee for your users that the package that you" +" have released does precisely what the code states it does. There is little" +" to no potential for supply chain related vulnerabilities arising from your" +" package! If you have a package that is ready for real-world use on the " +"real PyPI, then you can follow the same steps to publish it securely." +msgstr "" +"おめでとうございます！！これで、新しいバージョンがGitHubでタグ付けされたときに、プロジェクトが安全にリリースできるように設定されました。 " +"私たちが設定したワークフローは、タグを付けている正確なバージョンのコードからパッケージをビルドします。 " +"これは、リリースしたパッケージがコードで記載されている通りのことを正確に行うことをユーザーに保証するものです。 " +"あなたのパッケージから発生するサプライチェーン関連の脆弱性の可能性はほとんどありません！もし本物のPyPIで実際に使用できるパッケージがある場合は、同じ手順に従って安全に公開することができます。" #: ../../tutorials/trusted-publishing.md:349 msgid "" -msgstr "" +msgstr "" #: ../../tutorials/trusted-publishing.md:350 msgid "" "" msgstr "" +"" #: ../../tutorials/trusted-publishing.md:351 msgid "" "" msgstr "" +"" #: ../../tutorials/trusted-publishing.md:352 msgid "" -msgstr "" +msgstr "" #~ msgid "Make your Python code installable" #~ msgstr "Pythonコードをインストール可能にする" @@ -7804,11 +7909,11 @@ msgstr "" #~ " such as GitHub (or GitLab). The " #~ "package that you create in this " #~ "lesson will have the bare minimum " -#~ "elements needed to be installable into" -#~ " a Python environment." +#~ "elements needed to be installable into " +#~ "a Python environment." #~ msgstr "" -#~ "パッケージングチュートリアルシリーズの次のステップは、ローカルでも GitHub (または " -#~ "GitLab) などのウェブサイトからリモートでもインストール可能な Python " +#~ "パッケージングチュートリアルシリーズの次のステップは、ローカルでも GitHub (または GitLab)" +#~ " などのウェブサイトからリモートでもインストール可能な Python " #~ "パッケージを作成することです。このレッスンで作成するパッケージは、Python環境にインストールするために必要な最低限の要素しか持っていません。" #~ msgid "" @@ -7823,18 +7928,17 @@ msgstr "" #~ msgid "" #~ "A basic installable package needs a " -#~ "few things: code, a [specific package" -#~ " file structure](https://www.pyopensci.org/python-" -#~ "package-guide/package-structure-code/python-" -#~ "package-structure.html) and a `pyproject.toml`" -#~ " containing your package's name and " +#~ "few things: code, a [specific package " +#~ "file structure](https://www.pyopensci.org/python-package-" +#~ "guide/package-structure-code/python-package-" +#~ "structure.html) and a `pyproject.toml` " +#~ "containing your package's name and " #~ "version. Once you have these items " #~ "in the correct directory structure, you" -#~ " can pip install your package into" -#~ " any environment on your computer. " -#~ "You will learn how to create a " -#~ "basic installable package in this " -#~ "lesson." +#~ " can pip install your package into " +#~ "any environment on your computer. You " +#~ "will learn how to create a basic " +#~ "installable package in this lesson." #~ msgstr "" #~ "基本的なインストール可能パッケージには、以下のものが必要です: コード、 " #~ "[特定のパッケージファイル構造](https://www.pyopensci.org/python-package-" @@ -7843,10 +7947,10 @@ msgstr "" #~ "が必要です。これらのアイテムが正しいディレクトリ構造になっていれば、pipであなたのコンピュータのどの環境にもパッケージをインストールすることができます。このレッスンでは、基本的なインストール可能パッケージの作成方法を学びます。" #~ msgid "" -#~ "How to create a basic `pyproject.toml`" -#~ " file that includes package dependencies" -#~ " and metadata. This file is required" -#~ " to make your package installable." +#~ "How to create a basic `pyproject.toml` " +#~ "file that includes package dependencies " +#~ "and metadata. This file is required " +#~ "to make your package installable." #~ msgstr "" #~ "パッケージの依存関係とメタデータを含む基本的な `pyproject.toml` " #~ "ファイルの作成方法。このファイルは、パッケージをインストール可能にするために必要です。" @@ -7873,13 +7977,13 @@ msgstr "" #~ msgid "" #~ "Now that you understand the basics " -#~ "of the Python package directory " -#~ "structure, and associated key files " -#~ "(`__init__.py` and `pyproject.toml`), it's " -#~ "time to create your Python package! " -#~ "Below you will create a directory " -#~ "structure similar to the structure " -#~ "described above using Hatch." +#~ "of the Python package directory structure," +#~ " and associated key files (`__init__.py` " +#~ "and `pyproject.toml`), it's time to create" +#~ " your Python package! Below you will" +#~ " create a directory structure similar " +#~ "to the structure described above using " +#~ "Hatch." #~ msgstr "" #~ "Python パッケージのディレクトリ構造の基本を理解し、関連するキーファイル (`__init__.py` " #~ "と `pyproject.toml`) を理解したところで、いよいよ Python " @@ -7934,12 +8038,12 @@ msgstr "" #~ msgid "" #~ "If you are following along and " #~ "making a Python package from scratch " -#~ "then you can add the code below" -#~ " to your `add_numbers.py` module. The " -#~ "function below adds two integers " -#~ "together and returns the result. Notice" -#~ " that the code below has a few" -#~ " features that we will review in " +#~ "then you can add the code below " +#~ "to your `add_numbers.py` module. The " +#~ "function below adds two integers together" +#~ " and returns the result. Notice that" +#~ " the code below has a few " +#~ "features that we will review in " #~ "future tutorials:" #~ msgstr "" #~ "Python のパッケージをゼロから作るのであれば、以下のコードを `add_numbers.py` " @@ -7947,9 +8051,9 @@ msgstr "" #~ "以下の関数は2つの整数を加算して結果を返します。以下のコードには、今後のチュートリアルで確認するいくつかの機能があることに注目してください:" #~ msgid "" -#~ "If you aren't familiar with docstrings" -#~ " or typing yet, that is ok. You" -#~ " can review [this page in the " +#~ "If you aren't familiar with docstrings " +#~ "or typing yet, that is ok. You " +#~ "can review [this page in the " #~ "pyOpenSci packaging guide](https://www.pyopensci.org" #~ "/python-package-guide/documentation/write-user-" #~ "documentation/document-your-code-api-" @@ -7965,10 +8069,10 @@ msgstr "" #~ msgid "" #~ "Next, you will modify some of the" #~ " metadata (information) that Hatch adds " -#~ "to your `pyproject.toml` file. You are" -#~ " are welcome to copy the file " -#~ "we have in our [example pyospackage " -#~ "GitHub repository](https://github.com/pyOpenSci/pyosPackage)." +#~ "to your `pyproject.toml` file. You are " +#~ "are welcome to copy the file we " +#~ "have in our [example pyospackage GitHub" +#~ " repository](https://github.com/pyOpenSci/pyosPackage)." #~ msgstr "" #~ "次に、Hatchが `pyproject.toml` ファイルに追加するメタデータ (情報) " #~ "の一部を変更します。私たちの [example pyospackage " @@ -7982,17 +8086,17 @@ msgstr "" #~ "Delete `dynamic = [\"version\"]`: This " #~ "sets up dynamic versioning based on " #~ "tags stored in your git commit " -#~ "history. We will walk through " -#~ "implementing this in a later lesson." +#~ "history. We will walk through implementing" +#~ " this in a later lesson." #~ msgstr "" #~ "`dynamic = [\"version\"]` を削除する: これは、git " #~ "のコミット履歴に保存されているタグに基づいて、動的なバージョン管理を設定します。後のレッスンでこの実装方法を説明します。" #~ msgid "" -#~ "Add `version = \"0.1\"` in the " -#~ "place of `dynamic = [\"version\"]` " -#~ "which you just deleted. This sets " -#~ "up manual versioning." +#~ "Add `version = \"0.1\"` in the place" +#~ " of `dynamic = [\"version\"]` which " +#~ "you just deleted. This sets up " +#~ "manual versioning." #~ msgstr "" #~ "先ほど削除した `dynamic = [\"version\"]` の場所に " #~ "`version = \"0.1\"` を追加します。これで手動バージョン管理が設定されます。" @@ -8007,20 +8111,20 @@ msgstr "" #~ msgstr "オプション: プロジェクトの分類子を調整する" #~ msgid "" -#~ "Hatch by default provides a list " -#~ "of classifiers that define what Python" -#~ " versions your package supports. These " -#~ "classifiers do not in any way " -#~ "impact your package's build and are " -#~ "primarily intended to be used when " -#~ "you publish your package to PyPI." +#~ "Hatch by default provides a list of" +#~ " classifiers that define what Python " +#~ "versions your package supports. These " +#~ "classifiers do not in any way impact" +#~ " your package's build and are primarily" +#~ " intended to be used when you " +#~ "publish your package to PyPI." #~ msgstr "Hatchはデフォルトで、パッケージがサポートするPythonのバージョンを定義する分類子のリストを提供します。これらの分類子はパッケージのビルドには一切影響を与えず、主にパッケージをPyPIに公開するときに使用することを目的としています。" #~ msgid "" #~ "If you don't plan on publishing to" #~ " PyPI, you can skip this section. " -#~ "However, if you wish, you can " -#~ "clean it up a bit." +#~ "However, if you wish, you can clean" +#~ " it up a bit." #~ msgstr "PyPIに公開する予定がなければ、このセクションは飛ばして構いません。しかし、もし望むなら、少しきれいにすることもできます。" #~ msgid "To begin:" @@ -8031,17 +8135,17 @@ msgstr "" #~ msgid "" #~ "Within the `[project]` table, update " -#~ "`requires-python = \">3.8\"` to " -#~ "`requires-python = \">3.9\"`" +#~ "`requires-python = \">3.8\"` to `requires-" +#~ "python = \">3.9\"`" #~ msgstr "" #~ "`[project]` テーブル内で、 `requires-python = " #~ "\">3.8\"` を `requires-python = \">3.9\"`" #~ " に更新します。" #~ msgid "" -#~ "Since you are creating a pure " -#~ "Python package in this lesson, you " -#~ "can remove the following classifiers:" +#~ "Since you are creating a pure Python" +#~ " package in this lesson, you can " +#~ "remove the following classifiers:" #~ msgstr "このレッスンでは純粋な Python パッケージを作成するので、以下の分類子は削除してかまいません:" #~ msgid "Your new pyproject.toml file should now look something like this:" @@ -8054,18 +8158,17 @@ msgstr "" #~ msgstr "これからのレッスンではあなたは:" #~ msgid "" -#~ "Learn how to [build and publish " -#~ "your Python package to (test) PyPI" -#~ "](publish-pypi)" +#~ "Learn how to [build and publish your" +#~ " Python package to (test) PyPI](publish-" +#~ "pypi)" #~ msgstr "[Python パッケージをビルドして (test) PyPI に公開する](publish-pypi) 方法を学びましょう。" #~ msgid "Add a README file and LICENSE to your package" #~ msgstr "READMEファイルとLICENSEをパッケージに追加する。" #~ msgid "" -#~ "Add more metadata to your " -#~ "`pyproject.toml` file to support PyPI " -#~ "publication." +#~ "Add more metadata to your `pyproject.toml`" +#~ " file to support PyPI publication." #~ msgstr "PyPI での公開をサポートするために `pyproject.toml` ファイルにメタデータを追加します。" #~ msgid "learn how to publish to **conda-forge** from **PyPI**." @@ -8081,35 +8184,35 @@ msgstr "" #~ msgstr "ライセンスと" #~ msgid "" -#~ "This lesson uses the pyOpenSci Python" -#~ " package copier template to create a" -#~ " Python package quickly. Your package " -#~ "will be installable both locally and " +#~ "This lesson uses the pyOpenSci Python " +#~ "package copier template to create a " +#~ "Python package quickly. Your package will" +#~ " be installable both locally and " #~ "remotely from a website such as " #~ "GitHub (or GitLab) into a Python " #~ "environment." #~ msgstr "" #~ msgid "" -#~ "The template will then begin to " -#~ "copy files into the directory that " -#~ "used above. (`.` means current working" -#~ " directory" +#~ "The template will then begin to copy" +#~ " files into the directory that used " +#~ "above. (`.` means current working " +#~ "directory" #~ msgstr "" #~ msgid "" #~ "If you use the \"bells and " #~ "whistles\" default option when working " -#~ "through the template prompts, our " -#~ "template will create a complete package" -#~ " setup with GitHub CI actions, " -#~ "typing, tests, environments , and more" -#~ " using Hatch. If you customize the" -#~ " entire package, then you can select" -#~ " what platform you wish to host " -#~ "it on (GitHub vs GitLab), whether " -#~ "you want typing, what documentation " -#~ "engine you want to use, and more." +#~ "through the template prompts, our template" +#~ " will create a complete package setup" +#~ " with GitHub CI actions, typing, tests," +#~ " environments , and more using Hatch." +#~ " If you customize the entire package," +#~ " then you can select what platform " +#~ "you wish to host it on (GitHub " +#~ "vs GitLab), whether you want typing, " +#~ "what documentation engine you want to " +#~ "use, and more." #~ msgstr "" #~ msgid "" @@ -8123,57 +8226,55 @@ msgstr "" #~ "A `pyproject.toml` file stores metadata " #~ "that provides instructions to various " #~ "tools interacting with it, including " -#~ "Hatch, which will build your package." -#~ " You can also specify metadata for" -#~ " your package." +#~ "Hatch, which will build your package. " +#~ "You can also specify metadata for " +#~ "your package." #~ msgstr "" #~ msgid "" #~ "The metadata in your generated " #~ "pyproject.toml is already setup for you" -#~ " using the information you provided " -#~ "the copier template above." +#~ " using the information you provided the" +#~ " copier template above." #~ msgstr "" #~ msgid "" #~ "Welcome to your shiny new package! " -#~ "This page will help you get " -#~ "started with using Hatch to run " -#~ "tests, build and check your package, " -#~ "and build your documentation." +#~ "This page will help you get started" +#~ " with using Hatch to run tests, " +#~ "build and check your package, and " +#~ "build your documentation." #~ msgstr "" #~ msgid "" #~ "To begin, have a look at the " #~ "`pyproject.toml` file in your package " #~ "directory. This file contains the " -#~ "configuration for your package. This " -#~ "file is written using a .toml " -#~ "format. [You can learn more about " -#~ "toml here.](https://www.pyopensci.org/python-package-" -#~ "guide/package-structure-code/pyproject-toml-" -#~ "python-package-metadata.html) Here's the " -#~ "TL&DR:" +#~ "configuration for your package. This file" +#~ " is written using a .toml format. " +#~ "[You can learn more about toml " +#~ "here.](https://www.pyopensci.org/python-package-guide" +#~ "/package-structure-code/pyproject-toml-python-" +#~ "package-metadata.html) Here's the TL&DR:" #~ msgstr "" #~ msgid "" -#~ "In the pyOpenSci Python package " -#~ "template, we have set up Hatch " -#~ "environments. You will notice at the " -#~ "bottom of the file, a [hatch " -#~ "environment](https://hatch.pypa.io/1.13/environment/) section," -#~ " that looks like this:" +#~ "In the pyOpenSci Python package template," +#~ " we have set up Hatch environments. " +#~ "You will notice at the bottom of " +#~ "the file, a [hatch " +#~ "environment](https://hatch.pypa.io/1.13/environment/) section, " +#~ "that looks like this:" #~ msgstr "" #~ msgid "" #~ "Below is a Hatch environment definition" -#~ " that you will find in your " -#~ "[new project's pyproject.toml file](create-" -#~ "python-package). It is set up to " -#~ "[build your package's](build-package) " -#~ "distribution files ([source distribution](python-" -#~ "source-distribution) and [wheel](python-" -#~ "wheel))." +#~ " that you will find in your [new" +#~ " project's pyproject.toml file](create-python-" +#~ "package). It is set up to [build " +#~ "your package's](build-package) distribution " +#~ "files ([source distribution](python-source-" +#~ "distribution) and [wheel](python-wheel))." #~ msgstr "" #~ msgid "" @@ -8181,11 +8282,11 @@ msgstr "" #~ "declares two dependencies: `pip` and " #~ "`twine`, which the environment needs to" #~ " run successfully. This declaration is " -#~ "similar to declaring dependencies for " -#~ "your package at the top of your" -#~ " `pyproject.toml`. This section tells Hatch" -#~ " to create a new VENV with pip" -#~ " and twine installed." +#~ "similar to declaring dependencies for your" +#~ " package at the top of your " +#~ "`pyproject.toml`. This section tells Hatch " +#~ "to create a new VENV with pip " +#~ "and twine installed." #~ msgstr "" #~ msgid "Build your package's source (sdist) and wheel distributions" @@ -8199,12 +8300,12 @@ msgstr "" #~ "provided by GitHub to automate software" #~ " workflows, straight from the GitHub " #~ "repository of the project. You can " -#~ "configure automated testing for every " -#~ "pull request, automate publishing of " +#~ "configure automated testing for every pull" +#~ " request, automate publishing of " #~ "documentation, automate creation of web " #~ "pages for the project, and even " -#~ "automate the release process. For this" -#~ " lesson, we will focus on using " +#~ "automate the release process. For this " +#~ "lesson, we will focus on using " #~ "actions to release and publish your " #~ "Python package securely to PyPI." #~ msgstr "" @@ -8212,8 +8313,8 @@ msgstr "" #~ msgid "" #~ "For a release job, you need to " #~ "clone or check out the repository. " -#~ "You can use the `actions/checkout` " -#~ "action to check out the code. You" -#~ " then install and use `hatch` to " -#~ "build your package." +#~ "You can use the `actions/checkout` action" +#~ " to check out the code. You then" +#~ " install and use `hatch` to build " +#~ "your package." #~ msgstr ""