将RST格式的文档转换为为pdf文档

2019独角兽企业重金招聘Python工程师标准>>>

转载自：https://my.oschina.net/zctzl/blog/896236

为了更方便的阅读，我们有时需要将一些RST的文档转化为PDF格式，下面介绍了在Windows的环境下的具体过程：

一、首先安装Sphinx（参考教程：http://www.sphinx-doc.org/en/stable/install.html#mac-os-x-install-sphinx-using-macports））

    由于Sphinx是用Python语言编写的,所以你需要安装Python(要求至少为2.7的版本)和Sphinx

    ①安装Python（下载地址：https://www.python.org/）

    

    点开网址，找到Downloads目录下，选择对应的操作系统（这里以windows为例）下的下载链接进行下载，完成后得到一个如下图的python-3.6.1.exe文件

     

    双击文件开始安装

     

    勾选Add Python 3.6 to PATH以便自动配置环境变量（否则可能需要自己手动配置环境变量），然后再点击Install Now进行安装。

    

    验证是否安装成功：打开命令提示符窗口 输入python

C:\Users\zw>python

若出现python版本信息则表示安装成功

    

②安装pip

    Python有一个非常有用的pip命令可以用单个命令下载并安装第三方库。我们同样需要在Python的官网上去下载，（下载地址：https://pypi.python.org/pypi/pip#downloads）

           

    下载完成之后，解压到一个文件夹，用CMD控制台进入解压目录，输入下面的命令：

C:\Users\zw\Desktop>cd C:\Users\zw\Desktop\pip-9.0.1
C:\Users\zw\Desktop\pip-9.0.1>python setup.py install

    此时pip已经安装成功，接下来通过pip安装Sphinx ，可以使用pip list命令检验是否安装成功

C:\Users\zw\Desktop\pip-9.0.1>pip list

    结果如下图所示：

   接下来，使用pip来安装sphinx

C:\Users\zw\Desktop\pip-9.0.1>pip install sphinx

    结果如下所示：

     

二、准备需要转化的RST格式的文档，这里以github上的geonetwork文档为例。从github上download下来（下载网址：https://github.com/geonetwork/doc）

    点击Download ZIP下载到本地并解压，得到一个名为doc-develop的文件夹

 

三、转成pdf格式（参考教程：https://github.com/talkincode/talkincode.org/issues/1）

创建一个名为document的文件夹，进入该文件夹，并使用sphinx-quickstart命令来生成我们的文档

C:\Users\zw\Desktop\pip-9.0.1>cd ..

C:\Users\zw\Desktop>mkdir document

C:\Users\zw\Desktop>cd document

C:\Users\zw\Desktop\document>sphinx-quickstart

在需要填写信息的地方（如工程名，版本等）填写对应的信息，其他全部选择默认选项，回车

     

  完成后自动生成如下目录结构:

    将上面下载好的doc-develop文件打开，选择需要转换格式的部分（如里面的名为“en”的子文件夹）

选中该子文件夹的所有文件复制到document文件夹里面（会出现是否替换的提示，选择是），将命令提示符的目录切换到document下执行如下命令进行格式转换：

C:\Users\zw\Desktop\document>make latex

结果如下图所示：

    转化后的Latex格式的文件就保存在document文件下的名为_build的子文件夹下。最后使用LaTex编辑工具即可再将其转换为PDF格式。

 

转载于:https://my.oschina.net/xhhuang/blog/896244