On Sat, Mar 16, 2024 at 03:13:04PM +0100, pertu...@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?