Thank you, I look forward to testing any new export features.
In my attempts to create accessible documents using ConTeXt sources, my current
approach is to create an HTML file using ConTeXt, which I then manually tweak.
The style sheets that ConTeXt provides are wonderfully easy to adapt, even for
a beginner like me.
To make the HTML file accessible, some manual editing has to happen, and maybe
there is something that can be done to make it easier.
Below are some observations/comments/questions.
Thanks for all the work you do!
1) Screen readers rely on header tags <H1> .. </H1>, etc, while ConText uses
style sheets to provide a more customizable header structure. So I have to
change the ConTeXt headers to
<H1> .. </H1>. That’s about 50-100 lines of manual HTML editing, not too bad
2) The HTML is missing one style sheet: add
<link type="text/css" rel="stylesheet" href=“styles/file-templates.css" />
3) The label={text} parameter for images that provides tags for PDFs becomes in
HTML
<div class="image label-{text} >,
which has to be manually changed to the ALT-tag in HTML
4) All PDF files have to become SVG. I have not been able to set this up so
that the export to HTML recognizes them and that the created PDF displays them;
it has been an either-or.
5) There are problems with links within the document (using \in etc), they
don’t consistently work in the HTML: The ones to sections work, the ones to
theorems, etc don’t. I provided a minimal example earlier.
6)I haven’t heard back from our librarian, who does accessibility checks, about
whether the math is deemed to be accessible. The MATHML appears fine, and I can
also see the spelled-out text in the HTML. I am wondering whether it is
possible to have an accessible text-only HTML export from Context that replaces
every image with its alternative text and every math element with the
spelled-out version ConTeXt creates, along with all navigational elements.
I have not been able to use the MathBlobs tracker for anything but footnotes.
Maybe there is a way (using modes) to replace all math with spelled-out math,
and all figures with their alt-texts?
Matthias
> On Jul 24, 2025, at 8:20 AM, Hans Hagen via ntg-context <ntg-context@ntg.nl>
> wrote:
>
> Hi,
>
> Just for the record. Mikael and I will pick up on the export as well as
> tagging next week and use lecture notes as examples. Wrt tagging we only
> adapted some NoStructs to Div/Span and added languages to a few environments.
> It has a bit lower priority.
>
> There's also a slightly different metod for tagging paragraphs (which only
> affects cases where a paragraph start inside a group and finishes outside the
> group, which seldom happens but maybe it has side effects.
>
> We are wondering about some additional structure related tracing to help
> users figure out useable tagging mappings within the limitations of pdf
> (maybe a few defaults for simple predictable documents like articles that
> often have a rather limited structure anyway, but the system as a whole
> remains configured for extremes).
>
> In the export we can handle sub documents (this is driven by a configuration
> file that permits parallel processing) and noticed soem issues with generated
> images but that was fixed so it will also be in the next upload. If there are
> users who export e.g. chapters from books we can tell them how to experiment
> with that.
>
> No update these few days, probably after the weekend.
>
> Hans
>
> -----------------------------------------------------------------
> Hans Hagen | PRAGMA ADE
> Ridderstraat 27 | 8061 GH Hasselt | The Netherlands
> tel: 038 477 53 69 | www.pragma-ade.nl | www.pragma-pod.nl
> -----------------------------------------------------------------
>
> ___________________________________________________________________________________
> If your question is of interest to others as well, please add an entry to the
> Wiki!
>
> maillist : ntg-context@ntg.nl /
> https://mailman.ntg.nl/mailman3/lists/ntg-context.ntg.nl
> webpage : https://www.pragma-ade.nl / https://context.aanhet.net (mirror)
> archive : https://github.com/contextgarden/context
> wiki : https://wiki.contextgarden.net
> ___________________________________________________________________________________
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the
Wiki!
maillist : ntg-context@ntg.nl /
https://mailman.ntg.nl/mailman3/lists/ntg-context.ntg.nl
webpage : https://www.pragma-ade.nl / https://context.aanhet.net (mirror)
archive : https://github.com/contextgarden/context
wiki : https://wiki.contextgarden.net
___________________________________________________________________________________
