README.md

Building the DOLFINx Python documentation

To build the documentation:

Install DOLFINx Python interface using the docs dependency group, e.g.
```
python -m pip install --group docs .
```
It must be possible to import the module dolfinx to build the documentation.

Run in this directory:

python -m sphinx -W -b html source/ build/html/

Python demo programs are written in Python, with MyST-flavoured Markdown syntax for comments.

jupytext reads the Python demo code, then converts it to a Markdown file and Jupyter notebook.
myst_parser allows Sphinx to process the Markdown file.