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. Sifalse,
            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 AuthorLastSeparatorpour les citations dans le texte
            telles queSmith & 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 FormatCitationsest 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é CitationCharacterFormatcontrô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 2001etp. 301dans[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 aetbdans[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.