bdumont/csl-clio
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
233 Commits 1 Branch 0 Tags 3 MiB
TeX 75.1%
Shell 10.3%
Lua 10%
Makefile 4.6%
cbbdeb4733
Go to file
Bastien Dumont cbbdeb4733 Message de confirmation pour le passage des indications de ligne en exposant dans REB + ne plus supprimer les espaces fines insécables
2021-05-04 12:50:02 +02:00
Documentation Titres sensibles à la casse dans le fichier d'abréviation de Pandoc : à corriger quand ce sera réglé (mais pas à supprimer, car tous les utilisateurs n'ont pas la dernière version) 2021-04-18 09:53:58 +02:00
Filtres-Pandoc Ajout des filtres pour doc et Pandoc 2021-04-15 23:02:49 +02:00
Macros Message de confirmation pour le passage des indications de ligne en exposant dans REB + ne plus supprimer les espaces fines insécables 2021-05-04 12:50:02 +02:00
REB Ajout du lien vers le dépôt dans fichier CSL 2021-04-17 21:12:58 +02:00
Tests-Data Affichage de sourceDivisionLocator pour une source en position ibidem 2021-03-08 20:45:34 +01:00
Utilitaires Correction des erreurs empêchant la production de la documentation spécifique aux styles 2021-04-17 20:28:09 +02:00
README.md Précision de la version pour Pandoc à cause des changements fréquents dans le fichier de sortie d'une version à l'autre 2021-04-17 21:18:15 +02:00

README.md

CSL/Clio

Ce dépôt contient les fichiers source du projet CSL/Clio. Les fichiers PDF du manuel, les feuilles de style, les filtres et les macros sont hébergés sur Zenodo. Vous pouvez également les obtenir directement sur ce dépôt et compiler le manuel.

Présentation du projet

CSL/Clio vise à fournir des outils permettant de compenser les limites du langage de mise en forme de citations CSL, sur lequel repose notamment le logiciel Zotero. Par le biais de détournement et de spécialisation de variables présentes dans les spécifications CSL, il permet notamment de faire face à des exigences variées pour la citation de sources primaires.

Le projet fournit des styles CSL, des macros pour LibreOffice et des filtres pour Pandoc. Certaines de ces ressources peuvent s'avérer utiles dans d'autres disciplines que l'Histoire.

Développement

Le fichier Utilitaires/Makefile fait appel aux programmes suivants :

  • Pour les tests :
    • bash
    • pandoc 2.13
    • dwdiff
    • sort
    • uniq
    • palemoon (peut être remplacé en renseignant la variable HTML-VIEWER)
  • Pour la documentation :
    • pandoc
    • une distribution TeX contenant LuaLaTeX et ConTeXt (dans le futur, la dépendance à LaTeX pourra être supprimée)

Chaque éditeur ou revue possède son propre répertoire, contenant :

  • un fichier *.csl ;
  • un fichier *_CSL-Validation.html correspondant au résultat attendu du traitement du fichier Tests-Data/CSL-Tests.md par Pandoc avec l'option citeproc et les filtres spécifiés dans les fichiers *_filters-first.txt et *_filters-last.txt.

Les cibles suivantes requièrent que la variable JOURNAL soit renseignée par la ligne de commande avec le nom d'un des répertoires :

  • test : compare le fichier produit par Pandoc à l'aide du fichier *.csl avec le fichier *_CSL-Validation.html ;
  • test-compact : même chose, mais compare les mots plutôt que les lignes entières et produit un résultat plus compact ;
  • validation-prov : produit via Pandoc un fichier HTML en appliquant le style CSL fourni dans le répertoire et l'ouvre dans le navigateur défini par la variable HTML-VIEWER ;
  • validation-docx : produit via Pandoc un fichier de validation provisoire au format DOCX, permettant par exemple de le faire corriger par un tiers ;
  • install : valide le fichier de validation provisoire ;
  • clean.

L'idée est de rédiger une première version de la feuille de style CSL, générer un fichier de validation provisoire, le corriger manuellement, l'installer, puis modifier la feuille de style jusqu'à ce que le fichier HTML produit par Pandoc soit identique au fichier de validation ainsi obtenu. Bien entendu, si certaines exigences de l'éditeur ne peuvent être satisfaites ni par CSL, ni par un filtre Pandoc, le fichier de validation doit en tenir compte.

Les cibles docA4 et docDiapo produisent la documentation particulière à la revue ou à l'éditeur visé si la variable JOURNAL est spécifiée et le guide général de CSL/Clio dans le cas contaire.

Comment contribuer

Toutes les bonnes volontés sont bienvenues ! Si vous souhaitez contribuer, vous pouvez vous référer au manuel, qui contient les informations nécessaires, et m'écrire ou ouvrir un ticket sur ce dépôt.