Using Editorial and Bibkeys Together review

A few days go, Editorial for iPad was released. Created by Pythonista developer Ole Zorn, Editorial is the latest markdown editor for the iPad and, quite frankly, is the best one available right now. There’s been some excellent reviews of Editorial, notably from Federico Viticci and Gabe Weatherhead that are well worth reading.

Citation workflow

I’ve spent the last week exclusively writing with Editorial and have been blown away by its features, especially the ability to build Workflows. Workflows are similar to Automator on Mac and allow you to construct ways to automate tasks (which includes running Python scripts).1 I do all of my writing in Markdown, including my dissertation, and I wanted a way to access my citations, which I maintain in a BibTeX database for citing in vim and processing with Pandoc. To call up citations in vim, I use Lincoln Mullen’s Bibkeys and his recommendation for vim dictionary completion. But for doing all of my writing in Editorial, I needed a different system. With Workflows, this turned out to be ridiculously easy.

You can grab the workflow here. The one downfall at the moment is the citekeys.txt file needs to be in the root Dropbox folder (which might only be a problem for me since I keep my bibliography files in their own directory). The workflow is fairly straight forward and works by locating the text file, displaying a list of the file’s entries, and selecting the entry you want. The text file must already exist; you can follow Lincoln’s instructions for setting that up. In my case, I have a Rake file that handles everything for me.

Source list.

Creating citations needs just a little manual work. Selecting ‘Citekeys’ in my Editorial bookmark bar will run the Workflow and allow me to select the source I’m after. But since I’m using the citeproc built into Pandoc, I need to do some prep for the citation to work correctly by inserting square brackets where the note will go.

Inserting brackets.

Selecting a source will automatically put the ‘@’ symbol in front of the source. I’ll be adjusting the Workflow so it will smartly respond to page number inputs (if no numbers are provided, for example, it will ignore the page number input).

Select pages.

Full citation.

If you make any modifications to the Workflow, please let me know. I’m sure there are better ways to handle some of this. For now, this works great for my needs.

  1. The fact that I can write and execute Python on iOS blows me away. That Pythonista and Editorial made it into the App Store is astounding.
3 min read · 427 words · Published · Subscribe · Share

Jason Heppler is a digital humanities developer living in Omaha. More »

Do you want to discuss this?
Try mentioning @jaheppler on Twitter or, or email me.