Go to file
2022-09-06 22:50:33 +02:00
Documentation Précision éditeur/auteur du livre dans guide 2022-06-28 18:02:46 +02:00
Filtres-Pandoc Ajout avertissement sur le fait que remove-superfluous-spaces est spécifique à Unix et donc devrait être réécrit en Lua 2022-01-09 22:27:07 +01: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 cas de l'ouvrage collectif 2022-09-06 22:50:33 +02:00
Tests-Data Ajout du cas de l'ouvrage collectif 2022-09-06 22:50:33 +02:00
Utilitaires Annulation du changement dans pandoc qui fait désormais des retours à la ligne en HTML 2022-09-06 22:44:37 +02:00
CHANGELOG.md Précision éditeur/auteur du livre dans guide 2022-06-28 18:02:46 +02:00
README.md Mise à jour de la version de référence de Pandoc pour les tests 2022-01-09 22:04:01 +01:00

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.16.2
    • 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.