wiki:TracZoteroPlugin

Zotero integration into Trac

Description

This is a plugin used to show and cite a local Zotero database. Zotero [zoh-TAIR-oh] is a free, easy-to-use tool to help you collect, organize, cite, and share your research sources.

Key features:

  • Collection tree is created and always shown, which based on 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.
  • TracLink provider. Examples: [zot:key], [zot:RAXETNDM see], [zot:0_RAXETNDM see].
  • Search database.

Bugs/Feature Requests

Existing bugs and feature requests for TracZoteroPlugin are here.

If you have any issues, create a new ticket.

Download

Download the zipped source from here.

Source

You can check out TracZoteroPlugin from here using Subversion, or browse the source with Trac.

Installation

Install as follows:

  • Grab the source from SVN.
  • Build and install an egg from this source.

Configuration

  • The Zotero database (folder including zotero.sqlite) must be located in the htdocs directory of your Trac environment.
  • Add section '[zotero]' section in your trac.ini file, in which you set the path of the 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 'labels':
      columns = firstCreator, year, publicationTitle, title
      
    • The links of attachments are rendered in two ways: http:// and zotero://. The default is http://. You can set 'attachmentlink' as 'local' to render attachment as zotero://:
      attachmentlink = local
      

Screenshots

Start page

Collection

Item

Publisher cloud

Cite list

Example

  • 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

10361 by helend on 2011-06-21 15:43:06
Add util.py and bug fix
10360 by helend on 2011-06-21 15:26:29
Add basic search module
10359 by helend on 2011-06-21 15:13:31
Add basic search module
(more)

Author/Contributors

Author: helend
Maintainer: Bangyou Zheng
Contributors:

Last modified 9 months ago Last modified on Nov 24, 2015, 2:00:34 PM

Attachments (5)

Download all attachments as: .zip