org-contrib/org-mac-link.org

   1 #+TITLE:     org-mac-link.el -- Grab links from open Mac applications
   2 #+OPTIONS:   ^:{} author:nil
   3 #+STARTUP: odd
   4
   5 [[file:index.org][{Back to Worg's contibutions index}]]
   6
   7 * Overview
   8
   9   This code will allow you to grab the current link or selection from
  10   an open mac application and insert it as a hyperlink at point in an
  11   org-mode document.
  12
  13 *** Supported Applications
  14
  15     The following applications are currently supported:
  16     - Finder.app
  17     - Mail.app
  18     - Address Book.app
  19     - Safari.app
  20     - Skim.app
  21     - Firefox.app
  22     - Firefox.app with the Vimperator plugin
  23     - Google Chrome.app
  24     - Together.app
  25
  26 * Installation
  27
  28   Customize the org group by typing =M-x customize-group RET org RET=, then
  29   expand the /Modules/ section, and enable =mac-link=.
  30
  31   You may also optionally bind a key to activate the link grabber menu, like
  32   this:
  33
  34   : (add-hook 'org-mode-hook (lambda ()
  35   :   (define-key org-mode-map (kbd "C-c g") 'org-mac-grab-link)))
  36
  37 * Usage
  38
  39   Activate the grabber by typing =C-c g= (or whatever key you decided to bind,
  40   as above), or type =M-x org-mac-grab-link RET=. This will give you a menu in
  41   the modeline allowing you to select an application. The current selection in
  42   that application will be inserted at point as a hyperlink in your org-mode
  43   document.
  44
  45 * Customizing
  46
  47   You may customize which applications appear in the grab menu by customizing
  48   the group /org-mac-link/. Changes take effect immediately. If you are using
  49   the org-mode version >=8.2, you can also customize whether the
  50   =org-mac-link= should highlight the selected text when grabbing the link from
  51   Skim.app.