summaryrefslogtreecommitdiffstats
path: root/tde-i18n-pl/docs/kdeaddons/kate-plugins/xmltools.docbook
blob: a5524c57bbac65671f9c317a98d1e2cd1bab478f (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
<chapter id="xmltools">
<chapterinfo>

<title
>Dopełnianie tekstu w XML</title>

<authorgroup>
<author
><firstname
>Daniel</firstname
> <surname
>Naber</surname
> <affiliation
> <address
>&Daniel.Naber.mail;</address>
</affiliation>
</author>
</authorgroup
> <date
>2006-05-17</date
> <releaseinfo
>3.5.2</releaseinfo
> <abstract
> <para
>Wtyczka ta wspomaga tworzenie plików XML poprzez wyświetlanie dopuszczalnych tagów. Zawiera również inne narzędzia.</para>

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

<title
>Wprowadzenie</title>

<para
>Wtyczka ta powoduje wyświetlanie podpowiedzi o dostępnych w danej pozycji edytowanego pliku &XML; elementach, zgodnie z określonym dla tego pliku szablonem DTD. Wyświetlana będzie lista elementów, atrybutów, wartości atrybutów lub encji, w zależności od pozycji kursora (np. wszystkie encje będą wyświetlone jeżeli znakiem na lewo od kursora jest<quote
>&amp;</quote
>). Jedną z funkcji jest także zamykanie najbliższego, znajdującego się po lewej stronie kursora, otwartego znacznika.</para>

<para
>Szablon dokumentu XML <acronym
>DTD</acronym
> musi istnieć i być określony w formacie generowanym przez polecenie Perla <command
>dtdparse</command
>. Szablon w tym formacie jest nazywany <quote
>meta szablonem DTD</quote
>. Wraz z wtyczką zainstalowane jest kilka meta szablonów DTD w katalogu: <filename class="directory"
>$KDEDIR/share/apps/katexmltools/</filename
>, który jest katalogiem domyślnym przy wywoływaniu funkcji <guimenuitem
>Przyporządkuj Meta DTD...</guimenuitem
>. Aby stworzyć własne meta szablony DTD należy skorzystać z programu <command
>dtdparse</command
> dostępnego na stronach: <ulink url="http://dtdparse.sourceforge.net"
>http://dtdparse.sourceforge.net</ulink
>.</para>

<sect1 id="xmltools-how-to-use">
<title
>Jak korzystać z wtyczki</title>

<para
>Należy uruchomić program &kate; i otworzyć okno dialogowe konfiguracji za pomocą menu <menuchoice
><guimenu
>Ustawienia</guimenu
> <guimenuitem
>Konfiguracja &kate;...</guimenuitem
></menuchoice
>. Następnie należy zaznaczyć opcję <guilabel
>Uzupełnianie składni XML </guilabel
> znajdującą się w karcie <guilabel
>Program</guilabel
>/<guilabel
>Wtyczki</guilabel
>. Po włączeniu wtyczki i zamknięciu okna, należy wybrać z menu pozycję <menuchoice
><guimenu
>XML</guimenu
><guimenuitem
>Przyporządkuj Meta DTD...</guimenuitem
></menuchoice
>. Jeżeli edytowany dokument nie posiada elementu <quote
>DOCTYPE</quote
> lub jeżeli jest on nieznany to należy wskazać meta szablon DTD znajdujący się na dysku. W przeciwnym wypadku zostanie automatycznie załadowany meta szablon DTD odpowiadający elementowi DOCTYPE bieżącego dokumentu.</para>

<para
>Od tego momentu można już korzystać z wtyczki podczas edycji naciskając następujące klawisze:</para>

<variablelist>

<varlistentry>
<term
>&lt; (znak mniejszości)</term>
<listitem
><para
>Wyświetli listę dostępnych elementów (tagów). Klawisz działa tylko jeżeli kursor znajduje się poza znacznikiem. Należy zauważyć iż nie można użyć tego klawisze do wstawiania elementów najwyższego poziomu ( jak np.: <quote
>&lt;html&gt;</quote
>).</para
></listitem>
</varlistentry>

<varlistentry>
<term
>" (cudzysłów)</term>
<listitem
><para
>Klawisz wyświetli listę dostępnych wartości atrybutów (jeżeli występują). Klawisz działa jeżeli kursor znajduje się wewnątrz znacznika.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>(spacja)</term>
<listitem
><para
>Naciśnięcie tego klawisza wyświetli listę dostępnych atrybutów dla bieżącego elementu. Klawisz działa jeżeli kursor znajduje się wewnątrz znacznika.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>&amp;</term>
<listitem
><para
>Klawisz wywoła listę dostępnych encji.</para
></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="xmltools-features-and-limitations">
<title
>Możliwości i ograniczenia</title>

<para
>Użytkownik może przetestować wszystkie funkcje i ograniczenia wtyczki wczytując plik <filename
>$KDEDIR/share/apps/katexmltools/testcases.xml</filename
> i postępując zgodnie z zawartymi tam instrukcjami. Należy zaznaczyć iż praca z kilkoma widokami tego samego dokumentu nie jest jeszcze poprawnie obsługiwana przez tą wtyczkę.</para>

</sect1>


<sect1 id="xmltools-menu">
<title
>Pozycje menu</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Return</keycap
></keycombo
> </shortcut
> <guimenu
>XML</guimenu
> <guimenuitem
>Wstaw element...</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Otwiera okno dialogowe pozwalające na wstawienie znacznika &XML;. Znaki &lt;, &gt; oraz znacznik zamykający będą dołączone automatycznie. Jeżeli przed wybraniem tej opcji w dokumencie był zaznaczony fragment tekstu, to zostanie on umieszczony pomiędzy znacznikiem otwierającym i zamykającym. W oknie dialogowym działa również funkcja autouzupełniania nazw znaczników oraz elementów, które można umieścić w bieżącej pozycji kursora zgodnie ze zdefiniowanym za pomocą<guimenuitem
>Przyporządkuj Meta DTD...</guimenuitem
> meta szablonem DTD. </para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>&lt;</keycap
></keycombo
> </shortcut
> <guimenu
>XML</guimenu
> <guimenuitem
>Zamknij element</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Spowoduje przeszukanie dokumentu w poszukiwaniu znacznika, który jeszcze nie został zamknięty i zamknięcie go poprzez wstawienie odpowiedniego znacznika zamykającego. Poszukiwanie rozpoczyna się od pozycji kursora w lewą stronę. Jeżeli żaden otwarty znacznik nie zostanie znaleziony to nic nie zostanie wstawione.</para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>XML</guimenu
> <guimenuitem
>Przyporządkuj Meta DTD...</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Pozwala na wskazanie pliku DTD, który powinien zostać użyty dla bieżącego dokumentu. Przyporządkowanie to nie zostanie zapisane, należy je ponowić przy każdym następnym uruchomieniu &kate;.</para
></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="xmltools-thanks-and-acknowledgements">
<title
>Podziękowania i zasługi</title>

<para
>Wtyczka &kate; <quote
>Uzupełnianie składni XML</quote
>. Prawa autorskie (c) 2001,2002 &Daniel.Naber; &Daniel.Naber.mail;. </para>

<para
>Prawa autorskie do dokumentacji (c) 2001,2002 &Daniel.Naber; </para>

<para
>Krzysztof Woźniak <email
>wozniakk@ceti.pl</email
></para
> 
&underGPL; </sect1>
</chapter>

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