dehyph-exptl/INSTALL

   1 For English installation instructions, see end of this file.
   2
   3
   4 **************
   5 **  German  **
   6 **************
   7 Es folgen Installationshinweise für die experimentellen
   8 deutschen Trennmuster.  Die Installation der Trennmuster für die
   9 traditionelle Rechtschreibung des in der Schweiz gebräuchlichen
  10 Standarddeutschs wird nicht ausdrücklich erwähnt, kann aber
  11 analog erfolgen.  TeX benötigt dann jedoch zusätzlichen
  12 Speicherplatz für die Trennmuster.
  13
  14 Die folgenden Installationswege werden beschrieben:
  15
  16 1. teilautomatisierte Installation in MiKTeX mit Hilfe der
  17     Paketverwaltung,
  18 2. manuelle Installation in MiKTeX mit graphischer Oberfläche,
  19 3. manuelle Installation in MiKTeX auf der Kommandozeile,
  20 4. manuelle Installation in TeX Live auf der Kommandozeile.
  21
  22 Nachfolgend ist <datum> jeweils durch die ISO-Notation des
  23 Datums der Trennmusterdateien zu ersetzen (JJJJ-MM-TT).
  24
  25
  26 *************************************************
  27 **  Teilautomatisierte Installation in MiKTeX  **
  28 **  mit Paketverwaltung                        **
  29 *************************************************
  30 Das Paket ist zunächst mit der Paketverwaltung
  31 "Browse Packages" zu installieren.  Danach ist Schritt C der
  32 manuellen Installation in MiKTeX mit graphischer Oberfläche
  33 zu befolgen (siehe nächster Abschnitt).
  34
  35
  36 ***************************************
  37 **  Manuelle Installation in MiKTeX  **
  38 **  mit graphischer Oberfläche       **
  39 ***************************************
  40 Die Installation der experimentellen Trennmuster erfordert
  41 drei Schritte:
  42
  43 A. Die Trennmuster- und Wrapperdateien sollten in die
  44    folgenden Verzeichnisse innerhalb eines lokalen
  45    TEXMF-Baums kopiert werden:
  46
  47       tex\generic\dehyph-exptl\dehyphn-x-<datum>.pat
  48       tex\generic\dehyph-exptl\dehyphn-x-<datum>.tex
  49       tex\generic\dehyph-exptl\dehypht-x-<datum>.pat
  50       tex\generic\dehyph-exptl\dehypht-x-<datum>.tex
  51
  52   Die verbleibenden Dateien können in das Verzeichnis
  53
  54       doc\generic\dehyph-exptl\
  55
  56   kopiert werden.
  57
  58
  59 B. Aktualisieren der File Name Database:
  60
  61     Programm 'Settings'
  62       -->  Reiter 'General'
  63         -->  Knopf 'Refresh FNDB'
  64
  65
  66 C. Anlegen der Sprachen und Erstellen der Formatdateien:
  67
  68     Programm 'Settings'
  69       -->  Reiter 'Languages'
  70         -->  Knopf 'New'
  71           -->  Feld 'Language Name' : german-x-<datum>
  72           -->  Feld 'Synonyms' : german-x-latest
  73           -->  Feld 'Hyphenation File' : <texmfbaum>\tex\generic\dehyph-exptl\dehypht-x-<datum>.tex
  74           -->  Box 'Load the hyphenation file' : aktiv
  75           -->  Knopf 'OK'
  76         -->  Knopf 'New'
  77           -->  Feld 'Language Name' : ngerman-x-<datum>
  78           -->  Feld 'Synonyms' : ngerman-x-latest
  79           -->  Feld 'Hyphenation File' : <texmfbaum>\tex\generic\dehyph-exptl\dehyphn-x-<datum>.tex
  80           -->  Box 'Load the hyphenation file' : aktiv
  81           -->  Knopf 'OK'
  82         Vorhandene Synonyme [n]german-x-latest anderer Sprachen
  83           sind gegebenenfalls zu entfernen.
  84         -->  Knopf 'Ok'
  85       -->  Meldung 'To apply the new settings, it is necessary to rebuild the format files.'
  86         -->  Knopf 'OK'
  87
  88      Wenn der letzte Schritt mit der Meldung
  89
  90        >TeX capacity exceeded, sorry [pattern memory=XXX]
  91
  92      oder
  93
  94        >TEX capacity exceeded, sorry [pattern memory ops=XXX]
  95
  96      fehlschlägt, so müssen Sie andere Sprachen deaktivieren
  97      oder die Parameter trie_size und trie_op_size anpassen.
  98      Bitte lesen Sie dazu die Dokumentation Ihrer
  99      TeX-Verteilung oder fragen Sie jemanden, der das Problem
 100      lösen kann.
 101
 102
 103 ***************************************
 104 **  Manuelle Installation in MiKTeX  **
 105 **  auf der Kommandozeile            **
 106 ***************************************
 107 Achtung: Die manuelle Installation in MiKTeX wird nicht
 108 empfohlen, da die Datei language.dat in der Regel automatisch
 109 verwaltet wird, hier jedoch von Hand Änderungen vorgenommen
 110 werden.  Es kann daher bei späteren (unabhängigen) Updates zu
 111 Problemen kommen!
 112
 113 Die manuelle Installation der experimentellen Trennmuster
 114 erfordert vier Schritte:
 115
 116 A. siehe Schritt A im Abschnitt "Manuelle Installation in
 117    MiKTeX mit graphischer Oberfläche".
 118
 119
 120 B. Anlegen der Sprachen:
 121
 122   1. Ermitteln des Pfades der Datei language.dat:
 123
 124       >findtexmf language.dat
 125
 126      Falls das Ergebnis des obigen Kommandos ein Pfad zu einem
 127      lokalen TEXMF-Baum ist, existiert bereits eine lokale
 128      Kopie der Datei language.dat.  Springe zu Punkt B.3.
 129
 130   2. Eine lokale Kopie von language.dat existiert bisher nicht.
 131      Kopiere die Datei aus dem in Schritt B.1 erhaltenen Pfad
 132      in einen lokalen TEXMF-Baum, zum Beispiel nach
 133
 134        C:\Dokumente und Einstellungen\All Users\Anwendungsdaten\MiKTeX\2.7\tex\generic\config\language.dat
 135
 136   3. Öffne die Datei language.dat aus dem lokalen TEXMF-Baum in
 137      einem Editor.
 138
 139   4. Falls vorhanden, entferne Zeilen
 140
 141   =german-x-latest
 142   =ngerman-x-latest
 143
 144   5. Füge am Ende der Datei die folgenden Zeilen hinzu:
 145
 146   german-x-<datum> dehypht-x-<datum>.tex
 147   =german-x-latest
 148   ngerman-x-<datum> dehyphn-x-<datum>.tex
 149   =ngerman-x-latest
 150
 151   6. Datei language.dat speichern und schließen.
 152
 153
 154 C. Aktualisieren der File Name Database:
 155
 156     Kommando
 157
 158       >initexmf --update-fndb
 159
 160     aufrufen.
 161
 162
 163 D. Anlegen der Formatdateien:
 164
 165     Kommando
 166
 167       >initexmf --dump
 168
 169     aufrufen.
 170
 171     Wenn dieses Kommando mit der Meldung
 172
 173       >TeX capacity exceeded, sorry [pattern memory=XXX]
 174
 175     oder
 176
 177       >TEX capacity exceeded, sorry [pattern memory ops=XXX]
 178
 179     fehlschlägt, so müssen Sie andere Sprachen in der Datei
 180     language.dat deaktivieren oder die Parameter trie_size
 181     und trie_op_size anpassen.  Bitte lesen Sie dazu die
 182     Dokumentation Ihrer TeX-Verteilung oder fragen Sie
 183     jemanden, der das Problem lösen kann.
 184
 185
 186 *****************************************
 187 **  Manuelle Installation in TeX Live  **
 188 **  auf der Kommandozeile              **
 189 *****************************************
 190 Achtung: Die manuelle Installation in TeX Live wird nicht
 191 empfohlen, da die Datei language.dat in der Regel automatisch
 192 verwaltet wird, hier jedoch von Hand Änderungen vorgenommen
 193 werden.  Es kann daher bei späteren (unabhängigen) Updates zu
 194 Problemen kommen!
 195
 196 In TeX Live ist dieses Paket bereits vorinstalliert und
 197 ohne weitere Vorkehrungen nutzbar.
 198
 199 Die Installation der experimentellen Trennmuster erfordert
 200 vier Schritte:
 201
 202 A. Die Trennmuster- und Wrapperdateien sollten in die
 203    folgenden Verzeichnisse innerhalb eines lokalen
 204    TEXMF-Baums kopiert werden:
 205
 206       tex/generic/dehyph-exptl/dehyphn-x-<datum>.pat
 207       tex/generic/dehyph-exptl/dehyphn-x-<datum>.tex
 208       tex/generic/dehyph-exptl/dehypht-x-<datum>.pat
 209       tex/generic/dehyph-exptl/dehypht-x-<datum>.tex
 210
 211   Die verbleibenden Dateien können in das Verzeichnis
 212
 213       doc/generic/dehyph-exptl/
 214
 215   kopiert werden.
 216
 217
 218 B. Anlegen der Sprachen:
 219
 220   1. Ermitteln des Pfades der Datei language.dat:
 221
 222       >kpsewhich language.dat
 223
 224      Falls das Ergebnis des obigen Kommandos ein Pfad zu einem
 225      lokalen TEXMF-Baum ist, existiert bereits eine lokale
 226      Kopie der Datei language.dat.  Springe zu Punkt B.3.
 227
 228   2. Eine lokale Kopie von language.dat existiert bisher nicht.
 229      Kopiere die Datei aus dem in Schritt B.1 erhaltenen Pfad
 230      in einen lokalen TEXMF-Baum, zum Beispiel nach
 231
 232        <TeXLiveWurzel>/texmf-local/tex/generic/config/language.dat
 233
 234   3. Öffne die Datei language.dat aus dem lokalen TEXMF-Baum in
 235      einem Editor.
 236
 237   4. Falls vorhanden, entferne Zeilen
 238
 239   =german-x-latest
 240   =ngerman-x-latest
 241
 242   5. Füge am Ende der Datei die folgenden Zeilen hinzu:
 243
 244   german-x-<datum> dehypht-x-<datum>.tex
 245   =german-x-latest
 246   ngerman-x-<datum> dehyphn-x-<datum>.tex
 247   =ngerman-x-latest
 248
 249   6. Datei language.dat speichern und schließen.
 250
 251
 252 C. Aktualisieren der File Name Database:
 253
 254     Kommando
 255
 256       >mktexlsr
 257
 258     aufrufen.
 259
 260
 261 D. Anlegen der Formatdateien:
 262
 263     Kommando
 264
 265       >fmtutil --refresh
 266
 267     aufrufen.
 268
 269     Wenn dieses Kommando mit der Meldung
 270
 271       >TeX capacity exceeded, sorry [pattern memory=XXX]
 272
 273     oder
 274
 275       >TEX capacity exceeded, sorry [pattern memory ops=XXX]
 276
 277     fehlschlägt, so müssen Sie andere Sprachen in der Datei
 278     language.dat deaktivieren oder die Parameter trie_size
 279     und trie_op_size in der Datei texmf.cnf anpassen.  Bitte
 280     lesen Sie dazu die Dokumentation Ihrer TeX-Verteilung oder
 281     fragen Sie jemanden, der das Problem lösen kann.
 282
 283
 284 ******************************************************
 285 **  English installation instructions for TeX Live  **
 286 ******************************************************
 287 The following installation instructions don't mention
 288 hyphenation patterns for traditional orthography of Standard
 289 German as used in Switzerland explicitly.  However,
 290 installation is analogous to the discussed patterns.  Be
 291 warned, that installing all patterns might cause memory
 292 problems for TeX.
 293
 294 Note, in the remaining text <date> refers to the pattern file
 295 date in ISO notation (YYYY-MM-DD)!
 296
 297 Installation of the dehyph-exptl package requires four steps:
 298
 299 A. Copy pattern and wrapper files to the following location
 300    within a local texmf tree:
 301
 302       tex/generic/dehyph-exptl/dehyphn-x-<date>.pat
 303       tex/generic/dehyph-exptl/dehyphn-x-<date>.tex
 304       tex/generic/dehyph-exptl/dehypht-x-<date>.pat
 305       tex/generic/dehyph-exptl/dehypht-x-<date>.tex
 306
 307    The remaining files can be copied to
 308
 309       doc/generic/dehyph-exptl/
 310
 311
 312 B. Modify file language.dat:
 313
 314   1. Determine the location of language.dat:
 315
 316       >kpsewhich language.dat
 317
 318      If the resulting path already points to a local tree,
 319      jump right to step B.3.
 320
 321   2. A local copy of language.dat doesn't exist, yet.  Copy the
 322      file that was output in step B.1 to a local texmf tree,
 323      e.g.,
 324
 325        <TeXLiveRoot>/texmf-local/tex/generic/config/language.dat
 326
 327   3. Open language.dat from the local texmf tree into an
 328      editor.
 329
 330   4. If existent, remove the following lines
 331
 332   =german-x-latest
 333   =ngerman-x-latest
 334
 335   5. Add the following lines to the end of language.dat:
 336
 337   german-x-<date> dehypht-x-<date>.tex
 338   =german-x-latest
 339   ngerman-x-<date> dehyphn-x-<date>.tex
 340   =ngerman-x-latest
 341
 342   6. Save file language.dat and close the editor.
 343
 344
 345 C. Refresh file name database:
 346
 347     Execute command
 348
 349       >mktexlsr
 350
 351
 352 D. Rebuild format files:
 353
 354     Execute command
 355
 356       >fmtutil --refresh
 357
 358     In case this command fails with error message
 359
 360       >TeX capacity exceeded, sorry [pattern memory=XXX]
 361
 362     or
 363
 364       >TEX capacity exceeded, sorry [pattern memory ops=XXX]
 365
 366     some languages have to be deactivated in language.dat or
 367     parameters trie_size and trie_op_size have to be enlarged
 368     (probably in file texmf.cnf).  Please refer to the
 369     documentation of your TeX distribution or ask a TeX wizard.
 370
 371
 372 END.