Aide:Utilisation avancée des références Harvard
Ce petit tutoriel a pour objectif de vous faire acquérir les techniques avancées de sourçage d'articles au moyen de références Harvard (ou « références auteur-date »).
L'un des grands avantages de la méthode Harvard est de séparer les références, qui restent très courtes, des descriptions complètes des sources, qui peuvent être très longues.
Dans Wikipédia, un autre avantage est que le code de chaque référence reste bref et homogène, ce qui simplifie la maintenance des articles et améliore la lisibilité des fenêtres d'édition lorsqu'il y a beaucoup de références incluses dans un même chapitre d'ouvrage.
Pour mémoire : méthode minimale
La première chose à garder en tête en matière de sourçage, c'est qu'il faut éviter de perdre l'information à propos de la source. Lorsque vous ajoutez une information dans un article, ça ne vous prendra que quelques secondes pour mentionner l'endroit exact où vous venez de la trouver. Si vous ne le faites pas tout de suite, dans quelques semaines, même vous, vous risquez de ne plus pouvoir retrouver la source !
La méthode minimale consiste donc à écrire directement, par exemple :
- Le Danube d'argent sur le blason de Belgrade est strié de gueules pour évoquer la destin tragique de cette ville (page 134 de la revue Historia de juillet 1997).
Méthode Harvard
Parmi les méthodes plus sophistiquées permettant de sourcer un article, on trouve la méthode dite « Harvard » ou « Auteur-date » (portée par le modèle : {{Référence Harvard}}). Son utilisation dans Wikipédia donne d'excellents résultats, mais nécessite une petite phase d'apprentissage. Ça ne vous effraye pas ? Alors allons-y !
Exemple simple
Regardons cet exemple :
Bibliographie
- (en) Albert Einstein, Boris Podolsky et Nathan Rosen, « Can Quantum-Mechanical Description of Physical Reality Be Considered Complete? », Phys. Rev., vol. 47, , p. 777-780.
Cet exemple de base est composé de trois parties :
- le texte, qui contient l'information. Il se termine par un petit numéro : l'appel de référence ;
- la référence elle-même. C'est une référence « Harvard » (auteur-date). Elle donne les informations minimales pour retrouver la source exacte, à savoir :
- le nom de famille des auteurs ;
- l'année de publication ;
- le passage du livre ;
- dans la bibliographie, (ou section liste des œuvres si on cite l'auteur lui-même) on trouve les détails de la publication (au minimum l'auteur ( qui peut être Anonyme ou Collectif), le titre exact, l'année et l'éditeur, mais parfois beaucoup plus de choses).
De plus, si on dispose d'un navigateur performant, en cliquant sur le petit numéro, on surligne la référence. En cliquant sur la référence, on surligne la publication. Et en cliquant sur la petite flèche à gauche de la référence, on remonte à son utilisation dans le texte.
Prenez quelques secondes de plus pour vous assurer d'avoir une vision claire des relations entre ces trois éléments (l'appel de référence, la référence et le détail de la publication). Une fois que vous aurez bien compris ça, vous maîtriserez 90 % du sujet de ce petit tutoriel !
Code wiki de l'exemple simple
Regardons maintenant le code wiki qui a permis de créer cet exemple avec 3 auteurs :
==== Physique ====
L'interprétation de Copenhague de la physique quantique est incomplète<ref>{{harvsp|Einstein|Podolsky|Rosen|1935|p=779}}.</ref>.
==== Références ====
{{Références}}
==== Bibliographie ====
*{{article |langue=en |prénom1=Albert |nom1=Einstein |prénom2=Boris |nom2=Podolsky |prénom3=Nathan |nom3=Rosen |titre=Can Quantum-Mechanical Description of Physical Reality Be Considered Complete? |périodique=Phys. Rev. |année=1935 |volume=47 |pages=777-780 }}.
L'appel de référence
Dans le texte, l'appel de référence a été créé par le code ;
- <ref>{{harvsp|Einstein|Podolsky|Rosen|1935|p=779}}.</ref>
Regardons-le de plus près :
- le couple de balises <ref></ref> encadre la référence.
- le code « {{harvsp » marque le début de l'utilisation du modèle : {{Référence Harvard}} (plus précisément du modèle « harvsp », référence sans parenthèses).
- Suit le paramètre auteur. Ici, il y a trois auteurs « Einstein », « Podolsky » et « Rosen ». (Prérequis sur le remplissage des paramètres: appel de référence).
- Suit le paramètre année. Ici, l'année est « 1935 »
- Suit la précision du passage du livre. On peut mettre une seule page ou un intervalle. Ce paramètre est facultatif.
« Quoi ? » direz-vous, « Tout ce code pour faire un simple petit numéro bleu ? ».
Oui, mais ce petit numéro va avoir de grands pouvoirs !
La section « référence »
Ici, la section références a été créée par le code :
- {{Références}}
Comme souvent, vous trouverez dans la documentation d'autres manières de faire. Notre conseil : quand vous serez devenu un expert, vous ferez bien comme vous voudrez et ça vous donnera la joie de participer à des débats techniques sans fin ! Mais comme pour commencer, il faut bien en choisir une, et nous vous conseillons d'utiliser celle-ci !
Ce simple code a le mérite de rassembler et de présenter correctement toutes les références de l'article. Comme il peut y en avoir parfois plusieurs dizaines, vous commencez sûrement à comprendre pourquoi c'était un gain de temps de coder correctement les appels de références !
La section « bibliographie »
On a utilisé ici un modèle {{article}} avec quelques-uns de ses paramètres. Il existe beaucoup d'autres paramètres, secondaires, comme l'éditeur, le nom du traducteur, etc. que nous vous laissons découvrir. Il existe aussi d'autres modèles pour les sources, tels que {{ouvrage}} ou {{chapitre}} ou {{lien web}}.
Exemple avec un identifiant invisible
Regardons cet exemple :
Bibliographie
- (en) Charles Darwin, A monograph on the sub-class Cirripedia, with figures of all the species, Ray Society,
Cet exemple de base est composé de trois parties :
- Le texte, qui contient l'information. Il se termine par un petit numéro : l'appel de référence.
- La référence elle-même. C'est une référence « Harvard » (auteur-date sans parenthèses). Elle donne les informations minimales pour retrouver la source exacte, à savoir :
- Le nom de famille de l'auteur
- L'année de publication
- Le passage du livre
- Dans la bibliographie, on trouve les détails de la publication (au minimum le titre exact, surtout pour Harvard l'auteur et l'année, en général l'éditeur, mais parfois beaucoup plus de choses dont la langue de l'ouvrage dont il est question).
De plus, si on dispose d'un navigateur performant, en cliquant sur le petit numéro, on surligne la référence. En cliquant sur la référence, on surligne la publication. Et en cliquant sur la petite flèche à gauche de la référence, on remonte à son utilisation dans le texte.
Prenez encore quelques secondes d'observation pour une vision claire des relations entre ces trois éléments (l'appel de référence, la référence et le détail affiché de la publication) .
Code Wiki de cet exemple
Regardons maintenant de près le code wiki qui a permis de créer cet exemple :
==== Géographie ====
Le ''Pollicipes elegans'' vit sur la côte pacifique de l'Amérique du Sud<ref>{{harvsp|Darwin|1864|p=212-213|id=C.D.1864a}}</ref>.
==== Références ====
{{Références}}
==== Bibliographie ====
*{{ancre|Darwin1864a}}{{Ouvrage| langue=en | prénom1=Charles |nom1=Darwin| titre=A monograph on the sub-class Cirripedia, with figures of all the species| éditeur=Ray Society | année=1864 }}.
L'appel de référence
Dans le texte, l'appel de référence a été créé par le code ;
- <ref>{{harvsp|Darwin|1864|p=212-213|id=C.D.1864a}}</ref>
Regardons-le de plus près :
- le couple de balises <ref></ref> encadre la référence.
- le code « {{harvsp » marque le début de l'utilisation du {{Harvsp}}, Harvard sans parenthèses.
- Suit le paramètre auteur. Ici, il y a un auteur « Darwin ».
- Suit le paramètre année. Dans cet exemple, on suppose qu'il existe deux publications avec les mêmes auteurs durant la même année. Il faut donc les différencier. On inscrit donc « 1864a » pour l'année.
- Suit la précision du passage du livre. On peut mettre une seule page ou un intervalle. Ce paramètre est facultatif.
- Suit le paramètre id=C.D.1864a
La section « références »
Ici, la section références a été créée par le code :
- {{Références}}
Comme souvent, vous trouverez dans la documentation d'autres manières de faire. Notre conseil : quand vous serez devenu un expert, vous ferez bien comme vous voudrez et ça vous donnera la joie de participer à des débats techniques sans fin !
Ce simple code a le mérite de rassembler et de présenter correctement toutes les références de l'article. Comme il peut y en avoir parfois plusieurs dizaines, vous commencez sûrement à comprendre pourquoi c'était un gain de temps de coder correctement les appels de références !
La section « bibliographie »
On a utilisé ici un modèle {{ouvrage}} avec seulement ses paramètres essentiels. Il existe beaucoup d'autres paramètres, secondaires, comme le nombre de pages, le nom du traducteur, etc. que nous vous laissons découvrir. Il existe aussi d'autres modèles pour les sources, tels que {{chapitre}}, {{article}} ou {{lien web}}.
Mais elle est précédée par {{ancre|Darwin1864a}} qui suit les recommandations des documentations des objets-source-biblio qui excluent le paramètre id vu infra (l'article que vous modifiez n'est peut-être pas actualisé sur cet ancien problème . Actualisez le! ). Et surtout cela convient à la structure codée dans l'appel que vous trouvez et pouvez modifier si vous savez le faire. Vous n'avez pas à reprendre tous les harvard car cela ne dérange pas les autres appels existants. (Pour les explications lisez d'abord Aide:Références Harvard si vous ne l'avez pas encore fait, cela ne prend que quelques minutes).
À vous de choisir le modèle de source qui sera adéquat. Quel que soit votre choix, pour ce qui concerne cette partie du tutoriel, un seul paramètre sert sur l'appel pour la liaison (qui, insistons, peut-être automatique), c'est le paramètre « id=C.D.1864a »; un seul objet est indispensable sur la bibliographie précédant l'oeuvre, c'est l'ancre. Insistons : le paramètre id est fortement déconseillé dans l'ouvrage, il empêche le système harvard automatique.
Méthode Harvard et références groupées
Au lieu d'écrire plusieurs fois:
- <ref>{{harvsp|Darwin|1864|p=212-213}}</ref>
- <ref>{{harvsp|Darwin|1864|p=212-213}}</ref>
Ce qui provoque dans l'espace référence plusieurs références identiques pointant sur une seule source
{{Références}}
Vous écrivez dans le premier appel de référence:
- <ref name="Darwin1864a">{{harvsp|Darwin|1864|p=212-213}}</ref>
vous pouvez le dupliquer:
- <ref name="Darwin1864a">{{harvsp|Darwin|1864|p=212-213}}</ref>
cependant dans tous les autres appels similaires, vous pouvez écrire seulement:
- <ref name="Darwin1864a"/>
{{Références}}
Pour pas trop vous perdre, mettez le paramètre ref name="Darwin1864n°"
dans chaque appel de référence dont le contenu est identique (par exemple avec une même page...). Car c'est l'unicité de cette référence codée qui assure la « magie » : il n'y a pas de duplicata dans l'espace de référence entre les deux éléments référençant identiquement la source.
À dire vrai pour faire cela, il est moins usant d'utiliser {{sfn}}, qui va rassembler les identiques et séparer ceux qui se distinguent (parce qu'avec une ref name="Darwin1864"
avec un passage 212-222 cela provoquerait une "Erreur......").
Pour aller plus loin: Tout faire avec seulement 11 paramètres
L'une des critiques parfois (souvent?) formulées à l'encontre de l'utilisation des modèles de sources dans Wikipédia provient du très grand nombre des paramètres, des modèles et de leurs fonctionnalités. Les nouveaux (et aussi beaucoup d'anciens) s'y perdent, au risque de renoncer. Or, il est possible de tout faire de manière « rustique », avec seulement onze paramètres.
- Pour la balise initiale du renvoi en bas de page ref name=
- Pour le modèle {{harvsp}}, quatre paramètres: nom, année, passage, plus texte
- Pour le modèle {{ouvrage}} (ou similaires), six paramètres: nom, titre, éditeur, année, (et id si vous ne pouvez pas faire autrement) plus et al.
- et séparez le commentaire de l'ouvrage puisqu'obsolète et utilisez {{commentaire biblio}} ou {{commentaire biblio SRL}}.
Démonstration:
Plus de trois auteurs
Sur le renvoi bas de page s'il y a plus de trois auteurs, la norme prévoit qu'on ne mentionne que le premier et qu'on fasse suivre de l'expression et al.. Celle-ci est indépendante de celle déclarée dans l'ouvrage. Dans le modèle type harvard on ne reçoit que quatre auteurs et une date, et automatiquement il est mis dans le renvoi en bas de page auteurs-date : auteur1 "et al." à la place des autres auteurs. Mais si vous voulez absolument les afficher malgré la convention, plutôt que de bidouiller les noms des trois premiers auteurs déclarés avec le paramètre id , vous pouvez utiliser le paramètre texte= du {{harvsp}} qui remplace le texte affiché automatique et est prévu pour et fonctionne dans tous les cas :
==== Physique ====
La perception des couleurs est très subjective<ref>{{harvsp|texte=Leblanc, Lebrun, Lenoir, Lejaune, Levert et al. 2006|Leblanc|Lebrun|Lenoir|Lejaune|2006|p=25}}.</ref>.
==== Références ====
{{Références|taille=30}}
==== Bibliographie ====
*{{ouvrage |langue=fr | nom1= Leblanc |nom2=Lebrun |nom3=Lenoir |nom4=Lejaune |nom5=Levert |et al.=oui |titre=De la perception des couleurs |année=2006 |éditeur=Larousse |collection=couleurs et valeurs fin de siècle }}
La référence Harvard se présentera ainsi:
- [1].
et l'entrée de bibliographie sera:
- Leblanc, Lebrun, Lenoir, Lejaune, Levert et al., De la perception des couleurs, Larousse, coll. « couleurs et valeurs fin de siècle », .
Ouvrage anonyme
Et si l'auteur est inconnu? Dans ce cas, on remplacera le nom de l'auteur par le titre et on utilise une {{ancre}} invisible devant l'ouvrage. Cette ancre est la concaténation des paramètres positionnels, date comprise, mais n'est pas le texte affiché en bleu du harvsp qui comporte une espace:
==== Ésotérisme ====
L'histoire des « Noces Chymiques de Christian Rosenkreutz » débute à la veille de Pâques<ref>{{harvsp|Les Noces Chymiques|1616|p=25}}.</ref>.
==== Références ====
{{Références|taille=30}}
==== Bibliographie ====
*{{ancre|Les noces Chymiques1616}}{{ouvrage |langue=fr | auteur= Anonyme |titre=Les Noces Chymiques de Christian Rosenkreutz |lien titre=Les Noces Chymiques de Christian Rosenkreutz |année=1616 }} {{commentaire biblio| attribué à [[Johann Valentin Andreae]], première publication à Strasbourg}}.
La référence donnera: