Skip to main content

すべての質問

でタグ付けされた
絞り込み
並べ替え
タグ付けされた
3
1 回答
91 閲覧数

sphinxの`code-block`のハイライトを無効化するには、言語に`text`と`none`どちらを指定するのがよいですか?

実行環境 Python 3.9.6 sphinx 4.4.0 やりたいこと code-blockディレクティブのハイライトを無効にしたいです。 .. code-block:: list set dict ... デフォルトの言語はpython3に近いものなので、下図のようにハイライトされてしまいます。 https://www.sphinx-doc.org/en/master/...
0
1 回答
122 閲覧数

Unicode正規化した後に、一文字のみ取り出して大文字にするとウムラウトが取れる

Pythonのプログラムをデバッグしていて気付いた挙動についての質問です。 よろしくお願いします。 質問 Unicode正規化した後に、一文字のみ取り出して大文字にするとウムラウトが取れます。これってUnicodeの規格としては正しい挙動なのでしょうか。 ※正しい挙動である場合、何か参考情報があると喜びます。 参考情報 Unicode正規化 - Qiita Unicode正規化 - ...
1
1 回答
101 閲覧数

単語として切り出せる文字列に対して読み仮名を付与する場合に、指針となるようなPEPはありますか?

■後日談 次の二つを分けて考えることにしました。 記法そのもの 記法も含めたかな文字情報を扱えるようにする拡張性 現在の実装は「 よみ|漢字 の記法をそのまま維持して、同時に後者についてのサンプル実装も兼ねる」という位置付けにすることにしました。これを踏まえて README.rst を更新します。 Sphinx拡張を実装するにあたって思いついたことですが、...
0
1 回答
287 閲覧数

PyPIパッケージでのClassifierの書き方について

作成したPyPIパッケージについて、次のようなケースを想定します。 python3のみ対応 ただし、現状テストできているのはpython3.8のみ この場合のClassifierの指定は次の通りでどうでしょうか? Programming Language :: Python :: 3 Programming Language :: Python :: 3 :: Only Programming ...
0
1 回答
275 閲覧数

__next__を使った__iter__はエラーになって、yieldを使った__iter__はエラーにならない

<後日談> 回答の指摘で気づけましたが、単なる勘違いでした。__next となっていたのを見逃していたのが原因でした。経験の浅い言語のため、原因を __next__ に限定できていなかったのが根本原因だと受け止めます。 問題は解決しましたが、その解決方法の理屈が分からないので質問します。 よろしくお願いします。 <質問> ...
1
1 回答
970 閲覧数

Google StyleのPython Docstringで、「非推奨」はどのように表せばよいでしょうか?

背景 PythonのdocstringをGoogle Styleで記載しています。 docstringの内容は、sphinxのautodoc機能でHTMLドキュメントに反映しています。 質問 非推奨のメソッドは、docstringにどのような内容を記載すればよいでしょうか? JavaDocの@Deprecatedのようなタグを期待しています。 Example Google Style ...
0
1 回答
274 閲覧数

Read the docsにアップロードしたドキュメントにDocstring出力されない

環境 sphinx 1.8.5 やりたいこと Read the DocsにPythonライブラリのリファレンスを公開したいです。 リファレンスの主な内容はDocstringです。 今の状態 Read the Docsにアップロードはできましたが、Docstringは出力されていませんでした。 https://annofab-api-python-client.readthedocs.io/...
1
1 回答
111 閲覧数

Pythonパッケージのドキュメントはどこで公開できますか?

環境 Python 3.6+ 質問 Pythonパッケージのドキュメントを公開したいです。 候補として何がありますか? 以下のサイトは、github.ioでした。 https://qiita.com/kinpira/items/505bccacb2fba89c0ff0 kerasやrequestsモジュールはgithub.ioではなさそうなので、ほかにどんな候補があるのかを知りたいです。 ...
0
1 回答
415 閲覧数

sphinx文章内の置換について、txtをincludeした場合の文字列処理

みなさん初めまして、どうぞ宜しくお願いいたします。 早速ですが、ある構造計算プログラムをpythonで作成しその結果を、exp.txtで書き出しています。書き出した中身は以下の様な内容です。     .. |t1| replace:: 100     .. |t2| replace:: ok これを、ひな型としてsphinxであらかじめ作成しておいたrst内の先頭行で .. ...
1
1 回答
1,274 閲覧数

Sphinx のインストールについて

Sphinx のインストールをpipでしました. ですが,sphinx-quickstartで始めようとしたところ,以下の様なエラーが出てしまいました. user:~ $ sphinx-quickstart Traceback (most recent call last): File "user/anaconda/bin/sphinx-quickstart", line 9, in <...