1) Short summery to get your mental model right to understand
Hyperbole and the rest of the summery and documentation
Hyperbole is PKM "personal knowledge management" system that uses the
computer in a holistic seance to help you manage your life. Hyperbole
is like and improves upon emacs by being a toolbox, while being
installed optionally on another toolbox <<linux/bsd|or (*)nix>> to
help you accomplish this goal. As such it is best to play around in
some of the example files <<hyperbutton for exapmle file>> and use the
features piece by piece as you learn them. If you try to learn all of
Hyperbole "or Emacs for that matter" all at ounce you are gonna have a
rough time.
2) Hyperbole summery points
Using specific examples in conjunction with descriptions should make
the description more clear and shorter
1) Implicit buttons -- These help you with links you find in the wild
"Created by or for consumption of people not using Hyperbole" such as
1) r...@gnu.org -- an email address to open in your mail client
optionally Emacs
2) https://www.gnu.org/software/hyperbole/ -- a website to open in
your browser
3) ~/.emacs.d/init.el -- a file to open up inside of emacs
4) etc
2) Explicit buttons -- These push the state of the art of what a
button or link means while still being written in plain text.
1) {C-x C-b C-x C-q M-x keep-lines RET [\\/]$ RET C-x C-q} --
Buffer list of directory buffers only
2) <kotl/EXAMPLE.kotl, 3b10 |c2en> --Display a Hyperbole Koutline
starting from cell 3b10 with lines per cell clipped to 2.
3) Showing a Kotl file with a condensed view-- can probably replace 2
4) an example using your hyperbutton file with description talking
about how you reduce information on a file and where the button file
is stored so it is magical in a good way and not in a bad way
3) misc
1) r...@gnu.org you should expound upon your emacs lisp file
outline collapsed view in some way, either showing it in a video, blog
post, or worked into Hyperbole somehow
2) Things I didn't know about hyperbole that I learned, maybe
could be documented better?
1) That the Koutline export to html is really nice by using
pure html, utilizing multiple colors, and having collapsible sections
1) Have a Black and White theme
1)
https://protesilaos.com/codelog/2021-02-22-modus-themes-exporter/
could be used to help make a theme
2) fore browsers supporting operating systmes themes
https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-color-scheme
3) You could have an example Koutline exported html file hosted
somewhere on https://www.gnu.org/software/hyperbole/
4) Could you reuse some of the Kotl buttons by turning them into
html anchors to jump to?
2) The moving of the Koutline cells like you do in org mode is
a nice improvement:) that will make the package more frictionless and
pleasant to use :)
w
