Re: Accessibility of Generated Docx

[Conrad Cunningham <hcc.olemiss-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>]

[-- Attachment #1: Type: text/plain, Size: 5267 bytes --]

Thanks. 

It is useful that Pandoc’s docx writer generates files in compatibility mode and that the generated documents are accessible. 

Given my institution’s push to make all public documents accessible, I am looking at convenient (automatable) ways to get my Pandoc-flavored course documents into accessible PDFs and other accessible formats. Unfortunately, mLaTeX-to-PDF support for PDF/UA seems “not ready for prime time”. 

> On Sep 13, 2019, at 3:00 PM, BP Jonsson <bpjonsson-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> wrote:
> 
> I believe compatibility mode is helpful also when opening docx files in LibreOffice. At least even quite large files produced by Pandoc open much faster than some DOCX files people send me.
> 
> 
> Den fre 13 sep. 2019 19:31John MacFarlane <jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org> skrev:
>> 
>> We use compatibility mode so that the docx pandoc produces
>> will be readable by the widest variety of Word versions (even
>> quite old ones).
>> 
>> This isn't itself an issue with accessibility; it's just an
>> issue with the Mac's checker I guess, and I don't think we should
>> modify pandoc just to work around that.
>> 
>> We could change pandoc to avoid compatibility mode, but that
>> would mean our docxs can't be read by older Word versions.
>> At some point it may be worth having this conversation.
>> 
>> In principle we could have a flag to generate either
>> compatibility mode or not, but that adds a lot of complexity
>> for little gain.
>> 
>> > by using a custom reference document with modified styles. The warnings 
>> > associated with code blocks, highlighting, etc., seem more problematic.
>> 
>> The code coloring is affected by the --highlight-style option. We
>> provide several styles out of the box, including a monochrome
>> style which is very high contrast. You can also create and use
>> your own style. See the docs.
>> 
>> 
>> Conrad Cunningham <hcc.olemiss-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> writes:
>> 
>> > I use pandoc to convert Pandoc-flavored Markdown documents to HTML 
>> > (primarily), Word docx, PDF (via LaTeX), etc. I am currently using pandoc 
>> > 2.7.3. Microsoft Word for Mac 16.16.14, and MacTeX 2019 on MacOS 10.14.6 
>> > (Mojave).
>> >
>> > According to the tests I have run using the WebAIM WAVE tool, the 
>> > accessibility of the generated HTML is reasonable. (I need to give some 
>> > attention to places in the Markdown input where I use tables and alt text.)
>> >
>> > For the generated docx, I am using Word for Mac's builtin accessibility 
>> > checker. I found that the generated docx is in compatibility mode. Word for 
>> > Mac's accessibility checker cannot process that kind of file. If I load the 
>> > file into Word and then save as a normal docx, the checker will run.
>> >
>> > Is there a less inconvenient way to get the generated output into the 
>> > normal docx mode? I would like to get the final output by running a shell 
>> > script on the Markdown input.
>> >
>> > The issues I have found so far in my limited tests are warnings about 
>> > insufficient color contrasts and sequences of blank characters. Some of 
>> > these (e.g., colors in section headers and hyperlinks) seem to be fixable 
>> > by using a custom reference document with modified styles. The warnings 
>> > associated with code blocks, highlighting, etc., seem more problematic.
>> >
>> > -- 
>> > You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
>> > To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
>> > To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/677959fb-29b8-4eaa-837f-c53e5ea5ab51%40googlegroups.com.
>> 
>> -- 
>> You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
>> To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
>> To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/yh480k1rwk6r2b.fsf%40johnmacfarlane.net.
> 
> -- 
> You received this message because you are subscribed to a topic in the Google Groups "pandoc-discuss" group.
> To unsubscribe from this topic, visit https://groups.google.com/d/topic/pandoc-discuss/Y8Q1z1mdgVM/unsubscribe.
> To unsubscribe from this group and all its topics, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/CAFC_yuTPDWN5yxYnSObFq3kiRp%2BZ%3DY3Kvd%2B67g16qz4D%2BEgeLA%40mail.gmail.com.

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/DF338AD1-4D4E-461B-8A66-F30986A9015E%40gmail.com.

[-- Attachment #2: Type: text/html, Size: 7341 bytes --]