To install this package, run in Emacs:
M-x package-install RET org-real RET
Keep track of real things as org-mode links.
package-install RET org-real RET
To create a real link in org-mode, use
C-c C-l real RET.
Real links are created inside-out, starting with the most specific item and working to the most general.
┌──────────────────────────────┐ │ │ │ outside │ │ ↑ │ │ ┌────────── ↑ ───────────┐ │ │ │ ↑ │ │ │ │ ↑ │ │ │ │ ↑ │ │ │ │ ┌─────── ↑ ────────┐ │ │ │ │ │ ↑ │ │ │ │ │ │ inside │ │ │ │ │ │ │ │ │ │ │ └──────────────────┘ │ │ │ │ │ │ │ └────────────────────────┘ │ │ │ └──────────────────────────────┘
The first prompt will be for the thing which is trying to be linked
to, called the "primary thing". Then, the prompt will continue to
ask if more context should be added by pressing
+ until the user
confirms the link with
Org real will help create links by parsing all existing links in the current buffer. When choosing an existing thing, all of the context for that thing is automatically added to the current completion.
This is only possible because of the unique inside-out completion style for inserting a link and makes it very easy to add new things to an existing container.
In order to edit a real link, place the cursor on the link and
C-c C-l. Narrow the link down beyond the context you wish
to change by pressing
BACKSPACE repeatedly, then
+ to add the
If any container in the new link does not match an existing container in the buffer, org-real will prompt you to replace all occurences of that thing with the new context and relationships.
This makes it easy to keep things in sync. If any one link changes location, all links in the currnet buffer are updated accordingly.
If a link is changed manually, use the interactive function
org-real-apply with the cursor on top of the new link to apply
changes from that link to the buffer.
To open a real link, place the cursor within the link and press
C-c C-o. This will display a popup buffer in Org Real mode
showing the location of the link.
To view all real links in the current buffer in a combined diagram,
use the interactive function
(define-key org-mode-map (kbd "C-c r w") 'org-real-world)
Once in boxy mode, you can cycle the visibility level of all
S-TAB or use
TAB to toggle the visibility of
children for a single box.
Emacs movement keys will navigate by boxes rather than characters. Each box in the diagram has these keybindings:
RET / mouse-1Jump to first occurrence of link
oCycle occurrences of links in other window
M-RETOpen all occurences of links by splitting the current window
rJump to the box directly related to the current box
TABexpand/collapse children boxes
Test whether ELC has any complaints
Run all test files in
Creates a dist folder with
Creates an md5 checksum against all files in the dist folder.