manual/source
Begerad, Stefan 8129187bd9
All checks were successful
continuous-integration/drone/push Build is passing
feat: extend .drone.yml with step html
2022-12-14 20:46:36 +01:00
..
manual feat: extend .drone.yml with step html 2022-12-14 20:46:36 +01:00
conf.py feat: extend .drone.yml with step html 2022-12-14 20:46:36 +01:00
index.rst feat: add architecture section 2022-12-13 12:19:43 +01:00
readme.md feat: enable <make html> generation instruction 2022-11-14 15:28:07 +01:00

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 file
  • index.rst: root document serves as welcome page and contains root of ToC
  • manual: folder containing source files
  • readme.md: this file