Giter VIP home page Giter VIP logo

bookends-tools's Introduction

Bookends Tools

Bookends is an excellent bibliographic/research manager for macOS. This Alfred workflow curates 11 tools together in one interface to integrate with Bookends and other apps. You can use Alfred keywords (be…) and/or your preferred key binding to trigger them. The workflow is designed for Alfred 3, and should keep itself up-to-date using OneUpdater.

Download it here…

Workflow screenshot

Note: the tools denoted by πŸ“„ use Applescript System Events to trigger keyboard bindings with delays; the delays work fine for me but may need to be adjusted for you. If the tools seems to not work try to manually type ⌘V and enter.

key: πŸ“„: select some text in another app then trigger tool β€” πŸ—„: select reference(s) within Bookends then trigger tool β€” ⌨: trigger tool and enter some text Β 

  1. beidsearch πŸ“„ β€” Find a selected uniqueID in Bookends. For example, if you have a temporary citation like {Koffka, 1922, #6475} in your word-processor, double-click select the Bookends ID 6475, then trigger this workflow and it will find the reference in Bookends for you.
  2. bebrowser πŸ“„ β€” Search selected text in Bookends browser. For the Pubmed interface you should select this manually in the bookends browser before triggering this tool. If the automatic paste into the search field fails, press ⌘V and ENTER to trigger the search.
  3. berefsearch πŸ“„ β€” Take some selected text like "(Doe et al., 2005)" citation, clean it up become "Doe 2005" and send it to Bookend's quick search. This is great because you can take a formatted ref in a text document and search for the first author/year, then quickly paste back (⌘Y for Scrivener) the Bookends style temporary citation in its place!
  4. bequickadd πŸ“„ β€” Take selected DOI / PMID / ISBN or JSTOR text and use Quick Add (feature added in Bookends 13.0.3+) to quickly add this reference to the database.
  5. betoopml πŸ—„ β€” Select multiple references within Bookends, then run this to create an OPML file which you can import into Scrivener or other OPML-aware tool. This will contain the abstract and notes which is very useful for research. It contains links back to the Bookends reference. You can configure the export path in the workflow variables (default Desktop/).
  6. bescopus πŸ—„ β€” Select a reference (with a DOI) in Bookends, then trigger this to search Scopus with the DOI. It will return an inline results list for the Scopus entry AND the Cited-by page. Select an entry to go to that page. It will also append these Scopus URLs in the Notes field for future reference. You can enter your Scopus API key in the workflow variables. bescopus
  7. betobibtex ⌨ β€” You enter the name of a Bookends static/smart group name and this will create a BibTeX bibliography file for those particular groups. Very useful for Pandoc and/or LaTeX workflows. You can optionally generate JSON. You can configure the export path in the workflow variables (default Desktop/). betobibtex
  8. becite ⌨ β€” You enter one or more author/editor names and an optional year, and get an inline results list (for example [friston hobson 2014]). You can then paste the selected ref as a temporary citation (⌘ pastes Pandoc style, βŒ₯ pastes MMD style, βŒƒ pastes formatted ref, ⇧ opens ref in Bookends, [fn] opens attachment). For becite, betitle. and beall there is also a workflow environment variable (citeUsesRTF & commentText) to copy the Pandoc/MMD temporary citation using RTF; this puts the link back to bookends into an RTF comment (and/or annotation in Scrivener). becite
  9. betitle ⌨ β€” You enter one or more words contained in the title or keywords and an optional year, and get an inline results list. You can then paste this as a temporary citation (⌘ pastes Pandoc style, βŒ₯ pastes MMD style, βŒƒ pastes formatted ref, ⇧ opens ref in Bookends). betitle
  10. beall ⌨ β€” You enter one or more words contained in any field and an optional year, and get an inline results list. You can then paste this as a temporary citation (⌘ pastes Pandoc style, βŒ₯ pastes MMD style, βŒƒ pastes formatted ref, ⇧ opens ref in Bookends).
  11. bebib ⌨ β€” You enter one or more author/editor names and an optional year, and get an inline results list. You can then paste the selected ref as a formatted reference (see workflow variable citationStyle; ⌘ pastes Pandoc style, βŒ₯ pastes MMD style).

Workflow variables

variables

There are several workflow variables which let you modify the functionality of the tools:

  • appendScopusNotes (default = TRUE): allows you to toggle the behaviour whereby the Scopus URLs are appended back to the Bookends reference note stream.
  • BibTeXtoJSON (default = FALSE): allows you to convert the BIB file to a JSON file, which at least for Pandoc-citeproc is much faster (~3X) to then process for the bibliography.
  • citeUsesRTF (default = FALSE) & commentText: for the becite and betitle tools for Pandoc/MMD temporary citations, if you enable this then the temp citation is copied as RTF with a comment-enclosed link back to Bookends. In Scrivener if you enable Preferencesβ–ΈSharingβ–ΈImport comments as inline annotations, then the comment becomes an inline annotation. commentText is the text that is linked back to Bookends (default is @).
  • protectBibTitles (default = FALSE): makes titles in the BIB file {{ wrapped }} so the case is not changed in subsequent processing.
  • citationStyle (default = APA 6th Edition): is the Bookends bibliographic style used by bebib when outputting the formatted reference.
  • exportPath (default = Desktop): used by betoopml and betobibtex
  • scopusKey: your personal Scopus API key

Scopus Info

For the Scopus search tool, ideally you should register for your own Scopus API key (without it it will use the demo key which may or may not work) and enter it in the workflow variables. The Scopus URLs also benefit from an institutional subscription, otherwise you will see a Scopus preview (which still contains useful information).

Sources

Several of these very useful tools have been modified from the following sources:

betoopml

Thanks to Dave Glogowski (dave83); Bookends forum thread

betobibtex

Thanks and MIT copyright to Naupaka Zimmerman; Bookends forum thread | Original Gist

becite & bebib

Thanks to kseggleton for the original applescript version; Bookends forum thread

OneUpdater

Thanks to Vitor for his excellent update system for Alfred workflows: OneUpdater

bookends-tools's People

Contributors

iandol avatar

Stargazers

 avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    πŸ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. πŸ“ŠπŸ“ˆπŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❀️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.