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