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

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 directive 插入手动分页符：

One page

.. raw:: pdf

    PageBreak

Another page

或者切换到不同的 PDF 引擎（我通过 pandoc 尝试了你的 reST markdown - 它使用 texlive - widow/orphan 分页看起来不错）。

编辑：

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

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

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

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

Restructured text splits paragraph between pages and adds erroneous list bullet

python-sphinx

restructuredtext

rst2pdf