Handbuch als Markdown: doc/handbuch.md aus dem OCR-Text, mit Konverter

README.md

@@ -97,6 +97,12 @@ Er ist nicht korrigiert: Tabulatoren fehlen, Tabellen können verrutscht sein. J
 Seite ist mit PDF- und Buchseite markiert (Buchseite = PDF-Seite − 10). Kapitel 1–16
 sind ein Lehrbuch, Kapitel 17 enthält dieselben Man-Pages wie `man/`.
 
+`doc/handbuch.md` ist dieselbe Vorlage lesbar gesetzt: ein Abschnitt je „Section“, Überschriften,
+zusammengefügte Absätze, Befehle und Tabellenausgaben in Codeblöcken, Listen, und vor jeder Seite
+eine Marke mit PDF- und Buchseite (Anker `#s27` springt zur PDF-Seite 27). Die Datei entsteht mit
+`ruby tools/handbuch_md.rb` aus der `.txt`; die Umsetzung ist heuristisch, die OCR-Fehler bleiben,
+und im Zweifel gilt der Scan.
+
 `demo/handbuch/` enthält die Beispiele aus dem Lehrbuch mit ihren Tabellen, ein
 Unterordner je Kapitel. `beispiele.txt` hält zu jedem Beispiel den Befehl und die
 Ausgabe, wie sie im Buch steht; `test/handbuch_test.rb` führt alles aus und vergleicht
@@ -296,6 +302,7 @@ man/               Man-Pages (troff-Quellen aus den MWC-Archiven)
 demo/              Beispieltabellen; testall.cmds = je ein Beispiel pro Befehl, testall.old = letzter Lauf
 demo/handbuch/     die Beispiele aus dem gedruckten Handbuch, je Kapitel ein Ordner
 doc/handbuch.txt   Text des gedruckten Handbuchs (OCR)
+doc/handbuch.md    derselbe Text als Markdown, erzeugt mit tools/handbuch_md.rb
 test/              Tests
 ```