Differences

This shows you the differences between two versions of the page.

--- fr:dev:citation_styles:style_editing_step-by-step [2017/11/12 19:53] – external edit 127.0.0.1
+++ fr:dev:citation_styles:style_editing_step-by-step [2018/11/16 09:19] – upgrade and update - translation of the English version fflamerie
@@ Line 1: / Line 1: @@
-<html><p id="zotero-5-update-warning" style="color: red; font-weight: bold">We’re
+======Editer des styles CSL - Guide pas à pas======
-in the process of updating the documentation for
-<a href="https://www.zotero.org/blog/zotero-5-0">Zotero 5.0</a>. Some documentation
-may be outdated in the meantime. Thanks for your understanding.</p></html>
-======Modifier les styles CSL - Guide pas-à-pas======
+=====L'éditeur visuel CSL=====
+Une collaboration entre la bibliothèque de l'université de Columbia et Mendeley a permis le développement d'un éditeur visuel CSL open source. Vous pouvez trouver l'éditeur [[http://editor.citationstyles.org/about/|ici]] et son guide d'utilisation
+[[https://github.com/citation-style-editor/csl-editor/wiki/User-guide-for-the-CSL-Editor|ici]]. Si vous rencontrez toutefois des difficultés pour éditez des styles, vous pouvez demander de l'aide sur les forums Zotero. Vous pouvez rapporter les bogues [[https://github.com/citation-style-editor/csl-editor/issues|ici]] - assurez-vous de rapporter des erreurs reproductibles. Le traqueur de problèmes GitHub n'est pas le lieu où poser des questions.
-=====L'éditeur visuel : "CSL Visual Editor"=====
+=====Editer manuellement les styles CSL=====
+Dans de nombreux cas, vous pouvez toujours vouloir éditer manuellement les styles CSL. Le présent guide fournit les étapes, faciles à suivre, pour ce faire.
-Un éditeur visuel de style CSL a été développé (open-source, il est le fruit d'une collaboration entre la bibliothèque de l'Université Columbia et Mendeley). Il est disponible [[http://editor.citationstyles.org/about/|ici]].
+==== 1 - Commencez avec le bon style ====
-Un guide sommaire d'utilisation est en création (en anglais) [[https://github.com/citation-style-editor/csl-editor/wiki/User-guide-for-the-CSL-Editor|ici]]. Si vous avez toutefois des difficultés à modifier des styles avec l'éditeur visuel, vous pouvez demander de l'aide sur le forum Zotero. Vous pouvez rapporter les bogues [[https://github.com/citation-style-editor/csl-editor/issues|ici]] - assurez-vous de rapporter des erreurs reproductibles par quiconque. (Par ailleurs, le tracker GitHub n'est pas le lieu où poser des questions.)
-=====Modification manuelle des styles CSL=====
+Commencez par vérifier l'[[/styles|entrepôt des styles Zotero]]. Si vous voulez améliorer un style CSL existant, assurez-vous que vous partez de sa version la plus récente (l'entrepôt indique pour chaque style la date et l'heure de sa dernière mise à jour).  Si vous voulez créer un nouveau style, trouvez le style qui correspond le mieux à vos besoins en utilisant les prévisualisations dans l'entrepôt des styles.
-Dans un certain nombre de cas, il est plus rapide de modifier manuellement un style. Ce guide indique quelles étapes suivre.
+Généralement, la meilleure façon de trouver un style très similaire est d'utiliser la fonction "[[http://editor.citationstyles.org/searchByExample/|Search by Example]]" (recherche par l'exemple) de l'éditeur visuel.
-==== 1 - Choisir le bon style ====
+==== 2 - Editez le style ====
-Commencez par jeter un œil au [[/styles|dépôt des styles Zotero]]. Si vous voulez améliorer un style existant, assurez-vous que vous avez la version la plus récente (le dépôt indique la date et l'heure auxquelles chaque style ont été mis à jour). Si vous voulez créer un nouveau style, trouvez le style qui est le plus proche de vos besoins en utilisant la fonction de prévisualisation (en passant la souris au-dessus du nom du style).
+Téléchargez le style que vous souhaitez modifier sur votre ordinateur, et ouvrez le avec un (simple) éditeur de texte comme le Bloc-Notes sous Windows, TextEdit sous Mac OS X (veillez alors à choisir "Convertir au format texte"  dans le menu "Format"), ou gedit sous Linux.
-La façon la plus simple d'identifier le style le plus proche est d'utiliser la fonction "[[http://editor.citationstyles.org/searchByExample/|Recherche par l'exemple]]" (search by Example) de l'éditeur visuel.
+Les autres possibilités sont [[http://notepad-plus-plus.org/|Notepad++]] pour Windows, [[http://www.barebones.com/products/TextWrangler/|TextWrangler]] pour Mac OS X, [[http://www.oxygenxml.com/|oXygen XML Editor]], [[http://www.thaiopensource.com/nxml-mode/|Emacs en mode nXML]], et [[http://www.jedit.org/|jEdit]], qui prennent tous en charge la mise en surbrillance de la syntaxe XML (CSL est un langage de type XML) et dans certains cas également la [[https://github.com/citation-style-language/styles/wiki/Validation|validation conformément au schéma CSL]] en temps réel.
-**Important** Si vous avez utilisé Zotero 2.0 ou une version antérieure sur votre ordinateur, votre [[/support/fr/zotero_data|répertoire de données Zotero]] contient probablement encore des styles au format CSL 0.8.1. Bien que Zotero 2.1 (et suivants) supporte encore ce vieux format, il est fortement recommandé de toujours commencer avec une version à jour d'un style CSL 1.0 du [[/styles|dépôt des styles Zotero]] ou, si vous voulez modifier un style CSL 0.8.1 non présent dans le dépôt, de commencer par le [[http://citationstyles.org/downloads/upgrade-notes.html#updating-csl-0-8-styles|mettre à jour vers CSL 1.0]].
+Collez le code du style dans l' [[/support/fr/dev/citation_styles/reference_test_pane|éditeur de style Zotero]], afin de visualiser instantanément l'effet des modifications du code sur la mise en forme produite par le style. Si vous éditez le style  directement dans le panneau d'édition, sauvegardez vos modifications régulièrement en utilisant votre éditeur de texte ou le bouton "Enregistrer sous..." {{:dev/citation_styles/csledit-save.png}}, car les changements effectués dans le panneau d'édition peuvent facilement être perdus.
+Consultez la [[http://citationstyles.org/citation-style-language/documentation/|page de documentation]] du site du projet CSL pour plus d'informations sur les posibilités d'édition CSL (en particulier, assurez-vous de jetez un coup d'œil attentif à la [[http://citationstyles.org/downloads/specification.html|spécification CSL]]. Nous présentons plus bas quelques modifications de style simples et courantes pour vous aider à démarrer.
-==== 2 - Modifier le style ====
+=== Modifier le titre et l'identifiant du style ===
-Téléchargez le style que vous souhaitez modifier sur votre ordinateur, et ouvrez le avec un éditeur de texte comme le Bloc-Notes sous Windows, TextEdit sous Mac OS X (veillez alors à choisir "Convertir au format texte"  dans le menu "Format"), ou gedit sous Linux.
+**Important:** Avant d'installer votre style édité, vous devez changer son titre et son identifiant au début du code du style. Si vous ne les changez pas, votre style modifié sera écrasé à la prochaine mise à jour du style original dont il est dérivé.
-Les autres possibilités sont [[http://notepad-plus-plus.org/|Notepad++]] pour Windows, [[http://www.barebones.com/products/TextWrangler/|TextWrangler]] pour Mac OS X, [[http://www.oxygenxml.com/|oXygen XML Editor]], [[http://www.thaiopensource.com/nxml-mode/|Emacs en mode nXML]], et [[http://www.jedit.org/|jEdit]], qui supportent tous aussi la mise en surbrillance de la syntaxe XML (CSL est un langage de type XML) et dans certains cas également la [[https://github.com/citation-style-language/styles/wiki/Validation|validation conformément au schéma CSL]] en temps réel.
-Collez le code du style dans le [[/support/fr/dev/citation_styles/reference_test_pane|Panneau de test Zotero]], de façon à voir instantanément les effets de vos modifications de code sur les références. Si vous modifiez directement le style dans le panneau de test, sauvegardez ces changements régulièrement en utilisant votre éditeur de texte : le panneau de test n'a pas, actuellement, de fonction de sauvegarde et les modifications sont facilement perdues !
+Le titre et l'identifiant du style sont stockés dans les éléments ''<title/>'' et ''<id/>'', au début du code. Par exemple,
+<code><title>American Psychological Association 6th edition</title>
+<title-short>APA</title-short>
+<id>http://www.zotero.org/styles/apa</id></code>
+peut être changé en
+<code><title>American Psychological Association 6th edition Modified</title>
+<title-short>APA</title-short>
+<id>http://www.zotero.org/styles/apa-modified</id></code>
+Il n'est pas nécessaire que les URLs que vous insérez comme identifiants existent : vous pouvez utiliser un identifiant de type zotero.org/style/mystyle même si le style ne sera pas publié dans l'entrepôt Zotero
+=== Validation ===
+Avant d'installer un style modifié, assurez-vous toujours de sa validité XML et CSL en le [[https://github.com/citation-style-language/styles/wiki/Validation|validant conformément au schéma CSL]].
-Voyez la [[http://citationstyles.org/citation-style-language/documentation/|page de documentation]] du projet CSL pour des informations  sur les changements qu'il est possible de faire (en particulier, jetez un œil attentif au [[http://citationstyles.org/downloads/specification.html|cahier des charges CSL]] (CSL specification). Ci-dessous, nous présentons quelques changements courants et faciles à réaliser pour commencer.
 === Exemples de modifications ====
@@ Line 53: / Line 67: @@
 </code>
-L'avantage de l'utilisation d'un élément ''group'' est que lorsqu'une référence comporte un éditeur (''publisher'') mais n'a pas de lieu de publication (''publisher-place''), une ponctuation incorrecte ne s'affichera pas : le résultat deviendra "(CSHL Press)". Alors que si vous ajoutiez directement la ponctuation dans les éléments textes, ainsi :
+L'avantage de l'utilisation d'un élément ''group'' est que lorsqu'une référence comporte un éditeur (''publisher'') mais non un lieu de publication (''publisher-place''),vous ne vous retrouvez pas avec une ponctuation incorrecte : le résultat deviendra "(CSHL Press)". Alors que si vous ajoutiez directement la ponctuation dans les éléments "text", ainsi :
 <code xml>
@@ Line 60: / Line 74: @@
 </code>
-vous perdriez la parenthèse fermante dès que la référence ne comporte pas de lieu de publication, c'est-à-dire que s'afficherait : "(CSHL Press".
+vous perdriez la parenthèse fermante en l'absence de lieu de publication, c'est-à-dire que s'afficherait : "(CSHL Press".
-== Modifier l'abréviation Et-al ==
+== Modifier l'abréviation et-al ==
-Il y a deux paramètres principaux pour l'abréviation "et al." (c'est-à-dire, afficher les noms "Doe, Smith & Johnson" comme "Doe et al."). Le nombre minimum des noms pour activer "et al.", d'une part, et le nombre de noms affichés avant "et al.", d'autre part.
+Il y a deux paramètres principaux pour l'abréviation et-al, c'est-à-dire pour afficher les noms "Doe, Smith & Johnson" sous la forme "Doe et al.". Le nombre minimum de noms pour activer l'abréviation et-al, d'une part, et le nombre de noms affichés avant "et al." d'autre part.
-Dans CSL, ces paramètres peuvent apparaître dans les éléments ''style'', ''citation'', ''bibliography'' ou ''names'' sous la forme des attributs ''et-al-min'' et ''et-al-use-first'' (il est possilbe d'avoir des paramètres séparés pour les références qui ont déjà été citées en utilisant les attributs ''et-al-subsequent-min'' et ''et-al-subsequent-use-first'').
+Dans CSL, ces paramètres peuvent apparaître dans les éléments "style", "citation", "bibliography" ou "names" sous la forme des attributs "et-al-min" et "et-al-use-first". Il est possible de définir des paramètres séparés pour les références qui ont déjà été citées en utilisant les attributs "et-al-subsequent-min" et "et-al-subsequent-use-first".
 Par exemple,
@@ Line 76: / Line 90: @@
 </code>
-affichera une liste de noms du style : "Dupond", "Dupond & Haddock" et, s'il y a trois noms ou plus, "Dupond et al.". Essayez de changer ces nombres et observez l'effet.
+affichera une liste de noms du type : "Doe", "Doe & Smith" et, s'il y a trois noms ou plus, "Doe et al.". Essayez de changer ces nombres et observez l'effet.
 ==Modifier les options de désambigüisation==
-CSL offre des méthodes multiples pour rendre les citations et les noms non-ambigus Par exemple, un style peut normalement n'afficher que le nom de famille (ex., "(Durand 1999, Durand 2002)"). Si les auteurs sont Jean Durand et Pauline Durand, ces noms seront désambiguïsés en ajoutant l'initiale ou le prénom complet (ex., "(J. Durand 1999, P. Durand 2002)").
+CSL offre de multiples méthodes  pour désambiguïser les citations ou les noms. Par exemple, un style peut normalement afficher uniquement le nom de famille, par exemple "(Doe 1999, Doe 2002)". Si les auteurs sont Jane Doe et Thomas Doe, ces noms seront désambiguïsés par l'ajout de l'initiale ou du prénom complet, par exemple "(J. Doe 1999, T. Doe 2002)").
-Les méthodes de désambigüisation sont sélectionnées au niveau de l'élément ''citation''. par exemple, pour désactiver la [[fr/kb/given_name_disambiguation|désambigüisation des prénoms]], supprimez l'attribut ''disambiguate-add-givenname'', c'est-à-dire changez
+Les méthodes de désambigüisation sont sélectionnées au niveau de l'élément ''citation''. Par exemple, pour désactiver la [[fr/kb/given_name_disambiguation|désambiguïsation des prénoms]], supprimez l'attribut ''disambiguate-add-givenname'', c'est-à-dire transformez
 <code xml>
@@ Line 90: / Line 104: @@
 </code>
-pour
+en
 <code xml>
@@ Line 98: / Line 112: @@
 </code>
-=== Modifier le titre du style et son ID ===
+==Séparation des auteurs==
-Avant d'installer votre style modifié, changez sont titre et son ID si vous ne souhaitez pas remplacer le style original par le vôtre.
+Par défaut, plusieurs auteurs sont séparés par un délimiteur ", " et le mot ''et''. Ces paramètres peuvent être modifiés, par exemple pour utiliser le symbole "&" à la place de "et" :
-Le titre du style et l'ID sont enregistrés dans les éléments ''<title/>'' et ''<id/>'' près du début du style. Par exemple,
+<code xml>
+<names variable="author">
+  <name form="short" and="symbol" delimiter=", "/>
+  ...
+</names>
+</code>
-<code><title>Harvard Reference format 1 (Author-Date)</title>
+ou pour ne pas utiliser du tout ''et'', mais utiliser uniquement le délimiteur ''/'':
-<id>http://www.zotero.org/styles/harvard1</id></code>
-peut être changé pour :
+<code xml>
+<names variable="author">
+  <name form="short" delimiter="/"/>
+  ..
+</names>
+</code>
-<code><title>Harvard Style Modification Perso</title>
+== Mise en forme conditionnelle (style avec notes de bas de page complètes) ==
-<id>http://www.zotero.org/styles/harvard-modificaton-perso</id></code>
-Les adresses URLs que vous indiquez comme ID n'ont pas à exister, c'est-à-dire que vous pouvez utiliser un ID comme  http://www.zotero.org/style/monstyle même si ce style ne sera pas diffusé sur le dépôt de style Zotero.
+L'apparence des citations dans les styles avec notes de bas de page (complètes) peut dépendre de leur position dans le document. Si la même source est citée deux fois, une version abrégée peut être utilisée dans la deuxième citation (et dans toutes les suivantes). Pour gérer cette distinction, on peut utiliser la  [[http://citationstyles.org/downloads/specification.html#choose|mise en forme conditionnelle fondée sur la position]] de la citation. Une structure générique pourrait alors ressembler à ce qui suit.
-=== Validation ===
+<code xml>
+<citation>
+  <layout>
+    <choose>
+      <if position="ibid-with-locator">
+        ...
+      </if>
+      <else-if position="ibid">
+        ...
+      </else-if>
+      <else-if position="subsequent">
+        ...
+      </else-if>
+      <else>
+        ...
+      </else>
+    </citation>
+  </layout>
+</citation>
+</code>
-Avant d'installer un style modifié, il est indispensable de vérifier qu'il s'agit d'un style valide, c'est-à-dire conforme aux exigences XML et CSL. Pour cela, il suffit de le [[https://github.com/citation-style-language/styles/wiki/Validation|valider conformément au schéma CSL]].
+Si un cas manque dans votre style, vous pouvez l'ajouter et indiquer quelles informations doivent être affichées et comment elles doivent l'être dans ce cas  ([[https://www.zotero.org/styles/chicago-fullnote-bibliography?source=1|exemple d'un tel style avec notes de bas de page complètes]]).
-==== 3 - Installer votre style modifié dans Zotero ====
+==== 3 - Installez votre style édité dans Zotero ====
-===Zotero pour Firefox===
-Enregistrez le style avec une extension de fichier ".csl" (vous pouvez généralement faire cela en tapant simplement ".csl" après le nom de votre fichier) , et glissez-déposez le fichier CSL dans une fenêtre ouverte de Firefox, et cliquez sur le bouton "Installez" (Vous pouvez ignorer la barre grise en haut de la page si elle apparaît ("This XML style does not appear...")).
-{{:style_install.png?600}}
+Voir la page de la documentation générale [[/support/styles|Les styles bibliographiques]].
-===Zotero Standalone===
+Enregistrez le style avec une extension de fichier ".csl" (vous pouvez généralement faire cela en tapant simplement ".csl" après le nom de votre fichier). Allez ensuite dans le [[/support/fr/preferences/cite|volet "Citer"]] des [[/support/fr/preferences|Préférences Zotero]]. Cliquez sur le signe "+" en-dessous de la liste des styles installés. Dans la boîte de dialogue de sélection de fichier qui s'ouvre, naviguez jusqu'au fichier .csl que vous venez de créer et ouvrez-le. Cela installera votre nouveau style.
-Enregistrez le style avec une extension de fichier ".csl" (vous pouvez généralement faire cela en tapant simplement ".csl" après le nom de votre fichier). Puis, allez dans  le [[/support/fr/preferences/cite|panneau "Citer"]] des [[/support/fr/preferences|Préférences Zotero]]. Cliquez sur le signe + sous la liste des styles installés. Dans la boîte de dialogue de sélection de fichier qui s'ouvre, choisissez le fichier .csl que vous venez de créer et ouvrez-le. Cela installera votre nouveau style.
-==== 4 - Partager les styles ====
+==== 4 - Partagez des styles ====
-Si vous pensez que votre style modifié peut être utile à d'autres, envisagez de le [[https://github.com/citation-style-language/styles/blob/master/CONTRIBUTING.md|soumettre]] au [[/styles|dépôt de style Zotero]].
+Si vous pensez que votre style modifié peut être utile à d'autres, envisagez de le [[https://github.com/citation-style-language/styles/blob/master/CONTRIBUTING.md|soumettre]] à l'[[/styles|entrepôt des styles Zotero]].
 ==== Obtenir de l'aide ====
-Si vous êtes bloqué, recherchez sur les [[/forum/|forums Zotero]], ou, si cela ne vous donne aucune réponse, postez un message (en français ou en anglais) dans la section [[/forum/11/|styles ]].
+Si vous êtes bloqué, publiez une question sur les [[/forum/|forums Zotero]].