Mercurial > emacs
annotate lisp/org/org-id.el @ 105173:500233eb2d72
* term.el (term-set-scroll-region): Don't move cursor any more.
(term-handle-ansi-escape): Call term-goto here instead.
Suggested by Ivan Kanis <apple@kanis.eu>.
author | Stefan Monnier <monnier@iro.umontreal.ca> |
---|---|
date | Thu, 24 Sep 2009 02:15:11 +0000 |
parents | 172e1951f385 |
children | 2a8a3a69c1c7 |
rev | line source |
---|---|
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
1 ;;; org-id.el --- Global identifiers for Org-mode entries |
101458
36abe982e7cd
2009-01-25 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100908
diff
changeset
|
2 ;; |
100908 | 3 ;; Copyright (C) 2008, 2009 Free Software Foundation, Inc. |
96045 | 4 ;; |
5 ;; Author: Carsten Dominik <carsten at orgmode dot org> | |
6 ;; Keywords: outlines, hypermedia, calendar, wp | |
7 ;; Homepage: http://orgmode.org | |
104810
86b7fe7d1d8f
2009-09-02 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
104201
diff
changeset
|
8 ;; Version: 6.30c |
96045 | 9 ;; |
10 ;; This file is part of GNU Emacs. | |
11 ;; | |
12 ;; GNU Emacs is free software: you can redistribute it and/or modify | |
13 ;; it under the terms of the GNU General Public License as published by | |
14 ;; the Free Software Foundation, either version 3 of the License, or | |
15 ;; (at your option) any later version. | |
16 | |
17 ;; GNU Emacs is distributed in the hope that it will be useful, | |
18 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of | |
19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
20 ;; GNU General Public License for more details. | |
21 | |
22 ;; You should have received a copy of the GNU General Public License | |
23 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. | |
24 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; | |
25 ;; | |
26 ;;; Commentary: | |
27 | |
28 ;; This file implements globally unique identifiers for Org-mode entries. | |
29 ;; Identifiers are stored in the entry as an :ID: property. Functions | |
30 ;; are provided that create and retrieve such identifiers, and that find | |
31 ;; entries based on the identifier. | |
32 | |
98644
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
33 ;; Identifiers consist of a prefix (default "Org" given by the variable |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
34 ;; `org-id-prefix') and a unique part that can be created by a number |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
35 ;; of different methods, see the variable `org-id-method'. |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
36 ;; Org has a builtin method that uses a compact encoding of the creation |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
37 ;; time of the ID, with microsecond accuracy. This virtually |
96045 | 38 ;; guarantees globally unique identifiers, even if several people are |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
39 ;; creating IDs at the same time in files that will eventually be used |
100458
ba23e35d3eaf
2008-12-17 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100448
diff
changeset
|
40 ;; together. As an external method `uuidgen' is supported, if installed |
98644
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
41 ;; on the system. |
96045 | 42 ;; |
43 ;; This file defines the following API: | |
44 ;; | |
45 ;; org-id-get-create | |
46 ;; Create an ID for the entry at point if it does not yet have one. | |
47 ;; Returns the ID (old or new). This function can be used | |
48 ;; interactively, with prefix argument the creation of a new ID is | |
49 ;; forced, even if there was an old one. | |
50 ;; | |
51 ;; org-id-get | |
52 ;; Get the ID property of an entry. Using appropriate arguments | |
53 ;; to the function, it can also create the ID for this entry. | |
54 ;; | |
55 ;; org-id-goto | |
56 ;; Command to go to a specific ID, this command can be used | |
57 ;; interactively. | |
58 ;; | |
59 ;; org-id-get-with-outline-path-completion | |
60 ;; Retrieve the ID of an entry, using outline path completion. | |
61 ;; This function can work for multiple files. | |
62 ;; | |
63 ;; org-id-get-with-outline-drilling | |
64 ;; Retrieve the ID of an entry, using outline path completion. | |
65 ;; This function only works for the current file. | |
66 ;; | |
67 ;; org-id-find | |
68 ;; Find the location of an entry with specific id. | |
69 ;; | |
70 | |
71 (require 'org) | |
72 | |
73 (declare-function message-make-fqdn "message" ()) | |
74 | |
75 ;;; Customization | |
76 | |
77 (defgroup org-id nil | |
78 "Options concerning global entry identifiers in Org-mode." | |
79 :tag "Org ID" | |
80 :group 'org) | |
81 | |
104164
ac1a55cc2c38
2009-08-06 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
101757
diff
changeset
|
82 (defcustom org-id-uuid-program "uuidgen" |
ac1a55cc2c38
2009-08-06 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
101757
diff
changeset
|
83 "The uuidgen program." |
ac1a55cc2c38
2009-08-06 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
101757
diff
changeset
|
84 :group 'org-id |
ac1a55cc2c38
2009-08-06 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
101757
diff
changeset
|
85 :type 'string) |
98644
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
86 |
100458
ba23e35d3eaf
2008-12-17 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100448
diff
changeset
|
87 (defcustom org-id-method |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
88 (condition-case nil |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
89 (if (string-match "\\`[-0-9a-fA-F]\\{36\\}\\'" |
104164
ac1a55cc2c38
2009-08-06 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
101757
diff
changeset
|
90 (org-trim (shell-command-to-string |
ac1a55cc2c38
2009-08-06 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
101757
diff
changeset
|
91 org-id-uuid-program))) |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
92 'uuidgen |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
93 'org) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
94 (error 'org)) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
95 "The method that should be used to create new IDs. |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
96 |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
97 If `uuidgen' is available on the system, it will be used as the default method. |
100458
ba23e35d3eaf
2008-12-17 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100448
diff
changeset
|
98 if not, the method `org' is used. |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
99 An ID will consist of the optional prefix specified in `org-id-prefix', |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
100 and a unique part created by the method this variable specifies. |
98644
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
101 |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
102 Allowed values are: |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
103 |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
104 org Org's own internal method, using an encoding of the current time to |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
105 microsecond accuracy, and optionally the current domain of the |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
106 computer. See the variable `org-id-include-domain'. |
98644
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
107 |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
108 uuidgen Call the external command uuidgen." |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
109 :group 'org-id |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
110 :type '(choice |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
111 (const :tag "Org's internal method" org) |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
112 (const :tag "external: uuidgen" uuidgen))) |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
113 |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
114 (defcustom org-id-prefix nil |
96045 | 115 "The prefix for IDs. |
116 | |
117 This may be a string, or it can be nil to indicate that no prefix is required. | |
118 When a string, the string should have no space characters as IDs are expected | |
119 to have no space characters in them." | |
120 :group 'org-id | |
121 :type '(choice | |
122 (const :tag "No prefix") | |
123 (string :tag "Prefix"))) | |
124 | |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
125 (defcustom org-id-include-domain nil |
96045 | 126 "Non-nil means, add the domain name to new IDs. |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
127 This ensures global uniqueness of IDs, and is also suggested by |
98644
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
128 RFC 2445 in combination with RFC 822. This is only relevant if |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
129 `org-id-method' is `org'. When uuidgen is used, the domain will never |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
130 be added. |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
131 The default is to not use this because we have no really good way to get |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
132 the true domain, and Org entries will normally not be shared with enough |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
133 people to make this necessary." |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
134 :group 'org-id |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
135 :type 'boolean) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
136 |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
137 (defcustom org-id-track-globally t |
100458
ba23e35d3eaf
2008-12-17 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100448
diff
changeset
|
138 "Non-nil means, track IDs through files, so that links work globally. |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
139 This work by maintaining a hash table for IDs and writing this table |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
140 to disk when exiting Emacs. Because of this, it works best if you use |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
141 a single Emacs process, not many. |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
142 |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
143 When nil, IDs are not tracked. Links to IDs will still work within |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
144 a buffer, but not if the entry is located in another file. |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
145 IDs can still be used if the entry with the id is in the same file as |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
146 the link." |
96045 | 147 :group 'org-id |
148 :type 'boolean) | |
149 | |
99139
8fa7ef477c04
2008-10-26 Carsten Dominik <dominik@science.uva.nl>
Carsten Dominik <dominik@science.uva.nl>
parents:
98871
diff
changeset
|
150 (defcustom org-id-locations-file (convert-standard-filename |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
151 "~/.emacs.d/.org-id-locations") |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
152 "The file for remembering in which file an ID was defined. |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
153 This variable is only relevant when `org-id-track-globally' is set." |
96045 | 154 :group 'org-id |
155 :type 'file) | |
156 | |
157 (defvar org-id-locations nil | |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
158 "List of files with IDs in those files. |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
159 Depending on `org-id-use-hash' this can also be a hash table mapping IDs |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
160 to files.") |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
161 |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
162 (defvar org-id-files nil |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
163 "List of files that contain IDs.") |
96045 | 164 |
165 (defcustom org-id-extra-files 'org-agenda-text-search-extra-files | |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
166 "Files to be searched for IDs, besides the agenda files. |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
167 When Org reparses files to remake the list of files and IDs it is tracking, |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
168 it will normally scan the agenda files, the archives related to agenda files, |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
169 any files that are listed as ID containing in the current register, and |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
170 any Org-mode files currently visited by Emacs. |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
171 You can list additional files here. |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
172 This variable is only relevant when `org-id-track-globally' is set." |
96045 | 173 :group 'org-id |
174 :type | |
175 '(choice | |
176 (symbol :tag "Variable") | |
177 (repeat :tag "List of files" | |
178 (file)))) | |
179 | |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
180 (defcustom org-id-search-archives t |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
181 "Non-nil means, search also the archive files of agenda files for entries. |
100458
ba23e35d3eaf
2008-12-17 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100448
diff
changeset
|
182 This is a possibility to reduce overhead, but it means that entries moved |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
183 to the archives can no longer be found by ID. |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
184 This variable is only relevant when `org-id-track-globally' is set." |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
185 :group 'org-id |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
186 :type 'boolean) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
187 |
96045 | 188 ;;; The API functions |
189 | |
190 ;;;###autoload | |
191 (defun org-id-get-create (&optional force) | |
192 "Create an ID for the current entry and return it. | |
193 If the entry already has an ID, just return it. | |
194 With optional argument FORCE, force the creation of a new ID." | |
195 (interactive "P") | |
196 (when force | |
197 (org-entry-put (point) "ID" nil)) | |
198 (org-id-get (point) 'create)) | |
100267
c851df8e004e
2008-12-07 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
99866
diff
changeset
|
199 |
96045 | 200 ;;;###autoload |
201 (defun org-id-copy () | |
202 "Copy the ID of the entry at point to the kill ring. | |
203 Create an ID if necessary." | |
204 (interactive) | |
104164
ac1a55cc2c38
2009-08-06 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
101757
diff
changeset
|
205 (org-kill-new (org-id-get nil 'create))) |
96045 | 206 |
207 ;;;###autoload | |
208 (defun org-id-get (&optional pom create prefix) | |
209 "Get the ID property of the entry at point-or-marker POM. | |
210 If POM is nil, refer to the entry at point. | |
211 If the entry does not have an ID, the function returns nil. | |
212 However, when CREATE is non nil, create an ID if none is present already. | |
213 PREFIX will be passed through to `org-id-new'. | |
214 In any case, the ID of the entry is returned." | |
215 (let ((id (org-entry-get pom "ID"))) | |
216 (cond | |
217 ((and id (stringp id) (string-match "\\S-" id)) | |
218 id) | |
219 (create | |
220 (setq id (org-id-new prefix)) | |
221 (org-entry-put pom "ID" id) | |
222 (org-id-add-location id (buffer-file-name (buffer-base-buffer))) | |
223 id) | |
224 (t nil)))) | |
225 | |
226 ;;;###autoload | |
227 (defun org-id-get-with-outline-path-completion (&optional targets) | |
228 "Use outline-path-completion to retrieve the ID of an entry. | |
229 TARGETS may be a setting for `org-refile-targets' to define the eligible | |
230 headlines. When omitted, all headlines in all agenda files are | |
231 eligible. | |
232 It returns the ID of the entry. If necessary, the ID is created." | |
233 (let* ((org-refile-targets (or targets '((nil . (:maxlevel . 10))))) | |
100267
c851df8e004e
2008-12-07 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
99866
diff
changeset
|
234 (org-refile-use-outline-path |
96045 | 235 (if (caar org-refile-targets) 'file t)) |
104164
ac1a55cc2c38
2009-08-06 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
101757
diff
changeset
|
236 (org-refile-target-verify-function nil) |
96045 | 237 (spos (org-refile-get-location "Entry: ")) |
100267
c851df8e004e
2008-12-07 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
99866
diff
changeset
|
238 (pom (and spos (move-marker (make-marker) (nth 3 spos) |
96045 | 239 (get-file-buffer (nth 1 spos)))))) |
240 (prog1 (org-id-get pom 'create) | |
241 (move-marker pom nil)))) | |
242 | |
243 ;;;###autoload | |
244 (defun org-id-get-with-outline-drilling (&optional targets) | |
245 "Use an outline-cycling interface to retrieve the ID of an entry. | |
246 This only finds entries in the current buffer, using `org-get-location'. | |
247 It returns the ID of the entry. If necessary, the ID is created." | |
248 (let* ((spos (org-get-location (current-buffer) org-goto-help)) | |
249 (pom (and spos (move-marker (make-marker) (car spos))))) | |
250 (prog1 (org-id-get pom 'create) | |
251 (move-marker pom nil)))) | |
252 | |
253 ;;;###autoload | |
254 (defun org-id-goto (id) | |
255 "Switch to the buffer containing the entry with id ID. | |
256 Move the cursor to that entry in that buffer." | |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
257 (interactive "sID: ") |
96045 | 258 (let ((m (org-id-find id 'marker))) |
259 (unless m | |
260 (error "Cannot find entry with ID \"%s\"" id)) | |
261 (switch-to-buffer (marker-buffer m)) | |
262 (goto-char m) | |
263 (move-marker m nil) | |
100267
c851df8e004e
2008-12-07 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
99866
diff
changeset
|
264 (org-show-context))) |
96045 | 265 |
266 ;;;###autoload | |
267 (defun org-id-find (id &optional markerp) | |
268 "Return the location of the entry with the id ID. | |
269 The return value is a cons cell (file-name . position), or nil | |
270 if there is no entry with that ID. | |
271 With optional argument MARKERP, return the position as a new marker." | |
101458
36abe982e7cd
2009-01-25 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100908
diff
changeset
|
272 (cond |
36abe982e7cd
2009-01-25 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100908
diff
changeset
|
273 ((symbolp id) (setq id (symbol-name id))) |
36abe982e7cd
2009-01-25 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100908
diff
changeset
|
274 ((numberp id) (setq id (number-to-string id)))) |
96045 | 275 (let ((file (org-id-find-id-file id)) |
276 org-agenda-new-buffers where) | |
277 (when file | |
278 (setq where (org-id-find-id-in-file id file markerp))) | |
279 (unless where | |
280 (org-id-update-id-locations) | |
281 (setq file (org-id-find-id-file id)) | |
282 (when file | |
283 (setq where (org-id-find-id-in-file id file markerp)))) | |
284 where)) | |
285 | |
286 ;;; Internal functions | |
287 | |
288 ;; Creating new IDs | |
289 | |
290 (defun org-id-new (&optional prefix) | |
291 "Create a new globally unique ID. | |
292 | |
293 An ID consists of two parts separated by a colon: | |
294 - a prefix | |
98644
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
295 - a unique part that will be created according to `org-id-method'. |
96045 | 296 |
297 PREFIX can specify the prefix, the default is given by the variable | |
298 `org-id-prefix'. However, if PREFIX is the symbol `none', don't use any | |
299 prefix even if `org-id-prefix' specifies one. | |
300 | |
301 So a typical ID could look like \"Org:4nd91V40HI\"." | |
302 (let* ((prefix (if (eq prefix 'none) | |
98644
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
303 "" |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
304 (concat (or prefix org-id-prefix) ":"))) |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
305 unique) |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
306 (if (equal prefix ":") (setq prefix "")) |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
307 (cond |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
308 ((eq org-id-method 'uuidgen) |
104164
ac1a55cc2c38
2009-08-06 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
101757
diff
changeset
|
309 (setq unique (org-trim (shell-command-to-string org-id-uuid-program)))) |
98644
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
310 ((eq org-id-method 'org) |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
311 (let* ((etime (org-id-reverse-string (org-id-time-to-b36))) |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
312 (postfix (if org-id-include-domain |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
313 (progn |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
314 (require 'message) |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
315 (concat "@" (message-make-fqdn)))))) |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
316 (setq unique (concat etime postfix)))) |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
317 (t (error "Invalid `org-id-method'"))) |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
318 (concat prefix unique))) |
96045 | 319 |
98644
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
320 (defun org-id-reverse-string (s) |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
321 (mapconcat 'char-to-string (nreverse (string-to-list s)) "")) |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
322 |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
323 (defun org-id-int-to-b36-one-digit (i) |
96045 | 324 "Turn an integer between 0 and 61 into a single character 0..9, A..Z, a..z." |
325 (cond | |
326 ((< i 10) (+ ?0 i)) | |
98644
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
327 ((< i 36) (+ ?a i -10)) |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
328 (t (error "Larger that 35")))) |
96045 | 329 |
98644
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
330 (defun org-id-b36-to-int-one-digit (i) |
96045 | 331 "Turn a character 0..9, A..Z, a..z into a number 0..61. |
332 The input I may be a character, or a single-letter string." | |
333 (and (stringp i) (setq i (string-to-char i))) | |
334 (cond | |
335 ((and (>= i ?0) (<= i ?9)) (- i ?0)) | |
98644
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
336 ((and (>= i ?a) (<= i ?z)) (+ (- i ?a) 10)) |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
337 (t (error "Invalid b36 letter")))) |
96045 | 338 |
98644
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
339 (defun org-id-int-to-b36 (i &optional length) |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
340 "Convert an integer to a base-36 number represented as a string." |
96045 | 341 (let ((s "")) |
342 (while (> i 0) | |
343 (setq s (concat (char-to-string | |
98644
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
344 (org-id-int-to-b36-one-digit (mod i 36))) s) |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
345 i (/ i 36))) |
96045 | 346 (setq length (max 1 (or length 1))) |
347 (if (< (length s) length) | |
348 (setq s (concat (make-string (- length (length s)) ?0) s))) | |
349 s)) | |
350 | |
98644
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
351 (defun org-id-b36-to-int (s) |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
352 "Convert a base-36 string into the corresponding integer." |
96045 | 353 (let ((r 0)) |
98644
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
354 (mapc (lambda (i) (setq r (+ (* r 36) (org-id-b36-to-int-one-digit i)))) |
96045 | 355 s) |
356 r)) | |
357 | |
98644
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
358 (defun org-id-time-to-b36 (&optional time) |
96045 | 359 "Encode TIME as a 10-digit string. |
360 This string holds the time to micro-second accuracy, and can be decoded | |
361 using `org-id-decode'." | |
362 (setq time (or time (current-time))) | |
98644
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
363 (concat (org-id-int-to-b36 (nth 0 time) 4) |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
364 (org-id-int-to-b36 (nth 1 time) 4) |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
365 (org-id-int-to-b36 (or (nth 2 time) 0) 4))) |
96045 | 366 |
367 (defun org-id-decode (id) | |
368 "Split ID into the prefix and the time value that was used to create it. | |
369 The return value is (prefix . time) where PREFIX is nil or a string, | |
370 and time is the usual three-integer representation of time." | |
371 (let (prefix time parts) | |
372 (setq parts (org-split-string id ":")) | |
373 (if (= 2 (length parts)) | |
374 (setq prefix (car parts) time (nth 1 parts)) | |
375 (setq prefix nil time (nth 0 parts))) | |
98644
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
376 (setq time (org-id-reverse-string time)) |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
377 (setq time (list (org-id-b36-to-int (substring time 0 4)) |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
378 (org-id-b36-to-int (substring time 4 8)) |
e1cc41b9282d
2008-10-12 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
97027
diff
changeset
|
379 (org-id-b36-to-int (substring time 8 12)))) |
96045 | 380 (cons prefix time))) |
381 | |
382 ;; Storing ID locations (files) | |
383 | |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
384 (defun org-id-update-id-locations (&optional files) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
385 "Scan relevant files for IDs. |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
386 Store the relation between files and corresponding IDs. |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
387 This will scan all agenda files, all associated archives, and all |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
388 files currently mentioned in `org-id-locations'. |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
389 When FILES is given, scan these files instead. |
100458
ba23e35d3eaf
2008-12-17 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100448
diff
changeset
|
390 When CHECK is given, prepare detailed information about duplicate IDs." |
96045 | 391 (interactive) |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
392 (if (not org-id-track-globally) |
105166
172e1951f385
* org.el (org-tree-to-indirect-buffer, org-convert-to-oddeven-levels)
Juanma Barranquero <lekktu@gmail.com>
parents:
104810
diff
changeset
|
393 (error "Please turn on `org-id-track-globally' if you want to track IDs") |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
394 (let ((files |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
395 (or files |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
396 (append |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
397 ;; Agenda files and all associated archives |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
398 (org-agenda-files t org-id-search-archives) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
399 ;; Explicit extra files |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
400 (if (symbolp org-id-extra-files) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
401 (symbol-value org-id-extra-files) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
402 org-id-extra-files) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
403 ;; Files associated with live org-mode buffers |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
404 (delq nil |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
405 (mapcar (lambda (b) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
406 (with-current-buffer b |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
407 (and (org-mode-p) (buffer-file-name)))) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
408 (buffer-list))) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
409 ;; All files known to have IDs |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
410 org-id-files))) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
411 org-agenda-new-buffers |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
412 file nfiles tfile ids reg found id seen (ndup 0)) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
413 (setq nfiles (length files)) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
414 (while (setq file (pop files)) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
415 (message "Finding ID locations (%d/%d files): %s" |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
416 (- nfiles (length files)) nfiles file) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
417 (setq tfile (file-truename file)) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
418 (when (and (file-exists-p file) (not (member tfile seen))) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
419 (push tfile seen) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
420 (setq ids nil) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
421 (with-current-buffer (org-get-agenda-file-buffer file) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
422 (save-excursion |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
423 (save-restriction |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
424 (widen) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
425 (goto-char (point-min)) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
426 (while (re-search-forward "^[ \t]*:ID:[ \t]+\\(\\S-+\\)[ \t]*$" |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
427 nil t) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
428 (setq id (org-match-string-no-properties 1)) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
429 (if (member id found) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
430 (progn |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
431 (message "Duplicate ID \"%s\", also in file %s" |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
432 id (car (delq |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
433 nil |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
434 (mapcar |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
435 (lambda (x) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
436 (if (member id (cdr x)) (car x))) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
437 reg)))) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
438 (when (= ndup 0) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
439 (ding) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
440 (sit-for 2)) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
441 (setq ndup (1+ ndup))) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
442 (push id found) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
443 (push id ids))) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
444 (push (cons (abbreviate-file-name file) ids) reg)))))) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
445 (org-release-buffers org-agenda-new-buffers) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
446 (setq org-agenda-new-buffers nil) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
447 (setq org-id-locations reg) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
448 (setq org-id-files (mapcar 'car org-id-locations)) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
449 (org-id-locations-save) ;; this function can also handle the alist form |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
450 ;; now convert to a hash |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
451 (setq org-id-locations (org-id-alist-to-hash org-id-locations)) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
452 (if (> ndup 0) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
453 (message "WARNING: %d duplicate IDs found, check *Messages* buffer" ndup) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
454 (message "%d unique files scanned for IDs" (length org-id-files))) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
455 org-id-locations))) |
96045 | 456 |
457 (defun org-id-locations-save () | |
458 "Save `org-id-locations' in `org-id-locations-file'." | |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
459 (when org-id-track-globally |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
460 (let ((out (if (hash-table-p org-id-locations) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
461 (org-id-hash-to-alist org-id-locations) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
462 org-id-locations))) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
463 (with-temp-file org-id-locations-file |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
464 (print out (current-buffer)))))) |
96045 | 465 |
466 (defun org-id-locations-load () | |
467 "Read the data from `org-id-locations-file'." | |
468 (setq org-id-locations nil) | |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
469 (when org-id-track-globally |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
470 (with-temp-buffer |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
471 (condition-case nil |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
472 (progn |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
473 (insert-file-contents-literally org-id-locations-file) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
474 (goto-char (point-min)) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
475 (setq org-id-locations (read (current-buffer)))) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
476 (error |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
477 (message "Could not read org-id-values from %s. Setting it to nil." |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
478 org-id-locations-file)))) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
479 (setq org-id-files (mapcar 'car org-id-locations)) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
480 (setq org-id-locations (org-id-alist-to-hash org-id-locations)))) |
96045 | 481 |
482 (defun org-id-add-location (id file) | |
100458
ba23e35d3eaf
2008-12-17 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100448
diff
changeset
|
483 "Add the ID with location FILE to the database of ID locations." |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
484 ;; Only if global tracking is on, and when the buffer has a file |
100458
ba23e35d3eaf
2008-12-17 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100448
diff
changeset
|
485 (when (and org-id-track-globally id file) |
99849
621e15919df0
2008-11-23 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
99501
diff
changeset
|
486 (unless org-id-locations (org-id-locations-load)) |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
487 (puthash id (abbreviate-file-name file) org-id-locations) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
488 (add-to-list 'org-id-files (abbreviate-file-name file)))) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
489 |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
490 (add-hook 'kill-emacs-hook 'org-id-locations-save) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
491 |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
492 (defun org-id-hash-to-alist (hash) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
493 "Turn an org-id hash into an alist, so that it can be written to a file." |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
494 (let (res x) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
495 (maphash |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
496 (lambda (k v) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
497 (if (setq x (member v res)) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
498 (setcdr x (cons k (cdr x))) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
499 (push (list v k) res))) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
500 hash) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
501 res)) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
502 |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
503 (defun org-id-alist-to-hash (list) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
504 "Turn an org-id location list into a hash table." |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
505 (let ((res (make-hash-table |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
506 :test 'equal |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
507 :size (apply '+ (mapcar 'length list)))) |
101568
f5aedb5cbd80
2009-01-27 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
101458
diff
changeset
|
508 f) |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
509 (mapc |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
510 (lambda (x) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
511 (setq f (car x)) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
512 (mapc (lambda (i) (puthash i f res)) (cdr x))) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
513 list) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
514 res)) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
515 |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
516 (defun org-id-paste-tracker (txt &optional buffer-or-file) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
517 "Update any IDs in TXT and assign BUFFER-OR-FILE to them." |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
518 (when org-id-track-globally |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
519 (save-match-data |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
520 (setq buffer-or-file (or buffer-or-file (current-buffer))) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
521 (when (bufferp buffer-or-file) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
522 (setq buffer-or-file (or (buffer-base-buffer buffer-or-file) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
523 buffer-or-file)) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
524 (setq buffer-or-file (buffer-file-name buffer-or-file))) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
525 (when buffer-or-file |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
526 (let ((fname (abbreviate-file-name buffer-or-file)) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
527 (s 0)) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
528 (while (string-match "^[ \t]*:ID:[ \t]+\\([^ \t\n\r]+\\)" txt s) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
529 (setq s (match-end 0)) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
530 (org-id-add-location (match-string 1 txt) fname))))))) |
96045 | 531 |
532 ;; Finding entries with specified id | |
533 | |
101458
36abe982e7cd
2009-01-25 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100908
diff
changeset
|
534 ;;;###autoload |
96045 | 535 (defun org-id-find-id-file (id) |
536 "Query the id database for the file in which this ID is located." | |
537 (unless org-id-locations (org-id-locations-load)) | |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
538 (or (gethash id org-id-locations) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
539 ;; ball back on current buffer |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
540 (buffer-file-name (or (buffer-base-buffer (current-buffer)) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
541 (current-buffer))))) |
96045 | 542 |
543 (defun org-id-find-id-in-file (id file &optional markerp) | |
544 "Return the position of the entry ID in FILE. | |
545 If that files does not exist, or if it does not contain this ID, | |
546 return nil. | |
547 The position is returned as a cons cell (file-name . position). With | |
548 optional argument MARKERP, return the position as a new marker." | |
101568
f5aedb5cbd80
2009-01-27 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
101458
diff
changeset
|
549 (let (org-agenda-new-buffers buf pos) |
96045 | 550 (cond |
551 ((not file) nil) | |
552 ((not (file-exists-p file)) nil) | |
553 (t (with-current-buffer (setq buf (org-get-agenda-file-buffer file)) | |
554 (setq pos (org-find-entry-with-id id)) | |
555 (when pos | |
556 (if markerp | |
557 (move-marker (make-marker) pos buf) | |
558 (cons file pos)))))))) | |
559 | |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
560 ;; id link type |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
561 |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
562 ;; Calling the following function is hard-coded into `org-store-link', |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
563 ;; so we do have to add it to `org-store-link-functions'. |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
564 |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
565 (defun org-id-store-link () |
104810
86b7fe7d1d8f
2009-09-02 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
104201
diff
changeset
|
566 "Store a link to the current entry, using its ID." |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
567 (interactive) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
568 (let* ((link (org-make-link "id:" (org-id-get-create))) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
569 (desc (save-excursion |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
570 (org-back-to-heading t) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
571 (or (and (looking-at org-complex-heading-regexp) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
572 (if (match-end 4) (match-string 4) (match-string 0))) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
573 link)))) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
574 (org-store-link-props :link link :description desc :type "id") |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
575 link)) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
576 |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
577 (defun org-id-open (id) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
578 "Go to the entry with id ID." |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
579 (org-mark-ring-push) |
104164
ac1a55cc2c38
2009-08-06 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
101757
diff
changeset
|
580 (let ((m (org-id-find id 'marker)) |
ac1a55cc2c38
2009-08-06 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
101757
diff
changeset
|
581 cmd) |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
582 (unless m |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
583 (error "Cannot find entry with ID \"%s\"" id)) |
104164
ac1a55cc2c38
2009-08-06 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
101757
diff
changeset
|
584 ;; Use a buffer-switching command in analogy to finding files |
ac1a55cc2c38
2009-08-06 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
101757
diff
changeset
|
585 (setq cmd |
ac1a55cc2c38
2009-08-06 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
101757
diff
changeset
|
586 (or |
ac1a55cc2c38
2009-08-06 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
101757
diff
changeset
|
587 (cdr |
ac1a55cc2c38
2009-08-06 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
101757
diff
changeset
|
588 (assq |
ac1a55cc2c38
2009-08-06 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
101757
diff
changeset
|
589 (cdr (assq 'file org-link-frame-setup)) |
ac1a55cc2c38
2009-08-06 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
101757
diff
changeset
|
590 '((find-file . switch-to-buffer) |
ac1a55cc2c38
2009-08-06 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
101757
diff
changeset
|
591 (find-file-other-window . switch-to-buffer-other-window) |
ac1a55cc2c38
2009-08-06 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
101757
diff
changeset
|
592 (find-file-other-frame . switch-to-buffer-other-frame)))) |
ac1a55cc2c38
2009-08-06 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
101757
diff
changeset
|
593 'switch-to-buffer-other-window)) |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
594 (if (not (equal (current-buffer) (marker-buffer m))) |
104164
ac1a55cc2c38
2009-08-06 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
101757
diff
changeset
|
595 (funcall cmd (marker-buffer m))) |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
596 (goto-char m) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
597 (move-marker m nil) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
598 (org-show-context))) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
599 |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
600 (org-add-link-type "id" 'org-id-open) |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
601 |
96045 | 602 (provide 'org-id) |
603 | |
604 ;;; org-id.el ends here | |
605 | |
104810
86b7fe7d1d8f
2009-09-02 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
104201
diff
changeset
|
606 ;; arch-tag: e5abaca4-e16f-4b25-832a-540cfb63a712 |
100448
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
607 |
cea079b68b76
2008-12-16 Carsten Dominik <carsten.dominik@gmail.com>
Carsten Dominik <dominik@science.uva.nl>
parents:
100269
diff
changeset
|
608 |