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
csl_simple_edits [2011/04/10 21:23] – [Change the Style Title and ID] rmzellecsl_simple_edits [2011/04/15 21:40] – rmzelle
Line 49: Line 49:
 You'll see the change occur immediately in the preview pane below. You'll see the change occur immediately in the preview pane below.
  
-If a style prints //et-al// for citations with more than three authors and only prints the first author, you'll find this in the options: +If a style prints //et al.// for citations with more than three authors and only prints the first author, you'll find this in the options: 
 <code><option name="et-al-min" value="4" /> <code><option name="et-al-min" value="4" />
 <option name="et-al-use-first" value="1"/></code> <option name="et-al-use-first" value="1"/></code>
-If you would like to change this so //et-al// is only used for more than five authors and displays the first three, change it to+If you would like to change this so //et al.// is only used for more than five authors and displays the first three, change it to
 <code><option name="et-al-min" value="6" /> <code><option name="et-al-min" value="6" />
 <option name="et-al-use-first" value="3"/></code> <option name="et-al-use-first" value="3"/></code>
  
-The [[dev/csl_syntax_summary|CSL 0.8.1 syntax summary]] explains how the CSL works.  Common options you might wish to change are [[dev/csl_syntax_summary#options|here]].+The [[dev/citation_styles/CSL 0.8.1 Syntax]] explains how CSL 0.8.1 works.  Common options you might wish to change are [[dev/citation_styles/CSL 0.8.1 Syntax#options|here]].
  
 ==CSL 1.0== ==CSL 1.0==
-In csl 1.0, the same options - and several new ones - exist, but they are not listed separately, but included in the <citation> and <bibliography> lines, e.g. +In CSL 1.0, the same options - and several new ones - exist, but they are not listed separately, but included in the <citation> and <bibliography> lines, e.g. 
-<code>  <citation  et-al-min="4" et-al-use-first="1" disambiguate-add-year-suffix="true" disambiguate-add-names="true"></code>+<code><citation et-al-min="4" et-al-use-first="1" disambiguate-add-year-suffix="true" disambiguate-add-names="true"></code>
  
 A bit of trial and error, and testing with a few combinations should help. You can see what different items and combinations will look like by selecting them in Zotero (Ctrl-click to select multiple items), and then "Refresh" at the top-left of the Test pane.   A bit of trial and error, and testing with a few combinations should help. You can see what different items and combinations will look like by selecting them in Zotero (Ctrl-click to select multiple items), and then "Refresh" at the top-left of the Test pane.  
Line 88: Line 88:
 === Different CSL versions === === Different CSL versions ===
 Starting with version 2.1, Zotero uses an updated version of the Citation Style Language, [[http://citationstyles.org/downloads/specification.html|CSL 1.0]], which has a changed syntax. The styles that come with your copy of Zotero as well as most styles in the [[http://www.zotero.org/styles|Zotero Style Repository]] are in the old CSL 0.8.1 format and are updated internally. You can still edit CSL 0.8.1 styles, but if you want to make more substantive changes or take advantage of one of the [[http://citationstyles.org/downloads/upgrade-notes.html|new features of CSL 1.0]], you should download an updated version of the style from the [[https://github.com/citation-style-language/styles|CSL 1.0 repository]] or use [[http://citationstyles.org/downloads/upgrade-notes.html#updating-csl-0-8-styles|update the CSL 0.8.1 style]] yourself. //You cannot mix CSL 0.8.1 and 1.0. If you want to use some of the new features in 1.0 you will need to use a style converted to 1.0.// Starting with version 2.1, Zotero uses an updated version of the Citation Style Language, [[http://citationstyles.org/downloads/specification.html|CSL 1.0]], which has a changed syntax. The styles that come with your copy of Zotero as well as most styles in the [[http://www.zotero.org/styles|Zotero Style Repository]] are in the old CSL 0.8.1 format and are updated internally. You can still edit CSL 0.8.1 styles, but if you want to make more substantive changes or take advantage of one of the [[http://citationstyles.org/downloads/upgrade-notes.html|new features of CSL 1.0]], you should download an updated version of the style from the [[https://github.com/citation-style-language/styles|CSL 1.0 repository]] or use [[http://citationstyles.org/downloads/upgrade-notes.html#updating-csl-0-8-styles|update the CSL 0.8.1 style]] yourself. //You cannot mix CSL 0.8.1 and 1.0. If you want to use some of the new features in 1.0 you will need to use a style converted to 1.0.//
- 
- 
  
 ===== Using your Edited Style with Zotero ===== ===== Using your Edited Style with Zotero =====
Line 98: Line 96:
  
 To install the style, drag the file from where you saved it into an open Firefox page, and click Install in the pop-up message. To install the style, drag the file from where you saved it into an open Firefox page, and click Install in the pop-up message.
-{{:style_install.png?450}} +{{:style_install.png?600}}
- +
-You can ignore the grey bar at the top of the window (This XML style does not appear...)+
  
 +You can ignore the grey bar at the top of the window ("This XML style does not appear...")
  
 =====  Some Slightly more advanced tips ===== =====  Some Slightly more advanced tips =====
  
-For anything more advanced, [[dev/creating_citation_styles|this page]] is your friend. It also includes links to comprehensive documentation for both csl 1.0 and csl 0.+For anything more advanced, [[dev/start/citation_styles|this page]] is your friend. It also includes links to comprehensive documentation for both CSL 1.0 and CSL 0.8.1.
  
-If you are making several changes, you might want to copy all the CSL code from the top window (Ctrl-A, Ctrl-C) and paste it into a new file in a text editor. Notepad works fine, though using a good text editor designed for programming like the free [[http://notepad-plus.sourceforge.net|Notepad++]] for Windows or [[http://www.barebones.com/products/TextWrangler/|TextWrangler]] for Mac, can help you to see the structure clearly and not make mistakes.  Set the "language" to XML  (CSL is based around XML).+If you are making several changes, you might want to copy all the CSL code from the top window (Ctrl-A, Ctrl-C) and paste it into a new file in a text editor. Notepad works fine, though using a good text editor designed for programming like the free [[http://notepad-plus.sourceforge.net|Notepad++]] for Windows or [[http://www.barebones.com/products/TextWrangler/|TextWrangler]] for Mac OS X, can help you to see the structure clearly and not make mistakes. Set the "language" to XML (CSL is based around XML).
  
-You'll find that your fellow users on the Zotero forum will be happy to help you with any problems. The forums also have little nuggets of gold all through them, and [[/search/#support|searching ]] usually finds the solution to any issue.  If you are still having trouble, post a question in the Styles section of the Forum and it's likely to get answered quickly.+You'll find that your fellow users on the Zotero forum will be happy to help you with any problems. The forums also have little nuggets of gold all through them, and [[/search/#support|searching]] usually finds the solution to any issue. If you are still having trouble, post a question in the Styles section of the forums and it's likely to get answered quickly.
  
 ===== Sharing Styles ===== ===== Sharing Styles =====
  
 If your new style has general appeal, consider [[dev:submitting_citation_styles|submitting]] it for inclusion into the [[http://www.zotero.org/styles|Zotero Style Repository]]. If your new style has general appeal, consider [[dev:submitting_citation_styles|submitting]] it for inclusion into the [[http://www.zotero.org/styles|Zotero Style Repository]].