Programmation de nouveaux styles : intro et ressources de base

This commit is contained in:
Bastien Dumont 2021-02-27 23:52:55 +01:00
parent 79e2ad019f
commit 84868d8c26

View File

@ -736,9 +736,36 @@ Lors de ce travail, veillez à prendre en compte le sens particulier des [variab
## Programmer de nouveaux styles ## Programmer de nouveaux styles
Si vous souhaitez proposer un nouveau style, La programmation d'un nouveau style n'est pas très compliquée. Il s'agit principalement de :
### Ressources fournies par le projet CSL * Choisir le style qui se rapproche le plus de ce à quoi vous souhaitez parvenir;
* Copier et modifier son fichier de test HTML pour définir le rendu auquel vous souhaitez arriver ;
* _Optionnellement_, définir les filtres _Pandoc_ que vous souhaitez appliquer pour parvenir au fichier de test;
* Copier et modifier le fichier `.csl` jusqu'à ce qu'il produise le même résultat que votre fichier de test;
* Indiquer dans un fichier à part les tâches qui restent à effectuer sur le résultat produit par le fichier CSL.
Sauf impossibilité réelle, il est très vivement conseillé de faire vérifier votre fichier de test par l'éditeur et de l'interroger sur les points qui ne seraient pas précisés dans les instructions aux auteurs.
N'hésitez pas à me contacter si vous rencontrez des difficultés.
### Ressources de base
Si vous n'en avez pas encore, procurez-vous un bon [éditeur de texte](https://framalibre.org/recherche-par-crit-res?keys=%22%C3%A9diteur+de+texte%22+d%C3%A9veloppement), qui dispose de la coloration syntaxique pour XML, permette une navigation facile entre les balises et éventuellement valide en temps réel la conformité de votre fichier au [schéma CSL (format RNC)](https://raw.githubusercontent.com/citation-style-language/schema/v1.0.1/csl.rnc).
Consultez la [spécification de CSL](https://docs.citationstyles.org/en/1.0.1/specification.html#terms), en prenant en compte les modifications signalées dans ce manuel.
Quand vous pensez que votre style est fonctionnel (mais pas nécessairement terminé), si votre éditeur ne supporte pas la validation en temps réel, vous pouvez le soumettre au [validateur](https://validator.citationstyles.org/) pour vérifier qu'il soit bien conforme aux spécifications. Les choix propres à _CSL/Clio_ n'entraînent jamais une non-conformité aux spécifications.
Vous pouvez utiliser l'éditeur de styles intégré à _Zotero_ pour faire des expériences et visualiser en direct les résultats de vos modifications. Il est accessible via le menu _Outils_ > _Développeur_ > _Style editor_.
En revanche, vous ne pouvez pas utiliser les [outils d'édition proposés sur le site de CSL](https://editor.citationstyles.org/about/).
Pour conduire les tests, vous avez le choix entre deux possibilités :
* Utiliser le [Makefile](<!-- REF -->) de CSL/Clio, ce qui implique de disposer des programmes en ligne de commande utilisés;
* Créer un fichier ODT ou DOCX dans lequel vous insérerez une deux fois de suite une note de bas de page pour chaque item dans la bibliographie de test (la première pour tester une première citation, la seconde pour une citation subséquente), puis quelques tests supplémentaires pour les localisateurs, les _ibidem_, etc... Il faudra ensuite vérifier à la main qu'elle ne contienne pas d'erreurs.
Dans les deux cas, il faudra au préalable importer la [bibliographie de test](<-- REF -->) dans _Zotero_.
### Directives spécifiques à *CSL/Clio* ### Directives spécifiques à *CSL/Clio*