Differences

This shows you the differences between two versions of the page.

--- dev:submitting_citation_styles [2011/03/04 15:55] – rmzelle
+++ dev:submitting_citation_styles [2017/11/12 19:53] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-====Sharing CSL styles====
+<html><p id="zotero-5-update-warning" style="color: red; font-weight: bold">We’re
-After creating or modifying a CSL style, consider sharing your new style if it might be of interest to other users (e.g. if the style is for an academic journal, publisher, university, or a university department). The easiest way to share your style is via the [[http://www.zotero.org/styles|Zotero Style Repository]]. To submit styles to the repository, follow the instructions below.
+in the process of updating the documentation for
+<a href="https://www.zotero.org/blog/zotero-5-0">Zotero 5.0</a>. Some documentation
+may be outdated in the meantime. Thanks for your understanding.</p></html>
-===General Instructions===
-  * The file name the style 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”.
+See [[dev/citation_styles/Sharing Styles]].
-  * The style ID (set with the ''<id>'' element) should be of the form ''<nowiki>http://www.zotero.org/styles/file-name</nowiki>'', without an extension (e.g. ''<nowiki>http://www.zotero.org/styles/apa</nowiki>'' for ''apa.csl'').
-  * The style should include a license (set with the ''<rights>'' element) that permits sharing (most styles use the Creative Commons Attribution-Share Alike 3.0 License). E.g. use <code><rights>This work is licensed under a Creative Commons Attribution-Share Alike 3.0 License:
-http://creativecommons.org/licenses/by-sa/3.0/</rights></code>
-  * If your style is largely derived from an existing style, list the authors and contributors of that style as contributors in your style. Add yourself as the style's author.
-  * Make sure your style [[dev/creating_citation_styles#validation|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 [[https://www.zotero.org/dev/trac_access|SVN/Trac]] account with Zotero.
-Next, you will need an SVN client. Many users prefer GUI-based SVN clients, which include [[http://tortoisesvn.tigris.org|Tortoise SVN]] for windows, [[http://versionsapp.com/|Versions (non-free)]] for Mac, and [[http://www.rabbitvcs.org|Rabbit VCS]] Linux. A comprehensive list of SVN clients is [[http://en.wikipedia.org/wiki/Comparison_of_Subversion_clients|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.