Cette fonction offre une interface pour insérer des citations et formater une bibliographie dans un document OpenOffice ou LibreOffice Writer à partir de JabRef.
Tout au long de ce document d'aide, lorsque le nom OpenOffice est utilisé, il peut être remplacé par LibreOffice.
Pour communiquer avec OpenOffice, JabRef doit tout d'abord se connecter à une instance active d'OpenOffice. Vous devez démarrez OpenOffice et ouvrir votre document avant de vous y connecter à partir de JabRef. JabRef a besoin de connaître la localisation de vos exécutables OpenOffice (soffice.exe sous Windows et soffice sous les autres systémes d'exploitation) et le répertoire où se trouvent plusieurs fichiers OpenOffice jar. Si vous lancez la connexion en cliquant sur le bouton Connexion automatique, JabRef tentera automatiquement de déterminer ses emplacements. Si cela ne fonctionne pas, vous devez établir la connexion en utilisant le bouton Connexion manuelle qui ouvrira une fenêtre vous demandant les emplacements nécessaires.
Après que la connexion ait été établie, vous pouvez insérer des citations en sélectionnant une ou plusieurs entrées dans JabRef et en utilisant le bouton Envoyer vers OpenOffice dans le menu déroulant de la barre d'outils de JabRef ou en utilisant le bouton approprié dans la sous-fenêtre OpenOffice du panneau latéral. Cela insérera les citations pour les entrées sélectionnées à l'emplacement actuel du curseur dans le document OpenOffice et mettra à jour la bibliographie afin qu'elle contienne la référence complète.
Note : JabRef n'utilise pas le système de bibliographie intégré à OpenOffice à cause des limitations de ce système. Un document contenant des citations insérées par JabRef ne sera en général pas compatible avec d'autres gestionnaires de références tels que Bibus et Zotero.
Deux types de citations différents peuvent être insérés - soit une citation entre parenthèses, "(Auteur 2007)", soit une citation dans le texte "Author (2007)". Cette distinction est uniquement pertinente si les citations auteur-année sont utilisées au lieu des citations numérotées, mais cette distinction sera conservée si vous basculer entre les deux styles.
Si vous modifiez les entrées dans JabRef après l'insertion de leurs citations dans OpenOffice, vous devrez synchroniser la bibliographie. Le bouton Synchroniser la bibliographie OO mettra à jour toutes les entrées de la bibliographie tant que leurs clefs BibTeX n'ont pas été modifiées (JabRef encode la clef BibTeX dans le nom de la référence pour chaque citation afin de suivre quelle clef BibTeX a l'entrée JabRef originale).
Pour configurer le style de citation, vous devez sélectionner un style de fichier ou utiliser un des styles par défaut. Le style définit le format des citations et le format de la bibliographie. Vous pouvez utiliser des formateurs d'exportations standards de JabRef pour traiter les champs des entrées avant qu'ils soient envoyés à OpenOffice. Grâce à l'existence de ce fichier de style, vous disposez d'une flexibilité aussi grande que possible dans les styles de citation. Vous pouvez changer de fichier de style à tout moment et utiliser le bouton Mettre à jour pour que votre bibliographie suive ce nouveau style.
En cliquant sur le bouton Sélectionner le style vous pouvez ouvrir une fenêtre qui permet de sélectionner soit le style par défaut soit un fichier de style externe. Si vous voulez créer un nouveau style basé sur celui par défaut, vous pouvez cliquer sur le bouton Aperçu afin d'afficher le contenu du style par défaut que vous pouvez copier dans un éditeur de texte et modifier.
Pour choisir un fichier de style externe, vous avez deux possibilités. Soit vous choisissez directement un fichier de style, soit vous paramétrez un répertoire de fichiers de style. Si vous choisissez cette dernière possibilité, vous pourrez voir la liste des styles de ce répertoire (et de ces sous-répertoires) et en choisir un à partir de cette liste.
Voici un exemple de fichier de style :
NAME Example style file for JabRef-OpenOffice integration. JOURNALS Journal name 1 Journal name 2 PROPERTIES Title="References" IsSortByPosition="false" IsNumberEntries="false" ReferenceParagraphFormat="Default" ReferenceHeaderParagraphFormat="Heading 1" CITATION AuthorField="author/editor" YearField="year" MaxAuthors="3" MaxAuthorsFirst="3" AuthorSeparator=", " AuthorLastSeparator=" & " EtAlString=" et al." ItalicEtAl="true" YearSeparator=" " InTextYearSeparator=" " BracketBefore="[" BracketAfter="]" BracketBeforeInList="[" BracketAfterInList="]" CitationSeparator="; " UniquefierSeparator="," GroupedNumbersSeparator="-" MinimumGroupingCount="3" FormatCitations="false" CitationCharacterFormat="Default" MultiCiteChronological="false" PageInfoSeparator="; " LAYOUT article=\format[AuthorLastFirst,AuthorAbbreviator,AuthorAndsReplacer]{\author} (<b>\year\uniq</b>). <i>\title</i>, \journal \volume\begin{pages} : \format[FormatPagesForHTML]{\pages}\end{pages}. book=\format[AuthorLastFirst,AuthorAbbreviator,AuthorAndsReplacer]{\author}\begin{editor} \format[AuthorLastFirst,AuthorAbbreviator,AuthorAndsReplacer]{\editor} (Ed.)\end{editor}, <b>\year\uniq</b>. <i>\title</i>. \publisher, \address. incollection=\format[AuthorLastFirst,AuthorAbbreviator,AuthorAndsReplacer]{\author} (<b>\year\uniq</b>). <i>\title</i>. In: \format[AuthorLastFirst, AuthorAbbreviator,AuthorAndsReplacer]{\editor} (Ed.), <i>\booktitle</i>, \publisher. inbook=\format[AuthorLastFirst,AuthorAbbreviator,AuthorAndsReplacer]{\author} (<b>\year\uniq</b>). <i>\chapter</i>. In: \format[AuthorLastFirst, AuthorAbbreviator,AuthorAndsReplacer]{\editor} (Ed.), <i>\title</i>, \publisher. phdthesis=\format[AuthorLastFirst,AuthorAbbreviator,AuthorAndsReplacer]{\author} (<b>\year\uniq</b>). <i>\title</i>, \school. default=\format[AuthorLastFirst,AuthorAbbreviator,AuthorAndsReplacer]{\author} (<b>\year\uniq</b>). <i>\title</i>, \journal \volume\begin{pages} : \format[FormatPagesForHTML]{\pages}\end{pages}.
(Notez que la mise en page de chaque type d'entrée doit être limité à une seule ligne dans le fichier de style - ci-dessus, les lignes sont coupées pour faciliter la lecture)
La section PROPERTIES décrit les propriétés générales de la bibliographie. Le tableau ci-dessous décrit les propriétés disponibles :
Propriété | Type | Valeur par défaut | Description |
IsNumberEntries | booléen | false |
Détermine le type de citations à utiliser. Si true ,
des citations numérotées seront utilisées. Si false ,
des citations auteur-année seront utilisées.
|
IsSortByPosition | booléen | false |
Détermine comment la bibliographie est triée. Si vrai, les entrées seront triées selon l'ordre dans lequel elles sont citées. Si faux, les entrées seront classées par ordre alphabétique des auteurs. |
ReferenceParagraphFormat | chaîne | Default |
Donne le nom du format de paragraphe à utiliser pour la liste de références. Ce format doit être défini dans votre document OpenOffice. |
ReferenceHeaderParagraphFormat | chaîne | Heading 1 |
Donne le nom du format de paragraphe à utiliser pour le titre de la liste de références. Ce format doit être défini dans votre document OpenOffice. |
Title | chaîne | Bibliography |
Le texte à entrer comme titre de la liste de références. |
La section CITATION décrit le format des marqueurs de citation insérés dans le texte.
Le tableau ci-dessous donne une brève description de toutes les propriétés de citation disponibles. Les propriétés qui n'apparaissent pas dans le fichier de style garderont leur valeur par défaut.
Propriété | Type | Valeur par défaut | Description |
AuthorField | chaîne | author/editor |
Champ BibTeX contenant les noms des auteurs. Peut contenir des
champs alternatifs, par exemple author/editor |
AuthorLastSeparator | chaîne | & |
Texte inséré entre les deux derniers noms d'auteur. |
AuthorLastSeparatorInText | chaîne | Si spécifiés, cette propriété écrase
AuthorLastSeparator pour les citations dans le texte
telles que Smith & Jones (2001) .
|
|
AuthorSeparator | chaîne | , |
Texte inséré entre les noms d'auteurs excepté pour les deux derniers. |
BracketAfter | chaîne | ] |
La parenthèse fermante des citations. |
BracketAfterInList | chaîne | ] | La parenthèse fermante pour la numérotation des citations dans la liste des références. |
BracketBefore | chaîne | [ |
La parenthèse ouvrante des citations. |
BracketBeforeInList | chaîne | [ | La parenthèse ouvrante pour la numérotation des citations dans la liste des références. |
CitationCharacterFormat | chaîne | Default |
Si FormatCitations est mis à true ,
le format de caractère ayant le nom donné par cette propriété sera
appliqué aux citations. Le format de caractère doit être défini
dans votre document OpenOffice.
|
CitationSeparator | chaîne | ; |
Texte inséré entre les éléments quand une citation contient
plusieurs entrées, par exemple [Smith 2001; Jones
2002] |
EtAlString | chaîne | et al. |
Texte inséré après les noms d'auteur quand tous les auteurs ne
sont pas listés, par exemple [Smith et al. 2001] |
FormatCitations | booléen | false |
Détermine si le formatage doit être appliqué aux citations. Si vrai,
un format de caractère sera appliqué aux citations. La propriété
CitationCharacterFormat contrôle quel format doit être
appliqué. Le format doit être défini dans votre document
OpenOffice. Tout paramètre et effet de caractère peut être choisit
dans OpenOffice pour votre format de caractère.
|
GroupedNumbersSeparator | chaîne | - |
Texte inséré entre les nombres quand les citations numériques sont
groupées, par exemple [4-6] |
InTextYearSeparator | chaîne | Single Space | Texte inséré entre les noms d'auteur et la parenthèse ouvrante avant l'année dans les citations dans le texte. |
ItalicEtAl | boolean | true |
Si true , la chaîne "et al." dans les marqueurs de citation est mis en italique. |
MaxAuthors | integer | 3 |
Le nombre maximum d'auteurs à lister dans une citation qui apparaît précédemment dans le document. |
MaxAuthorsFirst | integer | 3 |
Le nombre maximum d'auteurs à lister dans une citation qui apparaît pour la première fois. |
MinimumGroupingCount | integer | 3 |
Le nombre minimum d'entrées consécutives qu'une citation doit
contenir avant que les nombres soient groupés, par exemple
[4-6] ou [4; 5; 6] .
|
MultiCiteChronological | booléen | true |
Si true , les entrées multiples d'une même citation
sont triées chronologiquement. Sinon, elles sont sorties
alphabétiquement.
|
PageInfoSeparator | chaîne | ; |
Pour des citations avec des informations complémentaires, par exemple des numéros de page,
cette chaîne est insérée entre l'année (pour les citations auteur-année)
ou le numéro de citation (pour les citations numérotées) et les informations complémentaires.
Par exemple, le texte entre 2001 et p. 301 dans [Smith 2001; p. 301] .
|
UniquefierSeparator | chaîne | , |
Texte inséré entre les lettres utilisées pour différencier les
citations ayant des auteurs et année similaires. Par exemple
le texte entre a et b dans
[Smith 2001a, b] .
|
YearField | chaîne | year |
Le champ BibTeX pour l'année de publication. |
YearSeparator | chaîne | Single Space | Texte inséré entre les noms d'auteurs et l'année dans les citations
entre parenthèses telle que [Smith 2001] . |
Si des entrées numérotées sont utilisées, les propriétés
BracketBefore
et BracketAfter
sont les plus
importantes - elles définissent quels caractères sont utilisés dans le numéro
de citation. La citation est composée ainsi :
[BracketBefore][Number][BracketAfter]
où [Number] est le nombre dans la citation, déterminé selon l'ordre de la
bibliographie et/ou la position de cette citation dans le texte. Si une
citation correspond à plusieurs entrées, elles seront séparées par la
chaîne donnée dans la propriété CitationSeparator
(par exemple, si CitationSeparator
=;, la citation
ressemblera à [2;4;6]
). Si au moins deux entrées correspondent
à des numéros consécutifs, ces numéros seront groupés (par exemple
[2-4]
pour 2, 3 and 4 ou [2;5-7]
pour 2, 5, 6 et
7). La propriété GroupedNumbersSeparator
(par défaut
-
) détermine quelle chaîne sépare le premier et le dernier
élément des numéros groupés. La propriété entière
MinimumGroupingCount
(par défaut 3) détermine quel nombre
de numéros consécutifs est autorisé avant que les entrées ne soient
groupées. Si MinimumGroupingCount
=3, les numéros 2 et 3 ne
seront pas groupés, tandis que 2, 3, 4 le seront. Si
MinimumGroupingCount
=0, aucun groupement ne sera effectué
quel que soit le nombre de numéros consécutifs.
Si des entrées numérotées ne sont pas utilisées, des citations auteur-année
seront créées sur la base des propriétés de citation.
Une citation entre parenthèses est composée ainsi :
[BracketBefore][Author][YearSeparator][Year][BracketAfter]
où [Author] est le résultat du ou des champs donnés dans la propriété
AuthorField
et le formatage d'une liste d'auteurs.
Cette liste peu contenir jusqu'à MaxAuthors
noms - s'il y en
à plus, la liste sera composée du premier auteur et du texte spécifié dans
la propriété EtAlString
. Si la propriété
MaxAuthorsFirst
est donnée, elle est prioritaire sur
MaxAuthors
la première fois que chaque citation apparaît dans
le texte.
Si plusieurs champs séparés par des slashs sont donnés dans la propriété
AuthorField
, ils seront considérés successivement si le premier
champ est vide pour l'entrée BibTeX considérée. Dans l'exemple ci-dessus,
le champ "author" sera utilisé ; mais, s'il est vide le champ "editor"
sera utilisé en remplacement.
Les noms de la liste d'auteurs seront séparés par le texte donné par la
propriété AuthorSeparator
, exceptés pour les deux derniers
noms qui seront séparés par le texte spécifié dans
AuthorLastSeparator
.
Si la propriété AuthorLastSeparatorInText
est spécifiée, elle
remplace le précédent pour les citations du type "dans le texte". Cela
permet d'avoir des citations comme (Olsen & Jensen, 2008)
et Olsen and Jensen (2008)
avec un même style.
[Year] est la résultante du ou des champs spécifiés dans la propriété [YearField].
Une citation "dans le texte" est composée comme suit :
[Author][InTextYearSeparator][BracketBefore][Year][BracketAfter]
où [Author] et [Year] sont traités exactement de la même façon que pour
les citations entre parenthèses.
Si deux sources différentes sont citées et si elles ont les mêmes auteurs
et années de publication, et si des citations auteur-année sont utilisées,
leurs appels nécessiteront une modification afin d'être rendue
discernables. Ceci est fait automatiquement en rajoutant une lettre après
l'année pour chacune de ces publications ; 'a' pour la première
référence citée, 'b' pour la suivante, et ainsi de suite.
Par exemple, si l'auteur "Olsen" a deux papiers cités pour 2005, les appels
de citation seront modifiés en (Olsen, 2005a)
et
(Olsen, 2005b)
. Dans la mise en page de la bibliographie,
l'utisation d'une lettre "singularisante" sera indiquée explicitement par
l'insertion du champ virtuel uniq
.
Si plusieurs entrées ayant été "singularisées" sont citées ensemble, elles
seront groupées dans l'appel à référence. Par exemple, des deux entrées
données ci-dessus en exemple sont citées ensemble, l'appel à référence
sera (Olsen, 2005a, b)
au lieu de
Olsen, 2005a; Olsen, 2005b)
. Les lettres discrimantes
regroupées (a et b dans notre exemple) seront séparés par une chaîne
spécifiée par la propriété UniquefierSeparator
.
Les citations auteur-année faisant référence à plus d'une entrée seront par
défaut triée chronologiquement. Si vous souhaitez qu'elles soient triées
alphabétiquement, la propriété de citation
MultiCiteChronological
doit être paramétrée à
false.
.
La section LAYOUT décrit comment doit apparaître l'entrée
bibliographique correspondant à chaque type d'entrée de JabRef.
Chaque ligne doit débuter soit avec le nom d'un type d'entrée BibTeX, soit
avec le mot default
, suivi par un '='. La mise en page
default
sera utilisée pour toutes les entrées où une mise
en page n'a pas été spécifiée.
Le reste de chaque ligne définit la mise en page, avec le texte et les
espaces habituels apparaissant directement dans l'entrée bibliographique.
Les informations provenant de l'entrée BibTeX sont insérées en ajoutant des
marqueurs \field
avec le nom de fichier approprié (par exemple
\author
pour insérer les noms des auteurs). Les informations
de formatage pour le champ peuvent être inclues ici, en suivant la syntaxe
de JabRef pour la mise en page d'exportation. Voir
la
documentation de JabRef sur les filtres d'exportation personnalisés
pour plus d'informations sur les formateurs disponibles.
Si des citations auteur-année sont utilisées, vous devez spécifier
explicitement la position de la lettre "singularisante" qui est ajoutée
pour distinguer des citations similaires. Ceci est effectué en incluant
le champ virtuel uniq
, typiquement juste après l'année (comme
montré dans l'exemple du fichier de style). Le champ uniq
est
automatiquement paramétré correctement pour chaque entrée avant que son
texte de référence soit mis en page.
Pour spécifier le formatage dans la bibliographie, vous pouvez utiliser les paires de balises de style HTML <b> </b>, <i> </i>, <sup> </sup> and <sub> </sub> pour définir respectivement du texte en gras, en italique, en exposant et en indice.
Si vous utilisez des citations numérotées, le numéro de chaque entrée sera
automatiquement inséré au début de chaque entrée dans le liste de
références. Par défaut, les numéros seront mis entre les même parenthèses
que définies pour les citations. Les propriétés de citations optionelles
BracketBeforeInList
et BracketAfterInList
remplacent BracketBefore
et BracketAfter
si elles
sont paramétrées. Elles peuvent être utilisées si vous voulez des types
différents de parenthèses (ou pas de parenthèses) dans votre liste de
références. Notez que ce ne sont pas nécessairement des parenthèses ;
cela peut être toute combinaison de caractères.