python-sphinx - 重组文本在页面之间拆分段落并添加错误的列表项目符号

Question

所以我的问题是我正在为我们的一个产品生成一个文档，这个项目分为两页，它添加了一个额外的项目符号（如下所示）。如何删除这个错误的项目符号或简单地将列表项强制到下一页？

分割线的语法

* I am a very long statement and I create a bullet when I continue on to the next line. Why does this happen? I am using rst2pdf to generate this document. Please send help. Blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah blah. *(XXXXXX-40A, August 2019)* (`CN-XXXXX <https://www.jira.com/browse/CN-XXXXX>`_)  

版本

pytest = "^5.0"
pylama = "^7.6"
pylint = "^2.2"
pytest-cov = "^2.6"
black = "18.9b0"
sphinx = "^2.0"
docutils = "0.16"

Answer 1

rst2pdf 使用raw 指令插入手动分页符：

One page

.. raw:: pdf

    PageBreak

Another page

或切换到不同的 PDF 引擎（我通过pandoc尝试了你的 reST 降价- 它使用 texlive - 寡妇/孤儿分页看起来很好）。

---

编辑：

我安装了rst2pdf v0.97并且开箱即用的 PDF 看起来也不错。

所以猜测你的 Sphinx 项目conf.py（或选择的 rst2pdf 样式表）必须是定制的。尝试不同的样式表以查看问题是否仍然存在，例如

pdf_stylesheets = ['autumn','kerning','a4-landscape']