“That’s quite a viewer. I’ve never seen anything quite like it before. What is it?”
Sinclair and Kosh in Babylon 5: “The War Prayer”
Okay, not the most creative posting name, but that’s what it’s about. A question about linking to documents in DEVONthink (thanks Max :-)) led me to look into Item Links in DEVONthink. They look like this:
and are a lot of HTML links … very much like — and you can do some cool things with them. They work not only for DEVONthink but for other applications as well. This here for example:
This is the start page that is loaded per default in my browser — and it allows me to quickly open specific perspectives in OmniFocus (task manager) or Folders/Groups in DEVONthink (specific file would have worked as well). Something like this:
It does this by using the x-devonthink-item:// links or omnifocus:/// links in the href of the link, like this:
<a href="omnifocus:///perspective/Doing%20Today" alt="OmniFocus: Doing Today">Doing Today</a>
All you need is an image (here: background.png) and an html-file with an image map (created with a text editor like TextWrangler, here: background_start_page.html) with the content:
<html> <head><title>Startpage</title></head> <body bgcolor="#000000"><div align="center"><img name="background" src="background.png" width="1120" height="650" border="0" id="background" usemap="#background_map" alt="" /><map name="background_map" id="background_map"> <area shape="rect" coords="0,0,560,325" href="x-devonthink-item://LINKADDRESS" alt="Work Notebooks" /> <area shape="rect" coords="560,0,1120,325" href="x-devonthink-item://LINKADDRESS" alt="Goals" /> <area shape="rect" coords="0,325,280,488" href="omnifocus:///perspective/Doing%20Today" alt="OmniFocus: Doing Today" /> <area shape="rect" coords="0,488,280,670" href="omnifocus:///perspective/Projects" alt="OmniFocus: Projects" /> <area shape="rect" coords="280,325,560,670" href="x-devonthink-item://LINKADDRESS" alt="Reading Notebooks" /> <area shape="rect" coords="560,325,1120,670" href="x-devonthink-item://LINKADDRESS" alt="Private Notebooks" /></map></div></body> </html>
Note that I have removed the exact address of the x-devonthink-items — you have to put in your own.
Simply put both files (background image and the .html file) in a directory on your computer (NOT in DEVONthink and it must be on the same computer as DEVONthink and OmniFocus) and open the .html file in your browser (just drag it onto the Icon in your dock). You can then go to the preferences and set the current page as default page. Note that it works with any html file. You do not need an image map, I just think that it looks nicer.
Why is this cool?
How do you get the links?
So far, I have seen these kinds of links in DEVONthink, OmniFocus (thanks to an Asian Efficiency Posting), and Papers 2 (currently testing it). In …
- DEVONthink: Right-click on the file or folder you want to link to, then select “Copy Item Link”. If you link to a file that DEVONthink cannot open natively, you see a DEVONthink window with the file in it. You have to open it externally then (shift+command+O works).
- OmniFocus: As this Asian Efficiency Posting shows, its simply omnifocus:///perspective/PERSPECTIVENAME — if your perspective name includes a space, replace this with a %20.
- Papers 2: Right-Click on the article and select “Copy As” and then “Papers Link”, it gives you something like papers2://publication/doi/10.1542/peds.2012-2204
There are probably other applications as well, but these three are the store houses for most of my work at the moment and the ones I use most frequently.
Works in other applications as well … and very well, but BE CAREFUL!
Note that you can use these links in many other applications as well (I suppose in a lot of them as long as they support HTML links). The original reader question was about referring to documents in DEVONthink from Circus Ponies Notebook documents. It works without problems. Copy and paste the Item link from DEVONthink to Circus Ponies Notebook and it works (see below). You can also add these links in the URL field of an iCal entry (e.g., if you need a specific folder when the alarm sounds), or in a the notes field of an OmniFocus entry (as the Asian Efficiency Posting recommends). You can even create a bookmark in Firefox (e.g., in the bookmarks toolbar) and use the link as URL.
Note that if you refer to documents, e.g., in DEVONthink, make sure that you can understand the links if something happens with DEVONthink. A link like
does not tell you anything about the document you meant. When you copy and paste the “Copy Item Link” from DEVONthink into Circus Ponies Notebook, you get a link where the link text is the name of the document — if you use the normal paste (cmd + v). Circus Ponies Notebook has other kinds of paste that lead to different results (see image):
In any case, make sure that that name means something to you, e.g., if its an article, use the authorname_(authorname_)year name convention in DEVONthink!