summaryrefslogtreecommitdiffstats
path: root/tde-i18n-de/docs/tdeaddons/kate-plugins/xmltools.docbook
blob: 7628c6f0112486dd76620d5b7c0d4a4a2e448025 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
<chapter id="xmltools">
<chapterinfo>

<title
>&XML;-Vervollständigung</title>

<authorgroup>
<author
><firstname
>Daniel</firstname
> <surname
>Naber</surname
> <affiliation
> <address
>&Daniel.Naber.mail;</address>
</affiliation>
</author>
</authorgroup
> <date
>17.05.2006</date
> <releaseinfo
>3.5.2</releaseinfo
> <abstract
> <para
>Dieses Modul unterstützt die Erstellung von &XML;-Dateien, indem es erlaubte Marken anzeigt und einige zusätzliche Informationen liefert.</para>

</abstract>
<keywordset>
<keyword
>KDE</keyword>
<keyword
>kate</keyword>
<keyword
>xml</keyword>
</keywordset>
</chapterinfo>

<title
>Einleitung</title>

<para
>Dieses Modul gibt Hinweise, was an einer bestimmten Stelle einer &XML;-Datei gemäß der zugehörigen DTD erlaubt ist. Es zeigt, abhängig von der Cursorposition, mögliche Elemente, Attribute, Attributwerte oder Entitäten an (&eg; werden alle Entitäten angezeigt, wenn das Zeichen links vom Cursor <quote
>&amp;</quote
> ist). Es ist außerdem möglich, die nächste linksseitige nicht-geschlossene Marke zu schließen.</para>

<para
>Die <acronym
>DTD</acronym
> muss im &XML;-Format vorliegen, wie es das Perl-Programm <command
>dtdparse</command
> liefert. Eine DTD mit diesem Format wird als <quote
>Meta-DTD</quote
> bezeichnet. Einige Meta-DTDs werden mitgeliefert. Sie befinden sich im Ordner <filename class="directory"
>$TDEDIR/share/apps/katexmltools/</filename
>, der auch Standardordner für den Menü-Befehl <guimenuitem
>Meta-DTD zuweisen ...</guimenuitem
> ist. Um eigene Meta-DTDs zu erzeugen, benötigen Sie <command
>dtdparse</command
> von <ulink url="http://dtdparse.sourceforge.net"
>http://dtdparse.sourceforge.net</ulink
>.</para>

<sect1 id="xmltools-how-to-use">
<title
>Anwendung</title>

<para
>Starten Sie &kate; und öffnen Sie den Einrichtungsdialog mit <menuchoice
><guimenu
>Einstellungen</guimenu
> <guimenuitem
>&kate; einrichten ...</guimenuitem
></menuchoice
>. Dann wählen Sie <guilabel
>XML-Vervollständigung</guilabel
> im Abschnitt <guilabel
>Programm</guilabel
> <guilabel
>Erweiterungen</guilabel
>. Danach wählen Sie <menuchoice
><guimenu
>XML</guimenu
><guimenuitem
>Meta-DTD zuweisen ...</guimenuitem
></menuchoice
>. Wenn Ihr Dokument keinen <quote
>DOCTYPE</quote
> enthält oder dieser unbekannt ist, wählen Sie eine Meta-DTD aus Ihrem Dateisystem. Ansonsten wird die passende Meta-DTD für Ihr aktuelles Dokument automatisch geladen.</para>

<para
>Das Modul können Sie kann jetzt während der Texteingabe benutzen.</para>

<variablelist>

<varlistentry>
<term
>&lt; ("Kleiner als"-Taste)</term>
<listitem
><para
>Damit wird eine Liste mit möglichen Elementen angezeigt, solange sich der Cursor nicht schon in einer Marke befindet. Beachten Sie, dass Sie dies derzeitig noch nicht benutzen können, um ein Element aus der obersten Ebene einzufügen (&eg; <quote
>&lt;html&gt;</quote
>).</para
></listitem>
</varlistentry>

<varlistentry>
<term
>" (Anführungszeichen)</term>
<listitem
><para
>Die Eingabe des Anführungszeichens innerhalb einer Marke wird eine Liste mit möglichen Attributwerten anzeigen (wenn es welche gibt).</para
></listitem>
</varlistentry>

<varlistentry>
<term
>(Leertaste)</term>
<listitem
><para
>Diese Taste wird eine Liste mit möglichen Attributen für das aktuelle Element anzeigen, wenn die Taste innerhalb einer Marke gedrückt wird.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>&amp; (Kaufmanns-Und)</term>
<listitem
><para
>Diese Taste wird eine Liste mit definierten Entities anzeigen.</para
></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="xmltools-features-and-limitations">
<title
>Funktionen und Einschränkungen</title>

<para
>Sie können alle Funktionen und Einschränkungen testen, indem Sie die Datei <filename
>$TDEDIR/share/apps/katexmltools/testcases.xml</filename
> in &kate; laden und den Anweisungen folgen. Beachten Sie, dass die Arbeit mit mehreren Ansichten pro Dokument noch nicht fehlerfrei unterstützt wird.</para>

</sect1>


<sect1 id="xmltools-menu">
<title
>Menü-Struktur</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Eingabe</keycap
> </keycombo
> </shortcut
> <guimenu
>XML</guimenu
> <guimenuitem
>Element einfügen ...</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Damit öffnen Sie einen Dialog zum Einfügen eines &XML;-Elementes. Die &lt;,&gt;-Zeichen und die schließende Marke werden automatisch eingefügt. Wenn vorher Text markiert war, wird dieser mit einer öffnenden und einer schließenden Marke umgeben. Mit dem Dialog ist es auch möglich, alle an der Cursor-Position eingegebenen Elemente zu vervollständigen, wenn eine Meta-DTD mittels <guimenuitem
>Meta-DTD zuweisen ...</guimenuitem
> zugewiesen wurde. </para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>&lt;</keycap
></keycombo
> </shortcut
> <guimenu
>XML</guimenu
> <guimenuitem
>Element schließen</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Sucht im Text nach einer Marke, die noch nicht geschlossen wurde und schließt diese durch Einfügen der entsprechenden schließenden Marke. Die Suche erfolgt von der Cursorposition aus nach links. Falls keine offene Marke gefunden wird, hat dieser Befehl keine Auswirkungen.</para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>XML</guimenu
> <guimenuitem
>Meta-DTD zuweisen ...</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Bestimmt die Meta-DTD für das aktuelle Dokument. Beachten Sie, dass diese Zuordnung nicht gespeichert wird. Sie muss beim nächsten Programmstart von &kate; wiederholt werden.</para
></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="xmltools-thanks-and-acknowledgements">
<title
>Danksagungen</title>

<para
>&kate;-Modul <quote
>XML-Vervollständigung</quote
> Copyright 2001, &Daniel.Naber; &Daniel.Naber.mail;. </para>

<para
>Copyright der Dokumentation 2001, 2002 &Daniel.Naber; </para>

<para
>Übersetzung: Frank Schütte <email
>[email protected]</email
></para
> <para
>Überarbeitung der Übersetzung: Andreas Kunadt <email
>[email protected]</email
></para
> 
&underGPL; </sect1>
</chapter>

<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->