From 5caa45c54f35901a54ebfa22075e1a8a751c7a70 Mon Sep 17 00:00:00 2001 From: Tetsuo Koyama Date: Sat, 9 Nov 2024 05:18:14 +0900 Subject: [PATCH 1/3] docs: translate to Japanese documentation.md --- locales/ja/LC_MESSAGES/documentation.po | 977 +++++++++++++++++------- 1 file changed, 694 insertions(+), 283 deletions(-) diff --git a/locales/ja/LC_MESSAGES/documentation.po b/locales/ja/LC_MESSAGES/documentation.po index ea6bdd72..1cc51b62 100644 --- a/locales/ja/LC_MESSAGES/documentation.po +++ b/locales/ja/LC_MESSAGES/documentation.po @@ -22,7 +22,7 @@ msgstr "" #: ../../documentation/hosting-tools/intro.md:1 msgid "Tools to Build and Host your Documentation" -msgstr "" +msgstr "ドキュメンテーションの構築とホスティングのためのツール" #: ../../documentation/hosting-tools/intro.md:3 msgid "" @@ -31,6 +31,9 @@ msgid "" "[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/) のようなツールを使っているメンテナもいます。 " +"ドキュメンテーションにどのプラットフォームを使うかはあなた次第です！" #: ../../documentation/hosting-tools/intro.md:8 msgid "" @@ -38,20 +41,24 @@ msgid "" "documentation. We talk about various syntax options that you can use when" " writing Sphinx documentation including mySt and rST." msgstr "" +"このセクションでは、ドキュメントを作成するための一般的なツールとしてSphinxを紹介します。 " +"ここでは、Sphinxのドキュメントを書くときに使用できる、myStやrSTを含むさまざまな構文オプションについて説明します。" #: ../../documentation/hosting-tools/intro.md:12 msgid "" "We also talk about ways to publish your documentation online and Sphinx " "tools that might help you optimize your documentation website." -msgstr "" +msgstr "また、ドキュメントをオンラインで公開する方法や、ドキュメントのウェブサイトを最適化するためのSphinxツールについてもお話します。" #: ../../documentation/hosting-tools/myst-markdown-rst-doc-syntax.md:1 -msgid "Documentation syntax: markdown vs. myST vs. rst syntax to create your docs" -msgstr "" +msgid "" +"Documentation syntax: markdown vs. myST vs. rst syntax to create your docs" +msgstr "ドキュメントの構文:ドキュメントを作成するためのマークダウン構文とmyST構文とrst構文" #: ../../documentation/hosting-tools/myst-markdown-rst-doc-syntax.md:3 -msgid "There are three commonly used syntaxes for creating Python documentation:" -msgstr "" +msgid "" +"There are three commonly used syntaxes for creating Python documentation:" +msgstr "Pythonのドキュメントを作成するためによく使われる構文は3つあります:" #: ../../documentation/hosting-tools/myst-markdown-rst-doc-syntax.md:4 msgid "" @@ -63,6 +70,12 @@ msgid "" " 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で使われるデフォルトの構文です。 " +"マークダウンをhtmlとしてレンダリングするためのツールをSphinxのウェブサイトに追加することができます。 " +"しかし、マークダウンを使ってドキュメントを書くことには限界があります。 " +"例えば、ドキュメントにリファレンスや色付きのカラー出力ブロック、その他のカスタム要素を追加したい場合、 **myST** または **rST** " +"を使用する必要があります。" #: ../../documentation/hosting-tools/myst-markdown-rst-doc-syntax.md:8 msgid "" @@ -73,6 +86,9 @@ msgid "" "the top as a favorite for documentation given the flexibility that it " "allows." msgstr "" +"[rST (ReStructured Text):](https://www.sphinx-" +"doc.org/en/master/usage/restructuredtext/basics.html)。 " +"**rST**は、sphinxがサポートするネイティブの構文です。rSTは、長年ドキュメントに使用されてきたデフォルトの構文です。しかし、近年、mySTがその柔軟性から、ドキュメンテーションによく使われるようになりました。" #: ../../documentation/hosting-tools/myst-markdown-rst-doc-syntax.md:9 msgid "" @@ -82,44 +98,48 @@ msgid "" "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`はrSTの豊富な機能と書きやすいマークダウン構文の両方を提供するため、多くの人に好まれています。" #: ../../documentation/hosting-tools/myst-markdown-rst-doc-syntax.md:12 msgid "" "While you can chose to use any of the syntaxes listed above, we suggest " "using `myST` because:" -msgstr "" +msgstr "上記のどの構文を使ってもよいですが、 `myST` を使うことをお勧めします:" #: ../../documentation/hosting-tools/myst-markdown-rst-doc-syntax.md:15 msgid "It is a simpler syntax and thus easier to learn;" -msgstr "" +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." -msgstr "" +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" -msgstr "" +msgstr "README.mdファイルなど、Pythonパッケージのコアとなるテキストファイルのほとんどは、すでに `.md` 形式になっています。" #: ../../documentation/hosting-tools/myst-markdown-rst-doc-syntax.md:18 msgid "" "`GitHub` and `Jupyter Notebooks` support markdown thus it's more widely " "used in the scientific ecosystem." 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." -msgstr "" +"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 msgid "How to publish your Python package documentation online" -msgstr "" +msgstr "Pythonパッケージのドキュメントをオンラインで公開する方法" #: ../../documentation/hosting-tools/publish-documentation-online.md:3 msgid "" @@ -127,50 +147,56 @@ msgid "" "documentation. Two free and commonly used ways to quickly create a " "documentation website hosting environment are below." msgstr "" +"Pythonパッケージドキュメントのホスティングサービスをセットアップすることをお勧めします。 " +"ドキュメンテーションウェブサイトのホスティング環境を素早く作るための、無料でよく使われる2つの方法を以下に示します。" #: ../../documentation/hosting-tools/publish-documentation-online.md:7 msgid "" "You can host your documentation yourself using [GitHub " "Pages](https://pages.github.com/) or another online hosting service." msgstr "" +"[GitHub Pages](https://pages.github.com/) " +"や他のオンラインホスティングサービスを使って、ドキュメントを自分でホスティングすることができます。" #: ../../documentation/hosting-tools/publish-documentation-online.md:8 msgid "" "You can host your documentation using [Read the " "Docs](https://readthedocs.org/)." -msgstr "" +msgstr "[Read the Docs](https://readthedocs.org/) を使ってドキュメントをホストすることができます。" #: ../../documentation/hosting-tools/publish-documentation-online.md:10 msgid "What is Read the Docs ?" -msgstr "" +msgstr "Read the Docsとは？" #: ../../documentation/hosting-tools/publish-documentation-online.md:11 msgid "" "[Read the Docs](https://readthedocs.org/) is a documentation hosting " "service that supports publishing your project's documentation." msgstr "" +"[Read the Docs](https://readthedocs.org/) " +"は、あなたのプロジェクトのドキュメント公開をサポートするドキュメントホスティングサービスです。" #: ../../documentation/hosting-tools/publish-documentation-online.md:13 msgid "" "Read the Docs is a fully featured, free, documentation hosting service. " "Some of its many features include:" -msgstr "" +msgstr "Read the Docsは、完全な機能を備えた無料のドキュメントホスティングサービスです。 その多くの機能の一部を紹介します:" #: ../../documentation/hosting-tools/publish-documentation-online.md:16 msgid "" "Is free to host your documentation (but there are also paid tiers if you " "wish to customize hosting)" -msgstr "" +msgstr "ドキュメントのホスティングは無料です(ただし、ホスティングをカスタマイズしたい場合は、有料の階層もあります)" #: ../../documentation/hosting-tools/publish-documentation-online.md:17 msgid "Automates building your documentation" -msgstr "" +msgstr "ドキュメントの作成を自動化する" #: ../../documentation/hosting-tools/publish-documentation-online.md:18 msgid "" "Allows you to turn on integration with pull requests where you can view " "documentation build progress (success vs failure)." -msgstr "" +msgstr "プルリクエストとの統合を有効にすると、ドキュメントのビルドの進捗状況（成功か失敗か）を確認できます。" #: ../../documentation/hosting-tools/publish-documentation-online.md:19 msgid "" @@ -178,20 +204,21 @@ msgid "" "older tagged versions of the docs if they are using older versions of " "your package." msgstr "" +"ドキュメントのバージョン管理をサポートし、ユーザーが古いバージョンのパッケージを使用している場合、タグ付けされた古いバージョンのドキュメントを参照できるようにします。" #: ../../documentation/hosting-tools/publish-documentation-online.md:20 msgid "Supports downloading of documentation in PDF and other formats." -msgstr "" +msgstr "PDFやその他の形式のドキュメントのダウンロードに対応。" #: ../../documentation/hosting-tools/publish-documentation-online.md:21 msgid "" "You can customize the documentation build using a **.readthedocs.yaml** " "file in your GitHub repository." -msgstr "" +msgstr "ドキュメントのビルドは、GitHubリポジトリの **.readthedocs.yaml** ファイルを使ってカスタマイズできます。" #: ../../documentation/hosting-tools/publish-documentation-online.md:24 msgid "What is GitHub Pages?" -msgstr "" +msgstr "GitHub Pagesとは？" #: ../../documentation/hosting-tools/publish-documentation-online.md:25 msgid "" @@ -201,10 +228,14 @@ msgid "" "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 リポジトリのブランチにプッシュすることができます。" #: ../../documentation/hosting-tools/publish-documentation-online.md:33 msgid "Read the Docs vs GitHub Pages" -msgstr "" +msgstr "Read the Docs vs GitHub Pages" #: ../../documentation/hosting-tools/publish-documentation-online.md:35 msgid "" @@ -212,6 +243,8 @@ msgid "" "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 "" @@ -219,16 +252,18 @@ msgid "" "service automates the entire process of building and deploying your " "documentation." msgstr "" +"Read the Docsは、Read the Docsのユーザーアカウントで設定できます。 " +"このサービスは、ドキュメントの作成と配布の全プロセスを自動化します。" #: ../../documentation/hosting-tools/publish-documentation-online.md:42 msgid "" "If you don't want to maintain a documentation website for your Python " "package, we suggest using the Read the Docs website." -msgstr "" +msgstr "Pythonパッケージのドキュメントのウェブサイトを管理したくない場合は、Read the Docsウェブサイトを使うことをお勧めします。" #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:1 msgid "Using Sphinx to Build Python Package Documentation" -msgstr "" +msgstr "Sphinxを使ってPythonパッケージのドキュメントを作る" #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:17 msgid "" @@ -239,30 +274,37 @@ msgid "" "[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/) のような、ドキュメントをビルドするための他のツールを調べることも歓迎します。" #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:25 msgid "Examples of documentation websites that we love:" -msgstr "" +msgstr "私たちが気に入っているドキュメンテーションのウェブサイトの例:" #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:27 msgid "[GeoPandas](https://geopandas.org/en/stable/)" -msgstr "" +msgstr "[GeoPandas](https://geopandas.org/en/stable/)" #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:28 msgid "" "[View rst to create landing " "page](https://raw.githubusercontent.com/geopandas/geopandas/main/doc/source/index.rst)" msgstr "" +"[ランディングページを作成するために最初にご覧ください](https://raw.githubusercontent.com/geopandas/geopandas/main/doc/source/index.rst)" #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:29 msgid "[verde](https://www.fatiando.org/verde/latest/)" -msgstr "" +msgstr "[verde](https://www.fatiando.org/verde/latest/)" #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:30 msgid "" "[View verde landing page code - rst " "file.](https://github.com/fatiando/verde/blob/main/doc/index.rst)" msgstr "" +"[verdeランディングページのコードを見る - " +"rstファイル](https://github.com/fatiando/verde/blob/main/doc/index.rst)" #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:31 msgid "" @@ -270,10 +312,12 @@ msgid "" " page.](https://github.com/pyOpenSci/python-package-" "guide/blob/main/index.md)" msgstr "" +"[ランディングページのmyST例をご覧になりたい方は、こちらのドキュメントをご覧ください](https://github.com/pyOpenSci/python-" +"package-guide/blob/main/index.md)" #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:34 msgid "Sphinx - a static site generator" -msgstr "" +msgstr "Sphinx - 静的サイトジェネレーター" #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:36 msgid "" @@ -284,26 +328,31 @@ msgid "" "\"Statically\" which means that there is no generation or modification of" " the files on the fly." msgstr "" +"Sphinxは " +"[スタティックサイトジェネレーター](https://www.cloudflare.com/learning/performance/static-" +"site-generator/) です。 静的サイトジェネレータとは、テンプレートのセットに基づいて、ウェブサイトのhtmlを作成するツールです。 " +"htmlファイルは「静的」に提供されるため、その場でファイルを生成したり変更したりすることはありません。" #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:39 msgid "Sphinx is written using Python." -msgstr "" +msgstr "SphinxはPythonで書かれています。" #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:41 msgid "Sphinx sites can be customized using extensions and themes" -msgstr "" +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:" msgstr "" +msgstr "Sphinxの機能は、エクステンションやテーマを使って拡張することができます。 いくつかの例があります:" #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:46 msgid "" "You can apply documentation themes for quick generation of beautiful " "documentation." -msgstr "" +msgstr "ドキュメントテーマを適用して、美しいドキュメントを素早く作成することができます。" #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:47 msgid "" @@ -312,6 +361,8 @@ msgid "" "autodoc extension](https://www.sphinx-" "doc.org/en/master/usage/extensions/autodoc.html)" msgstr "" +"[autodocエクステンションを使って、パッケージの関数やクラス(パッケージのAPI)のドキュメントをコードのdocstringから自動的に作成する](https://www.sphinx-" +"doc.org/en/master/usage/extensions/autodoc.html) ことができます。" #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:48 msgid "" @@ -319,6 +370,8 @@ msgid "" "extension](https://www.sphinx-" "doc.org/en/master/usage/extensions/doctest.html)" msgstr "" +"doctestエクステンションを使って、docstringのコード例を [実行してテストする](https://www.sphinx-" +"doc.org/en/master/usage/extensions/doctest.html) ことができます。" #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:49 msgid "" @@ -326,10 +379,12 @@ msgid "" "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` 構文をサポートしています。" #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:51 msgid "Commonly used Sphinx themes" -msgstr "" +msgstr "よく使われるSphinxのテーマ" #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:53 msgid "" @@ -337,26 +392,28 @@ msgid "" "most common Sphinx themes used in the Python scientific community " "include:" msgstr "" +"あなたは好きなSphinxテーマを自由に使うことができます。 " +"しかし、Pythonの科学コミュニティで最もよく使われているSphinxのテーマは次のようなものです:" #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:57 msgid "[pydata-sphinx-theme](https://pydata-sphinx-theme.readthedocs.io/)" -msgstr "" +msgstr "[pydata-sphinx-theme](https://pydata-sphinx-theme.readthedocs.io/)" #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:58 msgid "[sphinx-book-theme](https://sphinx-book-theme.readthedocs.io/)" -msgstr "" +msgstr "[sphinx-book-theme](https://sphinx-book-theme.readthedocs.io/)" #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:59 msgid "[furo](https://pradyunsg.me/furo/quickstart/)" -msgstr "" +msgstr "[furo](https://pradyunsg.me/furo/quickstart/)" #: ../../documentation/hosting-tools/sphinx-python-package-documentation-tools.md:63 msgid "This book is created using Sphinx and the `furo` theme." -msgstr "" +msgstr "この本はSphinxと `furo` というテーマを使って作られています。" #: ../../documentation/hosting-tools/website-hosting-optimizing-your-docs.md:1 msgid "Optimizing your documentation so search engines (and other users) find it" -msgstr "" +msgstr "検索エンジン(および他のユーザー)に見つけてもらえるよう、ドキュメントを最適化する。" #: ../../documentation/hosting-tools/website-hosting-optimizing-your-docs.md:3 msgid "" @@ -364,10 +421,11 @@ msgid "" "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 msgid "Google Analytics" -msgstr "" +msgstr "Google アナリティクス" #: ../../documentation/hosting-tools/website-hosting-optimizing-your-docs.md:11 msgid "" @@ -382,12 +440,19 @@ msgid "" "[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." -msgstr "" +msgstr "pyOpenSci は現在、オープンソース開発者のための無料のオプションを検討しています。" #: ../../documentation/hosting-tools/website-hosting-optimizing-your-docs.md:16 msgid "" @@ -400,6 +465,12 @@ msgid "" "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のサイトタグをドキュメントの各ページに追加します。" #: ../../documentation/hosting-tools/website-hosting-optimizing-your-docs.md:22 msgid "" @@ -407,6 +478,8 @@ msgid "" "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 "" @@ -415,6 +488,9 @@ msgid "" " is the most popular search engine. And if your documentation is search " "optimized, users are more likely to find your package!" msgstr "" +"コンプライアンスやプライバシーの問題からGoogleアナリティクスから離れようとしていますが、検索エンジン最適化は依然として重要です。 " +"Googleは最も人気のある検索エンジンです。 " +"そして、もしあなたのドキュメントが検索に最適化されていれば、ユーザーはあなたのパッケージを見つける可能性が高くなります!" #: ../../documentation/hosting-tools/website-hosting-optimizing-your-docs.md:30 msgid "" @@ -423,10 +499,13 @@ msgid "" "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 "" +"Googleのような検索エンジンのために文書を最適化することに興味があるなら、 **sitemap.xml** ファイルが必要です。 " +"このサイトマップをGoogleに送信すると、Googleはあなたのサイト全体をインデックスします。 " +"このサイトマップをGoogleに送信することで、サイト全体がインデックスされ、サイト内のコンテンツが検索されやすくなります。" #: ../../documentation/hosting-tools/website-hosting-optimizing-your-docs.md:36 msgid "This extension is lightweight." -msgstr "" +msgstr "このエクステンションは軽量です。" #: ../../documentation/hosting-tools/website-hosting-optimizing-your-docs.md:38 msgid "" @@ -434,10 +513,14 @@ msgid "" "and site your documentation base url](https://sphinx-" "sitemap.readthedocs.io/en/latest/getting-started.html)." msgstr "" +"これは、 [Sphinxの `conf.py` " +"拡張機能リストに追加し、ドキュメントのベースURLを指定する必要があります](https://sphinx-" +"sitemap.readthedocs.io/en/latest/getting-started.html) 。" #: ../../documentation/hosting-tools/website-hosting-optimizing-your-docs.md:40 msgid "[sphinxext.opengraph](https://github.com/wpilibsuite/sphinxext-opengraph)" msgstr "" +"[sphinxext.opengraph](https://github.com/wpilibsuite/sphinxext-opengraph)" #: ../../documentation/hosting-tools/website-hosting-optimizing-your-docs.md:42 msgid "" @@ -450,87 +533,91 @@ msgid "" "like Twitter and Mastodon and even for shares on tools like Slack and " "Discourse." msgstr "" +"OpenGraphは、ドキュメントのコンテンツページにメタデータを追加できる拡張機能です。 " +"[OpenGraphプロトコルは、共有されたときに他のウェブサイトがあなたのページのコンテンツの有用なプレビューを提供することを可能にします](https://www.freecodecamp.org/news/what-" +"is-open-graph-and-how-can-i-use-it-for-my-website/#what-is-open-graph) 。 " +"これは、あなたのドキュメントのページがTwitterやMastodonのようなソーシャルメディアサイトで共有されるときや、SlackやDiscourseのようなツールで共有されるときにも重要です。" #: ../../documentation/index.md:3 msgid "Documentation Overview" -msgstr "" +msgstr "ドキュメントの概要" #: ../../documentation/index.md:3 ../../documentation/index.md:10 #: ../../documentation/index.md:21 ../../documentation/index.md:42 msgid "Intro" -msgstr "" +msgstr "イントロ" #: ../../documentation/index.md:10 msgid "Create Your Docs" -msgstr "" +msgstr "ドキュメントの作成" #: ../../documentation/index.md:10 msgid "Document Your Code (API)" -msgstr "" +msgstr "コードを文書化する(API)" #: ../../documentation/index.md:10 msgid "Create Package Tutorials" -msgstr "" +msgstr "チュートリアルパッケージの作成" #: ../../documentation/index.md:10 msgid "Write User Documentation" -msgstr "" +msgstr "ユーザードキュメントの作成" #: ../../documentation/index.md:21 msgid "Contributing File" -msgstr "" +msgstr "貢献ファイル" #: ../../documentation/index.md:21 msgid "Development Guide" -msgstr "" +msgstr "開発ガイド" #: ../../documentation/index.md:21 msgid "Changelog File" -msgstr "" +msgstr "変更履歴ファイル" #: ../../documentation/index.md:21 msgid "Docs for Contributors & Maintainers" -msgstr "" +msgstr "コントリビューターとメンテナーのためのドキュメント" #: ../../documentation/index.md:32 msgid "README file" -msgstr "" +msgstr "README ファイル" #: ../../documentation/index.md:32 msgid "Code of Conduct File" -msgstr "" +msgstr "行動規範ファイル" #: ../../documentation/index.md:32 msgid "LICENSE files" -msgstr "" +msgstr "ライセンスファイル" #: ../../documentation/index.md:32 msgid "Community Docs" -msgstr "" +msgstr "コミュニティドキュメント" #: ../../documentation/index.md:42 msgid "Sphinx for Docs" -msgstr "" +msgstr "ドキュメント用Sphinx" #: ../../documentation/index.md:42 msgid "myST vs Markdown vs rst" -msgstr "" +msgstr "myST vs Markdown vs rst" #: ../../documentation/index.md:42 msgid "Publish Your Docs" -msgstr "" +msgstr "ドキュメントを公開する" #: ../../documentation/index.md:42 msgid "Website Hosting and Optimization" -msgstr "" +msgstr "ウェブサイトのホスティングと最適化" #: ../../documentation/index.md:42 msgid "Publication tools for your docs" -msgstr "" +msgstr "ドキュメント出版ツール" #: ../../documentation/index.md:1 msgid "Documentation for your Open Source Python Package" -msgstr "" +msgstr "オープンソースPythonパッケージのドキュメント" #: ../../documentation/index.md:55 msgid "" @@ -542,16 +629,19 @@ msgid "" "requirements. Our requirements are focused on the documentation content " "of your package." msgstr "" +"ここで取り上げているツールは、コミュニティで一般的に使用されているものです。 ツールの進化に伴い、このガイドを更新します。 " +"pyOpenSci査読のためにパッケージを提出し、パッケージを構築するためにガイドに記載されていない他のツールを使用する場合でも、査読のために提出することができます！" +" ここに挙げたツールは提案であり、要件ではありません。 私たちの要求は、あなたのパッケージの文書内容に焦点を当てています。" #: ../../documentation/index.md:65 msgid "Documentation is critical for your Python package's success" -msgstr "" +msgstr "Pythonパッケージの成功にはドキュメンテーションが欠かせません" #: ../../documentation/index.md:67 msgid "" "Documentation is as important to the success of your Python open source " "package as the code itself." -msgstr "" +msgstr "ドキュメンテーションは、あなたのPythonオープンソースパッケージの成功にとって、コードそのものと同じくらい重要です。" #: ../../documentation/index.md:70 msgid "" @@ -559,26 +649,28 @@ msgid "" " 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." -msgstr "" +"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 msgid "Two types of Python package users" -msgstr "" +msgstr "Pythonパッケージユーザーの2つのタイプ" #: ../../documentation/index.md:78 msgid "" "The documentation that you write for your package should target two types" " of users:" -msgstr "" +msgstr "パッケージのために書くドキュメントは、2つのタイプのユーザーをターゲットにすべきです:" #: ../../documentation/index.md:81 msgid "1. Basic Tool Users" -msgstr "" +msgstr "1. 基本ツールユーザー" #: ../../documentation/index.md:83 msgid "" @@ -587,56 +679,61 @@ msgid "" " expert programmers. But they might not have a background in software " "development. These users need to know:" msgstr "" +"基本ツールユーザーは、あなたのパッケージコードを Python ワークフローで使用する人たちです。 " +"彼らはPythonやデータサイエンスの(より)初心者かもしれません。 あるいは熟練プログラマーかもしれません。 " +"しかし、彼らはソフトウェア開発のバックグラウンドを持っていないかもしれません。 このようなユーザーは以下のことを知っておく必要があります:" #: ../../documentation/index.md:88 msgid "How to install your package" -msgstr "" +msgstr "パッケージのインストール方法" #: ../../documentation/index.md:89 msgid "How to install dependencies that your package requires" -msgstr "" +msgstr "パッケージが必要とする依存関係をインストールする方法" #: ../../documentation/index.md:90 msgid "How to get started using the code base" -msgstr "" +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." -msgstr "" +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." msgstr "" +"あなたのコードが使用するライセンスに関する情報を提供することで、運用環境においてコードをどのように使用できるか、または使用できないかを知ってもらいます。" #: ../../documentation/index.md:96 msgid "2. Potential tool contributors" -msgstr "" +msgstr "2. ツールコントリビュータ候補" #: ../../documentation/index.md:98 msgid "" "The other subset of users are more experienced and/or more engaged with " "your package. As such they are potential contributors. These users:" msgstr "" +"もう一組のユーザは、経験が豊富で、かつ/またはあなたのパッケージにより深く関わっています。 彼らは潜在的な貢献者です。 これらのユーザーは:" #: ../../documentation/index.md:102 msgid "might have a software development background," -msgstr "" +msgstr "ソフトウェア開発のバックグラウンドを持っているかもしれない、" #: ../../documentation/index.md:103 msgid "" "might also be able to contribute bug fixes to your package or updates to " "your documentation" -msgstr "" +msgstr "また、パッケージのバグフィックスやドキュメントの更新に貢献できるかもしれません。" #: ../../documentation/index.md:104 msgid "" "might also just be users who will find spelling errors in your " "documentation, or bugs in your tutorials." -msgstr "" +msgstr "また、ドキュメントのスペルミスやチュートリアルのバグを見つけるユーザーもいるかもしれません。" #: ../../documentation/index.md:106 msgid "" @@ -644,18 +741,20 @@ msgid "" "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." -msgstr "" +msgstr "パッケージリポジトリで使われているインフラを理解するための開発ガイドです。" #: ../../documentation/index.md:111 msgid "" "Contributing guidelines that clarify the types of contributions that you " "welcome and how you'd prefer those contributions to be submitted." -msgstr "" +msgstr "どのような貢献の投稿を歓迎し、どのように貢献をしてほしいかを明確にした貢献ガイドライン。" #: ../../documentation/index.md:114 msgid "" @@ -665,10 +764,11 @@ msgid "" "a code fix that includes a new test that covers an edge-case that they " "discovered." msgstr "" +"重要なのは、貢献の定義は幅広いということを覚えておくことです。貢献とは、バグ報告のような単純なものでもよいのです。あるいは、ドキュメントのスペルの問題を修正する。あるいは、彼らが発見したエッジケースをカバーする新しいテストを含むコード修正かもしれません。" #: ../../documentation/index.md:120 msgid "Documentation elements that pyOpenSci looks for reviewing a Python package" -msgstr "" +msgstr "pyOpenSciがPythonパッケージをレビューする際に注目するドキュメント要素" #: ../../documentation/index.md:122 msgid "" @@ -677,17 +777,18 @@ msgid "" "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." -msgstr "" +msgstr "このガイドでは、各必須要素について説明し、パッケージの文書で考慮すべきその他の要素についても詳しく説明します。" #: ../../documentation/index.md:131 msgid "View pyOpenSci peer review check list" -msgstr "" +msgstr "pyOpenSci査読チェックリストを見る" #: ../../documentation/index.md:138 msgid "" @@ -695,6 +796,8 @@ msgid "" "in the image include code of conduct.md contributing.md license.txt and " "readme.md." msgstr "" +"MovingPandasのGitHubリポジトリにあるファイルを示す画像。画像内のファイルには、code of conduct.md " +"contributing.md license.txtとreadme.mdが含まれています。" #: ../../documentation/index.md:144 msgid "" @@ -702,10 +805,12 @@ msgid "" "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日撮影 )* 。" #: ../../documentation/index.md:147 msgid "What's next in this Python package documentation section?" -msgstr "" +msgstr "このPythonパッケージのドキュメントセクションの次は何でしょうか？" #: ../../documentation/index.md:149 msgid "" @@ -714,10 +819,12 @@ msgid "" "will also suggest tools that you can use to build your user-facing " "documentation website." msgstr "" +"pyOpenSciパッケージガイドのこのセクションでは、Pythonパッケージのドキュメントを設定するためのベストプラクティスを説明します。 " +"また、ユーザー向けのドキュメントサイトを構築するために使用できるツールも提案します。" #: ../../documentation/index.md:154 msgid "Todo" -msgstr "" +msgstr "Todo" #: ../../documentation/index.md:156 msgid "" @@ -727,14 +834,17 @@ msgid "" "is that the package should support, at least, the latest three Python " "versions (e.g., 3.8, 3.7, 3.6)." msgstr "" +"Pythonのバージョンサポート あなたのパッケージがどのバージョンのPythonをサポートしているか、常に明示しておくべきです。 " +"Pythonの古いバージョンとの互換性を保つことは、機能が変わるにつれて難しくなります。 " +"良い経験則として、パッケージは少なくとも最新の3つのPythonバージョン（例えば、3.8、3.7、3.6）をサポートするべきです。" #: ../../documentation/repository-files/changelog-file.md:1 msgid "CHANGELOG.md Guide" -msgstr "" +msgstr "CHANGELOG.md ガイド" #: ../../documentation/repository-files/changelog-file.md:3 msgid "Introduction" -msgstr "" +msgstr "はじめに" #: ../../documentation/repository-files/changelog-file.md:5 msgid "" @@ -744,10 +854,12 @@ msgid "" "contributors stay informed about new features, bug fixes, and other " "changes introduced in each release." msgstr "" +"`CHANGELOG.md` ドキュメントは、開発者にとってもユーザーにとっても、プロジェクトの進化を追跡するための貴重なリソースとなります。 " +"変更履歴の構造と目的を理解することで、ユーザーや貢献者は各リリースで導入された新機能やバグ修正、その他の変更について常に情報を得ることができます。" #: ../../documentation/repository-files/changelog-file.md:7 msgid "What is CHANGELOG.md?" -msgstr "" +msgstr "CHANGELOG.mdとは？" #: ../../documentation/repository-files/changelog-file.md:9 msgid "" @@ -756,38 +868,47 @@ msgid "" "users understand what has been added, fixed, modified, or removed with " "each version of the software." msgstr "" +"`CHANGELOG.md` の主な目的は、新しいリリースごとにプロジェクトに加えられた注目すべき変更の記録を提供することです。 " +"このドキュメントは、ソフトウェアの各バージョンで何が追加、修正、変更、削除されたかをユーザーが理解するのに役立ちます。" #: ../../documentation/repository-files/changelog-file.md:11 msgid "" "[Keep a CHAGELOG.md](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." +"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/)は、変更ログとは何か、どのように良い変更ログを作成するかを理解するための、シンプルで素晴らしいリソースです。" +" また、避けるべきことの例も含まれています。" #: ../../documentation/repository-files/changelog-file.md:13 msgid "Versioning your Python package and semantic versioning" -msgstr "" +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)" msgstr "" +"[Python パッケージの新しいバージョンの作成](../../package-structure-code/python-package-" +"versions.md)" #: ../../documentation/repository-files/changelog-file.md:18 msgid "[Semantic Versioning](https://semver.org)" -msgstr "" +msgstr "[セマンティック バージョニング](https://semver.org)" #: ../../documentation/repository-files/changelog-file.md:21 msgid "Why is it important?" -msgstr "" +msgstr "なぜそれが重要なのか？" #: ../../documentation/repository-files/changelog-file.md:23 msgid "" @@ -797,10 +918,13 @@ msgid "" " changelog up-to-date, project maintainers can build trust with their " "user base and demonstrate their commitment to improving the software." msgstr "" +"ユーザーや開発者との透明性のあるコミュニケーションには、よく管理された変更履歴が不可欠です。 " +"変更ログは、変更点を文書化し、各リリースでの進捗をハイライトするための一元的なハブとして機能します。 " +"変更履歴を常に最新の状態に保つことで、プロジェクトメンテナはユーザーベースとの信頼を築き、ソフトウェアを改善するというコミットメントを示すことができます。" #: ../../documentation/repository-files/changelog-file.md:25 msgid "What does it include?" -msgstr "" +msgstr "その内容は？" #: ../../documentation/repository-files/changelog-file.md:27 msgid "" @@ -809,18 +933,23 @@ msgid "" " may vary depending on the project's conventions, some common elements " "found in changelogs for Python packages include:" msgstr "" +"changelog.md ファイルの内容は一般的に構造化されたフォーマットに従い、各リリースで導入された変更の詳細を記述します。 " +"正確なフォーマットはプロジェクトの規約によって異なるかもしれませんが、 Python パッケージの changelog " +"でよく見られる要素には以下のようなものがあります：" #: ../../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." msgstr "" +"**Versioning**： " +"セマンティックバージョニング、またはプロジェクトが採用するその他のバージョニングスキームを使って、各リリースのバージョンを明確に識別すること。" #: ../../documentation/repository-files/changelog-file.md:31 msgid "" "**Release Date**: The date when each version was released to the public, " "providing context for the timeline of changes." -msgstr "" +msgstr "**Release Date**: 各バージョンが公開された日付で、変更のタイムラインのコンテキストを提供します。" #: ../../documentation/repository-files/changelog-file.md:33 msgid "" @@ -828,13 +957,15 @@ msgid "" "\"Added,\" \"Changed,\" \"Fixed,\" and \"Removed\" to facilitate " "navigation and understanding." msgstr "" +"**変更カテゴリー**: 変更を \"Added,\" \"Changed,\" \"Fixed,\" \"Removed\" " +"などのカテゴリーに整理し、ナビゲーションと理解を容易にします。" #: ../../documentation/repository-files/changelog-file.md:35 msgid "" "**Description of Changes**: A concise description of the changes made in " "each category, including new features, enhancements, bug fixes, and " "deprecated functionality." -msgstr "" +msgstr "**変更の内容**: 新機能、機能強化、バグフィックス、非推奨機能を含む、各カテゴリーにおける変更点の簡潔な説明。" #: ../../documentation/repository-files/changelog-file.md:37 msgid "" @@ -842,32 +973,34 @@ msgid "" "tracker items or pull requests associated with each change, enabling " "users to access more detailed information if needed." 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." -msgstr "" +msgstr "**アップグレード手順**: 最新バージョンへのアップグレード方法に関するガイダンス、注意すべき変更点や移行手順を含みます。" #: ../../documentation/repository-files/changelog-file.md:41 msgid "" "**Contributor Recognition**: Acknowledgment of contributors who made " "significant contributions to the release, fostering a sense of community " "and appreciation for their efforts." -msgstr "" +msgstr "**コントリビューターの認識**: リリースに多大な貢献をした貢献者を認識し、彼らの努力に対する感謝の気持ちと共同体意識を醸成します。" #: ../../documentation/repository-files/changelog-file.md:43 msgid "How do maintainers use it?" -msgstr "" +msgstr "メンテナーはどのように使っているのか？" #: ../../documentation/repository-files/changelog-file.md:45 msgid "Often you will see a changelog that documents a few things:" -msgstr "" +msgstr "多くの場合、変更履歴を見ることができます:" #: ../../documentation/repository-files/changelog-file.md:47 msgid "Unreleased Section" -msgstr "" +msgstr "未リリースセクション" #: ../../documentation/repository-files/changelog-file.md:49 msgid "" @@ -875,26 +1008,28 @@ msgid "" "`Unreleased` section. This is where you can add new fixes, updates and " "features that have been added to the package since the last release." msgstr "" +"未リリースのコミットは変更履歴の一番上にあり、一般的には `Unreleased` セクションにあります。 " +"ここには、前回のリリース以降にパッケージに追加された新しい修正、更新、機能を追加することができます。" #: ../../documentation/repository-files/changelog-file.md:51 msgid "This section might look something like this:" -msgstr "" +msgstr "このセクションは次のようなものです:" #: ../../documentation/repository-files/changelog-file.md:59 msgid "Release Sections" -msgstr "" +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." -msgstr "" +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." -msgstr "" +msgstr "この特定のリリースセクションは、未リリースセクションの下に位置し、更新、追加、非推奨、貢献者を含むことができます。" #: ../../documentation/repository-files/changelog-file.md:65 msgid "" @@ -902,36 +1037,43 @@ msgid "" "features continue to be added there. At the same time, after releasing a " "version like v1.0 all of its features remain in that specific section." msgstr "" +"未発表のセクションは常にファイルの一番上にあり、新しい機能はそこに追加され続けます。 " +"同時に、v1.0のようなバージョンをリリースした後も、すべての機能はその特定のセクションに残ります。" #: ../../documentation/repository-files/changelog-file.md:83 msgid "What does it look like?" -msgstr "" +msgstr "それはどのようなものですか？" #: ../../documentation/repository-files/changelog-file.md:85 msgid "" "This example comes from [Devicely](https://github.com/hpi-" "dhc/devicely/blob/main/CHANGELOG.md), a pyOpenSci accepted package." msgstr "" +"この例はpyOpenSci受諾パッケージの [Devicely](https://github.com/hpi-" +"dhc/devicely/blob/main/CHANGELOG.md) から来ています。" #: ../../documentation/repository-files/code-of-conduct-file.md:1 msgid "The CODE_OF_CONDUCT file - Python Packaging" -msgstr "" +msgstr "CODE_OF_CONDUCT ファイル - Python Packaging" #: ../../documentation/repository-files/code-of-conduct-file.md:3 msgid "Example CODE_OF_CONDUCT files" -msgstr "" +msgstr "CODE_OF_CONDUCT ファイルの例" #: ../../documentation/repository-files/code-of-conduct-file.md:6 msgid "" "[SciPy Code of Conduct file - notice they included theirs in their " "documentation](https://docs.scipy.org/doc/scipy/dev/conduct/code_of_conduct.html)" msgstr "" +"[SciPyの行動規範ファイル - " +"彼らのドキュメントに含まれていることに注目](https://docs.scipy.org/doc/scipy/dev/conduct/code_of_conduct.html)" #: ../../documentation/repository-files/code-of-conduct-file.md:7 msgid "" "[fatiando CODE_OF_CONDUCT.md " "file](https://github.com/fatiando/community/blob/main/CODE_OF_CONDUCT.md)" msgstr "" +"[fatiandoのCODE_OF_CONDUCT.mdファイル](https://github.com/fatiando/community/blob/main/CODE_OF_CONDUCT.md)" #: ../../documentation/repository-files/code-of-conduct-file.md:10 msgid "" @@ -941,16 +1083,22 @@ msgid "" "community uses your tool. These users may have questions or encounter " "challenges using your package." msgstr "" +"あなたのパッケージには、リポジトリのルートに `CODE_OF_CONDUCT.md` ファイルがあるはずです。 " +"あなたのパッケージを使っている人がいれば、そのパッケージ自体にコミュニティがあると考えることができます。 " +"このコミュニティの一部は、あなたのツールを使っています。 " +"このようなユーザは、あなたのパッケージを使用する際に質問をしたり、問題に遭遇するかもしれません。" #: ../../documentation/repository-files/code-of-conduct-file.md:16 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 "" +"コミュニティの他の人たちも、あなたのツールに貢献したいと思うかもしれません。 " +"バグを修正したり、ドキュメントを更新したり、メンテナチームと関わりを持ったりするかもしれません。" #: ../../documentation/repository-files/code-of-conduct-file.md:20 msgid "Why you need a CODE_OF_CONDUCT" -msgstr "" +msgstr "CODE_OF_CONDUCTが必要な理由" #: ../../documentation/repository-files/code-of-conduct-file.md:22 msgid "" @@ -958,6 +1106,8 @@ msgid "" "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/) を持つことが重要です。" #: ../../documentation/repository-files/code-of-conduct-file.md:26 msgid "" @@ -967,6 +1117,9 @@ msgid "" "enforced if need be to protect others from harmful and/or negative " "behaviors." msgstr "" +"`CODE_OF_CONDUCT` " +"は、利用者や貢献者がメンテナや他の利用者とどのように交流するかという点で、あなたが期待することを定めるものとして重要です。 " +"また、有害な行動や否定的な行動から他の人を守るために、必要であれば強制することができる規則や期待も確立します。" #: ../../documentation/repository-files/code-of-conduct-file.md:32 msgid "" @@ -979,30 +1132,41 @@ msgid "" "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 " +"Pythonコミュニティの例はこちら](https://github.com/fatiando/community/blob/main/CODE_OF_CONDUCT.md)" +" を参照してください。" #: ../../documentation/repository-files/contributing-file.md:1 msgid "Contributing File in your Python Open Source Package" -msgstr "" +msgstr "Pythonオープンソースパッケージにファイルを貢献する" #: ../../documentation/repository-files/contributing-file.md:3 msgid "What a CONTRIBUTING.md file should contain" -msgstr "" +msgstr "CONTRIBUTING.md ファイルが含むべき内容" #: ../../documentation/repository-files/contributing-file.md:5 msgid "Example contributing files" -msgstr "" +msgstr "貢献ファイルの例" #: ../../documentation/repository-files/contributing-file.md:8 msgid "" "[pyGMT contributing " "file](https://github.com/GenericMappingTools/pygmt/blob/main/CONTRIBUTING.md)" msgstr "" +"[pyGMT " +"貢献ファイル](https://github.com/GenericMappingTools/pygmt/blob/main/CONTRIBUTING.md)" #: ../../documentation/repository-files/contributing-file.md:9 msgid "" "[fatiando verde's contributing " "file](https://github.com/fatiando/verde/blob/main/CONTRIBUTING.md)" msgstr "" +"[fatiando " +"verdeの貢献ファイル](https://github.com/fatiando/verde/blob/main/CONTRIBUTING.md)" #: ../../documentation/repository-files/contributing-file.md:12 msgid "" @@ -1010,13 +1174,15 @@ msgid "" "**CONTRIBUTING.md** located in the root of your repository (with your " "**README.md** file)." msgstr "" +"あなたのPythonオープンソースパッケージは、リポジトリのルートに **CONTRIBUTING.md** というファイルを含むべきです（ " +"**README.md** ファイルと一緒に）。" #: ../../documentation/repository-files/contributing-file.md:15 msgid "" "The contributing file should include information about the types of " "contributions that you welcome, and how you'd like to see contributions " "happen." -msgstr "" +msgstr "貢献ファイルには、歓迎する貢献の種類や、どのように貢献してほしいかについての情報を記載します。" #: ../../documentation/repository-files/contributing-file.md:19 msgid "" @@ -1024,28 +1190,29 @@ msgid "" "asking questions, submitting issues or pull requests. It should have " "things like:" msgstr "" +"このガイドには、質問や課題の提出、プルリクエストに興味がある人のための情報も含まれていなければなりません。 以下のようなことが書かれているべきです:" #: ../../documentation/repository-files/contributing-file.md:22 msgid "" "Any guidelines that you have in place for users submitting issues, pull " "requests or asking questions." -msgstr "" +msgstr "課題、プルリクエスト、質問を提出するユーザーに対して設けているガイドライン。" #: ../../documentation/repository-files/contributing-file.md:23 msgid "A link to your code of conduct" -msgstr "" +msgstr "行動規範へのリンク" #: ../../documentation/repository-files/contributing-file.md:24 msgid "A link to licensing information found in your README file." -msgstr "" +msgstr "READMEファイルにあるライセンス情報へのリンク。" #: ../../documentation/repository-files/contributing-file.md:25 msgid "A link to a development guide if you have one" -msgstr "" +msgstr "もしあれば開発ガイドへのリンク" #: ../../documentation/repository-files/development-guide.md:1 msgid "What the development guide for your Python package should contain" -msgstr "" +msgstr "Pythonパッケージの開発ガイドに含めるべき内容" #: ../../documentation/repository-files/development-guide.md:3 msgid "" @@ -1054,28 +1221,30 @@ msgid "" "CONTRIBUTING.md file (discussed above). A development guide should " "clearly show technically proficient users how to:" msgstr "" +"理想的には、あなたのパッケージは開発ガイドを持つべきです。 このファイルはあなたのパッケージのドキュメントにあり、 " +"CONTRIBUTING.mdファイル(前述)からリンクされるべきです。 開発ガイドは、技術的に熟達したユーザに対して、以下の方法を明確に示すべきです:" #: ../../documentation/repository-files/development-guide.md:7 msgid "Set up a development environment locally to work on your package" -msgstr "" +msgstr "開発環境をローカルにセットアップし、パッケージで作業できるようにする" #: ../../documentation/repository-files/development-guide.md:8 msgid "Run the test suite" -msgstr "" +msgstr "テストスイートの実行" #: ../../documentation/repository-files/development-guide.md:9 msgid "Build documentation locally" -msgstr "" +msgstr "ドキュメントをローカルにビルドする" #: ../../documentation/repository-files/development-guide.md:11 msgid "The development guide should also have guidelines for:" -msgstr "" +msgstr "開発ガイドには、次のようなガイドラインもあるはずです:" #: ../../documentation/repository-files/development-guide.md:12 msgid "" "code standards including docstring style, code format and any specific " "code approaches that the package follows." -msgstr "" +msgstr "docstringスタイルを含むコード標準、コードフォーマットと、パッケージが従う特定のコードアプローチ。" #: ../../documentation/repository-files/development-guide.md:14 msgid "" @@ -1083,30 +1252,31 @@ msgid "" "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:16 msgid "" "If you have time to document it, it's also helpful to document your " "maintainer workflow and release processes." -msgstr "" +msgstr "もし文書化する時間があれば、メンテナのワークフローやリリースプロセスを文書化することも有用です。" #: ../../documentation/repository-files/development-guide.md:18 msgid "Why a development guide is important" -msgstr "" +msgstr "開発ガイドが重要な理由" #: ../../documentation/repository-files/development-guide.md:20 msgid "It's valuable to have a development guide, in the case that you wish to:" -msgstr "" +msgstr "開発ガイドを持つことは価値があります、もしそうしたいのであれば:" #: ../../documentation/repository-files/development-guide.md:23 msgid "Onboard new maintainers." -msgstr "" +msgstr "新しいメンテナーを迎える。" #: ../../documentation/repository-files/development-guide.md:24 msgid "" "Allow technically inclined contributors to make thoughtful and useful " "code based pull requests to your repository." -msgstr "" +msgstr "技術志向のコントリビューターが、あなたのリポジトリに対して、思慮深く有用なコードベースのプルリクエストを行えるようにします。" #: ../../documentation/repository-files/development-guide.md:26 msgid "" @@ -1114,6 +1284,7 @@ msgid "" "documented in the case that we need to help you onboard new maintainers " "in the future." msgstr "" +"また、pyOpenSciにとって、将来新しいメンテナーの参加を支援する必要がある場合に備えて、メンテナンスのワークフローを文書化しておくことも重要です。" #: ../../documentation/repository-files/development-guide.md:31 msgid "" @@ -1121,6 +1292,7 @@ msgid "" "allow users to skip building the package locally (especially if they are " "just updating text)." msgstr "" +"リポジトリによく考えられた継続的インテグレーションのセットアップがあれば、ユーザーはローカルでのパッケージのビルドを省略することができる（特にテキストを更新するだけの場合）。" #: ../../documentation/repository-files/development-guide.md:36 msgid "" @@ -1129,6 +1301,7 @@ msgid "" "Some maintainers may also opt to include the development information in " "their contributing guide." msgstr "" +"開発ガイドは強く推奨されますが、pyOpenSciがレビューの対象とするためにパッケージに要求するファイルではありません。メンテナによっては、コントリビューティングガイドに開発情報を含めることもできます。" #: ../../documentation/repository-files/development-guide.md:43 msgid "" @@ -1136,10 +1309,13 @@ msgid "" " when creating a contributing guide](https://mozillascience.github.io" "/working-open-workshop/contributing/)" msgstr "" +"[Mozilla Science " +"Labのウェブサイトには、寄稿ガイドを作成する際に考慮すべきことの素晴らしいアウトラインがあります](https://mozillascience.github.io/working-" +"open-workshop/contributing/)" #: ../../documentation/repository-files/intro.md:1 msgid "Documentation Files That Should be in your Python Package Repository" -msgstr "" +msgstr "Pythonパッケージリポジトリにあるべきドキュメントファイル" #: ../../documentation/repository-files/intro.md:3 msgid "" @@ -1147,6 +1323,8 @@ msgid "" " that you should have in your Python package repository. Your Python " "package should, at a minimum have the following files:" msgstr "" +"Python パッケージングガイドのこのセクションでは、Python パッケージリポジトリにあるべきすべてのファイルをレビューします。 Python " +"パッケージには最低限以下のファイルが必要です:" #: ../../documentation/repository-files/intro.md:7 msgid "" @@ -1155,6 +1333,9 @@ msgid "" "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 " +"リポジトリで利用できます。" #: ../../documentation/repository-files/intro.md:13 msgid "" @@ -1164,6 +1345,8 @@ msgid "" "Security policy has a yellow circle next to it as that is missing from " "the repo." msgstr "" +"MovingPandasのGitHubリポジトリコミュニティの健全性を示す画像で、説明、README、行動規範、貢献、ライセンス、課題テンプレートを含む各ファイルの横に緑色のチェックが付いています。" +" セキュリティポリシーは黄色い丸で囲まれています。" #: ../../documentation/repository-files/intro.md:19 msgid "" @@ -1173,6 +1356,10 @@ msgid "" "repo](https://github.com/anitagraser/movingpandas/community) *(screen " "shot taken Nov 23 2022)*" msgstr "" +"GitHub community health は、リポジトリのコミュニティレベルの健全性を評価する際に、他の要素の中から readme " +"ファイルを探します。この例は、 [MovingPandas GitHub " +"repo](https://github.com/anitagraser/movingpandas/community) " +"*(2022年11月23日撮影のスクリーンショット)* からのものです。" #: ../../documentation/repository-files/intro.md:22 msgid "" @@ -1180,6 +1367,8 @@ msgid "" " 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) もパッケージの健全性を監視している有名な会社です。 " +"以下では、コミュニティの健全性を測る尺度として、Github リポジトリ内のファイルに対する同様の評価を見ることができます。" #: ../../documentation/repository-files/intro.md:26 msgid "" @@ -1188,6 +1377,9 @@ msgid "" " shows that it has 30 contributors and no funding. The package health " "score is 78/100." msgstr "" +"movingpandasのSnykページのスクリーンショットです。 " +"このリポジトリには、READMEファイル、貢献ファイル、行動規範があることがわかります。 また、30人の貢献者がいて、資金提供はないことがわかります。 " +"パッケージのヘルススコアは78/100です。" #: ../../documentation/repository-files/intro.md:32 msgid "" @@ -1195,10 +1387,12 @@ msgid "" "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日撮影)* 。" #: ../../documentation/repository-files/license-files.md:1 msgid "License files for scientific Python open source software" -msgstr "" +msgstr "科学的Pythonオープンソースソフトウェアのライセンスファイル" #: ../../documentation/repository-files/license-files.md:3 msgid "" @@ -1208,7 +1402,7 @@ msgstr "" #: ../../documentation/repository-files/license-files.md:10 msgid "What is a Open Source License file?" -msgstr "" +msgstr "オープンソースライセンスファイルとは何ですか？" #: ../../documentation/repository-files/license-files.md:12 msgid "" @@ -1217,10 +1411,11 @@ msgid "" "describes to your users how they can legally use (and not use) your " "package." msgstr "" +"LICENSEファイルというのは、GitHubやGitLabのリポジトリにあるファイルのことです。このファイルには、あなたのパッケージをユーザーが合法的に使う（あるいは使わない）方法が書かれています。" #: ../../documentation/repository-files/license-files.md:16 msgid "Why licenses are important" -msgstr "" +msgstr "ライセンスが重要な理由" #: ../../documentation/repository-files/license-files.md:18 msgid "" @@ -1228,22 +1423,24 @@ msgid "" "protects both you as a maintainer and your users. The license file helps " "your users and the community understand:" msgstr "" +"ライセンスファイルは、メンテナであるあなたとユーザの両方を保護するため、すべてのオープンソースプロジェクトにとって重要です。 " +"ライセンスファイルは、あなたのユーザとコミュニティの理解を助けます:" #: ../../documentation/repository-files/license-files.md:20 msgid "How they can use your software" -msgstr "" +msgstr "ソフトウェアの利用方法" #: ../../documentation/repository-files/license-files.md:21 msgid "Whether the software can be reused or adapted for other purposes" -msgstr "" +msgstr "ソフトウェアの再利用や他の目的への転用が可能かどうか" #: ../../documentation/repository-files/license-files.md:22 msgid "How people can contribute to your project" -msgstr "" +msgstr "プロジェクトに貢献する方法" #: ../../documentation/repository-files/license-files.md:24 msgid "and more." -msgstr "" +msgstr "などなど。" #: ../../documentation/repository-files/license-files.md:26 msgid "" @@ -1252,16 +1449,18 @@ msgid "" "package.](https://opensource.guide/legal/#just-give-me-the-tldr-on-what-i" "-need-to-protect-my-project)" msgstr "" +"[科学的なPythonオープンソースパッケージのメンテナであるあなたとユーザの両方を保護するために、ライセンスファイルが重要である理由についてもっと読む](https://opensource.guide/legal/#just-" +"give-me-the-tldr-on-what-i-need-to-protect-my-project)" #: ../../documentation/repository-files/license-files.md:29 msgid "Where to store your license" -msgstr "" +msgstr "ライセンスの保管場所" #: ../../documentation/repository-files/license-files.md:31 msgid "" "Your `LICENSE` file should be stored at root of your GitHub / GitLab " "repository." -msgstr "" +msgstr "`LICENSE` ファイルは GitHub / GitLab リポジトリのルートに保存してください。" #: ../../documentation/repository-files/license-files.md:33 msgid "" @@ -1271,16 +1470,19 @@ msgid "" "templates provided both by GitHub and/or the " "[choosealicense.com](https://choosealicense.com/) website." msgstr "" +"特定の理由からライセンスファイルの言葉をカスタマイズするメンテナもいます。 しかし、これから始めるのであれば、寛容なライセンスを選択し、GitHubや " +"[choosealicense.com](https://choosealicense.com/) " +"のウェブサイトで提供されている法的な言語テンプレートを使うことをお勧めします。" #: ../../documentation/repository-files/license-files.md:36 msgid "" "Licenses are legally binding, as such you should avoid trying to create " "your own license unless you have the guidance of legal council." -msgstr "" +msgstr "ライセンスには法的拘束力があるため、法律顧問の指導がない限り、独自のライセンスを作成しようとするのは避けるべきです。" #: ../../documentation/repository-files/license-files.md:38 msgid "Use open permissive licenses when possible" -msgstr "" +msgstr "可能な限りオープンパーミッシブライセンスを使用する" #: ../../documentation/repository-files/license-files.md:40 msgid "" @@ -1290,16 +1492,22 @@ msgid "" "review](https://www.pyopensci.org/about-peer-review/index.html), then we " "require an OSI approved license." msgstr "" +"一般的に、 [Open Software Initiative (OSI) " +"approved](https://opensource.org/licenses/)の寛容なライセンスを使用することを推奨します。 " +"もしあなたが[査読のためにpyOpenSciにパッケージを提出する](https://www.pyopensci.org/about-peer-" +"review/index.html) のであれば、OSIが承認したライセンスが必要です。" #: ../../documentation/repository-files/license-files.md:44 msgid "How to choose a license" -msgstr "" +msgstr "ライセンスの選び方" #: ../../documentation/repository-files/license-files.md:46 msgid "" "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/) " +"を使うことをお勧めします。" #: ../../documentation/repository-files/license-files.md:49 msgid "" @@ -1308,10 +1516,12 @@ msgid "" "repository. However in some cases the license that you want is not " "available through that online process." msgstr "" +"GitHub リポジトリの新規作成時にライセンスを選択すると、自動的にライセンスファイルのテキストコピーを取得してリポジトリに追加することもできます。 " +"しかし、オンラインプロセスでは希望のライセンスが取得できないこともあります。" #: ../../documentation/repository-files/license-files.md:54 msgid "License recommendations from the SciPy package" -msgstr "" +msgstr "SciPyパッケージからのライセンス勧告" #: ../../documentation/repository-files/license-files.md:55 msgid "" @@ -1323,6 +1533,10 @@ msgid "" "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) 。 " +"これらのドキュメントが推奨する重要な要素の一つは、選択するライセンスが科学的なPythonのエコシステムのコアで使用されているライセンスと相補的であることを確認することです。" +" 以下は、SciPyが使用している修正BSDライセンスと互換性のあるライセンスの概要です。" #: ../../documentation/repository-files/license-files.md:61 msgid "" @@ -1331,6 +1545,10 @@ msgid "" "Apache and custom licenses that require attribution/citation or prohibit " "use for commercial purposes." msgstr "" +"SciPyが使用している修正BSDライセンスと互換性のある他のライセンスは、2-clause BSD、MIT、PSFです。 " +"Licenses are legally binding, as such you should avoid trying to create " +"your own license unless you have the guidance of legal council." +"互換性のないライセンスは、GPL、Apache、および帰属表示/引用を必要とする、または商用目的での使用を禁止するカスタムライセンスです。" #: ../../documentation/repository-files/license-files.md:63 msgid "" @@ -1339,12 +1557,14 @@ msgid "" "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:69 msgid "" "Important: make sure that you closely follow the guidelines outlines by " "the License that you chose" -msgstr "" +msgstr "重要：選択したライセンスのガイドラインに忠実に従うこと" #: ../../documentation/repository-files/license-files.md:71 msgid "" @@ -1352,6 +1572,7 @@ msgid "" "in your package and also how others can (or can not) use the code in your" " package." msgstr "" +"どのライセンスも、あなたがパッケージの中でどのようなコードを使うことができるか、また、他の人があなたのパッケージの中のコードをどのように使うことができるか(あるいは使うことができないか)という点で、異なるガイドラインを持っています。" #: ../../documentation/repository-files/license-files.md:74 msgid "" @@ -1359,16 +1580,17 @@ msgid "" " 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:78 msgid "An example of how a license determine how code can be reused" -msgstr "" +msgstr "ライセンスがコードの再利用を決定する例" #: ../../documentation/repository-files/license-files.md:81 msgid "" "Let's use StackOverflow as an example that highlights how a license " "determines how code can or can not be used." -msgstr "" +msgstr "StackOverflowを例に、ライセンスによってコードの使用可否がどのように決まるかを明らかにしましょう。" #: ../../documentation/repository-files/license-files.md:83 msgid "" @@ -1377,6 +1599,9 @@ msgid "" "license requires you to use the same sharealike license when you reuse " "any code from StackOverflow." msgstr "" +"[Stack overflowはCreative Commons Share " +"Alikeライセンスを使用しています。](https://stackoverflow.com/help/licensing) " +"Sharealikeライセンスでは、StackOverflowのコードを再利用する際に、同じSharealikeライセンスを使用することが義務付けられています。" #: ../../documentation/repository-files/license-files.md:85 msgid "" @@ -1385,14 +1610,17 @@ msgid "" "license such as a MIT license, you are violating Stack Overflow's license" " requirements!" msgstr "" +"つまり、技術的には、Stack Overflowのウェブサイトからコードをコピーし、それをあなたのパッケージで使用する場合です。 " +"そして、あなたのパッケージがMITライセンスのような異なるライセンスを使用している場合、あなたはStack " +"Overflowのライセンス要件に違反していることになります！" #: ../../documentation/repository-files/license-files.md:87 msgid "🚨 Proceed with caution! 🚨" -msgstr "" +msgstr "🚨 慎重に進め！ 🚨" #: ../../documentation/repository-files/license-files.md:91 msgid "What about software citation?" -msgstr "" +msgstr "ソフトウェアの引用についてはどうだろうか？" #: ../../documentation/repository-files/license-files.md:93 msgid "" @@ -1404,10 +1632,15 @@ msgid "" "citation-files). We will cover this topic when we talk about creating " "DOI's for your package using zenodo." msgstr "" +"多くの寛容なライセンスは引用を必要としませんが、わたしたちは、あなたが論文やブログ、その他の出版物で使用するすべてのソフトウェアを引用することを強く推奨します。" +" あなたは、 [citation.cff ファイル](https://docs.github.com/en/repositories/managing-" +"your-repositorys-settings-and-features/customizing-your-repository/about-" +"citation-files) を使うことで、あなたのパッケージの引用方法をユーザに伝えることができます。 " +"このトピックについては、zenodoを使ってパッケージのDOIを作成する際に説明します。" #: ../../documentation/repository-files/readme-file-best-practices.md:1 msgid "README File Guidelines and Resources" -msgstr "" +msgstr "READMEファイルのガイドラインとリソース" #: ../../documentation/repository-files/readme-file-best-practices.md:3 msgid "" @@ -1415,26 +1648,28 @@ msgid "" "repository. The **README.md** file is important as it is often the first " "thing that someone sees before they install your package." msgstr "" +"**README.md** ファイルは、GitHubリポジトリのルートに置く必要があります。 **README.md** " +"ファイルは、あなたのパッケージをインストールする前に誰かが最初に目にすることが多いので重要です。" #: ../../documentation/repository-files/readme-file-best-practices.md:7 msgid "The README.md file is the landing page of:" -msgstr "" +msgstr "README.mdファイルは、そのランディングページです:" #: ../../documentation/repository-files/readme-file-best-practices.md:9 msgid "" "Your package as it appears on a repository site such as PyPI or " "Anaconda.org" -msgstr "" +msgstr "PyPIやAnaconda.orgのようなリポジトリサイトに表示されているあなたのパッケージ" #: ../../documentation/repository-files/readme-file-best-practices.md:10 msgid "Your package's GitHub repository" -msgstr "" +msgstr "あなたのパッケージのGitHubリポジトリ" #: ../../documentation/repository-files/readme-file-best-practices.md:12 msgid "" "Your README.md file is also used as a measure of package and community " "health on sites such as:" -msgstr "" +msgstr "あなたのREADME.mdファイルは、以下のようなサイトで、パッケージやコミュニティの健全性の指標としても使われています:" #: ../../documentation/repository-files/readme-file-best-practices.md:14 msgid "" @@ -1443,6 +1678,10 @@ msgid "" " [Snyk - moving pandas " "example](https://snyk.io/advisor/python/movingpandas)" msgstr "" +"[GitHub community health for MovingPandas (available for all " +"repositories)](https://github.com/anitagraser/movingpandas/community) と " +"[Snyk - moving pandas example](https://snyk.io/advisor/python/movingpandas) " +"。" #: ../../documentation/repository-files/readme-file-best-practices.md:17 msgid "" @@ -1458,6 +1697,8 @@ msgid "" "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:23 msgid "" @@ -1466,48 +1707,51 @@ msgid "" "[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日撮影)* 。" #: ../../documentation/repository-files/readme-file-best-practices.md:26 msgid "" "Thus, it is important that you spend some time up front creating a high " "quality **README.md** file for your Python package." -msgstr "" +msgstr "従って、Pythonパッケージのために高品質の **README.md** ファイルを作成するために、前もって時間をかけることが重要です。" #: ../../documentation/repository-files/readme-file-best-practices.md:30 msgid "" "An editor or the editor in chief will ask you to revise your README file " "before a review begins if it does not meet the criteria specified below." -msgstr "" +msgstr "READMEファイルが以下に指定された基準を満たしていない場合、編集者または編集長はレビュー開始前に修正を依頼します。" #: ../../documentation/repository-files/readme-file-best-practices.md:33 msgid "Please go through this list before submitting your package to pyOpenSci" -msgstr "" +msgstr "あなたのパッケージをpyOpenSciに投稿する前に、このリストに目を通してください。" #: ../../documentation/repository-files/readme-file-best-practices.md:50 msgid "What your README.md file should contain" -msgstr "" +msgstr "README.mdファイルの内容" #: ../../documentation/repository-files/readme-file-best-practices.md:52 msgid "" "Your **README.md** file should contain the following things (listed from " "top to bottom):" -msgstr "" +msgstr "**README.md** ファイルには、（上から順番に）以下のことが書かれているはずです：" #: ../../documentation/repository-files/readme-file-best-practices.md:54 msgid "✔️ Your package's name" -msgstr "" +msgstr "✔️ パッケージ名" #: ../../documentation/repository-files/readme-file-best-practices.md:55 msgid "" "Ideally your GitHub repository's name is also the name of your package. " "The more self explanatory that name is, the better." -msgstr "" +msgstr "GitHub リポジトリの名前がパッケージの名前にもなっているのが理想的です。 説明しやすい名前であればあるほどよいでしょう。" #: ../../documentation/repository-files/readme-file-best-practices.md:58 msgid "" "✔️ Badges for current package version, continuous integration and test " "coverage" -msgstr "" +msgstr "✔️ 現在のパッケージバージョン、継続的インテグレーション、テストカバレッジのバッジ" #: ../../documentation/repository-files/readme-file-best-practices.md:60 msgid "" @@ -1518,43 +1762,52 @@ msgid "" "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) " +"を追加することで、そのサイトのビルドが失敗したときにすぐに確認することができます。" #: ../../documentation/repository-files/readme-file-best-practices.md:66 msgid "" "It is common to provide a collection of badges towards the top of your " "README file for others to quickly browse." -msgstr "" +msgstr "READMEファイルの一番上に、他の人がすぐに閲覧できるようにバッジのコレクションを提供するのが一般的です。" #: ../../documentation/repository-files/readme-file-best-practices.md:69 msgid "Some badges that you might consider adding to your README file include:" -msgstr "" +msgstr "READMEファイルへの追加を検討すべきバッジには、以下のようなものがあります:" #: ../../documentation/repository-files/readme-file-best-practices.md:71 msgid "Current version of the package on PyPI / Anaconda.org" -msgstr "" +msgstr "PyPI / Anaconda.org にあるパッケージの最新バージョン" #: ../../documentation/repository-files/readme-file-best-practices.md:73 msgid "" "Example: [![PyPI version " "shields.io](https://img.shields.io/pypi/v/pandera.svg)](https://pypi.org/project/pandera/)" msgstr "" +"例: [![PyPI version " +"shields.io](https://img.shields.io/pypi/v/pandera.svg)](https://pypi.org/project/pandera/)" #: ../../documentation/repository-files/readme-file-best-practices.md:73 msgid "PyPI version shields.io" -msgstr "" +msgstr "PyPIバージョン shields.io" #: ../../documentation/repository-files/readme-file-best-practices.md:75 msgid "" -"Status of tests (pass or fail) - Example: [![CI Build](https://github.com" -"/pandera-" -"dev/pandera/workflows/CI%20Tests/badge.svg?branch=main)](https://github.com" -"/pandera-" +"Status of tests (pass or fail) - Example: [![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)" 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)" #: ../../documentation/repository-files/readme-file-best-practices.md:75 msgid "CI Build" -msgstr "" +msgstr "CI ビルド" #: ../../documentation/repository-files/readme-file-best-practices.md:77 msgid "" @@ -1562,20 +1815,24 @@ msgid "" "Building](https://github.com/pyOpenSci/python-package-" "guide/actions/workflows/build-book.yml/badge.svg)" msgstr "" +"ドキュメントのビルド - 例: ![Docs Building](https://github.com/pyOpenSci/python-" +"package-guide/actions/workflows/build-book.yml/badge.svg)" #: ../../documentation/repository-files/readme-file-best-practices.md:77 msgid "Docs Building" -msgstr "" +msgstr "ドキュメントビルディング" #: ../../documentation/repository-files/readme-file-best-practices.md:79 msgid "" "DOI (for citation) Example: " "[![DOI](https://zenodo.org/badge/556814582.svg)](https://zenodo.org/badge/latestdoi/556814582)" msgstr "" +"(参照のための) DOI の例: " +"[![DOI](https://zenodo.org/badge/556814582.svg)](https://zenodo.org/badge/latestdoi/556814582)" #: ../../documentation/repository-files/readme-file-best-practices.md:79 msgid "DOI" -msgstr "" +msgstr "DOI" #: ../../documentation/repository-files/readme-file-best-practices.md:82 msgid "" @@ -1584,20 +1841,23 @@ msgid "" "[![pyOpenSci](https://pyopensci.org/badges/peer-" "reviewed.svg)](https://github.com/pyOpenSci/software-review/issues/12)" msgstr "" +"あなたのパッケージがpyOpenSciに受理されると、あなたのリポジトリにレビュー済みであることを示すバッジを提供します。 " +"[![pyOpenSci](https://pyopensci.org/badges/peer-" +"reviewed.svg)](https://github.com/pyOpenSci/software-review/issues/12)" #: ../../documentation/repository-files/readme-file-best-practices.md:82 msgid "pyOpenSci" -msgstr "" +msgstr "pyOpenSci" #: ../../documentation/repository-files/readme-file-best-practices.md:90 msgid "" "Beware of the overuse of badges! There is such a thing as too much of a " "good thing (which can overload a potential user!)." -msgstr "" +msgstr "バッジの使い過ぎに注意！ 過ぎたるは及ばざるが如し(潜在的なユーザーを過負荷にする可能性があります!)。" #: ../../documentation/repository-files/readme-file-best-practices.md:93 msgid "✔️ A short, easy-to-understand description of what your package does" -msgstr "" +msgstr "✔️ あなたのパッケージが何をするのかを短く、わかりやすく説明する。" #: ../../documentation/repository-files/readme-file-best-practices.md:95 msgid "" @@ -1608,6 +1868,7 @@ msgid "" "users with varying scientific (and development) backgrounds can " "understand it." msgstr "" +"READMEファイルの一番上に、あなたのパッケージが何をするのか、短く、わかりやすく、1-3文の説明を書くべきです。このセクションには、パッケージの目標を明記します。この説明では、科学的（および開発的）背景が異なるさまざまなユーザーが理解できるように、専門用語をあまり使わないようにすべきです。" #: ../../documentation/repository-files/readme-file-best-practices.md:101 msgid "" @@ -1616,6 +1877,9 @@ msgid "" "other similar packages or complementary package mentions them here in 1-2" " sentences." msgstr "" +"この説明では、あなたのパッケージがより広い科学的 Python " +"パッケージのエコシステムの中でどのように位置づけられるかをユーザに知らせるのに役立ちます。 " +"もし他に似たようなパッケージや補完的なパッケージがあれば、ここで1-2文でそれらに言及してください。" #: ../../documentation/repository-files/readme-file-best-practices.md:106 msgid "" @@ -1623,16 +1887,18 @@ msgid "" "level of writing is often considered an appropriate level for scientific " "content that serves a variety of users with varying backgrounds." msgstr "" +"高校レベル（または同等のレベル）の文章を書くことを考慮します。 " +"このレベルの文章は、さまざまな背景を持つさまざまなユーザーに役立つ科学的な内容として、しばしば適切なレベルとみなされます。" #: ../../documentation/repository-files/readme-file-best-practices.md:110 msgid "" "The goal of this description is to maximize accessibility of your " "**README** file." -msgstr "" +msgstr "この記述の目的は、 **README** ファイルへのアクセシビリティを最大化することです。" #: ../../documentation/repository-files/readme-file-best-practices.md:114 msgid "✔️ Installation instructions" -msgstr "" +msgstr "✔️ インストール手順" #: ../../documentation/repository-files/readme-file-best-practices.md:116 msgid "" @@ -1640,10 +1906,11 @@ msgid "" "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:119 msgid "✔️ Document any additional setup required" -msgstr "" +msgstr "✔️ 必要な追加設定を文書化する" #: ../../documentation/repository-files/readme-file-best-practices.md:121 msgid "" @@ -1652,42 +1919,44 @@ msgid "" "installation page in your online documentation here rather than over " "complicating your README file." msgstr "" +"認証トークンなど、パッケージの使用を開始するために必要な追加設定を追加します。 " +"セットアップが複雑な場合は、READMEファイルを複雑にしすぎるのではなく、オンラインドキュメントのインストールページにリンクすることを検討してください。" #: ../../documentation/repository-files/readme-file-best-practices.md:126 msgid "✔️ Brief demonstration of how to use the package" -msgstr "" +msgstr "✔️ パッケージの使い方の簡単なデモンストレーション" #: ../../documentation/repository-files/readme-file-best-practices.md:128 msgid "" "This description ideally includes a brief, quick start code example that " "shows a user how to get started using your package." -msgstr "" +msgstr "この説明には、あなたのパッケージを使い始める方法をユーザーに示す、簡単なクイックスタートコードの例が含まれているのが理想的です。" #: ../../documentation/repository-files/readme-file-best-practices.md:131 msgid "✔️ Descriptive links to package documentation, short tutorials" -msgstr "" +msgstr "✔️ パッケージドキュメントへの説明的なリンク、短いチュートリアル" #: ../../documentation/repository-files/readme-file-best-practices.md:133 msgid "Include descriptive links to:" -msgstr "" +msgstr "説明的なリンクを含める:" #: ../../documentation/repository-files/readme-file-best-practices.md:135 msgid "The package's documentation page." -msgstr "" +msgstr "パッケージのドキュメントページ。" #: ../../documentation/repository-files/readme-file-best-practices.md:136 msgid "Short tutorials that demonstrate application of your package." -msgstr "" +msgstr "パッケージのアプリケーションをデモンストレーションする短いチュートリアル。" #: ../../documentation/repository-files/readme-file-best-practices.md:138 msgid "Too Much Of A Good Thing" -msgstr "" +msgstr "良いことのあまり" #: ../../documentation/repository-files/readme-file-best-practices.md:141 msgid "" "Try to avoid including several tutorials in the README.md file itself. " "This too will overwhelm the user with information." -msgstr "" +msgstr "README.mdファイル自体に複数のチュートリアルを含めるのはなるべく避けてください。 これもユーザーを情報で圧倒してしまいます。" #: ../../documentation/repository-files/readme-file-best-practices.md:143 msgid "" @@ -1695,74 +1964,80 @@ msgid "" "package is plenty of content for the README file. All other tutorials and" " documentation should be presented as descriptive links." msgstr "" +"READMEファイルの内容は、あなたのパッケージの使い方を示す短いクイックスタートのコード例で十分です。 " +"他のすべてのチュートリアルやドキュメントは、説明的なリンクとして表示されるべきです。" #: ../../documentation/repository-files/readme-file-best-practices.md:149 msgid "✔️ A Community Section with Links to Contributing Guide, Code of Conduct" -msgstr "" +msgstr "✔️ 貢献ガイド、行動規範へのリンクがあるコミュニティセクション" #: ../../documentation/repository-files/readme-file-best-practices.md:151 msgid "Use your README.md file to direct users to more information on:" -msgstr "" +msgstr "README.mdファイルを使用して、ユーザーをより詳細な情報に誘導する:" #: ../../documentation/repository-files/readme-file-best-practices.md:153 msgid "Contributing to your package" -msgstr "" +msgstr "パッケージへの貢献" #: ../../documentation/repository-files/readme-file-best-practices.md:154 msgid "Development setup for more advanced technical contributors" -msgstr "" +msgstr "より高度な技術貢献者のための開発セットアップ" #: ../../documentation/repository-files/readme-file-best-practices.md:155 msgid "Your code of conduct" -msgstr "" +msgstr "あなたの行動規範" #: ../../documentation/repository-files/readme-file-best-practices.md:156 msgid "Licensing information" -msgstr "" +msgstr "ライセンス情報" #: ../../documentation/repository-files/readme-file-best-practices.md:158 msgid "" "All of the above files are important for building community around your " "project." -msgstr "" +msgstr "上記のファイルはすべて、あなたのプロジェクトを取り巻くコミュニティを構築するために重要です。" #: ../../documentation/repository-files/readme-file-best-practices.md:161 msgid "✔️ Citation information" -msgstr "" +msgstr "✔️ 引用情報" #: ../../documentation/repository-files/readme-file-best-practices.md:163 msgid "" "Finally be sure to include instructions on how to cite your package. " -"Citation should include the DOI that you want used when citing your " -"package, and any language that you'd like to see associated with the " -"citation." +"Citation should include the DOI that you want used when citing your package," +" and any language that you'd like to see associated with the citation." msgstr "" +"最後に、パッケージの引用方法を必ず明記してください。引用には、パッケージを引用する際に使用してほしいDOIと、引用に関連する言語を含めてください。" #: ../../documentation/repository-files/readme-file-best-practices.md:167 msgid "README Resources" -msgstr "" +msgstr "READMEリソース" #: ../../documentation/repository-files/readme-file-best-practices.md:171 msgid "" -"Below are some resources on creating great README.md files that you might" -" find helpful." -msgstr "" +"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:174 msgid "" "[How to Write a Great README - Bane " "Sullivan](https://github.com/banesullivan/README)" msgstr "" +"[How to Write a Great README - Bane " +"Sullivan](https://github.com/banesullivan/README)" #: ../../documentation/repository-files/readme-file-best-practices.md:175 msgid "" "[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)" #: ../../documentation/write-user-documentation/create-package-tutorials.md:1 msgid "Create tutorials in your Python package documentation" -msgstr "" +msgstr "Pythonパッケージのドキュメントにチュートリアルを作成する" #: ../../documentation/write-user-documentation/create-package-tutorials.md:6 msgid "" @@ -1771,6 +2046,9 @@ msgid "" " start to finish providing a second set of checks (on top of your test " "suite) to your package's code base." msgstr "" +"パッケージには、ユーザが簡単にパッケージを使い始められるようなチュートリアルがあるべきです。 " +"理想的には、チュートリアルは最初から最後まで実行することができ、パッケージのコードベースに対する (テストスイートの上にある) " +"第二のチェックセットを提供することです。" #: ../../documentation/write-user-documentation/create-package-tutorials.md:11 msgid "" @@ -1778,54 +2056,57 @@ msgid "" "`nbsphinx`) that allow you to create reproducible tutorials that are run" " when your Sphinx documentation builds." msgstr "" +"このページでは、あなたの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" -msgstr "" +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." -msgstr "" +msgstr "よく構成されたチュートリアルをパッケージに加えることで、新しい人があなたのパッケージを使い始めるのが簡単になります。" #: ../../documentation/write-user-documentation/create-package-tutorials.md:20 msgid "" "There are two Sphinx tools that make it easy to add tutorials to your " "package:" -msgstr "" +msgstr "チュートリアルを簡単にパッケージに追加できるSphinxのツールが2つあります:" #: ../../documentation/write-user-documentation/create-package-tutorials.md:22 msgid "[Sphinx Gallery](https://sphinx-gallery.github.io/stable/index.html) and" msgstr "" +"[Sphinx Gallery](https://sphinx-gallery.github.io/stable/index.html) と" #: ../../documentation/write-user-documentation/create-package-tutorials.md:23 msgid "[NbSphinx](https://nbsphinx.readthedocs.io/en/latest/)" -msgstr "" +msgstr "[NbSphinx](https://nbsphinx.readthedocs.io/en/latest/)" #: ../../documentation/write-user-documentation/create-package-tutorials.md:25 msgid "Both of these tools act as Sphinx extensions and:" -msgstr "" +msgstr "これらのツールはどちらもSphinxの拡張機能として機能します:" #: ../../documentation/write-user-documentation/create-package-tutorials.md:27 msgid "" "Support creating a gallery type page in your Sphinx documentation where " "users can explore tutorials via thumbnails." -msgstr "" +msgstr "ユーザーがチュートリアルをサムネイルで見ることができる、Sphinxドキュメントのギャラリータイプのページの作成をサポートしました。" #: ../../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." -msgstr "" +msgstr "チュートリアルのコードを実行し、使用するパッケージの \"テスト\" をもう一段階追加する。" #: ../../documentation/write-user-documentation/create-package-tutorials.md:29 msgid "Render your tutorials with Python code and plot outputs" -msgstr "" +msgstr "Pythonコードによるチュートリアルのレンダリングとプロット出力" #: ../../documentation/write-user-documentation/create-package-tutorials.md:31 msgid "[sphinx gallery:](https://sphinx-gallery.github.io/stable/index.html)" -msgstr "" +msgstr "[sphinx gallery:](https://sphinx-gallery.github.io/stable/index.html)" #: ../../documentation/write-user-documentation/create-package-tutorials.md:33 msgid "" @@ -1834,6 +2115,9 @@ msgid "" "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** " +"ファイルを使用します。 ドキュメントをビルドするときは、ギャラリーの拡張子は:" #: ../../documentation/write-user-documentation/create-package-tutorials.md:38 msgid "" @@ -1841,24 +2125,29 @@ msgid "" " check to ensure your package's functions, classes, methods, and " "attributes (ie the API) are working as they should." msgstr "" +"各チュートリアルのコードを実行します。 " +"このようにチュートリアルを実行することで、パッケージの関数、クラス、メソッド、アトリビュート(つまりAPI)が正常に動作しているかどうかを確認することができます。" #: ../../documentation/write-user-documentation/create-package-tutorials.md:39 msgid "" "Creates a downloadable Jupyter Notebook **.ipynb** file and a **.py** " "script for your tutorial that a user can quickly download and run." msgstr "" +"ダウンロード可能なJupyter Notebookの **.ipynb** ファイルとチュートリアル用の **.py** " +"スクリプトを作成し、ユーザーがすぐにダウンロードして実行できるようにします。" #: ../../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." msgstr "" +"レンダリングされた **.html** ページを作成し、ユーザーフレンドリーなチュートリアルギャラリーにコード要素とコード出力を表示します。" #: ../../documentation/write-user-documentation/create-package-tutorials.md:41 msgid "" "Creates a gallery landing page with visual thumbnails for each tutorial " "that you create." -msgstr "" +msgstr "作成した各チュートリアルのビジュアルサムネイル付きギャラリーランディングページを作成します。" #: ../../documentation/write-user-documentation/create-package-tutorials.md:44 msgid "" @@ -1866,6 +2155,8 @@ msgid "" "tutorial is in a grid and the tutorial thumbnails are created from a " "graphic in the tutorial." msgstr "" +"画像はsphinx-" +"galleryによって提供されるギャラリーの出力を示しており、各チュートリアルはグリッド内にあり、チュートリアルのサムネイルはチュートリアルのグラフィックから作成されます。" #: ../../documentation/write-user-documentation/create-package-tutorials.md:50 msgid "" @@ -1874,16 +2165,21 @@ msgid "" "**.py** file or a Jupyter Notebook. And it renders the tutorials in a " "user-friendly grid." msgstr "" +"`sphinx-gallery` は、ユーザーフレンドリーなチュートリアルギャラリーを簡単に作成することができます。 " +"それぞれのチュートリアルにはダウンロードリンクがあり、ユーザーは **.py** ファイルやJupyter " +"Notebookをダウンロードすることができます。 また、チュートリアルはユーザーフレンドリーなグリッドで表示されます。" #: ../../documentation/write-user-documentation/create-package-tutorials.md:54 msgid "Below you can see what a tutorial looks like created with sphinx-gallery." -msgstr "" +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." msgstr "" +"画像はSphinxギャラリーのチュートリアルです。 " +"このチュートリアルでは、簡単なmatplotlibで作成したプロットと、それに関連するコードを示しています。" #: ../../documentation/write-user-documentation/create-package-tutorials.md:62 msgid "" @@ -1891,84 +2187,94 @@ msgid "" " python script (**.py** file) and a Jupyter notebook (**.ipynb** file) at" " the bottom." msgstr "" +"`sphinx-gallery` のチュートリアルは、デフォルトでは、Pythonスクリプト (**.py** ファイル)とJupyterノートブック " +"(**.ipynb** ファイル)のダウンロードリンクが下部に含まれています。" #: ../../documentation/write-user-documentation/create-package-tutorials.md:66 msgid "Sphinx Gallery benefits" -msgstr "" +msgstr "Sphinx Galleryの利点" #: ../../documentation/write-user-documentation/create-package-tutorials.md:67 msgid "easy-to-download notebook and .py outputs for each tutorials." -msgstr "" +msgstr "簡単にダウンロードできるノートブックと各チュートリアルの .py 出力。" #: ../../documentation/write-user-documentation/create-package-tutorials.md:68 msgid ".py files are easy to work with in the GitHub pull request environment." -msgstr "" +msgstr ".pyファイルはGitHubのプルリクエスト環境で簡単に扱えます。" #: ../../documentation/write-user-documentation/create-package-tutorials.md:69 msgid "Nice gridded gallery output." -msgstr "" +msgstr "素敵なグリッドギャラリーの出力。" #: ../../documentation/write-user-documentation/create-package-tutorials.md:70 msgid "" "Build execution time data per tutorial. [Example](https://sphinx-" "gallery.github.io/stable/auto_examples/sg_execution_times.html)" msgstr "" +"チュートリアルごとのビルド実行時間データ。 [例](https://sphinx-" +"gallery.github.io/stable/auto_examples/sg_execution_times.html)" #: ../../documentation/write-user-documentation/create-package-tutorials.md:72 msgid "Sphinx gallery challenges" -msgstr "" +msgstr "Sphinx galleryの挑戦" #: ../../documentation/write-user-documentation/create-package-tutorials.md:74 msgid "The downsides of using Sphinx gallery include:" -msgstr "" +msgstr "Sphinx galleryを使うことのデメリットは以下の通りです:" #: ../../documentation/write-user-documentation/create-package-tutorials.md:76 msgid "" "the **.py** files can be finicky to configure, particularly if you have " "matplotlib plot outputs." -msgstr "" +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." -msgstr "" +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" -msgstr "" +msgstr "最近、多くのユーザーはJupyter Notebookで作業することに慣れています。.pyは作業するのに少し使いにくいかもしれません" #: ../../documentation/write-user-documentation/create-package-tutorials.md:83 msgid "" "These nuances can make it challenging for potential contributors to add " "tutorials to your package. This can also present maintenance challenge." msgstr "" +"このようなニュアンスの違いは、潜在的な貢献者があなたのパッケージにチュートリアルを追加することを困難にする可能性があります。 " +"これはまた、メンテナンスの課題でもあります。" #: ../../documentation/write-user-documentation/create-package-tutorials.md:86 msgid "Add about the gallery setup:" -msgstr "" +msgstr "ギャラリーのセットアップについて追加します:" #: ../../documentation/write-user-documentation/create-package-tutorials.md:93 msgid "File directory structure:" -msgstr "" +msgstr "ファイルのディレクトリ構造:" #: ../../documentation/write-user-documentation/create-package-tutorials.md:114 msgid "" "[nbsphinx - tutorials using Jupyter " "Notebooks](https://nbsphinx.readthedocs.io/en/latest/)" msgstr "" +"[nbsphinx - Jupyter " +"Notebooksを使ったチュートリアル](https://nbsphinx.readthedocs.io/en/latest/)" #: ../../documentation/write-user-documentation/create-package-tutorials.md:116 msgid "" "If you prefer to use Jupyter Notebooks to create tutorials you can use " "nbsphinx. nbsphinx operates similarly to Sphinx gallery in that:" msgstr "" +"もしチュートリアルを作成するのにJupyter Notebooksを使いたい場合は、nbsphinxを使うことができます。nbsphinxはSphinx" +" galleryと同じように動作します:" #: ../../documentation/write-user-documentation/create-package-tutorials.md:119 msgid "It runs your notebooks and produces outputs in the rendered tutorials" -msgstr "" +msgstr "ノートブックを実行し、レンダリングされたチュートリアルの出力を生成します。" #: ../../documentation/write-user-documentation/create-package-tutorials.md:121 msgid "" @@ -1978,12 +2284,16 @@ msgid "" "settings)](https://nbsphinx.readthedocs.io/en/0.8.10/prolog-and-" "epilog.html)" msgstr "" +"Pro/con デフォルトでは **.py** と **.ipynb** ファイルのダウンロードをサポートしていません。 しかし、 " +"[conf.pyの設定(epilog " +"settingsを参照)を追加したノートブックへのリンク](https://nbsphinx.readthedocs.io/en/0.8.10/prolog-" +"and-epilog.html) を追加することができます。" #: ../../documentation/write-user-documentation/create-package-tutorials.md:125 msgid "" "Image showing the gallery output provided by nbsphinx using the sphinx-" "gallery front end interface." -msgstr "" +msgstr "画像は、nbsphinxがsphinx-galleryフロントエンドインターフェースを使用して提供したギャラリーの出力を示しています。" #: ../../documentation/write-user-documentation/create-package-tutorials.md:131 msgid "" @@ -1991,14 +2301,16 @@ msgid "" "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つのカラムに全てのギャラリー要素をリストアップします。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:1 msgid "Document the code in your package's API using docstrings" -msgstr "" +msgstr "docstringsを使って、パッケージのAPIのコードを文書化する。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:3 msgid "What is an API?" -msgstr "" +msgstr "APIとは何か？" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:5 msgid "" @@ -2007,6 +2319,8 @@ msgid "" "classes, methods, and attributes that a package maintainer creates for " "users." msgstr "" +"API は **A**pplied **P**rogramming **I**nterface の略です。 " +"(Pythonの)パッケージの文脈で議論される場合、APIはパッケージメンテナがユーザーのために作成する関数、クラス、メソッド、属性を指します。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:9 msgid "" @@ -2016,16 +2330,20 @@ msgid "" "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)` " +"を呼び出すだけで、パッケージの関数が値を計算して `6` を返します。 `add_numbers` " +"関数を呼び出すことで、パッケージのAPIを使用していることになります。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:15 msgid "" "Package APIs consist of functions, classes, methods and attributes that " "create a user interface." -msgstr "" +msgstr "パッケージAPIは、ユーザーインターフェイスを作成する関数、クラス、メソッド、属性から構成されます。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:17 msgid "What is a docstring and how does it relate to documentation?" -msgstr "" +msgstr "docstringとは何ですか？docstringとドキュメンテーションの関係は？" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:19 msgid "" @@ -2037,10 +2355,15 @@ msgid "" "argument-vs-parameter), and the outputs are often called \"return " "values\"" msgstr "" +"Pythonにおいてdocstringとは、関数、メソッド、クラスにおいて、その関数が何を行うのか、その入出力を記述したテキストを指します。 " +"Pythonプログラマは通常、関数への入力を " +"[\"parameters\"](https://docs.python.org/3/glossary.html#term-parameter) または" +" [\"arguments\"](https://docs.python.org/3/faq/programming.html#faq-" +"argument-vs-parameter) と呼び、出力を \"return values\" と呼ぶことが多いです。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:22 msgid "The docstring is thus important for:" -msgstr "" +msgstr "docstringは以下のために重要です:" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:24 msgid "" @@ -2049,6 +2372,8 @@ msgid "" "user better understand how to apply the function more effectively to " "their workflow." msgstr "" +"Pythonで `help()` を呼び出すと、例えば `help(add_numbers)` は関数のdocstringのテキストを表示します。 " +"このようにdocstringは、ユーザが自分のワークフローにより効果的に関数を適用する方法をよりよく理解するのに役立ちます。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:25 msgid "" @@ -2056,12 +2381,13 @@ msgid "" "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:28 msgid "" "Example API Documentation for all functions, classes, methods, and " "attributes in a package." -msgstr "" +msgstr "パッケージ内のすべての関数、クラス、メソッド、属性の API ドキュメントの例。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:29 msgid "" @@ -2070,6 +2396,8 @@ msgid "" "explanation of what it " "does](https://www.fatiando.org/verde/latest/api/index.html)" msgstr "" +"[Verdeパッケージの高レベルAPIドキュメントの例をご覧ください。 " +"このページには、パッケージ内のすべての関数とクラスが、その機能の簡単な説明とともに一覧表示されています](https://www.fatiando.org/verde/latest/api/index.html)" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:30 msgid "" @@ -2077,10 +2405,11 @@ msgid "" " 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)" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:33 msgid "Python package API documentation" -msgstr "" +msgstr "PythonパッケージAPIドキュメント" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:35 msgid "" @@ -2088,6 +2417,7 @@ msgid "" "attribute and/or function in your package (_within reason_), then your " "package's API is considered well-documented." msgstr "" +"もし、あなたのパッケージのすべてのユーザー向けクラス、メソッド、属性、関数に説明的なdocstringがあれば（_合理的な範囲内で_）、そのパッケージのAPIは十分に文書化されているとみなされます。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:38 msgid "" @@ -2095,46 +2425,55 @@ msgid "" "facing class, method, attribute and/or function in your package (_within " "reason_) that:" msgstr "" +"Pythonの場合、これは、パッケージ内のすべてのユーザー向けのクラス、メソッド、属性、および/または関数について、 (_無理のない範囲で_) " +"docstringを追加する必要があることを意味します:" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:42 msgid "Explains what the function, method, attribute, or class does" -msgstr "" +msgstr "関数、メソッド、属性、またはクラスが何をするのかを説明します" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:43 msgid "Defines the `type` inputs and outputs (ie. `string`, `int`, `np.array`)" -msgstr "" +msgstr "入力と出力の `type` を定義します( `string` 、 `int` 、 `np.array` など)" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:44 msgid "Explains the expected output `return` of the object, method or function." -msgstr "" +msgstr "オブジェクト、メソッド、関数の期待される出力 `return` を説明する。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:47 msgid "Three Python docstring formats and why we like NumPy style" -msgstr "" +msgstr "Pythonの3つのdocstringフォーマットとNumPyスタイルが好きな理由" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:49 msgid "" "There are several Python docstring formats that you can choose to use " "when documenting your package including:" -msgstr "" +msgstr "Pythonのdocstringフォーマットには、パッケージを文書化する際に使用できるものがいくつかあります:" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:52 msgid "" "[NumPy-style](https://numpydoc.readthedocs.io/en/latest/format.html" "#docstring-standard)" msgstr "" +"[NumPy-" +"style](https://numpydoc.readthedocs.io/en/latest/format.html#docstring-" +"standard)" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:53 msgid "" "[google style](https://sphinxcontrib-" "napoleon.readthedocs.io/en/latest/example_google.html)" msgstr "" +"[google style](https://sphinxcontrib-" +"napoleon.readthedocs.io/en/latest/example_google.html)" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:54 msgid "" "[reST style](https://sphinx-rtd-" "tutorial.readthedocs.io/en/latest/docstrings.html)" msgstr "" +"[reST style](https://sphinx-rtd-" +"tutorial.readthedocs.io/en/latest/docstrings.html)" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:58 msgid "" @@ -2142,6 +2481,9 @@ msgid "" "docstrings](https://numpydoc.readthedocs.io/en/latest/format.html" "#docstring-standard) for your Python documentation because:" msgstr "" +"Pythonのドキュメントには [NumPy-style " +"docstrings](https://numpydoc.readthedocs.io/en/latest/format.html#docstring-" +"standard) を使うことをお勧めします:" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:61 msgid "" @@ -2150,6 +2492,9 @@ msgid "" "guide](https://numpydoc.readthedocs.io/en/latest/format.html). Thus you " "will find them widely used there." msgstr "" +"NumPyスタイルのdocstringは、科学的なPythonエコシステムの中核であり、 " +"[NumPyスタイルガイド](https://numpydoc.readthedocs.io/en/latest/format.html) " +"で定義されています。 そのため、NumPyスタイルガイドで広く使われています。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:62 msgid "" @@ -2158,6 +2503,9 @@ msgid "" " reST style docstrings are harder to quickly scan, and can take up more " "lines of code in modules." msgstr "" +"Numpyスタイルのドキュメントストリングは単純化されているので、コード内でもPythonで `help()` " +"を呼び出すときでも読みやすくなっています。 " +"対照的に、reSTスタイルのdocstringは素早くスキャンするのが難しく、モジュールの中でより多くの行を占める可能性があると感じる人もいます。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:65 msgid "" @@ -2167,10 +2515,14 @@ msgid "" "`conf.py` file. This extension allows Sphinx to properly read and format " "NumPy format docstrings." msgstr "" +"もしNumPy形式のドキュメントを使用しているのであれば、ドキュメントの `conf.py` ファイルに [sphinx napoleon " +"extension](https://www.sphinx-" +"doc.org/en/master/usage/extensions/napoleon.html) を含めるようにしてください。 " +"この拡張機能により、SphinxはNumPy形式のドキュメントを正しく読み、フォーマットすることができます。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:70 msgid "Docstring examples Better and Best" -msgstr "" +msgstr "Docstringの例 Better と Best" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:72 msgid "" @@ -2181,10 +2533,13 @@ msgid "" "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文）。 " +"関数の戻り値も指定されています。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:106 msgid "Best: a docstring with example use of the function" -msgstr "" +msgstr "ベスト: 関数の使用例を記載したdocstring" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:108 msgid "" @@ -2192,6 +2547,8 @@ msgid "" "tested in sphinx using " "[doctest](https://docs.python.org/3/library/doctest.html)." msgstr "" +"この例には、sphinxでも [doctest](https://docs.python.org/3/library/doctest.html) " +"を使ってテストされている関数の使用例が含まれています。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:159 msgid "" @@ -2200,12 +2557,15 @@ msgid "" "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)` " +"コマンドの出力は、doctestを使ってテストすることもできます。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:165 msgid "" "Using doctest to run docstring examples in your package's methods and " "functions" -msgstr "" +msgstr "doctestを使って、パッケージのメソッドや関数でdocstringのサンプルを実行します。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:170 msgid "" @@ -2219,6 +2579,13 @@ msgid "" "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-" +"doc.org/en/master/usage/extensions/doctest.html) " +"という拡張機能をSphinxビルドに追加することができます。Doctestは、サンプルコードを含むdocstringに対して追加のチェックを行います。 " +"Doctest は、docstring `Examples` 内のサンプルコードを実行し、期待される出力が正しいかどうかをチェックします。 " +"ドキュメントのチュートリアルを実行するのと同様に、 `doctest` はパッケージのコード (API) " +"が期待通りに動作することを保証する便利なステップになります。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:177 msgid "" @@ -2229,18 +2596,21 @@ msgid "" " 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 をチェックすることができます。 " +"これらの項目はどちらも、オペレーティングシステムや Python " +"のバージョンにまたがってパッケージのコア機能をテストするように設計された、独立したテストスイートを置き換えるものではありません。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:185 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." -msgstr "" +msgstr "doctestは以下の例を実行し、 `add_me` に1と3の値を与えると4が返されることをテストします。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:218 msgid "Adding type hints to your docstrings" -msgstr "" +msgstr "docstringに型ヒントを追加する" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:220 msgid "" @@ -2251,12 +2621,15 @@ msgid "" "parameter `num1` and `num2` should both be a Python `int` (integer) " "value." msgstr "" +"上の例では、パラメータとして関数に渡されるデータ型や、属性としてクラスに渡されるデータ型を記述するために、numpyスタイルのdocstringを使用することを見ました。" +" numpyスタイルのdocstringでは、docstringのParametersセクションにそれらのデータ型を追加します。 下の例では、パラメータ" +" `num1` と `num2` は両方とも Python の `int` (整数) 値であるべきであることがわかります。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:235 msgid "" "Describing the expected data type that a function or method requires " "helps users better understand how to call a function or method." -msgstr "" +msgstr "関数やメソッドが必要とするデータ型を記述することで、ユーザーが関数やメソッドの呼び出し方をより理解しやすくなります。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:238 msgid "" @@ -2264,69 +2637,73 @@ msgid "" "hints make it easier for new developers, your future self or contributors" " to get to know your code base quickly." msgstr "" +"型ヒントは、あなたのコードに型ドキュメントの別のレイヤーを追加します。 " +"型ヒントは、新しい開発者や将来の自分、あるいは貢献者が、あなたのコードベースについて素早く知ることを容易にします。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:242 msgid "" "Type hints are added to the definition of your function. In the example " "below, the parameters aNum and aNum2 are defined as being type = int " "(integer)." -msgstr "" +msgstr "型のヒントは関数の定義に追加されます。 以下の例では、パラメータaNumとaNum2はtype = int（整数）として定義されています。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:249 msgid "" "You can further describe the expected function output using `->`. Below " "the output of the function is also an int." -msgstr "" +msgstr "さらに `->` を使って、期待される関数の出力を記述することができます。以下の関数の出力も int です。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:257 msgid "Why use type hints" -msgstr "" +msgstr "型ヒントを使う理由" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:259 msgid "Type hints:" -msgstr "" +msgstr "型ヒント:" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:261 msgid "Make development and debugging faster," -msgstr "" +msgstr "開発とデバッグをより速くします、" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:262 msgid "" "Make it easier for a user to see the data format inputs and outputs of " "methods and functions," -msgstr "" +msgstr "メソッドや関数のデータ・フォーマットの入出力を、ユーザーが見やすくします、" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:263 msgid "" "Support using static type checking tools such as [`mypy`](https://mypy-" "lang.org/) which will check your code to ensure types are correct." msgstr "" +"型が正しいことを確認するためにコードをチェックする [`mypy`](https://mypy-lang.org/) " +"のような静的型チェックツールの使用をサポートします。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:265 msgid "You should consider adding type hinting to your code if:" -msgstr "" +msgstr "あなたのコードにタイプヒンティングを追加することを検討すべきです:" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:267 msgid "Your package performs data processing," -msgstr "" +msgstr "あなたのパッケージはデータ処理を行います、" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:268 msgid "You use functions that require complex inputs" -msgstr "" +msgstr "複雑な入力を必要とする関数を使用しています" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:269 msgid "" "You want to lower the entrance barrier for new contributors to help you " "with your code." -msgstr "" +msgstr "あなたは、あなたのコードを手助けしてくれる新しい貢献者の入り口の障壁を低くしたいです。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:271 msgid "Beware of too much type hinting" -msgstr "" +msgstr "型ヒントの多用に注意してください" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:274 msgid "As you add type hints to your code consider that in some cases:" -msgstr "" +msgstr "コードに型ヒントを追加する際には、場合によってはこのようなこともあることを考慮してほしい:" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:276 msgid "" @@ -2334,22 +2711,24 @@ msgid "" "to read. This is especially true when a parameter’s input takes multiple " "data types and you list each one." msgstr "" +"複雑なコードベースを持っている場合、型ヒントはコードを読みにくくする可能性がある。 " +"パラメーターの入力が複数のデータ型を取り、それぞれをリストアップする場合は特にそうだ。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:277 msgid "" "Writing type hints for simple scripts and functions that perform obvious " "operations don't make sense." -msgstr "" +msgstr "単純なスクリプトや明らかな操作を行う関数に型ヒントを書いても意味がありません。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:280 msgid "Gradually adding type hints" -msgstr "" +msgstr "型ヒントを徐々に追加" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:282 msgid "" "Adding type hints can take a lot of time. However, you can add type hints" " incrementally as you work on your code." -msgstr "" +msgstr "型ヒントの追加には多くの時間がかかります。 しかし、コードを書きながら少しずつ型ヒントを追加していくことができます。" #: ../../documentation/write-user-documentation/document-your-code-api-docstrings.md:286 msgid "" @@ -2357,18 +2736,20 @@ msgid "" " them get to know your package's code and structure better before digging" " into more complex contributions." msgstr "" +"型ヒントを追加することは、新しい貢献者にとっても素晴らしい作業です。 " +"より複雑な貢献をする前に、あなたのパッケージのコードと構造をよりよく知ることができます。" #: ../../documentation/write-user-documentation/get-started.md:1 msgid "Create User Facing Documentation for your Python Package" -msgstr "" +msgstr "Pythonパッケージのユーザー向けドキュメントを作成する" #: ../../documentation/write-user-documentation/get-started.md:14 msgid "Core components of user-facing Python package documentation" -msgstr "" +msgstr "ユーザー向けPythonパッケージドキュメントのコアコンポーネント" #: ../../documentation/write-user-documentation/get-started.md:15 msgid "Below we break documentation into two broad types." -msgstr "" +msgstr "以下では、ドキュメントを2つのタイプに大別します。" #: ../../documentation/write-user-documentation/get-started.md:17 msgid "" @@ -2378,12 +2759,15 @@ msgid "" "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(function-name)` とタイプしたときに表示されるものです。" #: ../../documentation/write-user-documentation/get-started.md:23 msgid "" "Your user-facing documentation for your Python package should include " "several core components." -msgstr "" +msgstr "Pythonパッケージのユーザー向けドキュメントには、いくつかのコアコンポーネントを含めるべきです。" #: ../../documentation/write-user-documentation/get-started.md:26 msgid "" @@ -2391,6 +2775,8 @@ msgid "" " helps someone use your package. This documentation should help users " "both install and use your package." msgstr "" +"**ドキュメントウェブサイト:** これは、誰かがあなたのパッケージを使うのを助ける、読みやすいドキュメンテーションのことです。 " +"このドキュメンテーションは、ユーザがあなたのパッケージをインストールし、使うのを助けるものでなければなりません。" #: ../../documentation/write-user-documentation/get-started.md:27 msgid "" @@ -2398,6 +2784,8 @@ msgid "" "[**short tutorials** that showcase core features of your package](create-" "package-tutorials)." msgstr "" +"**短いチュートリアル:** ユーザー向けのドキュメントには、 [パッケージのコア機能を紹介する **短いチュートリアル** ](create-" +"package-tutorials) も含めるべきです。" #: ../../documentation/write-user-documentation/get-started.md:28 msgid "" @@ -2410,10 +2798,16 @@ msgid "" "documentation and docstrings in greater detail here.](document-your-code-" "api-docstrings)" msgstr "" +"**パッケージコード/APIドキュメント:** パッケージの関数、クラス、メソッド、属性（API）もドキュメント化されるべきです。 " +"APIドキュメントは、あなたのコードにある " +"[docstrings](https://pandas.pydata.org/docs/development/contributing_docstring.html)" +" から生成することができます。 理想的には、Pythonパッケージ内のすべてのユーザー向けの関数、クラス、メソッドのdocstringがあることです。 " +"[コードドキュメンテーションとdocstringについてはこちらで詳しく説明します。](document-your-code-api-" +"docstrings)" #: ../../documentation/write-user-documentation/get-started.md:32 msgid "Write usable documentation" -msgstr "" +msgstr "使いやすい文書を書く" #: ../../documentation/write-user-documentation/get-started.md:34 msgid "" @@ -2422,36 +2816,40 @@ msgid "" "may not be developers or expert-level programmers. Rather, the language " "that you use in your documentation should not be highly technical." msgstr "" +"ユーザー向けのドキュメントは、閲覧しやすいウェブサイトで公開されるべきである。 " +"ドキュメントは、ユーザーが開発者や専門家レベルのプログラマーではないことを念頭に置いて書かれるべきです。 " +"むしろ、ドキュメントで使用する言語は、高度な技術的なものであってはなりません。" #: ../../documentation/write-user-documentation/get-started.md:39 msgid "" "To make the language of your documentation more accessible to a broader " "audience:" -msgstr "" +msgstr "ドキュメンテーションの言語を、より多くの読者が理解できるようにする:" #: ../../documentation/write-user-documentation/get-started.md:42 msgid "Whenever possible, define technical terms and jargon." -msgstr "" +msgstr "可能な限り、技術用語や専門用語を定義する。" #: ../../documentation/write-user-documentation/get-started.md:43 msgid "Consider writing instructions for a high-school level reader." -msgstr "" +msgstr "高校生レベルの読者を想定して指示を書く。" #: ../../documentation/write-user-documentation/get-started.md:44 msgid "" "Include step-by-step code examples, tutorials or vignettes that support " "getting started using your package." -msgstr "" +msgstr "あなたのパッケージの使い始めをサポートする、ステップ・バイ・ステップのコード例、チュートリアル、またはヴィネットを含めてください。" #: ../../documentation/write-user-documentation/get-started.md:46 msgid "Four elements of a good open source documentation landing page" -msgstr "" +msgstr "優れたオープンソース・ドキュメントのランディングページの4つの要素" #: ../../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:" msgstr "" +"ユーザーが必要なものをすぐに見つけられるように、パッケージのランディングページに以下の要素へのクイックリンクを追加することを検討してください:" #: ../../documentation/write-user-documentation/get-started.md:52 msgid "" @@ -2460,12 +2858,13 @@ msgid "" "package is good to have here as well. Or you can link to useful tutorials" " in the get started section." msgstr "" +"**開始:** このセクションは、あなたのパッケージをインストールするためのクイックスタート をユーザーに提供するものです。 " +"パッケージの使い方の小さな例もここにあると良いでしょう。 または、便利なチュートリアルへのリンクを、スタートセクションに置くこともできます。" #: ../../documentation/write-user-documentation/get-started.md:53 msgid "" -"**About:** Describe your project, stating its goals and its " -"functionality." -msgstr "" +"**About:** Describe your project, stating its goals and its functionality." +msgstr "**About:** プロジェクトについて、その目標と機能を説明してください。" #: ../../documentation/write-user-documentation/get-started.md:54 msgid "" @@ -2475,6 +2874,9 @@ msgid "" " include a development guide for those who might contribute to your " "package." msgstr "" +"**Community:** どのように手伝ったり、参加したりするかについての説明。 このセクションには、issue " +"(ユーザーに質問できるようにしている場合) や GitHub リポジトリのディスカッションへのリンクが含まれます。 " +"このセクションには、あなたのパッケージに貢献するかもしれない人のための開発ガイドを含めることができます。" #: ../../documentation/write-user-documentation/get-started.md:55 msgid "" @@ -2483,6 +2885,8 @@ msgid "" "functions, classes, methods, and attributes as well as any additional " "high level discussion that will help people use your package." msgstr "" +"**APIドキュメント:** これはプロジェクトの詳細なドキュメントです。 " +"ここには、ユーザー向けの関数、クラス、メソッド、属性、およびパッケージの使用に役立つ追加的な高レベルのディスカッションを含む、パッケージのAPIのドキュメントを保存します。" #: ../../documentation/write-user-documentation/get-started.md:58 msgid "" @@ -2490,6 +2894,8 @@ msgid "" "sections including Getting started, Documentation, About GeoPandas, " "Community." msgstr "" +"画像は GeoPandas ドキュメントのランディングページで、Getting started、Documentation、About " +"GeoPandas、Community の 4 つのセクションがあります。" #: ../../documentation/write-user-documentation/get-started.md:64 msgid "" @@ -2497,6 +2903,8 @@ msgid "" "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カードを使って各要素にユーザーを誘導していることに注目してください。" #: ../../documentation/write-user-documentation/get-started.md:67 msgid "" @@ -2504,22 +2912,24 @@ msgid "" "**CONTRIBUTING** files in your documentation given those files may have " "some of the components listed above." msgstr "" +"NOTE: 多くの場合、 **README** ファイルと **CONTRIBUTING** " +"ファイルをドキュメントに含めることができま、これらのファイルには、上に挙げた構成要素のいくつかが含まれているかもしれません。" #: ../../documentation/write-user-documentation/get-started.md:71 msgid "" "You can include files in Sphinx using the include directive. Below is an " "example of doing this using `myst` syntax." -msgstr "" +msgstr "Sphinxではincludeディレクティブを使ってファイルをインクルードすることができます。 下記は `myst` 構文を使った例です。" #: ../../documentation/write-user-documentation/intro.md:1 msgid "Writing user-facing documentation for your Python package" -msgstr "" +msgstr "Pythonパッケージのユーザー向けドキュメントを書く" #: ../../documentation/write-user-documentation/intro.md:3 msgid "" "This section walks you through best practices for with writing " "documentation for your Python package." -msgstr "" +msgstr "このセクションでは、Python パッケージのドキュメント作成のベストプラクティスを説明します。" #: ../../documentation/write-user-documentation/intro.md:6 msgid "" @@ -2527,19 +2937,20 @@ msgid "" "documentation, the different types of users who might read your " "documentation and how to create tutorials for your package." msgstr "" +"ドキュメントに追加することを検討すべき要素、ドキュメントを読む可能性のあるさまざまなタイプのユーザー、パッケージのチュートリアルを作成する方法について話します。" #: ../../documentation/write-user-documentation/intro.md:10 msgid "" "Here we also cover sphinx extensions that you can user to make " "documentation easier such as:" -msgstr "" +msgstr "ここでは、ドキュメンテーションを容易にするために使用できるsphinxの拡張機能についても説明します:" #: ../../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" -msgstr "" +msgstr "autodocは、あなたのコードの関数、クラス、メソッド、属性（APIドキュメント）のドキュメントを自動生成します。" #: ../../documentation/write-user-documentation/intro.md:15 msgid "sphinx gallery for tutorials." -msgstr "" +msgstr "チュートリアルのためのsphinxギャラリー。" From d39841e858e596122c912df6b31b52899ea97eb5 Mon Sep 17 00:00:00 2001 From: Tetsuo Koyama Date: Sat, 9 Nov 2024 21:45:08 +0900 Subject: [PATCH 2/3] Update locales/ja/LC_MESSAGES/documentation.po --- locales/ja/LC_MESSAGES/documentation.po | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/locales/ja/LC_MESSAGES/documentation.po b/locales/ja/LC_MESSAGES/documentation.po index 1cc51b62..52af0a0d 100644 --- a/locales/ja/LC_MESSAGES/documentation.po +++ b/locales/ja/LC_MESSAGES/documentation.po @@ -2863,7 +2863,8 @@ msgstr "" #: ../../documentation/write-user-documentation/get-started.md:53 msgid "" -"**About:** Describe your project, stating its goals and its functionality." +"**About:** Describe your project, stating its goals and its " +"functionality." msgstr "**About:** プロジェクトについて、その目標と機能を説明してください。" #: ../../documentation/write-user-documentation/get-started.md:54 From da0b9f60d9d60a281e5122be1ded2ca4b97b737e Mon Sep 17 00:00:00 2001 From: Tetsuo Koyama Date: Mon, 11 Nov 2024 11:38:48 +0900 Subject: [PATCH 3/3] Apply suggestions from code review --- locales/ja/LC_MESSAGES/documentation.po | 44 ++++++++++++------------- 1 file changed, 22 insertions(+), 22 deletions(-) diff --git a/locales/ja/LC_MESSAGES/documentation.po b/locales/ja/LC_MESSAGES/documentation.po index 52af0a0d..3ae70621 100644 --- a/locales/ja/LC_MESSAGES/documentation.po +++ b/locales/ja/LC_MESSAGES/documentation.po @@ -51,13 +51,11 @@ msgid "" msgstr "また、ドキュメントをオンラインで公開する方法や、ドキュメントのウェブサイトを最適化するためのSphinxツールについてもお話します。" #: ../../documentation/hosting-tools/myst-markdown-rst-doc-syntax.md:1 -msgid "" -"Documentation syntax: markdown vs. myST vs. rst syntax to create your docs" +msgid "Documentation syntax: markdown vs. myST vs. rst syntax to create your docs" msgstr "ドキュメントの構文:ドキュメントを作成するためのマークダウン構文とmyST構文とrst構文" #: ../../documentation/hosting-tools/myst-markdown-rst-doc-syntax.md:3 -msgid "" -"There are three commonly used syntaxes for creating Python documentation:" +msgid "There are three commonly used syntaxes for creating Python documentation:" msgstr "Pythonのドキュメントを作成するためによく使われる構文は3つあります:" #: ../../documentation/hosting-tools/myst-markdown-rst-doc-syntax.md:4 @@ -133,8 +131,8 @@ msgstr "" #: ../../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 @@ -654,8 +652,8 @@ 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 @@ -874,8 +872,8 @@ msgstr "" #: ../../documentation/repository-files/changelog-file.md:11 msgid "" "[Keep a CHAGELOG.md](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." +"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/)は、変更ログとは何か、どのように良い変更ログを作成するかを理解するための、シンプルで素晴らしいリソースです。" @@ -887,9 +885,9 @@ 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 パッケージ全体で広く使われています。" @@ -1090,8 +1088,8 @@ msgstr "" #: ../../documentation/repository-files/code-of-conduct-file.md:16 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 "" "コミュニティの他の人たちも、あなたのツールに貢献したいと思うかもしれません。 " "バグを修正したり、ドキュメントを更新したり、メンテナチームと関わりを持ったりするかもしれません。" @@ -1796,9 +1794,10 @@ msgstr "PyPIバージョン shields.io" #: ../../documentation/repository-files/readme-file-best-practices.md:75 msgid "" -"Status of tests (pass or fail) - Example: [![CI " -"Build](https://github.com/pandera-" -"dev/pandera/workflows/CI%20Tests/badge.svg?branch=main)](https://github.com/pandera-" +"Status of tests (pass or fail) - Example: [![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)" msgstr "" "テストのステータス(合格または不合格) - 例: [![CI Build](https://github.com/pandera-" @@ -2004,8 +2003,9 @@ msgstr "✔️ 引用情報" #: ../../documentation/repository-files/readme-file-best-practices.md:163 msgid "" "Finally be sure to include instructions on how to cite your package. " -"Citation should include the DOI that you want used when citing your package," -" and any language that you'd like to see associated with the citation." +"Citation should include the DOI that you want used when citing your " +"package, and any language that you'd like to see associated with the " +"citation." msgstr "" "最後に、パッケージの引用方法を必ず明記してください。引用には、パッケージを引用する際に使用してほしいDOIと、引用に関連する言語を含めてください。" @@ -2015,8 +2015,8 @@ msgstr "READMEリソース" #: ../../documentation/repository-files/readme-file-best-practices.md:171 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:174