Differences

This shows you the differences between two versions of the page.

--- configuration:sphinx [2022/09/18 15:35] – [Konfiguration Sphinx] omdevelop
+++ configuration:sphinx [2022/09/18 22:33] (current) – [Integration von Markdown-Files] omdevelop
@@ Line 9: / Line 9: @@
 ===== Installation Sphinx =====
-  * '**pip install -U sphinx**' in der Administrator-Console
+  * **'pip install -U sphinx'** in der Administrator-Console
@@ Line 17: / Line 17: @@
   * **sphinx-quickstart** ausführen
+===== Theme-Wechsel =====
+  * auf Github o.ä. passendes Theme finden: [[https://github.com/readthedocs/sphinx_rtd_theme | 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!!!
+===== Integration von Markdown-Files =====
+  * **'pip install --upgrade myst-parser'** {{https://www.sphinx-doc.org/en/master/usage/markdown.html | Sphinx-Markdown}}
+<code>
+source_suffix = {
+    '.rst': 'restructuredtext',
+    '.txt': 'markdown',
+    '.md': 'markdown',
+}
+#
+extensions = ["myst_parser"]
+</code>
+  * Markdown-Page **helper.md**:
+<code>
+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>
+</code>
+  * **'pip install nbsphinx'**
+  * **'pip install sphinx-math-dollar'**
+  * in 'conf.py' ändern:
+    * **'mathjax_config = {'** zu
+    * **'mathjax3_config = {'**
 ===== ToDo / Done =====