Imported Upstream version 2.10+ds
[debian/jabref.git] / src / help / fr / CustomExports.html
1 <html xmlns="http://www.w3.org/1999/xhtml">
2 <head>
3 <link rel="stylesheet" type="text/css" href="../jabref_help.css"/>
4 </head>
5
6 <body>
7
8     <h1>Filtres d'exportation personnalis&eacute;s</h1>
9
10     <p>JabRef vous permet de d&eacute;finir et d'utiliser vos
11     propres filtres d'exportation de la m&ecirc;me mani&egrave;re
12     que les filtres d'exportation standards. Un filtre
13     d'exportation est d&eacute;fini par un ou plusieurs <i>fichiers
14     gabarit</i> qui, avec l'aide d'un certain nombre de routines
15     internes de formatage, d&eacute;finissent le format des
16     fichiers export&eacute;s. Vos fichiers gabarit doivent
17     &ecirc;tre pr&eacute;par&eacute;s avec un &eacute;diteur de
18     texte &agrave; l'ext&eacute;rieur de JabRef.</p>
19
20     <h2>Ajout d'un filtre d'exportation personnalis&eacute;</h2>
21
22     <p>La seule obligation pour avoir un filtre d'exportation
23     valide est l'existence d'un fichier avec l'extension
24     <b>.layout</b>. Pour ajouter un nouveau filtre d'exportation,
25     on utilise le menu <b>Options -&gt; G&eacute;rer les
26     exportations personnalis&eacute;es</b>, et on clique sur
27     <b>Ajouter nouvelle</b>. Une nouvelle boite de dialogue
28     appara&icirc;t et vous permet de sp&eacute;cifier le nom du
29     nouveau filtre d'exportation (ce nom appara&icirc;tra ensuite
30     comme l'un des choix du menu d&eacute;roulant "Type de fichier"
31     de la fen&ecirc;tre de dialogue affect&eacute;e au menu
32     <b>Fichier -&gt; Exporter</b> de la fen&ecirc;tre principale de
33     JabRef), le chemin du fichier <b>.layout</b>, et l'extension de
34     fichier pr&eacute;f&eacute;r&eacute;e par le filtre
35     d'exportation (c'est cette extension qui sera
36     sugg&eacute;r&eacute;e dans la boite de dialogue lorsque le
37     filtre sera utilis&eacute;).</p>
38
39     <h2>Cr&eacute;ation d'un filtre d'exportation</h2>
40
41     <p>Pour voir des exemples de constitution de filtres
42     d'exportation, recherchez le r&eacute;pertoire contenant les
43     fichiers gabarit des filtres d'exportation standards sur notre
44     page de t&eacute;l&eacute;chargement.</p>
45
46     <h3>Les fichiers gabarit</h3>
47
48     <p>On suppose que l'on veut cr&eacute;er un filtre
49     d'exportation pour une sortie HTML.</p>
50
51     <p>Bien que le filtre d'exportation ne n&eacute;cessite qu'un
52     seul fichier <b>.layout</b>, qui dans ce cas pourrait s'appeler
53     <i>html.layout</i>, vous pouvez d&eacute;sirer ajouter deux
54     autres fichiers appel&eacute;s <i>html.begin.layout</i> et
55     <i>html.end.layout</i>. Le premier contient le d&eacute;but de
56     la sortie et le dernier la fin. JabRef recherche ces deux
57     fichiers quelque soit le fichier d'exportation utilis&eacute;
58     et, s'il les trouve, les recopie tel quel dans la sortie avant
59     et apr&egrave;s l'&eacute;criture des entr&eacute;es
60     individuelles.</p>
61
62     <p>Il faut noter que ces fichiers doivent &ecirc;tre dans le
63     m&ecirc;me r&eacute;pertoire que le fichier <i>html.layout</i>,
64     et que leur nom doit comporter <b>.begin</b> pour l'un et
65     <b>.end</b> pour l'autre.</p>
66
67     <p>Dans notre exemple de fichier d'exportation, cela pourrait
68     ressembler &agrave;</p>
69
70     <p><i>html.begin.layout</i>&nbsp;:<br />
71     <code>&lt;!DOCTYPE html&gt;<br/>&lt;html&gt;<br /> &lt;body
72     style="color:#275856; font-family: Arial, sans-serif;"&gt;</code>
73     </p>
74
75     <p><i>html.end.layout</i>&nbsp;:<br />
76     <code>&lt;/BODY&gt;<br />&lt;/HTML&gt;</code></p>
77
78     <p>Le fichier <i>html.layout</i> fournit le gabarit par
79     d&eacute;faut pour l'exportation d'une seule entr&eacute;e. Si
80     vous devez utiliser diff&eacute;rents gabarits pour les
81     diff&eacute;rentes entr&eacute;es, vous pouvez le faire en
82     ajoutant des fichiers <b>.layout</b> sp&eacute;cifiques. Les
83     fichiers doivent aussi &ecirc;tre dans le m&ecirc;me
84     r&eacute;pertoire que le gabarit principal et ils sont
85     nomm&eacute;s en ins&eacute;rant <b>.entrytype</b> dans le nom
86     du fichier gabarit principal. Le nom de l'entr&eacute;e doit
87     &ecirc;tre en minuscules. Dans notre exemple, on peut vouloir
88     ajouter un gabarit diff&eacute;rent pour les livres et cela se
89     fera via le fichier <i>html.book.layout</i>. Pour une
90     th&egrave;se, on ajoutera le fichier
91     <i>html.phdthesis.layout</i>. Ces fichiers sont similaires au
92     gabarit principal, si ce n'est qu'ils sont utilis&eacute;s pour
93     des entr&eacute;es sp&eacute;cifiques. A noter que le gabarit
94     g&eacute;n&eacute;ral peut ais&eacute;ment &ecirc;tre
95     cr&eacute;&eacute; suffisamment g&eacute;n&eacute;ral pour
96     &ecirc;tre utilisable avec la plupart des entr&eacute;es dans
97     la majorit&eacute; des filtres d'exportation.</p>
98
99     <h3>Le format des fichiers gabarit</h3>
100
101     <p>Les fichiers gabarit utilisent un simple langage de balisage
102     dans lequel les commandes sont identifi&eacute;es par
103     l'antislash (\) les pr&eacute;c&eacute;dant. Tout texte non
104     identifi&eacute; comme faisant partie d'une entr&eacute;e est
105     recopi&eacute; tel quel dans le fichier de sortie.</p>
106
107     <h3>Les commandes relatives aux champs</h3>
108
109     <p>Les mots pr&eacute;c&eacute;d&eacute;s d'un antislash, par
110     exemple <code>\author</code>, <code>\editor</code>,
111     <code>\title</code> ou <code>\year</code>, sont
112     interpr&eacute;t&eacute;s comme des r&eacute;f&eacute;rences
113     aux champs correspondants et le contenu du champ est
114     copi&eacute; directement dans la sortie.</p>
115
116     <h3>Les formateurs de champs</h3>
117
118     <p>Souvent, on a besoin de faire subir au contenu d'un champ un
119     pr&eacute;-traitement avant de le copier dans le fichier de
120     sortie. Cela est r&eacute;alis&eacute; en utilisant un
121     <i>formateur de champ</i> - une classe java contenant une seule
122     m&eacute;thode qui manipule le contenu du champ.</p>
123
124     <p>Le formateur est utilis&eacute; en ins&eacute;rant la
125     commande <code>\format</code> suivie du nom du formateur entre
126     crochets et du nom du champ entre accolades, par exemple</p>
127
128     <p><code>\format[ToLowerCase]{\author}</code></p>
129
130     <p>Vous pouvez aussi indiquer plusieurs formateurs
131     s&eacute;par&eacute;s par des virgules. Ils seront alors
132     appel&eacute;s s&eacute;quentiellement de la gauche vers la
133     droite, par exemple&nbsp;:</p>
134
135     <p><code>\format[ToLowerCase,HTMLChars]{\author}</code></p>
136
137     <p>va d'abord appliquer le formateur <b>ToLowerCase</b> puis
138     <b>HTMLChars</b> sur le r&eacute;sultat. Vous pouvez lister un
139     nombre arbitraire de formateurs de cette mani&egrave;re.</p>
140
141
142     <p>L'argument des formateurs, &agrave; l'int&eacute;rieur des accolades,
143     n'est pas obligatoirement une commande de champ. Ce peut aussi
144     &ecirc;tre du texte normal qui sera ensuite pass&eacute; aux formateurs
145     au lieu des contenus d'un champ. Cela peut &ecirc;tre utilis&eacute; pour
146     certains formateurs, par ex. le formateur CurrentDate (d&eacute;crit
147     ci-dessous).</p>
148
149     <p>Certains formateurs prennent un argument suppl&eacute;mentaire, sp&eacute;cifi&eacute; entre parenth&egrave;ses
150     imm&eacute;diatement apr&egrave;s le nom du formateur. L'argument peut &ecirc;tre mis
151     entre crochets, ce qui est n&eacute;cessaire s'il inclut les caract&egrave;res de parenth&egrave;ses.
152     Par exemple, <code>\format[Replace("\s,_")]{\journal}</code> appelle
153     le formateur <b>Replace</b> avec l'argument <b>\s,_</b> (ce qui remplace
154     tous les espaces par des soulign&eacute;s dans le champ "field").</p>
155
156
157     <p>Voir ci-dessous pour une liste des formateurs d'exportation disponibles.</p>
158
159
160     <h3>Les sorties conditionnelles</h3>
161
162     <p>Certaines informations dans les sorties ne prennent de sens
163     que si un certain champ est utilis&eacute;. Par exemple, disons
164     que l'on veuille faire suivre le nom de l'&eacute;diteur par le
165     texte <code>(Ed.)</code>. Cela peut &ecirc;tre
166     r&eacute;alis&eacute; avec le code suivant&nbsp;:</p>
167
168     <p><code>\format[HTMLChars,AuthorFirstFirst]{\editor}
169     (Ed.)</code></p>
170
171     <p>Cependant, si le champs <code>editor</code> n'a pas
172     &eacute;t&eacute; renseign&eacute; - il n'a pas de sens pour
173     l'entr&eacute;e export&eacute;e - le texte <code>(Ed.)</code>
174     doit &ecirc;tre ignor&eacute;. Cela peut &ecirc;tre
175     effectu&eacute; en utilisant les commandes <code>\begin</code>
176     et <code>\end</code>&nbsp;:</p>
177
178     <p><code>\begin{editor}<br />
179     \format[HTMLChars,AuthorFirstFirst]{\editor} (Ed.)<br />
180      \end{editor}</code></p>
181
182     <p>Les commandes <code>\begin</code> et <code>\end</code>
183     assure que le texte contenu entre les deux commandes ne sera
184     imprim&eacute; que si et seulement si le champ
185     sp&eacute;cifi&eacute; entre accolades est renseign&eacute;
186     dans l'entr&eacute;e que l'on veut exporter.</p>
187
188     <p>Un bloc conditionnel peut aussi d&eacute;pendre de plus d'un champ,
189     et le contenu du bloc est affich&eacute; uniquement
190     quand toutes les conditions sont remplies.
191     Deux op&eacute;rateurs conditionnels sont disponibles&nbsp;:</p>
192     <ul>
193         <li>op&eacute;rateur ET&nbsp;: <code>&amp;</code>, <code>&amp;&amp;</code></li>
194         <li>op&eacute;rateur OU&nbsp;: <code>|</code>, <code>||</code></li>
195     </ul>
196
197     <p>Pour imprimer du texte uniquement si &agrave; la fois les champs
198     <code>year</code> et <code>month</code> sont renseign&eacute;s, utilisez
199     un bloc tel que celui-ci&nbsp;:<br/><br/>
200     <code>\begin{year&amp;&amp;month}Month: \format[HTMLChars]
201         {\month}\end{year&amp;&amp;month}</code><br/><br/>
202     qui imprimera "Month: " plus le contenu du champ <code>month</code>, mais
203     seulement si le champ <code>year</code> est lui-aussi d&eacute;fini.</p>
204
205     <p><b>Note&nbsp;:</b> L'utilisation des commandes
206     <code>\begin</code> et <code>\end</code> est une mani&egrave;re
207     astucieuse de cr&eacute;er des gabarits qui sont communs
208     &agrave; une grande vari&eacute;t&eacute; d'entr&eacute;es.</p>
209
210
211     <h3>Les sorties group&eacute;es</h3>
212
213     <p>Si vous d&eacute;sirez s&eacute;parer vos entr&eacute;es en
214     groupes bas&eacute;s sur un certain champ, vous pouvez utiliser
215     les commandes de sorties group&eacute;es. La sortie
216     group&eacute;e est assez similaire aux sorties conditionnelles,
217     except&eacute; que le texte sp&eacute;cifi&eacute; n'est
218     imprim&eacute; que si le champ indiqu&eacute; dans les
219     accolades change de valeur.</p>
220
221     <p>Par exemple, on suppose que l'on d&eacute;sire faire des
222     groupes &agrave; partir de mots-clefs. Avant l'exportation, on
223     s'assure que les entr&eacute;es sont tri&eacute;es selon les
224     mots-clefs. Ensuite, on utilise les commandes suivantes pour
225     les grouper par mot-clefs&nbsp;:</p>
226     
227     <p><code>\begingroup{keywords}New Category:
228     \format[HTMLChars]{\keywords}<br />
229      \endgroup{keywords}</code></p>
230
231     <h2>Partage de votre travail</h2>
232
233     <p>Avec les fichiers gabarit externes, il est relativement
234     simple de partager des formats d'exportation entre
235     utilisateurs. Si vous &eacute;crivez un filtre d'exportation
236     pour un format non support&eacute; par JabRef, ou si vous
237     am&eacute;liorez un filtre d&eacute;j&agrave; existant, nous
238     vous encourageons &agrave; d&eacute;poser votre travail sur
239     notre page SourceForge.net. La m&ecirc;me chose est possible
240     pour les nouvelles classes de formateur que vous avez
241     &eacute;crites. Nous serons heureux de distribuer une
242     collection des fichiers gabarit soumis ou de les ajouter
243     &agrave; la s&eacute;rie des filtres d'exportation standard ou
244     des formateurs.</p>
245
246     <p>&Agrave; partir de JabRef 2.4 vous pouvez aussi empaqueter votre
247     format d'exportation ("ExportFormat") ou formateur de gabarit
248     ("LayoutFormatter") comme un greffon ("plug-in"). Si vous le
249     faites, vous pouvez fournir un unique fichier zip &agrave; d'autres
250     utilisateurs afin qu'ils utilisent votre format d'exportation.
251     Pour un exemple, t&eacute;l&eacute;charger le source de JabRef et jeter un
252     oeil au r&eacute;pertoire <code>src/plugins/</code>. N'h&eacute;sitez pas
253     &agrave; participer aux forums sur Sourceforge, puisque nous ne disposons
254     pas encore d'une documentation volumineuse.</p>
255
256
257     <h2>Formateurs d'exportation inclus</h2>
258
259     <p>JabRef fournit la s&eacute;rie suivante de formateurs&nbsp;:</p>
260
261     <ul>
262         <li><code>Authors</code>&nbsp;: Ce formateur fournit des options de
263             formatage pour les champs author et editor&nbsp;
264             pour des informations d&eacute;taill&eacute;es, voir ci-dessous.
265             Il rend obsol&egrave;te une s&eacute;rie de formateurs
266             d&eacute;di&eacute;s qui &eacute;taient disponibles dans les
267             versions de JabRef ant&eacute;rieures &agrave; 2.7.</li>
268
269         <li><code>CreateBibORDFAuthors</code>&nbsp;: formate les auteurs
270             selon les sp&eacute;cification de Bibliographic Ontology (bibo).</li>
271
272         <li><code>CreateDocBookAuthors</code>&nbsp;: formate le
273         contenu du champ author selon le style DocBook.</li>
274
275         <li><code>CreateDocBookEditors</code>&nbsp;: formate le
276         contenu du champ editor selon le style DocBook.</li>
277
278         <li><code>CurrentDate</code>&nbsp;: renvoie la date
279         actuelle. Sans argument, ce formateur renvoie la date et
280         l'heure actuelle au format "yyyy.MM.dd hh:mm:ss z" (date,
281         heure et fuseau horaire). En donnant une cha&icirc;ne de
282         format diff&eacute;rent comme argument, le format de la
283         date peut-&ecirc;tre adapt&eacute;. Par exemple,
284         <code>\format[CurrentDate]{yyyy.MM.dd}</code> renverra
285         uniquement la date, comme par exemple 2005.11.30.</li>
286         
287         <li><code>Default</code>&nbsp;: prend un seul argument, qui sert comme
288         valeur par d&eacute;faut. Si la cha&icirc;ne &agrave; formater
289         n'est pas vide, elle est renvoy&eacute;e sans changement.
290         Si elle est vide, la valeur par d&eacute;faut est renvoy&eacute;e.
291         Par exemple,
292         <code>\format[Default(unknown)]{\year}</code>
293         renverra l'ann&eacute;e de l'entr&eacute;e si elle existe,
294         et "unknown" si l'ann&eacute;e n'est pas pr&eacute;cis&eacute;e.</li>
295
296         <li><code>DOIStrip</code>&nbsp;: supprime tous les pr&eacute;fixes d'une
297             cha&icirc;ne de DOI.</li>
298
299         <li><code>DOICheck</code>&nbsp;: fournit l'URL compl&egrave;te pour
300             un lien DOI.</li>
301
302         <li><code>FileLink(TypeDeFichier)</code>&nbsp;: sans argument, ce formateur renvoie
303         le premier lien apparaissant dans le champ. Pour fonctionner, ce formateur doit
304         &ecirc;tre aliment&eacute; par le contenu du champ "file" (fichier).<br/>
305         Ce formateur prend comme argument optionnel l'extension du type de fichier externe
306         sp&eacute;cifi&eacute; entre parenth&egrave;ses apr&egrave;s le nom du formateur. Par exemple,
307         <code>\format[FileLink(pdf)]{\file}</code> sp&eacute;cifie <code>pdf</code> comme un
308         argument. Quand un argument est fourni, le formateur s&eacute;lectionne le premier lien
309         vers un fichier du type sp&eacute;cifi&eacute;. Dans l'exemple, le chemin vers le premier lien PDF
310         sera renvoy&eacute;.</li>
311
312         <li><code>FirstPage</code>&nbsp;: renvoie la premi&egrave;re page du champ "pages", si initialis&eacute;.
313         Par exemple, si le champ "pages" est initialis&eacute; avec "345-360" ou "345--360",
314         ce formateur renverra "345".</li>
315
316         <li><code>FormatChars</code>&nbsp;: Ce formateur convertit les s&eacute;quences
317         de caract&egrave;res LaTeX dans les caract&egrave;res unicode &eacute;quivalents et
318         supprime les autres commandes LaTeX sans les transf&eacute;rer.</li>
319
320         <li><code>FormatPagesForHTML</code>&nbsp;: remplace "--"
321         par "-".</li>
322
323         <li><code>FormatPagesForXML</code>&nbsp;: remplace "--" par
324         un tiret XML.</li>
325         
326         <li><code>GetOpenOfficeType</code>&nbsp;: renvoie le num&eacute;ro
327         utilis&eacute; par le syst&egrave;me bibliographique d'OpenOffice.org
328         (versions 1.x et 2.x) pour d&eacute;finir le type
329         de cette &eacute;e.</li>
330         
331         <li><code>HTMLChars</code>&nbsp;: remplace les
332         caract&egrave;res sp&eacute;ciaux sp&eacute;cifiques
333         &agrave; TeX (par exemple&nbsp;: {\^a} ou {\"{o}}) par leur
334         repr&eacute;sentation HTML, et traduit les commandes LaTeX
335         \emph, \textit, \textbf dans leurs &eacute;quivalents HTML.</li>
336
337         <li><code>HTMLParagraphs</code>&nbsp;: interpr&egrave;te
338         deux retours-chariot cons&eacute;cutifs (comme \n \n) comme
339         le d&eacute;but d'un nouveau paragraphe et cr&eacute;e les
340         balises html de paragraphes appropri&eacute;es.</li>
341
342         <li><code>IfPlural</code>&nbsp;: renvoie son premier argument si le
343         champ d'entr&eacute;e ressemble &agrave; une liste d'auteurs avec deux
344         noms ou plus, sinon renvoie son second argument. Par exemple,
345         <code>\format[IfPlural(Eds.,Ed.)]{\editor}</code> renverra "Eds." s'il y
346         a plus d'un &eacute;diteur et "Ed." s'il n'y en a qu'un seul.</li>
347
348         <li><code>JournalAbbreviator</code>&nbsp;: Le texte donn&eacute; en entr&eacute;e
349         est abr&eacute;g&eacute; selon les listes d'abr&eacute;viations des journaux.
350         Si aucune abr&eacute;viation n'est trouv&eacute; pour l'entr&eacute;e (par exemple, si elle
351         n'est pas dans la liste ou si elle est d&eacute;j&agrave; abr&eacute;g&eacute;e), l'entr&eacute;e sera
352         renvoy&eacute;e sans modification.
353         Par exemple, en utilisant <code>\format[JournalAbbreviator]{\journal}</code>,
354         "Physical Review Letters" renvoie "Phys. Rev. Lett."</li>
355
356         <li><code>LastPage</code>&nbsp;: renvoie la derni&egrave;re page du champ "pages", si initialis&eacute;.
357         Par exemple, si le champ "pages" est initialis&eacute; avec "345-360" ou "345--360",
358         ce formateur renverra "360".</li>
359
360         <li><code>NoSpaceBetweenAbbreviations</code>&nbsp;: Un formateur de mise
361         en page qui supprime l'espace entre les initiales des pr&eacute;noms.
362         Par exemple&nbsp;: J. R. R. Tolkien devient J.R.R. Tolkien.</li>
363
364         <li><code>NotFoundFormatter</code>&nbsp;: Ce formateur est utilis&eacute;
365         pour indiquer qu'un formateur n'a pas &eacute;t&eacute; trouv&eacute;.
366         Cela peut-&ecirc;tre utilis&eacute; pour g&eacute;rer proprement les cas o&ugrave; une mise
367         en page utilise un format non d&eacute;fini.</li>
368
369         <li><code>Number</code>&nbsp;: renvoie la s&eacute;quence de nombres &agrave; base de 1 de l'entr&eacute;e actuelle dans
370         l'exportation actuelle. Ce formateur peut &ecirc;tre utilis&eacute; pour faire une liste num&eacute;rot&eacute;e d'entr&eacute;es. Le
371         num&eacute;ro de s&eacute;quence d&eacute;pend de la place de l'entr&eacute;e actuelle dans l'ordre de tri actuel, pas du
372         nombre d'appels de ce formateur.</li>
373
374         <li><code>RemoveBrackets</code>&nbsp;: supprime toutes les
375         accolades "{" ou "}".</li>
376
377         <li><code>RemoveBracketsAddComma</code>&nbsp;: supprime toutes les
378         accolades "{" ou "}". L'accolade fermante est remplac&eacute;e par une virgule.</li>
379
380         <li><code>RemoveLatexCommands</code>&nbsp;: supprime toutes
381         les commandes LaTeX comme <code>\em</code>,
382         <code>\textbf</code>, etc. Lorsqu'il est utilis&eacute;
383         avec <code>HTMLChars</code> ou <code>XMLChars</code>, ce
384         formateur doit &ecirc;tre appel&eacute; en dernier.</li>
385
386         <li><code>RemoveTilde</code>&nbsp;: remplace le
387         caract&egrave;re tilde (utilis&eacute; dans LaTeX comme un
388         espace ins&eacute;cable) par un espace normal. Utile en
389         combinaison avec <a href="#NameFormatter">un formateur de nom</a>        
390         comme discut&eacute; dans la prochaine section.</li>
391
392         <li><code>RemoveWhitespace</code>&nbsp;: supprime tous les caract&egrave;res espace.</li>
393
394         <li><code>Replace(ExpReg,RemplaceAvec)</code>&nbsp;: effectue le remplacement d'une expression r&eacute;guli&egrave;re.
395         Pour utiliser ce formateur, un argument en deux parties doit &ecirc;tre fourni. Les parties sont
396         s&eacute;par&eacute;es par une virgule. Pour indiquer le caract&egrave;re virgule, utilisez la s&eacute;quence
397         d'&eacute;chappement&nbsp;: \,<br/>
398         La premi&egrave;re partie est l'expression r&eacute;guli&egrave;re &agrave; rechercher. 
399         Notez bien que toute virgule doit y &ecirc;tre pr&eacute;c&eacute;d&eacute;e par un antislash,
400         et, qu'en cons&eacute;quence, un antislash dans l'expression r&eacute;guli&egrave;re
401         recherch&eacute;e y est repr&eacute;sent&eacute; par une paire d'anti-slash. Une description
402         des expression r&eacute;guli&egrave;res de Java peut &ecirc;tre trouv&eacute;e &agrave;&nbsp;:<br/>
403         &nbsp;http://java.sun.com/j2se/1.4.2/docs/api/java/util/regex/Pattern.html<br/>
404         La seconde partie est le texte qui remplace tous les correspondances.</li>
405
406         <li><code>RisAuthors</code>&nbsp;: &agrave; documenter.</li>
407
408         <li><code>RisKeywords</code>&nbsp;: &agrave; documenter.</li>
409
410         <li><code>RisMonth</code>&nbsp;: &agrave; documenter.</li>
411
412         <li><code>RTFChars</code>&nbsp;: remplace les
413         caract&egrave;res sp&eacute;ciaux sp&eacute;cifiques
414         &agrave; TeX (par exemple&nbsp;: {\^a} ou {\"{o}}) par leur
415         repr&eacute;sentation RTF, et traduit les commandes LaTeX
416         \emph, \textit, \textbf dans leurs &eacute;quivalents RTF.</li>
417
418         <li><code>ToLowerCase</code>&nbsp;: bascule tous les
419         caract&egrave;res en minuscules.</li>
420
421         <li><code>ToUpperCase</code>&nbsp;: bascule tous les
422         caract&egrave;res en majuscules.</li>
423
424         <li><code>WrapContent</code>&nbsp;: 
425         Ce formateur renvoie la valeur d'entr&eacute;e apr&egrave;s ajout d'un pr&eacute;fixe et
426         d'un suffixe, tant que la valeur d'entr&eacute;e n'est pas vide.
427         
428         Si la valeur d'entr&eacute;e est vide, une cha&icirc;ne vide est renvoy&eacute;e (le
429         pr&eacute;fixe et le suffixe ne sont pas renvoy&eacute;s dans ce cas).
430         Le formateur n&eacute;cessite un argument contenant le pr&eacute;fixe et le suffixe
431         s&eacute;par&eacute;s par une virgule.
432         Pour inclure le caract&egrave;re virgule dans l'un d'entre eux, utilisez la
433         cha&icirc;ne d'&eacute;chappement
434         (\,).</li>
435
436         <li><code>WrapFileLinks</code>&nbsp;: Voir ci-dessous.</li>
437
438         <li><code>XMLChars</code>&nbsp;: remplace les
439         caract&egrave;res sp&eacute;ciaux sp&eacute;cifiques
440         &agrave; TeX (par exemple&nbsp;: {\^a} ou {\"{o}}) par leur
441         repr&eacute;sentation XML.</li>
442
443     </ul>
444
445     <h3>Le formateur <code>Authors</code></h3>
446
447     <p>Pour satisfaire les nombreux styles de citation,
448         le formateur <code>Authors</code> permet un contr&ocirc;le flexible de la mise
449         en page de la liste des auteurs. Le formateur prend en argument
450         une liste d'options s&eacute;par&eacute;es par des virgules, ce qui remplace leurs
451         valeurs par d&eacute;faut. Les paires option/valeur suivantes sont actuellement
452         disponibles, les valeurs par d&eacute;faut &eacute;tant &eacute;crites entre accolades.</p>
453
454     <dl>
455     <dt><code>AuthorSort = [ {FirstFirst} | LastFirst | LastFirstFirstFirst]</code></dt>
456     <dd>d&eacute;finit l'ordre dans lequel les noms d'auteur sont format&eacute;s.
457         <ul>
458                 <li><code>FirstFirst</code>&nbsp;:
459                     les pr&eacute;noms sont suivis du nom de famille.</li>
460                 <li><code>LastFirst</code>&nbsp;:
461                     les noms de famille des auteurs sont suivis de leurs pr&eacute;noms,
462                     s&eacute;par&eacute;s par une virgule.</li>
463                 <li><code>LastFirstFirstFirst</code>&nbsp;:
464                     Le premier auteur est format&eacute; en LastFirst&nbsp;;
465                     les auteurs suivants en FirstFirst.</li>
466         </ul>
467     </dd>
468
469     <dt><code>AuthorAbbr = [ FullName | LastName | {Initials} | InitialsNoSpace | FirstInitial | MiddleInitial]</code></dt>
470     <dd>d&eacute;finit comment les noms d'auteur sont abr&eacute;g&eacute;s.
471     <ul>
472                 <li><code>FullName</code>&nbsp;:
473                     montre les noms complets des auteurs&nbsp;;
474                     les pr&eacute;noms ne sont pas abr&eacute;g&eacute;s.</li>
475                 <li><code>LastName</code>&nbsp;:
476                     montre uniquement les noms de familles,
477                     les pr&eacute;noms sont enlev&eacute;s.</li>
478                 <li><code>Initials</code>&nbsp;:
479                     tous les pr&eacute;noms sont abr&eacute;g&eacute;s.</li>
480                 <li><code>InitialsNospace</code>&nbsp;:
481                     comme Initials, tous les espaces entre les initiales
482                     &eacute;tant enlev&eacute;s.</li>
483                 <li><code>FirstInitial</code>&nbsp;:
484                     seule la premi&egrave;re initiale est affich&eacute;e.</li>
485                 <li><code>MiddleInitial</code>&nbsp;:
486                     le premier pr&eacute;nom est affich&eacute;, mais tous les pr&eacute;noms suivants
487                     sont abr&eacute;g&eacute;s.</li>
488         </ul>
489     </dd>
490
491     <dt><code>AuthorPunc = [ {FullPunc} | NoPunc | NoComma | NoPeriod]</code></dt>
492     <dd>d&eacute;finit la ponctuation &agrave; utiliser dans la liste des auteurs
493         lorsque <code>AuthorAbbr</code> est utilis&eacute;
494         <ul>
495                 <li><code>FullPunc</code>&nbsp;:
496                     aucun changement &agrave; la ponctuation n'est effectu&eacute;.</li>
497                 <li><code>NoPunc</code>&nbsp;:
498                     tous les points et les virgules sont supprim&eacute;s du nom d'auteur.</li>
499                 <li><code>NoComma</code>&nbsp;:
500                     toutes les virgules sont supprim&eacute;es du nom d'auteur.</li>
501                 <li><code>NoPeriod</code>&nbsp;:
502                     tous les points sont supprim&eacute;s du nom d'auteur.</li>
503         </ul>
504     </dd>
505
506     <dt><code>AuthorSep = [ {Comma} | And | Colon | Semicolon | Sep=&lt;string&gt;]</code></dt>
507     <dd>d&eacute;finit le s&eacute;parateur &agrave; utiliser entre les auteurs. Tout s&eacute;parateur
508         peut &ecirc;tre sp&eacute;cifi&eacute; gr&acirc;ce &agrave; l'option <code>Sep=&lt;string&gt;</code>.</dd>
509
510     <dt><code>AuthorLastSep = [ Comma | {And} | Colon | Semicolon | Amp | Oxford | LastSep=&lt;string&gt;]</code></dt>
511     <dd>d&eacute;finit le dernier s&eacute;parateur dans la liste d'auteurs. Tout s&eacute;parateur
512         peut &ecirc;tre sp&eacute;cifi&eacute; gr&acirc;ce &agrave; l'option <code>LastSep=&lt;string&gt;</code>.</dd>
513
514     <dt><code>AuthorNumber = [ {inf} | &lt;integer&gt;]</code></dt>
515     <dd>d&eacute;finit le nombre d'auteurs devant &ecirc;tre affich&eacute;s. Si le nombre d'auteurs
516         exc&egrave;de le maximum d&eacute;fini, la liste d'auteurs est remplac&eacute;e par le
517         premier auteur suivi de <code>EtAlString</code>.</dd>
518
519     <dt><code>EtAlString = [ {et al.} | EtAl=&lt;string&gt;]</code></dt>
520     <dd>d&eacute;finit la cha&icirc;ne utilis&eacute;e pour remplacer des auteurs multiples.
521         Toute cha&icirc;ne peut &ecirc;tre sp&eacute;cifi&eacute;e en utilisant <code>EtAl=&lt;string&gt;</code></dd>
522
523     </dl>
524
525     <p>Si une option n'est pas sp&eacute;cifi&eacute;e, la valeur par d&eacute;faut (montr&eacute;e entre accolades
526         ci-dessus) est utilis&eacute;e. Ainsi, uniquement les options de mise en page
527         qui diff&egrave;re de celles par d&eacute;faut ont besoin d'&ecirc;tre d&eacute;finies.
528         L'ordre dans lequel les options sont d&eacute;finies est (en g&eacute;n&eacute;ral) indiff&eacute;rent.
529         Ainsi, par exemple,</p>
530     <p><code>\format[Authors(Initials,Oxford)]{\author}</code></p>
531     <p>est &eacute;quivalent &agrave;</p>
532     <p><code>\format[Authors(Oxford,Initials)]{\author}</code></p>
533     
534     <p>Comme mentionn&eacute;, l'ordre dans lequel les options sont d&eacute;finies est
535         indiff&eacute;rent. Il y a une possibilit&eacute; d'ambigu&iuml;t&eacute; si &agrave; la fois
536         <code>AuthorSep</code> et <code>AuthorLastSep</code> sont d&eacute;finis.
537         Dans ce cas, la premi&egrave;re valeur applicable rencontr&eacute;e devrait &ecirc;tre
538         pour <code>AuthorSep</code>, et la seconde pour <code>AuthorLastSep</code>.
539         Afin d'&eacute;viter toute ambigu&iuml;t&eacute;, lorsque la valeur par d&eacute;faut
540         est modifi&eacute;e, il est recommand&eacute; de sp&eacute;cifier les deux.
541     </p>
542
543
544     <h4>Exemples</h4>
545     <p>Pour les auteurs suivants, <i>"Joe James Doe and Mary Jane
546         and Bruce Bar and Arthur Kay"</i> ,le formateur <code>Authors</code>
547         donnera les r&eacute;sultats suivants&nbsp;:</p>
548     <dl>
549     <dt><code>Authors()</code> ou, de mani&egrave;re &eacute;quivalente,
550         <code>Authors(FirstFirst,Initials,FullPunc,Comma,And,inf,EtAl= et al.)</code></dt>
551     <dd><pre>J. J. Doe, M. Jane, B. Bar and A. Kay</pre></dd>
552
553     <dt><code>Authors(LastFirstFirstFirst,MiddleInitial,Semicolon)</code></dt>
554     <dd><pre>Doe, Joe J.; Mary Jane; Bruce Bar and Arthur Kay</pre></dd>
555
556     <dt><code>Authors(LastFirst,InitialsNoSpace,NoPunc,Oxford)</code></dt>
557     <dd><pre>Doe JJ, Jane M, Bar B, and Kay A</pre></dd>
558
559     <dt><code>Authors(2,EtAl= and others)</code></dt>
560     <dd><pre>J. J. Doe and others</pre></dd>
561     </dl>
562     <p>Les formats de citations les plus courants devraient &ecirc;tre r&eacute;alisables
563         avec ce formateur. Pour des options encore plus avanc&eacute;es, envisagez
564         d'utiliser les Formateurs personnalis&eacute;s d&eacute;taill&eacute;s ci-dessous.
565     </p>
566
567     <h3>Le formateur <code>WrapFileLinks</code></h3>
568
569     <p>
570     Ce formateur it&egrave;re sur tous les liens de fichiers, ou tous les liens de fichiers
571     d'un type particulier, renvoyant une cha&icirc;ne de formatage donn&eacute;e comme premier
572     argument. La cha&icirc;ne de formatage peut contenir un nombre de s&eacute;quences d'&eacute;chappement
573     indiquant les informations sur le lien de fichier &agrave; &ecirc;tre ins&eacute;r&eacute; dans la cha&icirc;ne.
574     </p>
575     <p>
576     Ce formateur peut prendre un second argument optionnel sp&eacute;cifiant le nom d'un type
577     de fichier. Si sp&eacute;cifi&eacute;, l'it&eacute;ration inclura uniquement les fichiers correspondant
578     au type de fichier recherch&eacute; (en &eacute;tant sensible &agrave; la casse des
579     caract&egrave;res). S'il est sp&eacute;cifi&eacute; comme un argument vide, tous les liens de fichiers
580     seront inclus.
581     </p>
582     <p>
583     Apr&egrave;s le second argument, des paires d'arguments additionnels peuvent &ecirc;tre ajout&eacute;es
584     afin de sp&eacute;cifier des expressions r&eacute;guli&egrave;res de remplacement devant &ecirc;tre ex&eacute;cut&eacute;es
585     sur les informations du lien ins&eacute;r&eacute; avant son insertion dans la cha&icirc;ne de sortie.
586     Un argument non appari&eacute; sera ignor&eacute;. Afin de sp&eacute;cifier des remplacements sans effectuer
587     de filtrage sur les types de fichiers, utilisez un second argument vide.
588     </p>
589     <p>
590     Les s&eacute;quences d'&eacute;chappement pour les informations incluses sont les suivantes&nbsp;:
591     </p>
592     <ul>
593         <li><code>\i</code>&nbsp;: Cela ins&egrave;re l'index d'it&eacute;ration (d&eacute;butant
594                 &agrave; 1), et peut &ecirc;tre utile si la liste des fichiers en sortie
595                 doit &ecirc;tre &eacute;num&eacute;r&eacute;e.</li>
596         <li><code>\p</code>&nbsp;: Cela ins&egrave;re le chemin de fichier d'un lien de fichier.</li>
597         <li><code>\f</code>&nbsp;: Cela ins&egrave;re le nom du type du lien de fichier.</li>
598         <li><code>\x</code>&nbsp;: Cela ins&egrave;re l'extension de fichier, si elle existe.</li>
599         <li><code>\d</code>&nbsp;: Cela ins&egrave;re la description du lien de fichier, si elle existe.</li>
600     </ul>
601     <p>
602     Par exemple, une entr&eacute;e pourrait contenir un lien de fichier vers le fichier    
603     "/home/john/report.pdf" de type "PDF" avec la description "John's final report".
604     En utilisant le formateur WrapFileLinks avec l'argument suivant&nbsp;:
605     </p><code>\format[WrapFileLinks(\i. \d (\p))]{\file}</code>
606     <p>donnera la sortie suivante&nbsp;:</p>
607     <pre>
608     1. John's final report (/home/john/report.pdf)
609     </pre>
610     <p>
611     Si l'entr&eacute;e contient un second lien de fichier vers le fichier "/home/john/draft.txt"
612     du type "Text file" avec la description 'An early "draft"', le sortie sera comme suit&nbsp;:</p>
613     <pre>
614     1. John's final report (/home/john/report.pdf)
615     2. An early "draft" (/home/john/draft.txt)
616
617     </pre>
618     <p>
619     Si le formateur a &eacute;t&eacute; appel&eacute; avec un second argument, la liste sera filtr&eacute;e.
620     Par exemple&nbsp;:
621     </p>
622     <p><code>\format[WrapFileLinks(\i. \d (\p),,text file)]{\file}</code></p>
623     <p>affichera uniquement le texte suivant&nbsp;:</p>
624     <pre>
625     1. An early "draft" (/home/john/draft.txt)
626
627     </pre>
628     
629     <p>
630     Si l'on veut que cette sortie soit incluse dans une sortie en style XML,
631     les guillemets dans la description de fichier pourrait causer probl&egrave;me.
632     En ajoutant deux arguments additionnels pour traduire les guillemets en
633     caract&egrave;res XML, on r&eacute;soudra ce probl&egrave;me&nbsp;:</p>
634     <p><code>\format[WrapFileLinks(\i. \d (\p),,text file,",&quot;)]{\file}
635     </code></p>
636     <p>affichera la sortie suivante&nbsp;:</p>
637     <pre>
638     1. An early &quot;draft&quot; (/home/john/draft.txt)
639
640     </pre>
641     <p>Des paires de remplacement suppl&eacute;mentaires pourraient &ecirc;tre ajout&eacute;es.</p>
642
643
644     <h3>Formateurs personnalis&eacute;s</h3>
645
646     <p>Si aucun des formateurs disponibles ne peut faire ce que
647     vous d&eacute;sirez, vous pouvez ajouter le votre &agrave;
648     l'interface
649     <code>net.sf.jabref.export.layout.LayoutFormatter</code>. Si
650     vous ins&eacute;rez votre propre classe dans
651     <code>net.sf.jabref.export.layout.format</code>, vous pouvez
652     appeler votre formateur en utilisant son nom de classe, comme
653     pour les formateurs standards. Sinon, vous devez appeler le
654     formateur par son nom complet (incluant le nom du paquetage).
655     Dans les deux cas, le formateur doit &ecirc;tre dans votre
656     chemin de classe lorsque vous lancez JabRef</p>
657
658     <h2 id="NameFormatter">Utiliser des formateurs de nom
659     personnalis&eacute;</h2>
660
661     <p>&Agrave; partir de JabRef 2.2, il est possible de
662     d&eacute;finir des formateurs de nom personnalis&eacute;s et
663     utilisant la syntaxe des fichiers de style BibTeX. Cela permet
664     une flexibilit&eacute; totale, mais c'est fastidieux &agrave;
665     &eacute;crire</p>
666
667     <p>Vous pouvez d&eacute;finir votre propre formateur dans
668     l'onglet "Formateur de nom" des pr&eacute;f&eacute;rences en
669     utilisant le format suivant et en l'utilisant ensuite avec le
670     nom que vous avez d&eacute;fini comme de n'importe quel autre
671     formateur</p>
672     <code>&lt;cas1&gt;@&lt;gamme11&gt;@&lt;format&gt;@&lt;gamme12&gt;@&lt;format&gt;@&lt;gamme13&gt;...@@<br />
673
674      &lt;cas2&gt;@&lt;gamme21&gt;@... et ainsi de suite.</code>
675
676     <p>Ce format commence par s&eacute;parer la tache de formatage
677     de la liste d'auteurs dans des cas d&eacute;pendant du nombre
678     d'auteurs qu'il y a (c'est ainsi car certains formats
679     diff&egrave;rent en fonction du nombre d'auteurs). Chaque cas
680     individuel est s&eacute;par&eacute; par @@ et contient les
681     instructions sur la fa&ccedil;on de formater chaque auteur dans
682     le cas consid&eacute;r&eacute;. Ces instructions sont
683     s&eacute;par&eacute;es par un @.</p>
684
685     <p>Les cas sont identifi&eacute;s en utilisant des entiers (1,
686     2, 3, etc.) ou le caract&egrave;re * (correspondant &agrave;
687     n'importe quel nombre d'auteurs) et sp&eacute;cifieront le
688     formateur &agrave; appliquer s'il y a un nombre
689     inf&eacute;rieur ou &eacute;gal d'auteurs.</p>
690
691     <p>Les gammes sont soit
692     <code>&lt;entier&gt;..&lt;entier&gt;</code>,
693     <code>&lt;entier&gt;</code> ou le caract&egrave;re
694     <code>*</code> en utilisant un index bas&eacute; sur 1 pour
695     indexer les auteurs d'une liste donn&eacute;e d'auteurs. Les
696     index entiers peuvent &ecirc;tre n&eacute;gatif afin de
697     signifier qu'ils commencent par la fin de la liste o&ugrave; -1
698     est le dernier auteur.</p>
699
700     <p>Par exemple, avec une liste d'auteurs comme "Joe Doe and
701     Mary Jane and Bruce Bar and Arthur Kay"&nbsp;:</p>
702
703     <ul>
704         <li>1..3 affectera Joe, Mary and Bruce</li>
705
706         <li>4..4 affectera Arthur</li>
707
708         <li>* les affectera tous</li>
709
710         <li>2..-1 affectera Mary, Bruce and Arthur</li>
711     </ul>
712
713     <p>Les cha&icirc;nes de <code>&lt;format&gt;</code> utilisent
714     le format du formateur BibTeX&nbsp;:</p>
715
716     <p>Les quatre lettres v, f, l et j indiquent les parties du nom
717     von, first, last et jr qui sont utilis&eacute;es entre
718     accolades. Une unique lettre v, f, l ou j indique que le nom
719     doit &ecirc;tre abr&eacute;g&eacute;. Si l'une de ces lettres
720     ou paires de lettres sont rencontr&eacute;es, JabRef retournera
721     tous les noms respectifs (potentiellement
722     abr&eacute;g&eacute;s), mais l'expression totale entre
723     accolades est uniquement imprim&eacute;e si la partie du nom
724     existe.</p>
725
726     <p>Par exemple, si le format est "{ll} {vv {von Part}} {ff}" et
727     si les noms sont "Mary Kay and John von Neumann", alors JabRef
728     retournera "Kay Mary" (avec deux espaces entre le nom propre et
729     le pr&eacute;nom) et "Neuman von von Part John".</p>
730
731     <p>Je donne ici deux exemples, mais je pr&eacute;f&eacute;rerai
732     vous diriger vers la documentations BibTeX.</p>
733
734     <p>Exemple court&nbsp;: <code>"{ll}, {f.}"</code> va convertir
735     <code>"Joe Doe"</code> en <code>"Doe, J."</code></p>
736
737     <p>Exemple long&nbsp;:</p>
738
739     <blockquote>
740         <p>Pour convertir&nbsp;:</p>
741
742         <p><code>"Joe Doe and Mary Jane and Bruce Bar and Arthur
743         Kay"</code></p>
744
745         <p>en</p>
746
747         <p><code>"Doe, J., Jane, M., Bar, B. and Kay,
748         A."</code></p>
749
750         <p>vous devrez utiliser</p>
751
752         <p><code>1@*@{ll}, {f}.@@2@1@{ll}, {f}.@2@ and {ll},
753         {f}.@@*@1..-3@{ll}, {f}., @-2@{ll}, {f}.@-1@ and {ll},
754         {f}.</code></p>
755     </blockquote>
756
757     <p>Si quelqu'un souhaite &eacute;crire un meilleur didacticiel
758     sur ce sujet, envoyez un courriel sur l'une des listes de
759     diffusion de JabRef&nbsp;!</p>
760
761 </body>
762 </html>