Normalisation des références bibliographiques selon le GB/T 7714-2015 et vérification des liens
I. Pourquoi en faire une compétence distincte
Ce travail présente trois caractéristiques : de nombreuses règles détaillées (identifiant de type de document, date de citation pour les documents électroniques, écriture différente pour plus de trois auteurs), facile à mal faire et sans retour d'erreur (une erreur parmi des dizaines de chaînes est difficile à repérer), et une fois mal écrite, difficile à détecter visuellement. L'important n'est donc pas de « mémoriser les règles », mais de suivre un processus d'écriture programmée + vérification par relecture + validation des liens.
II. Points essentiels de la norme GB/T 7714-2015
Structure de base
[Numéro] Auteur principal. Titre[Identifiant de type de document/support]. Source, année, volume(numéro) : pages.
Identifiants de types courants
| Type | Identifiant | Écriture électronique |
|---|---|---|
| Livre | [M] | [M/OL] |
| Article de revue | [J] | [J/OL] |
| Article de journal | [N] | [N/OL] |
| Thèse | [D] | [D/OL] |
| Rapport | [R] | [R/OL] |
| Norme | [S] | — |
| Annonce électronique | [EB/OL] | — |
| Brevet | [P] | [P/OL] |
Trois points à ne pas ignorer
- Pour les documents électroniques, la date de consultation et le chemin d'accès sont obligatoires – exigence de l'article 4.9 du GB/T 7714-2015. La forme correcte pour un document avec URL/DOI est :
[J/OL]. Nom de la revue, année, volume(numéro) : pages[date de consultation]. https://.... Inversement, si la revue/l'université cible ne l'exige pas, vous pouvez omettre la date de consultation, mais sachez que c'est un choix délibéré. - Lorsqu'il y a plus de 3 auteurs, pour les références en chinois : « Auteur principal, et al. » ; pour les références occidentales : « Auteur principal, et al. ». La norme autorise la liste complète, mais la cohérence doit être maintenue dans tout le document.
- Pour les auteurs occidentaux, le nom précède le prénom abrégé :
Büller HR, Verhamme P, Weitz JI. Ne copiez pasBuller HRde PubMed en perdant les lettres diacritiques, et n'écrivez pasHR Büller.
III. Vérification des liens (outil principal)
# Une ligne par élément : URL / DOI / PMID / PMC, le script identifie automatiquement le type
python3 scripts/check_refs.py refs.txt
# Entrée JSON, avec possibilité de spécifier explicitement le type
python3 scripts/check_refs.py refs.json --timeout 20 --workers 8
Code de sortie : 0 = aucun échec certain ; 1 = échec(s) existant(s).
Formats d'entrée supportés :
| Entrée | Résultat de l'analyse |
|---|---|
10.1056/NEJMoa2513880 ou https://doi.org/... | Lien DOI |
25482425 (numérique uniquement) | Lien PubMed |
PMC2909362 | Lien PMC |
https://... ou nom de domaine nu | Accès direct |
Logique de décision (important)
Le script classe les résultats en trois catégories ; ne considérez pas un échec dès qu'un code autre que 200 apparaît :
| Catégorie | Condition | Traitement |
|---|---|---|
| Accessible directement | 200 / 203 / 30x | Accepté |
| Suspecté de blocage anti-robot | 403 / 412 / 429 / 503 / 000 (aucune erreur fatale) | Vérifier avec un navigateur, ce n'est pas une erreur de lien |
| Suspecté d'échec | curl signale explicitement une erreur could not resolve host ou DNS/certificat | Confirmer puis remplacer ou supprimer le lien |
Deux pièges déjà rencontrés :
- PubMed renvoie 203, ce n'est pas un échec. J'avais autrefois considéré le 203 comme un échec, ce qui a inutilement compliqué la recherche.
curl -smasque silencieusement les erreurs DNS, faisant apparaître « domaine inexistant » et « réseau bloqué » (deux situations complètement différentes) comme un code 000. Le script utilise désormais-sSet se base sur stderr pour les distinguer.
Caractéristiques d'accès des sites courants
| Site | Caractéristique |
|---|---|
nhc.gov.cn (Commission nationale de la santé) | curl renvoie souvent 412 anti-robot, le navigateur peut l'ouvrir normalement |
| Domaine med. de Wanfang | Anti-robot, peut être accédé via d.wanfangdata.com.cn/periodical/<xxx> |
| CNKI (知网) | Généralement sans lien direct ; la présence de la référence dans la base suffit, inutile d'insister sur l'URL |
| NEJM / Lancet | Paywall, curl renvoie souvent 403 ; le DOI suffit |
IV. Technique d'écriture : éviter les erreurs de caractères
C'est le point le plus facilement négligé et potentiellement le plus dommageable de cette compétence.
N'utilisez pas de long Heredoc pour écrire des listes de références directement dans un docx / json / py.
En pratique, des erreurs de caractères surviennent souvent : préfixe DOI mal écrit (10.7723 devenant 10.19546), nom d'auteur mal orthographié, code de règlement tronqué, et le processus d'écriture ne signale pas l'erreur.
Solution correcte :
# 1) Construire la liste des références comme une structure de données Python, puis écrire le bloc entier de manière programmée
refs = [
{"id": 1, "text": "Büller HR, ...", "url": "https://...", "doi": "10.1056/..."},
...
]
# 2) Définir une liste de vérification
must_have = ["25482425", "10.1056/NEJMoa2513880", "国卫医发", "Büller"]
bads = ["10.7723", "理相指南", "ERUOIMMUON"]
# 3) Après écriture, relire immédiatement pour vérifier
content = read_back()
missing = [s for s in must_have if s not in content]
leaked = [s for s in bads if s in content]
assert not missing and not leaked, (missing, leaked)
must_have contient les identifiants clés (PMID, DOI, codes règlement, noms difficiles), bads les erreurs connues. Les deux sont nécessaires : le premier empêche la perte de contenu, le second empêche la production de contenu erroné.
V. Liste d'erreurs courantes (à vérifier une par une)
| Erreur | Exemple | Correction |
|---|---|---|
| Fusion de données de sources différentes | Fusionner « 2-4 % (RCT) » et « 2-5 % (monde réel) » en un seul nombre | Maintenir les différences de source, écrire séparément |
| Volume/pages mal écrits | Büller écrit 2009;361:1722 | En réalité NEJM 2015;372:232-240 |
| Citation de source secondaire comme primaire | Citer un chiffre d'une revue secondaire tout en mentionnant la source RCT originale | Retrouver l'original, ou écrire explicitement « cité dans » |
| Document normatif sans source | Le corps cite 5 documents, mais la bibliographie n'en contient aucun | Chaque document/règlement cité doit figurer dans la bibliographie |
| Titre cité non conforme au réel | Le titre de la référence [1] ne correspond pas à l'article publié | Vérifier titre par titre |
| Faute d'orthographe sur un nom propre | EUROIMMUN écrit ERUOIMMUON | Vérifier visuellement chaque nom propre |
VI. Connexion avec Zotero / CSL
Pour ajuster le style de citation Zotero, il est plus fiable de modifier directement le fichier .csl que d'utiliser des plugins. Par exemple, le style numérique GB/T 7714-2015 ajoute une date de consultation à la fin de chaque référence électronique : trouvez la macro accessed-date et videz son contenu en <group/> pour désactiver globalement cette information (une modification unique). Modifiez également id / title / updated pour éviter les conflits avec le style officiel.
Mais rappelez-vous : la norme GB/T 7714-2015 exige la date de consultation pour les documents électroniques (article 4.9). La supprimer peut rendre la soumission non conforme pour certaines revues/thèses. C'est un choix de l'utilisateur, qu'il faut explicitement lui signaler, plutôt que de le supprimer en silence.
La macro issued-year conserve une mention de date d'accès de secours (si issued est manquant, on utilise l'année de consultation) ; ne la supprimez pas.
VII. Liste de vérification
- L'identifiant de type de document de chaque référence est cohérent avec la présence ou non de
/OL - Le traitement des auteurs >3 est cohérent dans tout le document
- Noms occidentaux : nom avant prénom abrégé ; les lettres diacritiques sont conservées
- Documents électroniques : date de consultation (sauf décision explicite de l'omettre) et chemin d'accès présents
- Préfixe DOI correct, pas de mélange demi-pleine / pleine largeur
- Les liens ont été vérifiés avec
check_refs.py; les éléments « suspectés de blocage » ont été vérifiés avec un navigateur - Après écriture, la vérification
must_have/badsest réussie - Chaque référence citée dans le corps figure dans la bibliographie, et inversement