このリンクに従って、SphinxからPDFを生成してみてください。
https://www.quora.com/How-to-create-a-PDF-out-of-Sphinx-documentation-tool
$ sphinx-build -b pdf source build/pdf
Error: Cannot find source directory `/Users/seb/mydocs/source'.
$ make all-pdf
make: *** No rule to make target `all-pdf'. Stop.
$ make pdf
make: *** No rule to make target `pdf'. Stop.
OSXで試したので:
$ conda install -c dfroger rst2pdf=0.93
Fetching package metadata .........
Solving package specifications: .
Error: Package missing in current osx-64 channels:
- rst2pdf 0.93*
Anaconda.orgでパッケージを検索できます
anaconda search -t conda rst2pdf
編集:
Pipインストール後rst2pdf
install rst2pdf
register rst2pdf in your conf.py Sphinx config
extensions = ['sphinx.ext.autodoc','rst2pdf.pdfbuilder']
ただし、「rst2pdf.pdfbuilder」を追加すると
Extension error:
Config value 'math_number_all' already present
make: *** [html] Error 1
$ sphinx-build -bpdf sourcedir outdir
しかし、sourcedirとoutdirとして何を指定しますか?例を挙げてください。
編集:
Htmlを作成した後
その後:
$ rst2pdf index.rst output.pdf
index.rst:14: (ERROR/3) Unknown directive type "toctree".
.. toctree::
:maxdepth: 2
入門チュートリアルmultiple_jobs展開プロジェクト
index.rst:26: (ERROR/3) Unknown interpreted text role "ref".
index.rst:27: (ERROR/3) Unknown interpreted text role "ref".
index.rst:28: (ERROR/3) Unknown interpreted text role "ref".
また:
$rst2pdf.py index.rst -o mydocument.pdf
Mydocument.pdfを作成しますが、htmlやtocとはまったく異なり、すべてのページがありませんか?
構成の変更に従うことで、DevStackドキュメントのPDFファイルを生成することに成功しました このリンクで :
手順は次のとおりです。
conf.py
を編集(値を編集または追加)
extensions = ['rst2pdf.pdfbuilder']
pdf_documents = [('index', u'rst2pdf', u'Sample rst2pdf doc', u'Your Name'),]
必要に応じて「 rst2pdf
」をインストールします
pip install rst2pdf
PDFファイルを次のようにビルドします。
sphinx-build -b pdf doc/source doc/build
Rst2pdfを避け、make pdflatex
を使用して、ラテックスファイルを介してpdf出力を作成できます。
cf詳細:
https://docs.typo3.org/typo3cms/extensions/sphinx/AdvancedUsersManual/RenderingPdf/
Latexを介したPDF生成に成功しました(Windows 10の場合)... Sphinxの既存のconf.pyファイルを変更する必要はありません...最適な解決策はMiKTeXをインストールすることです... Perl(ActiveState)をインストールすることです...実行後にsphinx type 'make HTML' type 'make latex'その後、latexPdfを作成します...これで私の問題は解決しました。
これは 公式のSphinxドキュメント からです。 pdfTex
ツールがマシンにインストールされている場合、必要なものは次のとおりです。
$ make latexpdf
次に、生成されたpdfファイルは_build/latex/<PROJECT-NAME>.pdf
したがって、ゼロからの完全なプロセスは次のようになります。
$ pip install -U sphinx # install the package
$ sphinx-quickstart # create a new project (answer the questions)
$ make latexpdf # compile and generate pdf file
ファイルを編集することで必要な拡張機能を「オプションで」インストールすることもできますconfig.py
この関連記事を見つけました これは、rst2pdfがSphinx 1.4.1の数学レンダリングを壊すことを発見しますダミーの数学モジュールをインポートするため。
rst2pdf.pdfbuilder:setup()
では、mathbase.setup()
を内部的に呼び出して、ダミーの数学モジュールをインストールします。競合が発生し、エラーが発生します。
sphinx-build -b pdf
を実行したときに同じエラーが発生しました
拡張エラー:
設定値 'math_number_all'はすでに存在します
latexオプションを見て、@ tfvが投稿されたときにpdfにエクスポートします。 pdflatex
はTeX分布のより大きな宇宙 。
http://rst2pdf.ralsina.me/handbook.html#sphinx をご覧ください。
以下はUbuntu 16に適用されます。
ただし、このツールを実行しようとするよりも、完全なLaTexスイートをインストールする方が痛みは少ないでしょう。エラーに非常に敏感であり、使用が困難です。
私はそこを見て( https://tex.stackexchange.com/a/9537 )、それは気難しいように見えます...
これはより励みになります: https://milq.github.io/install-latex-ubuntu-debian/
そして、私はそれをやった:
Sudo apt-get install texlive-full
make clean latexpdf
忍耐(およびディスク容量)をインストールする価値があります。 rst2pdfを取り除きました。