Citations et références en sciences naturelle (schémas auteur–année ou numérique)

Patrick W. Daly^{∗}

Ce papier décrit le package natbib version 7.0 du 1999/05/28.

Résumé

Le package natbib est une réimplementation de la commande L^{A}TEX \cite, pour fonctionner à la fois avec les citations auteurs–date et les citations numériques.

Il est compatible avec les styles bibliographiques standard, tels que

plain.bst, ainsi qu’avec ceux pour harvard, apalike, chicago, astron,
authordate et bien sûr natbib.

Au contraire des packages cités ci-dessus, le package natbib supporte non seulement les divers styles de bibliographie auteur–année, mais également ceux pour les citations numériques standards. En fait, il peut aussi produire des citations numériques même avec un style bibliographique auteur–année, quelque chose qui permet un passage facile d’un mode de citation à l’autre. Dans ce but, des remplacements pour les fichiers .bst standard de L^{A}TEX sont également fournis.

Il est possible de définir le style de citation (type de crochets autour et de ponctuation entre les citations) et même de l’associer au nom du style bibliographique afin qu’il soit automatiquement activé. Les styles de citation peuvent être définis pour des fichiers .bst locaux au moyen d’un fichier de configuration natbib.cfg.

Ce package est compatible avec les packages : babel, index, showkeys, chapterbib, hyperref, koma et avec les classes de document amsbook et amsart. Il peut également émuler les fonctions de tri et de compression du paquetage cite (avec lequel il est par contre incompatible).

Le package natbib agit donc comme une interface unique, souple, pour la plupart des styles bibliographiques disponibles.

∗Traduction Jean-Pierre Drucbert, amendée par Nicolas Le Novère le 12 avril 2000.

Titre original : Natural Sciences Citations and References (Author–Year and Numerical Schemes)

Table des matières

1 Introduction 3

2 Solutions antérieures 3 2.1 Le style natsci.bst . . . . . . . . . . . . . . . . . . . . . . . . . . 3 2.2 Le style apalike.bst . . . . . . . . . . . . . . . . . . . . . . . . . 4 2.3 Le style newapa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 2.4 La famille Harvard . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2.5 Le style Astronomie . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2.6 Les styles authordate . . . . . . . . . . . . . . . . . . . . . . . . . 5

3 Le système natbib 6

4 Utilisation du present package 6 4.1 Nouveaux styles de bibliographie . . . . . . . . . . . . . . . . . . . 6 4.2 Commandes de citation basiques . . . . . . . . . . . . . . . . . . . 7 4.3 Commandes étendues de citation . . . . . . . . . . . . . . . . . . . 8 4.4 Forcer les noms en majuscules . . . . . . . . . . . . . . . . . . . . . 9 4.5 Alias de citation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 4.6 Références sans auteur et sans année . . . . . . . . . . . . . . . . . 10 4.7 Dispositifs supplémentaires dans la famille plainnat . . . . . . . . 11 4.8 Sélection de la ponctuation pour les citations . . . . . . . . . . . . 11 4.9 Priorité des commandes de style . . . . . . . . . . . . . . . . . . . 13 4.10 Autres options de mise en forme . . . . . . . . . . . . . . . . . . . 13 4.11 Indexation automatique des citations . . . . . . . . . . . . . . . . . 14 4.12 Compatibilité avec HyperTEX . . . . . . . . . . . . . . . . . . . . . 15 4.13 Bibliographies multiples dans un même document . . . . . . . . . . 15

4.13.1 Considérations spéciales pour natbib et chapterbib …. 15 4.14 Tri et compression des citations numériques . . . . . . . . . . . . . 16 4.15 Liste longue des auteurs lors de la première citation . . . . . . . . 16

5 Citations numériques avec les styles auteur–année 17 5.1 Sélection du mode numérique . . . . . . . . . . . . . . . . . . . . . 17

6 Configuration locale 18

7 Options avec L^{A}TEX 2ε 18

8 Comme module de styles spécifiques de journaux 19

9 Résumé 19

10 Options avec docstrip 19

1 Introduction

Le premier problème de l’utilisation des citations auteur–année avec le L^{A}TEX standard est que les deux formes de citations ne sont pas supportées. Ce sont les formes :

textuelle : … comme le montre Jones et al. (1990) … parenthésée : Il a été montré (Jones et al., 1990) que …

Il n’y a qu’une seule commande \cite pour faire les deux travaux.

Un deuxième problème est que l’environnement thebibliography, pour lister les références, insiste pour inclure les labels dans la liste. Ces labels sont normalement les numéros, nécessaires pour référencer. Dans le système auteur–année, ils sont superflus^{1} et devraient être laissés de côté. Donc, si l’on construisait une bibliographie avec l’auteur–année comme label, comme dans

      \begin{thebibliography}{...}
      \bibitem[Jones et all., 1990]{jon90}
      Jones, P. K., . . .
      \end{thebibliography}

alors \cite{jon90} produit la citation parenthésée [Jones et al., 1990], mais il n’y a pas moyen d’obtenir la citation textuelle. De plus, le texte de citation sera aussi inclus dans la liste des références.

Le problème final est de trouver un style de bibliographie BibTEX qui conviendra.

2 Solutions antérieures

Cette section peut ne pas intéresser tous les utilisateurs. Pour savoir comment utiliser natbib sans avoir à lire le contexte historique, sautez à la section 4.

Bien que le mode de citation auteur–année ne soit pas supporté par le L^{A}TEX standard, il y a un certain nombre de packages dans les contributions qui essayent de résoudre ce problème. Les divers styles bibliographiques (fichiers .bst) qui existent sont habituellement conçus pour être utilisés avec un package L^{A}TEX particulier.

J’ai trouvé sur les serveurs un grand nombre de fichiers .bst qui peuvent servir d’indicateurs des divers systèmes disponibles^{2}.

2.1 Le style natsci.bst

Ce qui me donna ma première inspiration fut le style natsci.bst dû à Stephen Gildea à utiliser avec son package agujgr.sty. Ceci me montra que le problème était soluble. Cependant le style de Gildea met en page \bibitem exactement comme je l’ai illustré au-dessus : avec un label optionnel formé des auteurs abrégés et de l’année. Donc seules les citations parenthésées peuvent être adaptées. La liste des références, cependant, est corrigée dans ses fichiers de style.

1NdT : c’est l’opinion de l’auteur, Patrick W. Daly.

2NdT : les commentaires sur ces différents styles sont ceux de l’auteur, Patrick W. Daly.

2.2 Le style apalike.bst

Oren Patashnik, l’auteur de BibTEX et des fichiers .bst standards, a aussi travaillé sur un style auteur–année, appelé apalike.bst, avec un package correspondant apalike.sty pour le supporter. Ici encore, seule la citation sous forme parenthésée est fournie. Excepté le fait que son style fonctionne avec la version 0.99 de BibTEX, sa fonctionnalité est identique à celle des fichiers natsci.

Patashnik n’aime pas les citations auteur–année. Il le dit très clairement dans ses manuels BibTEX et dans l’en-tête de apalike.bst. Néanmoins, nous devons respecter son travail dans ce domaine, simplement parce qu’il devrait être le meilleur expert en matière de BibTEX. Donc apalike.bst devrait être la base pour d’autre styles.

La forme des entrées de thebibliography dans ce système est

     \bibitem[Jones et al., 1990]{jon90}...

la même que j’ai illustré plus haut. C’est la forme minimale qui peut être donnée. Je la nomme variante apalike, d’après apalike.bst et apalike.sty de Patashnik. Cependant il pourrait y avoir beaucoup de fichiers .bst indépendants qui suivent cette voie. Les fichiers de styles bibliographiques appartenant à ce groupe comprennent :

     apalike, apalike2, cea, cell, jmb, phapalik, phppcf, phrmp

2.3 Le style newapa

Un progrès majeur a été accompli avec newapa.bst et le package associé par Stephen N. Spencer et Young U. Ryu. Avec leur système, trois éléments distincts d’information sont inclus dans le label de \bibitem, pour être utilisés à la demande. Ce sont : la liste complète des auteurs, la liste abrégée et l’année. Ceci est effectué au moyen d’une commande \citeauthoryear incluse dans le label, comme par exemple

     \bibitem[\protect\citeauthoryear{Jones, Barker,
       and Williams}{Jones et al.}{1990}]{jon90}...

En fait, ceci ne fait qu’illustrer la structure de base de \citeauthoryear ; les fichiers newapa vont encore plus loin en remplaçant certains mots et signes de ponctuation par des commandes. Par exemple, le mot « and » ci-dessus est en réalité \betweenauthors, quelque chose qui doit être défini dans le fichier .sty. Bien sûr, \citeauthoryear est aussi défini dans ce fichier. Un certain nombre de commandes \cite sont disponibles pour imprimer la citation avec la liste complète des auteurs, avec la liste courte, avec ou sans la date, sous la forme textuelle ou parenthésée.

Donc l’entrée \citeauthoryear dans \bibitem est très souple, ce qui permet au fichier de style d’engendrer chaque forme de citation que l’on peut souhaiter. Elle est utilisée par de nombreux autres styles, avec les fichiers .sty correspondants. Ils semblent tous avoir été inspirés par newapa.bst, bien qu’il leur manque les commandes supplémentaires de ponctuation.

Les fichiers de styles bibliographiques appartenant au groupe newapa comprennent :

     newapa, chicago, chicagoa, jas99, named

Note : le dernier de ces styles, named.bst, utilise \citeauthoryear d’une manière légèrement différente, avec seulement deux arguments : la liste courte et l’année.

2.4 La famille Harvard

Le même effet est réalisé selon une approche différente dans la famille de styles bibliographiques Harvard. Ici un substitut de \bibitem est utilisé, comme dans

     \harvarditem[Jones et al.]{Jones, Baker, and
        Williams}{1990}{jon90}...

Le package d’interface associé s’appelle harvard.sty et a été écrit par Peter Williams et Thorsten Schnier. Il définit \harvarditem ainsi que les commandes de citation \cite, pour les citations parenthésées et \citeasnoun pour les citations textuelles. La première citation utilise la liste longue des auteurs, les suivantes la liste plus courte, si elle a été donnée dans l’argument optionnel de

\harvarditem.

Les fichiers de styles bibliographiques appartenant à la famille Harvard sont :

     agsm, dcu, kluwer

Ce package a été mis à jour pour L^{A}TEX 2ε, avec de nombreux ajouts pour la souplesse. Le résultat est une interface puissante qui devrait satisfaire la plupart des besoins concernant les citations (il ne supprime cependant pas les auteurs répétés, comme le fait natbib).

2.5 Le style Astronomie

Réalisant apparemment les limitations de son système apalike, Oren Patashnik entreprit de développer un « vrai » style bibliographique apa, en faisant usage de la méthode déjà employée par un journal d’astronomie. Celui-ci est en fait très semblable au label créé par newapa mais avec seulement la liste courte des auteurs :

     \bibitem[\protect\astroncite{Jones et al.}{1990}]{jon90}
        ...

Il nécessite le package astron.sty ou tout autre package qui définisse \astroncite de manière appropriée. Les fichiers de styles bibliographiques appartenant au groupe astronomie sont :

     apa, astron, bbs, cbe, humanbio, humannat, jtb

Ceci est aussi bon que la commande \citeauthoryear, bien que moins souple car il manque la liste complète des auteurs.

2.6 Les styles authordate

Enfin, j’ai également trouvé quelques packages qui font usage d’une commande de label appelée \citename sous la forme

     \bibitem[\protect\citename{Jones et al., }1990]{jon90}
         ...

Ce n’est pas un bon système parce que la liste des auteurs et la date ne sont pas nettement séparées en tant qu’arguments individuels et parce que la ponctuation est incluse dans le texte du label. Il est préférable de conserver la ponctuation totalement retirée, faisant partie des définitions dans le fichier .sty, afin d’avoir une souplesse complète.

Les styles bibliographiques appartenant à ce groupe sont :

     authordate1, authordate2, authordate3, authordate4, aaai-named
avec les packages authordate1-4.sty.

3 Le système natbib

La forme de l’entrée \bibitem que j’ai utilisé pour tous mes styles bibliographiques est seulement légèrement plus compliquée que la forme minimale, mais elle permet une séparation claire entre les auteurs et la date :

     \bibitem[Jones et al.(1990)]{jon90}...

ou alternativement

     \bibitem[Jones et al.(1990)Jones, Baker,
         and Williams]{jon90}...

(Une faiblesse du format natbib est qu’il échoue si la liste d’auteurs contient elle-même des parenthèses ! Ceci peut être corrigé si la liste des auteurs est placée entre accolades.)

Je voulais appeler ce système quelque chose comme « natural sciences bibliography », ayant l’intention d’en faire une variante de natsci.sty. Puisque ce nom était déjà pris, j’ai dû prendre le nom quelque peu cryptique, et définitivement laid, de natbib.

Le package natbib.sty^{3} supporte non seulement mon propre format pour \bibitem, mais aussi tous les autres décrits dans ce chapitre, plus les modes de citation numériques. Les données supplémentaires concernant le style de citation (type de crochets, virgules ou points-virgules entre les citations) peuvent être définies une fois pour toutes pour chaque fichier .bst et n’ont jamais besoin d’être explicitement notifiées dans le texte source. Les commandes \cite et leur syntaxe sont toujours celles de natbib, même lorsqu’elles sont utilisées avec un fichier .bst comme chicago.bst qui aurait normalement un autre jeu de commandes (définies dans le package chicago.sty). Le résultat est un seul package L^{A}TEX pour traiter tous les styles bibliographiques d’une manière uniforme.

Tous les fichiers de style bibliographique auteur–année peuvent aussi être utilisés pour des citations numériques, en sélectionnant simplement le mode de l’une des manières décrites aux sections 4.8 et 7. Il n’est pas possible d’employer des citations auteur-année avec des fichiers .bst purement numérique, et ce ne le sera jamais. Voir la section 5 pour plus d’informations.

4 Utilisation du present package

Dans ce papier, je fais la distinction entre le mode de citation (auteur–année ou numérique) et le style de citation (le type de ponctuation utilisé pour les citations). Le style de citation est quelque chose qui est indépendant du style de bibliographie et n’est pas programmé dans les fichiers .bst.

4.1 Nouveaux styles de bibliographie

Je fournis trois nouveaux fichiers .bst pour remplacer les numériques standards de L^{A}TEX :

     plainnat.bst     abbrvnat.bst     unsrtnat.bst

Ces styles produisent des listes de références dans le même style que le fichier .bst standard correspondant, mais fonctionnent avec natbib. L’avantage est qu’ils peuvent être utilisés en mode numérique et en mode auteur–année.

3précedemment appelé un fichier de style selon l’ancienne terminologie de L^{A}TEX 2.09

Ces fichiers .bst ne prétendent en aucune manière être exhaustifs. D’autres fichiers de style se conformant au format natbib existent, ou peuvent être engendrés par le programme custom-bib (aussi connue sous le nom de makebst.

4.2 Commandes de citation basiques

\citet Le package natbib offre deux commandes basiques de citation, \citet et \citep \citep pour les citations textuelles et parenthésées respectivement. Il existe aussi

les formes étoilées \citet* et \citep* qui impriment la liste complète des auteurs, et pas seulement la liste abrégée. Toutes ces commandes acceptent un ou deux arguments optionnels qui ajoutent du texte avant et après la citation.

\citet{jon90}  ⇒ Jones et al. (1990)
\citet[chap.~2]{jon90}  ⇒ Jones et al. (1990, chap. 2)
\citep{jon90}  ⇒ (Jones et al., 1990)
\citep[chap.~2]{jon90}  ⇒ (Jones et al., 1990, chap. 2)
\citep[see][]{jon90}  ⇒ (see Jones et al., 1990)
\citep[see][chap.~2]{jon90} ⇒ (see Jones et al., 1990, chap. 2)
\citet*{jon90}  ⇒ Jones, Baker, and Williams (1990)
\citep*{jon90}  ⇒ (Jones, Baker, and Williams, 1990)

Les formes étoilées ne peuvent lister la liste complète des auteurs que si le fichier .bst supporte cette possibilité ; sinon la liste abrégée est imprimée.

En L^{A}TEX standard, la commande \cite ne peut prendre qu’un seul argument optionnel pour une note après la citation ; ici un seul texte optionnel est une note postérieure, tandis que deux donnent une note antérieure et une note postérieure. Pour avoir seulement une note antérieure, il suffit de fournir une note postérieure vide, comme indiqué ci-dessus.

Des mélanges plus complexes de texte et citations peuvent être engendrés par la commande à tout faire \citetext de la section 4.3.

Les citations multiples peuvent se faire en incluant plus d’une clé de citation dans l’argument de la commande \cite. Si des citations adjacentes désignent les mêmes auteurs mais des années différentes, alors les noms d’auteurs ne sont pas répétés.

\citet{jon90,jam91}  ⇒ Jones et al. (1990) ; James et al. (1991)
\citep{jon90,jam91}  ⇒ (Jones et al., 1990 ; James et al. 1991)
\citep{jon90,jon91}  ⇒ (Jones et al., 1990, 1991)

      \citep{jon90a,jon90b} ⇒ (Jones et al., 1990a,b)

Ces exemples sont pour le mode de citation auteur–année. En mode numérique, les résultats sont différents.

\citet{jon90}  ⇒ Jones et al. [21]

      \citet[chap.~2]{jon90}  ⇒ Jones et al. [21, chap. 2]
      \citep{jon90}  ⇒ [21]
      \citep[chap.~2]{jon90}  ⇒ [21, chap. 2]
      \citep[see][]{jon90}  ⇒ [see 21]
      \citep[see][chap.~2]{jon90} ⇒ [see 21, chap. 2]
      \citep{jon90a,jon90b}  ⇒ [21, 32]

Les auteurs ne peuvent être listés que si le fichier .bst supporte les citations auteurs–année. Les fichiers .bst standard, comme plain.bst, sont uniquement numériques et ne transmettent aucune information auteur–année à L^{A}TEX. Dans ce cas, \citet imprime « (author ?) [21] ».

\cite Dans les versions originales de natbib, la commande traditionnelle \cite était utilisée à la fois pour les citations textuelles et parenthésées. La présence d’un texte optionnel vide entre crochets droits signalait le cas parenthésé. Cette syntaxe a été retenue dans un souci de compatibilité, mais elle n’est plus conseillée.

Ceci signifie que \cite (sans notes) est identique à \citet dans le mode auteur–année, tandis qu’en mode numérique, elle est identique à \citep. La forme étoilée, comme la syntaxe avec une ou deux notes optionnelles, peut aussi être utilisée.

Il est possible d’avoir des citations multiples triées dans le même ordre que leur apparition dans la liste des références, quelque soit leur ordre en tant qu’arguments des commandes \cite. L’option sort est nécessaire pour cela ; voir la section 4.14.

Certaines maisons d’édition demandent que la première citation de toute référence donnée soit imprimée avec la liste complète des auteurs, mais que les citations ultérieures le soient toutes avec la liste abrégée. Il suffit d’ajouter l’option longnamesfirst pour activer cela pour natbib. Voir la section 4.15.

4.3 Commandes étendues de citation

\citealt Comme autre forme de citation, \citealt est analoque à \citet mais sans

\citealp
\citetext

aucune parenthèse, De même, \citealp est \citep sans les parenthèses. Les références multiples, les notes et les formes étoilées existent aussi.

      \citealt{jon90}  ⇒ Jones et al. 1990

\citealt*{jon90}  ⇒ Jones, Baker, and Williams 1990
\citealp{jon90}  ⇒ Jones et al., 1990
\citealp*{jon90}  ⇒ Jones, Baker, and Williams, 1990
\citealp{jon90,jam91}  ⇒ Jones et al., 1990 ; James et al., 1991

      \citealp[pg.~32]{jon90} ⇒ Jones et al., 1990, pg. 32
      \citetext{priv.\ comm.} ⇒ (priv. comm.)

La commande \citetext permet de placer du texte arbitraire dans les parenthèses courantes de citation. Ceci peut être utilisé en combinaison avec \citealp. Par exemple,

 \citetext{voir \citealp{jon90},
   ou encore mieux \citealp{jam91}}

pour produire (voir Jones et al., 1990, ou encore mieux James et al., 1991).

\citeauthor Dans les schémas auteur–année, il est parfois souhaitable de pouvoir faire réfé-

\citeyear
\citeyearpar
\citefullauthor

rence aux auteurs sans l’année, ou vice versa. Ceci est obtenu grâce aux commandes supplémentaires

      \citeauthor{jon90} ⇒ Jones et al.

\citeauthor*{jon90} ⇒ Jones, Baker, and Williams

      \citeyear{jon90}  ⇒ 1990
      \citeyearpar{jon90} ⇒ (1990)

Il existe aussi une commande \citefullauthor qui est équivalente à \citeauthor*.

Si les informations complètes sur les auteurs sont manquantes, alors \citeauthor* est identique à \citeauthor, n’imprimant que la liste abrégée. Ceci s’applique également aux formes étoilées de \citet et \citep.

Si l’information auteur ou année est manquante (comme c’est le cas avec les fichiers .bst du L^{A}TEX standard), ces commandes émettent un avertissement.

Note : ces commandes peuvent aussi être utilisées avec des citations numériques, pourvu qu’un fichier .bst auteur–année soit utilisé.

Note : toutes les commandes \cite... ont la même syntaxe, permettant les citations multiples et au plus deux notes (il n’y a cependant pas de forme étoilée de \citeyear). Cela n’a pas grande signification d’ajouter des notes à \citeyear ou \citeauthor, en particulier avec des citations multiples ; cependant il est possible de le faire, et il n’y aura pas de message d’erreur, mais les résultats sont parfois étranges. Par exemple, en mode numérique, les notes sont complètement ignorées, tandis qu’en mode auteur–année, seule la note postérieure est acceptée. Les citations multiples dans \citet ne sont pas non plus recommandées (et n’ont, selon moi, aucun sens), mais si elles sont utilisées avec des notes, la note antérieure apparaîtra avant chaque année, et la note postérieure seulement après la dernière année. Il faut admettre que ce sont des erreurs, mais l’effort nécessaire pour les éliminer ne se justifie pas par l’utilité contestable de ces possibilités.

En résumé, les notes sont destinées seulement à \citep mais peuvent aussi être utilisées avec \citet en mode auteur–année, avec des citations simples. Dans toute autre situation, les résultats sont imprévisibles.

\Citet
\Citep
\Citealt
\Citealp
\Citeauthor

4.4 Forcer les noms en majuscules

Si le nom du premier auteur contient une partie von, comme dans « della Robbia », alors \citet{dRob98} produit « della Robbia (1998) », même au début d’une phrase. Vous pouvez forcer la première lettre à être une majuscule en utilisant plutôt la commande \Citet. D’autres commandes pour forcer une majuscule existent :

when \citet{dRob98}  ⇒ della Robbia (1998)
then \Citet{dRob98}  ⇒ Della Robbia (1998)
\Citep{dRob98}  ⇒ (Della Robbia, 1998)

             \Citealt{dRob98}  ⇒ Della Robbia 1998

\Citealp{dRob98}  ⇒ Della Robbia, 1998

             \Citeauthor{dRob98} ⇒ Della Robbia

Ces commandes existent aussi en forme étoilée pour les noms complets des auteurs Note : le codage des commandes de passage en majuscule est compliqué et probablement erroné. Il opère sur les noms qui sont rangés dans l’entrée \bibitem et fonctionne même si des commandes de fontes de l’ancien style sont utilisées ; cependant les commandes NFSS provoqueront un plantage ; donc

 \bibitem[{\it della Robbia}(1998)]{dRob98}  fonctionne, mais \bibitem[\textit{della Robbia}(1998)]{dRob98} plante. J’es-

père améliorer cette situation dans le futur.

4.5 Alias de citation

\defcitealias On souhaite parfois citer une référence avec une désignation spéciale, au lieu de

\citetalias
\citepalias

le faire par les auteurs. par exemple, sous Papier I, Papier II. De tels alias peuvent être définis et utilisés, dans le texte et/ou entre parenthèses avec :

      \defcitealias{jon90}{Paper~I}

      \citetalias{jon90}  ⇒ Paper I
      \citepalias{jon90}  ⇒ (Paper I)

Ces commandes de citation fonctionnent tout comme \citet et \citep : elles peuvent prendre plusieurs clés dans l’argument, peuvent contenir des notes et sont marquées comme hyper-liens.

Un avertissement est émis si l’alias est utilisé avant qu’il soit défini, ou si un alias est redéfini pour une citation donnée. Aucun n’avertissement n’est émis si un alias est défini pour une clé de citation qui n’existe pas ; l’avertissement viendra lorsque l’alias sera utilisé !

Voir la section 4.6 pour d’autres méthodes de citation avec un nom de code.

4.6 Références sans auteur et sans année

Que doit-on faire des références qui n’ont pas d’auteur ? Ceci m’a longtemps ennuyé mais j’ai une suggestion. Les styles BibTEX standards font usage d’un champ KEY dans les entrées, champ à utiliser pour classer alphabétiquement lorsque auteurs et éditeurs sont manquants. Les styles auteur–année vont encore plus loin et insèrent le champ Key à la place des auteurs. On peut à ce moment imaginer de donner un code de désignation pour le document. Par exemple,

      @MANUAL{handbk98,
        title = {Assembling Computers},
        year = 1998,
        organization = {MacroHard Inc.},
        key = "MH-MAN"
      }

Avec le style bibliographique plain, le texte de la clé MH-MAN n’est utilisé que pour classer la référence, mais avec le style bibliographique plainnat et d’autres styles auteur–année, il est utilisé à la place des auteurs. On peut alors y faire référence par \citeauthor{handbk98} pour obtenir MH-MAN ou par \citetext{\citeauthor{handbk98}} pour obtenir (MH-MAN), une citation parenthésée.

Ceci peut être grandement simplifié si le style bibliographique laisse la date en blanc dans l’entrée \bibitem, comme dans

     \bibitem[MH-MAN()]{handbk98}

car alors natbib supprime la date, la ponctuation précédente et les accolades pour \citet. Cela signifie que \citet et \citep se comportent automatiquement comme dans les deux exemples ci-dessus. La date peut encore apparaître dans le texte de la référence.

Les styles bibliographiques de natbib ont été modifiés en conséquence pour omettre la date de l’entrée \bibitem lorsque les auteurs et/ou éfiteurs sont remplacés par le texte de la clé.

De même, si l’année est manquente, elle sera laissée en blanc dans l’entrée \bibitem ; donc citer un tel document ne produira que les noms des auteurs.

Note : il y a de nombreuses autres possibilités avec ce dispositif. On peut même produire des citations comme celles du style bibliographique alpha, en plaçant le code de citation à la place des auteurs dans l’entrée \bibitem et en laissant l’année en blanc. Un deuxième code (ou peut-être même les auteurs eux-mêmes) pourrait être placé là ou apparaît normalement la liste complète des auteurs, pour être imprimé avec la forme étoilée des commandes \cite. Par exemple,

     \bibitem[MH-MAN()MacroHard Inc.]{handbk98}

4.7 Dispositifs supplémentaires dans la famille plainnat

Les fichiers .bst spéciaux pour natbib mentionnés dans la section 4.1 ont de nombreux champs supplémentaires par rapport aux fichiers d’origine :

ISBN pour le numéro ISBN dans les livres, ISSN pour le numéro ISSN dans les périodique, URL pour l’adresse Internet des documents en ligne. L’adresse Internet est

composée dans une fonte machine à écrire et conduit souvent à des problèmes de coupure de ligne. Il est conseillé de charger le package url de Donald Arseneau, qui permet au texte en fonte machine à écrire d’être coupé sur les marques de ponctuation. Les adresses URL sont composées avec la commande \url dans ce package, mais s’il n’est pas chargé, alors \url est défini comme étant \textttt, sans coupure de ligne.

Comme le signale la section 4.6, le champ KEY est traité différemment par plainnat et par plain. Tandis que ce dernier utilise ce champ seulement pour classer alphabétiquement les entrées sans auteur, plainnat l’insère vraiment à la place de l’auteur, les deux dans le texte de référence et dans le label de citation (entrées \bibitem). De plus, l’année est laissée vide dans \bibitem afin que \citep n’imprime que le texte « author », qui est maintenant le champ KEY. Ce devrait être un certain code pour désigner le document cité.

4.8 Sélection de la ponctuation pour les citations

\bibpunct Les exemples ci-dessus ont été imprimés avec le style de citation par défaut. Il est possible d’en changer, comme de choisir le mode numérique ou auteur– année, au moyen de la commande \bibpunct, qui prend un argument optionnel et 6 arguments obligatoires. Les arguments obligatoires sont :

1. le symbole crochet ouvrant, par défaut « ( » ;

2. le symbole crochet fermant, par défaut « ) » ;

3. la ponctuation entre des citations multiples, par défaut « ; » ;

4. la lettre « n » pour le style numérique, ou « s » pour le style numérique en exposant, ou toute autre lettre pour auteur–année, par défaut auteur–année ; notez qu’il n’est pas nécessaire de spécifier quelle interface auteur–année est utilisée, car toutes seront reconnues ;

5. la ponctuation qui vient se placer entre les noms d’auteurs et l’année (cas parenthésé seulement), par défaut « , » ;

6. la ponctuation qui vent se placer entre les années lorsque des listes d’auteurs communes sont supprimées (par défaut « {,~}») ; si à la fois auteurs et années sont communs, la citation est imprimée sous la forme « 1994a,b », mais si un espace est demandé entre les lettres supplémentaires, alors incluez l’espace dans l’argument, comme dans {,~}. Pour le mode numérique, \citet{jon90,jon91} produit « Jones et al. [21, 22] » avec cette ponctuation entre les numéros. Un espace est automatiquement inclus pour les numéros, mais pas pour les exposants.

L’argument optionnel est le caractère qui précède une note postérieure ; par défaut, c’est une virgule plus un espace. En redéfinissant ce caractère, il faut inclure un espace si vous en voulez un.

la commande \bibpunct doit être appelée dans le préambule donc avant

\begin{document}.
   Example 1, \bibpunct{[}{]}{,}{a}{}{;} change la sortie de
     \citep{jon90,jon91,jam92}

en [Jones et al. 1990 ; 1991, James et al. 1992].

   Example 2, \bibpunct[; ]{(}{)}{,}{a}{}{;} change la sortie de
     \citep[and references therein]{jon90}

en (Jones et al. 1990 ; and references therein).

\bibstyle@xxx Habituellement le style de citation est déterminé par le journal pour lequel vous écrivez, et fait autant partie du style de bibliographie que tout le reste. Le package natbib permet que les définitions de ponctuation soient directement couplées à la commande \bibliographystyle qui doit toujours être présente lorsque BibTEX est utilisé. C’est cette commande qui sélectionne le fichier .bst ; en ajoutant un tel couplage à natbib pour tout fichier .bst que l’on pourrait vouloir utiliser, il n’est pas nécessaire d’ajouter \bibpunct explicitement dans le document lui-même, sauf bien sûr si vous voulez passer outre les valeurs par défaut.

Un tel couplage est réalisé en définissant une commande \bibstyle@ .bst, où bst est le nom du fichier .bst. Par exemple, l’American Geophysical Union (AGU) demande dans ses publications que les citations soient faites avec des crochets droits et séparées par des points-virgules. Il y a donc un fichier agu.bst pour effectuer la plus grande partie de la mise en forme, mais de telles ponctuations ne sont pas incluses dans ce fichier. En revanche, natbib a la définition

     \newcommand{\bibstyle@agu}{\bibpunct{[}{]}{;}{a}{,}{,~}}

Ces styles définissant des commandes peuvent contenir plus que simplement \bibpunct. Certains schémas de citation numériques nécessitent encore plus de modifications. Par exemple, le journal Nature non seulement utilise des nombres en exposant pour les citations, il imprime aussi les numéros dans la liste des références sans les crochets droits habituels. Pour s’adapter à cela, natbib contient la définition de style

      \newcommand{\bibstyle@nature}%
          {\bibpunct{}{}{,}{s}{}{\textsuperscript{,}}%
           \gdef\NAT@biblabelnum##1{##1.}}

La commande redéfinie \NAT@biblabelnum spécifie comment les numéros des références doivent être mis en forme dans la liste des références elle-même. La redéfinition doit être faite avec \gdef, mais pas avec \def ni \renewcommand.

Le style de ponctuation sélectionné et les autres redéfinitions ne seront pas effectives lors de première exécution de L^{A}TEX, car elles sont mémorisées dans le fichier auxiliaire en vue de l’exécution suivante.

L’utilisateur peut ajouter beaucoup de telles définitions de lui-même, pour s’adapter aux journaux et fichiers .bst qu’il a. Il peut soit les ajouter à sa copie locale de natbib.sty, ou mieux les placer dans un fichier nommé natbib.cfg. Ce fichier sera lu s’il existe, en ajoutant toutes configurations locales. Donc de telles configurations pourront survivre aux mises à jour futures du package. (Ce pour L^{A}TEX 2ε seulement.)

Note : tout appel explicite à \bibpunct a priorité sur les styles de citation prédéfini.

\citestyle Un style de citation préprogrammé est normalement invoqué par la commande classique \bibliographystyle, comme décrit ci-dessus. Cependant, il se peut que l’on veuille appliquer un certain style de citation à un autre style de bibliographie. Ceci peut être fait avec \citestyle, placée avant \begin{document}. Par exemple, pour utiliser le style bibliographique plainnat (pour la liste des références) avec le style Nature de citations (exposants),

     \documentclass{article}
     \usepackage{natbib}
     . . . . .
     \citestyle{nature}
     \begin{document}
     \bibliographystyle{plainnat}
     . . . . .

Note : toutes les modifications au style de citation, y compris la ponctuation, doivent être faites avant \begin{document}, qui gèle le style de citation.

4.9 Priorité des commandes de style

Le style de citation (ponctuation et mode) peut être sélectionné au moyen des commandes \bibpunct, \citestyle et de commandes prédéfinies \bibstyle@bst. Ces éléments peuvent aussi être sélectionnés par des options L^{A}TEX 2ε (voir la section 7). Que se passe-t-il s’il y a plusieurs sélections en conflit ?

La prorité la plus basse est affectée aux commandes prédéfinies \bibstyle@bst, puisqu’elles sont implicites et non directement visibles par l’utilisateur. Les options L^{A}TEX 2ε ont la priorité suivante. Enfin, toute sélection faite par \bibpunct et/ou \citestyle outrepasse celles des autres méthodes.

4.10 Autres options de mise en forme

\bibsection La liste des références apparaît normalement comme une \section* ou un \chapter* selon la classe du document. Si vous voulez concevoir votre propre mis en page du titre, disons une section numérotée avec \section, alors la commande \bibsection peut être redéfinie en conséquence par l’utilisateur.

\bibpreamble Un préambule apparaissant après l’en-tête \bibsection peut être inséré avant la vraie liste des références en définissant \bibpreamble. Il apparaîtra dans la fonte du texte normal, à moins qu’il ne contienne des déclarations de fontes. La fonte définie par \bibfont s’applique à la liste de références, non à ce préambule.

\bibfont La liste des références est normalement imprimée dans la même taille et le même style de fonte que le corps principal du texte. Cependant, il est possible de définir \bibfont comme étant des commandes de fonte qui seront activées à l’intérieur de l’environnement thebibliography après tout préambule. Par exemple,

     \newcommand{\bibfont}{\small}

\citenumfont Les citations numériques peuvent être imprimées dans une fonte différente. Définissez \citenumfont comme étant une déclaration de fonte par exemple \itshape ou même une commande prenant des arguments comme \textit.

     \newcommand{\citenumfont}[1]{\textit{#1}}

Cette dernière déclaration est meilleure que \itshape puisqu’elle ajoute automatiquement la correction italique.

\bibnumfmt Le format du listing numérique dans la liste de référence peut aussi être changé

de celui par défaut [32] en redéfinissant \bibnumfmt, par exemple

     \renewcommand{\bibnumfmt}[1]{\textbf{#1}:}

pour obtenir 32 : à la place.

\bibhang La liste des références pour les styles auteur–année utilise un format avec indentation pendante : la première ligne de chaque référence est en fer à gauche, les lignes suivantes sont composées avec une indentation par rapport à la marge gauche. Cette indentation est de 1 em par défaut et peut être modifiée (par \setlength) en changeant le paramètre longueur \bibhang.

\bibsep L’espacement vertical entre les références dans la liste, que ce soit en style auteur–année ou numérique, est contrôlé par la longueur \bibsep. Si elle est réglée à 0 pt, il n’y a pas d’espacement supplémentaire entre les références. L’espacement par défaut dépend de la taille de fonte choisie dans \documentclass, et est presque équivalente à une ligne blanche. Ce paramètre s’ajuste à l’aide de la commande

\setlength.

4.11 Indexation automatique des citations

\citeindextrue Si l’on désire que les citations soient ajoutées au fichier d’indexation .idx, \citeindexfalse il est seulement nécessaire de placer la commande \citeindextrue en un point

quelconque du document. Toutes les commandes \cite subséquentes, dans toutes leurs variantes, inséreront alors l’entrée correspondante dans ce fichier. Avec \citeindexfalse, ces entrées ne seront plus créées.

Les commandes \bibitem dans l’environnement thebibliography créeront également des entrées dans l’index. Si ceci n’est pas souhaité, placez une commande

\citeindexfalse avant \bibliography ou \begin{thebibliography}.

Bien entendu, il faut aussi appeler \makeindex dans le préambule pour activer l’indexation, comme d’habitude. Dans le cas contraire aucune indexation n’est effectuée.

Assurez vous que le document a été traité au moins deux fois après la dernière exécution de BibTEX avant de lancer le programme makeindex.

\NAT@idxtxt Le format des entrées dans l’index est établi par la commande interne \NAT@idxtxt, qui peut être redéfinie par les astucieux (dans le fichier natbib.cfg s’il vous plait). Par défaut, elle imprime la liste courte des auteurs plus la date dans le style parenthésé courant.

Le package natbib peut également être utilisé avec le package index de David M. Jones. L’ordre de chargement des packages est sans importance.

\citeindextype Dans ce package, les listes d’index multiples peuvent être créées au moyen d’une commande \newindex. Par exemple, il peut être souhaitable de placer toutes les entrées d’index pour les citations dans une liste distincte. D’abord cette liste doit être initialisée par

     \newindex{cite}{ctx}{cnd}{Liste des Citations}

puis l’indexation automatique des citations est associée à cette liste avec la commande suivante du package natbib

     \renewcommand{\citeindextype}{cite}

Voyez la documentation du package index.sty pour les détails.

4.12 Compatibilité avec HyperTEX

Le package natbib est compatible avec le package hyperref de Sebastian Rahtz, pour une utilisation avec L^{A}TEX → conversions HTML, pdfTEX, pdfmark. La compatibilité est de nature mutuelle : les deux packages contiennent du code qui interagit avec celui de l’autre.

Il y a une option spéciale nonamebreak qui peut être utilisée avec le package hyperref ; elle conserve tous les noms d’auteurs dans une citation sur une seule ligne, ce qui évite certains problèmes avec pdfTEX. Mais sinon elle n’est pas recommandée, car elle entraine de nombreuses lignes qui débordent.

4.13 Bibliographies multiples dans un même document

Le package natbib est compatible avec le package chapterbib de Donald Arseneau et Niel Kempson,^{4} qui permet d’avoir plusieurs bibliographies dans un même document. L’application usuelle est d’avoir des bibliographies dans chaque chapitre d’un livre, en particulier s’ils ont été écrits par des auteurs différents.

Le package chapterbib fonctionne d’une manière très naturelle pour l’auteur ; seul l’éditeur qui met ensemble tous les chapitres en un seul livre a un peu de travail supplémentaire. Ce paquetage utilise la commande \include et c’est en fait chaque fichier inclus par cette commande qui a sa propre bibliographie. Pour de gros livres, il est de toutes façons très raisonnable de tirer avantage de cette fonctionnalité.

Pour l’utilisation de la commande \include, rappelez vous que le fichier principal

   \documentclass{...}
   \includeonly{ch2}
   \begin{document}
     \include{ch1}
     \include{ch2}
     \include{ch3}
   \end{document}

ne traitera que le fichier ch2.tex comme si les fichiers ch1.tex et ch3.tex étaient aussi présents. En fait tous les compteurs, en particulier les compteurs de page et de section, fonctionneront comme si le document complet était traité. L’astuce est que chaque fichier inclus par \include a son propre fichier .aux contenant ces définitions, et qu’elles sont lues chaque fois, même si le fichier .tex ne l’est pas. Les fichiers .aux contiennent aussi les informations de citation pour BibTEX, chose que le paquetage chapterbib exploite.

Si le package chapterbib a été chargé, les clés dans chaque commande \cite et \bibitem sont associées au fichier inclus par \include courant et sont distinguées des clés identiques dans un fichier inclus différent. Chacun de ces fichiers doit contenir ses propres commandes \bibliography et \bibliographystyle. On exécute BibTEX sur chaque fichier séparément avant de le traiter par L^{A}TEX (au moins deux fois).

4.13.1 Considérations spéciales pour natbib et chapterbib

L’ordre dans lequel les packages natbib et chapterbib est sans importance.

4J’ain utilisé la version 1.5 du 1995/10/09 ; Je ne peux pas garantir les versions précédentes.

Le package chapterbib offre une option sectionbib qui met la bibliographie dans une \section* au lieu d’un \chapter*, chose qui a un sens s’il y a une bibliographie dans chaque chapitre. Cette option ne marchera pas si natbib est également chargé ; il faut plutôt ajouter cette option pour natbib. (L’option sectionbib peut toujours être donnée, mais elle n’a de signification que pour les classes book et report, et celles qui en dérivent.)

Chaque fichier inclus par \include doit contenir sa propre commande \bibliography là où devra apparaître la bibliographie. Les fichiers bases de données listés comme arguments de cette commande peuvent être différents dans chaque fichier, bien sûr. Cependant, ce qui n’est pas évident, est que chaque fichier doit aussi contenir une commande \bibliographystyle, de préférence avec le même argument style. Si des styles bibliographiques différents sont spécifiés pour les différents fichiers, alors le style préprogrammé de citation (ponctuation et mode de citation) sera celui du premier style bibliographique donné. Les styles préprogrammés de citation ne peuvent être changés que dans le préambule (voir la section 4.9), ce qui garantit un style uniforme pour l’ensemble du document^{5}.

4.14 Tri et compression des citations numériques

Un autre package de Donald Arseneau, cite.sty, ré-implémente l’ensemble du système de citation (numérique) pour que l’on puisse contrôler la ponctuation et le format de citation, choses qui sont aussi faites par natbibĊependant, il peut aussi trier et comprimer les citations numériques, chose qui est demandée par certains journaux.

Ceci signifie que lorsque plusieurs citations sont données dans une seule commande \cite, l’ordre normal des numéros est la séquence donnée. C’est en général une suite quelconque de nombres, comme [4,2,8,3]. Avec le package cite, cette liste devient [2–4,8].

Il est impossible de rendre les packages cite et natbib compatibles, puisque les deux redéfinissent complètement \cite. A la place j’ai donc repris une partie du code de cite.sty, en le modifiant pour natbib. Ce code est activé en spécifiant l’une des options sort ou sort&compress dans la commande \usepackage.

Pour les citations auteur–année, l’option sort classe les citations dans une même commande \citep ou \citet dans l’ordre où elles apparaissent dans la liste des références. C’est normalement d’abord par ordre alphabétique, puis par année. Ceci devrait éviter des citations du type : « James et al. (1994b,a) ». Pour le mode auteur–année, l’option sort&compress est identique à sort.

4.15 Liste longue des auteurs lors de la première citation

Un dispositif qui a souvent été réclamé par des utilisateurs pour le reste satisfaits de natbib est disponible en standard avec le package harvard : avec la première citation d’une référence bibliographique quelconque, la liste complète des auteurs est imprimée, puis, ensuite seulement, la liste abrégée. On peut obtenir ceci avec \citet* pour la première citation, et \citet ou \citep ensuite. Cependant, le mécanisme automatique est très demandé.

Ceci peut être activé avec l’option longnamesfirst.

5Il serait relativement facile de permettre des modifications du style n’importe où dans le document, mais cela me choque comme étant une mauvaise politique. Cependant cela est fourni par l’option nopreonly de docstrip

\shortcites Certaines références ont tellement d’auteurs que vous voudriez supprimer la

liste compléte seulement pour elles. Dans ce cas, dites

     \shortcites{⟨liste de clés⟩}

avant les premières citations et les références dont la clé apparaît dans la liste de clés auront une liste courte même pour leur première citation.

Une liste complète des auteurs peut toujours être forcée avec les formes étoilées des commandes.

5 Citations numériques avec les styles auteur– année

Il est possible de produire des citations numériques avec tout fichier .bst auteur-année, avec des modifications minimales dans le texte. Les commandes \citet et \citep produiront des résultats corrects dans les deux modes, sans édition spéciale. évidemment le contraire n’est pas possible ; un fichier .bst conçu pout la citation numérique ne peut jamais produire des citations auteur–année, tout simplement parce que les informations ne sont pas transmises au fichier auxiliaire.

5.1 Sélection du mode numérique

Par défaut, natbib est en mode auteur–année. Ceci peut être changé en

1. électionnant un style bibliographique numérique avec un style de citation prédéfini, défini soit dans le paquetage soit dans le fichier de configuration local ;

2. donnant les options numbers ou super à la commande \usepackage ;

3. appelant \bibpunct avec un quatrième argument obligatoire égal à n ou s ;

4. appelant \citestyle avec le nom d’un style bibliographique numérique pré-

défini. Les méthodes sont listées par ordre de priorité croissante.

Le paquetage natbib passera automatiquement en mode numérique si une quelconque des entrées \bibitem se trouve ne pas être conforme aux formats auteur–année possibles. Il n’y a aucun moyen de passer outre ceci, puisqu’une telle entrée sèmerait le trouble dans le mode auteur–année.

Il y a certains styles « numériques » spéciaux, comme celui du standard alpha.bst, qui incluent un label non numérique à la place du numéro, sous la forme

     \bibitem[ABC95]{able95}

En ce qui concerne natbib, ce label n’est pas conforme aux possibilités auteur– année et est en conséquence considéré comme étant numérique. Le mode de citation devient numérique, et \cite{able95} imprime [ABC95].

Voir cependant la fin de la section 4.6 pour une autre possibilité. Le résultat ci-dessus peut être obtenu avec

     \bibitem[ABC95()]{able95}

6 Configuration locale

Avec L^{A}TEX 2ε, il est possible d’ajouter un fichier local de configuration natbib.cfg, qui est lu, s’il existe, à la fin du package. Il peut donc contenir du code qui supplante celui qui est dans le package, bien que son but principal soit de permettre à l’usager d’ajouter ses propres définitions bibstyle@bst pour coupler la ponctuation de citation avec les styles bibliographiques locaux.

7 Options avec L^{A}TEX 2ε

Une des possibilités nouvelles de L^{A}TEX 2ε est la présence d’options pour les packages, de la même manière que les styles principaux de documents (maintenant appelés classes). Ce package est maintenant appelé par :

     \documentclass[..]{...}
     \usepackage[options]{natbib}

Les options disponibles offrent une autre méthode pour spécifier la ponctuation pour les citations : round (défaut) pour des parenthèses rondes () ; square pour des crochets droits [] ; curly pour des accolades {} ; angle pour des chevrons < >; colon (défaut) pour séparer des citations multiples par des deux-points ; comma pour utiliser des virgules comme séparateurs ; authoryear (défaut) pour avoir des citations auteur–année ; numbers pour avoir des citations numériques ; super pour avoir des citations numériques en exposant comme dans Nature ; sort trie les citations multiples selon l’ordre de leur apparition dans la liste des

références ; sort&compress comme sort mais de plus les citations numériques multiples sont

compressées si possible (comme dans (3–6, 15) ; longnamesfirst fait que la première citation d’une référence quelconque sera

traitée comme la forme étoilée (liste complète des auteurs) et les citations suivantes comme la forme normale (liste abrégée) ;

sectionbib redéfinit \thebibliography pour obtenir \section* au lieu de

\chapter* ; n’est valide que pour les classes de document ayant une commande \chapter ; à utiliser avec le package chapterbib ;

nonamebreak garde tous les noms d’auteurs dans une citation sur une seule ligne ; provoque des boîtes trop pleines (lignes qui débordent) mais résoud certains problèmes avec hyperref.

Si l’une de ces options de mise en forme est sélectionnée, les styles de citation prédéfinis dans les commandes \bibstyle@bst ne seront plus effectifs. Si \bibpunct ou \citestyle sont appelées dans le préambule, les options de ponctuation ci-dessus ne seront plus valables.

8 Comme module de styles spécifiques de journaux

Bien que natbib soit conçu pour être un package de style bibliographique universel, il peut aussi être incorporé comme module dans d’autres packages pour des journaux spécifiques. Dans ce cas, plusieurs des possibilités générales peuvent être laissées de côté. Ceci est permis grâce à des options de docstrip qui non seulement laissent de côté certaines lignes de code, mais aussi en incluent des supplémentaires. À l’heure actuelle, des options existent pour subpack produit une version basique avec le mode auteur–année seulement, une

ponctuation de citation fixée, pas de commandes \bibpunct ni \citestyle ni de styles prédéfinis ;

subpack,egs pour les journaux de la European Geophysical Society, en particulier

Nonlinear Processes in Geophysics ; subpack,agu pour les journaux de l’American Geophysical Union. L’option subpack doit toujours être utilisée avec package.

Les anciennes options jgr et grl sont devenues obsolètes à cause de changements dans ces journaux ; elles ont été remplacées par l’option plus générale

agu.

9 Résumé

Un résumé rapide des points principaux concernant l’utilisation de natbib peut être obtenu en exécutant L^{A}TEX sur le fichier natnotes.tex, qui est extrait du fichier source principal natbib.dtx à l’aide de l’option notes de docstrip. Il est censé constituer une référence facilement manipulable.

Ce fichier devrait être automatiquement extrait par le fichier d’installation

fourni natbib.ins.

10 Options avec docstrip

Le fichier source natbib.dtx est destiné à être traité avec docstrip, pour lequel un certain nombre d’options sont disponibles : all inclut toutes les autres interfaces ; apalike permet l’interprétation d’une forme apalike minimale de \bibitem ; newapa permet que \citeauthoryear soit dans l’argument optionnel de \bibitem

avec les commandes de ponctuation de newapa.sty ; chicago est identique à newapa ; harvard inclut l’interprétation de \harvarditem ; astron permet que \astroncite apparaisse dans l’argument optionnel de \bibitem ; authordate ajoute la syntaxe de la commande \citename.

Ce package est conçu pour agir comme module pour d’autres fichiers de classes écrits pour des journaux spécifiques, auxquels cas les commandes souples \bibstyle@bst ne sont plus souhaitées. Ponctuation et autres dispositifs de styles doivent être établis de manière rigide. Ces options pour journaux sont agu pour les journaux de l’American Geophysical Union ; egs pour les journaux de l’European Geophysical Society, en particulier Nonlinear

Processes in Geophysics. Les options restantes sont :

package pour produire un fichier paquetage .sty avec la plupart des commen-

taires retirés ; 209 (associée avec package) pour une option de style qui fonctionnera sous l’an-

tique L^{A}TEX 2.09 ; subpack (associée avec package) pour un codage qui devra être inclus dans un

package plus vaste ; encore plus de commentaires sont retirés, ainsi que le traitement L^{A}TEX 2ε des options et le code d’identification ; produit un package natbib basique pour seulement le mode auteur–année et un style de citation fixé (ponctuation) ;

notes extrait un résumé d’utilisation destiné à servir de feuille de référence ; le

fichier résultant, natnotes.tex, peut être traité par L^{A}TEX. nopreonly permet que les commandes \citestyle et \bibpunct soient appelées

n’importe où dans le texte (et pas seulement dans le préambule) ; ceci est considéré utile avec le package chapterbib car alors des chapitres différents peuvent avoir des styles de bibliographie et de citation différents ; n’est fournie qu’au cas où je changerait d’avis à ce propos, mais pour le moment je me refuse à l’implémenter ;

driver pour produire un fichier pilote .drv qui imprimera la documentation sous

L^{A}TEX 2ε. La documentation ne peut pas être imprimée sous L^{A}TEX 2.09. Le fichier source natbib.dtx est lui-même un fichier pilote et peut être traité directement par L^{A}TEX 2ε.