Differences

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

--- fr:dev:citation_styles:style_editing_step-by-step [2013/06/27 13:02] – fr links gracile
+++ fr:dev:citation_styles:style_editing_step-by-step [Unknown date] (current) – removed - external edit (Unknown date) 127.0.0.1
@@ Line 1: / Line 1: @@
-======Modifier les styles CSL - Guide pas-à-pas======
-=====L'éditeur visuel: "CSL Visual Editor"=====
-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]].
-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=====
-Dans un certain nombre de cas, il est plus rapide de modifier manuellement un style. Ce guide indique quels étapes suivre.
-==== 1 - Choisir le bon 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).
-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.
-**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]].
-==== 2 - Modifier le 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.
-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 sur le code. 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.
-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 ====
-==Changer la punctuation==
-Dans cet example, nous voulons afficher l'éditeur ("CSHL Press") et le lieu de publication ("Cold Spring Harbor, NY") dans une entrée bibliographique. Bien que cela puisse être réalisé avec le code :
-<code>
-<text variable="publisher"/>
-<text variable="publisher-place"/>
-</code>
-cela aurait pour résultat: "CSHL PressCold Spring Harbor, NY". Heureusement, nous pouvons ajouter des signes de ponctuation grâce aux attributs ''prefix'', ''suffix'' et ''delimiter''. Imaginons que nous voulons séparer l'éditeur (''publisher'') et le lieu de publication (''publisher-place'') par une virgule et un espace, puis mettre l'ensemble entre parenthèses, c'est-à-dire "(CSHL Press, Cold Spring Harbor, NY)". Cela peut être obtenu avec :
-<code>
-<group delimiter=", " prefix="(" suffix=")">
-  <text variable="publisher"/>
-  <text variable="publisher-place"/>
-</group>
-</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:
-<code xml>
-<text variable="publisher" prefix="("/>
-<text variable="publisher-place" prefix=", " suffix=")"/>
-</code>
-vous perdriez la parenthèse fermante dès que la référence ne comporte pas de lieu de publication, c'est-à-dire "(CSHL Press".
-== Modifier l'abréviation Et-al ==
-There are two main settings for et-al abbreviation (e.g., rendering the names "Doe, Smith & Johnson" as "Doe et al."). The minimum number of names that activates et-al abbreviation, and the number of names shown before "et al.".
-In CSL, these settings can appear on the ''style'', ''citation'', ''bibliography'' or ''names'' elements in the form of the ''et-al-min'' and ''et-al-use-first'' attributes (it is possible to have separate settings for items that have been cited previously by using the ''et-al-subsequent-min'' and ''et-al-subsequent-use-first'' attributes).
-For example,
-<code xml>
-<citation et-al-min="3" et-al-use-first="1">
-  ...
-</citation>
-</code>
-will result in name lists like "Doe", "Doe & Smith" and, if there are three or more names, "Doe et al.". Try changing these numbers and observe the effect.
-==Modifier les options de désambigüisation==
-CSL offre des méthodes multiples pour rendre les citations et les noms non-ambigüs 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ïser en ajoutant l'initiale ou le prénom complet (ex., "(J. Durand 1999, P. Durand 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 [[kb/given_name_disambiguation|désambigüisation des prénoms]], supprimez l'attribut ''disambiguate-add-givenname'', c'est-à-dire changez
-<code xml>
-<citation disambiguate-add-givenname="true">
-  ...
-</citation>
-</code>
-pour
-<code xml>
-<citation>
-  ...
-</citation>
-</code>
-=== Change the Style Title and ID ===
-Before installing your edited style, change the title and ID of your style if you don't want your modified style to overwrite the original style.
-The style title and ID are stored within the ''<title/>'' and ''<id/>'' elements near the top of the style. For example,
-<code><title>Harvard Reference format 1 (Author-Date)</title>
-<id>http://www.zotero.org/styles/harvard1</id></code>
-can be changed to
-<code><title>Harvard Style Modified</title>
-<id>http://www.zotero.org/styles/harvard-modified</id></code>
-The URLs that you put in as an ID do not have to exist, i.e. you can use a zotero.org/style/mystyle type ID even if the style will not be posted on the Zotero repository.
-=== Validation ===
-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]].
-==== 3 - Installer votre style modifié 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}}
-===Zotero Standalone===
-Enregistrez le style avec une extension de fichier ".csl" file extension 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 signes 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 ====
-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]].
-==== 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 ]].