Le projet open source indépendant Citation Style Language (CSL) vise à faciliter la communication scientifique en automatisant le formatage des citations et des bibliographies. Les principaux composants de l’écosystème CSL sont :
Le schéma et la spécification CSL, qui décrivent comment les styles CSL et les fichiers de paramètres régionaux basés sur XML doivent être écrits et interprétés.
Référentiels organisés de styles CSL et de fichiers de paramètres régionaux
Processeurs CSL tiers, bibliothèques de logiciels pour le rendu de citations et de bibliographies formatées à partir de styles CSL, de fichiers de paramètres régionaux CSL et de métadonnées d'éléments
Ce README décrit notre référentiel officiel de styles CSL, hébergé sur https://github.com/citation-style-langage/styles/. Les fichiers de paramètres régionaux CSL, qui fournissent des données de localisation par défaut pour les styles CSL (tels que les traductions et les formats de date), peuvent être trouvés sur https://github.com/citation-style-lingual/locales.
Pour plus d'informations sur CSL et les styles CSL, consultez https://citationstyles.org/ et les fichiers d'informations de ce référentiel (Exigences de style, Développement de style, Styles de demande, Styles de contribution et Contrôle qualité).
Le référentiel officiel de style CSL est le seul référentiel de ce type, il est utilisé par des dizaines de produits logiciels tiers et par des centaines de milliers d'utilisateurs. La popularité de ce référentiel est en grande partie due à sa nature participative et, selon nous, également à notre conservation minutieuse. Bien que nous évaluions les soumissions de style au cas par cas, nous utilisons généralement les critères suivants pour l'inclusion dans le référentiel de styles CSL :
Les styles doivent être de qualité suffisante et répondre à nos exigences de style. Même si nous pouvons vous aider, il est en fin de compte de la responsabilité du demandeur de fournir un style qui répond à nos normes.
Les styles doivent être basés sur un guide de style officiel (et un lien vers le guide de style sous forme en ligne ou imprimée).
Les styles doivent intéresser un public plus large. Nous sommes heureux d'accepter des styles destinés à un public de niche, mais en règle générale, les auteurs de styles ne doivent pas connaître toutes les personnes susceptibles d'être intéressées par leur style. Si vous le faites, il est généralement préférable de leur distribuer vous-même votre style.
Sur la base de ces critères, nous acceptons généralement :
styles pour les revues avec des soumissions ouvertes (non sollicitées) (et styles pour les éditeurs de ces revues).
styles pour les guides de style publiés, tels que ceux des organisations professionnelles, des universités et des départements universitaires.
Cependant, nous n'acceptons généralement pas :
styles pour un usage personnel ou pour un usage interne au sein de petites organisations.
styles uniquement à utiliser avec une API (interne).
En cas de doute sur la pertinence de votre style pour le référentiel, n'hésitez pas à ouvrir un ticket ou une pull request et à demander notre avis. Si nous n'acceptons pas votre soumission, nous vous encourageons à distribuer vous-même votre style CSL.
Nous ne maintenons actuellement activement les styles CSL que dans la branche « master » pour la dernière version publiée de CSL.
De plus, afin de fournir un emplacement stable pour les styles d'une version CSL donnée, les styles dans "master" sont automatiquement copiés dans une branche nommée d'après la dernière version de CSL (par exemple "v1.0.2" lorsque CSL 1.0.2 est la dernière version). Une fois qu'une nouvelle version de CSL est publiée (par exemple CSL 1.1.0), "master" sera mis à niveau vers cette version, après quoi les styles seront copiés de "master" vers une nouvelle branche de version ("v1.1.0"). Les branches de version pour les anciennes versions de CSL sont conservées mais deviennent généralement dormantes, car pour ces branches, nous arrêtons généralement la maintenance, n'acceptons pas les contributions de tiers via des demandes d'extraction, ni les modifications apportées aux styles dans "master".
À partir de la branche "v1.0.1", les branches de version diffèrent de "master" des manières suivantes :
la branche de la dernière version ne reçoit les mises à jour de "master" que si tous les tests de "master" réussissent
Les horodatages
des styles dans la branche version sont modifiés pour correspondre à la date de modification git de chaque style individuel dans "master"
les fichiers superflus présents dans "master", par exemple pour les tests de style, sont supprimés.
Ainsi, notamment pour les intégrateurs en aval, vous êtes encouragés à obtenir vos styles CSL auprès de la branche de version appropriée (par exemple "v1.0.2" pour les styles CSL 1.0.2). Actuellement, le référentiel de styles comprend les branches (protégées) suivantes :
"maître"
"v1.0.2" (pour les styles CSL 1.0.2)
"v1.0.1" (pour les styles CSL 1.0.1)
"v1.0" (pour les styles CSL 1.0)
Le schéma de publication décrit ici est également utilisé pour nos paramètres régionaux CSL.
Depuis novembre 2020, https://github.com/citation-style-langage/styles-distribution, qui remplissait un rôle similaire aux branches de version, est obsolète et ne reçoit plus de mises à jour de https://github.com/ langage/styles de style de citation.
Tous les styles de ce référentiel sont publiés sous la licence Creative Commons Attribution-ShareAlike 3.0 Unported. Pour l'attribution, tout logiciel utilisant les styles CSL de ce référentiel doit inclure une mention claire du projet CSL et un lien vers https://citationstyles.org/. Lors de la redistribution des styles, les listes d'auteurs et de contributeurs dans les métadonnées de style doivent être conservées telles quelles.