public inbox archive for pandoc-discuss@googlegroups.com
 help / color / mirror / Atom feed
From: mb21 <mauro.bieg-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
To: pandoc-discuss <pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org>
Subject: Re: Accessibility of Generated Docx
Date: Sun, 22 Sep 2019 03:10:24 -0700 (PDT)	[thread overview]
Message-ID: <b37da1b5-c763-4fc0-9006-d69f2a5a0b64@googlegroups.com> (raw)
In-Reply-To: <m2lfuh358a.fsf-pgq/RBwaQ+zq8tPRBa0AtqxOck334EZe@public.gmane.org>


[-- Attachment #1.1: Type: text/plain, Size: 6790 bytes --]

You can try:

pandoc --pdf-engine=context -M pdfa -o output.pdf

see the description of pdfa in 
https://pandoc.org/MANUAL.html#variables-for-context

Maybe the pdfa part is not even needed, since the default pandoc context 
template includes \setuptagging[state=start]



On Saturday, September 21, 2019 at 7:54:29 PM UTC+2, John MacFarlane wrote:
>
>
> You can try using alternative paths to pdf (--pdf-engine supports 
> a number of options, some via HTML, and they may do better for 
> accessibility, I'm not sure). 
>
> Conrad Cunningham <hcc.o...-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org <javascript:>> writes: 
>
> > 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 <bpjo...-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org 
> <javascript:>> 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 <j...-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org 
> <javascript:>> 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.o...-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org <javascript:>> 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-...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org <javascript:>. 
> >>> > 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-...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org <javascript:>. 
> >>> 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-...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org <javascript:>. 
> >> 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-...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org <javascript:>. 
> > To view this discussion on the web visit 
> https://groups.google.com/d/msgid/pandoc-discuss/DF338AD1-4D4E-461B-8A66-F30986A9015E%40gmail.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/b37da1b5-c763-4fc0-9006-d69f2a5a0b64%40googlegroups.com.

[-- Attachment #1.2: Type: text/html, Size: 11813 bytes --]

  parent reply	other threads:[~2019-09-22 10:10 UTC|newest]

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2019-09-12 21:21 Conrad Cunningham
     [not found] ` <677959fb-29b8-4eaa-837f-c53e5ea5ab51-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org>
2019-09-12 23:15   ` Devin Prater
2019-09-13 17:31   ` John MacFarlane
     [not found]     ` <yh480k1rwk6r2b.fsf-pgq/RBwaQ+zq8tPRBa0AtqxOck334EZe@public.gmane.org>
2019-09-13 20:00       ` BP Jonsson
     [not found]         ` <CAFC_yuTPDWN5yxYnSObFq3kiRp+Z=Y3Kvd+67g16qz4D+EgeLA-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org>
2019-09-20 18:53           ` Conrad Cunningham
     [not found]             ` <DF338AD1-4D4E-461B-8A66-F30986A9015E-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
2019-09-21 17:54               ` John MacFarlane
     [not found]                 ` <m2lfuh358a.fsf-pgq/RBwaQ+zq8tPRBa0AtqxOck334EZe@public.gmane.org>
2019-09-22 10:10                   ` mb21 [this message]
     [not found]                     ` <b37da1b5-c763-4fc0-9006-d69f2a5a0b64-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org>
2019-09-25  3:54                       ` Conrad Cunningham

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=b37da1b5-c763-4fc0-9006-d69f2a5a0b64@googlegroups.com \
    --to=mauro.bieg-re5jqeeqqe8avxtiumwx3w@public.gmane.org \
    --cc=pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).