Re: [TASK] Enhance Worg HTML styling (was: [BUG] worg-setup.org is outdated)

[Tim Cross]

Alain.Cochard@unistra.fr writes:

> Bastien Guerry writes on Wed  4 Jan 2023 11:21:
>
>  > Strong +1 on working on Worg's styling.
>  > 
>  > The task may be daunting, but we can also tackle it incrementally.
>  > 
>  > >From memory, orgmode.org/worg is visited by ~30k persons each month,
>  > that 1000 persons per day.  A patch enhancing the .css will make 1000
>  > persons happiers each day.
>
> So far it was an obscure discussion for, but as a visitor of
> orgmode.org/worg I now feel concerned.  What's wrong with Worg's
> styling?  A specific example might be enlightening.  (Enhancement for
> some can be deterioration for others.)
>

As a simple example, try increasing the font size and see what happens
to the menus. Keep in mind that some users require a very large font
(for example, I use a 26 or 28 pt font.

The current site is not good from an accessibility perspective, renders
inconsistently with different browsers, does not have consistent
keyboard navigation, arguably has inconsistent styling in some areas
etc.

If you are able to use the defaults (default font and size, default
fg/bg colors, normal 'desktop' screen, things seem ok. However, once you
need different fonts, different size text, different fg/bg colors or are
using a mobile device or assistive technologies, like a screen reader,
things rapidly degrade. There have also been numerous other issues (many
have already been addressed) such as broken links, links to data which
doesn't exist or has wrong MIME type, issues associated with file name
case etc.  There is also a fair amount of inconsistency in how pages are
presented - some seem to have good navigation support while others do
not, some pages seem to fit into an overall 'site map' while others seem
to be out in their own island etc. As a result, the ability to
effectively browse the site and follow 'threads' of information is often
challenging. Perhaps even more unfortunate is that sometimes, you can
come across some good information in the worg site, but finding that
same information again at a latter date is often extremely challenging.