🇬🇧 English ver­sion

Cette page est des­ti­née aux concep­teurs de sites web (y com­pris moi-même) dési­reux de décou­vrir (ou de se rap­pe­ler) la concep­tion de ce site pour ce qui concerne les iden­ti­fiants pérennes (Per­sistent IDen­ti­fiers, PID lien:hgpw).

Le PID est un concept ima­gi­né par les créa­teurs de pla­te­formes pour l’ar­chi­vage pérenne de docu­ments numé­riques. Un exemple bien connu dans le monde aca­dé­mique est celui du “DOI” (Digi­tal Object Iden­ti­fier) attri­bué à chaque publi­ca­tion dans une revue scien­ti­fique.

Par exemple, un article de Fron­tiers in Neu­ro­lo­gy dont l’URL est
https://www.frontiersin.org/articles/10.3389/fneur.2018.00952/full a reçu le DOI
“10.3389/fneur.2018.00952”. Le lien https://doi.org/10.3389/fneur.2018.00952 doit donc abou­tir à la page web décri­vant l’ar­ticle…

Les archi­vistes savent que la péren­ni­té de l’URL cible n’est pas assu­rée car les domaines d’In­ter­net et les che­mins d’ac­cès aux docu­ments peuvent être modi­fiés sur le long terme. L’a­van­tage de se connec­ter par le biais d’un DOI est que le res­pon­sable de son enre­gis­tre­ment (Fron­tiers in Neu­ro­lo­gy) est char­gé de cor­ri­ger au besoin la redi­rec­tion vers une adresse valide. Le DOI est donc un type d’iden­ti­fiant pérenne (PID) : une chaîne de carac­tères alpha­nu­mé­riques for­mant réfé­rence stable à un docu­ment, une page inter­net, ou tout autre objet lien:hgpw).

Un autre type de PID uti­li­sé par les archi­vistes du monde uni­ver­si­taire est le Sys­tème Handle (lien:2bit). À l’op­po­sé des DOI, ces iden­ti­fiants sont gra­tuits et peuvent accom­plir d’autres tâches que le simple accès aux objets d’une archive.

Un objet numé­rique peut rece­voir plu­sieurs PIDs. Cha­cun d’eux pointe vers sa loca­tion réelle ou vers un autre PID qui se charge de la redi­rec­tion…

Un service de PID « local »

Les DOIs sont admi­nis­trés par la DOI Foun­da­tion (lien:p7it) à l’aide d’une infra­struc­ture tech­nique réser­vée aux publi­ca­tions dans des revues scien­ti­fiques. Tou­te­fois, il est rai­son­nable de créer et gérer des PIDs sur n’im­porte quel domaine décla­ré « pérenne » en lien avec les sites web qui lui sont asso­ciés. C’est le cas du domaine leti.lt asso­cié au site LeBonheurEstPossible.org, les deux étant héber­gés sur le même compte.

Le PID mana­ger (ges­tion­naire d’i­den­ti­fiants pérennes) fonc­tionne sur le domaine leti.lt pour gérer un réper­toire de liens vers les res­sources men­tion­nées sur le site. Le cœur de ce dis­po­si­tif est une base de don­nées dont chaque enre­gis­tre­ment contient l’i­den­ti­fiant unique et son URL cible. Sont inclus une courte des­crip­tion qui appa­raî­tra dans le champ title du lien en HTML, et en option la réfé­rence biblio­gra­phique com­plète appe­lé le conte­nu. (Cette ter­mi­no­lo­gie est spé­ci­fique du dis­po­si­tif.)

Les PIDs sur leti.lt sont des chaînes alpha­nu­mé­riques de 4 carac­tères, par exemple “dyig” qui désigne l’ar­ticle de Fron­tiers in Neu­ro­lo­gy déjà men­tion­né. Grâce au resol­ver de PID mana­ger, le lien https://leti.lt/dyig est redi­ri­gé vers l’ar­ticle. En édi­tion de texte, ce lien peut être sai­si sous la forme lien:dyig (ou link:dyig).

La liste com­plète des PIDs (visibles) se trouve sur la page https://leti.lt/list. En cher­chant “dyig” on trouve l’ar­ticle cité en exemple.

Voi­ci deux entrées de la base de don­nées, ‘6ran’ and ‘rm0y’, la pre­mière sans conte­nu et la seconde avec un conte­nu bali­sé par un disque rouge (🔴) :

Une expres­sion comme (lien:6ran) figu­rant dans la colonne de gauche peut être copiée et col­lée sur n’im­porte texte du web. Il est pru­dent de copier les paren­thèses pour ne pas tron­quer l’ex­pres­sion. En fonc­tion du contexte, PID mana­ger déci­de­ra de conser­ver ces paren­thèses ou de les sup­pri­mer. Les appels d’en­trées biblio­gra­phiques peuvent être plus expli­cites, comme par exemple (Blek­ken­horst L et al., 2015 lien:6ran).

Les cibles des PIDs sur leti.lt devraient être des DOIs chaque fois que pos­sible. Mais par­fois il vaut mieux sai­sir l’URL (plus ou moins pérenne) d’une publi­ca­tion quand celle-ci conduit à la ver­sion inté­grale de l’ar­ticle par­ta­gée par ses auteurs. D’autre part, il n’est pas garan­ti qu’un DOI attri­bué à une pré-publi­ca­tion sera iden­tique à celui de la publi­ca­tion finale. Enfin, cer­tains DOIs pointent vers le fichier PDF du texte inté­gral et non vers la page de l’ar­ticle, ce qui est une erreur d’ar­chi­vage.

Le plu­gin Bro­ken Link Che­cker ins­tal­lé sur le site se charge de repé­rer les liens deve­nus obso­lètes. Sur la page https://leti.lt/list, les admi­nis­tra­teurs ont accès à des bou­tons per­met­tant de cor­ri­ger l’URL cible d’un PID, sa des­crip­tion, ou encore de le sup­pri­mer s’il n’est plus utile loca­le­ment.

Sur la page https://leti.lt/list, tous les liens contiennent un champ title. Cela veut dire qu’en fai­sant glis­ser le cur­seur sur le lien ‘6ran’ on fait appa­raître la des­crip­tion de “Die­ta­ry satu­ra­ted fat intake and athe­ros­cle­ro­tic vas­cu­lar disease mor­ta­li­ty in elder­ly women : a pros­pec­tive cohort stu­dy (ver­sion 2019-12-19)”. Mal­heu­reu­se­ment, ce champ est effa­cé chaque fois qu’on colle le lien dans un texte en édi­tion Word­Press — à moins de réa­li­ser ce col­lage en mode HTML… PID mana­ger se charge de res­ti­tuer les titles sur les liens.

La date “(ver­sion 2019-12-19)” appa­rais­sant à la fin d’un title est celle à laquelle le PID a été créé.

Création d’un PID

Au bas de la page https://leti.lt/list se trouve un lien qui per­met de s’i­den­ti­fier comme admi­nis­tra­teur du ser­vice de PIDs. D’autres liens appa­raissent ensuite qui conduisent à la page de sai­sie des PIDs. Sup­po­sons qu’on ait besoin d’un PID pour “Juk­ka K. Kor­pe­la : IT and com­mu­ni­ca­tion” dont l’URL est http://jkorpela.fi/. On sai­sit les deux para­mètres :

Après avoir cli­qué “Create PID” on obtient :

Noter que pour cet exemple le pro­to­cole d’ac­cès à la cible est ‘http’ et non ‘https’. Le pro­to­cole sécu­ri­sé ‘https’ est deve­nu le stan­dard des sites web bien qu’il n’ait pas encore été implé­men­té sur les plus anciens. PID mana­ger véri­fie l’ac­cès selon les deux pro­to­coles et com­pare les résul­tats en nombres d’oc­tets. Si ‘https’ affiche une page dont la taille est égale ou supé­rieure à “http”, ce pro­to­cole est enre­gis­tré dans la base de don­nées. Sur la page https://leti.lt/list, les URLs qu’on n’a pas réus­si à ouvrir sous ‘https’ sont sur­li­gnées en jaune. L’ad­mi­nis­tra­teur devra cli­quer de temps en temps un bou­ton de mise à jour jus­qu’à ce que le pro­to­cole “https” ait été confir­mé.

Quel que soit le pro­to­cole, le PID ‘1ppb’ a été créé pour le site de Juk­ka. À pré­sent, (lien:1pbb) conduit à la cible. Au cas où la chaîne de carac­tères choi­sie au hasard aurait l’air bizarre, il suf­fit de cli­quer “Choose a dif­ferent PID” pour en obte­nir une nou­velle.

PID mana­ger pré­vient l’ad­mi­nis­tra­teur s’il existe déjà un PID condui­sant à la même adresse. Une option de modi­fier la des­crip­tion est alors pré­sen­tée. Afin de faire coïn­ci­der les adresses équi­va­lentes, les URLs sont stan­dar­di­sées. Par exemple, la copie de l’URL de la page « Cor­ti­coïde » sur Wiki­pe­dia se pré­sente ain­si :
https://fr.wikipedia.org/wiki/Cortico%C3%AFde

Mais PID mana­ger l’en­re­gistre comme :
https://fr.wikipedia.org/wiki/Corticoïde
ce qui est équi­valent mais plus lisible. Cette situa­tion est ren­con­trée chaque fois qu’un URL contient des carac­tères Uni­code étran­gers à l’al­pha­bet anglais.

De plus, PID mana­ger peut tron­quer l’URL au point où des don­nées de navi­ga­tion entrent en jeu. C’est le cas d’URL qui se pro­longent de séquences ‘?utm­source=…’ ou ‘?fbclid=…’ qui per­mettent aux ges­tion­naire de sites de gar­der une trace de l’o­ri­gine du visi­teur !

Comment lancer PID manager

Après iden­ti­fi­ca­tion en tant qu’ad­mi­nis­tra­teur sur le ser­veur de PID, il est pos­sible d’af­fi­cher la page des articles qui com­prend trois bou­tons actifs :

• “Add URL” inclut à la liste une page ou un article du site ;
• “Delete” efface de la liste une page ou un article du site ;
• “Run PID mana­ger” lance PID Mana­ger sur la page ou l’ar­ticle.

Aucun para­mètre n’a besoin d’être sai­si pour lan­cer PID mana­ger car toutes les options font l’ob­jet d’ins­crip­tions sur la page elle-même (voir ci-des­sous). Cli­quer seule­ment le bou­ton “Run PID mana­ger” :

Après son tra­vail PID mana­ger ouvre dans une nou­velle fenêtre la page conver­tie et affiche un bou­ton “Undo” qui per­met d’an­nu­ler l’o­pé­ra­tion :

Noter que PID mana­ger ne fonc­tionne que sur des pages ou articles com­po­sés avec le nou­vel édi­teur de Word­Press (Guten­berg). Toute ten­ta­tive de le lan­cer sur du code Clas­sic pro­dui­ra un mes­sage d’er­reur, et aucune modi­fi­ca­tion ne sera effec­tuée.

Fonctionnement de base

Deux types de docu­ments tex­tuels peuvent être publiés sur un site Word­Press : des pages et des articles. La dis­tinc­tion réside dans leurs modes de clas­si­fi­ca­tion. Les articles sont grou­pés par caté­go­ries et tendent à appa­raître en ordre chro­no­lo­gique, tan­dis que les pages sont sup­po­sées repré­sen­ter des don­nées intem­po­relles. Cette dis­tinc­tion n’a aucune impor­tance pour PID mana­ger qui ne prend en compte que le conte­nu de la page ou de l’ar­ticle. Dans ce qui suit, le mot « page » est uti­li­sé pour dési­gner les deux types.

En pla­çant des PIDs dans le corps d’un texte, on rend sa lec­ture moins agréable. C’é­tait la pre­mière rai­son de créer PID mana­ger qui les rem­place par des liens plus courts sous la forme d’ap­pels de notes de bas de page — voir le chan­ge­ment de gauche à droite dans l’i­mage ci-des­sus.

Pre­nons par exemple la phrase :

There is an esca­la­ting debate over the value and vali­di­ty of memo­ry-based die­ta­ry assess­ment methods (Archer E et al., 2018 lien:5ys0).

Après avoir été trai­tée par PID mana­ger, elle devient :

There is an esca­la­ting debate over the value and vali­di­ty of memo­ry-based die­ta­ry assess­ment methods (Archer E et al., 2018^N6).

Ce trai­te­ment prend en compte (on l’es­père) toutes les variantes de syn­taxe, déci­dant là où l’on devrait sup­pri­mer les paren­thèses et uti­li­ser des expo­sants afin que le PID appa­raisse sous une forme com­pré­hen­sible et com­pacte. Plu­sieurs niveaux peuvent s’a­vé­rer néces­saires, comme par exemple :

Une autre patho­lo­gie qui n’est pas abor­dée dans cet article est l’ané­vrisme (N8 ; vidéo^N9).

La typo­gra­phie fran­co­phone n’adhère pas à la conven­tion de Modern Lan­guage Asso­cia­tion (lien:9t7t) selon laquelle les expo­sants devraient être pla­cés après les signes de ponc­tua­tion. Cette option est tou­te­fois pré­vue dans PID mana­ger pour gérer les textes en anglais. Une ver­sion mul­ti­lingue est envi­sa­gée.

Il est pos­sible de lan­cer PID mana­ger plu­sieurs fois sur la même page. Si son conte­nu n’a pas été modi­fié, aucun chan­ge­ment n’au­ra lieu. For­mel­le­ment, si f désigne la fonc­tion exer­cée par PID mana­ger, on peut écrire : f ○ f = f

Les appels non-catégorisés (notes)

Par défaut, les appels de notes de bas de page sont éti­que­tés N1, N2 etc. et leur liste appa­raît en bas de page avec leurs des­crip­tions. Voir par exemple le bas de la page Vivre bien et long­temps. Admet­tons que ‘N’ signi­fie « note ». Ces appels sont non-caté­go­ri­sés. D’autres éti­que­tages comme A1…, B1… etc. sont uti­li­sés dans des contextes par­ti­cu­liers (voir ci-des­sous).

Pour ne pas affi­cher la liste sous forme de notes de bas de page, il faut taper _no_footnotes en fin de page. Cette ins­truc­tion est lue par PID mana­ger et enre­gis­trée pour un futur usage sous la forme d’une expres­sion invi­sible : <div id=“_no_footnotes”></div>. L’ex­pres­sion reste visible dans l’é­di­teur de Word­Press de sorte qu’on puisse la sup­pri­mer.

Les liens for­ma­tés par PID mana­ger sont convi­viaux : ils affichent leur des­crip­tion en « sur­vol de sou­ris » (les champs title des liens HTM) et ils ouvrent une nou­velle fenêtre lors­qu’on les clique :

Cette ouver­ture de nou­velle fenêtre fonc­tionne même si la confi­gu­ra­tion du navi­ga­teur bloque l’af­fi­chage de fenêtres sur­gis­santes (pop-up).

Appels catégorisés (entrées bibliographiques)

Toute page web devrait affi­cher une biblio­gra­phie lisible en impres­sion sur papier. C’est le cas de la page Soi­gner ses artères. Les entrées biblio­gra­phiques avaient été sai­sies sous la forme :

Après trai­te­ment par PID mana­ger elles appa­raissent ain­si :

Les appels de notes ‘A1’ et ‘A2’ ont été créés, dis­tincts de ‘N1’, ‘N2’ etc

Dans le corps du texte, tous les appels éti­que­tés pré­cé­dem­ment comme « lien:exjf » ont été rem­pla­cés par « A1 », le plus sou­vent en expo­sants. En fai­sant glis­ser la sou­ris sur “A1” on fait appa­raître la des­crip­tion (champ title) et en cli­quant le lien on ouvre sa cible dans une nou­velle fenêtre.

Le sym­bole ‘✓’ près de la balise H2, H3 ou H4 dans l’en­tête d’une liste biblio­gra­phique (<h2>✓ ou <h3>✓ ou <h4>✓) indique à PID mana­ger que cette liste doit être caté­go­ri­sée.

➡ Le sym­bole ‘✓’ est un carac­tère Uni­code, pas une image. Ne pas tenir compte du carac­tère ‘⇪’ qui est un lien option­nel per­met­tant de remon­ter à la table des matières.

PID mana­ger ne fait pas que refor­ma­ter les appels de notes de pages et leurs listes. Il enre­gistre aus­si l’en­trée com­plète (leur conte­nu) dans la base de don­nées des PIDs. Il lit cette entrée dans la biblio­gra­phie et en com­pare la lon­gueur avec le conte­nu déjà enre­gis­tré dans la base de don­nées, le cas échéant, et avec la des­crip­tion. Le conte­nu le plus long est enre­gis­tré s’il est dif­fé­rent de la des­crip­tion.

Réci­pro­que­ment, le conte­nu enr­te­gis­tré dans la base de don­nées sera copié dans la biblio­gra­phie s’il est plus long que l’en­trée qui y figure déjà. On peut uti­li­ser ce méca­nisme pour construire les biblio­gra­phies de manière très rapide. Par exemple, taper seule­ment :

Après trai­te­ment par PID mana­ger on obtient les entrées com­plètes parce que les conte­nus de ‘exjf’ et ‘3a5m’ avaient déjà été sai­sis dans la base :

Bien noter que le « texte quel­conque » ins­crit après “lien:3a5m” devait être plus court que la des­crip­tion du PID ‘3a5m’, faute de quoi il aurait été récu­pé­ré et enre­gis­tré comme nou­veau conte­nu.

On peut créer plu­sieurs listes biblio­gra­phiques sur la même page cor­res­pon­dant à plu­sieurs caté­go­ries de publi­ca­tions. Par exemple, sur la page Sta­tines et médi­ca­ments anti­cho­les­té­rol on trouve 3 caté­go­ries de publi­ca­tions avec pour pré­fixes A, B et C. On peut uti­li­ser ‘A’ pour les “articles” et “B” pour les “books”… Sachant que ‘N’ est réser­vé aux entrées de PID non-caté­go­ri­sées, veuillez me contac­ter si vous avez besoin d’al­ler au-delà de ‘M’ !

Ordre alphabétique

Par défaut, les entrées biblio­gra­phiques caté­go­ri­sées sont main­te­nus dans l’ordre où elles ont été sai­sies. Il existe une option de tri alpha­bé­tique. Voir par exemple page Pour­quoi dimi­nuer le cho­les­té­rol ?. À l’in­verse, la biblio­gra­phie était triée en ordre chro­no­lo­gique dans Faut-il jeter les enquêtes nutri­tion­nelles ? et PID mana­ger n’a pas modi­fié l’ordre.

Pour acti­ver cette option, taper “_alpha” dans les entêtes des blocs qui contiennent des entrées biblio­gra­phiques caté­go­ri­sées à clas­ser alpha­bé­ti­que­ment, par exemple :

<h2>✓ Ouvrages _alpha

Cette ins­truc­tion sera lue par PID mana­ger et sau­ve­gar­dée pour usage ulté­rieur dans une expres­sion invi­sible du style <div id=“_alphabetic_order_1”></div>. Cette expres­sion reste visible dans l’é­di­teur de Word­Press et peut donc être effa­cée.

Bibliographie partagée

Les entrées biblio­gra­phiques qui ont été créées sur une page sont auto­ma­ti­que­ment repro­duites comme liens non-caté­go­ri­sés (notes) sur les autres pages fai­sant réfé­rence aux mêmes PIDs.

La page Can­cer – conclu­sion et réfé­rences contient toutes les réfé­rences citées sur les pages du même sujet. Pre­nons comme exemple cette réfé­rence :

Un appel du PID sfm0 se trouve aus­si sur la page Can­cer – nou­velles pistes avec pour éti­quette “N106”. PID mana­ger a donc entiè­re­ment repro­duit cette entrée au bas de la page :

Les entrées biblio­gra­phiques ain­si pro­duites peuvent ensuite être manuel­le­ment copiées sur la même page pour construire des biblio­gra­phies (appels caté­go­ri­sés) décri­vant les articles (A), les ouvrages (B) etc. Celles-ci pour­ront être triés par ordre alpha­bé­tique. Une fois qu’une entrée appa­raît comme un appel caté­go­ri­sé, PID mana­ger ne la liste plus par­mi les appels non-caté­go­ri­sés (N) — car dupli­quer des notes de bas de page serait inélé­gant…

Les conte­nus de ces entrées biblio­gra­phiques sont syn­chro­ni­sés chaque fois que PID mana­ger est lan­cé sur une page où ils appa­raissent.

Nettoyage automatique des références

Par défaut, PID mana­ger effec­tue un net­toyage des réfé­rences : toute entrée caté­go­ri­sée (biblio­gra­phie) est affi­chée en texte bar­ré si aucun appel de cette réfé­rence n’existe dans le texte de la page. Par exemple :

Ce dis­po­si­tif peut être désac­ti­vé en écri­vant “_no_strike” n’im­porte où sur la page. Cette ins­truc­tion sera sai­sie par PID mana­ger et conser­vée pour son pro­chain usage sous forme de l’ex­pres­sion invi­sible : <div id=“_no_strike”></div>. Cette expres­sion reste visible dans l’é­di­teur Word­Press et peut donc être sup­pri­mée.

En outre, si vous sou­hai­tez que ces notices biblio­gra­phiques res­tent inchan­gées sur la page, tapez “_no_modify” n’im­porte où sur la page. Exemple : https://leti.lt/ljg6.

Suppression des indices

Les indices peuvent être sup­pri­més de toute liste d’en­trées caté­go­ri­sées, notam­ment si ces entrées ne figurent pas dans le texte de la page. Le résul­tat est par exemple :

Cette option peut être acti­vée en écri­vant “_no_label” n’im­porte où sur la page. Cette ins­truc­tion sera sai­sie par PID mana­ger et conser­vée pour son pro­chain usage sous forme de l’ex­pres­sion invi­sible : <div id=“_no_label”></div>. Cette expres­sion reste visible dans l’é­di­teur Word­Press et peut donc être sup­pri­mée.

Pas de lecteur audio

Par défault, PID mana­ger insère un élé­ment audio player dans la page, de sorte que Meks Audio Player est affi­ché et acti­vé par le fichier sonore pro­duit par SPEAKER — voir la page Lec­ture auto­ma­tique TTS. Les pages qui n’u­ti­lisent pas la lec­ture auto­ma­tique peuvent rece­voir l’i­den­ti­fiant « _no_speaker » qui est conver­ti en <div id=“_no_speaker”>.

“No recode” + récupération des pages

Cer­taines pages ne doivent pas être trai­tées par PID mana­ger. Celle-ci par exemple. Afin de les pro­té­ger contre un trai­te­ment acci­den­tel, taper “_no_recode” n’im­porte où dans la page. Cette ins­truc­tion sera lue par PID mana­ger et sau­ve­gar­dée pour usage ulté­rieur dans l’ex­pres­sion invi­sible <div id=“_no_recode”></div>.

PID mana­ger modi­fie le conte­nu tex­tuel d’une page sans en créer une nou­velle ver­sion dans la base Word­Press. Il ne modi­fie même pas la date de la der­nière modi­fi­ca­tion. Ce qui veut dire qu’en cas de pro­blème on ne peut pas récu­pé­rer la ver­sion ini­tiale dans l’en­vi­ron­ne­ment Word­Press. Pour reve­nir à la ver­sion ini­tiale, cli­quer le bou­ton “Undo” comme expli­qué ci-des­sus.

Les sau­ve­gardes sont écra­sées chaque fois que le trai­te­ment est appli­qué. Il est donc pru­dent de s’as­su­rer que le résul­tat est celui escomp­té. Le plus sûr est de gar­der à por­tée de main la page ini­tiale ouverte dans l’é­di­teur pen­dant qu’on uti­lise PID mana­ger. Si le résul­tat ne convient pas, cli­quer le bou­ton “Mettre à jour” pour res­ti­tuer la ver­sion avant trai­te­ment.

Table des matières

Ce site construit des tables de matières sur les pages en uti­li­sant le plu­gin CM Table Of Contents Pro. Cette page contient par exemple une table des matières. Le plu­gin construit dyna­mi­que­ment une table à par­tir de la hié­rar­chie des balises<h1>, <h2>, <h3> etc. Un mar­queur spé­ci­fique [cmtoc_…] doit être ins­crit à l’emplacement où la table devra appa­raître.

PID mana­ger cherche ce mar­queur [cmtoc_…]. S’il le trouve il effec­tue deux modi­fi­ca­tions :

1. Inser­tion du mot “Som­maire” au-des­sus de la table des matières, avec la balise (ancre) id=“toc”. Cet iden­ti­fiant est à la fois uti­li­sé pour retour­ner au som­maire et pour for­ma­ter ce mot dans la CSS du site.
2. Inser­tion d’une flèche (⇪) au début de chaque entête <h…> pour retour­ner au som­maire de la table des matières.

Ce dis­po­si­tif de table des matières est option­nel : PID mana­ger ne l’en­tre­prend que s’il a repé­ré le mar­queur [cmtoc_…] sur la page.

Syntaxe des appels de notes

Dans la plu­part des cas, les appels de notes obéissent à une syn­taxe simple, comme par exemple :

There is an esca­la­ting debate over the value and vali­di­ty of memo­ry-based die­ta­ry assess­ment methods (Archer E et al., 2018 lien:5ys0).

Tou­te­fois, des appels mul­tiples existent :

There is an esca­la­ting debate over the value and vali­di­ty of memo­ry-based die­ta­ry assess­ment methods (Archer E et al., 2018 lien:5ys0, lien:yhcg ; Young SS, Karr A, 2011 lien:5ep8).

Après trai­te­ment par PID mana­ger cette phrase devient :

There is an esca­la­ting debate over the value and vali­di­ty of memo­ry-based die­ta­ry assess­ment methods (Archer E et al., 2018^N9·N13 ; Young SS, Karr A, 2011^N14).

Les entrées mul­tiples sont grou­pées lors­qu’elles sont connec­tées par des vir­gules ou des espaces, par exemple :

Voir Archer, E et al. (2018 lien:54ji, lien:aw3j, lien:cm76 ; 2017 lien:nxg2 ou encore 2015 lien:f4st lien:ohn3 lien:s9ks).

qui donne :

Voir Archer, E et al. (2018^{N13·N14·N15} ; 2017^N16 ou encore 2015^{N17·N18·N19}).

De nom­breuses variantes de syn­taxe d’ap­pels biblio­gra­phiques sont prises en compte par PID mana­ger. Cer­taines erreurs (comme des fer­me­tures de paren­thèses mal édi­tées) peuvent être auto­ma­ti­que­ment cor­ri­gées. De nou­veaux cas seront inclus à l’im­plé­men­ta­tion chaque fois que pos­sible.

PID mana­ger n’est pas sup­po­sé cor­ri­ger la typo­gra­phie. Tou­te­fois, il fait de son mieux pour pré­pa­rer le texte à un trai­te­ment par un plu­gin de typo­gra­phie auto­ma­tique comme WP-Typo­gra­phy. Par exemple, dans la ver­sion actuelle (mai 2020) WP-Typo­gra­phy ne gère pas bien un guille­met fer­mant en fran­çais quand celui-ci est sui­vi par un expo­sant (voir image ci-des­sus).

PID mana­ger anti­cipe ce pro­blème en insé­rant le code néces­saire à un bon trai­te­ment (voir image ci-contre).

PID mana­ger rem­place toutes les espaces insé­cables “&nbsp ;” par des espaces ordi­naires dans le corps du texte, puis il les réin­tro­duit à la suite de chiffres — comme dans « 100_000 » ou « 35_mètres ». Les espaces insé­cables asso­ciées en fran­çais à cer­tains signes de ponc­tua­tion ou à l’in­té­rieur des guille­mets « che­vrons » sont recons­truites par WP-Typo­gra­phy.

D’autres cor­rec­tions auto­ma­tiques pour­raient être implé­men­tées dans PID mana­ger tout en veillant à ne pas rendre les conte­nus de pages incom­pa­tibles avec de futures ver­sions de Word­Press ou des wid­gets gérés par son édi­teur Guten­berg.

Une ten­ta­tive d’u­ti­li­ser le nar­row no-break space “&#8239 ;” en rem­pla­ce­ment de “&nbsp ;” a été aban­don­née car ce carac­tère n’est pas (encore ?) recon­nu par le navi­ga­teur Safa­ri. C’est aus­si une option de WP-typo­gra­phy.

Sécurité

Il est clair que les dis­po­si­tifs de sécu­ri­té implé­men­tés dans Word­Press ou ajou­tés sous forme de plu­gins n’ap­pré­cient pas qu’un script « étran­ger » à l’ins­tal­la­tion puisse effec­tuer des modi­fi­ca­tions dans la base de don­nées. Selon le sys­tème ins­tal­lé il est donc néces­saire d’a­jou­ter des auto­ri­sa­tions pour que PID mana­ger fonc­tionne cor­rec­te­ment. Par exemple, inclure la famille des IP géné­rées par la borne ADSL à la white list du sys­tème de sécu­ri­té.

Limites actuelles

À pré­sent, PID mana­ger modi­fie les codes HTML sui­vants :

1. Les balises <i> sont rem­pla­cées par <em>
2. Les balises <b> sont rem­pla­cées par <strong>
3. Les espaces insé­cables “&nbsp ;” peuvent être sup­pri­mées (voir ci-des­sus)
4. Les séquences d’es­paces sont rem­pla­cées par une espace unique
5. Les ins­truc­tions <span> sont sup­pri­mées dans les entêtes de para­graphes
6. Les mar­queurs id=“…” à l’in­té­rieur des balises H1, H2 etc. sont sup­pri­més

Les deux pre­mières opé­ra­tions sont en accord avec une pra­tique stan­dard de l’é­di­teur de Word­Press. Les séquences d’es­paces sont rem­pla­cées par une espace unique dans WP-Typo­gra­phy.

Pour conclure…

Le tra­vail avec les iden­ti­fiants pérennes était mon domaine d’ex­per­tise quand j’é­tais enga­gé dans les Digi­tal Huma­ni­ties (lien:wvdl). Les DH sont une branche d’ac­ti­vi­té uni­ver­si­taire qui com­prend l’u­ti­li­sa­tion sys­té­ma­tique de res­sources numé­riques dans les sciences humaines et sociales, ain­si que pour l’a­na­lyse de leurs usages. J’ai pris part à un pro­jet pilote (avec le CINES et l’IN2P3) pour la créa­tion de pla­te­formes de dépôt et de par­tage de res­sources lin­guis­tiques des­ti­nées à un archi­vage pérenne. Ce pro­jet s’est arti­cu­lé plus tard sur des infra­struc­tures de docu­men­ta­tion et de recherche euro­péennes comme CLARIN and DARIAH. C’est pour­quoi je suis par­ti­cu­liè­re­ment atten­tif à recher­cher les sources d’in­for­ma­tion les plus cer­taines et les plus uti­li­sables, ain­si qu’à garan­tir un accès fiable à ces don­nées.

J’in­vite les lecteurs/trices et desi­gners à me faire par­ve­nir des sug­ges­tions d’a­mé­lio­ra­tion de PID mana­ger. L’im­plan­ta­tion sur d’autres sites est ouverte à dis­cus­sion. On peut uti­li­ser à cet effet ma page de contact ou pos­ter des com­men­taires publics aux bas de cette page…