skip to main content

@tonyfast s notebooks

site navigation
notebook summary
title
revisiting nbviewer/nbconvert screen reader experiences
description
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.
cells
7 total
3 code
state
executed in order
kernel
Python [conda env:p311] *
language
python
name
conda-env-p311-py
lines of code
28
outputs
3
table of contents
{"kernelspec": {"display_name": "Python [conda env:p311] *", "language": "python", "name": "conda-env-p311-py"}, "language_info": {"codemirror_mode": {"name": "ipython", "version": 3}, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", "version": "3.11.3"}, "widgets": {"application/vnd.jupyter.widget-state+json": {"state": {}, "version_major": 2, "version_minor": 0}}, "title": "revisiting nbviewer/nbconvert screen reader experiences", "description": "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."}
notebook toolbar
Activate
cell ordering

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

patrick's original video provided a lot of fodder for the rest of the stream. 

%%html
<iframe width="560" height="315" src="https://www.youtube.com/embed/KsUF_HjA97U?si=HGlqvW_gc0ojpsrJ" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></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

[NbConvertApp] WARNING | Config option `kernel_spec_manager_class` not recognized by `NbConvertApp`.
[NbConvertApp] Converting notebook /home/tbone/Downloads/ViewData.ipynb to a11y
[NbConvertApp] Writing 546006 bytes to /home/tbone/Downloads/ViewData.html