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

2023-01-05 Thread Tim Cross


alain.coch...@unistra.fr writes:

> Tim Cross writes on Thu  5 Jan 2023 09:43:
>
>  > 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.
>
> OK, I understand.  (Even with default font size, I hate that the table
> of contents hides some parts of the text -- I had forgotten about
> that.)
>
>  > [...] 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 [...]  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.
>
> But that's not "Org styling", right?  Or am I confused about what
> "styling" means?
>
> At any rate, I agree with your other examples, understand why the
> styling (as I understand it) should be improved, and am no longer
> worried about changes.  Thank you very much for your time.

It isn't just about the styling - that is just one aspect and the one I
planned to start with. However, styling and presentation will also be
part of providing better links/navigation, which I think is also
necessary to make exploration and discovery easier and more consistent.
.




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

2023-01-05 Thread Alain . Cochard
Tim Cross writes on Thu  5 Jan 2023 09:43:

 > 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.

OK, I understand.  (Even with default font size, I hate that the table
of contents hides some parts of the text -- I had forgotten about
that.)

 > [...] 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 [...]  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.

But that's not "Org styling", right?  Or am I confused about what
"styling" means?

At any rate, I agree with your other examples, understand why the
styling (as I understand it) should be improved, and am no longer
worried about changes.  Thank you very much for your time.

-- 
EOST (École et Observatoire des Sciences de la Terre) 
ITE (Institut Terre & Environnement) | alain.coch...@unistra.fr
5 rue René Descartes   [bureau 110]  | Phone: +33 (0)3 68 85 50 44 
F-67084 Strasbourg Cedex, France | [ slot available for rent ]




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

2023-01-04 Thread Tim Cross


alain.coch...@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. 



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

2023-01-04 Thread Alain . Cochard
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.)

Regards

-- 
EOST (École et Observatoire des Sciences de la Terre) 
ITE (Institut Terre & Environnement) | alain.coch...@unistra.fr
5 rue René Descartes   [bureau 110]  | Phone: +33 (0)3 68 85 50 44 
F-67084 Strasbourg Cedex, France | [ slot available for rent ]




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

2023-01-04 Thread Bastien Guerry
Tim Cross  writes:

> A significant re-design of the worg styling is required in order to get
> a presentation which both looks good and which works with respect to
> accessibility requirements. I don't believe the current styles are
> workable. Someone with greater CSS fu than me might do better, but from
> what I could tell, the basic underlying premise for the existing styles
> is flawed. I suspect it would be possible to 'fix' things, but it would
> be a major style re-working. 

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.

Who would like to help?

-- 
 Bastien