Re: HTML <title> node names: Not emitting 'Top (Manual name)'

[Gavin Smith]

On Sat, Mar 16, 2024 at 03:13:04PM +0100, pertusus@free.fr wrote:

> My last important interrogation is about CSS.  The whole CSS added by
> texi2any is removed, instead of using the possibility offered by the
> command-line.  My feeling is that what is done right now would be better
> achieved either by calling with
>  --css-include=/software/emacs/manual.css
> although it may not lead to the wanted result if there is some
> disagreement between the CSS output bu texi2any and the emacs CSS.
> Another possibility would be to add a file named, for example
> import_emacs_css.css which would only contain
> 
> @import url('/software/emacs/manual.css');
> 
> and use
>   --css-ref=..../import_emacs_css.css
> at the command-line.
> 
> I think that it would be better if the texi2any CSS was kept as some is
> important for some features, such as copiable links.  In the CSS file
> https://www.gnu.org/style.css I also noticed that some parts refer to
> classes no longer used, which is ok if old releases are targeted, but
> the new class is not there, which makes wonder if some of the code is
> still needed.

I asked about this in the past:

"Online HTML manuals for Emacs missing important CSS"
https://lists.gnu.org/archive/html/help-gnu-emacs/2023-04/msg00007.html

> See for example:
> 
> https://www.gnu.org/software/emacs/manual/html_node/emacs/Misc-X.html#index-_002d_002dbasic_002ddisplay.
> https://www.gnu.org/software/emacs/manual/html_node/elisp/Choosing-Window-Options.html
> 
> There are ¶ (pilcrow) symbols visible indicating copiable links.
> 
> texi2any outputs CSS rules to hide these unless the users moves their
> mouse pointer over the text:
> 
> a.copiable-link {visibility: hidden; text-decoration: none; line-height: 0em}
> span:hover a.copiable-link {visibility: visible}
> 
> However, these rules are missing.  Presumably they are removed when
> the Emacs manuals are built for the web.
> 
> Could I suggest that either these CSS rules not be removed, or that
> they be included in the "manual.css" file referenced by these pages?