python的sphinx-build重新格式化rst文件

Question

sphinx-build修改了我的RST文件的格式，但我不知道如何停止它。 它仅在我运行make html之后发生，而我的IDE（PyCharm）没有进行格式化。

在make html之前：

General use plots
-----------------

.. autosummary::
    :toctree: generated/

    Study.plot_gene
    Study.plot_event

后make html ：

General use plots
-----------------

.. autosummary::
:toctree: generated/

        Study.plot_gene
        Study.plot_event

这是我的make html命令（与sphinx-quickstart相同）：

html:
    $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
    @echo
    @echo "Build finished. The HTML pages are in $(BUILDDIR)/html."

之前/之后的完整内容以及我的conf.py都位于： https : conf.py

Answer 1

如果您是说要对文件进行就地编辑，那将是非常令人惊讶的，而且-令人大跌眼镜-可能是由于您的extensions = [...]列表中列出的非标准Sphinx扩展名之一。 要发现哪一个，可以尝试使用以下命令从.rst文件中删除写许可权：

chmod a-w general_use_plots.rst

除非尝试进行修改的模块是一个非常聪明的模块，否则它将在不首先检查权限位的情况下尝试进行写操作，并且在尝试以写模式打开文件时将被杀死，并带有异常。 然后，您可以查看堆栈跟踪，并（希望）了解哪个扩展的代码错误地尝试接触您的源代码。

如果确实获得了堆栈跟踪，则可以将其添加到问题的文本中。