GNU Hyperbole 9.0.1, the Rhapsody release, is now available on GNU ELPA.
And oh what a release it is: extensive new features, new video
demos, org and org roam integration, Markdown and Org file support in
HyRolo, recursive directory and wildcard file scanning in HyRolo, and
much more.
What's new in this release is extensively described here:
www.gnu.org/s/hyperbole/HY-NEWS.html
Everything back until release 8.0.0 is new since the last major release
announcement (almost a year and a half ago), so updates are extensive.
Hyperbole is like Markdown for hypertext. Hyperbole automatically
recognizes dozens of common patterns in any buffer regardless of mode
and transparently turns them into hyperbuttons you can instantly
activate 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.
But Hyperbole is also a personal information manager with built-in
capabilities of contact management/hierarchical record lookup,
legal-numbered outlines with hyperlinkable views and a unique window
and frame manager. It is even Org-compatible so you can use all of
Org's capabilities together with Hyperbole.
Hyperbole stays out of your way but is always a key press away when
you need it. Like Emacs, Org, Counsel and Helm, Hyperbole has many
different uses, all based around the theme of reducing cognitive load
and improving your everyday information management. It reduces
cognitive load by using a single Action Key, {M-RET}, across many
different contexts to perform the best default action in each.
Hyperbole has always been one of the best documented Emacs packages.
With Version 9 comes excellent test coverage: over 400 automated tests
are run with every update against every major version of Emacs since
version 27, to ensure quality. We hope you'll give it a try.
If you prefer video introductions, visit the videos linked to below;
otherwise, skip to the next section.
To install within GNU Emacs, use:
{M-x package-install RET hyperbole RET}
Hyperbole installs in less than a minute and can be uninstalled even
faster if ever need be. Give it a try.
Then to invoke its minibuffer menu, use:
{C-h h} or {M-x hyperbole RET}
The best way to get a feel for many of its capabilities is to invoke the
all new, interactive FAST-DEMO and explore sections of interest:
{C-h h d d}
To permanently activate Hyperbole in your Emacs initialization file, add
the line:
(hyperbole-mode 1)
Hyperbole is a minor mode that may be disabled at any time with:
{C-u 0 hyperbole-mode RET}
The Hyperbole home page with screenshots is here:
www.gnu.org/s/hyperbole
For use cases, see:
www.gnu.org/s/hyperbole/HY-WHY.html
For what users think about Hyperbole, see:
www.gnu.org/s/hyperbole/hyperbole.html#user-quotes
Enjoy,
The Hyperbole Team
The latest development version of Hyperbole can be installed directly from the GNU-devel ELPA Packages using built-in Emacs Package Manager.
The Elpa GNU-devel package repository provides a development version of Hyperbole. It pulls from the latest Hyperbole development branch to get the tip version and makes an installable package. This is done on a daily basis. Installing this does not require any new package manager software. Since Hyperbole is a mature package, this version is usually fine to use and is updated on a day-to-day basis. But new features are tested on this branch and once in awhile it may break for a short time before a fix is pushed.
To download and install this version of the Hyperbole, you should add the following lines to your personal Emacs initialization file, typically "~/.emacs". (For further details, see info page "(emacs)Init File", or Init-File).
(when (< emacs-major-version 27)
(error "Hyperbole requires Emacs 27 or above; you are running version %d" emacs-major-version))
(require 'package)
(add-to-list 'package-archives '("gnu-devel" . "https://elpa.gnu.org/devel/"))
(unless (package-installed-p 'hyperbole)
(package-refresh-contents)
(package-install 'hyperbole))
(hyperbole-mode 1)
Now save the file and restart Emacs. Hyperbole will then be downloaded and compiled for use with your version of Emacs; give it a minute or two. You may see a bunch of compilation warnings but these can be safely ignored.
========================================================================
========================================================================
GNU Hyperbole 8.0.0, the Epiphany release, is now available on GNU ELPA.
Hyperbole is a unique hypertextual information management Emacs package
that works across all Emacs modes, letting the computer do the hard work
while you benefit from its sophisticated context-sensitive linking and
navigation capabilities. Hyperbole has always been one of the best
documented Emacs packages. With Version 8 comes excellent test coverage:
over 200 automated tests to ensure quality. We hope you'll give it a try.
What's new in this release is described here:
www.gnu.org/s/hyperbole/HY-NEWS.html
Everything back until release 7.1.3 is new since the last major
release announcement (over a year ago), so updates are extensive.
If you prefer video introductions, visit the videos linked to below; otherwise,
skip to the next section.
GNU Hyperbole Videos
========================================================================
========================================================================
Hyperbole is like Markdown for hypertext. Hyperbole automatically
recognizes dozens of common 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 interlinks all your working information within Emacs for
fast access and editing, not just within special modes. Every button
is automatically assigned a type and new types can be developed for
your own buttons with simple function definitions. You can create
your own buttons by simply dragging between two buffers.
But Hyperbole is also a hub controller for your information supplying
built-in capabilities of contact management/hierarchical record
lookup, legal-numbered outlines with hyperlinkable views and a unique
window and frame manager. It is even Org-compatible so you can use
all of Org's capabilities together with Hyperbole.
Hyperbole is unique, powerful, extensively documented, and free. Like
Emacs, Org, Counsel and Helm, Hyperbole has many different uses all
based around the theme of reducing cognitive load and improving your
everyday information management. It reduces cognitive load by using
a single Action Key, {M-RET}, across many different contexts
which automatically chooses the best action
Then as you grow with it across time, it helps you build new capabilities
that continue to speed your work.
========================================================================
========================================================================
To install within GNU Emacs, use:
{M-x package-install RET hyperbole RET}
Hyperbole installs in less than a minute and can be uninstalled even
faster if ever need be. Give it a try.
Then to invoke its minibuffer menu, use:
{C-h h} or {M-x hyperbole RET}
The best way to get a feel for many of its capabilities is to invoke the
all new, interactive DEMO and explore sections of interest:
{C-h h d d}
To permanently activate Hyperbole in your Emacs initialization file, add
the line:
(hyperbole-mode 1)
Hyperbole is a minor mode that may be disabled at any time with:
{C-u 0 hyperbole-mode RET}
The Hyperbole home page with screenshots is here:
www.gnu.org/s/hyperbole
For use cases, see:
www.gnu.org/s/hyperbole/HY-WHY.html
For what users think about Hyperbole, see:
www.gnu.org/s/hyperbole/hyperbole.html#user-quotes
Enjoy,
The Hyperbole Team
What's new in this release is described here:
www.gnu.org/s/hyperbole/HY-NEWS.html
Everything back until release 7.0.3 is new since the last major
release announcement (about a year ago), so updates are extensive.
========================================================================
========================================================================
Hyperbole is like Markdown for hypertext. Hyperbole automatically
recognizes dozens of common 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 interlinks all your working information within Emacs for
fast access and editing, not just within special modes. Every button
is automatically assigned a type and new types can be developed for
your own buttons with simple function definitions. You can create
your own buttons by simply dragging between two buffers.
But Hyperbole is also a hub controller for your information supplying
built-in capabilities of contact management/hierarchical record
lookup, legal-numbered outlines with hyperlinkable views and a unique
window and frame manager. It is even Org-compatible so you can use
all of Org's capabilities together with Hyperbole.
Hyperbole is unique, powerful, extensively documented, and free. Like
Emacs, Org, Counsel and Helm, Hyperbole has many different uses all
based around the theme of reducing cognitive load and improving your
everyday information management. Then as you grow with it across
time, it helps you build new capabilities that continue to speed your
work.
========================================================================
========================================================================
To install:
{M-x package-install RET hyperbole RET} to install it.
It installs in about a minute and can be uninstalled even faster if
ever need be. Give it a try.
Then to invoke its menu:
{C-h h} or {M-x hyperbole RET}
The best way to get a feel for many of its capabilities is to
invoke the interactive DEMO and explore sections of interest:
{C-h h d d}
The Hyperbole home page with screen shots is here:
www.gnu.org/s/hyperbole
For use cases, see:
www.gnu.org/s/hyperbole/HY-WHY.html
For what users think about Hyperbole, see:
www.gnu.org/s/hyperbole/hyperbole.html#user-quotes
Enjoy,
The Hyperbole Team
Hyperbole is an amazing hypertextual information management system
that installs quickly and easily as an Emacs package. It is part of
GNU Elpa, the Emacs Lisp Package Archive.
Hyperbole interlinks all your working information within Emacs for
fast access and editing, not just within special modes. An hour
invested exploring Hyperbole's built-in interactive DEMO file will
save you hundreds of hours in your future work.
7.0.3 is a significant release with a number of interesting
improvements. What's new in this release is described here:
www.gnu.org/s/hyperbole/HY-NEWS.html
Hyperbole is described here:
www.gnu.org/s/hyperbole
For use cases, see:
www.gnu.org/s/hyperbole/HY-WHY.html
For what users think about Hyperbole, see:
https://www.gnu.org/s/hyperbole/hyperbole.html#user-quotes
Hyperbole can supplement and extend Org-mode's capabilities. It adds
many features not found elsewhere in Emacs, including Org mode, see:
www.emacswiki.org/emacs/Hyperbole
Hyperbole includes its own easy-to-use hypertextual buttons and links
that can be created without the need for any markup language.
Hyperbole has an interactive demo to introduce you to its features as
well as a detailed reference manual, as explained here:
https://www.gnu.org/s/hyperbole/hyperbole.html#invocation-and-doc
========================================================================
========================================================================
It contains:
- the most flexible and easy-to-use hyperbuttons available, including
implicit buttons automatically recognized by context, e.g. stack
trace source line references.
- the only Emacs outliner with full legal item numbering,
e.g. 1.4.2.6, and automatic permanent hyperlink anchors for every
item
- the only free-form contact manager with full-text search for Emacs
- rapid and precise window, frame and buffer placement on screen
- an extensive menu of typed web searches, e.g. dictionary, wikipedia
and stackoverflow, plus convenient, fast file and line finding
functions
- immediate execution of a series of key presses just by typing them
out. For example, a M-RETURN press on: {C-x C-b C-s scratch RET
C-a} will find the first buffer menu item that contains 'scratch';
then leave point at the beginning of its line. Build interactive
tutorials with this.
========================================================================
========================================================================
For near instant gratification, try Hyperbole's 'implicit button'
capabilities (hyper-buttons that Hyperbole gives you for free by
recognizing all types of references embedded within text such as
pathnames or error message lines). Below are more complex examples to
show the power; simpler ones can be found within the Hyperbole DEMO
file.
Implicit buttons are activated by pressing the Action Key, M-RETURN.
Once Hyperbole is loaded in your Emacs, pressing M-RETURN on any of
these examples in virtually any buffer will display the associated
referent in a chosen window or frame, handling all variable
substitution and full path resolution:
"find-func.el" Find this file whether gzipped or not
in the Emacs Lisp load-path
"${hyperb:dir}/HY-NEWS" Resolve variable, show Hyperbole news
"${PATH}/umask" Display a script somewhere in multi-dir PATH
"${hyperb:dir}/DEMO#Hyperbole Menus" Org mode outline, Markdown, and HTML # refs
"(hyperbole)Menus" Texinfo and Info node links
"c:/Users", "c:\Users", "/C/Users", "/c/Users", and "/mnt/c/Users"
On Windows and Windows Subsystem for Linux,
Hyperbole recognizes all of these as the
same path and can translate between Windows
and POSIX path formats in both directions
Git Links:
git#branches List branches in current repo/project
git#commits List and browse commits for current project
git#tags List tags in current project
git#/hyperbole From any buffer, dired on the top
directory of the local hyperbole
project
git#/hyperbole/55a1f0 or From any buffer, display hyperbole
git#hyperbole/55a1f0 local git commit diff
Github Links:
gh@rswgnu Display user's home page & projects
github#rswgnu/hyperbole Display user's project
gh#rswgnu/helm/global_mouse Display user project's branch
gh#rswgnu/hyperbole/55a1f0 Display user project's commit diff
Gitlab Links:
gitlab@seriyalexandrov Display user's home page
gl#gitlab-org/gitlab-ce/activity Summarize user's project activity
gl#gitlab-org/gitlab-ce/analytics Display user project's cycle_analytics
gl#gitlab-org/gitlab-ce/boards Display user project's kanban-type issue boards
Once you set the default user and project variables, you can leave them off any reference links:
(setq hibtypes-gitlab-default-user "gitlab-org")
(setq hibtypes-gitlab-default-project "gitlab-ce")
gl#issues or gl#list Display default project's issue list
gl#labels Display default project's issue categories
gl#members Display default project's staff list
gl#contributors Show contributor push frequency charts
gl#merge_requests or gl#pulls Display default project's pull requests
gl#milestones Display default project's milestones status
gl#pages Display default project's web pages
gl#snippets Project snippets, diffs and text with discussion
gl#groups List all available groups of projects
gl#projects List all available projects
gl#milestone=38 Show a specific project milestone
gl#snippet/1689487 Show a specific project snippet
Even useful social media links:
tw#travel or twitter#travel Display twitter hashtag matches
fb#technology Display facebook hashtag matches
Hyperbole uses simple prefix characters with paths to make them executable:
"!/bin/date" Execute as a non-windowed program within a shell
"&/opt/X11/bin/xeyes" Execute as a windowed program;
"-find-func.el" Load/execute this Emacs Lisp library
File "/usr/lib/python3.7/ast.py", line 37, in parse
Jump to error/stack trace source
"/ftp:anonymous@ftp.gnu.org:" Tramp remote paths
This is the main public release of GNU Hyperbole for 2017 and it is
bursting with new features and further quality improvements. New
capabilities, including Git and Github object links, are summarized
here:
https://git.savannah.gnu.org/cgit/hyperbole.git/plain/HY-NEWS
A short explanation of Hyperbole is included below. For more
detail or how to obtain and install it, see:
https://www.gnu.org/s/hyperbole
For a list of use cases, see:
https://www.gnu.org/s/hyperbole/HY-WHY.html
For what users think about Hyperbole, see:
https://www.gnu.org/s/hyperbole/hyperbole.html#user-quotes
For information on what GNU Hyperbole is, screenshots, download and
installation instructions, see the GNU Hyperbole home page:
https://www.gnu.org/software/hyperbole
The Hyperbole wiki page:
https://www.emacswiki.org/emacs/Hyperbole
explains the many ways it differs from and is complementary to Org mode.
Hyperbole includes an interactive demo to introduce you to its features and a
detailed reference manual.
========================================================
What's New in GNU Hyperbole V6.0.2
========================================================
BUTTONS
- pathname Implicit Button Type: generalized to handle hash-style links to
HTML files, to Github Markdown # sections and to Emacs outline *
sections. So an Action Key press on any of the following links displays
the link referent:
"man/hyperbole.html#Questions-and-Answers"
"README.md#why-was-hyperbole-developed"
"DEMO#HTML Markdown and Emacs Outline Hash Links"
Even links split across 2 lines like this now work: "DEMO#Social Media
Hashtags and Usernames", as long as point is on the first line.
Within HTML and Markdown files, in-file hash links without any file name
prefix work as well.
HTML hash-links are case-sensitive; other hash-links are not. Hash links
typically use dashes in place of the spaces that referents may contain,
but if the link is enclosed in quotes, Hyperbole allows spaces to be used
as well. In fact, it is best practice to always enclose hash-style links
in quotes so Hyperbole can distinguish them from other similar looking
constructs, such as social media hashtags (see "(hyperbole)Social Media").
Pathnames surrounded by literal non-ASCII quote marks now work as well.
For example, ‘http://ftp.gnu.org/gnu/hyperbole/’.
- New Implicit Button Type, markdown-internal-link, displays any in-file
Markdown link referent, aside from pathnames and urls. Together with
other types, all Markdown links can now be followed by the Action Key.
- social-reference Implicit Button Type: Disabled this type within quoted
strings (all modes) and within parentheses (markdown-mode), so in-file
hash link references are not matched as social hash tags. Made the list
of modes a variable, hibtypes-social-inhibit-modes.
- New link-to-web-search Action Type: Allows global and explicit buttons
to link to specific web term searches from `hyperbole-web-search-alist'.
- org-mode Implicit Button Type: Improved to invoke org-meta-return when
not on an Org link or outline heading.
DOCUMENTATION
- Added pointer to HyControl video and {C-c \} binding which invokes
HyControl window control.
- README File: New Org-mode user testimonial.
- DEMO File: Added description and exercise using the new Find/Web menu.
- Added README.md.html introduction with images combining README, INSTALL
and HY-ABOUT information.
- Full set of hand-written changes are now in the file "Changes". The
former name, ChangeLog, is now auto-generated from the version controlled
'git log' but not as complete.
KEYS
- New variables, action-key-eol-function and assist-key-eol-function, used
to control what the Action and Assist Keys do at the end of a line.
Default behaviors remain as before but now one can set these to do
something other than scrolling, if desired. See "(hyperbole)Smart Key -
Smart Scrolling"
- When in HyControl, pressing {ESC} now quits in addition to {q}.
MENUS
- New submenu, Find/Web, for quick access to major web search engines.
The Find/Web menu looks like this:
Web> Amazon Bing Dictionary Elisp Facebook Google Hub(git) Images Maps RFCs StackOverflow Twitter Wikipedia Youtube
Hyperbole binds the key {C-c /} for quick access to this menu, if it is
not already bound prior to Hyperbole's initialization. The
Cust/Web-Search menu, {C-h h c w}, sets the option,
hyperbole-web-search-browser-function, which determines whether web
search results are displayed within Emacs or with an external web
browser. A short video introduction to the Find/Web menu may be found at
https://youtu.be/8lMlJed0-OM.
Advanced users can change the search engines listed in the Find/Web menu
with M-x customize-variable RET hyperbole-web-search-alist RET. Changes
are automatically reflected in the Hyperbole menus once applied.
Remember each search engine name must begin with a unique letter and each
URL must have a %s format field indicating where to place the web search
term when a search is performed. See "(hyperbole)Web Search Engines".
-- The End --
GNU Hyperbole (pronounced Ga-new Hi-per-bo-lee), or just Hyperbole, is an amazing programmable hypertextual information management system implemented as a GNU Emacs package. This is the first public release in 2016. Hyperbole has been greatly expanded and modernized for use with the latest Emacs 25 releases; it supports GNU Emacs 24.4 or above. It contains an extensive set of improvements that can greatly boost your day-to-day productivity with Emacs and your ability to manage information stored across many different machines on the internet. People who get used to Hyperbole find it helps them so much that they prefer never to use Emacs without it.
http://git.savannah.gnu.org/cgit/hyperbole.git/tree/HY-ABOUT describes Hyperbole.
http://git.savannah.gnu.org/cgit/hyperbole.git/tree/INSTALL explains how to download and install Hyperbole.
http://git.savannah.gnu.org/cgit/hyperbole.git/tree/README provides guidance for the Hyperbole distribution.