Listes d'abréviations + typo

Documentation/GUIDE_CSL-Clio.md

@@ -189,9 +189,9 @@ L'interface de *Zotero* contient un champ *Extra* dans lequel l'utilisateur peut
 
 Exemples :
 
-> annote: Titre de la source
-> editor: Nom || Prénom
-> ~~annote: "Titre de la source"~~
+> annote: Titre de la source\
+> editor: Nom || Prénom\
+> ~~annote: "Titre de la source"~~\
 > ~~Éditeur: Nom || Prénom~~
 
 ### Intervalles de dates
@@ -202,8 +202,8 @@ Exemples :
 
 > issued: 1999-09/1999-12\
 > issued: 1999-09/2000-01\
-> issued: 1999/2000
-> ~~issued: 1999-09/12~~
+> issued: 1999/2000\
+> ~~issued: 1999-09/12~~\
 > ~~issued: 1999-09/2000~~
 
 ### Console JavaScript
@@ -247,6 +247,77 @@ Attention : avant d'utiliser la console, faites une sauvegarde de votre répert
 
 ### Listes d'abréviations
 
+CSL ne propose qu'un mécanisme rudimentaire pour les abréviations : la variable `container-title-short`. D'une part, cette variable n'est pas prévue pour les collections ; d'autre part, son utilité est diminué par le fait que les revues et les éditeurs divergent quant aux abréviations à utiliser. *Pandoc* et *Zotero* fournissent tous deux un mécanisme pour abréger automatiquement les titres selon une liste fournie par l'utilisateur. Dans les deux cas, il faut fournir un [fichier JSON](https://www.json.org/json-fr.html) présentant la structure suivante :
+
+~~~
+{ 
+    "default": {
+        "nom-de-la-variable-a-abreger": {
+            "Titre long": "Abrev",
+            "Titre long 2": "Abrev2"
+        },
+        "nom-autre-variable": {
+            "Titre long 3": "Abrev3"
+        }
+    }
+}
+~~~
+
+[Pour *Pandoc*](https://pandoc.org/MANUAL.html#specifying-a-citation-style), son utilisation est assez simple : il suffit de reprendre cette structure, d'indiquer les noms de revues ou de collections telles qu'elles apparaissent dans la base de données et d'utiliser l'option `--citation-abbreviations` ou la métadonnées `citation-abbreviations` pour indiquer au programme où se trouve le fichier d'abréviations à utiliser lors de son invocation. Sachant que les noms de revues sont représentés par la variable `container-title`, un fichier court mais complet pourrait ressembler à :
+
+~~~
+{ 
+    "default": {
+        "container-title": {
+            "Revue de l'histoire religieuse": "RHR",
+            "Jerusalem Studies in Arabic and Islam": "JSAI"
+        },
+        "collection-title": {
+            "Sources chrétiennes": "SC"
+        }
+    }
+}
+~~~
+
+Pour *Zotero*, le cas est plus complexe. Il faut en effet transformer les titres complets selon les règles suivantes :
+
+  * Passer toutes les capitales en minuscules ;
+  * Supprimer les mots suivants : and et y und la le the l' d' ;
+  * Supprimer les caractères suivants : ! " # $ % & ' ( * )  + , . / : ; < = > ? @ [ \ ] ^ _ ` { | } ~ ;
+  * Lorsque plusieurs espaces se suivent, n'en conserver qu'un.
+  
+En outre, il faut placer en début de document l'objet suivant :
+
+~~~
+"info": {
+    "URI": "http://www.zotero.org/abbreviations/nom.json",
+    "name": "Nom du fichier d'abréviations"
+}
+~~~
+
+Si l'on reprend l'exemple précédent, cela donne :
+
+~~~
+{
+    "info": {
+        "URI": "http://www.zotero.org/abbreviations/nom.json",
+        "name": "Nom du fichier d'abréviations"
+    },
+    "default": {
+        "container-title": {
+            "revue de histoire religieuse": "RHR",
+            "jerusalem studies in arabic islam": "JSAI"
+        },
+        "collection-title": {
+            "sources chrétiennes": "SC"
+        }
+    }
+}
+~~~
+
+Pour que le fichier soit pris en compte, il doit être enregistré obligatoirement sous le nom *abbreviations.json* à la racine de votre répertoire de données, dont l'emplacement peut être trouvé via le menu *Édition > Préférences > Avancées > Fichiers et dossiers*. Il faut donc conserver l'ensemble des fichiers d'abréviations avec chacun son titre dans un répertoire distinct ou dans le même répertoire et copier celui que vous voulez utiliser en donnant ce nom à la copie. À la suite de cette opération, *Zotero* doit être redémarré s'il est ouvert pour que le changement de fichier soit pris en compte. Enfin, dans votre logiciel de traitement de texte, il faut ouvrir les préférences de l'extension *Zotero* et cocher la case *Utiliser les abréviations MEDLINE des titres de revues* (voir [@fig:preferences-medline]) ; si cette option n'apparaît pas, c'est que le style n'utilise pas les formes abrégées.
+
+![Préférences du document dans l'extension *Zotero* pour *LibreOffice*](preferences-medline.png){#fig:preferences-medline}
 
 ### Demander de l'aide et signaler des bugs