diff options
Diffstat (limited to 'language/hyphenation/dehyph-exptl/INSTALL')
-rw-r--r-- | language/hyphenation/dehyph-exptl/INSTALL | 372 |
1 files changed, 372 insertions, 0 deletions
diff --git a/language/hyphenation/dehyph-exptl/INSTALL b/language/hyphenation/dehyph-exptl/INSTALL new file mode 100644 index 0000000000..df63af6d2c --- /dev/null +++ b/language/hyphenation/dehyph-exptl/INSTALL @@ -0,0 +1,372 @@ +For English installation instructions, see end of this file. + + +************** +** German ** +************** +Es folgen Installationshinweise für die experimentellen +deutschen Trennmuster. Die Installation der Trennmuster für die +traditionelle Rechtschreibung des in der Schweiz gebräuchlichen +Standarddeutschs wird nicht ausdrücklich erwähnt, kann aber +analog erfolgen. TeX benötigt dann jedoch zusätzlichen +Speicherplatz für die Trennmuster. + +Die folgenden Installationswege werden beschrieben: + +1. teilautomatisierte Installation in MiKTeX mit Hilfe der + Paketverwaltung, +2. manuelle Installation in MiKTeX mit graphischer Oberfläche, +3. manuelle Installation in MiKTeX auf der Kommandozeile, +4. manuelle Installation in TeX Live auf der Kommandozeile. + +Nachfolgend ist <datum> jeweils durch die ISO-Notation des +Datums der Trennmusterdateien zu ersetzen (JJJJ-MM-TT). + + +************************************************* +** Teilautomatisierte Installation in MiKTeX ** +** mit Paketverwaltung ** +************************************************* +Das Paket ist zunächst mit der Paketverwaltung +"Browse Packages" zu installieren. Danach ist Schritt C der +manuellen Installation in MiKTeX mit graphischer Oberfläche +zu befolgen (siehe nächster Abschnitt). + + +*************************************** +** Manuelle Installation in MiKTeX ** +** mit graphischer Oberfläche ** +*************************************** +Die Installation der experimentellen Trennmuster erfordert +drei Schritte: + +A. Die Trennmuster- und Wrapperdateien sollten in die + folgenden Verzeichnisse innerhalb eines lokalen + TEXMF-Baums kopiert werden: + + tex\generic\dehyph-exptl\dehyphn-x-<datum>.pat + tex\generic\dehyph-exptl\dehyphn-x-<datum>.tex + tex\generic\dehyph-exptl\dehypht-x-<datum>.pat + tex\generic\dehyph-exptl\dehypht-x-<datum>.tex + + Die verbleibenden Dateien können in das Verzeichnis + + doc\generic\dehyph-exptl\ + + kopiert werden. + + +B. Aktualisieren der File Name Database: + + Programm 'Settings' + --> Reiter 'General' + --> Knopf 'Refresh FNDB' + + +C. Anlegen der Sprachen und Erstellen der Formatdateien: + + Programm 'Settings' + --> Reiter 'Languages' + --> Knopf 'New' + --> Feld 'Language Name' : german-x-<datum> + --> Feld 'Synonyms' : german-x-latest + --> Feld 'Hyphenation File' : <texmfbaum>\tex\generic\dehyph-exptl\dehypht-x-<datum>.tex + --> Box 'Load the hyphenation file' : aktiv + --> Knopf 'OK' + --> Knopf 'New' + --> Feld 'Language Name' : ngerman-x-<datum> + --> Feld 'Synonyms' : ngerman-x-latest + --> Feld 'Hyphenation File' : <texmfbaum>\tex\generic\dehyph-exptl\dehyphn-x-<datum>.tex + --> Box 'Load the hyphenation file' : aktiv + --> Knopf 'OK' + Vorhandene Synonyme [n]german-x-latest anderer Sprachen + sind gegebenenfalls zu entfernen. + --> Knopf 'Ok' + --> Meldung 'To apply the new settings, it is necessary to rebuild the format files.' + --> Knopf 'OK' + + Wenn der letzte Schritt mit der Meldung + + >TeX capacity exceeded, sorry [pattern memory=XXX] + + oder + + >TEX capacity exceeded, sorry [pattern memory ops=XXX] + + fehlschlägt, so müssen Sie andere Sprachen deaktivieren + oder die Parameter trie_size und trie_op_size anpassen. + Bitte lesen Sie dazu die Dokumentation Ihrer + TeX-Verteilung oder fragen Sie jemanden, der das Problem + lösen kann. + + +*************************************** +** Manuelle Installation in MiKTeX ** +** auf der Kommandozeile ** +*************************************** +Achtung: Die manuelle Installation in MiKTeX wird nicht +empfohlen, da die Datei language.dat in der Regel automatisch +verwaltet wird, hier jedoch von Hand Änderungen vorgenommen +werden. Es kann daher bei späteren (unabhängigen) Updates zu +Problemen kommen! + +Die manuelle Installation der experimentellen Trennmuster +erfordert vier Schritte: + +A. siehe Schritt A im Abschnitt "Manuelle Installation in + MiKTeX mit graphischer Oberfläche". + + +B. Anlegen der Sprachen: + + 1. Ermitteln des Pfades der Datei language.dat: + + >findtexmf language.dat + + Falls das Ergebnis des obigen Kommandos ein Pfad zu einem + lokalen TEXMF-Baum ist, existiert bereits eine lokale + Kopie der Datei language.dat. Springe zu Punkt B.3. + + 2. Eine lokale Kopie von language.dat existiert bisher nicht. + Kopiere die Datei aus dem in Schritt B.1 erhaltenen Pfad + in einen lokalen TEXMF-Baum, zum Beispiel nach + + C:\Dokumente und Einstellungen\All Users\Anwendungsdaten\MiKTeX\2.7\tex\generic\config\language.dat + + 3. Öffne die Datei language.dat aus dem lokalen TEXMF-Baum in + einem Editor. + + 4. Falls vorhanden, entferne Zeilen + + =german-x-latest + =ngerman-x-latest + + 5. Füge am Ende der Datei die folgenden Zeilen hinzu: + + german-x-<datum> dehypht-x-<datum>.tex + =german-x-latest + ngerman-x-<datum> dehyphn-x-<datum>.tex + =ngerman-x-latest + + 6. Datei language.dat speichern und schließen. + + +C. Aktualisieren der File Name Database: + + Kommando + + >initexmf --update-fndb + + aufrufen. + + +D. Anlegen der Formatdateien: + + Kommando + + >initexmf --dump + + aufrufen. + + Wenn dieses Kommando mit der Meldung + + >TeX capacity exceeded, sorry [pattern memory=XXX] + + oder + + >TEX capacity exceeded, sorry [pattern memory ops=XXX] + + fehlschlägt, so müssen Sie andere Sprachen in der Datei + language.dat deaktivieren oder die Parameter trie_size + und trie_op_size anpassen. Bitte lesen Sie dazu die + Dokumentation Ihrer TeX-Verteilung oder fragen Sie + jemanden, der das Problem lösen kann. + + +***************************************** +** Manuelle Installation in TeX Live ** +** auf der Kommandozeile ** +***************************************** +Achtung: Die manuelle Installation in TeX Live wird nicht +empfohlen, da die Datei language.dat in der Regel automatisch +verwaltet wird, hier jedoch von Hand Änderungen vorgenommen +werden. Es kann daher bei späteren (unabhängigen) Updates zu +Problemen kommen! + +In TeX Live ist dieses Paket bereits vorinstalliert und +ohne weitere Vorkehrungen nutzbar. + +Die Installation der experimentellen Trennmuster erfordert +vier Schritte: + +A. Die Trennmuster- und Wrapperdateien sollten in die + folgenden Verzeichnisse innerhalb eines lokalen + TEXMF-Baums kopiert werden: + + tex/generic/dehyph-exptl/dehyphn-x-<datum>.pat + tex/generic/dehyph-exptl/dehyphn-x-<datum>.tex + tex/generic/dehyph-exptl/dehypht-x-<datum>.pat + tex/generic/dehyph-exptl/dehypht-x-<datum>.tex + + Die verbleibenden Dateien können in das Verzeichnis + + doc/generic/dehyph-exptl/ + + kopiert werden. + + +B. Anlegen der Sprachen: + + 1. Ermitteln des Pfades der Datei language.dat: + + >kpsewhich language.dat + + Falls das Ergebnis des obigen Kommandos ein Pfad zu einem + lokalen TEXMF-Baum ist, existiert bereits eine lokale + Kopie der Datei language.dat. Springe zu Punkt B.3. + + 2. Eine lokale Kopie von language.dat existiert bisher nicht. + Kopiere die Datei aus dem in Schritt B.1 erhaltenen Pfad + in einen lokalen TEXMF-Baum, zum Beispiel nach + + <TeXLiveWurzel>/texmf-local/tex/generic/config/language.dat + + 3. Öffne die Datei language.dat aus dem lokalen TEXMF-Baum in + einem Editor. + + 4. Falls vorhanden, entferne Zeilen + + =german-x-latest + =ngerman-x-latest + + 5. Füge am Ende der Datei die folgenden Zeilen hinzu: + + german-x-<datum> dehypht-x-<datum>.tex + =german-x-latest + ngerman-x-<datum> dehyphn-x-<datum>.tex + =ngerman-x-latest + + 6. Datei language.dat speichern und schließen. + + +C. Aktualisieren der File Name Database: + + Kommando + + >mktexlsr + + aufrufen. + + +D. Anlegen der Formatdateien: + + Kommando + + >fmtutil --refresh + + aufrufen. + + Wenn dieses Kommando mit der Meldung + + >TeX capacity exceeded, sorry [pattern memory=XXX] + + oder + + >TEX capacity exceeded, sorry [pattern memory ops=XXX] + + fehlschlägt, so müssen Sie andere Sprachen in der Datei + language.dat deaktivieren oder die Parameter trie_size + und trie_op_size in der Datei texmf.cnf anpassen. Bitte + lesen Sie dazu die Dokumentation Ihrer TeX-Verteilung oder + fragen Sie jemanden, der das Problem lösen kann. + + +****************************************************** +** English installation instructions for TeX Live ** +****************************************************** +The following installation instructions don't mention +hyphenation patterns for traditional orthography of Standard +German as used in Switzerland explicitly. However, +installation is analogous to the discussed patterns. Be +warned, that installing all patterns might cause memory +problems for TeX. + +Note, in the remaining text <date> refers to the pattern file +date in ISO notation (YYYY-MM-DD)! + +Installation of the dehyph-exptl package requires four steps: + +A. Copy pattern and wrapper files to the following location + within a local texmf tree: + + tex/generic/dehyph-exptl/dehyphn-x-<date>.pat + tex/generic/dehyph-exptl/dehyphn-x-<date>.tex + tex/generic/dehyph-exptl/dehypht-x-<date>.pat + tex/generic/dehyph-exptl/dehypht-x-<date>.tex + + The remaining files can be copied to + + doc/generic/dehyph-exptl/ + + +B. Modify file language.dat: + + 1. Determine the location of language.dat: + + >kpsewhich language.dat + + If the resulting path already points to a local tree, + jump right to step B.3. + + 2. A local copy of language.dat doesn't exist, yet. Copy the + file that was output in step B.1 to a local texmf tree, + e.g., + + <TeXLiveRoot>/texmf-local/tex/generic/config/language.dat + + 3. Open language.dat from the local texmf tree into an + editor. + + 4. If existent, remove the following lines + + =german-x-latest + =ngerman-x-latest + + 5. Add the following lines to the end of language.dat: + + german-x-<date> dehypht-x-<date>.tex + =german-x-latest + ngerman-x-<date> dehyphn-x-<date>.tex + =ngerman-x-latest + + 6. Save file language.dat and close the editor. + + +C. Refresh file name database: + + Execute command + + >mktexlsr + + +D. Rebuild format files: + + Execute command + + >fmtutil --refresh + + In case this command fails with error message + + >TeX capacity exceeded, sorry [pattern memory=XXX] + + or + + >TEX capacity exceeded, sorry [pattern memory ops=XXX] + + some languages have to be deactivated in language.dat or + parameters trie_size and trie_op_size have to be enlarged + (probably in file texmf.cnf). Please refer to the + documentation of your TeX distribution or ask a TeX wizard. + + +END. |