From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.text.pandoc/23416 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: John MacFarlane Newsgroups: gmane.text.pandoc Subject: Re: Accessibility of Generated Docx Date: Fri, 13 Sep 2019 10:31:40 -0700 Message-ID: References: <677959fb-29b8-4eaa-837f-c53e5ea5ab51@googlegroups.com> Reply-To: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="208521"; mail-complaints-to="usenet@blaine.gmane.org" To: Conrad Cunningham , pandoc-discuss Original-X-From: pandoc-discuss+bncBCJZJHG45QDBBCNF57VQKGQETRFK4RI-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Fri Sep 13 19:31:57 2019 Return-path: Envelope-to: gtp-pandoc-discuss@m.gmane.org Original-Received: from mail-pf1-f183.google.com ([209.85.210.183]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.89) (envelope-from ) id 1i8pQK-000s4s-4o for gtp-pandoc-discuss@m.gmane.org; Fri, 13 Sep 2019 19:31:56 +0200 Original-Received: by mail-pf1-f183.google.com with SMTP id 194sf21000782pfu.3 for ; Fri, 13 Sep 2019 10:31:56 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1568395914; cv=pass; d=google.com; s=arc-20160816; b=WqL7yE+3Wem0bX+v1qabSwtOkcj0dwvQ2COHCQUxNLIVeqr9GScfYK9VhdcQHxELGN EVsOB8afQzHeqEyhOlaoSYh5p6RHfGmCz8tcZx7/YOGeSDDoYYImsdK7AjEQdn6AQic8 t2a3tg0bEli5iISqtV56S0tmpYpGmf3r1COM5afqhytt3Q0XZyaRGgTxIKZ6LphPV6/O hVXJDNbU/GEDJQrGFAYF2gCzNhsBaEn14Y66w5SNsaI+790UdRWs6F95hv0Dwg775Ear EuJsY3i9RVKr9NzVGNEUKfvX4Mdafde33uU5dOlV0y9mGDE2bdM6RDZE35aUYUqoLIKs 157Q== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:reply-to:mime-version:message-id :date:references:in-reply-to:subject:to:from:sender:dkim-signature; bh=JAq6PrQUd5wZSHtk0rLK+i2/P6+5/7rMxX0BlGeg8Mc=; b=z2FMjSJts98M4GG+BIzx8jMU8pvUsLNJuUjZkPwo4nm+4RpTVKj9IXQF3NGR6Pspqu ACfGwsoU5BYb6Yv7mU/QAf308fIsBZmDjisjrkmXtxC4Iw8DFxSmNdUBlZnZjXNLE/UK MP8nHVV7uqBFLZsdyNUaXTJkyZGiGMFOg/A7dmTHI/nI5bFL/693hhUYibZPKybYhlNm OD597UvRm5hBtnq2sRNeFwIPD+P0xB8WD0vo/9Bosg9HIeEjrOT8e7f+eHo3nSLk9k+t uMT9i06w+ulKv7KMiumQb5vFAyrRDRrhahSazBabM2W24HsgJKhVIMnN5FBRp5LI+UY5 D+Iw== ARC-Authentication-Results: i=2; gmr-mx.google.com; dkim=pass header.i=@berkeley-edu.20150623.gappssmtp.com header.s=20150623 header.b=I85Xi9BB; spf=pass (google.com: domain of jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org designates 2607:f8b0:4864:20::529 as permitted sender) smtp.mailfrom=jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20161025; h=sender:from:to:subject:in-reply-to:references:date:message-id :mime-version:x-original-sender:x-original-authentication-results :reply-to:precedence:mailing-list:list-id:list-post:list-help :list-archive:list-subscribe:list-unsubscribe; bh=JAq6PrQUd5wZSHtk0rLK+i2/P6+5/7rMxX0BlGeg8Mc=; b=cCp8iIJVpD3DQEMfryP6CGtx1B9dGuCoPKNJBBzZaytuk9qAqTxutG4M2Cvfk9eKat FX0LYJzT3aK9hJjE+j7+6xkLOkhMyEb8YwIWsZzZxgJLbY1DKZJU8CX/DVFQs6aVGFIw 50CsNzZhiwEti0n8W3MwtS4+bxZMOga+WL1Ll84t/j3cNeZ9ePjX9ZFOR09yZjB91L2Y 2rpaG2ZE1XQkGT1YX5qGlgyxsup25mBbcYdAl+G4uUpwaDXKdOm/yHnMFZvYk+EHLuKL RvzlaRGTdUz9FASVQf1aWPlHs3grWCJemQMscONQFMmrEc8lgFB6IvAxHu1uZ/pqXWTM WbrA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=sender:x-gm-message-state:from:to:subject:in-reply-to:references :date:message-id:mime-version:x-original-sender :x-original-authentication-results:reply-to:precedence:mailing-list :list-id:x-spam-checked-in-group:list-post:list-help:list-archive :list-subscribe:list-unsubscribe; bh=JAq6PrQUd5wZSHtk0rLK+i2/P6+5/7rMxX0BlGeg8Mc=; b=cvHY8ILGlxRmxsTtVpa8j2/Blw6Jr7XXyqVgcjOJsX09xerlNi/GUeRiaVyDc9774c VPsO6N5IIaJTt9Fsc6dp9WkI6nuvXz61bOyQ0luJIYHeVCnzajACg7Vayacml6VyAiHn eYPDtcKiCiRH8+gbvSuKEsoTXzbTyXEUaRi5Lj6cFSXenLohesptzABLmyBmeIjMzMEW lexMpdhTUrxN5U4rHJZV0HdoJe1vrXAPDOp85PJvJgrXfS9TIpprc/N5zjpOS2CKQ12s a/d0yOamgRlv1gHRoBgIuCY4X7g6TOgLfeLh2DCn+CXCpV04eCEgd8MN3Mk4TWWSxem+ cjGA== Original-Sender: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org X-Gm-Message-State: APjAAAVLcFnSA7PkU1z4VnWYFOHqGSzl/ZwKunCbyBc3MHhB8Wr6SxZJ 6z1sylVrO90KKvEZvj7kqyQ= X-Google-Smtp-Source: APXvYqzq4wCqrdJDiVtS3mYX+xVo60o9zDpSi8gDYnW8YEsX3cbDtJrM8TYgvLyMpSPZ+D3OL/cb3A== X-Received: by 2002:a65:62d7:: with SMTP id m23mr44419531pgv.358.1568395914560; Fri, 13 Sep 2019 10:31:54 -0700 (PDT) X-BeenThere: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org Original-Received: by 2002:aa7:9d10:: with SMTP id k16ls8508491pfp.4.gmail; Fri, 13 Sep 2019 10:31:53 -0700 (PDT) X-Received: by 2002:a62:2b4d:: with SMTP id r74mr26599211pfr.30.1568395913331; Fri, 13 Sep 2019 10:31:53 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1568395913; cv=none; d=google.com; s=arc-20160816; b=w02vycqGRM+hpoQ9DxC8hz3/r12U9LIkqLmnDSc0tOGxhFXPun7HU7PjZCt2q45FQK 7UNG6u93EKR/tti0/S8ytJLmiZlsqTy610f8E7PZ8B1a8llNZUyiJgEToHM/+j/Ffv3B iwXCJn+D+QDK+SqkG65TfraN+9sftqRkCY/U7BQuke3J2doR7y4l5rfRdcYk0d0gcjrM YOYpg1ZkdNDSOMAnHH8tOYnfTPRXd1uK9oLfwO2/oORoWVai1zTjzLuau1XtLmD8Loc8 VJ18O5MViq6VovYW6JqHhOsIHDhYG6wi4aNsKEDUwUgrDFcFDkLo2cfoKwQyeZMsKN55 +/wQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=mime-version:message-id:date:references:in-reply-to:subject:to:from :dkim-signature; bh=m/TQcAdrae8WB+IOHZ0Ns0dLtNGv3rhueu5Q12SIF1o=; b=fkzaBzFmZ7DmOYzu4dtPI63DZG3jO8oDe1289VZNOKIv77J8RSqFhpliEYRllWDb2U doAjFyrnBVI5iDW9LTDNpRPZVYmg9YEo9Yk+hCrbaozwtpP8f6T74a8SPN+0GNzPifaa bHbJcGtBcvVfuhrAJKeynn+4s3nWwpXOMU/+/ylXxDBrtLo+3vvCHS/XwYw1IG4OcwTj 4E9np0SqD8zjCLo4jxOVlN5W/nB/eglzlKaZ44VuBAIM77DCDKOUKCu15zOw9mescERc 80x1jujAlclw0hW5mpxamOToFLWNoBe9fthxhaAJaPwnkPvu4FxoaddUQjPzq8Fb6VXU 0NvA== ARC-Authentication-Results: i=1; gmr-mx.google.com; dkim=pass header.i=@berkeley-edu.20150623.gappssmtp.com header.s=20150623 header.b=I85Xi9BB; spf=pass (google.com: domain of jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org designates 2607:f8b0:4864:20::529 as permitted sender) smtp.mailfrom=jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org Original-Received: from mail-pg1-x529.google.com (mail-pg1-x529.google.com. [2607:f8b0:4864:20::529]) by gmr-mx.google.com with ESMTPS id c6si1599134pls.5.2019.09.13.10.31.53 for (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Fri, 13 Sep 2019 10:31:53 -0700 (PDT) Received-SPF: pass (google.com: domain of jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org designates 2607:f8b0:4864:20::529 as permitted sender) client-ip=2607:f8b0:4864:20::529; Original-Received: by mail-pg1-x529.google.com with SMTP id n4so15611427pgv.2 for ; Fri, 13 Sep 2019 10:31:53 -0700 (PDT) X-Received: by 2002:aa7:9486:: with SMTP id z6mr57201123pfk.118.1568395912577; Fri, 13 Sep 2019 10:31:52 -0700 (PDT) Original-Received: from johnmacfarlane.net (li55-134.members.linode.com. [74.82.3.134]) by smtp.gmail.com with ESMTPSA id u4sm26302920pfh.55.2019.09.13.10.31.51 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 13 Sep 2019 10:31:51 -0700 (PDT) Original-Received: by johnmacfarlane.net (Postfix, from userid 1000) id A9CBFA258; Fri, 13 Sep 2019 13:31:40 -0400 (EDT) In-Reply-To: <677959fb-29b8-4eaa-837f-c53e5ea5ab51-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org> X-Original-Sender: jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org X-Original-Authentication-Results: gmr-mx.google.com; dkim=pass header.i=@berkeley-edu.20150623.gappssmtp.com header.s=20150623 header.b=I85Xi9BB; spf=pass (google.com: domain of jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org designates 2607:f8b0:4864:20::529 as permitted sender) smtp.mailfrom=jgm-TVLZxgkOlNX2fBVCVOL8/A@public.gmane.org Precedence: list Mailing-list: list pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org; contact pandoc-discuss+owners-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org List-ID: X-Google-Group-Id: 1007024079513 List-Post: , List-Help: , List-Archive: , List-Unsubscribe: , Xref: news.gmane.org gmane.text.pandoc:23416 Archived-At: 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 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.