Hyperbole is a broad information management framework that augments your favorite Emacs libraries like Org and Consult. It can accelerate the things you do everyday with Emacs, just give it a chance. It installs in about 60 seconds. Learn about it from:
- Hyperbole Manual
- Hyperbole Articles
- Hyperbole Videos
Hyperbole version 9.3.2 is another jump in capability with Org visibility cycling added to the Koutliner and the ability to use the double brackets of Org link format around Hyperbole implicit buttons in Org mode.
Below are major updates since release 9.1.0:
\* The Koutliner - legal-style outliner with permalinks and hidden properties
** Org-style Visibility Cycling
New, extensive key compatibility with Org-mode; major Org keys work similarly. {TAB} and {S-TAB} (previously {M-TAB}) keys cycle trees and entire outline visibility anywhere in a cell, by default. Use {C-c [} to toggle these keys between cycling and tree demotion/promotion, as desired. Bindings of {C-c C->} or {M-right} and {C-c C-<} or {M-left} for tree demotion/promotion always work regardless of the tab mode.
The Koutliner has the same kind of extensive user-customizations of tab behavior as Org mode.
** Inline Image Display
{C-c C-x C-v} toggles the inline display of image files in Koutlines, just like Org mode.
** Free Up User-customizable {C-c <letter>} Keys
Previously, the Koutliner bound a number of these keys for convenience. Now they are all replaced with {C-c ; <letter>} so global user set {C-c <letter>} keys are available. If you don't use such global keys, {M-1 C-c C-l} will enable the original Koutliner
{C-c <letter>} key bindings while leaving the {C-c ; <letter>} keys in place as well.
** kotl-mode:action-key-default-function
This new setting holds a function run by the Action Key in Koutline mode (kotl-mode) when no other context matches. The default setting does nothing within cells, whereas previously, it would toggle between showing and hiding the tree (this is now done with {TAB}).
Set this to `kotl-mode:show-or-hide-tree' to restore the old Koutliner behavior.
** kotl-mode:assist-key-default-function
This similar setting is for the Assist Key in Koutline mode when no other context matches. The default setting does nothing within cells whereas previously it would run `smart-scroll-down' to scroll down a screenful.
Set the variable to that command if you prefer the prior behavior.
** Improve copy-tree Mnemonics
- {C-c ; b} `kotl-mode:toggle-blank-lines' has moved to {C-c ]}.
- {C-c C-c} `kotl-mode:copy-before' has moved to {C-c ; b} to match with {C-c ; c} `kotl-mode:copy-after' binding.
\* Hyperbole Org Mode Support
** Hyperbole Buttons as Org Links
Hyperbole buttons wrapped in double square bracket org link delimiters when in Org mode will activate properly with the addition of a single line to your Hyperbole `use-package' configuration:
(push #'hyperbole-activate-button org-open-link-functions)
Then you get all the Hyperbole button capabilities with the highlighting and the activation of Org links via {C-c C-o}. Of course, the Action Key will activate these buttons as well.
Since Emacs Lisp symbols are Hyperbole buttons, you can make links to both function and variable definitons just by wrapping their names in Org delimiters. For example, [[find-file]] or [[hsys-org-enable-smart-keys]].
** Org Heading Smart Key Settings
Two new settings to control Action and Assist Key behavior when within an Org mode heading when `hsys-org-enable-smart-keys' is set to t (defaults are no-ops):
`smart-org-action-key-heading-function' and `smart-org-assist-key-heading-function'.
The new `smart-org-cycle' command is one option for such a setting.
\* HyWiki - the no markup, personal Wiki note taker
** HyWikiWord#Headline Links to Indented Headlines
HyWikiWord#Headline links now work in Wiki pages that use indentation before the * delimiters of headlines.
** Disable Action Key HyWikiWord Creation
You can now customize which modes prevent HyWikiWord creation with the Action Key {M-RET} Add any text or programming major modes to
`hywiki-word-create-exclude-action-key-modes' to disable this feature in these modes. You can bypass this setting by creating a HyWikiWord via the keyboard menus with {C-h h h c}.
** Orderless Matching in Searches
When using the `orderless' package in searches, multiple space-separated words are matched in any order they occur, regardless of the order given to the search.
\* HyRolo - the fast, hierarchical record retriever
** Yank Entire Record Trees
By default, {C-h h r y} `hyrolo-yank' yanks at point the entry matched without any of its sub-entries. Use {C-u C-h h r y} to yank in the entire tree.
** Orderless Matching in Searches
When using the `orderless' package in searches, multiple space-separated words are matched in any order they occur, regardless of the order given to the search.
* Documentation
** "FAST-DEMO" {C-h h d d} now includes links to articles about
Hyperbole, including two new articles and videos:
HyRolo: Records are Trees, Not Lines - https://youtu.be/5Oo_KqVcLFM
Implicit Buttons: Build Your Hyperverse - https://youtu.be/o2KMvSCXwlU
\* Installation
** New Install Documentation
Installation sections in the Hyperbole Manual and "README.md" have been extensively rewritten. Installation now utilizes `use-package' with a fully documented reference `man/use-package' configuration file you can easily customize. The file, "INSTALL", has been deleted.
** Key Use-Package Settings
Some key configuration settings in the "man/use-package" file:
- `iimage-mode' setting that permanently enables inline image display in Koutline buffers.
- `hyrolo-file-list' setting that shows all of the note taking systems that can be quickly full-text searched with HyRolo with no indexing.
- The new `hywiki-word-create-exclude-action-key-modes' list lets you exclude certain major-modes from having the Action Key create new HyWiki words when pressed on any capitalized word.
- A one line setting of `org-open-link-functions' enables highlighting Hyperbole buttons as Org links when wrapped in double square brackets. Now you can make all your Hyperbole buttons operate like Org links if desired.
* Further Details
See HY-NEWS.html for detailed changes in the Version 9 Hyperbole series.
-- The End --