Sphinx
Introduction
Sphinx is a documentation system similar to Doxygen, designed primarily to document Python code. With the use of \"Breathe\" it can also be used to parse C++ code, so it can be used in projects that mix C++ and Python.
Visit the Sphinx website to learn more about the system, and consult the Sphinx manual for the full information.
Sphinx and FreeCAD
This document gives a brief introduction to Sphinx, in particular how it is used in FreeCAD to document its sources. Visit the source documentation page for instructions on building the FreeCAD documentation, which is also hosted online on the FreeCAD API website.
General workflow to produce source code documentation with Sphinx. (Editor's note: update this image)
Sphinx and FreeCAD Preview
Encouraging results from David_D:
FreeCAD Forum Discussion
- This is now a thread about documentation
- Documenting Python Extensions
- Automatic Documentation Generation & Hosting
- FreeCAD Forum Post - https://github.com/DavidDaish/freecad_sphinx_docs
⏵ documentation index > Developer_Documentation > Sphinx
This page is retrieved from https://github.com/FreeCAD/FreeCAD-documentation/blob/main/wiki/Sphinx.md