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

除非嘗試進行修改的模塊是一個非常聰明的模塊，否則它將在不首先檢查權限位的情況下嘗試進行寫操作，並且在嘗試以寫模式打開文件時將被殺死，並帶有異常。 然后，您可以查看堆棧跟蹤，並（希望）了解哪個擴展的代碼錯誤地嘗試接觸您的源代碼。

如果確實獲得了堆棧跟蹤，則可以將其添加到問題的文本中。