[sphinx] タグが付いた質問
SphinxはPythonで実装されたドキュメンテーションツール。reStructuredTextというマークアップ言語を用いて文章を記述する。章などの単位でファイルを分割したり、見出しから目次を自動生成するなどの機能を持つ。
27 件の質問
1
票
1
回答
50
閲覧数
Sphinxプロジェクトフォルダを任意の階層に配置する方法
やりたいこと
開発プロジェクトにおいて、複数のドキュメントを作成し、それぞれsphinxドキュメントプロジェクトで管理したいです。
困っていること
ドキュメントフォルダを階層化すると、Pythonソースのモジュールドキュメントが生成できなくなります。
原因が分かりません。
試したこと
pythonソースコード
./source/init.py : 空ファイル
./source/app.py
def ...
1
票
1
回答
516
閲覧数
Sphinx で箇条書きの途中で改行したい
現在Sphinxでドキュメントを作成しているのですが、以下のように箇条書きで改行を行い、行間なく次の文字列を表示したいです。
・文字列1
文字列2
ラインブロックを使用して以下のようにしましたが、だめでした。
| * 文字列1
| 文字列2
どうすれば箇条書きで改行を行い、行間なく次の文字列を表示できるのでしょうか。
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
回答
199
閲覧数
Sphinxで「|漢字《よみ》」という記法で文章中に振り仮名をつけたい場合、Sphinx拡張で対応は可能でしょうか?
Sphinx拡張についての質問です。
私が持っていない良いアイデアがあればと思い質問します。
よろしくお願いします。
<質問>
Sphinxで「|漢字《よみ》」という記法で文章中に振り仮名をつけたい場合、Sphinx拡張で対応は可能でしょうか?
<背景>
明示的に「単語」単位で切り出せる「.. index::」「.. glossary::」「:index:」では、「よみ|...
0
票
1
回答
47
閲覧数
forkしたSphinxをローカルのclone環境でpytestを実行すると「tests/test_ext_imgconverter.py」がFAILする。
現象
forkしたsphinxをローカルのclone環境でpytestを実行すると「tests/test_ext_imgconverter.py」がFAILする。「svgimg.svg」ないというエラー。
メッセージを見てフォルダーを確認すると次の通り
/tmp/pytest-of-USERNAME/pytest-1/ext-imgconverter/svgimg.svg … あり
/tmp/...
0
票
2
回答
159
閲覧数
forkしたSphinxをローカルのclone環境でpytestを実行すると「ModuleNotFoundError: No module named '_testcapi'」が発生
Sphinxの開発環境に慣れている方ならFAQかもしれません。
宜しくお願いします。
質問
forkしたSphinxをローカルのclone環境でpytestを実行する場合に、必要な準備について教えてください。
現状
次のエラーが発生します。(「=」「_」「!」は多いので削りました)
======== ERRORS ===========================================...
0
票
1
回答
204
閲覧数
readthedocsサイトでビルドエラー(use_2to3、funcparserlib)
readthedocsでのドキュメント生成時のエラーについての質問です。
まだ公開を果たした実績がなく、慣れている人にはFAQレベルかもしれません。
よろしくおねがいします。
質問
次のエラーの解決方法をご存知でしょうか。
funcparserlib0.3.5でエラーになるのですが、最新版にしようとするとエラーになって最新にできません。
どちらのエラーも、...
0
票
1
回答
122
閲覧数
Unicode正規化した後に、一文字のみ取り出して大文字にするとウムラウトが取れる
Pythonのプログラムをデバッグしていて気付いた挙動についての質問です。
よろしくお願いします。
質問
Unicode正規化した後に、一文字のみ取り出して大文字にするとウムラウトが取れます。これってUnicodeの規格としては正しい挙動なのでしょうか。
※正しい挙動である場合、何か参考情報があると喜びます。
参考情報
Unicode正規化 - Qiita
Unicode正規化 - ...
0
票
1
回答
95
閲覧数
自作Sphinx拡張のコードの一部にSphinxのコードを流用している場合の、Copyrightの書き方について
BSDライセンスのため、流用そのものについては問題ないと判断しています。
どちらかといえばリスペクト的な意味でSphinxの名前を出しておきたい、という趣旨です。
一般的な表記方法などあれば教えてもらえると助かります。
質問
例えば、sphinx/builders/html/__init__.py には次のような記載があります。
sphinx.builders.html
~~~~~~~~~~~~~~...
0
票
1
回答
270
閲覧数
ロールの定義を関数からクラスに変えると、「make html」実行時に「TypeError: … takes no arguments」というエラーが発生する
自己回答で詳細を説明していますが、このエラーが __init__ に対するものだと気付けば、エラー情報から特定できるソースの該当箇所を見ることでadd_nodeの正しい書き方が分かります。
環境
windows10/cygwin64
python3.8
sphinx4.3.0+(開発版)
エラー内容
Exception occurred:
File "/usr/local/lib/...
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
回答
77
閲覧数
index/glossaryディレクティブでのデータの取り込み処理で、conf.pyの設定値を使う方法。
Sphinx拡張を実装する際のパラメータ値の使い方についての質問です。
よろしくお願いします。
■質問
index/glossaryディレクティブでのデータの取り込み処理で、conf.pyの設定値を使う方法。
■備考
現状は次のように考えており、対応策もありますしダメ元な質問です。
方法はない。
次のように対処する:
データの受入処理では、データの取り込みだけに留める
表示する直前で、...
0
票
1
回答
274
閲覧数
__next__を使った__iter__はエラーになって、yieldを使った__iter__はエラーにならない
<後日談>
回答の指摘で気づけましたが、単なる勘違いでした。__next となっていたのを見逃していたのが原因でした。経験の浅い言語のため、原因を __next__ に限定できていなかったのが根本原因だと受け止めます。
問題は解決しましたが、その解決方法の理屈が分からないので質問します。
よろしくお願いします。
<質問>
...
0
票
1
回答
260
閲覧数
Jinja2で自作オブジェクトを「文字列」と判定させる方法について、ドキュメントのどこかに説明がありますか?
問題そのものは解決していますが、手探りでPythhon/Sphinx/Jinja2を使っていることもあり、この問題の解決はかなり迷走していました。そのため、これに関連する知識を補強することを考えています。よろしくお願いします。
■質問
Jinja2で自作オブジェクトを「文字列」と認識させる方法は、以下の二つ
オブジェクトを渡すのは諦めて文字列を渡す。
unicodeクラスを継承したクラスを作る。
...
0
票
1
回答
370
閲覧数
Sphinxのsphinx-apidocコマンドによるソースドキュメント自動生成で、__init__関数を表示させる方法は?
Sphinxにおいて、docstirngを用いてソースコードからモジュールドキュメントを生成しています。
その際、sphinx-apidocコマンドを使用します。
例えば以下のように入力します。
sphinx-apidoc -f -P -o ./_documents_/Development/source/_root_source_ ./
このコマンドで生成された.rstファイルでは、...
0
票
1
回答
2,089
閲覧数
Sphinxでmakeコマンドを実行するとエラーになる
MacでSphinx (1.6.3)を利用しています。
sphinx-quickstartを実行して、make htmlをしてみましたがエラーが出てしまいます。
make html
/usr/bin/python: No module named sphinx.__main__; 'sphinx' is a package and
cannot be directly executed
...
1
票
1
回答
968
閲覧数
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ではなさそうなので、ほかにどんな候補があるのかを知りたいです。
...
1
票
1
回答
223
閲覧数
sphinxの検索結果の表示にreStructuredTextがそのまま表示されます
Sphinx1.8.2を使用しています。
検索すると、下記のようにreStructuredTextがそのまま表示されてしまいます。
どのように設定すれば、文字列だけの表示になるのでしょうか?
関わりのある情報をまとめてみる
.. include:: ./include_pagebreak.rst ..
_useful-dashboard-label: ****************...
1
票
1
回答
128
閲覧数
sphinxでPDFを作成するときに分割したい
Sphinx1.8.2でアプリのマニュアルを作成しています。
1~10章までありますが、HTMLへは全章を、
PDFは2分割して、1~7章を「基本編」として、8~10章を「応用編」として、出力したいのです。
また、この時のtitleもそれぞれ「基本編」「応用編」として別々にしたいと思っています。
このような場合の設定方法をご教示ください。
0
票
1
回答
414
閲覧数
sphinx文章内の置換について、txtをincludeした場合の文字列処理
みなさん初めまして、どうぞ宜しくお願いいたします。
早速ですが、ある構造計算プログラムをpythonで作成しその結果を、exp.txtで書き出しています。書き出した中身は以下の様な内容です。
.. |t1| replace:: 100
.. |t2| replace:: ok
これを、ひな型としてsphinxであらかじめ作成しておいたrst内の先頭行で
.. ...
2
票
1
回答
63
閲覧数
生成される図のファイル名
はじめまして、よろしくお願いします。
blockdiagやplantUML拡張で生成される図のファイル名を固定する方法はありますか?
blockdiag-03f29426fa631bca7b8304618538c8e37ce62f38.png
のようなファイル名になり、記述を変えるごとに別の名前で生成されていきます。
使用環境
Windows10
Python 3.6.4
Sphinx 1.7....
1
票
1
回答
341
閲覧数
mathディレクティブをつかって数式内で日本語を使用する方法
Sphinxで数式内で日本語を使いたいと思っているのですが、上手くできず困っています。
webで検索すると、\mboxを使用することで、数式内で日本語が使用できるとあったのですが、Sphinxではエラーが出てしまい、日本語が使用できません。
日本語無しの数式が出力されることは確認しています。
単純に下記のようにしてもエラーとなってしまいます。
.. math::
\mbox{日本語}
...
1
票
1
回答
1,273
閲覧数
Sphinx のインストールについて
Sphinx のインストールをpipでしました.
ですが,sphinx-quickstartで始めようとしたところ,以下の様なエラーが出てしまいました.
user:~ $ sphinx-quickstart
Traceback (most recent call last):
File "user/anaconda/bin/sphinx-quickstart", line 9, in <...
7
票
1
回答
409
閲覧数
Emacs で reStructuredText を編集中する際に、コードブロックを別途シンタックスハイライトしたい
Sphinx を用いて文章作成をしています。
Emacs で以下のような reStructuredText フォーマットのファイルを編集している際に、
コードブロック (code-block) の中身だけ rst-mode とは別のメジャーモードでシンタックスハイライトしたいのですが、どうすれば上手くできるでしょうか。
こんにちは世界
==============
- ほげほげ
.. ...