revisiting nbviewer/nbconvert screen reader experiences¤
today i recorded stream that started by watching patrick's first screen reader demo of navigating notebooks. i add some color commentary and demonstrate how the situation has not changed. we explore the same patterns through different rendering engines: nbviewer, github, a custom theme. the chapters below summarize the different concepts we discussed.
- 0:00 rendered notebooks and screen readers
- 1:29 patricks NVDA notebook walk through
- 6:18 tony demonstrates screen reader navigation with Orca
- 12:34 return to patrick's audit with heading navigation
- 25:20 tony uses the screen reader
- 30:07 tony gets really mad at jupyterlab
- 31:00 convert notebook to the accessible template
- 33:25 accessible template version
- 34:00 notebook summary
- 35:39 navigating cells audibly and visually
- 42:25 nbviewer screen reader audit
- 49:20 clean up notebook and wrap up
- 54:41 github notebook screen reader example
%%html
<iframe allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen="" frameborder="0" height="315" src="https://www.youtube.com/embed/rEnJNlPtPH8?si=lCXyjutgeLcqNUKH" title="YouTube video player" width="560"></iframe>
patrick's original video provided a lot of fodder for the rest of the stream.
%%html
<iframe allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen="" frameborder="0" height="315" src="https://www.youtube.com/embed/KsUF_HjA97U?si=HGlqvW_gc0ojpsrJ" title="YouTube video player" width="560"></iframe>
the cos data notebook rendered by nbviewer
creating an accessible version of the document¤
using the new nbconvert-a11y we export an assistive, labor reducing version of the template outputs.
the code below exports an assistive version of the COS notebook designed for a screen reader
!jupyter nbconvert --to a11y /home/tbone/Downloads/ViewData.ipynb