linux-kernel - Re: [PATCH v2 3/3] docs: CSS: make cross-reference links more evident

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <20250604165902.08265fe7@sal.lan>
Date: Wed, 4 Jun 2025 16:59:02 +0200
From: Mauro Carvalho Chehab <mchehab+huawei@...nel.org>
To: Jonathan Corbet <corbet@....net>
Cc: linux-doc@...r.kernel.org, linux-kernel@...r.kernel.org, "
 Nícolas F. R. A. Prado" <nfraprado@...labora.com>
Subject: Re: [PATCH v2 3/3] docs: CSS: make cross-reference links more
 evident

Em Wed,  4 Jun 2025 08:36:45 -0600
Jonathan Corbet <corbet@....net> escreveu:

> The Sphinx Alabaster theme uses border-bottom to mark reference links; the
> result does not render correctly (the underline is missing) in some browser
> configurations.  Switch to using the standard text-underline property, and
> use text-underline-offset to place that underline below any underscores in
> the underlined text.
> 
> Suggested-by: Nícolas F. R. A. Prado <nfraprado@...labora.com>
> Signed-off-by: Jonathan Corbet <corbet@....net>

While I didn't test, it looks good enough for me.

Reviewed-by: Mauro Carvalho Chehab <mchehab+huawei@...nel.org>
> ---
>  Documentation/sphinx-static/custom.css | 7 +++++++
>  1 file changed, 7 insertions(+)
> 
> diff --git a/Documentation/sphinx-static/custom.css b/Documentation/sphinx-static/custom.css
> index f4285417c71a..c9991566f914 100644
> --- a/Documentation/sphinx-static/custom.css
> +++ b/Documentation/sphinx-static/custom.css
> @@ -136,3 +136,10 @@ div.language-selection:hover ul {
>  div.language-selection ul li:hover {
>      background: #dddddd;
>  }
> +
> +/* Make xrefs more universally visible */
> +a.reference, a.reference:hover {
> +    border-bottom: none;
> +    text-decoration: underline;
> +    text-underline-offset: 0.3em;
> +}