Projet:Scripts et gadgets/Notices/refErrors

Une page de Wikipédia, l'encyclopédie libre.

Le script refErrors permet de vérifier que les renvois vers des entrées bibliographiques présents dans des notes et références sont valides. Il signale également la présence d'erreurs dues à une balise <references /> manquante ou à une référence nommée vide (<ref name>).

Comment se manifeste un renvoi bibliographique erroné ?[modifier | modifier le code]

Un renvoi bibliographique est un lien présent dans une référence en bas de page, qui permet d'accéder à une ligne de la section bibliographique de l'article. Voici par exemple un renvoi bibliographique qui ne comporte pas d'erreur[exemple 1] et un second renvoi bibliographique, cette fois erroné[exemple 2] : dans le second exemple, le lien présent dans la référence ne mène nulle part.

Ce lecteur est heureux : non seulement le renvoi bibliographique fonctionne correctement, mais en plus, il utilise le gadget tooltipRef qui lui permet de consulter les notes et leurs renvois bibliographiques confortablement Émoticône sourire
Alors, pourquoi casser son bonheur avec un bête renvoi bibliographique erroné (Smiley: triste) ? Hum ?

Comment corriger ?[modifier | modifier le code]

Exemple d'affichage des erreurs de renvois bibliographiques

Le script affiche en tête de page une boîte qui indique tout d'abord les éventuels renvois bibliographiques erronés, avec pour chacun un lien permettant d'accéder directement à la référence concernée dans l'article. Par exemple:

« Entrée #Connie_Kirchberg appelée par la référence [164] »

La référence erronée est également signalée au fil du texte de l'article, sous la forme :

« ...les performances de son adversaire164 Erreur : renvoi bibliographique à corriger (#Connie_Kirchberg). Bird et Magic... »

En éditant la section concernée, on constate par exemple que la référence est de la forme :

« <ref>{{harvsp|Connie Kirchberg|p=173}}</ref> »

Il faut alors vérifier :

  • que la section bibliographique de l'article comporte bien une entrée correspondante (un ouvrage de l'auteur Connie Kirchberg) ;
  • que cette entrée comporte bien le code nécessaire au fonctionnement du renvoi bibliographique (par exemple en étant faite à l'aide d'un modèle du type {{ouvrage}}) ;
  • que l'identifiant produit par la référence (Connie_Kirchberg) est bien identique, à la casse près, à celui produit par le code de l'entrée bibliographique.

Pour aider à trouver cette entrée bibliographique et son identifiant exact, le script indique également, à la suite de la liste des erreurs, celle des entrées bibliographiques trouvées dans l'article, accompagnées de leurs identifiants respectifs et d'un lien permettant d'y accéder immédiatement. Ici, la liste comportera par exemple une ligne :

« Kirchberg2007 (Aller) »

Selon les cas, il faudra corriger soit l'entrée bibliographique, soit la référence (à moins qu'il ne s'agisse d'une source dont la mention a simplement été oubliée dans la bibliographie) :

  • les modèles comme {{ouvrage}} produisent automatiquement l'identifiant, mais ils permettent également d'indiquer celui-ci manuellement à l'aide d'un paramètre id. On pourra donc, dans l'exemple, corriger l'entrée bibliographique en la modifiant pour lui ajouter l'identifiant présent dans la référence :
    « {{ouvrage |titre=Hoop lore: a history of the National Basketball Association |prénom1=Connie |nom1=Kirchberg |langue=en |éditeur=McFarland |année=2007 |pages=339 |isbn=9780786426737 |lire en ligne=http://exemple.org/foo |consulté le=24 novembre 2011|id=Connie_Kirchberg}} »
    (voir cette correction dans l'article Larry Bird) ;
  • inversement, on peut conserver l'entrée bibliographique existante et modifier cette fois la référence pour y utiliser l'identifiant de l'entrée bibliographique :
    « <ref>{{harvsp|Kirchberg2007|p=173}}</ref> »
    (voir cette correction dans l'article Larry Bird).

Cette dernière correction peut être améliorée en insérant un séparateur « | », ce qui permet d’avoir un rendu de note avec un espace entre le nom de l'auteur et la date d’édition de l'ouvrage :
« <ref>{{harvsp|Kirchberg|2007|p=173}}</ref> »
(voir cette correction dans l'article Larry Bird).

Les remarques qui précèdent s'appliquent aussi lorsque l'appel de note est effectué au moyen du modèle {{sfn}} : les corrections sont similaires. En l'occurrence, en restant dans le même exemple, un appel de note correct s'écrirait :
« {{sfn|Kirchberg|2007|p=173}} ».

Installation du script[modifier | modifier le code]

Le lien « Vérifier renvois biblio. »

Copiez dans votre common.js personnel la ligne :

importScript('Utilisateur:Lgd/refErrors/refErrors.js');

Un lien « Vérifier renvois biblio. » s'ajoute au menu d'action situé à gauche du formulaire de recherche.

Bug, améliorations à proposer ?[modifier | modifier le code]

Vous pouvez signaler les bugs sur Discussion Projet:Scripts et gadgets/Rapport de bug.

Exemple de section bibliographique[modifier | modifier le code]

  • John Doe, Moi, ma vie, mon œuvre

Exemple de section référence[modifier | modifier le code]

  1. JDoe, p. 173
  2. Doe, p. 173