summaryrefslogtreecommitdiffstats
path: root/tde-i18n-fr/docs/kdeaddons/kate-plugins/xmltools.docbook
blob: e12bad3e1c9fa5adb77a597374fa125c0ca6edbd (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
>Complètement &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
>Ce module externe supporte l'écriture de fichiers &XML; en listant les balises autorisées et autres.</para>

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

<title
>Introduction</title>

<para
>Ce module vous donne des astuces sur ce qui est autorisé à une position donnée dans un fichier &XML;, cela en se basant sur le DTD du fichier. Il donnera la liste des éléments, des attributs, des valeurs des attributs ou des entités possibles, selon la position du curseur (toutes les entités sont listées si le caractère à gauche du curseur est <quote
>&amp;</quote
>). Il est aussi possible de fermer la balise ouverte la plus proche à gauche.</para>

<para
>Le <acronym
>DTD</acronym
> doit exister au format &XML;, tel que généré par le programme Perl <command
>dtdparse</command
>. Notez que ce DTD au format XML n'est pas le modèle XML. Il est appelé <quote
>meta DTD</quote
>. Certains meta DTD sont fournis. Ils sont installés dans <filename class="directory"
>$KDEDIR/share/apps/katexmltools/</filename
>, qui est aussi le dossier par défaut lorsque vous choisissez <guimenuitem
>Assigner un meta DTD</guimenuitem
>. Pour fabriquer vos propres meta DTD, procurez-vous <command
>dtdparse</command
> depuis <ulink url="http://dtdparse.sourceforge.net"
>http://dtdparse.sourceforge.net</ulink
>.</para>

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

<para
>Démarrez &kate; et ouvrez la boîte de dialogue de configuration dans <menuchoice
><guimenu
>Configuration</guimenu
><guimenuitem
>Configurer &kate;...</guimenuitem
></menuchoice
>. Choisissez <guilabel
>Complètement XML pour Kate</guilabel
> qui se trouve dans la section<guilabel
>Application</guilabel
>/<guilabel
> Modules externes</guilabel
> puis fermez la boîte de dialogue. Après cela, choisissez <menuchoice
><guimenu
>XML</guimenu
><guimenuitem
>Affecter une méta-DTD...</guimenuitem
></menuchoice
>. Si votre document ne contient pas de <quote
>DOCTYPE</quote
> ou que le doctype est inconnu, vous aurez a sélectionner une méta-DTD depuis votre système de fichiers. Sinon la méta-DTD qui correspond au document actuel sera chargé automatiquement.</para>

<para
>Vous pouvez maintenant utiliser le module durant votre rédaction :</para>

<variablelist>

<varlistentry>
<term
>&lt; (la touche inférieur)</term>
<listitem
><para
>Ceci déclenchera une liste d'éléments possibles à moins que le curseur soit déjà à l'intérieur d'une balise. Notez qu'actuellement, vous ne pouvez pas l'employer pour insérer un élément de niveau supérieur (par exemple <quote
>&lt;html&gt;</quote
>).</para
></listitem>
</varlistentry>

<varlistentry>
<term
>" (la touche guillemet)</term>
<listitem
><para
>La touche guillemet appelle une liste de valeurs possibles d'attribut, s'il y en a et si vous êtes à l'intérieur d'une étiquette.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>(la barre espace)</term>
<listitem
><para
>Cette touche déclenchera une liste d'attributs possibles pour l'élément actuel si vous êtes à l'intérieur d'une balise.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>&amp; (touche esperluette)</term>
<listitem
><para
>Cette touche déclenchera une liste d'entités nommées.</para
></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="xmltools-features-and-limitations">
<title
>Fonctions et limitations</title>

<para
>Vous pouvez tester toutes les fonctions et limitations en chargeant <filename
>$KDEDIR/share/apps/katexmltools/testcases.xml</filename
> dans &kate;, en suivant les instructions contenues dans le fichier. Notez que le travail avec plus d'un document n'est pas supporté correctement actuellement par ce module.</para>

</sect1>


<sect1 id="xmltools-menu">
<title
>Structure des menus</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Entrée</keycap
></keycombo
> </shortcut
> <guimenu
>XML</guimenu
> <guimenuitem
>Insérer un élement...</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Cela ouvre une boîte de dialoguequi vous permet d'insérer un élément &XML;. Les caractères &lt;, &gt; ainsi que l'étiquette de fermeture sera inséré automatiquement. Si vous avez sélectionné du texte lorsque cette option est sélectionné, le texte sera entouré par les étiquettes ouvrante et fermante. La boîte de dialogue offre de plus d'autocomplètement de tous les éléments pouvant être insérés à la position actuelle du curseur. Cela à condition d'avoir sélectionné un meta DTD. en utilisant  <guimenuitem
> Assign Meta DTD...</guimenuitem
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>&lt;</keycap
></keycombo
> </shortcut
> <guimenu
>XML</guimenu
> <guimenuitem
>Fermer l'élement</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Ceci recherchera une balise pas encore fermée dans votre texte, et la fermera en insérant la balise de fermeture correspondants. La recherche démarre à la position du curseur et va vers la gauche. S'il ne peut pas trouver de balise ouvrante, rien ne se passera.</para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>XML</guimenu
> <guimenuitem
>Affecter une méta-DTD...</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Cela précise au module quel meta DTD utiliser pour tous les documents actuellement ouverts. Notez que cette assignation ne sera pas enregistrée, vous aurez à la répéter la prochaine fois que vous démarrerez &kate;.</para
></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="xmltools-thanks-and-acknowledgements">
<title
>Remerciements et mentions</title>

<para
>Module externe de &kate; <quote
>Complètement XML</quote
> copyright 2001, 2002 &Daniel.Naber; &Daniel.Naber.mail; </para>

<para
>Documentation sous copyright 2001,2002 &Daniel.Naber; </para>

<para
>Traduction française par &YvesDessertine;.</para
> <para
>Mise à jour par &GoneriLeBouder;.</para
> 
&underGPL; </sect1>
</chapter>

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