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

Question

sphinx-build修改了我的RST文件的格式，我不知道如何让它停止。只有在我运行make html，并且我的集成开发环境(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://gist.github.com/olgabot/d8bb75b9d88bed19cb18

Answer 1

如果您的意思是文件正在被就地编辑，那么这是非常令人惊讶的，而且可能是因为您的extensions = [...]列表中列出了一个非标准的Sphinx扩展名。要找出是哪一个，您可以尝试删除.rst文件的写权限，命令如下：

chmod a-w general_use_plots.rst

除非尝试修改的模块是一个异常聪明的模块，否则它将在没有检查权限位的情况下尝试写入，并在尝试以写入模式打开文件时被异常终止。然后，您可以查看堆栈跟踪，并(希望)了解哪个扩展的代码错误地试图触动您的源代码。

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