Re: emacs manuals: make docs (html) issue with the index.html output

[Jean-Christophe Helary <lists@traduction-libre.org>]

>> When running "make docs" to produce the emacs manuals HTML sets with the following options:
>> 
>> HTML_OPTS = --split=chapter --html
>> 
>> There are issues with the ToC files and index files in
>> 
>> 1) the elisp reference set
>> 2) the lisp intro set
>> 
>> In both cases, the issue seems to be that the ToC is output as "index.html#SEC_Contents" and is then overwritten by the index which is output as "Index.html" (notice the change in case).
>> 
>> The navigation HTML reads:
>> 
>> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]
> 
> Can you link to an online manual where the problem occurs as I couldn't find
> one (I checked three of the emacs manuals before giving up).

https://doublet.jp/gnu/

https://doublet.jp/gnu/elisp/elisp.html/index.html

https://doublet.jp/gnu/lispintro/emacs-lisp-intro.html/index.html

>> It looks like (I have not checked for all the manuals) when a manual only has 1 index it is output as Index.html and the ToC is output as index.html, but on case-insensitive systems (macOS) the files conflict and only the index is kept (presumably after overwriting the ToC).
> 
> Have you actually tested this on macOS?

Yes. That's my machine.

> I haven't but I remember there was code in texi2any to deal with this exact
> eventuality.
> 
> I haven't but I remember there was code in texi2any to deal with this exact
> eventuality.  If there was a node called "index" then it would be output at
> the bottom of index.html.
> 
>> Wouldn't it be more sensible to call the ToC just ToC.html so that it never conflicts with any concept index file?
> 
> For HTTP, index.html is a special name that is the file returned if
> no filename component was present in the URL.

You're right. So that the other index that needs to be named in a different fashion.


-- 
Jean-Christophe Helary @brandelune
https://mac4translators.blogspot.com
https://sr.ht/~brandelune/omegat-as-a-book/