rswgnu / hyperbole

GNU Hyperbole 9.0.2pre - The Everyday Hypertextual Information Manager If you are looking for the documentation for the stable release look [here.] We work on Hyperbole as a gift to the Emacs community and request you send us a thank you or a testimonial describing your usage if you like Hyperbole to [rsw@gnu.org]. [TOC] Reference Manual Hyperbole has many features you can explore interactively or by reading sections of the reference manual: • Browse Hyperbole Web Manual • In Emacs, Browse Hyperbole Info Manual • Display or Print PDF Manual Videos If you prefer video introductions, visit the videos linked to below; otherwise, skip to the next section. • Overview and Demo Long video that covers most of Hyperbole; Hyperlink timestamps to watch each section • Quick Introduction • Top 10 ways Hyperbole amps up Emacs • Introduction to Buttons • Linking Personal Info with Implicit Buttons • Powerful Productivity with Hyperbole and Org Mode • HyRolo, fast contact/hierarchical record viewer • Using Koutline for stream of thought journaling • Build a Zettelkasten with HyRolo • HyControl, fast Emacs frame and window manager • Writing test cases for GNU Hyperbole • Find/Web Search • Linking personal info with implicit buttons Articles • The Emacs Hyperbole • HyWiki: My Favorite Part of Hyperbole • Hyperbole VisionQuest Part 1 • Hyperbole VisionQuest Part 2 • A Taste of Hyperbole • My Understanding of GNU Hyperbole • What does GNU Hyperbole do? • John Wiegley - The Philosophy Behind Hyperbole • Daily ways GNU Hyperbole helps me stay in flow and reduces cognitive load • Doing a Research Project and using GNU Hyperbole's Integrated Features • AI-generated Hyperbole Architectural Documentation • Hypermedia and Hyperbole Summary (pronounced Ga-new Hi-per-bo-lee), or just , is like Markdown for hypertext. Hyperbole automatically recognizes dozens of common, pre-existing patterns in any buffer regardless of mode and can instantly activate them as hyperbuttons with a single key: email addresses, URLs, grep -n outputs, programming backtraces, sequences of Emacs keys, programming identifiers, Texinfo and Info cross-references, Org links, Markdown links and on and on. All you do is load Hyperbole and then your text comes to life with no extra effort or complex formatting. Hyperbole includes easy-to-use, powerful hypertextual button types without the need to learn a markup language. Hyperbole's button types are written in Lisp and can be wholly independent of the web, i.e. web links are one type of Hyperbole link, not fundamental to its link architecture. However, Hyperbole is a great assistant when editing HTML or Javascript or when browsing web pages and links. Hyperbole comes pre-built with most of the implicit button types you will need but with a little extra effort and a few lines of code (or even just a few words), you can define your own implicit button types to recognize your specific buttons and then activate them anywhere in Emacs. You press a single key, {M-RET} by default, on any kind of Hyperbole button to activate it, so you can rely on your muscle memory and let the computer do the hard work of figuring out what to do. {C-u M-RET} shows you what any button will do in any context before you activate it, so you can always be sure of what you are doing when needed or if some emails you a button (you can do that too). Hyperbole is something to be experienced and interacted with, not understood from reading alone. It installs normally as a single Emacs package with no dependencies outside of standard Emacs libraries. Most of Hyperbole is a single global minor mode that you can activate and deactivate at will. And it can be uninstalled quickly as well if need be, so there is no risk to giving it a spin. Once you have it installed and activated {C-u M-x hyperbole-mode RET}, try the interactive demo with {C-h h d d}. In fact, if you have Hyperbole loaded, you can press {M-RET} inside any of the brace delimited series of keys you see in this document and it will execute them on-the-fly (easy keyboard-macro style buttons in any text). Hyperbole can dramatically increase your productivity and greatly reduce the number of keyboard/mouse keys you'll need to work efficiently. In short, Hyperbole lets you: • Quickly create hyperlink buttons either from the keyboard or by dragging between a source and destination window with a mouse button depressed. Later, activate buttons by pressing/clicking on them or by giving the name of the button. • Activate many kinds of recognized by context within text buffers, e.g. URLs, grep output lines, and git commits. A single key or mouse button automatically does the right thing in dozens of contexts; just press and go. • Build outlines with multi-level numbered outline nodes, e.g. 1.4.8.6, that all renumber automatically as any node or tree is moved in the outline. Each node also has a permanent hyperlink anchor that you can reference from any other node; • Manage all your contacts or record-based, unstructured nodes quickly with hierarchical categories; each entry can have embedded hyperbuttons of any type. Or create an archive of documents with hierarchical entries and use the same search mechanism to quickly find any matching entry; • Use single keys to easily manage your Emacs windows or frames and quickly retrieve saved window and frame configurations; • Search for things in your current buffers, in a directory tree or across major web search engines with the touch of a few keys. The common thread in all these features is making retrieval, management and display of information fast and easy. That is Hyperbole's purpose. It may be broad but it works amazingly well. If it is textual information, Hyperbole can work with it. In contrast to Org mode, Hyperbole works across all Emacs modes and speeds your work by turning all kinds of references into clickable hyperlinks and allowing you to create new hyperlinks by dragging between two wi…