• Stars
    star
    3,266
  • Rank 13,752 (Top 0.3 %)
  • Language
    Ruby
  • Created almost 14 years ago
  • Updated about 1 month ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Official repository for Citation Style Language (CSL) citation styles.

CSL logo

Citation Style Language - Style Repository

License Build Status

Introduction

The independent open source Citation Style Language (CSL) project aims to facilitate scholarly communication by automating the formatting of citations and bibliographies. The primary components of the CSL ecosystem are:

  • The CSL schema and specification, which describe how the XML-based CSL styles and locale files should be written and interpreted
  • Curated repositories of CSL styles and locale files
  • Third party CSL processors, software libraries for rendering formatted citation and bibliographies from CSL styles, CSL locale files, and item metadata

This README describes our official curated repository of CSL styles, hosted at https://github.com/citation-style-language/styles/. CSL locale files, which provide default localization data for CSL styles (such as translations and date formats), can be found at https://github.com/citation-style-language/locales.

For more information about CSL and CSL styles, check out https://citationstyles.org/ and the information files in this repository (Style Requirements, Style Development, Requesting Styles, Contributing Styles, and Quality Control).

Criteria for inclusion

The official CSL style repository is the only repository of its kind, is used by dozens of third-party software products, and is relied upon by hundreds of thousands of users. The popularity of this repository is in large part due to its crowd-sourced nature, and, we believe, also due to our careful curation. While we evaluate style submissions on a case-by-case basis, we generally use the following criteria for inclusion in the CSL style repository:

  • Styles must be of sufficient quality and meet our style requirements. While we may be able to assist with this, its ultimately the submitter's responsibility to provide a style that meets our standards.
  • Styles should be based on an official style guide (and link to the style guide in online or printed form).
  • Styles should be of interest to a wider audience. We are happy to accept styles with a niche audience, but as a rule of thumb, style submitters should not know all individuals who would be interested in their style. If you do, it's generally better to distribute your style to them yourself.

Based on these criteria, we generally accept:

  • styles for journals with open (unsolicited) submissions (and styles for publishers of such journals).
  • styles for published style guides, such as those from professional organizations, universities, and university departments.

However, we typically won't accept:

  • styles for personal use, or for internal use within small organizations.
  • styles solely for use with an (internal) API.

If in doubt whether your style is a good fit for the repository, feel free to open an issue or pull request and ask for our opinion. If we don't accept your submission, we encourage you to distribute your CSL style yourself.

Versioning and style distribution

We currently only actively maintain CSL styles in the "master" branch for the latest released version of CSL.

In addition, in order to provide a stable location for styles of a given CSL version, styles in "master" are automatically copied to a branch named after the latest version of CSL (e.g. "v1.0.2" when CSL 1.0.2 is the latest version). Once a new version of CSL is released (e.g. CSL 1.1.0), "master" will upgrade to that version, after which styles will be copied from "master" to a new version branch ("v1.1.0"). Version branches for old versions of CSL are kept but typically become dormant, as for these branches we generally stop maintenance, won't accept third-party contributions via pull requests, nor backport changes made to styles in "master".

Starting with branch "v1.0.1", the version branches differ from "master" in the following ways:

  • the latest version branch only receives updates from "master" if all tests in "master" pass
  • <updated/> timestamps of styles in the version branch are changed to match the git modification date of each individual style in "master"
  • superfluous files present in "master", e.g. for style testing, are removed.

As such, especially for downstream integrators, you are encouraged to obtain your CSL styles from the appropriate version branch (e.g. "v1.0.2" for CSL 1.0.2 styles). Currently, the styles repository includes the following (protected) branches:

  • "master"
  • "v1.0.2" (for CSL 1.0.2 styles)
  • "v1.0.1" (for CSL 1.0.1 styles)
  • "v1.0" (for CSL 1.0 styles)

The release regimen described here is also used for our CSL locales.

As of November 2020, https://github.com/citation-style-language/styles-distribution, which fulfilled a similar role to the version branches, has been deprecated and no longer receives updates from https://github.com/citation-style-language/styles.

Licensing

All styles in this repository are released under the Creative Commons Attribution-ShareAlike 3.0 Unported license. For attribution, any software using CSL styles from this repository must include a clear mention of the CSL project and a link to https://citationstyles.org/. When redistributing styles, the listings of authors and contributors in the style metadata must be kept as is.

More Repositories

1

csl-editor

cslEditorLib - A HTML 5 library for searching and editing CSL styles
JavaScript
186
star
2

schema

Citation Style Language schema
Python
186
star
3

locales

Official repository for Citation Style Language (CSL) locale files.
Ruby
140
star
4

journals

Tools and journal metadata for generating dependent CSL styles
Ruby
50
star
5

styles-distribution

Official repository for distribution of validated CSL citation styles.
41
star
6

documentation

Citation Style Language documentation
Python
41
star
7

utilities

Citation Style Language utilities
JavaScript
18
star
8

csl-editor-demo-site

Reference implementation of the CSL editor
HTML
18
star
9

test-suite

HTML
11
star
10

abbreviations

Makefile
10
star
11

csl-validator

Validator for CSL styles and locales
JavaScript
9
star
12

formatter

Formatter for CSL styles
JavaScript
7
star
13

citation-style-language.github.io

Official repository for the Citation Style Language (CSL) website.
SCSS
6
star
14

Sheldon

Pull request bot for the CSL styles repository
Ruby
3
star
15

test-suite-old

A test suite for CSL.
Ruby
3
star
16

data-parsing

Provides a resource for developers wishing to generate structured CSL input data.
Python
2
star
17

csl-evolution

Central repository for coordinating CSL development
2
star
18

logo

Official repository for Citation Style Language (CSL) logos.
2
star
19

distribution-updater

A WSGI app to update the CSL styles distribution repo based on a Travis CI webhook
Python
2
star
20

governance

Governance documents
1
star
21

.github

GitHub default community health files for the Citation Style Language (CSL) project
1
star