[[PageOutline(2-5,Contents,pullout)]]

= TracZoteroPlugin =

== Description ==

TracZoteroPlugin is used to show and cite a local [http://www.zotero.org/ Zotero] database. 

'''Features:'''
 * Collection tree is created and always shown, which based on [http://bassistance.de/jquery-plugins/jquery-plugin-treeview/ jQuery plugin: Treeview]
 * Show all items in a collection
 * Show a item with all fields, attachment, and related items
 * Cross links to authors, year, publisher
 * Clouds for authors, year, publisher, which based on tags clouds in TagsPlugin
 * Cite item(s) in the WIKIs and tickets
 * [http://trac.edgewall.org/wiki/TracLinks TracLink] provider. Examples: `[zot:key], [zot:RAXETNDM see], [zot:0_RAXETNDM see]`
 * Search datadase

== Bugs/Feature Requests == 

Existing bugs and feature requests for TracZoteroPlugin are 
[report:9?COMPONENT=TracZoteroPlugin here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=TracZoteroPlugin&owner=helend new ticket].

== Download ==

Download the zipped source from [download:traczoteroplugin here].

== Source ==

You can check out TracZoteroPlugin from [http://trac-hacks.org/svn/traczoteroplugin here] using Subversion, or [source:traczoteroplugin browse the source] with Trac.

== Installing ==
 * Install
  * grab the source from [http://trac-hacks.org/svn/traczoteroplugin SVN].
  * Build and install an egg from this source. 
 * Configure
  * The Zotero database (folder including zotero.sqlite) must be located in the htdocs of your Trac environment
  * Add section '[zotero]' section in you trac.ini file, then setting the path of zotero database
{{{
[zotero]
path = Reference
}}}
  * if you have different database name other than 'zotero.sqlite', you can set 'dbname'
{{{
[zotero]
path = Reference
dbname = zotero.sqlite
}}}
  * The columns to show items could be specified by 'fields' and 'lables'.
{{{
columns = firstCreator, year, publicationTitle, title
}}}
  * The links of attachments are rendered as two ways, http:// and zotero://. The default way is http://. you can set 'attachmentlink' as 'locat' to render attachment as 'zotero://'
{{{
attachmentlink = local
}}}

== Screenshots ==
'''Start page'''

[[Image(start.png,height=200px)]]

''' Collection '''

[[Image(collections.png,height=250px)]]

''' Item '''

[[Image(item.png,height=200px)]]

''' Publisher cloud '''

[[Image(cloud.png,height=200px)]]

''' Cite list '''

[[Image(cite.png,height=100px)]]

== Cite in the WIKI pages ==
 * Cite a reference with key
{{{
[[ZotCite(TTQ685TT)]]
}}}
 * Cite multiple references with keys separated by comma ','. The keys can also start with '0_'
{{{
[[ZotCite(TTQ685TT, GCSENNQ8, 0_CVJBVNCN)]]
}}}
 * You can add any other words except comma after keys to let them easier to look.
{{{
[[ZotCite(CVJBVNCN(Marcellos&Single1975))]]
}}}
 * Add argument 'ait' or 'authorintext' to cite them as 'Author (year)'
{{{
[[ZotCite(GCSENNQ8(Rebbecketal.2007),ait)]]
}}} 
 * Show reference list
{{{
[[ZotRef]]
}}}
 * Show all related items
{{{
[[ZotRelated(5RUPZP36)]]
}}}
== Recent Changes ==

[[ChangeLog(traczoteroplugin, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:helend] [[BR]]
'''Maintainer:''' [wiki:helend] [[BR]]
'''Contributors:'''