Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Next revisionBoth sides next revision
dev:citation_styles:sharing_styles [2011/05/28 15:09] – [Preparing Styles for Distribution] clarify naming conventions adamsmithdev:citation_styles:sharing_styles [2011/10/27 12:46] rmzelle
Line 5: Line 5:
 ===== Preparing Styles for Distribution ===== ===== Preparing Styles for Distribution =====
  
-The are several requirements for distributing styles via the [[http://www.zotero.org/styles|Zotero Style Repository]] and GitHub [[https://github.com/citation-style-language/styles|CSL 1.0 style code repository]]:+There are several requirements for distributing styles via the [[http://www.zotero.org/styles|Zotero Style Repository]] and GitHub [[https://github.com/citation-style-language/styles|CSL 1.0 style code repository]]:
  
-  * 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”. Words in the title are customarily separated by a hyphen, e.g. “academic-journal.csl” instead of “academicjournal.csl”.+  * The file name of 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”. Words in the title are customarily separated by a hyphen, e.g. “academic-journal.csl” instead of “academicjournal.csl”.
  
   * The style ID (set with the ''<id>'' element) should be of the form ''<nowiki>http://www.zotero.org/styles/file-name</nowiki>'', without the ''.csl'' extension (e.g. ''<nowiki>http://www.zotero.org/styles/apa</nowiki>'' for ''apa.csl'').    * The style ID (set with the ''<id>'' element) should be of the form ''<nowiki>http://www.zotero.org/styles/file-name</nowiki>'', without the ''.csl'' extension (e.g. ''<nowiki>http://www.zotero.org/styles/apa</nowiki>'' for ''apa.csl''). 
Line 16: Line 16:
 http://creativecommons.org/licenses/by-sa/3.0/</rights></code> 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. +  * 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. Alternatively, you can mark the original style as a template by including a link to it in the info section of your style, e.g. ''<nowiki><link href="http://www.zotero.org/styles/original-style" rel="template"/></nowiki>''  
 + 
   * **Make sure your style [[dev/citation_styles#validation|validates]]**.   * **Make sure your style [[dev/citation_styles#validation|validates]]**.
  
Line 26: Line 26:
 ==== Submitting for Casual Coders ==== ==== Submitting for Casual Coders ====
  
-The easiest way to submit styles is post a link to your style code on the Zotero forums (do not paste style code directly into your post), using a code sharing website like http://gist.github.com.+The easiest way to submit styles is to post a link to your style code on the Zotero forums (do not paste style code directly into your post), using a code sharing website like http://gist.github.com.
  
 === Using gist.github.com === === Using gist.github.com ===
dev/citation_styles/sharing_styles.txt · Last modified: 2017/11/27 04:41 by bwiernik