diff options
Diffstat (limited to 'lib/spack/docs/conf.py')
| -rw-r--r-- | lib/spack/docs/conf.py | 18 |
1 files changed, 15 insertions, 3 deletions
diff --git a/lib/spack/docs/conf.py b/lib/spack/docs/conf.py index 5455aa0f28..48746d149e 100644 --- a/lib/spack/docs/conf.py +++ b/lib/spack/docs/conf.py @@ -23,7 +23,10 @@ import subprocess import sys from glob import glob +from docutils.statemachine import StringList +from sphinx.domains.python import PythonDomain from sphinx.ext.apidoc import main as sphinx_apidoc +from sphinx.parsers import RSTParser # -- Spack customizations ----------------------------------------------------- # If extensions (or modules to document with autodoc) are in another directory, @@ -82,9 +85,6 @@ todo_include_todos = True # # Disable duplicate cross-reference warnings. # -from sphinx.domains.python import PythonDomain - - class PatchedPythonDomain(PythonDomain): def resolve_xref(self, env, fromdocname, builder, typ, target, node, contnode): if 'refspecific' in node: @@ -92,8 +92,20 @@ class PatchedPythonDomain(PythonDomain): return super(PatchedPythonDomain, self).resolve_xref( env, fromdocname, builder, typ, target, node, contnode) +# +# Disable tabs to space expansion in code blocks +# since Makefiles require tabs. +# +class NoTabExpansionRSTParser(RSTParser): + def parse(self, inputstring, document): + if isinstance(inputstring, str): + lines = inputstring.splitlines() + inputstring = StringList(lines, document.current_source) + super().parse(inputstring, document) + def setup(sphinx): sphinx.add_domain(PatchedPythonDomain, override=True) + sphinx.add_source_parser(NoTabExpansionRSTParser, override=True) # -- General configuration ----------------------------------------------------- |