Differences

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

--- dev:citation_styles [2011/11/06 19:38] – [Zotero Reference Test pane (csledit.xul)] rmzelle
+++ dev:citation_styles [2018/11/16 04:04] (current) – [Mapping of Zotero Variables and Item Types to CSL] typo : to create to exmport replaced with to create and export (I hope I have not misunderstood) fflamerie
@@ Line 1: / Line 1: @@
 ====== Citation Styles ======
-Zotero uses [[http://citationstyles.org/|Citation Style Language]] (CSL) styles and the [[https://bitbucket.org/fbennett/citeproc-js/wiki/Home|citeproc-js]] CSL processor for [[/support/creating_bibliographies|creating citations and bibliographies]]. Most CSL-related documentation can be found at http://citationstyles.org/citation-style-language/documentation/.
+Zotero uses [[http://citationstyles.org/|Citation Style Language]] (CSL) styles and the [[https://bitbucket.org/fbennett/citeproc-js/wiki/Home|citeproc-js]] CSL processor for [[/support/creating_bibliographies|creating citations and bibliographies]].
-This page describes CSL-related information that is specific to Zotero, and CSL-related projects by the Zotero developers.
+For information on how to use existing CSL styles with Zotero, see [[/support/styles|Citation Styles]].
-===== Zotero Reference Test pane (csledit.xul) =====
+===== Editing CSL Styles =====
-The Zotero Reference Test pane is a tool to edit CSL styles. It can be opened by entering <html><a href="chrome://zotero/content/tools/csledit.xul">chrome://zotero/content/tools/csledit.xul</a></html> in the Firefox address bar.
+For basic instructions on how to edit CSL styles for Zotero, see the [[dev/citation_styles/style_editing_step-by-step|Step-by-step guide]]. More documentation can be found at http://citationstyles.org/citation-style-language/documentation/.
-{{:dev:csledit.png|}}
+===== Mapping of Zotero Variables and Item Types to CSL =====
+A mapping of Zotero item types and variables to CSL is available [[https://aurimasv.github.io/z2csl/typeMap.xml|here]]. A Zotero extension to create and export the current mapping from a local Zotero installation can be found [[https://github.com/aurimasv/z2csl|here]].
-The test pane provides instant processing of a CSL style, using items selected in your local copy of Zotero. After loading the pane, you are shown a toolbar, and a split browser window underneath. The first step in using the test pane is to select a CSL style. You can paste the code of an independent style into the upper window, or select an installed style from the pull-down menu on the right. The next step is to select one or more items in your local Zotero library, and click the "Refresh" button. The lower window now shows formatted citations and bibliographic entries for the selected items and CSL style.
+===== Submitting Styles to the Citation Style Repository =====
-Citations can be modified in several ways. A locator can be specified using the pull-down menu and adjoining text-box on the left (e.g., to obtain "(Doe 2002, p.52)"). The "Suppress author" option can be checked (so that a "(Doe 2002)" citation gets rendered as "(2002)"), and, finally, the position of the cites can changed, so it is possible to see how cites to previously cited items are rendered.
+Citation styles can be hosted on the [[https://github.com/citation-style-language/styles|Citation Style Language Repository]]. Follow [[https://github.com/citation-style-language/styles/blob/master/CONTRIBUTING.md|these instructions]] to have your style added to the repository.
-As you edit the CSL code in the upper window, the citations and bibliographic entries in the lower window are automatically updated. While the test pane will show an error if the CSL code is invalid XML, it does not check whether the code is valid CSL. After editing a style, it is still strongly recommended to [[https://github.com/citation-style-language/styles/wiki/Validation|validate]] your style.
-**Important** When you close the test pane, or select a style from the pull-down menu, any edits will be lost. If you are making extensive changes to a CSL style, save your edited code often.
-===== Zotero Preview pane (cslpreview.xul) =====
-The Zotero Preview pane is a tool to preview CSL styles. It can be opened by entering <html><a href="chrome://zotero/content/tools/cslpreview.xul">chrome://zotero/content/tools/cslpreview.xul</a></html> in the Firefox address bar.
-{{:dev:cslpreview.png|}}
-The preview pane shows rendered citations and bibliographic entries for all installed CSL styles, using items selected in your local copy of Zotero.
 ===== Self-hosting CSL Styles =====
-If you decide to host CSL styles online yourself, serve them with a “text/x-csl” MIME type allows Zotero for Firefox to automatically recognize and install your styles.
+If you decide to host CSL styles online yourself, serving them with the “vnd.citationstyles.style+xml” MIME type allows programs such as Zotero to automatically recognize and install your styles.
 ===== citeproc-node =====
 [[dev/citation_styles/citeproc-node|citeproc-node]] is a wrapper for [[https://bitbucket.org/fbennett/citeproc-js/wiki/Home|citeproc-js]] for server-side rendering of citations and bibliographies.
-===== Editing CSL 1.0 Styles =====
-A currently somewhat outdated tutorial for making small CSL edits:
-  * [[dev/citation_styles/Style Editing Step-By-Step]]