Open rgaiacs opened 1 year ago
yes i think this make would sense, but i don't know if nbconvert
is the right scope. there are some immediate ambiguities i imagine in this inference problem. do we operate in notebook or html space? WCAG is defined in HTML, but we are talking notebooks. if we operate in notebook space then we have markdown headers mixed with HTML headers potentially. It is a sticky problem.
i feel like enforcing headings would be something that a static site generator like sphinx or mkdocs would enforce for the notebook author.
nbconvert
turns notebooks into other document formats. i could imagine a library that extends the nbconvert
machinery to add some accessibility into the exporting pipeline. it would make the most sense to operate in HTML space because that is where the WCAG standards are defined. further, we could add more guard rails that let folks know there are ways to improve the accessibility of their content.
Related with [WCAG 2.1 G130:Providing descriptive headings], might be beneficial to add
<h1>
if user doesn't provide one.Consider the Minimal Working Example Jupyter Notebook.
Convert the notebook to HTML using
gives
that has no
<h1>
.cc @Jenneh @isabela-pf