Both sides previous revisionPrevious revision | Next revisionBoth sides next revision |
dev:citation_styles:style_editing_step-by-step [2017/11/27 04:24] – Remove Zotero 5 warning bwiernik | dev:citation_styles:style_editing_step-by-step [2017/11/27 04:33] – Update for Zotero 5. bwiernik |
---|
| |
See the [[http://citationstyles.org/citation-style-language/documentation/|documentation page]] of the CSL project website for information on making CSL changes (in particular, make sure to take a look at the [[http://citationstyles.org/downloads/specification.html|CSL specification]]. Below we discuss a few common and simple style edits to get you started. | See the [[http://citationstyles.org/citation-style-language/documentation/|documentation page]] of the CSL project website for information on making CSL changes (in particular, make sure to take a look at the [[http://citationstyles.org/downloads/specification.html|CSL specification]]. Below we discuss a few common and simple style edits to get you started. |
| |
| === Change the Style Title and ID === |
| |
| **Important:** Before installing your edited style, you must change the style title and ID at the type of the style code. If you don't change these, your modified style will be overwritten the next time the original style is updated. |
| |
| The style title and ID are stored within the ''<title/>'' and ''<id/>'' elements near the top of the style. For example, |
| |
| <code><title>Harvard Reference format 1 (Author-Date)</title> |
| <id>http://www.zotero.org/styles/apa</id></code> |
| |
| can be changed to |
| |
| <code><title>Harvard Style Modified</title> |
| <id>http://www.zotero.org/styles/apa-modified</id></code> |
| |
| The URLs that you put in as an ID do not have to exist (i.e., you can use a zotero.org/style/mystyle type ID even if the style will not be posted on the Zotero repository). |
| |
| === Validation === |
| |
| Before installing a modified style, always make sure it is valid XML and CSL by [[https://github.com/citation-style-language/styles/wiki/Validation|validating against the CSL schema]]. |
| |
=== Examples Edits ==== | === Examples Edits ==== |
If a case is missing in your style, you can add that and fill out what and how the information should be rendered in that case ([[https://www.zotero.org/styles/chicago-fullnote-bibliography?source=1|an example of such a full footnote style]]). | If a case is missing in your style, you can add that and fill out what and how the information should be rendered in that case ([[https://www.zotero.org/styles/chicago-fullnote-bibliography?source=1|an example of such a full footnote style]]). |
| |
=== Change the Style Title and ID === | ==== 3 - Install your Edited Style with Zotero ==== |
| |
Before installing your edited style, change the title and ID of your style if you don't want your modified style to overwrite the original style. | See [[/support/styles|Styles]]. |
| |
The style title and ID are stored within the ''<title/>'' and ''<id/>'' elements near the top of the style. For example, | |
| |
<code><title>Harvard Reference format 1 (Author-Date)</title> | |
<id>http://www.zotero.org/styles/harvard1</id></code> | |
| |
can be changed to | |
| |
<code><title>Harvard Style Modified</title> | |
<id>http://www.zotero.org/styles/harvard-modified</id></code> | |
| |
The URLs that you put in as an ID do not have to exist, i.e. you can use a zotero.org/style/mystyle type ID even if the style will not be posted on the Zotero repository. | |
| |
=== Validation === | |
| |
Before installing a modified style, always make sure it is valid XML and CSL by [[https://github.com/citation-style-language/styles/wiki/Validation|validating against the CSL schema]]. | |
| |
==== 3 - Install your Edited Style with Zotero ==== | |
===Zotero for Firefox=== | |
Save the style with a ".csl" file extension (you can generally do this by simply typing ".csl" after the name of your file) , and drag-and-drop the CSL style file onto an open Firefox browser window, and click the "Install" button (you can ignore the grey bar at the top of the window ("This XML style does not appear...")). | |
| |
{{:style_install.png?600}} | Save the style with a ".csl" file extension (you can generally do this by simply typing ”.csl” after the name of your file). Then, go to the [[/support/preferences/cite|Cite pane]] in the Zotero [[/support/preferences|preferences]]. Click on the "+" sign below the list of installed styles. In the file selection dialogue that opens, navigate to the .csl file you just created and open it. This will install your new style. |
| |
===Zotero Standalone=== | |
Save the style with a ".csl" file extension (you can generally do this by simply typing ”.csl” after the name of your file). Then, go to the [[/support/preferences/cite|"Cite" tab]] in the Zotero [[/support/preferences|preferences]]. Click on the + sign below the list of installed styles. In the file selection dialogue that opens, navigate to the .csl file you just created and open it. This will install your new style. | |
==== 4 - Sharing Styles ==== | ==== 4 - Sharing Styles ==== |
| |
==== Getting Help ==== | ==== Getting Help ==== |
| |
If you get stuck at any point, try searching the [[/forum/|Zotero forums]], or, if that doesn't give an answer, post in the forum's [[/forum/11/|styles section]]. | If you get stuck at any point, try posting a question on the [[/forum/|Zotero forums]]. |