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

<title
>Complementação de <acronym
>XML</acronym
></title>

<authorgroup>
<author
><firstname
>Daniel</firstname
> <surname
>Naber</surname
> <affiliation
> <address
><email
>daniel.naber@t-online.de</email
></address>
</affiliation>
</author>
</authorgroup
> <date
>2002-07-20</date
> <releaseinfo
>0.90.00</releaseinfo
> <abstract
> <para
>Este plug-in suporta escrever arquivos XML listando tags permitidas e mais.</para>

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

<title
>introdução</title>

<para
>Este plug-in dá pistas sobre o que é permitido em certa posição de um arquivo XML, de acordo com o DTD do arquivo. Ele listará possíveis elementos, atributos, valores de atributos ou entidades, dependendo da posição do cursor (por exemplo, todas as entidades são listadas se o caractere a esquerda do cursor for <quote
>&amp;</quote
>). Também é possível fechar a tag aberta mais próxima a esquerda.</para>

<para
>O <acronym
>DTD</acronym
> deve existir em formato XML , como produzido pelo programa Perl <command
>dtdparse</command
>. Chamaremos um DTD neste formato de <quote
>meta DTD</quote
>. Alguns meta DTDs são fornecidos. Eles estão instalados em <filename class="directory"
>$KDEDIR/share/apps/katexmltools/</filename
>, o qual também é a pasta padrão quando você escolhe <guimenuitem
>Designar Meta DTD...</guimenuitem
>. Para produzir seus próprios meta DTDs, pegue o <command
>dtdparse</command
> em <ulink url="http://dtdparse.sourceforge.net"
>http://dtdparse.sourceforge.net</ulink
>.</para>

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

<para
>Inicie o Kate e selecione <guilabel
>Complementação XML do Kate</guilabel
> o qual aparecerá na seção <guilabel
>Aplicação</guilabel
>/<guilabel
>Plug-ins</guilabel
> sob <menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Configurar Kate..</guimenuitem
></menuchoice
>. Após isto, selecione <menuchoice
><guimenu
>Plug-in XML</guimenu
><guimenuitem
>Designar Meta DTD</guimenuitem
></menuchoice
>. Se o seu documento não contém <quote
>DOCTYPE</quote
> ou o doctype é desconhecido, você terá que selecionar um meta DTD do sistema de arquivo. Senão, o meta DTD que combinar com o DOCTYPE do documento atual será carregado automaticamente.</para>

<para
>Você pode agora usar o plug-in enquanto digita seu texto:</para>

<variablelist>

<varlistentry>
<term
>&lt; (chave menor que)</term>
<listitem
><para
>Isto disparará uma lista dos elementos possíveis a menos que o cursor esteja já dentro de uma tag. Note que você atualmente não pode usar isto para inserir os elementos de nível mais alto (isto é <quote
>&lt;html&gt;</quote
>).</para
></listitem>
</varlistentry>

<varlistentry>
<term
>" (chave de citação)</term>
<listitem
><para
>A chave de citação disparará uma lista dos valores de atributos possíveis (se existirem) se você estiver dentro de uma tag.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>(chave de espaço)</term>
<listitem
><para
>Isto disparará uma lista dos atributos possíveis para o elemento atual se você estiver dentro de uma tag.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>&amp; (chave E comercial)</term>
<listitem
><para
>Isto disparará uma lista de entidades nomeadas.</para
></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="xmltools-features-and-limitations">
<title
>Características e Limitações</title>

<para
>Você pode testar todas as funções e limitações carregando <filename
>$KDEDIR/share/apps/katexmltools/testcases.xml</filename
> no &kate; e seguindo as instruções. Note que trabalhar com mais de uma visualização por documento ainda não é suportado corretamente por este plug-in.</para>

</sect1>


<sect1 id="xmltools-menu">
<title
>Estrutura do Menu</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><guimenu
>Plug-in XML</guimenu
> <guimenuitem
>Inserir Elemento...</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Isto abrirá um dialogo que lhe permite inserir um elemento XML. Os caracteres &lt;, &gt; e a tag de fechamento serão inseridas automaticamente. Se você tiver selecionado texto quando este item de menu for selecionado, o texto selecionado será circundado pelas tags de abertura e fechamento. O dialogo também oferece Complementação de todos os elementos que podem ser inseridos na posição atual do cursor se você tiver designado um meta DTD usando <guimenuitem
>Designar Meta DTD...</guimenuitem
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>Plug-in XML</guimenu
> <guimenuitem
> Fechar Elemento</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Isto irá pesquisar em seu texto por uma tag que não está ainda fechada e irá fecha-la inserindo a tag de fechamento correspondente. A pesquisa inicia na posição do cursor e vai para a esquerda. Se não puder encontrar uma tag aberta nada acontecerá.</para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>Plug-in XML</guimenu
> <guimenuitem
>Designar Meta DTD...</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Isto irá dizer ao plug-in qual meta DTD usar para o documento atual. Note que esta designação não será salva. Você terá que repetir isto quando você iniciar o &kate; na próxima vez.</para
></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="xmltools-thanks-and-acknowledgements">
<title
>Agradecimentos e Reconhecimentos</title>

<para
>Plug-in <quote
>Complementação de XML</quote
> do &kate; - copyright 2001,2002 Daniel Naber <email
>daniel.naber@t-online.de</email
>. </para>

<para
>Copyright da Documentação 2001,2002 por Daniel Naber </para>

<para
>Tradução de José Monteiro <email
>monteiro@ajato.com.br</email
></para
> 
&underGPL; </sect1>
</chapter>

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