[O] [dev] New version 2.1 of org-favtable: Navigate org-mode easily with a table of favorites

[Marc-Oliver Ihm]

Hello all !

Version 2.1 of org-favtable.el has arrived at worg.
Please find it attached to this message or at worg:

    http://orgmode.org/worg/code/elisp/org-favtable.el

The new Version supports normal org-mode links as well as numerical
references and has therefore been renamed from org-reftable to
org-favtable.

Citing from its documentation:

;;; org-favtable.el --- Table of favorite references and links

;; Purpose:
;;
;;  Mark and find your favorite items and org-locations easily: Create and
;;  update a lookup table of your favorite references and links. Often used
;;  entries automatically bubble to the top of the table; entering some
;;  keywords narrows it to just the matching entries; that way the right
;;  one can be picked easily.
;;
;;  References are essentially small numbers (e.g. "R237" or "-455-"), as
;;  created by this package; links are normal org-mode links.
;;

For a very simple example, please see the end of this message and find
three lines to add to your .emacs as well as a set of five nodes,
representing a simple org-mode setup.

Now, imagine that you want to visit the node for project "bar" but do not
remember its name. However, you recall that its related with "support".

So you type "C-+" to invoke org-favtable and then type "support" and
RET.  This will create an occur-Buffer and show you the three lines from
your table, which contain the keyword "support":


   |     | project | bar                            | support, legal            
     |       8 | [2012-12-07 Fr] | b33e89f5-ab45-44a5-a63d-8644d48508db | 
[2012-12-08 Sa 23:37] |
   | R7  | project | Subproject one                 | support                   
     |       7 | [2013-01-24 Do] |      |                       |
   | R1  | project | foo                            | support                   
     |       1 | [2012-12-03 Mo] | 265c3656-afc3-4ec1-9b36-07ba1765fda9 |       
                |


The first line ("bar") ist the one with the highest access count (8). It
appears right at the top, because the table is automatically sorted
after this number. And every time you access this node through
org-favtable, the count is incremented by one, so that your favorite
(i.e. most visited) entries always stay at the top.

So, you have found project "bar"; now just hit RET, to visit its node.

org-favtable.el has a lot more commands (e.g. to create new references
or search for existing ones in all your org-files); all of them, as well
as the proper setup, are explained in the documentation, which is also
accessible by simply invoking org-favtable.

Any questions, comments or suggestions are highly welcome !


regards, Marc-Oliver Ihm


------------ lines to add to your .emacs ------------

(require 'org-favtable)
(setq org-favtable-id "f3da98e2-e265-4d4e-9c3a-d22c4b7bba23")
(global-set-key (kbd "C-+") 'org-favtable)

------------ example org-mode nodes ------------

* TODO R1 Project foo
  :PROPERTIES:
  :ID:       265c3656-afc3-4ec1-9b36-07ba1765fda9
  :END:

   - [ ] Read paper R3

* TODO Project bar

   - [ ] Talk to Jim

** STARTED R7 Subproject one

** STARTED R8 Subproject two
   :PROPERTIES:
   :ID:       67480c3e-a308-4de4-aba0-e4fed510c4f0
   :END:

* DONE R5 Project baz
   CLOSED: [2012-12-08 Sa 23:01]

    - [X] Clean up directory R4

* TODO Project qux

   - [ ] Clean shoes

* Table of favorites
   :PROPERTIES:
   :ID:       f3da98e2-e265-4d4e-9c3a-d22c4b7bba23
   :END:

  This node is kept and updated by package org-favtable.


  |     | Type    | Description                    | Keywords                   
    |         |                 |      |                       |
  | Ref |         | ;c                             |                            
    | count;s | created         | link | last-accessed         |
  |     |         | <30>                           | <30>                           | 
        |                 | <4>  |                       |
  
|-----+---------+--------------------------------+--------------------------------+---------+-----------------+------+-----------------------|
  |     | project | bar                            | support, legal             
    |       8 | [2012-12-07 Fr] | b33e89f5-ab45-44a5-a63d-8644d48508db | 
[2012-12-08 Sa 23:37] |
  | R7  | project | Subproject one                 | support                    
    |       7 | [2013-01-24 Do] |      |                       |
  | R5  | project | baz                            | financial                  
    |       5 | [2012-12-05 Mi] |      | [2012-12-08 Sa 23:03] |
  | R8  | project | Subproject two                 |                            
    |       3 | [2013-01-24 Do] | 67480c3e-a308-4de4-aba0-e4fed510c4f0 |        
               |
  |     | project | qux                            | sport                      
    |       3 | [2012-12-08 Sa] | ac5fb5d7-b92a-443a-bcca-c9eee9005641 | 
[2012-12-08 Sa 23:01] |
  | R4  | folder  | directory                      |                            
    |       2 | [2012-12-08 Sa] |      | [2012-12-08 Sa 23:04] |
  | R1  | project | foo                            | support                    
    |       1 | [2012-12-03 Mo] | 265c3656-afc3-4ec1-9b36-07ba1765fda9 |        
               |
  | R3  | paper   | printed report                 | legal                      
    |         | [2012-12-04 Di] |      |                       |

org-favtable.el
Description: Text document