nikkie

Steps to reproduce ------------------ *This is a documentation error.* Expected behaviour ------------------ The reference description should be `sample_rate: Union[int, None] = None` Actual behaviour ---------------- ### Reference https://github.com/Uberi/speech_recognition/blob/3.8.1/reference/library-reference.rst#microphonedevice_index-unionint-none--none-sample_rate-int--16000-chunk_size-int--1024---microphone `sample_rate: int...

from ttslearn.dnntts import DNNTTS にてtorchのImportError

1

macOS（GPUはない環境です） Python 3.9.4 ## 再現手順 ``` $ pip install ttslearn $ python >>> from ttslearn.dnntts import DNNTTS Traceback (most recent call last): File "", line 1, in File "/Users/.../venv/lib/python3.9/site-packages/ttslearn/__init__.py", line...

日本語ドキュメントを翻訳&メンテナンスしていただき誠にありがとうございます。 # 概要 sslモジュールのドキュメントの「参考」のリンクに英語版とは異なるリンクが含まれていることに気付きました。 # 問題のある箇所 (URLで指定すること) https://docs.python.org/ja/3/library/ssl.html#tls-1-3 のセクションの下の「参考」です 英語版と比較しています https://docs.python.org/3/library/ssl.html#tls-1-3 # 問題の詳細 ## 1 >[:rfc:`RFC 1422: Privacy Enhancement for Internet Electronic Mail: Part II: Certificate-Based Key Management `_](https://docs.python.org/ja/3/library/ssl.html#id1) -...

ArgumentParserのprogのデフォルトがos.path.basename(sys.argv[0])になっていない

1

# 概要 >[prog](https://docs.python.org/ja/3/library/argparse.html#prog) - プログラム名 (デフォルト: `sys.argv[0]`) `sys.argv[0]`という記載は、実装や英語版と異なっています。 # 問題のある箇所 (URLで指定すること) https://docs.python.org/ja/3/library/argparse.html#argparse.ArgumentParser # 問題の詳細 https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser >[prog](https://docs.python.org/3/library/argparse.html#prog) - The name of the program (default: `os.path.basename(sys.argv[0])`) 以下の課題の対応で英語版の方は修正されたようですが、日本語のドキュメントに未反映のようです。 - コミット：https://github.com/python/cpython/commit/74af713538463c9881e27b58bc4dbd67712c53f8 - 課題：https://bugs.python.org/issue46228 -...

ArgumentParser.convert_arg_line_to_args の訳をよりわかりやすくする提案

1

# 概要 >このメソッドをオーバーライドすると便利なこととして、スペースで区切られた単語を 1 つの引数として扱えます。 実装例をよりうまく説明できそうな言い回しがありそうに思ったのでIssueを書くことにしました。 # 問題のある箇所 (URLで指定すること) https://docs.python.org/ja/3/library/argparse.html#argparse.ArgumentParser.convert_arg_line_to_args # 問題の詳細 ここの例のコードは、ファイルから引数を読み込む場合、`-f bar`という行があったら、`-f`と`bar`と2つの引数が指定されたとして扱える(A)ことを示していると理解しました。 `prefix_chars`引数のドキュメントによると、「ファイルから読み込まれる引数は、デフォルトでは1行に1つ」[1]なので、`-f bar`という行はデフォルトでは`-f bar`という1つの引数です(B)。 [1]: https://docs.python.org/ja/3/library/argparse.html#fromfile-prefix-chars この動きを変える方法を例で説明しているという理解です。 「スペースで区切られた単語を 1 つの引数として扱えます。」という今の訳ですと、(A)なのか(B)なのかが、例のコードを見ないとはっきりしないように思われます。 英語を確認するとeach space-separated word（スペースで区切られた1つ1つの単語）をan argument（1つの引数）として扱うということなので、(A)であることが分かりやすいです https://docs.python.org/3/library/argparse.html#argparse.ArgumentParser.convert_arg_line_to_args >A useful...

PYTHONSTARTUP変数のドキュメントの誤訳

1

# 概要 >このファイル内のプロンプト [`sys.ps1`](https://docs.python.org/ja/3/library/sys.html#sys.ps1) や [`sys.ps2`](https://docs.python.org/ja/3/library/sys.html#sys.ps2)、ならびにフック [`sys.__interactivehook__`](https://docs.python.org/ja/3/library/sys.html#sys.__interactivehook__) を変更することも出来ます。 # 問題のある箇所 (URLで指定すること) https://docs.python.org/ja/3/using/cmdline.html#envvar-PYTHONSTARTUP # 問題の詳細 PYTHONSTARTUPに指定したファイルで`sys.ps1`に文字列を代入すると、起動した**インタプリタのプロンプトが変わります**。 動作例[1]：https://scrapbox.io/nikkie-memos/PYTHONSTARTUP%E3%81%A7%E3%83%97%E3%83%AD%E3%83%B3%E3%83%97%E3%83%88%E3%82%92%E5%A4%89%E3%81%88%E3%82%8B%E4%BE%8B PYTHONSTARTUPに指定した"ファイル内のプロンプトを変える"という今の訳は、上記の動作例を説明できておらず、読者の誤解を招いてしまうと考えます。 原文 https://docs.python.org/3/using/cmdline.html#envvar-PYTHONSTARTUP >You can also change the prompts [`sys.ps1`](https://docs.python.org/3/library/sys.html#sys.ps1) and [`sys.ps2`](https://docs.python.org/3/library/sys.html#sys.ps2) and the...

デザインと歴史 FAQ: マークアップに使う``がgotoの質問への回答の中に表示されている

1

# 概要 ``` Pythonだと、分岐には if``節及び ``or ・ and ・ if-else 式を使います。 ``` # 問題のある箇所 (URLで指定すること) https://docs.python.org/ja/3/faq/design.html#why-is-there-no-goto # 問題の詳細 ReSTのコード片のマークアップに使う2連バッククォートがビルドされたドキュメントに現れています。 英語版では、2連バッククォートは現れていません。 https://docs.python.org/3/faq/design.html#why-is-there-no-goto >in Python, with if statements and or, and, and...

sys.exitのドキュメントのtypo: オブェクト

1

# 概要 `sys.exit`のドキュメントに「オブェクト」というtypoを見つけました >それ以外の型のオブジェクトを指定すると、そのオブェクトが stderr に出力され、 # 問題のある箇所 (URLで指定すること) https://docs.python.org/ja/3/library/sys.html#sys.exit # 問題の詳細 「オブェクト」は「オブジェクト」のtypoと思われます # 修正案 それ以外の型のオブジェクトを指定すると、そのオブジェクトが stderr に出力され、

Python言語リファレンス > 代入文の「結果オブジェクト」という訳の代案提案

1

# 概要 以下の訳の「得られた単一の結果オブジェクト」が少し気になりました。 >得られた単一の結果オブジェクトをターゲット (target) のリストに対して左から右へと代入してゆきます。 # 問題のある箇所 (URLで指定すること) https://docs.python.org/ja/3/reference/simple_stmts.html#assignment-statements # 問題の詳細 英語：https://docs.python.org/3/reference/simple_stmts.html#assignment-statements >assigns the single resulting object to each of the target lists, from left to right. 「the single...

Python言語リファレンス > 代入文のtypo

1

# 概要 「ターゲットリストは、丸括弧や角括弧で囲まれていてもよく、それに対するオブジェクトの代入は、以下のように再帰的に定義されています。」に続く箇条書きにtypoを見つけました。 >オブジェクトはイテラブルで、少なくともターゲットリストのターゲットの数よりも一つ少ない要素を持たなければはなりません。 「持たなければはなりません」がtypoです # 問題のある箇所 (URLで指定すること) https://docs.python.org/ja/3/reference/simple_stmts.html#assignment-statements # 問題の詳細 （概要を参照ください） # 修正案 該当するtypoを修正します（「は」を削除） `オブジェクトはイテラブルで、少なくともターゲットリストのターゲットの数よりも一つ少ない要素を持たなければなりません。`