InterImm / InterImmBook

:seedling: The Book of Interplanetary Civilization;星际移民之书.
http://book.interimm.org
201 stars 20 forks source link

换成 Sphinx 工具的任务列表 #51

Closed emptymalei closed 9 years ago

emptymalei commented 9 years ago

几个注意事项:

  1. rst 语法中,标题要求下面的符号的长度要至少跟标题文字长度相同,例如我们的标题使用的是 ---------- 作为标题的表示符号,那么下面的 --------- 的长度要至少跟标题一样长。
  2. 自动 index 的语法是

    :index:`需要 index 的内容`

    但是我觉得这个 inline 的不好用。所以建议使用 block level 的

    .. index:: 索引的题目

    需要注意的是,这个需要前后空行,并且 ::索引的题目之间需要添加空格。不过允许如下方式来同事对相同的地方索引两个不同的名字:

    .. index:: 词条1
    .. index:: 词条2

    即,两个 .. index:: XXX之间允许忽略空格。 详情见这里:http://sphinx-doc.org/markup/misc.html#directive-index