Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
csl_simple_edits [2011/04/08 21:29] – [(optional) Change the Style Title and ID] rmzelle | csl_simple_edits [2012/05/24 11:40] (current) – removed rmzelle | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Making Basic Changes to CSL Styles - Step-by-step Guide ====== | ||
- | |||
- | ===== The Zotero Reference Test Pane ===== | ||
- | |||
- | An easy way to get started with editing CSL styles is by using the Zotero Reference Test Pane. This tool renders items from your Zotero library with the CSL style of your choice, and gives real-time feedback when you edit the style. | ||
- | |||
- | To open the Zotero Reference Test Pane, paste | ||
- | |||
- | ''< | ||
- | |||
- | into the Firefox address bar and press Enter. | ||
- | |||
- | Now select a style from the drop-down menu in the top-right corner of the Test Pane, or copy and paste a CSL style into the text box into the upper half of the split pane window. Now open the Zotero pane, and select one or several items. The lower half of the window will now show how citations and bibliographies are formatted for the selected style and Zotero items. | ||
- | |||
- | ==== Make some changes ==== | ||
- | |||
- | You can now make changes to the CSL code in the upper half of the split window. As long as the changed style is still correct XML and CSL, the lower half of the window will automatically update after each change. **Style changes are lost when you close the Firefox tab or switch styles. If you plan to make extensive changes, make sure to save your edits often.** | ||
- | |||
- | === CSL 0.8.1 styles === | ||
- | |||
- | Minor issues are likely to be in the ''< | ||
- | |||
- | For example, to remove all [[kb/ | ||
- | |||
- | ''< | ||
- | |||
- | And just delete the whole line. | ||
- | You'll see the change occur immediately in the preview pane below. | ||
- | |||
- | The [[dev/ | ||
- | |||
- | 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 " | ||
- | |||
- | < | ||
- | < | ||
- | If nothing happens when you click refresh, you've broken the style!< | ||
- | |||
- | ==== (optional) Change the Style Title and ID ==== | ||
- | |||
- | Changing the title and ID of your modified style has two advantages: | ||
- | |||
- | * Installing your modified style won't overwrite the original style | ||
- | * It will prevent your modified from being overwritten itself. The styles that ship with Zotero are automatically updated. If you modified one of these styles and didn't change the title/ID, your modified style will be overwritten when a style update becomes available. | ||
- | |||
- | The title and ID are stored within the ''< | ||
- | |||
- | < | ||
- | < | ||
- | |||
- | can be changed to | ||
- | |||
- | < | ||
- | < | ||
- | ==== Using your Edited Style with Zotero ==== | ||
- | |||
- | You've made some changes to a style, and now you'd like to use your edited style with Zotero. How do you install this new style? | ||
- | |||
- | Select all the style code in the upper half of the test pane (Ctrl-A on Windows, Cmd-A on Mac OS X). Copy and paste the code into a text editor and save the style with a " | ||
- | |||
- | To install the style, drag the file from where you saved it into an open Firefox page, and click Install. Done! | ||
- | |||
- | ===== Some Slightly more advanced tips ===== | ||
- | |||
- | For anything more advanced, [[dev/ | ||
- | |||
- | 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:// | ||
- | |||
- | The Zotero forums have little nuggets of gold all through them, and [[/ | ||
- | |||
- | ===== Sharing Styles ===== | ||
- | |||
- | If your new style has general appeal, consider [[dev: | ||