【问题标题】:Sphinx starts chapter numbering from 0 in LaTeX outputSphinx 在 LaTeX 输出中从 0 开始章节编号
【发布时间】:2019-03-11 12:09:56
【问题描述】:

我正在使用 Latex 使用 Sphinx 生成 PDF 文档。

======================
RX-loader instructions
======================

Program
=======

然而这会产生

0.1 RX-loader 指令
0.1.1 程序

如何让编号从 1 开始?

编辑: 我的 index.rst 是这样的

#######################
RX-loader documentation
#######################

.. toctree::
   :maxdepth: 2

   rx-loader

我的问题似乎是编号将“RX-loader 文档”作为第 0 章,并且总是将章节编号写入章节。

【问题讨论】:

  • 尝试使用不同的降价策略(见Headers);似乎双 === 被误认为是一个,导致它是 \section 而不是 \chapter
  • 我尝试将 === 替换为 *** 但结果仍然相同。
  • 如果您完全按照链接帖子中的建议进行操作,但没有解决您的问题,我不知道还有什么建议。
  • 好吧,我放弃了,改成了 asciidoc。我不喜欢 asciidoctor 使用 Ruby,但它解决了我的任务。

标签: latex pdf-generation python-sphinx


【解决方案1】:

以下可能是一个肮脏的技巧,但它会在 Sphinx 1.6.7 上产生所需的 pdf 行为(在 html 中必须删除第一行):

Filler text
======================
RX-loader instructions
======================

Program 1
---------
Program 2
---------

输出:

【讨论】:

  • 这对我的文档没有任何影响。
  • 您使用的是哪个 sphinx 和 python 版本?您确定您在 conf.py 中选择了 reStructuredText (.rst) 而不是 Markdown (.md) 文本吗?
  • sphinx-build 1.8.5 md 和 rst 在 conf.py 中启用
  • 我不确定出了什么问题,对我来说它有效。也许如果您使用的是 Windows,那可能就像我使用的是 Ubuntu 一样。
猜你喜欢
  • 1970-01-01
  • 1970-01-01
  • 2011-02-21
  • 2021-08-26
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
相关资源
最近更新 更多