This is an old revision of the document!


Submitting your Citation Style

If you have written a new citation style, or adjusted an existing style, there is a good chance that other users would benefit from the style. Especially if the style is for an academic journal or publisher, a university, or a university department, consider making it available on the Zotero style repository.

General Guidelines

Please make sure to follow the following guidelines for public styles

  • File names of styles submitted to the Style Repository should contain no characters other than lowercase roman letters (a-z), digits (0-9) and single hyphens (-). The file extension should be ”.csl”. E.g. use “style-name.csl” instead of “StyleName.csl”, “Style Name.csl” or “style_name.txt”
  • New styles should use URIs in the <id> element of the form http://www.zotero.org/styles/style-name, without an extension.
  • Styles on the repository should have a creative commons or comparable license. Add
    <rights>This work is licensed under a Creative Commons Attribution-Share Alike 3.0 License:
    http://creativecommons.org/licenses/by-sa/3.0/</rights>

    to the <info> section of the style

  • If your style is based to a significant extent on an existing style, list the author and contributors of that style as <contributor> in the <info> section of your style. Add yourself as the style's author.
  • Make sure your style validates

Submitting for Casual Coders: gist.github.com

If you don't expect to contribute many citation styles to Zotero, getting SVN access to Zotero and learning how to use SVN is likely too much trouble. You can still submit your style. Go to http://gist.github.com a free site dedicated to sharing code. Paste the content of your code into the window, enter style-name.csl as the file name and the press the “Create Public Gist” button at the bottom of the page. Open a new thread for your style in the Citation Style section of the Zotero forum and ask for it to be uploaded to the repository. Provide the link to the style from the URL bar, i.e. in the form https://gist.github.com/123456. Your style will be added to the repository by one of the Zotero team members or volunteers. If you don't hear back within a week, post a reminder to the same thread.

Submitting for Advanced and/or Frequent Contributors

If you're a frequent contributor of styles or an advanced user, you may want to add the style to the repository yourself. For that, you first need a SVN/Trac account with Zotero. Next, you will need an SVN client. Many users prefer GUI-based SVN clients, which include Tortoise SVN for windows, Versions (non-free) for Mac, and Rabbit VCS Linux. A comprehensive list of SVN clients is here. With your SVN client, check out the csl repository from Zotero. The repository address is https://www.zotero.org/svn/csl. Add your style to the repository or update the style you're improving and commit your change. Refer to the instructions provided with your SVN client for details.

dev/submitting_citation_styles.1299267204.txt.gz · Last modified: 2011/03/04 14:33 by adamsmith