Projekt

Allgemein

Profil

Index » Historie » Version 10

Martin Kraetke, 19.03.2021 13:07

1 1 Patrick Schulz
h1. Index
2
3 7 Martin Kraetke
h2. Word
4 1 Patrick Schulz
5 7 Martin Kraetke
Es werden vier miteinander kombinierbare Varianten unterstützt, einen Index in Word zu kodieren:
6
7
h3. (1) Word-Indexfunktion
8
9
Natürlich wird die reguläre Word-Indexfunktion unterstützt, Mit dem Schalter @\f@ kann zudem der Indextyp angegeben werden:
10
11
!index.png!
12
13 10 Martin Kraetke
transpect erstellt das Indexverzeichnis aus den Indexeinträgen. Die Funktion _Index einfügen_ im Word-Ribbon _Referenzen_ dient also nur zur Kontrolle. Hier ist aber eine Anleitung, wie man für [[Indexverzeichnis-Typ|Indexeinträge mit Typ ein Index-Verzeichnis erstellen]] kann.
14
15 9 Martin Kraetke
16 7 Martin Kraetke
h3. (2) Auszeichnen des Indexeintrags per Zeichenformat
17
18 8 Martin Kraetke
Indexeinträge können festgelegt werden, indem Wörter oder Wortgruppen mit einem Zeichenformat (Regex: @[a-z]{1,3}_index_mark@) ausgezeichnet werden. Indexeinträge die bereits mit der Word-Indexfunktion kodiert wurden, werden ignoriert.
19 7 Martin Kraetke
20
h3. (3) Konkordanzliste
21
22
Indexeinträge können anhand einer Konkordanzliste automatisch kodiert werden. Dafür muss eine Liste von Indexeinträgen am Ende des Dokuments eingefügt werden. Überall wo im restlichen Dokument Wörter oder Wortgruppen aus dieser Liste gefunden werden, wird automatisch ein Indexeintrag kodiert. Dafür muss ein Indexeintrag mit dem Absatzformat (Regex: @[a-z]{1,3}_index_list@) verwendet werden. Jeder Eintrag muss in einem separaten Absatz stehen. Indexeinträge die bereits mit der Word-Indexfunktion oder via Zeichenformat index kodiert wurden, werden ignoriert.
23
24
h3. (4) Statischer Index
25
26
Sollen nicht automatisch im Text Fundstellen für Einträge im Index gesucht werden, kann man auch einen statischen Index einfügen. Dafür zeichnet man einfach eine Liste mit Indexeinträgen mit dem Format index_static aus. Seitenzahlen in der Form Eintrag 144, 156, 192 werden dann nur mit der Seite verknüpft, d.h. hier muss man selbst dafür Sorge tragen, dass die Seitenreferenz auch richtig ist!
27
28
h3. Index-Überschriften und Index-Position steuern
29
30
Man kann individuelle Index-Überschriften mit einem Absatzformat (Regex: @[a-z]{1,3}_index_heading@) auszeichnen. Der Index wird an der Stelle gerendert,  wo die Überschrift im Dokument steht.
31
32
Bei Konkordanzlisten und statischen Registern muss die Überschrift über dem Index stehen und das Format (Regex: @[a-z]{1,3}_index_heading@) haben. Sonst funktioniert die Zuordnung nicht. Bei Indexen mit einem Typ muss der Typ als Zusatz am Absatzformat stehen, also z.B. @[a-z]{1,3}_index_heading_Tiere@. Wenn keine Index-Überschrift ausgezeichnet ist, wird ein Standardtext eingefügt (z.B. _Index_) und der Index am Ende des Dokuments eingefügt.
33
34
35
h2. Hub
36
37
Es können alle vier Varianten einen Index zu erstellen miteinander kombiniert werden. Im Hub-Format erhalten Indexeinträge im Text ein @remap@-Attribut, was sie einem bestimmten Index zuordnet:
38
39
<pre><code class="xml">
40
<indexterm remap="e" type="Tiere">
41
  <primary>Wolf</primary>
42
  <secondary>Lamm</secondary>
43
</indexterm></code></pre>
44
45
Für jeden Index wird zudem ein @<index>@-Element erzeugt. Entweder steht das an der Stelle, wo die Indexüberschrift gesetzt wurde, oder am Ende. In dem Überschriftenformat kann man am Ende auch den Indextyp anhängen.
46
47
<pre><code class="xml">
48
<index type="Tiere" remap="e">
49
  <title role="tsindexheadingTiere">Tiere</title>
50
</index>
51
</code></pre>
52
53
Bei statischen Indexen wird davon ausgegangen, dass die Überschrift über den Indexeinträgen steht. Über den Formatzusatz kann hier aber auch der Typ des Indexes angegeben werden. Seitenzahlen werden später auf die Seite verlinkt.
54
55
Für statische Indexe wird schon bei der XML-Konvertierung eine passende @.x_ind@-Datei erzeugt. Bei dynamischen Indexen im Text muss diese erst noch über die @index.sh@ erzeugt werden. Siehe dazu weiter unten [[Index#Aufruf-des-Index-Skripts]].
56
57
<pre><code class="xml">
58
<index remap="c" type="Orte">
59
  <title role="tsindexheadingOrte">Ortsregister</title>
60
  <indexdiv>
61
    <title>B</title>
62
    <indexentry>
63
      <primaryie>Bertelé, <xref xlink:href="page-93"/>, <xref xlink:href="page-94"/></primaryie>
64
    </indexentry>
65
    <!-- (…) -->
66
  </indexdiv>
67
</index>
68
</code></pre>
69
70
71
h2. TeX
72
73
h3. Auszeichnung multipler Indexes und deren Überschriften
74
75 1 Patrick Schulz
Wir verwenden das LaTeX-Paket "index":https://mirror.dogado.de/tex-archive/macros/latex/contrib/index/index.pdf für die Rohindexerzeugung, sowie Xindy zum Generieren des fertigen Registers.
76
77 7 Martin Kraetke
h4. Deklaration der Index-Typen
78 1 Patrick Schulz
79
Das Paket erlaubt mehrere Indexe. Diese werden mit dem \(re)newindex-Befehlen deklariert:
80
<pre><code class="text">
81
\newindex{<typ>}{<endung rohindex>}{<endung fertiger index>}{<Überschrift>}
82
</code></pre>
83
Damit der Skriptaufruf später korrekt funktioniert, müssen die beiden Endungen bei *nicht-default-Typen* dem Schema @<typ>_idx@ (Rohindex) bzw. @<typ>_ind@ (fertiger Index) entsprechen.
84
85
Der Default- oder Hauptindex kriegt das Label @default@, dessen ÜS lässt sich wie folgt überdefinieren:
86
<pre><code class="text">
87
\renewindex{default}{idx}{ind}{Personenregister}
88
</code></pre>
89
Die Index-Einträge für diesen Index werden  mit 
90
<pre><code class="text">
91
\index{<Lemma>}
92
</code></pre>
93
deklariert. Ausgegeben wird der Hauptindex wird mit 
94
<pre><code class="text">
95
\printindex
96
</code></pre>
97
98
Angenommen, wir wollen zusätzlich zu diesem noch ein Ortsverzeichnis, dann müssen wir in der Präambel der tex-Datei einen neuen Index-Typ deklarieren:
99
<pre><code class="text">
100
\newindex{o}{o_idx}{o_ind}{Ortsverzeichnis}
101
</code></pre>
102
Die Index-Einträge würden dann mit 
103
<pre><code class="text">
104
\index[o]{<Term>}
105
</code></pre>
106
deklariert, der Index mit 
107
<pre><code class="text">
108
\printindex[o]
109
</code></pre>
110
ausgegeben.
111
112 7 Martin Kraetke
h4. Aufruf des Index-Skripts
113 1 Patrick Schulz
114
Mit dem optionalen Argument kann angegeben werden, welcher Index generiert werden soll. Wird das optionale Argument weggelassen, wird der Hauptindex erzeugt:
115
<pre><code class="text">
116
./index.sh <tex-Dateiname ohne Endung>
117
</code></pre>
118
Der Aufruf mit optionalen Argument erzeugt den Neben-Index, z.B.
119
<pre><code class="text">
120
./index.sh <tex-Dateiname ohne Endung> o
121
</code></pre>
122 4 Patrick Schulz
würde das Ortsverzeichnis aus o.g. Beispiel erzeugen. Das Skript muss also für jeden Index einzeln aufgerufen werden.
123 3 Patrick Schulz
124 7 Martin Kraetke
h3. Generierung des Index
125 5 Patrick Schulz
126 7 Martin Kraetke
h4. Generieung der Indexe durch TeX
127 3 Patrick Schulz
128
Heißt: Indexeinträge sind mittels \index[<typ>]{<Lemma>} in TeX kodiert.
129
130
<pre><code class="xml">
131
lualatex <tex-Dateiname>.tex     %% Initialer TeX-Lauf; einsammeln der ÜSen
132
lualatex <tex-Dateiname>.tex     %% Erzeugen des IHV; seitenzahlen verschieben sich ggf. 
133
lualatex <tex-Dateiname>.tex     %% Zur Sicherheit... 
134
./index.sh <tex-Dateiname>       %% OHNE Endung!
135 1 Patrick Schulz
./index.sh <tex-Dateiname> <typ> %% Zweites, optionales Argument für Index-Typ anders als default, s.u.
136 3 Patrick Schulz
lualatex  <tex-Dateiname>.tex    %% Index wird erstmalig ausgegeben, ÜS wird geschrieben
137
lualatex  <tex-Dateiname>.tex    %% ÜS(en) für Index(e) in IHV gerendert
138
lualatex  <tex-Dateiname>.tex    %% Zur Sicherheit...
139
</code></pre>
140
141 7 Martin Kraetke
h4. Statische Index-Dateien
142 3 Patrick Schulz
143
Heißt: @<basename>.<typ>_ind@ kommt vom Konverter
144
145
Bei statischen Indexes darf die @index.sh@ *nicht aufgerufen* werden, da sonst die *ind-Dateien überschrieben würden! Alle anderen Schritte sind dieselben; @\(re)newindex{}{}{}{}@ muss auch hier verwendet werden. Zum einen für die ÜSen, und zum anderen damit @\printindex[<typ>]@ keine "unknown index type"-Fehler auswirft.