zoukankan      html  css  js  c++  java
  • Sphinx编译docs文档

    在使用Python、Django的过程中,经常看到docs目录,里面存放着一些txt文本文件,也就是自带的一些帮助文档,里面有make.bat,在dos目录下直接执行make,给出的帮助是可以转换成Html、PDF等文件形式,那么,怎么转换这些帮助文档呢?直接执行make html发现提示sphinx-build不是内部或外部命令,在网上下载了Sphinx,并安装,再次执行make html时发现还是提示不是内部或外部命令,最后发现,Sphinx安装后,并没有在Python安装目录中生成Sphinx的模块,而是直接在Sphinx的源目录下生成了一个build目录,直接在当前目录中安装了。

    通过查找帮助,直接早dos环境进入sphinx源文件目录,在此目录下执行如下命令:

    python sphinx-build.py -b html 需要转化文档的全路径  转换后文档的全路径

    例如:我的Sphinx源文件路径在C:Sphinx-1.3.1,Django的docs路径在C:Django-1.8docs,现在将docs内容转换成html格式,并在docs中建立build目录,转换后的html存放目录,执行命令:

    C:Sphinx-1.3.1>python sphinx-build.py -b html C:Django-1.8docs C:Django-1.8docsuild,执行后,在build目录生成了django的帮助文档(Html格式的)。

    下列是需要安装的第三方工具:

    1.下载并安装Docutilshttp://docutils.sf.net/

    2.下载并安装sphinx http://pypi.python.org/pypi/Sphinx/1.1

    Sphinx 是用来生成文档的,可以生成html、htmlhelp/chm、qthelp、devhelp、latex、man 等格式的文档。

    3.在Widnows环境下,打开命令提示符,使用cd /d 命令将当前目录切换至Sphinx目录,运行命令:python sphinx-build.py -b html sourcedir builddir,其中,-b后面的字符串用于控制输出文档的格式,默认为html。sourcedir表示文档来源文件夹(一般就是包含conf.py文件的那个文件夹),builddir表示生成文档的目标文件夹。(注:在Windows环境下,请不要将sphinx文件夹、sourcedir builddir 设置成包含中文的路径,否则容易出现一些默名其妙的错误,例如编码错误。)

  • 相关阅读:
    sqlserver 时间格式函数详细
    asp.net中session的原理及应用
    asp.net中的cookie
    WCF 应用(一)
    c#操作word文档之简历导出
    浅解多线程
    .net反射详解
    正则表达式、常用的匹配总结
    存储过程详解
    jquery.pagination.js分页
  • 原文地址:https://www.cnblogs.com/ListenWind/p/4422640.html
Copyright © 2011-2022 走看看