Skip to main content

[sphinx] タグが付いた質問

SphinxはPythonで実装されたドキュメンテーションツール。reStructuredTextというマークアップ言語を用いて文章を記述する。章などの単位でファイルを分割したり、見出しから目次を自動生成するなどの機能を持つ。

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

Sphinxプロジェクトフォルダを任意の階層に配置する方法

やりたいこと 開発プロジェクトにおいて、複数のドキュメントを作成し、それぞれsphinxドキュメントプロジェクトで管理したいです。 困っていること ドキュメントフォルダを階層化すると、Pythonソースのモジュールドキュメントが生成できなくなります。 原因が分かりません。 試したこと pythonソースコード ./source/init.py : 空ファイル ./source/app.py def ...
Takahiro  Funahashi's user avatar
1
1 回答
516 閲覧数

Sphinx で箇条書きの途中で改行したい

現在Sphinxでドキュメントを作成しているのですが、以下のように箇条書きで改行を行い、行間なく次の文字列を表示したいです。 ・文字列1  文字列2 ラインブロックを使用して以下のようにしましたが、だめでした。 | * 文字列1 | 文字列2 どうすれば箇条書きで改行を行い、行間なく次の文字列を表示できるのでしょうか。
Tanaka Takeru's user avatar
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/...
yuji38kwmt's user avatar
  • 1,854
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/...
KaKkouo's user avatar
  • 86
0
2 回答
159 閲覧数

forkしたSphinxをローカルのclone環境でpytestを実行すると「ModuleNotFoundError: No module named '_testcapi'」が発生

Sphinxの開発環境に慣れている方ならFAQかもしれません。 宜しくお願いします。 質問 forkしたSphinxをローカルのclone環境でpytestを実行する場合に、必要な準備について教えてください。 現状 次のエラーが発生します。(「=」「_」「!」は多いので削りました) ======== ERRORS ===========================================...
KaKkouo's user avatar
  • 86
0
1 回答
204 閲覧数

readthedocsサイトでビルドエラー(use_2to3、funcparserlib)

readthedocsでのドキュメント生成時のエラーについての質問です。 まだ公開を果たした実績がなく、慣れている人にはFAQレベルかもしれません。 よろしくおねがいします。 質問 次のエラーの解決方法をご存知でしょうか。 funcparserlib0.3.5でエラーになるのですが、最新版にしようとするとエラーになって最新にできません。 どちらのエラーも、...
KaKkouo's user avatar
  • 86
0
1 回答
122 閲覧数

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

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

自作Sphinx拡張のコードの一部にSphinxのコードを流用している場合の、Copyrightの書き方について

BSDライセンスのため、流用そのものについては問題ないと判断しています。 どちらかといえばリスペクト的な意味でSphinxの名前を出しておきたい、という趣旨です。 一般的な表記方法などあれば教えてもらえると助かります。 質問 例えば、sphinx/builders/html/__init__.py には次のような記載があります。 sphinx.builders.html ~~~~~~~~~~~~~~...
KaKkouo's user avatar
  • 86
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/...
KaKkouo's user avatar
  • 86
0
1 回答
287 閲覧数

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

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

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

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

Sphinxで「|漢字《よみ》」という記法で文章中に振り仮名をつけたい場合、Sphinx拡張で対応は可能でしょうか?

Sphinx拡張についての質問です。 私が持っていない良いアイデアがあればと思い質問します。 よろしくお願いします。 <質問> Sphinxで「|漢字《よみ》」という記法で文章中に振り仮名をつけたい場合、Sphinx拡張で対応は可能でしょうか? <背景> 明示的に「単語」単位で切り出せる「.. index::」「.. glossary::」「:index:」では、「よみ|...
KaKkouo's user avatar
  • 86
0
1 回答
260 閲覧数

Jinja2で自作オブジェクトを「文字列」と判定させる方法について、ドキュメントのどこかに説明がありますか?

問題そのものは解決していますが、手探りでPythhon/Sphinx/Jinja2を使っていることもあり、この問題の解決はかなり迷走していました。そのため、これに関連する知識を補強することを考えています。よろしくお願いします。 ■質問 Jinja2で自作オブジェクトを「文字列」と認識させる方法は、以下の二つ オブジェクトを渡すのは諦めて文字列を渡す。 unicodeクラスを継承したクラスを作る。 ...
KaKkouo's user avatar
  • 86
1
1 回答
101 閲覧数

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

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

index/glossaryディレクティブでのデータの取り込み処理で、conf.pyの設定値を使う方法。

Sphinx拡張を実装する際のパラメータ値の使い方についての質問です。 よろしくお願いします。 ■質問 index/glossaryディレクティブでのデータの取り込み処理で、conf.pyの設定値を使う方法。 ■備考 現状は次のように考えており、対応策もありますしダメ元な質問です。 方法はない。 次のように対処する: データの受入処理では、データの取り込みだけに留める 表示する直前で、...
KaKkouo's user avatar
  • 86
0
1 回答
370 閲覧数

Sphinxのsphinx-apidocコマンドによるソースドキュメント自動生成で、__init__関数を表示させる方法は?

Sphinxにおいて、docstirngを用いてソースコードからモジュールドキュメントを生成しています。 その際、sphinx-apidocコマンドを使用します。 例えば以下のように入力します。 sphinx-apidoc -f -P -o ./_documents_/Development/source/_root_source_ ./ このコマンドで生成された.rstファイルでは、...
Takahiro  Funahashi's user avatar
1
1 回答
968 閲覧数

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

背景 PythonのdocstringをGoogle Styleで記載しています。 docstringの内容は、sphinxのautodoc機能でHTMLドキュメントに反映しています。 質問 非推奨のメソッドは、docstringにどのような内容を記載すればよいでしょうか? JavaDocの@Deprecatedのようなタグを期待しています。 Example Google Style ...
yuji38kwmt's user avatar
  • 1,854
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/...
yuji38kwmt's user avatar
  • 1,854
1
1 回答
111 閲覧数

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

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

sphinxの検索結果の表示にreStructuredTextがそのまま表示されます

Sphinx1.8.2を使用しています。 検索すると、下記のようにreStructuredTextがそのまま表示されてしまいます。 どのように設定すれば、文字列だけの表示になるのでしょうか? 関わりのある情報をまとめてみる .. include:: ./include_pagebreak.rst .. _useful-dashboard-label: ****************...
user avatar
1
1 回答
128 閲覧数

sphinxでPDFを作成するときに分割したい

Sphinx1.8.2でアプリのマニュアルを作成しています。 1~10章までありますが、HTMLへは全章を、 PDFは2分割して、1~7章を「基本編」として、8~10章を「応用編」として、出力したいのです。 また、この時のtitleもそれぞれ「基本編」「応用編」として別々にしたいと思っています。 このような場合の設定方法をご教示ください。
user avatar
0
1 回答
414 閲覧数

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

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

生成される図のファイル名

はじめまして、よろしくお願いします。 blockdiagやplantUML拡張で生成される図のファイル名を固定する方法はありますか? blockdiag-03f29426fa631bca7b8304618538c8e37ce62f38.png のようなファイル名になり、記述を変えるごとに別の名前で生成されていきます。 使用環境 Windows10 Python 3.6.4 Sphinx 1.7....
Hide's user avatar
  • 23
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 ...
otera's user avatar
  • 141
1
1 回答
341 閲覧数

mathディレクティブをつかって数式内で日本語を使用する方法

Sphinxで数式内で日本語を使いたいと思っているのですが、上手くできず困っています。 webで検索すると、\mboxを使用することで、数式内で日本語が使用できるとあったのですが、Sphinxではエラーが出てしまい、日本語が使用できません。 日本語無しの数式が出力されることは確認しています。 単純に下記のようにしてもエラーとなってしまいます。 .. math:: \mbox{日本語} ...
ken's user avatar
  • 13
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 <...
Akira Matsui's user avatar
7
1 回答
409 閲覧数

Emacs で reStructuredText を編集中する際に、コードブロックを別途シンタックスハイライトしたい

Sphinx を用いて文章作成をしています。 Emacs で以下のような reStructuredText フォーマットのファイルを編集している際に、 コードブロック (code-block) の中身だけ rst-mode とは別のメジャーモードでシンタックスハイライトしたいのですが、どうすれば上手くできるでしょうか。 こんにちは世界 ============== - ほげほげ .. ...
seikichi's user avatar
  • 206