Handbuch zum Programm "Writing without umlauts" v1.140, zu Deutsch "Schreiben ohne Umlaute"
Copyright by	Hilfe & Service von EDV-Fachleuten 
Dipl.-Phys Harald Schrfer	Tel.	(0345) 521 13 40
Reilstr. 22 (Eingang Mozartstr.)	Funk	(0177) 521 13 40
	EM	Vertrieb@HuSvEDVF.de 
D-06114 Halle (Saale)	Fax	(0345) 521 13 41
Edit v1.100 from 2022-08-23 to 2024-05-02 by Harald Schrfer
Nutzen: 
  Abb. 01: Logo vonWwu.
Erspart die Zeit fr das x malige Suchen und Ersetzen der deutschen Umlaute und anderer Sonderzeichen in reinen Texten durch ihre Umschreibung, weil diese auf einigen Systemen nicht darstellbar sind und als schwarze Rechtecke dargestellt "?"werden.






Inhaltsverzeichnis
1.	Bestandteile	2
2.	Systemvoraussetzungen	2
3.	Installation	2
4.	Benutzung	3
4.1	Syntax	5
4.2	Beispiele	6
9.	Anhang	7
9.1	Abkrzungen	7
9.2	Zeichenvorrat	7

1.	Bestandteile
Das Basic-Programm besteht aus folgenden 8 Komponenten.
Change.LOG	Die Liste der Versionsnummer und deren nderungen am Programm in chronologischer Reihenfolge.
Lizenz.TXT	Lizenzbestimmungen mit Gewhrleistungsbeschrnkung, Nutzungsrecht und Vertrieb zum Programm "Wwu.EXE".
UmlOhne.TXT	Text ohne deutsche Umlaute, dafr mit umschriebenen deutsche Umlauten "AEaeOEoeUEuesz", wird geschrieben.
UmlMit.TXT	Text mit optionalen deutsche Umlauten "", wird gelesen.
Wwu.exe	Das ausfhrbare Programm selbst, mit seinen 11 Ersetzungen inklusive der 4 gestrichenen Hochkommata.
Wwu.pdf	Dieses Handbuch als PDF.
Wwu.TXT	Dieses Handbuch im reinen Text-Format.
Wwu-B.exe	Das Basic   Programm ersetzt NUR die 7 deutschen Umlaute!
Das komplette Programm besteht zustzlich aus folgender 1er Komponente, die ins vorhandenen Verzeichnis der Basic-Version hinein kopiert werden kann.
Wwu.exe	Das komplette Programm ohne Einschrnkungen ersetzt alle Umlaute die in der Dokumentation genannt werden!
2.	Systemvoraussetzungen 
Das Programm wurde erfolgreich Ausfhrung und Nutzung getestet unter 
-	Windows 7 Prof., Hauptspeicher 6GByte.
-	Windows 10 Prof., Hauptspeicher 4GByte.
3.	Installation
Eine Installation mittels einem "Installer" ist nicht notwendig, das Programm ist portabel, d.h. es kann theoretisch von berall aus gestartet werden. 
Fr die Ablage  wrden wir das Verzeichnis "C:\Portable\Wwu" verschlagen und in weiterem Vorgehen auch annehmen.
Fr die Installation gengt es die Wwu.ZIP in das Verzeichnis "Laufwerk:\Portable\Wwu" zu auszupacken. 
Zustzlich muss man beachten dass der Benutzer entsprechende Dateisystemrechte braucht, um die eigentliche Arbeit auszufhren (ndern von Dateien und Verzeichnissen).
4.	Benutzung
Das Programm erwartet in seinem Programmverzeichnis
-	eine Datei UmlMit.TXT mit einem Text in dem deutsche Umlaute vorhanden sind;
-	eine Datei UmlOhne.TXT die berschrieben wird und in der nach der Ausfhrung des Programms der Text aus UmlMit.TXT ohne deutschen Umlaute, sondern mit deren umschriebenen Zeichen vorhanden ist.
Oder
-	bei Vorgabe eines Verzeichnisses, zum Beispiel C:\Tmp, werden alle darin vorhanden Textdateien eine Sicherungskaskade durchlaufen (*.TXT  > *.BAK  > *.TMP);
-	in allen Textdateien im Verzeichnis wird dabei die Ersetzung der deutschen Umlaute automatisch vollzogen.
Was wird durch welche Umschreibung bzw. Ersatz ersetzt?
-	In der Basic-Ausfhrung "Wwu-B.EXE" werden nur 
die 7 deutschen Umlaute (, , , , , , ) zu (ae, oe, ue, sz, AE, OE, UE)
verarbeitet, Hilfe und Informationen ber das Programm angeboten!
-	In der Standard-Ausfhrung "Wwu.EXE" werden die 7 deutschen Umlaute plus
-	einfache nach rechts (`) und links () gestrichene Hochkommata durch einfaches Hochkommata (');
-	doppelte hoch (") und tief (") gestellte Hochkommata durch einfaches Hockkommata (");
-	kleine doppelte spitze Klammern nach rechts (") und links (") zeigend durch viel grer bzw. kleiner (>>, <<) und 
-	"" durch "Euro"
ersetzt!
Zustzlich kann mit dem Parameter /e die Umschreibung mit HTML Entities erfolgen. Siehe Anhang "Zeichenvorrat".
Umkehrbar
Generell ist die Umkehrbarkeit von allen HTML-Enties gegeben, da diese eindeutig sind!

Dadurch die eineindeutige Ersetzung diese 7 Zeichen ist die Mglichkeit gegeben die Ersetzung rckgngig zu machen!
   <-> AE;
   <-> ae;
   <-> OE;
   <-> oe;
   <-> UE;
   <-> ue und
   <-> sz.
Euro-Zeichen
Steht das Wort "Euro" mit folgenden Leerzeichen, sozusagen alleine da, kann es durch die Suche nach "Euro " gegen " " zurck getauscht werden.
NUR bedingt Umkehrbar
Hochkommata
Nach Links oder Rechts gestrichene einfache bzw. doppelte Hochkommata wird durch die senkrechte Variante ersetzt: 
- Einfach Links und `Rechts gestrichenes Hochkommata <-> 'Senkrecht
- Doppelt "Links und "Rechts gestrichenes Hochkommata <-> "Senkrecht
Wird im originalen gesamten Text nur Links und Rechts gestrichenes Hochkommata eingesetzt  (Kein Senkrechtes) und ist vor dem links und nach dem rechts gestrichenen Hochkommata ein Leerzeichen, so ist die Umkehrung mglich. Analog bei doppelt gestrichenen Hochkommata.
Angewinkelte Anfhrungszeichen rechts/links
Angewinkelte Anfhrungszeichen rechts (")/links (") zur Eingrenzung von Wrtern und oder Textteilen im Internet
- Angewinkelte Anfhrungszeichen rechts (")/links (") -> ... rechts (>>)/links(<<).
Wird im originalen gesamten Text nur diese Verwendet und keine "sehr klein" und "sehr gro" und ist vor dem "angewinkelte Anfhrungszeichen rechts" und nach dem "angewinkelte Anfhrungszeichen links" ein Leerzeichen, so ist die Umkehrung mglich.
Generelle Vorgehensweise
Einzelne Datei
	1.	Text mit deutschen Umlauten aus der zu bearbeitenden Datei kopieren;
	2.	UmlMit.TXT 
	1.	Die Datei ffnen;
	2.	Den Text mit deutschen Umlauten in die Datei einfgen;
	3.	Die Datei speichern und 
	4.	die Datei schlieen.
	3.	Wwu.EXE mit oder ohne Parameter aufrufen! Optimal hat sich der Aufruf mit einer Verknpfung unter Windows herausgestellt, da diese die Parameter fr einen zweiten Aufruf speichern kann und damit behlt.
	4.	UmlOhne.TXT
	1.	Die Datei ffnen;
	2.	Inhalt kontrollieren und kopieren;
	3.	Die Datei schlieen.
	5.	Den kopierten Text dort einfgen, wo er gebraucht wird!
Fertig.
Dateien eines Verzeichnisses
	1.	Ein Verzeichnis "Tmp" auf dem Laufwerk C: erstellen, falls es noch nicht vorhanden ist!  > C:\Tmp
	2.	Den vorherigen Inhalt in ein Unterverzeichnis von C:\Tmp verschieben. Zum Beispiel "01".  > C:\Tmp\01
	3.	Die Textdateien die durch das Programm "Wwu" bearbeitet werden sollen, in das Verzeichnis "C:\Tmp" kopieren.
	4.	Aufruf des Programms mit 
Wwu.exe /a /d:C:\Tmp 
Oder mittels Verknpfung wie bei "Einzelner Datei" unter 3.
	5.	Ergebnis kontrollieren und wen OK, dann die Dateien zurck kopieren.
4.1	Syntax
Achtung, bei der Auswertung der Parameter wird die Grosz- und Kleinschreibung beachtet! Die Benutzung des Programms ermglicht dieses mit bergabeparameter zu steuern. Diese knnen per Stapelverarbeitungsdatei oder per Link bergegeben werden. Die evtl. vor Ort noch einmal bearbeitet werden mssen.
Wwu.exe [/a] [d:Laufwerk:\Verzeichnis] [/e] [/h] [/i] 
Zeichenvorrat
Hier werden dargestellt, welche Zeichen, je nach Parameter, knnen durch welches andere Zeichen ersetzt werden.
Parameter
	Ohne Parameter werden:
-	 durch AE, 
-	 durch ae, 
-	 durch OE, 
-	 durch oe, 
-	 durch UE, 
-	 durch ue und 
-	 durch sz ersetzt.
/a	Zustzlich noch die gestrichenen Hochkommata ersetzt. Das ist 
-	einfach Links und `Rechts gestrichenes Hochkommata durch 'Senkrecht;
-	doppelt "Links und "Rechts gestrichenes Hochkommata durch "Senkrecht;
-	kleine doppelte spitze Klammern von Links (") und von Rechts (") durch doppelte kleiner bzw. grer Zeichen (>> bzw. <<) und
-	angewinkelte Anfhrungszeichen nach rechts """/ links """.
-	Mit %C3 den erweiterten Zeichensatz (ä, ü, ...) fr die 7 dt. Sonderzeichen mit integrieren. 
-	Das Euro-Zeichen als "Euro" ausgeschrieben.
/d:Laufwerk:\Verzeichnis wie Directory, zu Deutsch: Verzeichnis.
Anweisung an das Programm alle im "Laufwerk:/Verzeichnis" darin liegenden Textdateien in BAK-Dateien umzubenennen, dabei deren Inhalt nach Vorgabe zu bearbeiten und wieder in die Textdatei zurck zu speichern. Achtung: Sicherheitskopie vorab anfertigen oder nur Kopien verwenden!
/e	wie Entities aus der HTML- und Internet-Welt. Dabei wird: 
-	"" durch "&Auml;", 
-	"" durch "&auml;", 
-	"" durch "&Ouml;", 
-	"" durch "&ouml;", 
-	"" durch "&Uuml;", 
-	"" durch "&uuml;" und 
-	"" durch "&szlig;" ersetzt.
-	Das Euro-Zeichen als "&euro;" geschrieben.
/h	wie Hilfe.
Aufruf der Hilfe. Alle anderen Parameter werden ignoriert.
/i	wie Information.
Ausgabe der Information ber das Programm, vor der eigentlichen Arbeit des Programms.
4.2	Beispiele
1. Test "Deutsche Umlaute"
Es sollen alle deutschen Umlaute, Gro- und Kleinschreibung inklusive, durch Umschreibungen ersetzt werden.
	1.	UmlMit.TXT mit dem folgenden Text fllen:
"" -> AE
"" -> ae
"" -> OE
"" -> oe
"" -> UE
"" -> ue
"" -> sz wie in He

Nach Links oder Rechts gestrichene einfache bzw. doppelte Hochkommata:
- Einfach Links und `Rechts gestrichens Zeichen durch 'Senkrecht
- Doppelt "timedate.cpl" -> "timedate.cpl"
- doppelte spitze "Klammern" -> >>Klammern<<.

	2.	Aufruf von Wwu.exe!
	3.	Ergebnis in UmlOhne.TXT erhalten.
"AE" -> AE
"ae" -> ae
"OE" -> OE
"oe" -> oe
"UE" -> UE
"ue" -> ue
"sz" -> sz wie in Hesz

Nach Links oder Rechts gestrichene einfache bzw. doppelte Hochkommata:
- Einfach Links und `Rechts gestrichens Zeichen durch 'Senkrecht
- Doppelt "timedate.cpl" -> "timedate.cpl"
- doppelte spitze "Klammern" -> >>Klammern<<.
  Abb. 01: Aufruf Wwu.EXE ber eine Verknpfung mit den Parameter /a fr alle 15 Sonderzeichen.
2. Test "15 Sonderzeichen"
Es sollen alle bekannten 13 Sonderzeichen durch deren Umschreibungen ersetzt werden.
	1.	UmlMit.TXT wieder mit dem Text aus dem 1. Test fllen.
	2.	Aufruf von "Wwu.exe /a" per Stapeldatei oder als Verknpfung.
	3.	Ergebnis in UmlOhne.TXT erhalten.
"AE" -> AE
"ae" -> ae
"OE" -> OE
"oe" -> oe
"UE" -> UE
"ue" -> ue
"sz" -> sz wie in Hesz

Nach Links oder Rechts gestrichene einfache bzw. doppelte Hochkommata:
- Einfach 'Links und 'Rechts gestrichenes Zeichen durch 'Senkrecht
- Doppelt "timedate.cpl" -> "timedate.cpl"
- doppelte spitze >>Klammern<< -> >>Klammern<<.



9.	Anhang
9.1	Abkrzungen
*.MD	Endung einer Markdown - Datei.
HTML	Hypertext Markup Language
9.2	Zeichenvorrat
 Besonderes Augenmerk ist auf 
-	das doppelt Hochkommata, was nicht verndert wird, und
-	die Winkel grer und kleiner, mit Leerzeichen davor und danach, 
zu richten.
****** EOF ****************************************************
