すべての質問
10 件の質問
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/...
1
票
1
回答
970
閲覧数
Google StyleのPython Docstringで、「非推奨」はどのように表せばよいでしょうか?
背景
PythonのdocstringをGoogle Styleで記載しています。
docstringの内容は、sphinxのautodoc機能でHTMLドキュメントに反映しています。
質問
非推奨のメソッドは、docstringにどのような内容を記載すればよいでしょうか?
JavaDocの@Deprecatedのようなタグを期待しています。
Example Google Style ...
1
票
1
回答
111
閲覧数
Pythonパッケージのドキュメントはどこで公開できますか?
環境
Python 3.6+
質問
Pythonパッケージのドキュメントを公開したいです。
候補として何がありますか?
以下のサイトは、github.ioでした。
https://qiita.com/kinpira/items/505bccacb2fba89c0ff0
kerasやrequestsモジュールはgithub.ioではなさそうなので、ほかにどんな候補があるのかを知りたいです。
...
1
票
1
回答
101
閲覧数
単語として切り出せる文字列に対して読み仮名を付与する場合に、指針となるようなPEPはありますか?
■後日談
次の二つを分けて考えることにしました。
記法そのもの
記法も含めたかな文字情報を扱えるようにする拡張性
現在の実装は「 よみ|漢字 の記法をそのまま維持して、同時に後者についてのサンプル実装も兼ねる」という位置付けにすることにしました。これを踏まえて README.rst を更新します。
Sphinx拡張を実装するにあたって思いついたことですが、...
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 <...
0
票
1
回答
122
閲覧数
Unicode正規化した後に、一文字のみ取り出して大文字にするとウムラウトが取れる
Pythonのプログラムをデバッグしていて気付いた挙動についての質問です。
よろしくお願いします。
質問
Unicode正規化した後に、一文字のみ取り出して大文字にするとウムラウトが取れます。これってUnicodeの規格としては正しい挙動なのでしょうか。
※正しい挙動である場合、何か参考情報があると喜びます。
参考情報
Unicode正規化 - Qiita
Unicode正規化 - ...
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/...
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__ に限定できていなかったのが根本原因だと受け止めます。
問題は解決しましたが、その解決方法の理屈が分からないので質問します。
よろしくお願いします。
<質問>
...
0
票
1
回答
415
閲覧数
sphinx文章内の置換について、txtをincludeした場合の文字列処理
みなさん初めまして、どうぞ宜しくお願いいたします。
早速ですが、ある構造計算プログラムをpythonで作成しその結果を、exp.txtで書き出しています。書き出した中身は以下の様な内容です。
.. |t1| replace:: 100
.. |t2| replace:: ok
これを、ひな型としてsphinxであらかじめ作成しておいたrst内の先頭行で
.. ...