* Improvements to Emacs documentation accessibility
@ 2022-10-12 12:37 John Haman
2022-10-12 13:44 ` Po Lu
2022-10-12 13:47 ` Eli Zaretskii
0 siblings, 2 replies; 12+ messages in thread
From: John Haman @ 2022-10-12 12:37 UTC (permalink / raw)
To: emacs-devel
I noticed while browsing the Emacs manuals on my mobile phone that the
accessibility is very poor. The text is very small which makes it hard
to read without zooming and scrolling.
The layout of the texinfo html is classic, but would the community would
be open to making the docs more readable on small devices? (like mobile
phones and tablets)
I'm not a web developer, but I believe the solution would involve some
improvements to the CSS of the documentation to add word-wrapping and
maybe increase the font size.
I'm happy to help.
-John
^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: Improvements to Emacs documentation accessibility
2022-10-12 12:37 Improvements to Emacs documentation accessibility John Haman
@ 2022-10-12 13:44 ` Po Lu
2022-10-12 16:16 ` John Haman
2022-10-12 13:47 ` Eli Zaretskii
1 sibling, 1 reply; 12+ messages in thread
From: Po Lu @ 2022-10-12 13:44 UTC (permalink / raw)
To: John Haman; +Cc: emacs-devel
John Haman <mail@johnhaman.org> writes:
> I noticed while browsing the Emacs manuals on my mobile phone that the
> accessibility is very poor. The text is very small which makes it hard
> to read without zooming and scrolling.
>
> The layout of the texinfo html is classic, but would the community
> would be open to making the docs more readable on small devices? (like
> mobile phones and tablets)
>
> I'm not a web developer, but I believe the solution would involve some
> improvements to the CSS of the documentation to add word-wrapping and
> maybe increase the font size.
>
> I'm happy to help.
AFAIU that means you somehow landed on an outdated page, since the
latest ones have been generated to work well on mobile browsers as well.
At least that's the conclusion last bug report about this led to. Feel
free to correct me if I'm wrong.
^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: Improvements to Emacs documentation accessibility
2022-10-12 12:37 Improvements to Emacs documentation accessibility John Haman
2022-10-12 13:44 ` Po Lu
@ 2022-10-12 13:47 ` Eli Zaretskii
2022-10-13 3:31 ` Stefan Kangas
1 sibling, 1 reply; 12+ messages in thread
From: Eli Zaretskii @ 2022-10-12 13:47 UTC (permalink / raw)
To: John Haman, Stefan Kangas; +Cc: emacs-devel
> Date: Wed, 12 Oct 2022 08:37:56 -0400
> From: John Haman <mail@johnhaman.org>
>
> I noticed while browsing the Emacs manuals on my mobile phone that the
> accessibility is very poor. The text is very small which makes it hard
> to read without zooming and scrolling.
AFAIU, the following is missing from the HTML manuals:
<meta name="viewport" content="width=device-width, initial-scale=1" />
This is strange, since I think the previous version did include that
heading. Texinfo does produce it, but AFAIR the script that edits the
HTML for the Web site was originally removing that line. That should
have been fixed several months ago.
Stefan, can you please look into this?
^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: Improvements to Emacs documentation accessibility
2022-10-12 13:44 ` Po Lu
@ 2022-10-12 16:16 ` John Haman
2022-10-12 17:17 ` Philip Kaludercic
0 siblings, 1 reply; 12+ messages in thread
From: John Haman @ 2022-10-12 16:16 UTC (permalink / raw)
To: Po Lu; +Cc: emacs-devel
[-- Attachment #1: Type: text/plain, Size: 1122 bytes --]
> AFAIU that means you somehow landed on an outdated page
I don't think it is outdated. Attaching an image that shows an example.
To me, it does not look like a mobile website.
On 10/12/22 9:44 AM, Po Lu wrote:
> John Haman <mail@johnhaman.org> writes:
>
>> I noticed while browsing the Emacs manuals on my mobile phone that the
>> accessibility is very poor. The text is very small which makes it hard
>> to read without zooming and scrolling.
>>
>> The layout of the texinfo html is classic, but would the community
>> would be open to making the docs more readable on small devices? (like
>> mobile phones and tablets)
>>
>> I'm not a web developer, but I believe the solution would involve some
>> improvements to the CSS of the documentation to add word-wrapping and
>> maybe increase the font size.
>>
>> I'm happy to help.
> AFAIU that means you somehow landed on an outdated page, since the
> latest ones have been generated to work well on mobile browsers as well.
>
> At least that's the conclusion last bug report about this led to. Feel
> free to correct me if I'm wrong.
--
Dr. John Haman
Bethesda, MD
[-- Attachment #2: Sequences Arrays Vectors (GNU Emacs Lisp Reference Manual).png --]
[-- Type: image/png, Size: 180186 bytes --]
^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: Improvements to Emacs documentation accessibility
2022-10-12 16:16 ` John Haman
@ 2022-10-12 17:17 ` Philip Kaludercic
2022-10-12 17:29 ` Eli Zaretskii
0 siblings, 1 reply; 12+ messages in thread
From: Philip Kaludercic @ 2022-10-12 17:17 UTC (permalink / raw)
To: John Haman; +Cc: Po Lu, emacs-devel
[-- Attachment #1: Type: text/plain, Size: 1711 bytes --]
John Haman <mail@johnhaman.org> writes:
>> AFAIU that means you somehow landed on an outdated page
>
> I don't think it is outdated. Attaching an image that shows an example.
>
> To me, it does not look like a mobile website.
I just tried it out in Firefox using the "Responsive Design Mode" (that
allows you to preview how a page looks like on a mobile device).
Interestingly enough the page did at first appear just like in your
screenshot, but when I slightly resized the frame it did appear like a
regular "mobile site" (hopefully attached below).
The site is missing a viewport-meta tag which is regretfully necessary
for normal pages to behave like normal pages on mobile screens. Adding
that ought to help, but that should be done by the texinfo/makeinfo
maintainers.
> On 10/12/22 9:44 AM, Po Lu wrote:
>> John Haman <mail@johnhaman.org> writes:
>>
>>> I noticed while browsing the Emacs manuals on my mobile phone that the
>>> accessibility is very poor. The text is very small which makes it hard
>>> to read without zooming and scrolling.
>>>
>>> The layout of the texinfo html is classic, but would the community
>>> would be open to making the docs more readable on small devices? (like
>>> mobile phones and tablets)
>>>
>>> I'm not a web developer, but I believe the solution would involve some
>>> improvements to the CSS of the documentation to add word-wrapping and
>>> maybe increase the font size.
>>>
>>> I'm happy to help.
>> AFAIU that means you somehow landed on an outdated page, since the
>> latest ones have been generated to work well on mobile browsers as well.
>>
>> At least that's the conclusion last bug report about this led to. Feel
>> free to correct me if I'm wrong.
[-- Attachment #2: Type: image/png, Size: 249127 bytes --]
^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: Improvements to Emacs documentation accessibility
2022-10-12 17:17 ` Philip Kaludercic
@ 2022-10-12 17:29 ` Eli Zaretskii
2022-10-12 18:20 ` Philip Kaludercic
0 siblings, 1 reply; 12+ messages in thread
From: Eli Zaretskii @ 2022-10-12 17:29 UTC (permalink / raw)
To: Philip Kaludercic; +Cc: mail, luangruo, emacs-devel
> From: Philip Kaludercic <philipk@posteo.net>
> Cc: Po Lu <luangruo@yahoo.com>, emacs-devel@gnu.org
> Date: Wed, 12 Oct 2022 17:17:21 +0000
>
> The site is missing a viewport-meta tag which is regretfully necessary
> for normal pages to behave like normal pages on mobile screens. Adding
> that ought to help, but that should be done by the texinfo/makeinfo
> maintainers.
Texinfo 6.8 already adds that tag. As I wrote, the scripts we use to
adapt the HTML docs to the GNU Web site used to remove that tag, but
that was supposed to be fixed months ago. In any case, this is our
problem, not Texinfo's.
^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: Improvements to Emacs documentation accessibility
2022-10-12 17:29 ` Eli Zaretskii
@ 2022-10-12 18:20 ` Philip Kaludercic
2022-10-12 18:38 ` Eli Zaretskii
0 siblings, 1 reply; 12+ messages in thread
From: Philip Kaludercic @ 2022-10-12 18:20 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: mail, luangruo, emacs-devel
Eli Zaretskii <eliz@gnu.org> writes:
>> From: Philip Kaludercic <philipk@posteo.net>
>> Cc: Po Lu <luangruo@yahoo.com>, emacs-devel@gnu.org
>> Date: Wed, 12 Oct 2022 17:17:21 +0000
>>
>> The site is missing a viewport-meta tag which is regretfully necessary
>> for normal pages to behave like normal pages on mobile screens. Adding
>> that ought to help, but that should be done by the texinfo/makeinfo
>> maintainers.
>
> Texinfo 6.8 already adds that tag. As I wrote, the scripts we use to
> adapt the HTML docs to the GNU Web site used to remove that tag, but
> that was supposed to be fixed months ago. In any case, this is our
> problem, not Texinfo's.
Even better then. Do you know why the tag was removed?
^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: Improvements to Emacs documentation accessibility
2022-10-12 18:20 ` Philip Kaludercic
@ 2022-10-12 18:38 ` Eli Zaretskii
0 siblings, 0 replies; 12+ messages in thread
From: Eli Zaretskii @ 2022-10-12 18:38 UTC (permalink / raw)
To: Philip Kaludercic; +Cc: mail, luangruo, emacs-devel
> From: Philip Kaludercic <philipk@posteo.net>
> Cc: mail@johnhaman.org, luangruo@yahoo.com, emacs-devel@gnu.org
> Date: Wed, 12 Oct 2022 18:20:33 +0000
>
> Eli Zaretskii <eliz@gnu.org> writes:
>
> >> From: Philip Kaludercic <philipk@posteo.net>
> >> Cc: Po Lu <luangruo@yahoo.com>, emacs-devel@gnu.org
> >> Date: Wed, 12 Oct 2022 17:17:21 +0000
> >>
> >> The site is missing a viewport-meta tag which is regretfully necessary
> >> for normal pages to behave like normal pages on mobile screens. Adding
> >> that ought to help, but that should be done by the texinfo/makeinfo
> >> maintainers.
> >
> > Texinfo 6.8 already adds that tag. As I wrote, the scripts we use to
> > adapt the HTML docs to the GNU Web site used to remove that tag, but
> > that was supposed to be fixed months ago. In any case, this is our
> > problem, not Texinfo's.
>
> Even better then. Do you know why the tag was removed?
Originally, inadvertently, by scripts that were written to handle
older Texinfo-produced HTML docs. But when we found out about the
removal of viewport tag, we fixed that (AFAIR). Which is why I'm
surprised it isn't there.
If worse comes to worst, we can add it manually.
^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: Improvements to Emacs documentation accessibility
2022-10-12 13:47 ` Eli Zaretskii
@ 2022-10-13 3:31 ` Stefan Kangas
2022-10-13 6:08 ` Eli Zaretskii
2022-10-13 18:23 ` John Haman
0 siblings, 2 replies; 12+ messages in thread
From: Stefan Kangas @ 2022-10-13 3:31 UTC (permalink / raw)
To: Eli Zaretskii, John Haman; +Cc: emacs-devel
Eli Zaretskii <eliz@gnu.org> writes:
> AFAIU, the following is missing from the HTML manuals:
>
> <meta name="viewport" content="width=device-width, initial-scale=1" />
>
> This is strange, since I think the previous version did include that
> heading. Texinfo does produce it, but AFAIR the script that edits the
> HTML for the Web site was originally removing that line. That should
> have been fixed several months ago.
>
> Stefan, can you please look into this?
This should now be fixed.
I had to regenerate the HTML files using the makeinfo version from
Debian testing/bookworm, instead of the one from stable/bullseye that I
used previously.
^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: Improvements to Emacs documentation accessibility
2022-10-13 3:31 ` Stefan Kangas
@ 2022-10-13 6:08 ` Eli Zaretskii
2022-10-13 18:13 ` Bastien
2022-10-13 18:23 ` John Haman
1 sibling, 1 reply; 12+ messages in thread
From: Eli Zaretskii @ 2022-10-13 6:08 UTC (permalink / raw)
To: Stefan Kangas; +Cc: mail, emacs-devel
> From: Stefan Kangas <stefankangas@gmail.com>
> Date: Wed, 12 Oct 2022 20:31:41 -0700
> Cc: emacs-devel@gnu.org
>
> Eli Zaretskii <eliz@gnu.org> writes:
>
> > AFAIU, the following is missing from the HTML manuals:
> >
> > <meta name="viewport" content="width=device-width, initial-scale=1" />
> >
> > This is strange, since I think the previous version did include that
> > heading. Texinfo does produce it, but AFAIR the script that edits the
> > HTML for the Web site was originally removing that line. That should
> > have been fixed several months ago.
> >
> > Stefan, can you please look into this?
>
> This should now be fixed.
>
> I had to regenerate the HTML files using the makeinfo version from
> Debian testing/bookworm, instead of the one from stable/bullseye that I
> used previously.
Thanks.
I think the conclusion here is that we should use the latest released
Texinfo version when generating the manuals. Maybe it's something to
be said in make-tarball.txt. (I always build my own Texinfo from
sources on systems where I need to generate Emacs manuals, FWIW. It's
not hard to build it.)
^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: Improvements to Emacs documentation accessibility
2022-10-13 6:08 ` Eli Zaretskii
@ 2022-10-13 18:13 ` Bastien
0 siblings, 0 replies; 12+ messages in thread
From: Bastien @ 2022-10-13 18:13 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: Stefan Kangas, mail, emacs-devel
Eli Zaretskii <eliz@gnu.org> writes:
> I think the conclusion here is that we should use the latest released
> Texinfo version when generating the manuals.
Thanks for catching this!
I've also updated the Org-mode manual and guide here:
https://orgmode.org/manual/
https://orgmode.org/guide/
--
Bastien
^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: Improvements to Emacs documentation accessibility
2022-10-13 3:31 ` Stefan Kangas
2022-10-13 6:08 ` Eli Zaretskii
@ 2022-10-13 18:23 ` John Haman
1 sibling, 0 replies; 12+ messages in thread
From: John Haman @ 2022-10-13 18:23 UTC (permalink / raw)
To: Stefan Kangas; +Cc: emacs-devel
On 10/12/22 11:31 PM, Stefan Kangas wrote:
> This should now be fixed.
It is ! Thanks for acting quickly.
--
Dr. John Haman
Bethesda, MD
^ permalink raw reply [flat|nested] 12+ messages in thread
end of thread, other threads:[~2022-10-13 18:23 UTC | newest]
Thread overview: 12+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2022-10-12 12:37 Improvements to Emacs documentation accessibility John Haman
2022-10-12 13:44 ` Po Lu
2022-10-12 16:16 ` John Haman
2022-10-12 17:17 ` Philip Kaludercic
2022-10-12 17:29 ` Eli Zaretskii
2022-10-12 18:20 ` Philip Kaludercic
2022-10-12 18:38 ` Eli Zaretskii
2022-10-12 13:47 ` Eli Zaretskii
2022-10-13 3:31 ` Stefan Kangas
2022-10-13 6:08 ` Eli Zaretskii
2022-10-13 18:13 ` Bastien
2022-10-13 18:23 ` John Haman
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).