@vanakat/zotero-bridge
TypeScript icon, indicating that this package has built-in type declarations

1.2.3 • Public • Published

Obsidian Zotero Bridge Plugin

Obsidian-Zotero integration plugin that provides APIs for other plugins to integrate with Zotero.

Requires ZotServer addon installed in your Zotero

How to use

Zotero Bridge provides APIs for other plugins to connect to Zotero with installed ZotServer addon.

Example of such consumer plugin is Zotero Link.

APIs of this plugin are published with Obsidian plugin api library and can be used anywhere in Obsidian.

Example use of Zotero Bridge APIs in Templater user scripts:

zotero.js user script:

module.exports = async function () {
    const item = await PluginApi.ZoteroBridge.v1().search();
    return (prop) => dotAccess(prop, item.getValues());
}

function dotAccess(str, obj) {
    return str.split('.').reduce((previousValue, currentValue) => previousValue[currentValue], obj);
}

This function can now be used in templates:

(this example is taken from https://github.com/vanakat/zotero-bridge/pull/2)

<%* const zi = await tp.user.zotero() %>


<% zi('firstAuthor.lastName') %><%* if (zi('authors.length')  == 2) { %> and <% zi('authors')[1].lastName %><%* } else if (zi('authors.length') > 2) { %> et al.<%* } %> <% zi('date.year') %> <% zi('title') %>

How to contribute

  1. Fork and clone this repository
  2. Link this directory to your plugins directory: ln -sfn <this-directory> <your-test-vault>/.obsidian/plugins/obsidian-zotero
  3. npm install to install all dependencies
  4. npm run dev will run development server
  5. Reload your Obsidian with test vault open

Please refer to following helpful resources:

Other Zotero integration plugins

While working on this plugin I found another Zotero integration one called Zotero Integration. If you are looking for a citation/bibliography integration with Zotero it might be a good option for you.

License

MIT

Install

npm i @vanakat/zotero-bridge

DownloadsWeekly Downloads

5

Version

1.2.3

License

MIT

Unpacked Size

15 kB

Total Files

7

Last publish

Collaborators

  • sgazanchyan