Manually linking annotation files, and other annotation file link questions


tl;dr: the note I made for myself before this post:
“Not clear how to link a file as an annotation, or how to fix annotation links if they get lost. Check of devontechnologies user forum also doesn’t really contain that.”

Pleased to have found DEVONthink a couple of years back, my wife and I have been slowly migrating towards a complete document management system with a parallel paper/backup system as well. In recent months we’ve been scanning a preexisting set of paper files arranged in an adaptation of the US Navy filing manual 5210.1.

Now, in order to re-organize our existing digital files into this structure, I find myself merging several separate satellite databases into one, so that each file may be replicated into the new location(s) but also be accessible in the old digital file structure, so that we aren’t totally lost during the probably months-long transition.

In doing so, I’ve been selecting all satellite database contents at once and moving to the new location, in order to keep any replicant structure already existing in the satellite database rather than end up with duplicates (though to be honest, I haven’t checked whether there is sufficient magic at work that replicants moved at different times will still show up as replicants in the target database; seems like this might actually work).

Everything has gone exactly correctly, except for links to annotation files. In some cases, the annotation files are moved but they do not show up in the annotation inspector on the annotated file (even though it did work before moving to the target database). I’ve had a set of so-far-confusing-to-me loss of links from files to their annotation files that seem at odds with the “location doesn’t matter” comment in the " Annotation File Re-Location?" thread. I won’t go into detail about right here, but could spend some time recreating/describing in more detail if that would be helpful.

But really this post is more about a few questions about the use of annotation files. Having started to do it a little more, I can imagine relying on this feature heavily, but I also expect to need to be moving large subsets of documents between databases for at least a while, and want to understand how it should/can work.

  1. Is there a way to manually specify a file as the annotation, rather than needing to create it through the Annotations inspector? If this was a clear option, I probably wouldn’t have gotten to the point of making this post. Also- I can imagine a time (and even specifically formulate a use case or two) when I would want to do this when importing data and their annotations from paper or another outside-of-DEVONthink source, very similarly to the desire expressed in the “Broken links in annotations” thread.
  2. Not quite the same, but is there a way to see from a file what its annotation link is? I know it is possible to reveal or open the annotation from the Annotations inspector, but any way to get it to show up in the Links inspector? It’s a little bit similar to the request in “Annotation incoming links missing”, but I’m interested in the link showing up on the document being annotated, rather than the annotation document.
  3. Is it possible to have multiple annotation documents for one file? I understand that more or less this can be accomplished by putting links in the annotation document, just trying to understand both limits and suggested/intended use.

That’s it for now. Kudos and appreciation to the whole DEVONteam for outstandingly functional and sane product and support!

Welcome! Others will be able to expand on this, but the very quick answer is “not really” to 1 & 3, and “yes” to 2.

  1. As I understand it (which may be not at all), the link between a file and its annotation is stored in the database rather than anywhere in file metadata, so that if you want to set an existing file as the annotation to another file, you have to create a new annotation in the inspector and paste the contents of the existing file into that.

  2. Control-8 will take you to the Links tab of the Document inspector, which displays outgoing links in the upper pane and incoming links in the lower. The latter will show the annotation file.

  3. No, though again there are partial workarounds of the kind you mention; you can do quite a lot with links and transclusions in the main annotation file.

Thanks @NickLowe

On my setup this only shows if there is explicitly a backlink in the annotation file. Is that different from what you see?

On 1, if you copy and paste the item link of a document into the URL field of the intended annotation file, it will link the two in that relationship. And no, you can’t have more than one annotation file per document.

1 Like

Yes and no – if there’s a backlink in the annotation file (as normally there would be, unless it’s created from a custom template without a backlink placeholder), it’ll show in Incoming Links with a DT icon and just the title of the annotation file. But if you then delete the backlink from the annotation file, it still shows up in Incoming Links with whatever your default editor is for that filetype and (if it’s a Markdown file) with the full link text in Markdown link format. If you then restore the backlink, Incoming Links will then display both versions of the link.

@Bluefrog’s trick with the URL field is new to me, and potentially very useful. It looks as if the association created by this route is slightly different from the result via the regular method, where the URL field of annotation files is empty. The URL field method doesn’t result in a displayed link back to the document in Incoming Links, unless you manually add a backlink in the annotation file.

1 Like