[elpa] externals/hyperbole 2173bf7e09 002/143: Add new HYPERAMP.org talk slides and update talks in HY-TALK

[ELPA Syncer]

branch: externals/hyperbole
commit 2173bf7e096bc9e20e74eebcdcc78e2730e265f8
Author: bw <rsw@gnu.org>
Commit: bw <rsw@gnu.org>

    Add new HYPERAMP.org talk slides and update talks in HY-TALK
---
 HY-TALK/.hypb                                      |   5 +-
 HY-TALK/HYPERAMP.org                               | 177 +++++++++++++++++++++
 .../{Hyperbole-and-Org-Mode.org => HYPERORG.org}   |   0
 MANIFEST                                           |   3 +
 4 files changed, 184 insertions(+), 1 deletion(-)

diff --git a/HY-TALK/.hypb b/HY-TALK/.hypb
index 044b0667ee..ed8c113b39 100644
--- a/HY-TALK/.hypb
+++ b/HY-TALK/.hypb
@@ -1,5 +1,8 @@
 
-"Hyperbole-and-Org-Mode.org"
+"HYPERAMP.org"
+("ERT_test" nil nil link-to-file 
("../test/hbut-tests.el#hypb:program-create-ebut-in-buffer") "rsw@gnu.org" 
"20231203:01:48:10" nil nil)
+
+"HYPERORG.org"
 ("Bring_Your_Text_to_Life" nil nil life (1) "rsw@gnu.org" "20221204:08:36:54" 
nil nil)
 
 "HY-TALK.org"
diff --git a/HY-TALK/HYPERAMP.org b/HY-TALK/HYPERAMP.org
new file mode 100644
index 0000000000..fb73e7915c
--- /dev/null
+++ b/HY-TALK/HYPERAMP.org
@@ -0,0 +1,177 @@
+-*- Mode: org; org-cycle-global-at-bob: t; hsys-org-enable-smart-keys: t -*-
+
+#+TITLE:  Top 10 Ways Hyperbole Amps Up Emacs
+#+AUTHOR:  Robert Weiner <rsw@gnu.org>
+
+`GNU Hyperbole' (pronounced Ga-new Hi-per-bo-lee), or just `Hyperbole', is
+like Markdown for hypertext.  Hyperbole automatically recognizes dozens of
+common, pre-existing 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.
+
+Install Hyperbole:  (progn (add-to-list 'package-archives
+                                        '("elpa-devel" . 
"https://elpa.gnu.org/devel/";))
+                           (package-install 'hyperbole))
+
+Activate Hyperbole: {C-h h} - displays minibuffer menu
+Reference Manual:   "(hyperbole)Top"
+
+Hyperbole Demo:     {C-h h d d} - interactive demo/tutorial as introduction
+
+Display Keys:       <keycast-log-mode 1>
+Hide Keys:          <keycast-log-mode 0>
+Erase Key Log:      <keycast-log-erase-buffer>
+
+Let's countdown the top 10 ways Hyperbole can help you.  We'll move
+fast as we have a lot to cover in a short time.  We'll answer
+questions after the talk.
+
+* 10. Key Series - in-buffer automation for everything
+
+**    Key series are curly brace, {}, delimited hyperbuttons that are an
+      in-buffer substitute for keyboard macros.
+
+      Place them in any file (in comment lines for programming files).
+
+      Then press {M-RET} within one to activate it.
+
+      {M-x shell RET M-> (export HYPERBOLE_DIR=${hyperb:dir} && 
+       cd $HYPERBOLE_DIR && grep -n gbut:label-list *.el) RET}
+
+       Use both a Hyperbole resolved variable, ${hyperb:dir}, and a
+       shell-resolved environment variable, $HYPERBOLE_DIR, to grep through
+       Lisp files.
+
+      {C-h h h} will restore your windows after invoking the above key series.
+
+**    FYI, Hyperbole offers a simpler way to recursively grep your current 
directory
+      for just Elisp files.  Use 'hypb:rgrep' when in an Elisp buffer and it 
will
+      match to only Elisp files.
+
+        {C-x 1 C-x 3 C-x o C-x C-f hibtypes.el RET C-x o C-n C-n}
+
+        {C-x o M-x hypb:rgrep RET gbut:label-list RET C-x o C-x 1 C-x 3 C-x b 
HYPERAMP RET}
+
+*  9. Existing pathnames with Environment or Lisp variables are hyperbuttons 
too
+
+      ${PATH}/rgrep
+
+      "${hyperb:dir}/README.md#Programmer Quick Reference:5:5"
+      "${hyperb:dir}/README.md#programmer-quick-reference:4:2"
+
+      ~/.bashrc#Alias
+
+      "${hyperb:dir}/kotl/EXAMPLE.kotl#3c"
+      "${hyperb:dir}/kotl/EXAMPLE.kotl#3c|c2ben"
+
+*  8. File prefixes for special handling
+
+      "-subr"                                     - load an Elisp library
+
+      "!${PATH}/date"                             - execute 'date' shell 
command
+
+      "&xdg-open ${hyperb:dir}/man/hyperbole.pdf" - run a graphical PDF viewer
+
+*  7. Bookmarks on Steroids
+
+      {C-x 2 C-x o C-h h b p} - Your personal home page of buttons and 
bookmarks
+
+      {C-h h g a} - Activate by name
+
+*  6. Instant test case running and debugging
+
+      {M-RET} on the first line of an <(ERT test)> runs it.
+
+      {C-u M-RET} steps through it with the edebugger.
+
+*  5. Instant 2-window typed hyperlink creation
+
+      Place 2 windows on screen; place point where you want to link to in one
+      window and then move to the window where you want the hyperlink placed.
+
+      {C-h h i l} will create a typed implicit link at point.
+      {C-h h e l} will create an explicit link instead.
+      {C-h h g l} will create a global named implicit link that works like a 
bookmark.
+
+*  4. Koutliner - Instant collapsible outlines on the web
+
+      {C-x 1 C-x 2}
+      {C-h h k e}
+
+      {C-x o C-h h k} - Koutliner menu
+
+      {f d} - Format menu, then display in browser
+
+*  3. HyControl - Zoom font size across all faces, windows and frames at once
+
+      {C-x 1 C-x 3 M-x list-faces-display RET C-x o}
+
+      {C-h h s f}  - {z} zoom out all frames; {Z} zoom in all frames
+
+      {C-h h s w}  - {z} zoom out all frames; {Z} zoom in all frames
+
+*  2. HyRolo - Simple, fast, flexible hierarchical record management
+
+** Search across Org, Emacs outline, Markdown and Koutline files and multiple 
dirs
+
+      <setq hyrolo-file-list '("${hyperb:dir}/DEMO-ROLO.otl" "~/org"
+                               "${hyperb:dir}/README.md" 
"${hyperb:dir}/kotl/*.kotl")>
+
+      {C-h h r s button RET}
+
+** Dynamic line-level filtering with Consult
+
+      {C-x 1 C-x 3 C-x o}
+
+      <hyrolo-consult-grep "button">
+
+*  1. Custom Implicit Button Types - solve your own problems
+
+  
+** defal - Create new button types with no programming knowledge
+
+      (defal ddg "https://duckduckgo.com/?q=\"%s\"";)
+
+      <ddg "emacs news">
+
+** defil - Control the way your link buttons look
+
+      Here is a sample use case.  Create a button type whose buttons
+      perform a grep-like function over a current repository’s git
+      log entries.  The buttons use this format: [<text to match>].
+
+      The following defines the button type called search-git-log which
+      calls hypb:fgrep-git-log with the text of the button as an argument:
+      
+        (defil search-git-log "[<" ">]" ".*" #'hypb:fgrep-git-log)
+
+        [<test release>]
+
+** defib - Use full Emacs Lisp to define button types (see "hibtypes.el")
+
+      (progn
+       (require 'thingatpt)
+       (defib dow ()
+         "Display a message with DATE's (YYYY-MM-DD) day of the week."
+         (let ((date (thing-at-point 'sexp)))
+           (when (and (stringp date)
+                      (string-match-p "[0-9]\\{4\\}-[0-9]\\{2\\}-[0-9]\\{2\\}"
+                                      date))
+             (cl-destructuring-bind (_ignore _ignore _ignore day month year 
_ignore _ignore _ignore) (parse-time-string date)
+               (hact #'message "%s falls on %s" date
+                     (calendar-day-name (list month day year))))))))
+
+      2023-12-03
+      2023-12-05
+
+* Thanks
+
+      - To my co-maintainer Mats Lidell
+
+      - To all the hard-working volunteers and speakers at EmacsConf
+
+-- The End --
+
diff --git a/HY-TALK/Hyperbole-and-Org-Mode.org b/HY-TALK/HYPERORG.org
similarity index 100%
rename from HY-TALK/Hyperbole-and-Org-Mode.org
rename to HY-TALK/HYPERORG.org
diff --git a/MANIFEST b/MANIFEST
index 218c47f55c..071a9be605 100644
--- a/MANIFEST
+++ b/MANIFEST
@@ -26,6 +26,9 @@ man/hyperbole.info   - The GNU Hyperbole Manual  (GNU Info 
version)
 man/hyperbole.pdf    - The GNU Hyperbole Manual  (printable version)
 man/hyperbole.texi   - The GNU Hyperbole Manual  (GNU Texinfo source form)
 man/hkey-help.txt    - Summarizes Smart Key behaviors in different contexts
+HY-TALK/HY-TALK.org  - EmacsNYC Talk: Make Your Text Come Alive
+HY-TALK/HYPERAMP.org - EmacsConf 2023 Talk: Top 10 Ways Hyperbole Amps Up Emacs
+HY-TALK/HYPERORG.org - EmacsConf 2022 Talk: Powerful Productivity with 
Hyperbole and Org Mode
 
 * --- USER INTERFACE ---
 hmouse-info.el       - Walks through Info networks using one key