Remove unnecessary footnote.
[worg.git] / 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 latest org-mode from Git, you can also customize whether the
50   =org-mac-link= should highlight the selected text when grabbing the link from
51   Skim.app.