diff --git a/doc/_static/diagrams/sphinx_build_phases.dot b/doc/_static/diagrams/sphinx_build_phases.dot new file mode 100644 index 00000000000..2d566df066f --- /dev/null +++ b/doc/_static/diagrams/sphinx_build_phases.dot @@ -0,0 +1,18 @@ +digraph phases { + + graph [ + rankdir = LR + ] + + node [ + shape = rect; + style = filled; + fillcolor ="#f7f7f7"; + fontcolor = "#0a507a" + ] + + Initialization -> Reading; + Reading -> "Consistency checks"; + "Consistency checks" -> Resolving; + Resolving -> Writing; +} diff --git a/doc/extdev/index.rst b/doc/extdev/index.rst index 5160cd45e72..17618992726 100644 --- a/doc/extdev/index.rst +++ b/doc/extdev/index.rst @@ -95,6 +95,9 @@ Build phases One thing that is vital in order to understand extension mechanisms is the way in which a Sphinx project is built: this works in several phases. +.. graphviz:: /_static/diagrams/sphinx_build_phases.dot + :caption: Build phases + **Phase 0: Initialization** In this phase, almost nothing of interest to us happens. The source