1 <html xmlns="http://www.w3.org/1999/xhtml">
3 <link rel="stylesheet" type="text/css" href="../jabref_help.css"/>
7 <h1>Intégration dans OpenOffice/LibreOffice</h1>
11 <p>Cette fonction offre une interface pour insérer des citations et formater une
12 bibliographie dans un document OpenOffice ou LibreOffice Writer à partir
15 <p>Tout au long de ce document d'aide, lorsque le nom <i>OpenOffice</i>
16 est utilisé, il peut être remplacé par <i>LibreOffice</i>.</p>
18 <h2>Utiliser l'interface OpenOffice/LibreOffice</h2>
20 <p>Pour communiquer avec OpenOffice, JabRef doit tout d'abord se connecter à
21 une instance active d'OpenOffice. Vous devez démarrez OpenOffice et ouvrir
22 votre document avant de vous y connecter à partir de JabRef. JabRef a
23 besoin de connaître la localisation de vos exécutables OpenOffice
24 (<b>soffice.exe</b> sous Windows et <b>soffice</b> sous les autres
25 systémes d'exploitation) et le répertoire où se trouvent plusieurs fichiers
26 OpenOffice jar. Si vous lancez la connexion en cliquant sur le bouton
27 <b>Connexion automatique</b>, JabRef tentera automatiquement de déterminer ses
28 emplacements. Si cela ne fonctionne pas, vous devez établir la connexion
29 en utilisant le bouton <b>Connexion manuelle</b> qui ouvrira une
30 fenêtre vous demandant les emplacements nécessaires.</p>
32 <p>Après que la connexion ait été établie, vous pouvez insérer des citations en
33 sélectionnant une ou plusieurs entrées dans JabRef et en utilisant le bouton
34 <b>Envoyer vers OpenOffice</b> dans le menu déroulant de la barre d'outils
35 de JabRef ou en utilisant le bouton approprié dans la sous-fenêtre
36 OpenOffice du panneau latéral. Cela insérera les citations pour les entrées
37 sélectionnées à l'emplacement actuel du curseur dans le document OpenOffice
38 et mettra à jour la bibliographie afin qu'elle contienne la référence
41 <p><b>Note :</b> JabRef n'utilise pas le système de bibliographie intégré
42 à OpenOffice à cause des limitations de ce système. Un document contenant
43 des citations insérées par JabRef ne sera en général pas compatible avec
44 d'autres gestionnaires de références tels que Bibus et Zotero.</p>
46 <p>Deux types de citations différents peuvent être insérés - soit une citation
47 entre parenthèses, "(Auteur 2007)", soit une citation dans le texte
48 "Author (2007)". Cette distinction est uniquement pertinente si les
49 citations auteur-année sont utilisées au lieu des citations numérotées, mais
50 cette distinction sera conservée si vous basculer entre les deux styles.</p>
52 <p>Si vous modifiez les entrées dans JabRef après l'insertion de leurs citations
53 dans OpenOffice, vous devrez synchroniser la bibliographie. Le bouton
54 <b>Synchroniser la bibliographie OO</b> mettra à jour toutes les entrées
55 de la bibliographie tant que leurs clefs BibTeX n'ont pas été modifiées
56 (JabRef encode la clef BibTeX dans le nom de la référence pour chaque
57 citation afin de suivre quelle clef BibTeX a l'entrée JabRef originale).</p>
59 <h2>Le fichier de style</h2>
61 <p>Pour configurer le style de citation, vous devez sélectionner un style de
62 fichier ou utiliser un des styles par défaut. Le style définit le format
63 des citations et le format de la bibliographie. Vous pouvez utiliser des
64 formateurs d'exportations standards de JabRef pour traiter les champs des
65 entrées avant qu'ils soient envoyés à OpenOffice. Grâce à l'existence de ce
66 fichier de style, vous disposez d'une flexibilité aussi grande que possible
67 dans les styles de citation. Vous pouvez changer de fichier de style à
68 tout moment et utiliser le bouton <b>Mettre à jour</b> pour que votre
69 bibliographie suive ce nouveau style.</p>
70 <p>En cliquant sur le bouton <b>Sélectionner le style</b> vous pouvez ouvrir
71 une fenêtre qui permet de sélectionner soit le style par défaut soit un
72 fichier de style externe. Si vous voulez créer un nouveau style basé sur
73 celui par défaut, vous pouvez cliquer sur le bouton <b>Aperçu</b> afin
74 d'afficher le contenu du style par défaut que vous pouvez copier dans un
75 éditeur de texte et modifier.</p>
76 <p>Pour choisir un fichier de style externe, vous avez deux possibilités.
77 Soit vous choisissez directement un fichier de style, soit vous paramétrez
78 un répertoire de fichiers de style. Si vous choisissez cette dernière
79 possibilité, vous pourrez voir la liste des styles de ce répertoire (et
80 de ces sous-répertoires) et en choisir un à partir de cette liste.</p>
82 <p>Voici un exemple de fichier de style :</p>
85 Example style file for JabRef-OpenOffice integration.
93 IsSortByPosition="false"
94 IsNumberEntries="false"
95 ReferenceParagraphFormat="Default"
96 ReferenceHeaderParagraphFormat="Heading 1"
99 AuthorField="author/editor"
104 AuthorLastSeparator=" & "
108 InTextYearSeparator=" "
111 BracketBeforeInList="["
112 BracketAfterInList="]"
113 CitationSeparator="; "
114 UniquefierSeparator=","
115 GroupedNumbersSeparator="-"
116 MinimumGroupingCount="3"
117 FormatCitations="false"
118 CitationCharacterFormat="Default"
119 MultiCiteChronological="false"
120 PageInfoSeparator="; "
123 article=\format[AuthorLastFirst,AuthorAbbreviator,AuthorAndsReplacer]{\author}
124 (<b>\year\uniq</b>). <i>\title</i>, \journal \volume\begin{pages} :
125 \format[FormatPagesForHTML]{\pages}\end{pages}.
127 book=\format[AuthorLastFirst,AuthorAbbreviator,AuthorAndsReplacer]{\author}\begin{editor}
128 \format[AuthorLastFirst,AuthorAbbreviator,AuthorAndsReplacer]{\editor} (Ed.)\end{editor},
129 <b>\year\uniq</b>. <i>\title</i>. \publisher, \address.
131 incollection=\format[AuthorLastFirst,AuthorAbbreviator,AuthorAndsReplacer]{\author}
132 (<b>\year\uniq</b>). <i>\title</i>. In: \format[AuthorLastFirst,
133 AuthorAbbreviator,AuthorAndsReplacer]{\editor} (Ed.), <i>\booktitle</i>, \publisher.
135 inbook=\format[AuthorLastFirst,AuthorAbbreviator,AuthorAndsReplacer]{\author}
136 (<b>\year\uniq</b>). <i>\chapter</i>. In: \format[AuthorLastFirst,
137 AuthorAbbreviator,AuthorAndsReplacer]{\editor} (Ed.), <i>\title</i>, \publisher.
139 phdthesis=\format[AuthorLastFirst,AuthorAbbreviator,AuthorAndsReplacer]{\author}
140 (<b>\year\uniq</b>). <i>\title</i>, \school.
142 default=\format[AuthorLastFirst,AuthorAbbreviator,AuthorAndsReplacer]{\author}
143 (<b>\year\uniq</b>). <i>\title</i>, \journal \volume\begin{pages} :
144 \format[FormatPagesForHTML]{\pages}\end{pages}.
148 <p>(Notez que la mise en page de chaque type d'entrée doit être limité à
149 une seule ligne dans le fichier de style - ci-dessus, les lignes sont
150 coupées pour faciliter la lecture)</p>
152 <h3>Propriétés générales</h3>
154 <p>La section <b>PROPERTIES</b> décrit les propriétés générales de la
155 bibliographie. Le tableau ci-dessous décrit les propriétés
156 disponibles :</p>
158 <table border="1" rules="none" summary="propriétés disponibles ">
160 <td><b>Propriété</b></td>
162 <td><b>Valeur par défaut</b></td>
163 <td><b>Description</b></td>
166 <td>IsNumberEntries</td>
167 <td>booléen</td>
168 <td><code>false</code></td>
169 <td>Détermine le type de citations à utiliser. Si <code>true</code>,
170 des citations numérotées seront utilisées. Si <code>false</code>,
171 des citations auteur-année seront utilisées.
175 <td>IsSortByPosition</td>
176 <td>booléen</td>
177 <td><code>false</code></td>
178 <td>Détermine comment la bibliographie est triée. Si vrai, les entrées
179 seront triées selon l'ordre dans lequel elles sont citées. Si faux,
180 les entrées seront classées par ordre alphabétique des auteurs.
184 <td>ReferenceParagraphFormat</td>
185 <td>chaîne</td>
186 <td><code>Default</code></td>
187 <td>Donne le nom du format de paragraphe à utiliser pour la liste de
188 références. Ce format doit être défini dans votre document
193 <td>ReferenceHeaderParagraphFormat</td>
194 <td>chaîne</td>
195 <td><code>Heading 1</code></td>
196 <td>Donne le nom du format de paragraphe à utiliser pour le titre de
197 la liste de références. Ce format doit être défini dans votre document
203 <td>chaîne</td>
204 <td><code>Bibliography</code></td>
205 <td>Le texte à entrer comme titre de la liste de références.</td>
209 <h3>Propriétés des citations</h3>
211 <p>La section <b>CITATION</b> décrit le format des marqueurs de citation
212 insérés dans le texte.</p>
214 <p>Le tableau ci-dessous donne une brève description de toutes les propriétés
215 de citation disponibles. Les propriétés qui n'apparaissent pas dans le
216 fichier de style garderont leur valeur par défaut.</p>
218 <table border="1" rules="none" summary="description">
220 <td><b>Propriété</b></td>
222 <td><b>Valeur par défaut</b></td>
223 <td><b>Description</b></td>
227 <td>chaîne</td>
228 <td><code>author/editor</code></td>
229 <td>Champ BibTeX contenant les noms des auteurs. Peut contenir des
230 champs alternatifs, par exemple <code>author/editor</code></td>
233 <td>AuthorLastSeparator</td>
234 <td>chaîne</td>
235 <td><code> & </code></td>
236 <td>Texte inséré entre les deux derniers noms d'auteur.</td>
239 <td>AuthorLastSeparatorInText</td>
240 <td>chaîne</td>
242 <td>Si spécifiés, cette propriété écrase
243 <code>AuthorLastSeparator</code> pour les citations dans le texte
244 telles que <code>Smith & Jones (2001)</code>.
248 <td>AuthorSeparator</td>
249 <td>chaîne</td>
250 <td><code>, </code></td>
251 <td>Texte inséré entre les noms d'auteurs excepté pour les deux
255 <td>BracketAfter</td>
256 <td>chaîne</td>
257 <td><code>]</code></td>
258 <td>La parenthèse fermante des citations.</td>
261 <td>BracketAfterInList</td>
262 <td>chaîne</td>
264 <td>La parenthèse fermante pour la numérotation des citations dans
265 la liste des références.</td>
268 <td>BracketBefore</td>
269 <td>chaîne</td>
270 <td><code>[</code></td>
271 <td>La parenthèse ouvrante des citations.</td>
274 <td>BracketBeforeInList</td>
275 <td>chaîne</td>
277 <td>La parenthèse ouvrante pour la numérotation des citations dans
278 la liste des références.</td>
281 <td>CitationCharacterFormat</td>
282 <td>chaîne</td>
283 <td><code>Default</code></td>
284 <td>Si <code>FormatCitations</code> est mis à <code>true</code>,
285 le format de caractère ayant le nom donné par cette propriété sera
286 appliqué aux citations. Le format de caractère doit être défini
287 dans votre document OpenOffice.
291 <td>CitationSeparator</td>
292 <td>chaîne</td>
293 <td><code>; </code></td>
294 <td>Texte inséré entre les éléments quand une citation contient
295 plusieurs entrées, par exemple <code>[Smith 2001; Jones
300 <td>chaîne</td>
301 <td><code> et al. </code></td>
302 <td>Texte inséré après les noms d'auteur quand tous les auteurs ne
303 sont pas listés, par exemple <code>[Smith et al. 2001]</code></td>
306 <td>FormatCitations</td>
307 <td>booléen</td>
308 <td><code>false</code></td>
309 <td>Détermine si le formatage doit être appliqué aux citations. Si vrai,
310 un format de caractère sera appliqué aux citations. La propriété
311 <code>CitationCharacterFormat</code> contrôle quel format doit être
312 appliqué. Le format doit être défini dans votre document
313 OpenOffice. Tout paramètre et effet de caractère peut être choisit
314 dans OpenOffice pour votre format de caractère.
318 <td>GroupedNumbersSeparator</td>
319 <td>chaîne</td>
320 <td><code>-</code></td>
321 <td>Texte inséré entre les nombres quand les citations numériques sont
322 groupées, par exemple <code>[4-6]</code></td>
325 <td>InTextYearSeparator</td>
326 <td>chaîne</td>
327 <td>Single Space</td>
328 <td>Texte inséré entre les noms d'auteur et la parenthèse ouvrante
329 avant l'année dans les citations dans le texte.</td>
334 <td><code>true</code></td>
335 <td>Si <code>true</code>, la chaîne "et al." dans les marqueurs de citation est mis en italique.</td>
340 <td><code>3</code></td>
341 <td>Le nombre maximum d'auteurs à lister dans une citation qui apparaît
342 précédemment dans le document.</td>
345 <td>MaxAuthorsFirst</td>
347 <td><code>3</code></td>
348 <td>Le nombre maximum d'auteurs à lister dans une citation qui apparaît
349 pour la première fois.</td>
352 <td>MinimumGroupingCount</td>
354 <td><code>3</code></td>
355 <td>Le nombre minimum d'entrées consécutives qu'une citation doit
356 contenir avant que les nombres soient groupés, par exemple
357 <code>[4-6]</code> ou <code>[4; 5; 6]</code>.
361 <td>MultiCiteChronological</td>
362 <td>booléen</td>
363 <td><code>true</code></td>
364 <td>Si <code>true</code>, les entrées multiples d'une même citation
365 sont triées chronologiquement. Sinon, elles sont sorties
366 alphabétiquement.
370 <td>PageInfoSeparator</td>
371 <td>chaîne</td>
372 <td><code>; </code></td>
373 <td>Pour des citations avec des informations complémentaires, par exemple des numéros de page,
374 cette chaîne est insérée entre l'année (pour les citations auteur-année)
375 ou le numéro de citation (pour les citations numérotées) et les informations complémentaires.
376 Par exemple, le texte entre <code>2001</code> et <code>p. 301</code> dans <code>[Smith 2001; p. 301]</code>.
380 <td>UniquefierSeparator</td>
381 <td>chaîne</td>
382 <td><code>, </code></td>
383 <td>Texte inséré entre les lettres utilisées pour différencier les
384 citations ayant des auteurs et année similaires. Par exemple
385 le texte entre <code>a</code> et <code>b</code> dans
386 <code>[Smith 2001a, b]</code>.
391 <td>chaîne</td>
392 <td><code>year</code></td>
393 <td>Le champ BibTeX pour l'année de publication.</td>
396 <td>YearSeparator</td>
397 <td>chaîne</td>
398 <td>Single Space</td>
399 <td>Texte inséré entre les noms d'auteurs et l'année dans les citations
400 entre parenthèses telle que <code>[Smith 2001]</code>.</td>
404 <p>Si des entrées numérotées sont utilisées, les propriétés
405 <code>BracketBefore</code> et <code>BracketAfter</code> sont les plus
406 importantes - elles définissent quels caractères sont utilisés dans le numéro
407 de citation. La citation est composée ainsi :<br/>
408 <code>[BracketBefore][Number][BracketAfter]</code><br/>
409 où [Number] est le nombre dans la citation, déterminé selon l'ordre de la
410 bibliographie et/ou la position de cette citation dans le texte. Si une
411 citation correspond à plusieurs entrées, elles seront séparées par la
412 chaîne donnée dans la propriété <code>CitationSeparator</code>
413 (par exemple, si <code>CitationSeparator</code>=;, la citation
414 ressemblera à <code>[2;4;6]</code>). Si au moins deux entrées correspondent
415 à des numéros consécutifs, ces numéros seront groupés (par exemple
416 <code>[2-4]</code> pour 2, 3 and 4 ou <code>[2;5-7]</code> pour 2, 5, 6 et
417 7). La propriété <code>GroupedNumbersSeparator</code> (par défaut
418 <code>-</code>) détermine quelle chaîne sépare le premier et le dernier
419 élément des numéros groupés. La propriété entière
420 <code>MinimumGroupingCount</code> (par défaut 3) détermine quel nombre
421 de numéros consécutifs est autorisé avant que les entrées ne soient
422 groupées. Si <code>MinimumGroupingCount</code>=3, les numéros 2 et 3 ne
423 seront pas groupés, tandis que 2, 3, 4 le seront. Si
424 <code>MinimumGroupingCount</code>=0, aucun groupement ne sera effectué
425 quel que soit le nombre de numéros consécutifs.
428 <p>Si des entrées numérotées ne sont pas utilisées, des citations auteur-année
429 seront créées sur la base des propriétés de citation.
430 Une citation entre parenthèses est composée ainsi :<br/>
431 <code>[BracketBefore][Author][YearSeparator][Year][BracketAfter]</code><br/>
432 où [Author] est le résultat du ou des champs donnés dans la propriété
433 <code>AuthorField</code> et le formatage d'une liste d'auteurs.
434 Cette liste peu contenir jusqu'à <code>MaxAuthors</code> noms - s'il y en
435 à plus, la liste sera composée du premier auteur et du texte spécifié dans
436 la propriété <code>EtAlString</code>. Si la propriété
437 <code>MaxAuthorsFirst</code> est donnée, elle est prioritaire sur
438 <code>MaxAuthors</code> la première fois que chaque citation apparaît dans
441 <p>Si plusieurs champs séparés par des slashs sont donnés dans la propriété
442 <code>AuthorField</code>, ils seront considérés successivement si le premier
443 champ est vide pour l'entrée BibTeX considérée. Dans l'exemple ci-dessus,
444 le champ "author" sera utilisé ; mais, s'il est vide le champ "editor"
445 sera utilisé en remplacement.</p>
447 <p>Les noms de la liste d'auteurs seront séparés par le texte donné par la
448 propriété <code>AuthorSeparator</code>, exceptés pour les deux derniers
449 noms qui seront séparés par le texte spécifié dans
450 <code>AuthorLastSeparator</code>.
451 Si la propriété <code>AuthorLastSeparatorInText</code> est spécifiée, elle
452 remplace le précédent pour les citations du type "dans le texte". Cela
453 permet d'avoir des citations comme <code>(Olsen & Jensen, 2008)</code>
454 et <code>Olsen and Jensen (2008)</code> avec un même style.
457 <p>[Year] est la résultante du ou des champs spécifiés dans la propriété
460 <p>Une citation "dans le texte" est composée comme suit :<br/>
461 <code>[Author][InTextYearSeparator][BracketBefore][Year][BracketAfter]</code><br/>
462 où [Author] et [Year] sont traités exactement de la même façon que pour
463 les citations entre parenthèses.</p>
465 <p>Si deux sources différentes sont citées et si elles ont les mêmes auteurs
466 et années de publication, et si des citations auteur-année sont utilisées,
467 leurs appels nécessiteront une modification afin d'être rendue
468 discernables. Ceci est fait automatiquement en rajoutant une lettre après
469 l'année pour chacune de ces publications ; 'a' pour la première
470 référence citée, 'b' pour la suivante, et ainsi de suite.
471 Par exemple, si l'auteur "Olsen" a deux papiers cités pour 2005, les appels
472 de citation seront modifiés en <code>(Olsen, 2005a)</code> et
473 <code>(Olsen, 2005b)</code>. Dans la mise en page de la bibliographie,
474 l'utisation d'une lettre "singularisante" sera indiquée explicitement par
475 l'insertion du champ virtuel <code>uniq</code>.</p>
477 <p>Si plusieurs entrées ayant été "singularisées" sont citées ensemble, elles
478 seront groupées dans l'appel à référence. Par exemple, des deux entrées
479 données ci-dessus en exemple sont citées ensemble, l'appel à référence
480 sera <code>(Olsen, 2005a, b)</code> au lieu de
481 <code>Olsen, 2005a; Olsen, 2005b)</code>. Les lettres discrimantes
482 regroupées (a et b dans notre exemple) seront séparés par une chaîne
483 spécifiée par la propriété <code>UniquefierSeparator</code>.</p>
485 <p>Les citations auteur-année faisant référence à plus d'une entrée seront par
486 défaut triée chronologiquement. Si vous souhaitez qu'elles soient triées
487 alphabétiquement, la propriété de citation
488 <code>MultiCiteChronological</code> doit être paramétrée à
489 <code>false.</code>.</p>
491 <h3>Mise en page de la liste de références</h3>
493 <p>La section <b>LAYOUT</b> décrit comment doit apparaître l'entrée
494 bibliographique correspondant à chaque type d'entrée de JabRef.
495 Chaque ligne doit débuter soit avec le nom d'un type d'entrée BibTeX, soit
496 avec le mot <code>default</code>, suivi par un '='. La mise en page
497 <code>default</code> sera utilisée pour toutes les entrées où une mise
498 en page n'a pas été spécifiée.</p>
500 <p>Le reste de chaque ligne définit la mise en page, avec le texte et les
501 espaces habituels apparaissant directement dans l'entrée bibliographique.
502 Les informations provenant de l'entrée BibTeX sont insérées en ajoutant des
503 marqueurs <code>\field</code> avec le nom de fichier approprié (par exemple
504 <code>\author</code> pour insérer les noms des auteurs). Les informations
505 de formatage pour le champ peuvent être inclues ici, en suivant la syntaxe
506 de JabRef pour la mise en page d'exportation. Voir
507 <a href="http://jabref.sourceforge.net/help/fr/CustomExports.php"> la
508 documentation de JabRef sur les filtres d'exportation personnalisés</a>
509 pour plus d'informations sur les formateurs disponibles.</p>
511 <p>Si des citations auteur-année sont utilisées, vous devez spécifier
512 explicitement la position de la lettre "singularisante" qui est ajoutée
513 pour distinguer des citations similaires. Ceci est effectué en incluant
514 le champ virtuel <code>uniq</code>, typiquement juste après l'année (comme
515 montré dans l'exemple du fichier de style). Le champ <code>uniq</code> est
516 automatiquement paramétré correctement pour chaque entrée avant que son
517 texte de référence soit mis en page.</p>
519 <p>Pour spécifier le formatage dans la bibliographie, vous pouvez utiliser les
520 paires de balises de style HTML <b> </b>,
521 <i> </i>, <sup> </sup> and <sub> </sub>
522 pour définir respectivement du texte en gras, en italique, en exposant et
525 <p>Si vous utilisez des citations numérotées, le numéro de chaque entrée sera
526 automatiquement inséré au début de chaque entrée dans le liste de
527 références. Par défaut, les numéros seront mis entre les même parenthèses
528 que définies pour les citations. Les propriétés de citations optionelles
529 <code>BracketBeforeInList</code> et <code>BracketAfterInList</code>
530 remplacent <code>BracketBefore</code> et <code>BracketAfter</code> si elles
531 sont paramétrées. Elles peuvent être utilisées si vous voulez des types
532 différents de parenthèses (ou pas de parenthèses) dans votre liste de
533 références. Notez que ce ne sont pas nécessairement des parenthèses ;
534 cela peut être toute combinaison de caractères.</p>
536 <h2>Problèmes connus</h2>
539 <li>Assurez-vous d'enregistrer votre document Write dans le format
540 OpenDocument (odt). Enregistrer au format Word perdra vos marques de
541 références.</li>
542 <li>Il n'y a actuellement pas de citations basés sur des notes de bas
544 <li>Le curseur peut être mal positionné après l'insertion d'une
546 <li>Copier-coller le fichier de style en exemple directement à partir de
547 cette page donnera un fichier non utilisable. Pour éviter cela,
548 téléchargez le fichier d'exemple à partir du lien dans la section de
549 téléchargement.