Accessibility guidelines?

[Norman Gray]

Greetings.

I've been asked about accessibility adjustments to JupyterHub. Is there
any current guidance on this that I could be pointed to?

I can see a passing mention of the issue in [1], and the beginning of a
discussion in [2] which links, inter alia, to [3], all of which look
interesting but still preliminary, and all of which show that the
Jupyter community is engaged with this as a problem -- which is great.
However they don't obviously result in a 'do X, Y and Z' list.

Specifically, I have a report from an affected user that JupyterHub is
'considerably harder [...] to see than MATLAB.' Due to a severe visual
impairment it would be necessary to use 'large font, specific fonts, and
an inverted colour scheme.' It's clear that at least part of that could
be addressed by a per-user CSS script in the right place, but it's not
clear just where that 'right place' is. So question B: is there a place
where I can drop a CSS script and start hacking at it?

(Unfortunately I have few space cycles to support this at present, so
while I'd like to learn the details, I'd _really_ love canned answers,
if they exist...)

I can't find discussion of this on the list archive, but it's possible
my google-fu is weak today.

Best wishes,

Norman


[1] https://github.com/jupyterhub/jupyterhub/issues/990
[2] https://github.com/jupyter/notebook/issues/1801
[3] https://github.com/ipython/ipython/issues/6845

--
Norman Gray : https://nxg.me.uk

[MinRK]

Thanks for the question! We are just learning about how to measure accessibility and address issues, and help is greatly appreciated.

On Mon, Nov 26, 2018 at 5:07 PM Norman Gray <norman...@gmail.com> wrote:

Greetings.

I've been asked about accessibility adjustments to JupyterHub.  Is there
any current guidance on this that I could be pointed to?

I can see a passing mention of the issue in [1], and the beginning of a
discussion in [2] which links, inter alia, to [3], all of which look
interesting but still preliminary, and all of which show that the
Jupyter community is engaged with this as a problem -- which is great. 
However they don't obviously result in a 'do X, Y and Z' list.

Specifically, I have a report from an affected user that JupyterHub is
'considerably harder [...] to see than MATLAB.'  Due to a severe visual
impairment it would be necessary to use 'large font, specific fonts, and
an inverted colour scheme.'  It's clear that at least part of that could
be addressed by a per-user CSS script in the right place, but it's not
clear just where that 'right place' is.  So question B: is there a place
where I can drop a CSS script and start hacking at it?

A user can put CSS overrides in ~/.jupyter/custom/custom.css for notebook classic or create a theme for jupyterlab. Documenting accessibility issues an opening an Issue on GitHub about them and what can be done to improve them would be hugely helpful (or even better, pull requests!), especially on the jupyterlab repo.

 

(Unfortunately I have few space cycles to support this at present, so
while I'd like to learn the details, I'd _really_ love canned answers,
if they exist...)

I can't find discussion of this on the list archive, but it's possible
my google-fu is weak today.

Best wishes,

Norman


[1] https://github.com/jupyterhub/jupyterhub/issues/990
[2] https://github.com/jupyter/notebook/issues/1801
[3] https://github.com/ipython/ipython/issues/6845

--
Norman Gray  :  https://nxg.me.uk

--
You received this message because you are subscribed to the Google Groups "Project Jupyter" group.
To unsubscribe from this group and stop receiving emails from it, send an email to jupyter+u...@googlegroups.com.
To post to this group, send email to jup...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/jupyter/44E56718-46F7-491E-93FD-6F90E71B332D%40gmail.com.
For more options, visit https://groups.google.com/d/optout.

[Chris Holdgraf]

Perhaps it's be useful if there were a community-driven guide to accessibility. e.g. it could come with a few pre-made CSS rules and instructions for where to put them. Even if there are some ways in which it specifically says jupyterXXX is *not* accessible, I think there'd be value in making this explicit so it's clear where we need to make improvements.

To view this discussion on the web visit https://groups.google.com/d/msgid/jupyter/CAHNn8BX%3DKAWaT6GKJZ%3Dwkfc4GBDJkFb0CCWh%3D4Q3ZfPUMf_aKA%40mail.gmail.com.

[Tim Head]

A new thread appeared a few days ago on exactly this topic in the
forum: https://discourse.jupyter.org/t/accessibility-jupyterhub-for-education/242

Maybe we can merge these two? Even if not, cross linking them should
be useful so I'll do that ;)

T

> To view this discussion on the web visit https://groups.google.com/d/msgid/jupyter/CAD7kTDE4B2HLssEvV%2Bh-rwdu%2BF-sYdyL1psLav_Aa91jX%2B9Tgw%40mail.gmail.com.

[Norman Gray]

Greetings, all.

[I'm finally responding to a thread from December...!]

On 5 Dec 2018, at 11:06, MinRK wrote:

> A user can put CSS overrides in ~/.jupyter/custom/custom.css for
> notebook
> classic or create a theme for jupyterlab. Documenting accessibility
> issues
> an opening an Issue on GitHub about them and what can be done to
> improve
> them would be hugely helpful (or even better, pull requests!),
> especially
> on the jupyterlab repo.

Many thanks for the suggestion. It doesn't seem to be working for me,
however.

I've tried putting some simple CSS (just 'body { background-color: #00f;
font-size: 32pt; }') into

1. ~/.jupyter/custom/custom.css
2. ~/.jupyter/profile/static/custom/custom.css and
3. ~/.ipython/profile_default/static/custom/custom.css

but none of them seem to have an effect.

(2) is as suggested by https://server/user/ME/custom/custom.css (which
is what appears to be the custom-CSS URL being loaded by the JupyterHub
front page, based on the presence of <link rel="stylesheet"
href="/user/ME/custom/custom.css" type="text/css"/>).

(3) is as suggested by
<https://sherif.io/2016/01/11/theming-ipython-jupyter-notebook.html> as
the deprecated/old location, which I thought was worth a try.

I'm using

% jupyter --version
4.3.0
% ipython --version
6.2.1

(by the way: is there any way I can get those version numbers from the
Jupyter web page, just to be sure I'm not suffering version-skew
problems?)

I've grepped through the JupyterHub code as retrieved from
<https://github.com/jupyterhub/jupyterhub>, but can't spot anything
obviously relevant.

Thanks for any pointers. Best wishes,

Norman

[Norman Gray]

Greetings.

On 22 Jan 2019, at 17:40, Norman Gray wrote:

> I've tried putting some simple CSS (just 'body { background-color:
> #00f; font-size: 32pt; }') into
>
> 1. ~/.jupyter/custom/custom.css
> 2. ~/.jupyter/profile/static/custom/custom.css and
> 3. ~/.ipython/profile_default/static/custom/custom.css
>
> but none of them seem to have an effect.

I take that back: I can see the contents of (1) at the URL
<https://server/user/ME/custom/custom.css>.

I'm sure this _wasn't_ the case when I sent the email, but now changes
to that file are reflected in this URL immediately. I vaguely suppose
there was some caching going on...?

Anyway, all is now good. We'll play around with this, and if we come to
any usefully-shareable conclusions about how best to set this up, I'll
share them.

Thanks for the pointers to the override file.