すべての質問
11 件の質問
1
票
1
回答
50
閲覧数
Sphinxプロジェクトフォルダを任意の階層に配置する方法
やりたいこと
開発プロジェクトにおいて、複数のドキュメントを作成し、それぞれsphinxドキュメントプロジェクトで管理したいです。
困っていること
ドキュメントフォルダを階層化すると、Pythonソースのモジュールドキュメントが生成できなくなります。
原因が分かりません。
試したこと
pythonソースコード
./source/init.py : 空ファイル
./source/app.py
def ...
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
回答
270
閲覧数
ロールの定義を関数からクラスに変えると、「make html」実行時に「TypeError: … takes no arguments」というエラーが発生する
自己回答で詳細を説明していますが、このエラーが __init__ に対するものだと気付けば、エラー情報から特定できるソースの該当箇所を見ることでadd_nodeの正しい書き方が分かります。
環境
windows10/cygwin64
python3.8
sphinx4.3.0+(開発版)
エラー内容
Exception occurred:
File "/usr/local/lib/...
0
票
1
回答
274
閲覧数
__next__を使った__iter__はエラーになって、yieldを使った__iter__はエラーにならない
<後日談>
回答の指摘で気づけましたが、単なる勘違いでした。__next となっていたのを見逃していたのが原因でした。経験の浅い言語のため、原因を __next__ に限定できていなかったのが根本原因だと受け止めます。
問題は解決しましたが、その解決方法の理屈が分からないので質問します。
よろしくお願いします。
<質問>
...
0
票
1
回答
260
閲覧数
Jinja2で自作オブジェクトを「文字列」と判定させる方法について、ドキュメントのどこかに説明がありますか?
問題そのものは解決していますが、手探りでPythhon/Sphinx/Jinja2を使っていることもあり、この問題の解決はかなり迷走していました。そのため、これに関連する知識を補強することを考えています。よろしくお願いします。
■質問
Jinja2で自作オブジェクトを「文字列」と認識させる方法は、以下の二つ
オブジェクトを渡すのは諦めて文字列を渡す。
unicodeクラスを継承したクラスを作る。
...
0
票
1
回答
77
閲覧数
index/glossaryディレクティブでのデータの取り込み処理で、conf.pyの設定値を使う方法。
Sphinx拡張を実装する際のパラメータ値の使い方についての質問です。
よろしくお願いします。
■質問
index/glossaryディレクティブでのデータの取り込み処理で、conf.pyの設定値を使う方法。
■備考
現状は次のように考えており、対応策もありますしダメ元な質問です。
方法はない。
次のように対処する:
データの受入処理では、データの取り込みだけに留める
表示する直前で、...
0
票
1
回答
370
閲覧数
Sphinxのsphinx-apidocコマンドによるソースドキュメント自動生成で、__init__関数を表示させる方法は?
Sphinxにおいて、docstirngを用いてソースコードからモジュールドキュメントを生成しています。
その際、sphinx-apidocコマンドを使用します。
例えば以下のように入力します。
sphinx-apidoc -f -P -o ./_documents_/Development/source/_root_source_ ./
このコマンドで生成された.rstファイルでは、...
0
票
1
回答
414
閲覧数
sphinx文章内の置換について、txtをincludeした場合の文字列処理
みなさん初めまして、どうぞ宜しくお願いいたします。
早速ですが、ある構造計算プログラムをpythonで作成しその結果を、exp.txtで書き出しています。書き出した中身は以下の様な内容です。
.. |t1| replace:: 100
.. |t2| replace:: ok
これを、ひな型としてsphinxであらかじめ作成しておいたrst内の先頭行で
.. ...