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

<title
>Completat &XML;</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
>Aquest connector suporta l'escriptura de fitxers &XML; a través del llistat de les etiquetes permeses i altres opcions.</para>

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

<title
>Introducció</title>

<para
>Aquest connector dona consells sobre el que està permès en una posició determinada d'un fitxer &XML;, en funció de la DTD del fitxer. Mostrarà una llista de possibles elements, atributs, valors d'atribut o entitats, depenent de la posició del cursor (&pex; es llisten totes les entitats si el caràcter a l'esquerra del cursor és <quote
>&amp;</quote
>). A més també és possible tancar l'etiqueta oberta més propera.</para>

<para
>La <acronym
>DTD</acronym
> haurà d'existir en format &XML;, tal i com la produeix el programa de Perl <command
>dtdparse</command
>. Direm a aquests tipus de DTD <quote
>meta DTD</quote
>. Es proveeixen algunes meta DTD. Estan instal·lades en <filename class="directory"
>$KDEDIR/share/apps/katexmltools/</filename
>, que a més és la carpeta per omissió quan escolliu <guimenuitem
>Assigna la meta DTD...</guimenuitem
>. Per a produir les vostres pròpies meta DTD, descarregueu <command
>dtdparse</command
> des de <ulink url="http://dtdparse.sourceforge.net"
>http://dtdparse.sourceforge.net</ulink
>.</para>

<sect1 id="xmltools-how-to-use">
<title
>Com usar-lo</title>

<para
>Inicieu &kate; i obriu el diàleg de configuració sota <menuchoice
><guimenu
>Arranjament</guimenu
> <guimenuitem
>Configura Kate...</guimenuitem
></menuchoice
>. Llavores trieu <guilabel
>Completat XML per a Kate</guilabel
>, aquest apareixerà en la secció <guilabel
>Aplicació</guilabel
>/<guilabel
>Connectors</guilabel
> i tanqueu el diàleg. Després d'això, seleccioneu <menuchoice
><guimenu
>XML</guimenu
><guimenuitem
>Assigna la Meta DTD</guimenuitem
></menuchoice
>. Si el vostre document no conté <quote
>DOCTYPE</quote
> o el tipus de document és desconegut, haureu de seleccionar una meta DTD des del sistema de fitxers. D'altra manera es carregarà automàticament la meta DTD que coincideixi amb el DOCTYPE.</para>

<para
>Ara podeu usar el connector mentre escriviu text:</para>

<variablelist>

<varlistentry>
<term
>&lt; (clau menor que)</term>
<listitem
><para
>Obre una llista de possibles elements a menys que el cursor estigui dintre d'una etiqueta. Tingueu present que en aquest moment no serà possible usar-la per inserir un element de primer nivell (&pex; <quote
>&lt;html&gt;</quote
>).</para
></listitem>
</varlistentry>

<varlistentry>
<term
>" (clau de cometes)</term>
<listitem
><para
>La clau de cometes obrirà una llista amb els possibles valors de l'atribut (si es que n'hi han) si us trobeu dins d'una etiqueta.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>(clau d'espai)</term>
<listitem
><para
>Aquesta clau obrirà una llista de possibles atributs per a l'element actual si us trobeu dins d'una etiqueta.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>&amp; (clau de 'i')</term>
<listitem
><para
>Aquest clau obrirà una llista d'entitats anomenades.</para
></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="xmltools-features-and-limitations">
<title
>Característiques i limitacions</title>

<para
>Podeu provar totes les funcions i limitacions carregant <filename
>$KDEDIR/share/apps/katexmltools/testcases.xml</filename
> en &kate; i seguint les instruccions. Tingueu present que treballar amb més d'una vista per document encara no està correctament suportat per aquest connector.</para>

</sect1>


<sect1 id="xmltools-menu">
<title
>Estructura del menú</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;&Retro;</keycombo
> </shortcut
> <guimenu
>XML</guimenu
> <guimenuitem
>Insereix element...</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Obrirà un diàleg que us permetrà inserir un element &XML;. Els caràcters &lt;, &gt; i l'etiqueta de tanca seran inserits automàticament. Si teniu algun text seleccionat en usar aquest menú, dit text serà envoltat per les etiquetes d'obrir i tancar. El diàleg també ofereix completat de tots els elements que es poden inserir en la posició actual del cursor si heu assignat una meta DTD mitjançant el menú <guimenuitem
>Assigna la meta DTD...</guimenuitem
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>&lt;</keycap
></keycombo
> </shortcut
> <guimenu
>XML</guimenu
> <guimenuitem
>Tanca element</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Cercarà en el text una etiqueta que encara no estigui tancada i la tancarà inserint la marca de tanca corresponent. La recerca comença en la posició del cursor i continuarà cap a l'esquerra. Si no troba cap etiqueta oberta no es realitzarà cap operació.</para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>XML</guimenu
> <guimenuitem
>Assigna la meta DTD...</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Li diu al connector quina meta DTD usar en tots els documents actuals. Tingueu present que aquesta assignació no serà desada. Pel que haureu de repetir-la la propera vegada que inicieu &kate;.</para
></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="xmltools-thanks-and-acknowledgements">
<title
>Agraïments i reconèixements</title>

<para
>El connector <quote
>Completat XML</quote
> de &kate; copyright 2001,2002 de  &Daniel.Naber; &Daniel.Naber.mail;. </para>

<para
>Documentació copyright 2001,2002 de &Daniel.Naber; </para>

<para
>Traductor de la documentació: &credits.Antoni.Bella;</para
> 
&underGPL; </sect1>
</chapter>

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