Taekman Writing Workflow 2015

The early release of Papers 3 got a bad rap, and rightly so. My negative experience began as I imported my Papers 2 library into Papers 3. I had about 2500 papers, but only a fraction of these PDFs were imported properly. I am still recovering from these import problems--having to add each missing PDF by hand. Although importing was a issue early on, The makers of Papers, MekentosJ, now part of Springer Science+Business Media, worked hard to fix problems. I assume, with all the work on Papers, that importing has been fixed. My advice? Back-up your data before trying to import to Papers 3!

Although I had early problems, I can tell you that Papers 3 is pretty robust now. I recently used it to write and submit a full grant. I’ll say the app should be strongly considered if you’re looking for a reference manager / bibliography builder. If you’re interested in some of the changes in Papers 3, check out this entry.

With the release of Papers 3, all files and PDFs are bundled into a single container. Bundling makes syncing across computers more reliable, but indexing of individual files much more difficult. Unfortunatly, my Papers 2 workflow was dependent on indexing of single files. And thus, with the release of Papers 3, I had to revamp my writing workflow. That’s what I’m going to cover in this entry.

My current workflow has three parts: 1.organizing, 2. creating, and 3. writing/formatting

The software I use includes:
Papers3
DropBox
Hazel
Skim
Keyboard Maestro
Ulysses
Devonthink
Tinderbox
OmniOutliner
Scrivener
Pages or Word

Part 1: Organizing

Papers 3

Papers is used as my storehouse for all academic literature. I use Keywords and Smart Folders (akin to Smart Playlists in iTunes) to keep my literature sorted. In addition to the topic of each manuscript or book chapter, I use keywords such as "MustRead" that fuel my prioritized reading list. I tend to keep my library sorted by the date in the main window, but can easily search or sort my library in numerous other ways. My library is synchronized using Dropbox.

KeyBoard Maestro

Most people, while reading academic literature, find additional manuscripts they’d like to download. I’ve developed a series of KeyBoard Maestro scripts that simplify the download of these additional articles from Duke’s Library, Pubmed, and Google Scholar. As I’m reading a manuscript, I highlight the article I want to download and invoke my KM script. The macro copies the text string I’ve highlighted, goes to the appropriate web page (e.g. Duke’s Library), pastes the search string into the appropriate box, and hits submit. Thus with two keystrokes, I can find and download new PDFs I’d like to read. The new PDFs are sent to my “Downloads” folder. Then Hazel takes over.

Hazel

Hazel is a program that watches folders on my computer. When a file matches defined criteria, Hazel performs a script. I have a Hazel script watch for PDFs that contain the word “Reference.” When Hazel sees a file that matches, it launches Papers and imports the file into my library.

Skim

Despite the pleasing new main interface, Papers 3 highlighting leaves much to be desired. For reading and annotating scientific literature I use Skim (Skim can designated as the primary PDF reader in the Papers Prefernce menu). Skim has a robust feature set and is customized for academic literature. Oh, and it’s free! When I’m done reading and annotating, I export the Skim annotations to a PlainText file. I then use a KM script to name the the Skim Notes file to my convention.

Using another KM script, I parse the single notes file into separate text files (one for each highlight or annotation). Each file is named to convention and contains the text I highlighted in the manuscript, my own comments, and the full reference. All the individual notes are aggragated into a folder. I move this folder from my Desktop to the cloud so I can access it from anywhere. I call this my Literature Comments Folder. Now I move to Ulysses.

Ulysses

Ulysses is able to read files anywhere on my computer. I’ve configured Ulysses to point to my Literature Comments Folder so all my comments are available in an organized fashion. At this point I can add additional comments to my individual highlight files. The next step is to index the files in Devonthink.

Devonthink

Finally, I open Devonthink. This workflow has matured from what I discussed in this entry. I have a database that is solely used to index my scholarly reading. From the File Menu, I update the index (NOT import) of my Literature Comments Folder. Indexing this folder allows me to take advantage of the “Artificial Intelligence” of Devonthink, finding relevant information throughout my reading.

Part 2: Creating

Tinderbox

At this point I’m ready to start developing my scholarly work. I use Tinderbox (in Outline View) to generate a high-level preliminary outline. Tinderbox is a power-user’s application. I’ve only scratched the surface of its capabilities, but find it extremely useful early on to organize thoughts and find connections between what I’ve read and what I hope to write.

From within Devonthink, I review each of my comments. If I find something I want to include, I drag and drop the file (comment, reference, and highlighted text) into Tinderbox. Then, using Devonthink’s “See Also & Classify” command, I see related notes in my Literature Comments Folder . I drag and drop the additional comments into Tinderbox too. As I think of new ideas, it’s not uncommon for me to conduct a freeform search from within Devonthink to see which comments bubble to the top.

Once I have several dozen comments in Tinderbox, I find myself entertaining new thoughts, and often adjusting (or add to) my outline.

Another way I approach the creative process is to surf through interesting comments and move them one by one into Tinderbox without organizing them (usually in the Map View). Once I have a few dozen of these interesting quotes and highlights, I start to see connections between them, letting me further refine and organize my thoughts (and begin to develop and outline).

Once I’m satisfied with my outline, I’ll sometimes export to OmniOutliner for additional organization. But most times, I’ll export my outline directly from Tinderbox to Scrivener.

Part 3: Writing and Formatting

Scrivener

Scrivener is the place where the early versions of my manuscript are built. Scrivener imports OPML files from Tinderbox or OmniOutliner—each bullet of the outline gets its own content field. I do the majority of my early writing in Scrivener, attacking whatever section I feel like writing at the time. I use the Magic Citations of Papers 3 to insert my references as I write. Once I get words down on the screen, I often find myself tweaking the outline in Scrivener. This early phase, when I’m writing on the go, is when I yearn for the iPad version of Scrivener. Until that’s available, I’ll continue to use Scrivener’s synchronization with SimpleNote when I plan to write on my iPad.

When I’ve completed all the sections in my Scrivener outline, I’ll export everything I’ve written to Ulysses. I use Ulysses to edit and rewrite (in Markdown) until I think the work is ready for submission. As I’m importing and editing my paper in Ulysses, I make sure to have the document type set to Markdown (not MarkdownXL). MarkdownXL uses the curly brackets as an internal mark for annotations. If I use MarkdownXL in Ulysses, all of my Papers citations are formatted as footnotes—very annoying.

Word or Pages

I write and edit for several rounds in Ulysses. Ulysses for iPad makes this process more seamless and enjoyable. Unfortunately, when I’m done writing, I cannot format my bibliography in Ulysses. I have to export my file to Word or Pages. That’s okay though, I still have to format my paper. I use an old version of Pages (the new version of Pages still doesn’t allow bibliography formatting). Microsoft Word also works. To do this, I highlight all my text and from the Ulysses Edit Menu I select Copy as RTF (Word), then paste it in the word processing application. After my bibliography is formatted, I format the rest of the paper.

Finally, as the final check of my writing, I use a KM script to read back the text to me. I often find errors, even in this late phase of writing. Finally, I double check everything conforms to required format of the journal (or funding agency) and hit submit.

And there you have it: my writing workflow. As with most of my workflows it is continuously subject to improvement. For the time being this workflow has streamlined my writing. I hope it works for you too.

Switching from SimpleNote to Notesy

In past entries I’ve written about how I rely on the combination of SimpleNote and nvALT to capture ideas, meeting notes, and more. I’ve been blissfully ignorant of the syncing issues between the two. I’ve had little problem with this combination, but apparently others have. 

When I read that Brett Terpstra (the architect of nvALT) will no longer support SimpleNote, I knew it was time to find an alternative. For me, the choice was between Notesy and Nebulous Notes. Since I need my SimpleNote replacement primarily as a pass-through and for quick mobile searches, I settled on Notesy. I’ll reserve Nebulous for more in-depth tasks.

I also learned that Brett recommends DropBox syncing for nvALT–so I’ve moved my nvALT Folder back to DropBox. I backed up my folder and followed Michael Schechter’s directions to make sure I suffered no data loss.

The total time to make the switch was about 10 minutes.

Meeting Workflows: Processing Meeting Notes and Discovering Linkages

It was a great deal of fun to join my friends, David Sparks - MacSparky, Katie Floyd, and Brett Terpstra (hosted by Dan Miller) on stage at MacWorld Live to discuss my Meeting Workflow. The session was webcast live from the MacWorld site. Following the session, I received many questions as to how I process my notes once they’ve been collected. Here is what I do…..

As I mentioned, I write and capture all my notes in Plaintext (using Drafts on my iPad and iPhone and nvALT on my Mac). I covered the way I capture ideas (IdeaX) using TextExpander. I use a similar method for capturing meeting notes (MeetX), chunks of writing (ScribbleX), quotations (QuoteX), and random thoughts (ThoughtX). Using Simplenote Notesy, I’m able to keep my notes on my iPad and iPhone in sync with my Mac. A single folder indexed by nvALT serves as the repository for everything, regardless of their content. In a pinch, I can search my notes on my iPad or iPhone using SimpleNote Notesy, but the true power of this workflow is realized when I return to my Mac.

I have alluded to my love of Devonthink Pro Office. I’m especially fond of DT's ability to find related notes using its artificial intelligence. For the purpose of this workflow, I have a single database that indexes three things: (1) my collection of manuscripts (from Papers2), (2) my web clippings, and (3) my nvALT notes. My web clippings are added directly to my DT database, but my Papers folder and nvALT folder are INDEXED, not imported into the same database. Indexing in DT is done by choosing File:Index… and navigating to the folder of interest on your computer (this is only during the initial set-up). You will have to manually update the index your folders each time you add new information. This is quick and simple– done by choosing the appropriate folder in DT and choosing File:Update Indexed Items.

When I’m writing (or searching for information), I can select a particular note and find all related information in my library-whether it’s a scholarly article, a newspaper clipping, a web site, or a note I’ve taken. Often times, DT finds linkages for me that weren’t readily apparent. This speeds my writing process immensely and makes me look like a magician to my peers. I hope it works for you too.

Appended March 2, 2013: Read this entry on why I switched from SimpleNote to Notesy.

Meeting WorkFlows: Efficiently Capturing Meeting Notes

In academics, like every other corporate entity, meetings are a necessary evil.

I’ve tried all sorts of solutions for capturing notes and action items from my meetings. For many years, I would haul my MacBook Pro into the room, relying on a slew of software invoked through Launchbar.

Next, I transitioned to the cool LiveScribe Echo. The Achilles Heel of Smart Pen Technology for me, true to the physician stereotype, is that I have awful handwriting. Most of my handwritten notes were illegible. To make matters worse, sending handwritten notes to OmniFocus was a kludge.

Recently, I’ve been carrying my iPad + Zagg Folio to meetings. Although convenient and portable, I have continued to depend on a slew of software to capture my notes and to-dos. None of my methods were standardized; my notes would constantly get lost.

This inefficient workflow was why I was so interested in the 512 Pixel post, The Capture Form. The author developed a standardized PDF form to capture meetings. But that wasn’t what I found interesting. It was the very last line of the article, with a link to a TextExpander version of the form.

I riffed on his work and developed a new workflow for my iPad + Zagg that I’ve been trying out.

My workflow starts with setting up the following TextExpander snippet:

MeetX - Untitled - %Y-%m-%d at %H:%M

 

ATTENDEES:

JMT

BACKGROUND / REFERENCE:

 

NOTES:

 

ACTION ITEMS FOR ME:

 

ACTION ITEMS FOR OTHERS:

 

The first line automatically names the note as a meeting, appending the current date and time. I use the title "MeetX" to help me with search. I know if I search for MeetX I'll only see my meeting workflow notes (instead of every document that had Meet or Meetings). All that's left to do is fill in the title. Since I synchronize TextExpander between my Mac, iPad, and iPhone using DropBox, my snippet is immediately available on my all my devices.

The second part of the set-up involves OmniFocus and their Mail Drop service (note: in order for this to work you have to sync OmniFocus with the Omni Sync Server). If you haven’t done so, log onto the Omni Sync Server, and apply for the Mail Drop Beta (when I applied, I received my invite in a matter of minutes). Once accepted, you set up a unique email address that is your direct link to Sync Server. To learn more, check out the Omni Mail Drop story at MacSparky.

When I want to take meeting notes, on my iPad, with TextExpander running, I launch Drafts. I expand my snippet (in my case by typing “.mtg”), fill in a title, and am ready to go. If I’m preparing for a meeting in advance, I type in my reference material under the appropriate heading, then fill in the remaining fields during the meeting. Most days, I get started with my note taking immediately when I enter the room.

When the meeting is over, within Drafts, I forward my notes to Notesy Simplenote. Since I’ve set up Notesy to synchronize with NValt on my Mac (as I wrote about previously), my meeting notes are immediately available and searchable on all my devices.

If personal to-do items came out of the meeting, I have another step. From within Drafts, I select “forward to email,” type out a subject name, then email the note to my personalized Omni Mail Drop address. When I open OmniFocus, the item is waiting for me as an Action in my Inbox. Even cooler, the complete meeting text is available in the "Notes" field . If there are multiple actions embedded in the original meeting notes, I spend a few minutes processing the set into single unique actions.

An alternative: from within Drafts select "Send to Omnifocus as note" (of course you have OmniFocus installed on your iPad for this to work). Drafts will launch Omnifocus and the notes of your meeting will be placed in the appropriate section of a new action. The only thing left for you to do is type in the name of the action.

This workflow has helped me immensely. I now have an efficient, standardized, searchable, multi-device method for recording and retrieving my meeting notes.

I’m really excited about this workflow–I hope it works for you too. Let me know what you think.

Appended March 2, 2013: Read this entry on why I switched from SimpleNote to Notesy.

Workflow: Capturing Ideas

Ideas are my lifeblood. Whether ideas for writing projects, grants, or to-dos, I need a simple method to get the ideas out of my head and into my system. An idea might come to me during a meeting, in the car, or on a walk. My system has to be fast, ubiquitous, and flexible. The less thought I have to put into capturing my ideas, the better.

Over time, my workflow for capturing ideas has evolved. You won't be surprised my system revolves around plaintext.

Here is the software you'll need for this workflow (you may also want to read my previous entries on why I use plaintext, Launchbar, and Drafts):

TextExpander allows me to type short key combinations (called Snippets) that expand into words, phrases, or even pictures. I use TextExpander constantly to type things like my email address (.hm expands to my home email, .wm expands to my professional email). I use similar combinations for my home address, my city, state, and my email signature. TextExpander is available for iOS devices (called TextExpander Touch) and is integrated into an increasing number of iOS programs. Under preferences, I choose to keep TextExpander Snippets synchronized using DropBox. I highly recommend this--identical snippets are then available on your Mac, iPhone, and iPad only needing to be entered once.

One must also have nvALT - Notational Velocity Fork installed on your Mac. Notational Velocity Fork is a special version of Notational Velocity that was developed by the genius, Bret Terpstra. It allows me to create text notes seamlessly and has a lightning fast search function. nvALT launches and I just start typing. Whatever I type becomes the title of my new note (after I hit return) while simultaneously searching the nvALT database for matching text strings. Hitting return finalizes the title and move the cursor down to a full note area. It's very fast. You need to check three settings in nvALT. First, be sure to set the "Read from Notes" drop-down menu to your desired folder. I synchronize to my nvALT folder in DropBox. Second, under the "Synchronization" Tab, make sure SimpleNote synchronization is OFF. Finally, under the "Storage" Tab, make sure you're saving as plaintext (not as RTF or HTML). If you choose this set-up, you won't be able to encrypt the nvALT database, but the trade-off in accessibility for me is well worth the price.

Next, make sure you have Simplenote Notesy installed on your iPhone and iPad. Notesy is a note taking program that synchronizes between your Mac and iOS devices using DropBox. Make sure Notesy is configured to synchronize with your nvALT folder in Dropbox hierarchy. I use Notesy as a conduit and for searches, but I rarely use it for writing.

The final programs you'll need are Drafts for iPhone and Drafts for iPad. As I discussed in my previous entry, Drafts is my go-to note taking app and has a place on the coveted home-screen of both my iPhone and iPad. I can get information entered quickly. Only after the information is captured, do I need to decide where to route it. Drafts gives me dozens of possibilities that I can personalize to show or hide.

IDEAS WORKFLOW: when sitting at my Mac and and idea hits me I invoke Launchbar (hitting Command-Space), type nv then return--launching nvAlt. Depending on what the idea is, I use TextExpander snippets. For instance ".wix" automatically types the following: WiPPPx - Untitled - 2012-12-10. I have a similar snippet for project ideas ".idx" expands to IdeaX - Untitled - 2012-12-10, and many others as well. All I have to do is change the "Untitled" to something descriptive, hit return and start typing. My idea or writing snippet is captured to nvALT (and is thus searchable via Spotlight, nvALT, or any other search utility I prefer). Because I've set up synchronization these idea files are available on my iPhone or iPad regardless of location.

If i'm on my iPad or iPhone and want to capture an idea, I use Drafts. Once I've completed the thought (using typing or voice entry), I must enter a title. Since Drafts is TextExpander Touch enabled, I can use my same Snippets to name the idea to convention (make sure TextExpander is open on your iPad or iPhone for the text expansion to work). I then route the completed Drafts note to Notesy (via the Drafts interface). It is saved, synchronized, and available on all my devices, all the time.

I can then search and find single or multiple ideas using the nvALT search interface. If I type "IdeaX" in the nvALT search box, ALL my ideas are returned in neat order. If, instead, I'm searching for a specific idea, I can be more explicit with my search terms, finding related items or even a single item.

Although this workflow takes a bit of set-up, the payoff is immense. Over time, I have accumulated hundreds of potential projects, text snippets, and more using this method. Many of them would have been lost, had I not had a quick and convenient way to capture them.

I hope you find the workflow useful.

Appended March 2, 2013: Read this entry on why I switched from SimpleNote to Notesy.