====== zotero plugin ======

---- plugin ----
description: Allows you to quote your literature references saved in Zotero with a LaTeX-like syntax.
author     : Stefan Macke
email      : blog@stefan-macke.de
type       : syntax
lastupdate : 2010-06-02
compatible : last version
depends    : 
conflicts  : 
similar    : 
tags       : citing, zotero, references, latex

downloadurl: http://f.macke.it/ZoteroPlugin
bugtracker : 
sourcerepo : 
donationurl: 
----

===== Download and Installation =====

Download and install the plugin using the [[plugin:plugin|Plugin Manager]] using the URL given above (http://f.macke.it/ZoteroPlugin). Refer to [[:Plugins]] on how to install plugins manually.

==== Configuration ====
  - Enter your Zotero username, key and user ID into ''zotero.ini''.
  - If you would like to use a wiki page as the cache page for Zotero entries, create a new page and enter its name into ''zotero.ini'' (e.g. ''zotero:sources''). If you don't want to use the cache page, delete the entry in ''zotero.ini''.
  - Initially enter your Zotero entries into the cache file (the newly created wiki page or sources.txt if you don't want to use the wiki page). This can be automated by calling ''readEntries.php'' from the command line.
  - If you cite a source that is not already in the cache, the plugin will automatically download your latest Zotero entries and add them to the cache. For this to work you have to enable ''autoupdate'' in ''zotero.ini''.

===== Screenshots =====
See [[http://wiki.stefan-macke.com/doku.php/se:programmierung|my wiki]] for a live example of the plugin's functionality.

  * The plugin's syntax:\\ {{http://blog.stefan-macke.com/wp-content/uploads/2010/06/ZoteroPlugin02.jpg|The plugin's syntax}}
  * The plugin's output:\\ {{http://blog.stefan-macke.com/wp-content/uploads/2010/06/ZoteroPlugin01.jpg|The plugin's output}}
  * The plugin's initial import of Zotero sources:\\ {{http://blog.stefan-macke.com/wp-content/uploads/2010/06/ZoteroPlugin03.jpg|The plugin's initial import of Zotero sources}}
  * Configuring a short name as a cite key for a source in Zotero:\\ {{http://blog.stefan-macke.com/wp-content/uploads/2010/06/ZoteroPlugin04.jpg|Configuring a short name as a cite key for a source in Zotero}}

===== Syntax and Usage =====
You can cite your Zotero sources by using the syntax known from LaTeX:
  \cite[p.123]{ShortName123}

==== Prerequisites ====
  * You need to have your Zotero database synchronized with the Zotero server.
  * Every source you would like to cite needs a "short name" in the Zotero database.
  * You need to make your Zotero reference list public and configure a "key" for access to the RSS feed.

===== History =====
  * 2010-06-02: Release of initial version

===== Discussion =====
  * Is it possible to add a functionnality to list all references cited at the end of the document, like with the latex command: \nocite{*} or \bibliography{zotero_biblio} ?
  * I am obtaining the same error of your implementation here: http://wiki.stefan-macke.com/doku.php/buecher:hectorsreise ''ERROR: No ID found in string http://zotero.org/stefanmacke/items/QVKUKNIB''. I really would appreciate any advice about it, since I am not being able to run zotero plugin properly
    * Might it be that you did not define a "short title" for this item?
  * How to refer to a group library instead of that of an individual?  group libraries have as well RSS feeds so it shoudn't be too difficult but I can't hack your code properly. --- [[berteh@hotmail.com|berteh]], April 2011
  * I'd really like this plugin if it could access a local Zotero database.