Function: hywiki-mode

hywiki-mode is an autoloaded, interactive and byte-compiled function defined in hywiki.el.

Signature

(hywiki-mode &optional ARG)

Documentation

Toggle HyWiki global minor mode with M-x hywiki-mode (hywiki-mode).

HyWiki minor mode automatically highlights and turns HyWikiWord references into Hyperbole implicit buttons that either link to HyWiki pages or activate typed referents such as bookmarks.

HyWiki minor mode has three states as tracked by the hywiki-mode(var)/hywiki-mode(fun) variable, with the default state when interactively enabled set by the value of hywiki-default-mode:

  - :pages - highlight HyWikiWords in HyWiki pages only (Org files in
             hywiki-directory); also enable hyperbole-mode(var)/hyperbole-mode(fun) minor mode
             if off.

  - :all - highlight HyWikiWords in all editable buffers except those
             with a major mode in hypb:exclude-major-modes; also
             enable hyperbole-mode(var)/hyperbole-mode(fun) minor mode if off.

  - nil - no highlighting, the hywiki-mode(var)/hywiki-mode(fun) is disabled.

HyWikiWord references may also include optional suffixes:

  - a #section reference that links to a HyWiki page Org headline or
    other outline file. Spaces in the headline must be converted
    to dash characters for proper recognition;

  - optionally followed by :L<line-number>:C<column-number>
    where the column part is also optional. If a section is
    given, the line number is relative to the section and the
    section headline is line 1.

See the Info documentation at "(hyperbole)HyWiki".

Keymap hywiki-mode-map is not currently defined.

This is a global minor mode. If called interactively, toggle the Hywiki mode mode. If the prefix argument is positive, enable the mode, and if it is zero or negative, disable the mode.

If called from Lisp, toggle the mode if ARG is toggle. Enable the mode if ARG is nil, omitted, or is a positive number. Disable the mode if ARG is a negative number.

To check whether the minor mode is enabled in the current buffer, evaluate the variable hywiki-mode(var)/hywiki-mode(fun).

The mode's hook is called both when the mode is enabled and when it is disabled.

This function has :around advice: hywiki-mode-around-advice.

Key Bindings

Source Code

;; Defined in ~/.emacs.d/elpa/hyperbole-20260822.1645/hywiki.el
;;;###autoload
(define-minor-mode hywiki-mode
  "Toggle HyWiki global minor mode with \\[hywiki-mode].
HyWiki minor mode automatically highlights and turns HyWikiWord references
into Hyperbole implicit buttons that either link to HyWiki pages or activate
typed referents such as bookmarks.

HyWiki minor mode has three states as tracked by the `hywiki-mode' variable,
with the default state when interactively enabled set by the value of
`hywiki-default-mode':

  - :pages - highlight HyWikiWords in HyWiki pages only (Org files in
             `hywiki-directory'); also enable `hyperbole-mode' minor mode
             if off.

  - :all   - highlight HyWikiWords in all editable buffers except those
             with a major mode in `hypb:exclude-major-modes'; also
             enable `hyperbole-mode' minor mode if off.

  - nil    - no highlighting, the `hywiki-mode' is disabled.

HyWikiWord references may also include optional suffixes:

  - a #section reference that links to a HyWiki page Org headline or
    other outline file.  Spaces in the headline must be converted
    to dash characters for proper recognition;

  - optionally followed by :L<line-number>:C<column-number>
    where the column part is also optional.  If a section is
    given, the line number is relative to the section and the
    section headline is line 1.

See the Info documentation at \"(hyperbole)HyWiki\".

\\{hywiki-mode-map}"
  :global t
  :lighter hywiki-mode-lighter
  :keymap hywiki-mode-map
  :group 'hyperbole-hywiki
  ;; Prevent definition of a custom-variable since it makes no sense to
  ;; customize this variable.
  :variable hywiki-mode
  (progn
    ;; Set mode and highlighting
    (pcase arg
     (:all (progn
             ;; Enable across all editable buffers
             ;; Need hyperbole-mode
             (unless hyperbole-mode
	       (hyperbole-mode 1))
             (hywiki-word-set-auto-highlighting hywiki--prior-mode arg)
             (setq hywiki-mode arg)))
     ('nil (progn
            ;; Disable across all editable buffers.
            ;; Dehighlight HyWikiWords in this buffer when 'hywiki-mode' is
            ;; disabled and this is not a HyWiki page buffer. If this is a
            ;; HyWiki page buffer, then dehighlight when `hywiki-mode' is nil.
            (hywiki-word-set-auto-highlighting hywiki--prior-mode arg)
            (setq hywiki-mode arg)))
     (:pages (progn
               ;; Enable in HyWiki page buffers only
               ;; Need hyperbole-mode
               (unless hyperbole-mode
                 (hyperbole-mode 1))
               (hywiki-word-set-auto-highlighting hywiki--prior-mode arg)
               (setq hywiki-mode arg))))))