GNU bug report logs - #51137
29.0.50; Make documentation more readable in mobile devices

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 51137 in the body.
You can then email your comments to 51137 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Carlos Pita <carlosjosepita2 <at> gmail.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 29.0.50; Make documentation more readable in mobile devices
Date: Mon, 11 Oct 2021 16:06:37 -0300

[Message part 1 (text/plain, inline)]

In my phone the navigation links and the subsection links are barely
visible and not proportionate to the body text, which is not only
unpleasant to look at but, more importantly, makes it very difficult to
navigate through the manual. See the attached screenshot.

Best regards,
Carlos

[Emacs in phone.jpeg (image/jpeg, attachment)]

Message #10 received at 51137-done <at> debbugs.gnu.org (full text, mbox):

From: Stefan Kangas <stefan <at> marxist.se>
To: Carlos Pita <carlosjosepita2 <at> gmail.com>
Cc: 51137-done <at> debbugs.gnu.org
Subject: Re: bug#51137: 29.0.50;
 Make documentation more readable in mobile devices
Date: Mon, 11 Oct 2021 12:31:12 -0700

Carlos Pita <carlosjosepita2 <at> gmail.com> writes:

> In my phone the navigation links and the subsection links are barely
> visible and not proportionate to the body text, which is not only
> unpleasant to look at but, more importantly, makes it very difficult to
> navigate through the manual. See the attached screenshot.

This documentation is generated by Texinfo, so I think this should be
reported to the texinfo developers at bug-texinfo <at> gnu.org.  I encourage
you to do so, as it would be nice to get this fixed.

Since this is not a bug in Emacs, I'm closing this bug report.  If you
think this conclusion is incorrect, please reply to this email (use
"Reply to all" in your email client) and we can consider reopening the
bug report.

Message #13 received at 51137 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Carlos Pita <carlosjosepita2 <at> gmail.com>
Cc: 51137 <at> debbugs.gnu.org
Subject: Re: bug#51137: 29.0.50;
 Make documentation more readable in mobile devices
Date: Mon, 11 Oct 2021 22:36:56 +0300

> From: Carlos Pita <carlosjosepita2 <at> gmail.com>
> Date: Mon, 11 Oct 2021 16:06:37 -0300
> 
> In my phone the navigation links and the subsection links are barely
> visible and not proportionate to the body text, which is not only
> unpleasant to look at but, more importantly, makes it very difficult to
> navigate through the manual. See the attached screenshot.

Isn't it a problem with the fonts installed on the phone?

Message #16 received at 51137 <at> debbugs.gnu.org (full text, mbox):

From: Carlos Pita <carlosjosepita2 <at> gmail.com>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 51137 <at> debbugs.gnu.org
Subject: Re: bug#51137: 29.0.50;
 Make documentation more readable in mobile devices
Date: Mon, 11 Oct 2021 17:34:37 -0300

> Isn't it a problem with the fonts installed on the phone?

I don't think so. I only see the issue with emacs, elisp and org-mode
documentation. Besides, it's a pretty standard Android phone running
Chrome, everything more or less up-to-date, no weird customization.
I've been seeing the same or related problems in other phones over the
years too. I will do as you said and report it to the texinfo
developers. Thanks!

Message #19 received at 51137 <at> debbugs.gnu.org (full text, mbox):

From: Carlos Pita <carlosjosepita2 <at> gmail.com>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 51137 <at> debbugs.gnu.org
Subject: Re: bug#51137: 29.0.50;
 Make documentation more readable in mobile devices
Date: Mon, 11 Oct 2021 21:47:33 -0300

In bug-texinfo they told me:

> This is not related to texinfo proper but to the CSS that's added on the gnu server side.

Any of you guys knows who else can I write for this?

Message #22 received at 51137 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Carlos Pita <carlosjosepita2 <at> gmail.com>
Cc: 51137 <at> debbugs.gnu.org
Subject: Re: bug#51137: 29.0.50;
 Make documentation more readable in mobile devices
Date: Tue, 12 Oct 2021 16:36:25 +0300

> From: Carlos Pita <carlosjosepita2 <at> gmail.com>
> Date: Mon, 11 Oct 2021 21:47:33 -0300
> Cc: 51137 <at> debbugs.gnu.org
> 
> In bug-texinfo they told me:
> 
> > This is not related to texinfo proper but to the CSS that's added on the gnu server side.
> 
> Any of you guys knows who else can I write for this?

webmasters <at> gnu.org, I think.

Message #25 received at 51137 <at> debbugs.gnu.org (full text, mbox):

From: Glenn Morris <rgm <at> gnu.org>
To: Carlos Pita <carlosjosepita2 <at> gmail.com>,  51137 <at> debbugs.gnu.org
Cc: Eli Zaretskii <eliz <at> gnu.org>
Subject: Re: bug#51137: 29.0.50;
 Make documentation more readable in mobile devices
Date: Tue, 12 Oct 2021 10:57:40 -0400

Emacs developers have full control over the styling applied to the
manuals on gnu.org. See

https://web.cvs.savannah.gnu.org/viewvc/emacs/emacs/manual.css

(It's true that this mostly just applies gnu.org style, but you could
always stop doing so.)

and the tweaks from  manual-html-fix-* in admin/admin.el .

Message #34 received at 51137 <at> debbugs.gnu.org (full text, mbox):

From: Stefan Kangas <stefan <at> marxist.se>
To: Glenn Morris <rgm <at> gnu.org>
Cc: Eli Zaretskii <eliz <at> gnu.org>, Carlos Pita <carlosjosepita2 <at> gmail.com>,
 51137 <at> debbugs.gnu.org
Subject: Re: bug#51137: 29.0.50;
 Make documentation more readable in mobile devices
Date: Tue, 19 Oct 2021 02:22:55 -0700

Glenn Morris <rgm <at> gnu.org> writes:

> Emacs developers have full control over the styling applied to the
> manuals on gnu.org. See
>
> https://web.cvs.savannah.gnu.org/viewvc/emacs/emacs/manual.css
>
> (It's true that this mostly just applies gnu.org style, but you could
> always stop doing so.)

But it seems better that the GNU stylesheet is updated, so that this is
fixed for everyone and not just for Emacs.

> and the tweaks from  manual-html-fix-* in admin/admin.el .

Message #37 received at 51137 <at> debbugs.gnu.org (full text, mbox):

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Stefan Kangas <stefan <at> marxist.se>
Cc: Glenn Morris <rgm <at> gnu.org>, Eli Zaretskii <eliz <at> gnu.org>,
 Carlos Pita <carlosjosepita2 <at> gmail.com>, webmasters <at> gnu.org,
 51137 <at> debbugs.gnu.org
Subject: Re: bug#51137: 29.0.50; Make documentation more readable in mobile
 devices
Date: Mon, 12 Sep 2022 13:38:42 +0200

[Message part 1 (text/plain, inline)]

Stefan Kangas <stefan <at> marxist.se> writes:

>> (It's true that this mostly just applies gnu.org style, but you could
>> always stop doing so.)
>
> But it seems better that the GNU stylesheet is updated, so that this is
> fixed for everyone and not just for Emacs.

Yes.  The problem seems to be here in style.css:

/* For navigation links */
.node a, .header a {display: inline-block;line-height: 2em;}

Having the <a> in the header be inline-block apparently makes
Chrome-based mobile browsers display the links very weirdly.

To test on a Chromium browser, go to this page:

https://www.gnu.org/software/emacs/manual/html_node/emacs/Basic-Minibuffer.html

And then use Developer Tools to switch to mobile view, and you should
see the problems:

[Message part 2 (image/png, inline)]

[Message part 3 (text/plain, inline)]

Could someone who controls the style.css file fix this,
webmasters <at> gnu.org?

If not, we can override this in the Emacs style sheets, but it seems
like it's a style.css problem.  (On the other hand, perhaps not -- CSS
problems aren't always trivial to debug.)

Message #42 received at 51137 <at> debbugs.gnu.org (full text, mbox):

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: "Therese Godefroy via RT" <webmasters <at> gnu.org>
Cc: 51137 <at> debbugs.gnu.org
Subject: Re: [gnu.org #1872370] Re: bug#51137: 29.0.50; Make documentation
 more readable in mobile devices
Date: Tue, 13 Sep 2022 13:02:50 +0200

"Therese Godefroy via RT" <webmasters <at> gnu.org> writes:

> I commented out the inline-block display. This solves the Chromium
> issue, 

Thanks; I can confirm that the too-small link issue is gone on Chromium
mobile views.

> but the font size is still way too small on phones with
> Firefox. To get a correct display in both browsers, the page should
> have a viewport meta tag in its <head> element:
> <meta name="viewport" content="width=device-width, initial-scale=1"
> />.

I tested on my Android phone here with Firefox and Chrome, and the font
size looked pretty similar (and not too small).  Perhaps it varies
between versions?

Message #47 received at 51137 <at> debbugs.gnu.org (full text, mbox):

From: Stefan Kangas <stefankangas <at> gmail.com>
To: Lars Ingebrigtsen <larsi <at> gnus.org>
Cc: Therese Godefroy via RT <webmasters <at> gnu.org>, 51137 <at> debbugs.gnu.org
Subject: Re: bug#51137: [gnu.org #1872370] Re: bug#51137: 29.0.50; Make
 documentation more readable in mobile devices
Date: Tue, 13 Sep 2022 09:14:32 -0400

Lars Ingebrigtsen <larsi <at> gnus.org> writes:

>> but the font size is still way too small on phones with
>> Firefox. To get a correct display in both browsers, the page should
>> have a viewport meta tag in its <head> element:
>> <meta name="viewport" content="width=device-width, initial-scale=1"
>> />.

That HTML is generated by "makeinfo --html".

The viewport stuff was already added to texinfo in:
https://git.savannah.gnu.org/cgit/texinfo.git/commit/?id=2509d615c

AFAICT, that commit was part of texinfo 6.8, released in June 2021,
which is already in Debian testing.

So I don't think there is anything more for us to do here.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.