Re: Identifying links to other Texinfo manuals in HTML

[Gavin Smith]

On Sun, Oct 18, 2020 at 11:31 PM Per Bothner <per@bothner.com> wrote:
>
> On 10/18/20 2:48 PM, Gavin Smith wrote:
> > Does anybody have a good idea how links to other Texinfo
> > manuals could be marked in the HTML output?  At present
> > there is nothing to distinguish a link like
> >
> > <a 
> > href="https://www.gnu.org/software/emacs/manual/html_mono/elisp.html#Special-Forms";>Special
> >  Forms</a>
> >
> > from a link like
> >
> > <a href="http://ctan.org/pkg/cm-super";>CM-Super</a>
>
> There are lots of ways. For example a new class name:
>
>     <a class="external-texinfo-manual" href="...">...</a>
>
> If you want to list the name of manual (which might be useful
> for a hover-over) you can use a new attribute:
>
>    <a external-texinfo-manual="GNU Emacs Lisp Reference Manual" 
> href="...">...</a>

I think that the external manual name should be added as a data attribute:

<a data-manual="elisp" href="...">

as there's no reliable way to extract this information from the URL.

Possibly also even the package it's from, so

<a data-manual="elisp" data-package="emacs" href="...">

so a browser can look under /usr/share/doc/emacs/elisp for the manual
instead of just /usr/share/doc/elisp (although I don't know where the
package information would come from).