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
|
<chapter id="xmltools">
<chapterinfo>
<title><acronym>XML</acronym>-kiegészítő</title>
<authorgroup>
<author><firstname>Daniel</firstname> <surname>Naber</surname> <affiliation> <address><email>[email protected]</email></address>
</affiliation>
</author>
</authorgroup> <date>2002. 07. 20.</date> <releaseinfo>0.90.00</releaseinfo> <abstract> <para>Ez a modul XML fájlok elkészítését segíti, felsorolva a megengedett tag-eket stb.</para>
</abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>Kate</keyword>
<keyword>xml</keyword>
</keywordset>
</chapterinfo>
<title>Bevezető</title>
<para>A modul megjeleníti azokat az elemeket, amelyek engedélyezettek az XML dokumentum aktuális pozíciójánál, a fájl DTD-je alapján. Kilistázza az engedélyezett elemeket, attribútumokat, attribútumértékeket vagy entitásokat, mindig a kurzorpozíciónak megfelelően (a lista az összes entitást tartalmazza, ha a kurzortól balra az <quote>&</quote> jel található). Ezenkívül be lehet zárni a legutoljára megnyitott tag-et.</para>
<para>A <acronym>DTD</acronym>-nek XML formátumúnak kell lennie, ahogy pl. a <command>dtdparse</command> nevű Perl programmal készíthető. Az ilyen DTD-t <quote>meta-DTD</quote>-nek hívják. A modulhoz tartozik néhány meta-DTD, telepítéskor a <filename class="directory">$TDEDIR/share/apps/katexmltools/</filename> könyvtárba kerülnek, mely az alapértelmezett könyvtár a <guimenuitem>Meta-DTD hozzárendelése...</guimenuitem> parancsnál. Ha saját meta-DTD-t szeretne készíteni, töltse le a <command>dtdparse</command> programot innen: <ulink url="http://dtdparse.sourceforge.net">http://dtdparse.sourceforge.net</ulink>.</para>
<sect1 id="xmltools-how-to-use">
<title>Használati útmutató</title>
<para>Indítsa el a Kate-et és válassza a <guilabel>Kate XML-kiegészítő</guilabel> menüpontot, mely az <guilabel>Alkalmazás</guilabel>/<guilabel>Bővítőmodulok</guilabel> részben található a <menuchoice><guimenu>Beállítások</guimenu> <guimenuitem>A Kate beállításai..</guimenuitem></menuchoice> menüben. Ezután válassza az <menuchoice><guimenu>XML-bővítőmodul</guimenu><guimenuitem>Meta-DTD hozzárendelése</guimenuitem></menuchoice> menüpontot. Ha a dokumentum nem tartalmaz <quote>DOCTYPE</quote> sort vagy a dokumentumtípus ismeretlen, ki kell választani a fájlrendszerből egy meta-DTD-t. Máskülönben az a meta-DTD lesz betöltve, mely a dokumentum DOCTYPE-jának megfelel.</para>
<para>A modulban szövegbevitelkor használható parancsok:</para>
<variablelist>
<varlistentry>
<term>< (kisebb jel)</term>
<listitem><para>Ennek hatására megjelenik a lehetséges elemek listája, kivéve, ha a kurzor már egy tag belsejében található. Jelenleg nem használható a legfelső szintű elem beszúrására (pl. <quote><html></quote>).</para></listitem>
</varlistentry>
<varlistentry>
<term>" (idézőjel)</term>
<listitem><para>Az idézőjel hatására megjelenik a választható attribútumok listája (ha nem üres), feltéve, hogy a kurzor már egy tag-en belül van.</para></listitem>
</varlistentry>
<varlistentry>
<term>(szóköz)</term>
<listitem><para>Ennek hatására megjelenik az aktuális elemnél lehetséges attribútumok listája, ha a kurzor tag-en belül található.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>& (és jel)</term>
<listitem><para>Ennek hatására megjelenik a nevesített entitások listája.</para></listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="xmltools-features-and-limitations">
<title>Lehetőségek, korlátok</title>
<para>Egyszerűen kipróbálhatja a szerkesztési lehetőségeket (és azok korlátait): töltse be a <filename>$TDEDIR/share/apps/katexmltools/testcases.xml</filename> fájlt a &kate;-be, és kövesse az utasításokat. Egyszerre csak egy nézetet lehet használni dokumentumonként.</para>
</sect1>
<sect1 id="xmltools-menu">
<title>A menüstruktúra</title>
<variablelist>
<varlistentry>
<term>
<menuchoice><guimenu>XML bővítőmodul</guimenu> <guimenuitem>Elem beszúrása...</guimenuitem> </menuchoice>
</term>
<listitem><para>Megnyit egy párbeszédablakot, melyből a kiválasztott XML elemet be lehet szúrni. A <, > jelet és a bezárő tag-et a program automatikusan beilleszti. Ha a menü kiválasztásakor ki volt jelölve egy szövegrész, akkor az a kezdő és záró tag közé fog kerülni. A párbeszédablak felajánlja az aktuális pozíciónál beszúrható összes elemet, ha kiválasztott egy meta-DTD-t a <guimenuitem>Meta-DTD hozzárendelése...</guimenuitem> menüpontban. </para></listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice><guimenu>XML-bővítőmodul</guimenu> <guimenuitem>Az elem bezárása</guimenuitem> </menuchoice>
</term>
<listitem><para>Ennek választásakor a program megkeresi visszafelé az utolsó megnyitott tag-et, és beszúrja az aktuális pozícióhoz a megfelelő bezáró elemet. A keresés mindig a kurzorpozíciótól visszafelé halad. Ha nincs megnyitott tag, nem történik semmi.</para></listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice><guimenu>XML-bővítőmodul</guimenu> <guimenuitem>Meta-DTD hozzárendelése...</guimenuitem> </menuchoice>
</term>
<listitem><para>Itt lehet megadni, hogy az aktuális dokumentumhoz melyik meta-DTD-t kell használni. A hozzárendelést nem menti el a program, ezért minden alkalommal (a &kate; megnyitása után) újra el kell végezni.</para></listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="xmltools-thanks-and-acknowledgements">
<title>A közreműködők névsora</title>
<para><quote>XML-kiegészítő</quote> &kate;-bővítőmodul - szerzői jog: Daniel Naber (<email>[email protected]</email>), 2001, 2002. </para>
<para>A dokumentáció szerzői joga: Daniel Naber, 2001, 2002. </para>
<para>Magyar fordítás: Szántó Tamás <email>[email protected]</email></para>
&underGPL; </sect1>
</chapter>
|
