DEVONthink/README.md
2024-10-28 01:58:26 +01:00

2.5 KiB

DEVONthink

Code for various AppleScripts I've written or modified for DEVONthink Pro 3

Creates Markdown-formatted citations from DEVONthink documents, with deeplinks and Bates number support. Perfect for reviewing administrative records in DEVONthink.

DEVONthink Bates deeplink script demo

Watch demo video →

Usage

  1. Open document in DEVONthink
  2. Select text to quote
  3. Run script
  4. Paste formatted citation into a Markdown editor

Features

  • Copies selected text to clipboard
  • Calculates and generates a Bates cite using if filename is compatible (see below), e.g., FWS 134 (if the selected text is on page 3 of a file that is named, e.g., FWS_000131.pdf)
  • For non-Bates numbered documents, it generates a standardized cite, e.g., IPCC Report at 5 (if the selected text is on page 5 of a file that is named IPCC Report.pdf)
  • Appends Markdown-formatted deeplink to selected text in document to clipboard, using the generated page number (Bates or non-Bates) (see Output Examples below)

Bates-compatible Filenames

The script will parse several different Bates-numbered filenaming conventions, including, for example:

  • FWS 000533.pdf
  • FWS-000533.pdf
  • FWS_000533.pdf
  • NMFS 002561-002985.pdf
  • BLM 45.pdf
  • BLM_45-62.pdf

Use my bates script to quickly rename a batch of PDFs (e.g. a complete administrative record) to be compatible with this script while preserving original names in metadata. Find it here →

Output Examples

"The environmental impact study shows..." [FWS 4326](x-devonthink-item://...)
"The data indicates..." [Report Title at 5](x-devonthink-item://...)

Installation

  1. Open Applications/Script Editor.app
  2. Paste in the script and save it as Bates Source Link.scpt
  3. Open DEVONthink
  4. Scripts menu → Open Scripts Folder
  5. Copy or move script to Menu subfolder
  1.  System Settings → Keyboard → Keyboard Shortcuts → App Shortcuts
  2. Select DEVONthink 3.app and click +
  3. Enter exact script name as it appears in the Scripts menu in DEVONthink, i.e., Bates Source Link
  4. Assign desired shortcut, such as:
    • ⌥ + C (Option C)
    • ⇧ ⌥ + C (Option Shift C)

Requirements

  • macOS
  • Perl (for URL encoding)
  • DEVONthink Pro