Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Style Requirements

Rintze M. Zelle edited this page · 27 revisions

Please follow these formatting guidelines for submissions to the CSL style repository:

  1. Don't include abbreviations in the style title. Instead, use the <title-short/> element, e.g.:

    <info>
     <title>Modern Humanities Research Association</title>
     <title-short>MHRA</title-short>
    </info>
    
  2. Keep diacritics in the style title. E.g. "Associação Brasileira de Normas Técnicas" instead of "Associacao Brasileira de Normas Tecnicas".

  3. If your style is for a single language, set the appropriate locale code with the default-locale attribute on <style/>. For a list of common languages and their locale codes, see https://github.com/citation-style-language/locales/wiki (e.g., the locale code for US English is "en-US"). When default-locale is used, include the chosen language in the style title, unless the language is English. For example:

    <style xmlns="http://purl.org/net/xbiblio/csl" class="in-text" version="1.0" default-locale="de-DE">
     <info>
       <title>Zeitschrift für Soziologie (German)</title>
       <id>http://www.zotero.org/styles/zeitschrift-fur-soziologie</id>
     </info>
    </style>
    
  4. The file name of a style should be based on its title, but may contain no characters other than lowercase roman letters (a-z), digits (0-9), and single hyphens (-). Please:

    • replace capitals with lowercase letters
    • replace spaces and apostrophes with hyphens (e.g., "Documents d'archéologie française (French)" becomes "documents-d-archeologie-francaise.csl")
    • replace ampersands with "and" (e.g., "Arts & Health" becomes "arts-and-health.csl")
    • drop diacritics (e.g., "für" becomes "fur", not "fuer")
    • drop text between parentheses (e.g., "Ugeskrift for Læger (Danish)" becomes "ugeskrift-for-laeger.csl")
    • avoid abbreviations (e.g., use "modern-humanities-research-association.csl" instead of "mhra.csl")

    File names must end with the ".csl" extension.

  5. The style ID must be "http://www.zotero.org/styles/file-name", with "file-name" representing the style's file name without the ".csl" extension. E.g., "http://www.zotero.org/styles/modern-humanities-research-association" for "modern-humanities-research-association.csl":

    <info>
     <id>http://www.zotero.org/styles/modern-humanities-research-association</id>
    </info>
    
  6. The style's "self" link must match the style ID:

    <info>
     <link href="http://www.zotero.org/styles/modern-humanities-research-association" rel="self"/>
    </info>
    
  7. The style must be licensed under the Creative Commons Attribution-ShareAlike 3.0 License. Use the exact text below, without any hard line breaks for <rights/>:

    <info>
     <rights license="http://creativecommons.org/licenses/by-sa/3.0/">This work is licensed under a Creative Commons Attribution-ShareAlike 3.0 License</rights>
    </info>
    
  8. If you started from another CSL style, delete the original style authors and contributors, and point to the original style with a "template" link:

    <info>
     <link href="http://www.zotero.org/styles/original-style" rel="template"/>
    </info>
    
  9. If the style is for a journal, please include the journal's print ISSN (<issn/>) and online ISSN (<eissn/>):

    <info>
     <issn>0028-0836</issn>
     <eissn>1476-4687</eissn>
    </info>
    
  10. Independent styles should have a "documentation" link that points to a description of the style's citation format. For journals this is typically the "instructions to authors" webpage. If a style guide is only available in print, provide a URL that allows us to locate a paper copy.

    <info>
     <link href="http://www.mhra.org.uk/Publications/Books/StyleGuide/download.shtml" rel="documentation"/>
    </info>
    
  11. Try to indent the style's XML with 2 spaces per level.

  12. Make sure that your finished style validates against the CSL schema.

That's it! You're ready to submit your style!

Something went wrong with that request. Please try again.