summaryrefslogtreecommitdiffstats
path: root/2022/talks/hyperorg.md
blob: c0a1ecaa4caa6c3bbc2882121342f6e296e2dc25 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
[[!sidebar content=""]]
[[!meta title="Powerful productivity with Hyperbole and Org Mode"]]
[[!meta copyright="Copyright © 2022 Robert Weiner"]]
[[!inline pages="internal(2022/info/hyperorg-nav)" raw="yes"]]

<!-- Initially generated with emacsconf-generate-talk-page and then left alone for manual editing -->
<!-- You can manually edit this file to update the abstract, add links, etc. --->


# Powerful productivity with Hyperbole and Org Mode
Robert Weiner (wine-er)

[[!inline pages="internal(2022/info/hyperorg-before)" raw="yes"]]

GNU Hyperbole and Org Mode are both parts of Emacs;
both offer outlining and hypertext support but Org uses its own
native format while Hyperbole can work across all major modes and
data formats, including Org's.  The two systems are compatible.
This talk will show ways to use them together and the resultant
productivity benefits that can be achieved.

Outline:

a. Context-sensitive Action Key on Org Constructs
b. Automate Actions in Org Mode with Hyperbole Key Series
c. Rapidly Link to or from Org Headers, e.g. in Source Code
d. Search over Org Notes with Hyperbole's HyRolo
e. Dynamically Expand/Contract Org outlines exported to web pages
f. Embed Org Tables in Hyperbole Koutlines
g. Create Your Own Hyperbole Implicit Buttons from Org
h. Hyperbole Expands Org Mode to an Emacs-wide Persistant Hyperbutton-Action Capability on Any Textual Format


# Discussion

## Notes

-   Sorry a few pixels at the left of the screen are cut off due to how
    it was recorded but it should not affect the bulk of the information
    you'll see.  We'll also make the Org document driving the
    presentation available for offline review.

## Questions and answers

-   Q: Can you have multiple implicit button files, if so how would you
    know which link came from what files?
    -   A: Links are one way at the present time, so you just place them
        where they are needed and activate them.  Things like HyRolo can
        be used to locate matching elements across multiple files.
-   Q: What about using implicit buttons with multiple people with
    different configs?
    -   A:As mentioned in the talk, environment and Lisp variables
        embedded in path links allow for sharing links whose location
        varies by user/team.  In other cases you often want team members
        to see the same result as someone else sees when a button is
        activated.
-   Q: Coming in from Org/Org-mode, would it be a fair assessment that
    Hyperbole is in some way a *generalization* of what most people
    think of the great features of Org to work across formats (i.e. not
    just in Org buffers, though *also* therein), with the Hyperbole
    links/buttons being the recurring example? And that it then further
    adds some capabilities (again across formats and thus including in
    Org buffers). Being a global minor mode (vs a major mode and thus
    coupled to a particular format namely org) is interesting per se,
    and I think goes to RMS's talk that Org's features could be more
    generalized and modularized. How is Hyperbole in that respect?
    -   A:Org, I believe, is focused on being an interactive notebook
        and publishing tool notably for scientists or academics, even
        though it is used by other technical people.  Hyperbole is for
        creating a hyperverse filled with many types of text files and
        interlinking them while maintaining their native formats; it
        does little with conversion to formats for publication, aside
        from export of Koutlines to HTML for use on the web.
-   Q: Internal/Radio targets: are they able to link to other Org mode
    files (that are part of my agenda)? Background: <<<example
    target>>> (default Org mode feature) is great for glossary and so
    forth but only works within a single Org mode file.
    -   A: You could develop an implicit button type that would link
        from an external file to a radio target in another file.  These
        usually are just a few lines of code.
-   Q: Your package advances how useful a mouse can be with creating
    links, do you have any experiance or thoughts about how
    touchscreens, or mice could be used or improved with emacs..
    -   A: I place the Action Mouse Key on my middle mouse button and
        the Assist Mouse Key on my right mouse button because I find
        them that useful.  The existing drag capabilities of the mouse
        are similar to actions we would have for a touchscreen
        interface.
-   Q: Would you consider Hyperbole to be more of a format spec that can
    then be handled however we want? Or the engine itself along with
    that format? i.e. can the simple link formats be used for other
    extensible purposes?
    -   A: yes, hyperbole was thoughts a s an hypertxt engine and then
        be avail. to multiple apps (as API). turns out didnt work really
        well
-   Q: How is the integration with org-roam?
    -   A: We are just beginning to work with org-roam and will likely
        add a Hyperbole interface to it across time.  We are also
        looking at related tools and how
-   Q: When doing something where do you determine where to put it
    'kotl, rolo, org".? I like kotl for journaling and org mode for
    gtd.:)
    -   A: sure, they're both outlined formats and they work well.
        depends on your taste
-   Q:Would you recommend a specific resource for getting into
    Hyperbole, or should I just start with the manual? Definitely
    interested in getting into this. (oh I love interactive demo style
    formats, great!)
    -   A: dont start with the manual! :) for learning use the menu
        system C-h-d-d and watch the interactive demo. Then watch one of
        the tutorial videos (mentioned before)
-   Q: What is hyperorg?
    -   A: probably a typo for hyperborg
-   Q:Do you have advice for people who'd like to try using Hyperbole
    with Org, but don't want to pollute Org files with inline Hyperbole
    links (e.g., with files that will be published)? (...Or is that
    inevitably the point of Hyperbole links?)
    -   A:


[[!inline pages="internal(2022/info/hyperorg-after)" raw="yes"]]

[[!inline pages="internal(2022/info/hyperorg-nav)" raw="yes"]]

[[!taglink CategoryHyperbole]]