Differences

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

Link to this comparison view

Both sides previous revision Previous revision
fr:dev:citation_styles:style_editing_step-by-step [2017/11/12 19:53]
127.0.0.1 external edit
fr:dev:citation_styles:style_editing_step-by-step [2018/11/16 09:19] (current)
fflamerie upgrade and update - translation of the English version
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 existantassurez-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 casil 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.
  
-==== Choisir ​le bon style ====+==== Editez ​le style ====
  
-Commencez par jeter un œil au [[/styles|dépôt des styles Zotero]]. Si vous voulez améliorer un style existantassurez-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 styletrouvez 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 XMLet 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 formatil 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'​éditionsauvegardez 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 styleSi vous ne les changez pasvotre 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érencesSi 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 ==== === Exemples de modifications ====
Line 53: Line 67:
 </​code>​ </​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> <code xml>
Line 60: Line 74:
 </​code>​ </​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-à-direafficher 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-alc'​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, Par exemple,
Line 76: Line 90:
 </​code>​ </​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== ==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, PDurand ​2002)"​).+CSL offre de multiples ​méthodes  ​pour désambiguïser ​les citations ​ou les nomsPar 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, TDoe 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> <code xml>
Line 90: Line 104:
 </​code>​ </​code>​
  
-pour+en
  
 <code xml> <code xml>
Line 98: Line 112:
 </​code>​ </​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éfautplusieurs 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 stylePar 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 ==== ==== 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]]. 
fr/dev/citation_styles/style_editing_step-by-step.txt · Last modified: 2018/11/16 09:19 by fflamerie