org-manual: Add footnote on how to enable described functionality

* doc/manual.org (Literal Examples): The functionality of having
`ref:' links remote-highlighted in HTML is disabled by default (since
version 9.5).  Add a footnote to explain how to enable it.

Link: https://emacs.stackexchange.com/questions/80783/org-mode-export-to-html-onmouseover-highlighting-of-referenced-code-lines
This commit is contained in:
Nick Dokos 2024-03-22 09:08:22 -04:00 committed by Ihor Radchenko
parent 50c51b9ad1
commit 01b540e21f
No known key found for this signature in database
GPG Key ID: 6470762A7DA11D8B
1 changed files with 6 additions and 3 deletions

View File

@ -11369,9 +11369,12 @@ to determine the starting line number.
In literal examples, Org interprets strings like =(ref:name)= as
labels, and use them as targets for special hyperlinks like
=[[(name)]]=---i.e., the reference name enclosed in single parenthesis.
In HTML, hovering the mouse over such a link remote-highlights the
corresponding code line, which is kind of cool.
=[[(name)]]=---i.e., the reference name enclosed in single
parentheses. In HTML, hovering the mouse over such a link
remote-highlights the corresponding code line[fn:: This requires some
Javascript which is /not/ automatically included in the HTML output:
you have to customize the variable =org-html-head-include-scripts= to
~t~ to have it included (it is ~nil~ by default).], which is kind of cool.
You can also add a =-r= switch which /removes/ the labels from the
source code[fn:: Adding =-k= to =-n -r= /keeps/ the labels in the