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: "
www.gnu.org/s/hyperbole/man/hyperbole.html#Hyperbole-Overview-1".
- Hyperbole Articles: "
www.gnu.org/s/hyperbole/man/hyperbole.html#Articles"
- Hyperbole Videos: "www.gnu.org/s/hyperbole/man/hyperbole.html#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
See "www.gnu.org/s/hyperbole/man/hyperbole.html#Koutliner"
** 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.
See "www.gnu.org/s/hyperbole/man/hyperbole.html#TAB-and-Shift_002dTAB"
for details on how these keys work and can be customized.
** 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
See "www.gnu.org/s/hyperbole/man/hyperbole.html#Smart-Key-_002d-Org-Mode"
** 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 sybmols 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
See "www.gnu.org/s/hyperbole/man/hyperbole.html#HyWiki".
** 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
See "www.gnu.org/s/hyperbole/man/hyperbole.html#HyRolo".
** 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
See "www.gnu.org/s/hyperbole/man/hyperbole.html#Install".
** 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 "www.gnu.org/s/hyperbole/HY-NEWS.html" for detailed changes in the
Version 9 Hyperbole series.
-- The End --
