Re: The HTML-Info initiative

[Gavin Smith]

On Mon, Dec 27, 2021 at 09:07:21AM -0800, Per Bothner wrote:
> On 12/27/21 01:02, Gavin Smith wrote:
> > I've started it in the TODO.HTML file in the git repo.  It can be read at
> > 
> > https://git.savannah.gnu.org/cgit/texinfo.git/plain/TODO.HTML
> 
> https://git.savannah.gnu.org/cgit/texinfo.git/plain/TODO.HTML
> 
> "However, this system is only appropriate for online manuals, not for
> locally installed manuals."
> 
> I don't agree: It works prefectly fine for locally installed manuals,
> either using file: URLs or http://localhost/.
> 
> However, there may be some issues relating to:
> 
> "It only handles one manual at a time and does not handle searching for a 
> manual."

Yes that is the point.

> Cross-manual links could be handled pretty by standarding relative URLs.
> I.e. if the emacs/texinfo manual is 
> /usr/local/share/doc/{emacs,texinfo}/index.html
> and you can get from one to the other using "../{texinfo,emacs}/index.html".

This was discussed in the document:
> Prior to this, we mooted the idea of outputting links in HTML documents
> differently if they were to be installed locally rather than put on the web.
> For example, link to "../auth/index.html" instead of
> "https://www.gnu.org/software/emacs/manual/html_node/auth/index.html";.  With
> the right installation standards, this would have allowed inter-manual
> links to work in regular web browsers (although only for a single
> installation location).