python's sphinx-build reformats rst files -

python's sphinx-build reformats rst files -

sphinx-build modifies formatting of rst files, , can't figure out how stop. happens after run make html, , ide (pycharm) isn't doing formatting.

before make html:

general utilize plots ----------------- .. autosummary:: :toctree: generated/ study.plot_gene study.plot_event

after make html:

general utilize plots ----------------- .. autosummary:: :toctree: generated/ study.plot_gene study.plot_event

this make html command (same sphinx-quickstart):

html: $(sphinxbuild) -b html $(allsphinxopts) $(builddir)/html @echo @echo "build finished. html pages in $(builddir)/html."

and total before/after, plus conf.py in: https://gist.github.com/olgabot/d8bb75b9d88bed19cb18

if mean files beingness edited in-place, extremely surprising , — @ wild guess — because of 1 of non-standard sphinx extensions listed in extensions = [...] list. find one, seek removing write permission .rst file, command like:

chmod a-w general_use_plots.rst

unless module attempting modification exceptionally clever one, effort write without checking permissions bits first, , killed exception when tries open file in write mode. @ stack trace , (hopefully) larn extension’s code incorrectly trying touch source.

if stack trace back, add together text of question.

python python-sphinx