Sphinx - TutorialGenerator

Open Hard- & Software [ DokuWiki WebSites MediaWiki NextCloud ]

• 'pip install -U sphinx' in der Administrator-Console

• Arbeitsverzeichnis erzeugen und dorthin wechseln: c:/Downloads/sphinx
• sphinx-quickstart ausführen

• auf Github o.ä. passendes Theme finden: sphinx_rtd_theme
• In Admin-Console Theme installieren: 'pip install sphinx-rtd-theme'
• ändern der Sphinx-Konfigurationsdatei conf.py auf html_theme = “sphinx_rtd_theme”
• wichtig: KEINE Hochkommas, sondern Gänsefüsse!!!

• 'pip install –upgrade myst-parser' Sphinx-Markdown

source_suffix = {
    '.rst': 'restructuredtext',
    '.txt': 'markdown',
    '.md': 'markdown',
}
#
extensions = ["myst_parser"]

• Markdown-Page helper.md:

Helper
======
# Main
## Sub
### SubSub
#### SubSubSub
##### SubSubSubSub
###### SubSubSubSubSub
<h1>asdfsd</h1>
<h2>asdfsd</h2>
<h3>asdfsd</h3>
<h4>asdfsd</h4>
<h5>asdfsd</h5>
<h6>asdfsd</h6>

• 'pip install nbsphinx'
• 'pip install sphinx-math-dollar'
• in 'conf.py' ändern:
  • 'mathjax_config = {' zu
  • 'mathjax3_config = {'

• Zweiteinrichtung des TutorialGenerators: Sphinx

Open Hard- & Software [ DokuWiki WebSites MediaWiki NextCloud ]