Differences

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

--- dev:citation_styles:reference_test_pane [2017/11/12 19:53] – external edit 127.0.0.1
+++ dev:citation_styles:reference_test_pane [2017/11/27 04:54] – bwiernik
@@ Line 1: / Line 1: @@
-<html><p id="zotero-5-update-warning" style="color: red; font-weight: bold">We’re
+===== Zotero Style Editor =====
-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>
+//This window is also called the Zotero Reference Test Pane, Zotero CSL Editor, or csledit.xul.//
-===== Zotero Reference Test pane (csledit.xul) =====
+The Zotero Style Editor is a tool to edit CSL styles. It can be opened using the "Style Editor" button at the bottom of the [[/support/preferences/cite|Cite pane]] of the Zotero preferences.
-The Zotero Reference Test pane is a tool to edit CSL styles. It can be opened using the button "Open CSL Editor" at the bottom of the Cite tab of the Zotero [[/support/preferences|preferences]].
+{{ :preferences_cite_csl_editor.png?nolink&800 |}}
-{{:dev:csledit.png|}}
+The Style Editor provides instant processing of a CSL style, using items selected in your local Zotero library. The Style Editor Window is divided into two parts. The upper portion of the window shows the CSL style code. You can load an installed style by selecting it from the dropdown menu in the upper-right corner. You can also paste CSL style code from your clipboard. The lower portion of the Style Editor window shows formatted citations and bibliography references for the style you are editing. Choose items to format by selecting one or more items in your local Zotero library and clicking the "Refresh" button.
-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.
+You can preview the style's behavior for several types of citation modifications. A locator (page number, chapter, verse, etc.) can be specified using the pull-down menu and adjoining text-box on the left of the toolbar (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)"). Finally, the position of the cites can changed, so it is possible to see how cites to previously cited items are rendered (e.g., if a citation should be rendered as "(Doe, Jones, & Smith, 2002)" the first time, but "(Doe et al., 2002)" subsequently). You can also change the language of the formatted citations and bibliography.
-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.
 As you edit the CSL code in the upper window, the citations and bibliographic entries in the lower window are automatically updated. The test pane shows an error if the CSL code is invalid XML. If the code is valid XML but invalid CSL, you may see an error, or the preview in the lower window will stop updating. After editing a style, always [[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.