bdumont/csl-clio
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Actualisation de la doc sur le développement de styles

Browse Source
This commit is contained in:
Bastien Dumont 2023-08-19 16:13:45 +02:00
parent 884582a368
commit 8580a18806
2 changed files with 17 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
CHANGELOG.md
View File

@ -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

13
Documentation/GUIDE_CSL-Clio.md
View File

@ -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=<nom du répertoire cible> make test` (ou `test-compact`) pour voir les changements dans le fichier `.native` ;
* `JOURNAL=<nom du répertoire cible> 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=<nom du répertoire cible> 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.