Hyperbole User Manual
2.4.3 Link Variable Substitution
Another variable to consider modifying in the `hsite.el' file is
hpath:variables. This variable consists of a list of Emacs Lisp
variable names, each of which may have a pathname or a list of pathnames
as a value. Whenever a Hyperbole file or directory link button is
created, its pathname is compared against the values in
hpath:variables. The first match found, if any, is selected and
its associated variable name is substituted into the link pathname, in
place of its literal value. When the link is resolved (the button is
activated), Hyperbole replaces each variable with the first matching
value from this list. (Environment variables are also replaced whenever
link paths are resolved.
This permits sharing of links over wide areas, where the variable values
may differ between link creator and link activator. The entire process
is wholly transparent to the user; it is explained here simply to help
you in deciding whether or not to modify the value of
hpath:variables.
