From 8a6ab3f5be4455bd6898d8e52801737160e6976e Mon Sep 17 00:00:00 2001 From: Ramin Honary Date: Mon, 28 Nov 2022 02:18:27 +0900 Subject: ramin-honary: changes to presentation page --- 2022/talks/rolodex.md | 199 +++++++++++++++++++++++++++++++++++++------------- 1 file changed, 148 insertions(+), 51 deletions(-) (limited to '2022/talks') diff --git a/2022/talks/rolodex.md b/2022/talks/rolodex.md index ae707a6b..8ec7c6aa 100644 --- a/2022/talks/rolodex.md +++ b/2022/talks/rolodex.md @@ -7,67 +7,164 @@ # Build a Zettelkasten with the Hyperbole Rolodex -Ramin Honary ("Rah-mean" (hard-H) "Ho-na-ree", he/him, , ) +Ramin Honary ("Rah-mean" (hard-H) "Ho-na-ree", he/him. + +- Email: +- Homepage: +- GitHub: [[!inline pages="internal(2022/info/rolodex-before)" raw="yes"]] -"Zettelkasten" is a methodology for marshalling your knowledge, +"Zettelkasten" is a methodology for marshaling your knowledge, ideas, creativity, into a database of hyperlinked notes, each note representing a single quantity of knowledge. The method was first devised by a well-published social scientist named Niklas Luhmann. Though he constructed his database with actual slips of paper in a box with a notebook for indexing, naturally, modern software removes -the manual labor from the process. In the world of Emacs packages, -Org Mode is the most well-known package that provides the tools -necessary for building a Zettelkasten, but it is not the only Emacs -package to provide such tools. But there is an alternative: an -oft-overlooked Emacs package called Hyperbole, and in particular the -"Rolodex" feature, called "HyRolo." It was originally designed for -tracking your personal relations, but it can be used to build a -Zettelkasten with almost no additional configuration or 3rd-party -packages. HyRolo is a purely textual database, and does not require -an external database software to index the notes. It also provides a -very rich set of "actions" so that notes not only link to each -other, but can also trigger Emacs to execute code as well. - -Outline: (about 1 minute per outline item) - -1. Quick overview of the Zettelkasten methodology - - 1.1. What is a single quantity of knowledge - - 1.2. Linking between pieces of knowledge - - 1.3. Composing pieces of knoweldge into hierarchies -2. Tools provided by the Hyperbole Rolodex (HyRolo) - - 2.1. The plain text database format - - 2.1.1. Possible brief digression to explain Hyperbole menu - system - - 2.2. Demo how to add a new entry - - 2.3. Demo how to searching entries - - 2.4. Demo how to hyperlink entries - - 2.5. Overview of the many various types of hyperlink actions - - 2.6. How to compose a hierarchy of notes. -3. Practical examples - - 3.1. Managing daily tasks - - 3.1.1. Integration with Org Agenda to manage TODO lists - - 3.1.2. Keeping track of people, conversations, mail - - 3.1.3. Keeping track of work, projects - - 3.2. Doing research, writing blogs or papers - - 3.2.1. Note hierarchies become your table of contents - - 3.2.2. Following chains of ideas to fill in each section, trimming excess prose - - 3.2.3. Keeping track of sources, references - - 3.3. Writing fiction - - 3.3.1. Heirarchy is less rigid, should follow the story telling model: intro -> conflict -> climax -> resolution - - 3.3.2. Rolodex of fictional characters, chain ideas such that they construct a personal history for each character - - 3.3.3. Chains of events are not as important as establishing tone and mood. Order of exposition need not be linear -4. Conclusions +the manual labor from the process. + +In the world of Emacs packages, Org Mode is the most well-known +package that provides the tools necessary for building a Zettelkasten, +along with extensions such as "Org Roam" which add functionality that +manage links between Org Mode documents. But Org Mode is not the only +Emacs package to provide such tools. + +In this talk, I demonstrate how to use an oft-overlooked package +called Hyperbole as an alternative to Org Roam for managing hyperlinks +and building a Zettelkasten. In particular I use the Hyperbole +"Rolodex" feature, called "HyRolo." It was originally designed for +tracking your personal relations, but it can be used to build a +Zettelkasten with almost no additional configuration or 3rd-party +packages. HyRolo is a purely textual database, and does not require +an external database software to index the notes. It also provides a +very rich set of "actions" so that notes not only link to each other, +but can also trigger Emacs to execute code as well. + +## Presentation outline: + +### Quick overview of the Zettelkasten methodology + + - **Note:** most of what I say about the Zettelkasten method comes + from Sacha Fast of + + - **Zettelkasten is:** a database of interconnected ideas + +### Tools I use in day-to-day writing + + - **Hyperbole:** for hyperlinking, search, project management + + - **Embark:** arranging text, copy and paste + + - **Org-Mode:** for markup + + - **Dired:** for working with sets of files + + - **Consult, Vertico, Orderless, Marginalia:** interactive search + + - **Magit:** Git revision control of my plain-text database + +### Quick overview of Hyperbole + + - **Core functionality:** a markup language for hyperlinks + + - Applications such as **HyRolo** and **Koutline** built on top of + this core functionality. + + - **HyRolo** is the feature I use as my Zettelkasten. + +### Configuration of Hyperbole using `use-package` + + ```emacs-lisp + (use-package hyperbole + :config + (setq hbmap:dir-user "~/.emacs.d/hyperb/") + (setq hyrolo-file-list '("~/.emacs.d/hyperb/ideas.org")) + (setq hyrolo-date-format "%Y-%m-%d %H:%M:%S")) + ``` + +### The Hyperbole Menu-Driven User Interface + + - Menus are a kind of modal user interface + + - Enter menu with Hyperbole leader key `{C-h h ...}` + + - Select menu items with key presses + + - Works a little like `which-key` + +### Getting started with **HyRolo**: Create a *zettel* + + - Add entry: `{C-h h r a}` "*hyperbole rolodex add*" + - Prompts you for a title for the entry + - The Zettelkasten file (e.g. ~idea.org~) is opened + - Write the body of the *zettel*, save the file. + +### Searching the *HyRolo* database + + - Multiple search options: by **string**, by **regex**, by **word**. + + - I use **string search** most often: `{C-h h r s}` + + - String search provides logical `AND`, `OR`, `XOR`, `NOT` + + - Executing a search opens the `*HyRolo*` buffer. + + - Read-only mode buffer with useful single-key navigation. + +### Searching the **HyRolo** database + + - **`{o}` as in "overview":** hides all but the headings + + - **`{a}` as in "all":** shows all information under each heading + + - **`{t}` as in "top":** shows top-level entries + + - **`{n}` and `{p}`:** next/previous result + + - **`{h}` and `{s}`:** hide/show a search result subheading + + - **`{C-u r}` as in "regex":** prompts for a new string search + + - **`{e}` or `{M-RET}` :** jump to that entry for editing, although + using this command inserts a new timestamp, I just use `{C-/}` + to undo insertion of the timestamp. + +### How is **HyRolo** a Zettelkasten? + + - **Key take-away:** The Hyperbole hyperlink markup language lets + you execute *arbitrary Emacs commands.* + + - To link Zettelkasten entries, create an hyperlinks that execute a + **HyRolo** search. + +### How to create an explicit link + + 1. Highlight text to be linked + + 2. `{C-h h e c}` to create a link + + 3. Prompted for link text with highlighted region (press enter) + + 4. Prompted for action: `hyrolo-fgrep` + + 5. Prompted for search string: `hyperbole` + +### How "explicit buttons" encode actions + + - A **separate file** from the HyRolo flat-file database. + + - By default, called `.hypb`, exists in the same directory as the + HyRolo flat-file database. + +### Conclusion + + 1. A Zettelkasten is database of ideas linked together + + 2. The Hyperbole **HyRolo** can run search queries + 3. The Hyperbole markdown creates links that execute queries + 4. This results in a minimal but useful Zettelkasten. [[!inline pages="internal(2022/info/rolodex-after)" raw="yes"]] -- cgit v1.2.3