Difference between revisions of "Help:Adding Zotero citations"
EricThrift (talk | contribs) (Created basic instructions for the Zotero citation entry in the wiki) |
EricThrift (talk | contribs) m (Text replacement - "Category:Main" to "Category:Featured") |
||
| (3 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| − | + | It is possible to add Zotero citations to documents in the wiki. Any cited reference MUST be available in a group library. By default, and unless you specify otherwise, items will be retrieved from the DFM library. | |
| + | |||
| + | ==Adding citations in the visual editor== | ||
| + | Inside the visual editor view (accessed by following the "Edit" or "Create" link to a page), you will see the option to cite Zotero items in the menu at the top: | ||
[[File:Zotero item insert menu option.png|border|center|Zotero item insert menu option in the MediaWiki visual editor interface menu]] | [[File:Zotero item insert menu option.png|border|center|Zotero item insert menu option in the MediaWiki visual editor interface menu]] | ||
| − | The insert menu will ask for the 8-character item key. You can look this up in the web version of the library, although it is also possible to retrieve the key from the desktop client. Here are the web search results for “Nyein and Mathew”, for example: | + | The insert menu will ask for the 8-character item key. You can look this up in the web version of the library, although it is also possible to retrieve the key from the desktop client (see below). Here are the web search results for “Nyein and Mathew”, for example: |
[[File:Item search results and key from the Zotero web library.png|center]] | [[File:Item search results and key from the Zotero web library.png|center]] | ||
The Zotero item key (ID) is the part of the URL following the “items” part. So if the address bar shows this: | The Zotero item key (ID) is the part of the URL following the “items” part. So if the address bar shows this: | ||
| Line 9: | Line 12: | ||
This can be copied into the citation box as follows: | This can be copied into the citation box as follows: | ||
[[File:Zotero item key entry in wiki.png|center]] | [[File:Zotero item key entry in wiki.png|center]] | ||
| − | |||
And we get this: | And we get this: | ||
[[File:Zotero item inserted in wiki text.png|center]] | [[File:Zotero item inserted in wiki text.png|center]] | ||
| + | |||
| + | ==Additional options== | ||
| + | The "add more information" link at the bottom of the Zotero citation dialogue box provides three further options for formatting the citation. | ||
| + | |||
| + | ;prefix:Text to come at the beginning of the citation ("See also"). | ||
| + | ;locator:Page, chapter, or section number ("p. 22"). | ||
| + | ;suffix:Text to come at the end of the citation ("for a more detailed explanation"). | ||
| + | |||
| + | ===Example:=== | ||
| + | See also Smith 2019, p. 22 for a more detailed explanation. | ||
| + | prefix citation locator suffix | ||
| + | |||
| + | ==Creating citations with multiple items== | ||
| + | If you wish to combine multiple references into a single citation, or add explanatory text to the footnote, select “Basic” (instead of "Zotero") in the "Cite" menu, then in the text box choose “Insert > Template”, and type “Zotero”. The Zotero citation menu should now appear. To insert further references within the same citation, select "Insert > Template" and type "Zotero" again for each reference. | ||
| + | |||
| + | Note that you will manually need to include punctuation to separate the references within the citation (e.g., ";"). | ||
| + | |||
| + | ==Retrieving item IDs from the Zotero desktop client== | ||
| + | It is possible to retrieve item IDs from the Zotero desktop client, although this requires some additional configuration of the client. | ||
| + | |||
| + | ===Step 1: Install translator=== | ||
| + | Save the following file as “<code>Zotero Item ID.js</code>” to your Zotero “translators” directory. On Windows, this will be <code>Users \ <your username> \ Zotero \ translators</code>.<blockquote>https://driedfishmatters.org/wiki/Zotero_Item_ID.js?action=raw</blockquote> | ||
| + | ===Step 2: Configure Zotero=== | ||
| + | In the Zotero desktop client, go to '''Edit > Preferences''' then select the “'''Export'''” tab menu. Under “'''Default Format'''”, choose “'''Zotero item ID'''” from the drop-down menu. | ||
| + | [[File:Zotero citation id preference setting.png|center|thumb|600x600px|Setting the preference to use "Zotero citation ID" (URL) export in the Zotero Desktop client.]] | ||
| + | |||
| + | |||
| + | You should now be able to copy the ID of any item in the library by selecting that item and pressing <code>SHIFT</code> + <code>CTRL</code> + <code>C</code>. | ||
| + | |||
| + | [[Category:Featured]] | ||
Latest revision as of 16:13, 12 October 2021
It is possible to add Zotero citations to documents in the wiki. Any cited reference MUST be available in a group library. By default, and unless you specify otherwise, items will be retrieved from the DFM library.
Adding citations in the visual editor
Inside the visual editor view (accessed by following the "Edit" or "Create" link to a page), you will see the option to cite Zotero items in the menu at the top:
The insert menu will ask for the 8-character item key. You can look this up in the web version of the library, although it is also possible to retrieve the key from the desktop client (see below). Here are the web search results for “Nyein and Mathew”, for example:
The Zotero item key (ID) is the part of the URL following the “items” part. So if the address bar shows this:
https://www.zotero.org/groups/2183860/dried_fish_matters/search/Nyein/titleCreatorYear/items/4SSP4CYN/item-list
the key is 4SSP4CYN.
This can be copied into the citation box as follows:
And we get this:
Additional options
The "add more information" link at the bottom of the Zotero citation dialogue box provides three further options for formatting the citation.
- prefix
- Text to come at the beginning of the citation ("See also").
- locator
- Page, chapter, or section number ("p. 22").
- suffix
- Text to come at the end of the citation ("for a more detailed explanation").
Example:
See also Smith 2019, p. 22 for a more detailed explanation. prefix citation locator suffix
Creating citations with multiple items
If you wish to combine multiple references into a single citation, or add explanatory text to the footnote, select “Basic” (instead of "Zotero") in the "Cite" menu, then in the text box choose “Insert > Template”, and type “Zotero”. The Zotero citation menu should now appear. To insert further references within the same citation, select "Insert > Template" and type "Zotero" again for each reference.
Note that you will manually need to include punctuation to separate the references within the citation (e.g., ";").
Retrieving item IDs from the Zotero desktop client
It is possible to retrieve item IDs from the Zotero desktop client, although this requires some additional configuration of the client.
Step 1: Install translator
Save the following file as “Zotero Item ID.js” to your Zotero “translators” directory. On Windows, this will be Users \ <your username> \ Zotero \ translators.
https://driedfishmatters.org/wiki/Zotero_Item_ID.js?action=raw
Step 2: Configure Zotero
In the Zotero desktop client, go to Edit > Preferences then select the “Export” tab menu. Under “Default Format”, choose “Zotero item ID” from the drop-down menu.
You should now be able to copy the ID of any item in the library by selecting that item and pressing SHIFT + CTRL + C.
