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) (Add info on how to configure the Zotero client for retrieval of item URIs.) |
||
| 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]] | ||
| + | |||
| + | ==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>. | ||
Revision as of 10:23, 19 April 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:
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.
