dcmnttn/source
dancingCycle 005a577c0c feat: add LaTex build configuration 2022-11-09 12:40:50 +01:00
..
_static feat: add LaTex build configuration 2022-11-09 12:40:50 +01:00
dcmnttn feat: add file documenting.rst 2022-11-08 15:37:09 +01:00
conf.py feat: add LaTex build configuration 2022-11-09 12:40:50 +01:00
index.rst feat: add file documenting.rst 2022-11-08 15:37:25 +01:00
readme.md feat: initial commit 2022-11-08 15:18:03 +01:00

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 file
  • index.rst: root document serves as welcome page and contains root of ToC
  • readme.md: this file
  • _static:
  • _templated: