如何創建一個PDF-外的獅身人面像的文檔工具

Question

遵循了這一環節，從獅身人面像試圖生成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 

編輯：

點子安裝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完全不同的所有頁面，即使不是嗎？

Image of pdf verse HTML same page

Answer 1

你可以避開rst2pdf和使用make pdflatex通過乳膠文件生成PDF輸出。

CF的詳細信息：

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

Answer 2

Found this related post其中發現rst2pdf打破了獅身人面像1.4.1因爲它導入一個虛擬的數學模塊的數學渲染。

In rst2pdf.pdfbuilder:setup() , it calls mathbase.setup() internally to install dummy math module. It causes conflicts and raise errors.

我跑sphinx-build -b pdf

Extension error:
Config value 'math_number_all' already present

當現在看看乳膠選項，並出口到PDF作爲@tfv發佈了同樣的錯誤。 pdflatex is a larger universe of TeX distribution。

Answer 3

我已經成功地通過下面的配置產生了DevStack文檔PDF文件更改in this link：

步驟如下：

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