Projekt-HowTo

---

---

gen-bootstrap-toc.sh & htmlTitle.py

• Das Projekt via shell- und python-Skript erzeugen (, dazu eventuell die Datei-Liste "md_list.txt" durchgehen)
  • Das Skript "htmlTitle.py" extrahiert den Titel der HTML-Datei aus der MD-Datei "$1.md" (erste Zeile, unterstrichen mit =====) und erzeugt die HTML-Datei "head.html" aus dem Template "head.temp"
  • "$1" steht für den Parameter (das Argument), der dem shell-Skript "gen-bootstrap-toc.sh" übergeben wird.
  • Das Skript "gen-bootstrap-toc.sh" ruft zuerst "htmlTitle.py" auf: /usr/bin/python htmlTitle.py $1.md.
  • Im zweiten Schritt wird mit dem Python-Markdown Modul die md-Datei nach HTML kovertiert:
    /usr/bin/python -m markdown --encoding=utf-8 --extension=markdown.extensions.toc --extension=markdown.extensions.tables $1.md -f main.html
    Ergebnis ist die Datei "main.html".
  • Im dritten Schritt werden die vier Dateien "head.html", "toc.html", "main.html" und "_end_.html" via catzusammengesetzt zu einer HTML-Datei: "$1.html":
    cat head.html toc.html main.html _end_.html > $1.html

---

Die Unterverzeichnisse

• beispiele: Enthält die Beispiele als Python (*.py) sowie als *.html-Datei

• js: Ordner für die js-Dateien

• media: Ordner für die Bilder

  • Bilder in den media-Ordner kopieren, Link zu den Bildern: "./bild001.png" → "./media/bild001.png"

• themes: Ordner für die css-Dateien

---

To Do

• faq.md > Link zur alten Version (= python 2.7-Version): http://wspnet.de/pykurs27 → ok

• python12.md: Dictionaries haben sich verändert!!! As of Python version 3.7, dictionaries are ordered. In Python 3.6 and earlier, dictionaries are unordered. When we say that dictionaries are ordered, it means that the items have a defined order, and that order will not change. Unordered means that the items does not have a defined order, you cannot refer to an item by using an index → Verwende in statt has_key()

• Beispiele: py2.7 → py3.x → ok

• Zu den Python-Beispielen die HTM-Dateien neu erzeugen → sourceParser-vers009a (tkSourceParser.py) → ok

• Tkinter zum Probieren → zeitnah!

• index.md/index.html: Das *.gif Bild im HTML-Code aus der h2-Überschrift zur h1-Überschrift verschieben (im Markdown-Code schlecht abzubilden):

  <h2 id="python-kurs">Python-Kurs      <img alt="" src="./media/kurs_logo.gif" /> </h2>   → 
  <h1 id="programmieren-in-python3">Programmieren in Python3      <img alt="" src="./media/kurs_logo.gif" /> </h1>

---

• sp, 2023-08-01

---