Enregistrement source

Documentation/GUIDE_CSL-Clio.md

@@ -175,6 +175,8 @@ Pour pouvoir utiliser les styles de *CSL/Clio*, il est tout d'abord primordial d
 
 ## Utilisation avancée de *Zotero*
 
+Parmi les fonctionnalités de *Zotero* que nous allons passer en revue, seules les trois premières sont indispensables. 
+
 ### Indications de mise en forme dans une valeur de champ
 
 Il est possible de mettre certaines parties des valeurs que vous renseignez dans les champs en italiques, gras, petites capitales, indice ou exposant. C'est utile, notamment, lorsqu'un titre cite un autre titre, comme dans la [@fig:titre-dans-titre] (noter que, dans ce cas, si le titre principal était en italiques, *Dialogica polymorpha antiiudaica* serait en caractères droits).
@@ -185,7 +187,7 @@ Vous trouverez plus d'informations [ici](https://citationstyles.org/authors/#/ri
 
 ### Champ *Extra*
 
-L'interface de *Zotero* contient un champ *Extra* dans lequel l'utilisateur peut renseigner des variables qui ne sont pas prévues dans les champs proposés par défaut pour le type de document sélectionné. La syntaxe utilisée est *variable: valeur*, chaque variable étant séparée de la précédente par un passage à la ligne. Une valeur peut contenir des espaces. Pour citer un individu, il faut séparer son nom de son prénom par deux barres verticales (Altgr+6 sur un clavier AZERTY). *Le nom de la variable est celui prévu dans les [spécifications CSL](https://docs.citationstyles.org/en/1.0.1/specification.html#appendix-iv-variables), pas celui affiché dans l'interface de* Zotero *!*
+L'interface de *Zotero* contient un champ *Extra* dans lequel l'utilisateur peut renseigner des variables qui ne sont pas prévues dans les champs proposés par défaut pour le type de document sélectionné. La syntaxe utilisée est *variable: valeur*, chaque variable étant séparée de la précédente par un passage à la ligne. Une valeur peut contenir des espaces. Pour citer un individu, il faut séparer son nom de son prénom par deux barres verticales (Altgr+6 sur un clavier AZERTY). Si une variable contient plusieurs valeurs (par exemple `editor`), il faut un enregistrement complet par valeur. *Le nom de la variable est celui prévu dans les [spécifications CSL](https://docs.citationstyles.org/en/1.0.1/specification.html#appendix-iv-variables), pas celui affiché dans l'interface de* Zotero *!*
 
 Exemples :
 
@@ -193,6 +195,7 @@ Exemples :
 > editor: Nom || Prénom\
 > ~~annote: "Titre de la source"~~\
 > ~~Éditeur: Nom || Prénom~~
+> ~~Éditeur: Nom || Prénom, Autrenom || Autreprénom~~
 
 ### Intervalles de dates
 
@@ -325,12 +328,29 @@ Si vous rencontrez un problème qui concerne *Zotero* et non *CSL/Clio*, vous po
 
 ## Enregistrement des documents selon les conventions de *CSL/Clio*
 
+Cette section passe en revue les stratégies d'encodage propres à *CSL/Clio*. Pour plus de clarté, vous pouvez vous référer à la [collection de test](<!--REF-->) du projet, que vous pouvez importer dans *Zotero*.
+
 ### Rôles
 
 <!-- Préciser ici le cas particulier du collaborateur -->
 
 ### Sources primaires
 
+Le type d'une source primaire est celui de la publication qui la contient. Les informations relatives à cette publication sont enregistrées normalement, à l'exception des points suivants :
+
+  * L'auteur de la publication est indiqué comme éditeur ou traducteur ; pour certains types, comme *Thèse*, cette information doit être enregistrée dans *Extra* ;
+  * Le champ *Auteur* doit être réservé à l'auteur de la source ;
+  * Si la source est publiée dans un chapitre d'ouvrage collectif, l'éditeur du livre doit être renseigné dans le champ *Auteur du livre* ;
+  * Si la source est publliée dans une compilation d'articles d'un ou plusieurs auteurs sans qu'il n'y ait d'éditeur, les auteurs du livre doivent être enregistrés dans *Extra* avec la variable `container-author` (voir [@fig:enregistrement-doctrina-jacobi]).
+  
+Les informations suivantes peuvent être ajoutées :
+
+  * Le titre de la source doit être renseigné dans *Extra* comme valeur de la variable `annote` ;
+  * Si le titre de la source et celui de la publication sont redondants, utilisez la variable `note` dans *Extra* avec une valeur telle que « titre redondant ». Selon le style utilisé, cela conduira à afficher seulement l'un des deux titres dans la bibliographie. (*N.-B. : La variable `note` doit être réservée à cet usage.*) ;
+  * Indiquer les noms de répertoires dans *Extra* avec la variable `references` (par exemple, CPG 1536). La référence entrée sera affichée telle quelle dans la bibliographie : s'il vous faut une espace insécable entre le nom du répertoire et le numéro, il faut que l'espace soit insécable dans votre enregistrement. Notez que CSL permet seulement d'afficher ou non cette variable, mais non de choisir entre plusieurs valeurs.
+  
+![Enregistrement de la *Doctrina Jacobi* dans *Zotero*](enregistrement-doctrina-jacobi.png){#fig:enregistrement-doctrina-jacobi}
+
 ### Manuscrits
 
 ### Actes de colloque, revues, sites webs, blogs
@@ -343,10 +363,25 @@ Si vous rencontrez un problème qui concerne *Zotero* et non *CSL/Clio*, vous po
 
 ### Apostrophes et guillemets
 
+### Localisation d'un passage dans le document cité
+
+<!-- Les numéros de pages avec lignes sont séparés par " - " et non "-". Exemples :
+  Dialogue, p. 5, l. 4-5
+  Dialogue, p. 5-6
+  Dialogue, p. 5, l. 4 - p. 6, l. 12 -->
+
+<!-- Pour la PG, indiquer la colonne dans le champ page en sélectionnant "colonne", puis le bloc (A-D) ou la ligne comme une ligne (i. e. précédé de ", l. "). La macro de chaque style reformatera correctement. Exemple :
+  1208, l. A5-B3
+  1208, l. A-B
+  1208, l. A - 1211, l. C -->
+
+
 ## Pratiques à éviter
 
 ### Faire confiance à l'enregistrement automatique des références à partir du navigateur
 
+<!-- URL superflues -->
+
 ### Mettre en forme les informations en fonction d'un style donné
 
 <!-- Prénoms abrégés : empêche de désambiguiser ; si un même auteur a son prénom abrégé dans une notice et plein dans l'autre il ne sera pas reconnu comme le même auteur et le prénom risque d'être affiché en plein pour la deuxième notice -->