[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Identifying links to other Texinfo manuals in HTML

From: Gavin Smith
Subject: Re: Identifying links to other Texinfo manuals in HTML
Date: Tue, 24 Nov 2020 20:02:44 +0000

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).

reply via email to

[Prev in Thread] Current Thread [Next in Thread]