zoukankan      html  css  js  c++  java
  • sphinx文档

    Sphinx logo

    下载

    目前版本: 1.2

    获得 Sphinx 从 Python Package Index, 或者使用如下命令安装:

    easy_install -U Sphinx

    最新的 开发版本文档 也是可用的。

    问题? 建议?

    请加入 Google group:

    或者加入在FreeNode上的频道#pocoo.

    你可以新建或者加入 话题.

    Welcome

    使用者说:

    “为这个伟大的工具而干杯,因为她让所有的程序员们愿意 编写文档!”

    Sphinx是一个工具,她能够轻易地创建智慧和优雅的文档,她是出自Georg Brandl之手,在BSD许可证下授权。

    她最初是为了新版的python文档, 因此在python项目的文档具有完美的特性,但是同样支持c/c++,目前正在计划增加对其他的语言的支持。 理所当然,本页面也是使用Sphinx创造自reStructuredText格式源!Sphinx具有如下的特点:

    • 输出格式: 超文本标记语言 (包括Windows HTML帮助),LaTeX (可打印的PDF版本),手册页,纯文本
    • 丰富的交叉引用: 语义标记以及针对函数,类,引用,词汇表(术语)和相似的信息块的自动链接
    • 层次结构: 简单的文本树定义,就能自动地链接到同层(兄弟姐妹)、上一层(父母)以及下一层(子女)的文本位置
    • 自动生成目录: 通用索引以及语言模块的目录
    • 代码高亮: 代码自动高亮,通过使用 Pygments
    • 扩展功能: 自动测试的代码片段,包括从Python模块(API文档)的文档字符串

    Sphinx 使用 reStructuredText 作为她的标记语言,她的优点大部分是来自于reStructuredText 以及reStructuredText的解析和转换工具(套件)Docutils的强大以及简单明了。

    文档

    你也能下载PDF格式的Sphinx文档:一种PDF 版本 是由LaTeX Sphinx生成,另一种PDF 版本 是由rst2pdf生成。

    实例

    用Sphinx生成文档的项目能够在 Projects using Sphinx上找到。

    想要查看Sphinx源文件长得什么样的话,可以在除本欢迎页外的任何页面上使用“显示网页源代码”。

    你也许对这份十分不错 教程感兴趣,它是由matplotlib的开发者编写,是使用了Sphinx创建地自定义的文档。

    下载 Sphinx

    Sphinx是一个可用的 easy-install包在 Python Package Index.

    源码能够在下面的地址中找到: http://bitbucket.org/birkenfeld/sphinx/

     
  • 相关阅读:
    赫夫曼树编码
    根据先序和中序实现后序
    C++语言实现开心消消乐
    C语言风格实现的开心消消乐
    动态规划
    leetcode dp wordbreakII
    欧拉回路
    欧拉通路是否存在
    Python|多任务:线程、进程、协程--你想要的都在这里
    网络通信:socket、udp与tcp
  • 原文地址:https://www.cnblogs.com/SofuBlue/p/8028988.html
Copyright © 2011-2022 走看看