5
票
承認済み
Google StyleのPython Docstringで、「非推奨」はどのように表せばよいでしょうか?
現時点では、Google Style GuideはDeprecatedである関数・メソッドについての記載方法を提供していません。このため、回答としては「そのような方法はないので独自の形式で表現してください」となります。
styleguide/pyguide.md at gh-pages · google/styleguide
一方、...
5
票
承認済み
Pythonパッケージのドキュメントはどこで公開できますか?
Sphinxのドキュメントは静的HTMLをホスティング出来るサービスであればどこでもかまいません。
https://sphinx-users.jp/cookbook/hosting/index.html でいくつか紹介しています。
ここに載っていないサービスもいくつもりますが、NetlifyでSphinxをホスティングする方法もあります。
Pythonパッケージのドキュメント、という意味では ...
4
票
承認済み
Sphinxでmakeコマンドを実行するとエラーになる
新しく作ったプロジェクトのMakefileの中身を修正することで問題が解決できることがわかりました。
動作していたプロジェクトのMakefile
SPHINXBUILD = sphinx-build
新しく作ったプロジェクトのMakefile
SPHINXBUILD = python -msphinx
私の環境では、pythonコマンドの場合はPython2になります。
なので、...
3
票
承認済み
sphinxの`code-block`のハイライトを無効化するには、言語に`text`と`none`どちらを指定するのがよいですか?
明示的に「無効」を表現したいのであれば none を指定するのが良さそうです。
none はSphinxがPygmentsのTextLexerにマッピングしています。
text はSphinxがPygmentsのlexer取得を行い、TextLexerが取得されます。
どちらの場合でもPygmentsのTextLexerが使用されます。
PygmentsのLexer一覧は以下で確認できます。
...
2
票
承認済み
Sphinxのsphinx-apidocコマンドによるソースドキュメント自動生成で、__init__関数を表示させる方法は?
sphinx-apidocコマンドでは指定出来ませんが、 conf.py に autodoc_default_options を指定する方法があります。
autodoc_default_options = {
'special-members': '__init__',
}
公式ドキュメント:
https://www.sphinx-doc.org/ja/master/usage/...
2
票
承認済み
生成される図のファイル名
実装コードはこのあたりです。
https://bitbucket.org/blockdiag/blockdiag/src/07f96892bfda92b84f624afab987015f26ff7ff0/src/blockdiag/utils/rst/nodes.py?at=default&fileviewer=file-view-default#nodes.py-49
残念ながら、...
2
票
承認済み
Read the docsにアップロードしたドキュメントにDocstring出力されない
他の依存パッケージと異なる部分は、backoffにはsetup.pyがないことです。
backoffのPyPI登録状況を見ると、whlとtar.gzがあるので特に問題なさそうです。
https://pypi.org/project/backoff/#files
https://readthedocs.org/projects/annofab-api-python-client/builds/...
2
票
承認済み
forkしたSphinxをローカルのclone環境でpytestを実行すると「ModuleNotFoundError: No module named '_testcapi'」が発生
Python本体のテスト用パッケージが不足している可能性があります。
CircleCIでテスト実行に使用している環境はこちらです。
https://github.com/sphinx-doc/docker-ci/blob/master/Dockerfile
Ubuntuであれば apt install python3-dev のインストールで解消する可能性がありそうです。
2
票
承認済み
Unicode正規化した後に、一文字のみ取り出して大文字にするとウムラウトが取れる
NFDは参考情報に挙げられているUnicode正規化で
文字は正準等価性によって分解される
と説明のある通りです。 ё U+0451 は е U+0435 と トレマ U+0308 の2文字に分解されます。
c[0] と指定すれば1文字目の е U+0435 だけが選択されるのは当然の結果です。
2
票
承認済み
自作Sphinx拡張のコードの一部にSphinxのコードを流用している場合の、Copyrightの書き方について
元が2条項BSDライセンスなので、以下が条件となります。
元のライセンスホルダーの名前を出す必要はありません
許可無く貢献者の名前を宣伝に用いてはいけないという条項もありません(3条項だとある)
ということで、2条項BSDライセンスに則っていれば後は自由です。
This part of the code uses sphinx/builder/html.
上記の部分は、...
2
票
承認済み
単語として切り出せる文字列に対して読み仮名を付与する場合に、指針となるようなPEPはありますか?
PEPはありません。
reStructuredTextに関するPEPは https://www.python.org/dev/peps/pep-0287/ がありますが、reStructuredTextの文法についてはほとんど触れられていません。
reStructuredTextの文法はdocutilsの公式ドキュメントが一時情報元になります。
しかし、index, ...
1
票
承認済み
index/glossaryディレクティブでのデータの取り込み処理で、conf.pyの設定値を使う方法。
reSTのdirectiveでconf.pyの設定値を参照するには以下の様に書きます。
class SomeDirective(SphinxDirective):
def run(self):
conf_val = self.config.your_config_value
ドキュメント
https://www.sphinx-doc.org/en/master/...
1
票
承認済み
PyPIパッケージでのClassifierの書き方について
良さそうです。
私自身は :: Only を付けていません。
https://github.com/jazzband/django-redshift-backend/blob/master/setup.cfg
代わりにClassifier以外で python_requires = >=3.6, <4 のようにPythonバージョンを指定しています。
https://packaging....
1
票
承認済み
__next__を使った__iter__はエラーになって、yieldを使った__iter__はエラーにならない
問題となるコードが提示できないようなので、これは推測になるのですが、イテレータ型として振る舞うためには、__iter__メソッドと__next__メソッドが必要です。
doctestがエラーになるコードを見ると、__iter__メソッドではselfを返していますが、このときのselfは__next__メソッドを実装していないのだと思います。(※現在は未使用と書いてたため推測)
そのため、...
1
票
承認済み
mathディレクティブをつかって数式内で日本語を使用する方法
前提の確認です
レンダリングには sphinx.ext.imgmath を使っていますか?
出力はHTMLですか?
出力しようとした数式のテキストと、エラーログを添付してください
sphinx.ext.imgmath は dvipng を使って数式をレンダリングします。
しかし、dvipngは日本語を扱えないようです。
代わりに sphinx.ext.mathjax を使ってみて下さい。
Only top scored, non community-wiki answers of a minimum length are eligible
関連するタグ
sphinx × 26python × 10
python3 × 10
read-the-docs × 2
アルゴリズム × 1
正規表現 × 1
emacs × 1
ライセンス × 1
unicode × 1
imagemagick × 1
circleci × 1
setuptools × 1
pypi × 1