web-dev-qa-db-ja.com

PDF-out-of-Sphinx-documentation-toolを作成する方法

このリンクに従って、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とはまったく異なり、すべてのページがありませんか?

PDFとHTMLの同じページの画像

12
niceseb

構成の変更に従うことで、DevStackドキュメントのPDFファイルを生成することに成功しました このリンクで

手順は次のとおりです。

  1. conf.pyを編集(値を編集または追加)

    extensions = ['rst2pdf.pdfbuilder']
    pdf_documents = [('index', u'rst2pdf', u'Sample rst2pdf doc', u'Your Name'),]
    
  2. 必要に応じて「 rst2pdf 」をインストールします

    pip install rst2pdf
    
  3. PDFファイルを次のようにビルドします。

    sphinx-build -b pdf doc/source doc/build
    
6

Rst2pdfを避け、make pdflatexを使用して、ラテックスファイルを介してpdf出力を作成できます。

cf詳細:

https://docs.typo3.org/typo3cms/extensions/sphinx/AdvancedUsersManual/RenderingPdf/

5
tfv

Latexを介したPDF生成に成功しました(Windows 10の場合)... Sphinxの既存のconf.pyファイルを変更する必要はありません...最適な解決策はMiKTeXをインストールすることです... Perl(ActiveState)をインストールすることです...実行後にsphinx type 'make HTML' type 'make latex'その後、latexPdfを作成します...これで私の問題は解決しました。

2

これは 公式の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

1
Aziz Alto

この関連記事を見つけました これは、rst2pdfSphinx 1.4.1の数学レンダリングを壊すことを発見しますダミーの数学モジュールをインポートするため。

rst2pdf.pdfbuilder:setup()では、mathbase.setup()を内部的に呼び出して、ダミーの数学モジュールをインストールします。競合が発生し、エラーが発生します。

sphinx-build -b pdfを実行したときに同じエラーが発生しました

拡張エラー:
設定値 'math_number_all'はすでに存在します

latexオプションを見て、@ tfvが投稿されたときにpdfにエクスポートします。 pdflatexはTeX分布のより大きな宇宙

1

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を取り除きました。

1
axd