Re: Short summery to get your mental model right

[Robert Weiner]

Hi Matthew:

Thanks for the feedback and ideas.  Give us some time to process this and we’ll 
respond.  In the mean time, please read some more on explicit buttons as a 
bunch of the examples you gave are types of implicit buttons.  Should be 
clearer when you read that manual section.

Regards,

-- Bob

> On Jan 15, 2023, at 3:56 PM, mattplasmastrike@gmail.com wrote:
> 
> 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) rsw@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) rsw@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
>