Begerad, Stefan
b38807c62a
All checks were successful
continuous-integration/drone/push Build is passing
|
||
---|---|---|
.. | ||
manual | ||
conf.py | ||
index.rst | ||
readme.md |
Introduction
This is the source directory of the Sphinx documentation generator.
Build
You can build HTML files like this.
sphinx-build -b html <sourcedir> <builddir>
Configuration
Markdown
Configure Sphinx for Markdown support like this.
https://www.sphinx-doc.org/en/master/usage/markdown.html
NOTE: Make sure to add 'myst_parser'
to
extension
to the configuration.
Exclude Documentation
Add all files and folders to be excluded from the generation to
exclude_patterns
.
File System
conf.ph
: Sphinx configuration fileindex.rst
: root document serves as welcome page and contains root of ToCmanual
: folder containing source filesreadme.md
: this file