diff --git a/CHANGELOG.md b/CHANGELOG.md index 6243f05..714fa8e 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,12 @@ # Changements +## 2023-08-19 + +### Changement interne + + * Utilisation du format _native_ de Pandoc pour les fichiers de test. + * Actualisation des instructions pour développer des styles dans le manuel. + ## 2023-05-08 ### Mise à jour vers CSL 1.0.2 diff --git a/Documentation/GUIDE_CSL-Clio.md b/Documentation/GUIDE_CSL-Clio.md index 0d8d2cb..526c5cc 100644 --- a/Documentation/GUIDE_CSL-Clio.md +++ b/Documentation/GUIDE_CSL-Clio.md @@ -774,12 +774,19 @@ Lors de ce travail, veillez à prendre en compte le sens particulier des [variab La programmation d'un nouveau style n'est pas très compliquée. Il s'agit principalement de : * 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 ; + * Définir précisément les changements que vous voulez opérer ; + * Copier le répertoire du style source et son contenu vers un répertoire correspondant au style que vous voulez créer, en modifiant les noms de fichier ; * _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 ; + * Modifier le fichier `.csl`. Pour vérifier l'effet des modifications : + * Ouvrir un terminal dans le répertoire `Utilitaires` ; + * `JOURNAL= make test` (ou `test-compact`) pour voir les changements dans le fichier `.native` ; + * `JOURNAL= make visualisation` pour voir le résultat dans votre navigateur^[ + Le cas échéant, modifier la valeur de `HTML-VIEWER` dans le fichier `Makefile`. + ] ; + * `JOURNAL= make install` quand vous êtes parvenu·e au résultat désiré. * 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. +Sauf impossibilité réelle, il est très vivement conseillé de faire vérifier votre fichier de visualisation HTML 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.