A guide on how to produce accessible PDF files?












55















First: I know that this has been asked before:





  • How can tagged PDFs be created that support Universal Accessibility and reflowing? (06/2010)


  • LaTeX accessibility (05/2011)


  • Accessibility issues (10/2012)


  • Revisiting producing structured PDFs from LaTeX (06/2013)


There has been a couple of questions closed about accessibility and LaTeX since these questions.



I am also aware of Ross More's paper from 2009 and his presentation from 2010.





The question is still: Is possible to make PDF files that are accessible using LaTeX?



I understand that one can disagree on what accessible means. Different countries/regions will have different (legal) definitions. I am interested in how accessibility is understood in different countries, but for this question my main concern is the US context. Here I believe that Americans with Disabilities Act of 1990 (ADA)/Section 508 is what defines what accessible content is. More concretely, I am thinking being able to read the PDF file using a screen reader (like JAWS). Concretely the desire is to create pdf files that can be used in a class setting at a university where federal law requires that content is accessible. This is a real concern (see for example this).



The standard way to check whether a pdf file is accessible seems to to use Adobe Pro's accessibility checker. This can, for example, reveal whether a document is tagged. But it also seems like one needs to actually test it with a screen reader to make sure that everything is as desired.



Right now using pdfLaTeX and checking with Adobe Pro's accessibility checker I in general get two errors:




  • the page lacks a language specification and

  • there are no tags.


I am hoping that there has been some development over the last two years on this. Even though I use LaTeX frequently, I still consider myself a casual user. Answers in the past seem to point out that there are ways to do this, but I haven't been able to find a user friendly guide written in English. I have checked some document where text is read by a screen reader, but the problem seems to be the mathematics content.



From what I can understand it isn't possible to create a truly accessible PDF file. If this is true, I am wondering:



Question: What is the current best practice is to create accessible PDF files? Are there are user friendly guides available?



I am also aware of this answer (from 08/2014):



https://tex.stackexchange.com/a/194226/5870



Here it is pointed out in the comments that the created PDF file doesn't pass the accessibility checker in Adobe Pro. Also, one actually has to edit the .sty file that is used. (I still think it is a great answer!) Also, this file might have been created for a German context (but might still have international use?)










share|improve this question




















  • 1





    There is all accsupp. One issue I see is that stuff has been created without clear licensing or distributed in a way which undermines further unclear licensing, and never even makes it to CTAN let alone into TeX distros. A lot of work is being wasted and, in the meantime, Word documents remain the gold standard in terms of accessibility. (That's what we're advised to provide, although I don't. But if I have a student who needs it, I'll have to.)

    – cfr
    Aug 15 '15 at 21:46






  • 1





    I typically take a different approach: create (or convert to) structured content; this allows you to create a tex file with associated beautiful PDF, together with screen-reader accessible HTML/ePUB. Possible conversion tools from tex to XML include plastex

    – cmhughes
    Aug 16 '15 at 8:01











  • Yes, thanks. I'll clean up my comments.

    – cfr
    Aug 16 '15 at 16:09






  • 3





    ross moore presented a further paper on this topic at tug 2015. also, olaf drümmer talked about the standardization of pdf/ua. both talks are now on line. there is still manual adjustment needed to provide all necessary metadata.

    – barbara beeton
    Aug 16 '15 at 17:38








  • 2





    See ac­cess PDF fea­tures topic on CTAN. May be too obvious, but probably the best solution at least for a highly formated PDF is attach a plain text version that can be easily reproduced by some text-to-speech system as festival or even a script for lauch this program easily.

    – Fran
    Aug 20 '15 at 19:54


















55















First: I know that this has been asked before:





  • How can tagged PDFs be created that support Universal Accessibility and reflowing? (06/2010)


  • LaTeX accessibility (05/2011)


  • Accessibility issues (10/2012)


  • Revisiting producing structured PDFs from LaTeX (06/2013)


There has been a couple of questions closed about accessibility and LaTeX since these questions.



I am also aware of Ross More's paper from 2009 and his presentation from 2010.





The question is still: Is possible to make PDF files that are accessible using LaTeX?



I understand that one can disagree on what accessible means. Different countries/regions will have different (legal) definitions. I am interested in how accessibility is understood in different countries, but for this question my main concern is the US context. Here I believe that Americans with Disabilities Act of 1990 (ADA)/Section 508 is what defines what accessible content is. More concretely, I am thinking being able to read the PDF file using a screen reader (like JAWS). Concretely the desire is to create pdf files that can be used in a class setting at a university where federal law requires that content is accessible. This is a real concern (see for example this).



The standard way to check whether a pdf file is accessible seems to to use Adobe Pro's accessibility checker. This can, for example, reveal whether a document is tagged. But it also seems like one needs to actually test it with a screen reader to make sure that everything is as desired.



Right now using pdfLaTeX and checking with Adobe Pro's accessibility checker I in general get two errors:




  • the page lacks a language specification and

  • there are no tags.


I am hoping that there has been some development over the last two years on this. Even though I use LaTeX frequently, I still consider myself a casual user. Answers in the past seem to point out that there are ways to do this, but I haven't been able to find a user friendly guide written in English. I have checked some document where text is read by a screen reader, but the problem seems to be the mathematics content.



From what I can understand it isn't possible to create a truly accessible PDF file. If this is true, I am wondering:



Question: What is the current best practice is to create accessible PDF files? Are there are user friendly guides available?



I am also aware of this answer (from 08/2014):



https://tex.stackexchange.com/a/194226/5870



Here it is pointed out in the comments that the created PDF file doesn't pass the accessibility checker in Adobe Pro. Also, one actually has to edit the .sty file that is used. (I still think it is a great answer!) Also, this file might have been created for a German context (but might still have international use?)










share|improve this question




















  • 1





    There is all accsupp. One issue I see is that stuff has been created without clear licensing or distributed in a way which undermines further unclear licensing, and never even makes it to CTAN let alone into TeX distros. A lot of work is being wasted and, in the meantime, Word documents remain the gold standard in terms of accessibility. (That's what we're advised to provide, although I don't. But if I have a student who needs it, I'll have to.)

    – cfr
    Aug 15 '15 at 21:46






  • 1





    I typically take a different approach: create (or convert to) structured content; this allows you to create a tex file with associated beautiful PDF, together with screen-reader accessible HTML/ePUB. Possible conversion tools from tex to XML include plastex

    – cmhughes
    Aug 16 '15 at 8:01











  • Yes, thanks. I'll clean up my comments.

    – cfr
    Aug 16 '15 at 16:09






  • 3





    ross moore presented a further paper on this topic at tug 2015. also, olaf drümmer talked about the standardization of pdf/ua. both talks are now on line. there is still manual adjustment needed to provide all necessary metadata.

    – barbara beeton
    Aug 16 '15 at 17:38








  • 2





    See ac­cess PDF fea­tures topic on CTAN. May be too obvious, but probably the best solution at least for a highly formated PDF is attach a plain text version that can be easily reproduced by some text-to-speech system as festival or even a script for lauch this program easily.

    – Fran
    Aug 20 '15 at 19:54
















55












55








55


25






First: I know that this has been asked before:





  • How can tagged PDFs be created that support Universal Accessibility and reflowing? (06/2010)


  • LaTeX accessibility (05/2011)


  • Accessibility issues (10/2012)


  • Revisiting producing structured PDFs from LaTeX (06/2013)


There has been a couple of questions closed about accessibility and LaTeX since these questions.



I am also aware of Ross More's paper from 2009 and his presentation from 2010.





The question is still: Is possible to make PDF files that are accessible using LaTeX?



I understand that one can disagree on what accessible means. Different countries/regions will have different (legal) definitions. I am interested in how accessibility is understood in different countries, but for this question my main concern is the US context. Here I believe that Americans with Disabilities Act of 1990 (ADA)/Section 508 is what defines what accessible content is. More concretely, I am thinking being able to read the PDF file using a screen reader (like JAWS). Concretely the desire is to create pdf files that can be used in a class setting at a university where federal law requires that content is accessible. This is a real concern (see for example this).



The standard way to check whether a pdf file is accessible seems to to use Adobe Pro's accessibility checker. This can, for example, reveal whether a document is tagged. But it also seems like one needs to actually test it with a screen reader to make sure that everything is as desired.



Right now using pdfLaTeX and checking with Adobe Pro's accessibility checker I in general get two errors:




  • the page lacks a language specification and

  • there are no tags.


I am hoping that there has been some development over the last two years on this. Even though I use LaTeX frequently, I still consider myself a casual user. Answers in the past seem to point out that there are ways to do this, but I haven't been able to find a user friendly guide written in English. I have checked some document where text is read by a screen reader, but the problem seems to be the mathematics content.



From what I can understand it isn't possible to create a truly accessible PDF file. If this is true, I am wondering:



Question: What is the current best practice is to create accessible PDF files? Are there are user friendly guides available?



I am also aware of this answer (from 08/2014):



https://tex.stackexchange.com/a/194226/5870



Here it is pointed out in the comments that the created PDF file doesn't pass the accessibility checker in Adobe Pro. Also, one actually has to edit the .sty file that is used. (I still think it is a great answer!) Also, this file might have been created for a German context (but might still have international use?)










share|improve this question
















First: I know that this has been asked before:





  • How can tagged PDFs be created that support Universal Accessibility and reflowing? (06/2010)


  • LaTeX accessibility (05/2011)


  • Accessibility issues (10/2012)


  • Revisiting producing structured PDFs from LaTeX (06/2013)


There has been a couple of questions closed about accessibility and LaTeX since these questions.



I am also aware of Ross More's paper from 2009 and his presentation from 2010.





The question is still: Is possible to make PDF files that are accessible using LaTeX?



I understand that one can disagree on what accessible means. Different countries/regions will have different (legal) definitions. I am interested in how accessibility is understood in different countries, but for this question my main concern is the US context. Here I believe that Americans with Disabilities Act of 1990 (ADA)/Section 508 is what defines what accessible content is. More concretely, I am thinking being able to read the PDF file using a screen reader (like JAWS). Concretely the desire is to create pdf files that can be used in a class setting at a university where federal law requires that content is accessible. This is a real concern (see for example this).



The standard way to check whether a pdf file is accessible seems to to use Adobe Pro's accessibility checker. This can, for example, reveal whether a document is tagged. But it also seems like one needs to actually test it with a screen reader to make sure that everything is as desired.



Right now using pdfLaTeX and checking with Adobe Pro's accessibility checker I in general get two errors:




  • the page lacks a language specification and

  • there are no tags.


I am hoping that there has been some development over the last two years on this. Even though I use LaTeX frequently, I still consider myself a casual user. Answers in the past seem to point out that there are ways to do this, but I haven't been able to find a user friendly guide written in English. I have checked some document where text is read by a screen reader, but the problem seems to be the mathematics content.



From what I can understand it isn't possible to create a truly accessible PDF file. If this is true, I am wondering:



Question: What is the current best practice is to create accessible PDF files? Are there are user friendly guides available?



I am also aware of this answer (from 08/2014):



https://tex.stackexchange.com/a/194226/5870



Here it is pointed out in the comments that the created PDF file doesn't pass the accessibility checker in Adobe Pro. Also, one actually has to edit the .sty file that is used. (I still think it is a great answer!) Also, this file might have been created for a German context (but might still have international use?)







pdftex accessibility pdf-a tagged-pdf






share|improve this question















share|improve this question













share|improve this question




share|improve this question








edited Apr 13 '17 at 12:35









Community

1




1










asked Aug 15 '15 at 18:28









ThomasThomas

1,07031829




1,07031829








  • 1





    There is all accsupp. One issue I see is that stuff has been created without clear licensing or distributed in a way which undermines further unclear licensing, and never even makes it to CTAN let alone into TeX distros. A lot of work is being wasted and, in the meantime, Word documents remain the gold standard in terms of accessibility. (That's what we're advised to provide, although I don't. But if I have a student who needs it, I'll have to.)

    – cfr
    Aug 15 '15 at 21:46






  • 1





    I typically take a different approach: create (or convert to) structured content; this allows you to create a tex file with associated beautiful PDF, together with screen-reader accessible HTML/ePUB. Possible conversion tools from tex to XML include plastex

    – cmhughes
    Aug 16 '15 at 8:01











  • Yes, thanks. I'll clean up my comments.

    – cfr
    Aug 16 '15 at 16:09






  • 3





    ross moore presented a further paper on this topic at tug 2015. also, olaf drümmer talked about the standardization of pdf/ua. both talks are now on line. there is still manual adjustment needed to provide all necessary metadata.

    – barbara beeton
    Aug 16 '15 at 17:38








  • 2





    See ac­cess PDF fea­tures topic on CTAN. May be too obvious, but probably the best solution at least for a highly formated PDF is attach a plain text version that can be easily reproduced by some text-to-speech system as festival or even a script for lauch this program easily.

    – Fran
    Aug 20 '15 at 19:54
















  • 1





    There is all accsupp. One issue I see is that stuff has been created without clear licensing or distributed in a way which undermines further unclear licensing, and never even makes it to CTAN let alone into TeX distros. A lot of work is being wasted and, in the meantime, Word documents remain the gold standard in terms of accessibility. (That's what we're advised to provide, although I don't. But if I have a student who needs it, I'll have to.)

    – cfr
    Aug 15 '15 at 21:46






  • 1





    I typically take a different approach: create (or convert to) structured content; this allows you to create a tex file with associated beautiful PDF, together with screen-reader accessible HTML/ePUB. Possible conversion tools from tex to XML include plastex

    – cmhughes
    Aug 16 '15 at 8:01











  • Yes, thanks. I'll clean up my comments.

    – cfr
    Aug 16 '15 at 16:09






  • 3





    ross moore presented a further paper on this topic at tug 2015. also, olaf drümmer talked about the standardization of pdf/ua. both talks are now on line. there is still manual adjustment needed to provide all necessary metadata.

    – barbara beeton
    Aug 16 '15 at 17:38








  • 2





    See ac­cess PDF fea­tures topic on CTAN. May be too obvious, but probably the best solution at least for a highly formated PDF is attach a plain text version that can be easily reproduced by some text-to-speech system as festival or even a script for lauch this program easily.

    – Fran
    Aug 20 '15 at 19:54










1




1





There is all accsupp. One issue I see is that stuff has been created without clear licensing or distributed in a way which undermines further unclear licensing, and never even makes it to CTAN let alone into TeX distros. A lot of work is being wasted and, in the meantime, Word documents remain the gold standard in terms of accessibility. (That's what we're advised to provide, although I don't. But if I have a student who needs it, I'll have to.)

– cfr
Aug 15 '15 at 21:46





There is all accsupp. One issue I see is that stuff has been created without clear licensing or distributed in a way which undermines further unclear licensing, and never even makes it to CTAN let alone into TeX distros. A lot of work is being wasted and, in the meantime, Word documents remain the gold standard in terms of accessibility. (That's what we're advised to provide, although I don't. But if I have a student who needs it, I'll have to.)

– cfr
Aug 15 '15 at 21:46




1




1





I typically take a different approach: create (or convert to) structured content; this allows you to create a tex file with associated beautiful PDF, together with screen-reader accessible HTML/ePUB. Possible conversion tools from tex to XML include plastex

– cmhughes
Aug 16 '15 at 8:01





I typically take a different approach: create (or convert to) structured content; this allows you to create a tex file with associated beautiful PDF, together with screen-reader accessible HTML/ePUB. Possible conversion tools from tex to XML include plastex

– cmhughes
Aug 16 '15 at 8:01













Yes, thanks. I'll clean up my comments.

– cfr
Aug 16 '15 at 16:09





Yes, thanks. I'll clean up my comments.

– cfr
Aug 16 '15 at 16:09




3




3





ross moore presented a further paper on this topic at tug 2015. also, olaf drümmer talked about the standardization of pdf/ua. both talks are now on line. there is still manual adjustment needed to provide all necessary metadata.

– barbara beeton
Aug 16 '15 at 17:38







ross moore presented a further paper on this topic at tug 2015. also, olaf drümmer talked about the standardization of pdf/ua. both talks are now on line. there is still manual adjustment needed to provide all necessary metadata.

– barbara beeton
Aug 16 '15 at 17:38






2




2





See ac­cess PDF fea­tures topic on CTAN. May be too obvious, but probably the best solution at least for a highly formated PDF is attach a plain text version that can be easily reproduced by some text-to-speech system as festival or even a script for lauch this program easily.

– Fran
Aug 20 '15 at 19:54







See ac­cess PDF fea­tures topic on CTAN. May be too obvious, but probably the best solution at least for a highly formated PDF is attach a plain text version that can be easily reproduced by some text-to-speech system as festival or even a script for lauch this program easily.

– Fran
Aug 20 '15 at 19:54












2 Answers
2






active

oldest

votes


















11














It seems the answer was hiding in a footnote of this paper on making ADA compliant PDFs. See this project!



UPDATE: Having spent time attempting to use this tool in conjunction with a complex custom class, I want to temper expectations. While the accessibility.sty package is a useful tool for simple documents, it is incompatible with multiple packages and commands. An improved version of the package, called accessibility_meta, is available here.



Even the updated package is not perfect. For example neither work with the package "fancyhdr" nor with simple commands like "setlist".






share|improve this answer

































    3














    This answer presents what seems to me the most efficient way to improve the accessibility of LaTeX documents. Unfortunately, it requires the use of R and Adobe Acrobat. My previous approach involved using only a modified version of Babett Schaltz’s accessibility.sty. (Schaltz created it as part of her 2007 PhD thesis in Germany.) Despite making hundreds of modifications to the original .sty file, the arrival of new incompatibilities with every MikTeX update led me to switch to my current approach.



    The first step involves knitting an RMarkdown file, however adding the following commands to the header of your standard LaTeX document will allow you to follow along from step two.



    RequirePackage{accsupp}
    RequirePackage{pdfcomment}
    newcommand{AccTool}[2]{BeginAccSupp{method=pdfstringdef,unicode,Alt={{#1}}}pdftooltip{{#2}}{{#1}}EndAccSupp{}}


    Step 1: Generate TeX Output Using RMarkdown



    Click this text to access the example Rmd file, or download all of the content by clicking here. The first difference between this file and a plain Rmd is the YAML. The fontsize command does what you might expect. The keep_tex command ensures we have access to the intermediate files for step two. Finally, the header_includes command adds required LaTeX code to the header.



    fontsize: 11pt
    output:
    pdf_document:
    keep_tex: yes
    header-includes:
    - RequirePackage{accsupp}
    - RequirePackage{pdfcomment}
    - newcommand{AccTool}[2]{BeginAccSupp{method=pdfstringdef,unicode,Alt={{#1}}}pdftooltip{{#2}}{{#1}}EndAccSupp{}}


    Step 2: Make Modifications to the TeX



    This file will modify the TeX output from step one. It uses R's gsub command to add tooltips and accessibility tags to the document. One can design clever regular expressions to capture caption text for the accessibility tags. To learn regular expressions visit this website. I used a ~100-line variation of this file to add more than 1,000 tags to this 218-page document.



    The last line of the script uses the texi2pdf command to generate a PDF file.



    Step 3: Run Adobe Acrobat Scripts



    The final step requires Adobe Acrobat Pro. Open the PDF file generated in step two and perform the accessibilty actions defined in this Acrobat script. You can install the scripts by simply opening the accessibility.sequ file if Acrobat is installed. You can access the script under Tools-->Action Wizard. For those managing multiple documents, Acrobat offers simple batch processing which you can apply to the accessibility.sequ commands.



    Results



    After performing all three steps, your document will be far closer to 508 compliance than the original knitr ouput. Among the four issues remaining after processing, logical reading order and color contrast always require manual judgement, Title is fixed with two clicks, and the final Headings-Nesting rule can be skipped according to Adobe. Specifically they say, "The order of headings is not required under WCAG, and is only an advisory technique."



    accessibility checks



    Notice the figure's alternative text tooltip:
    enter image description here






    share|improve this answer

























      Your Answer








      StackExchange.ready(function() {
      var channelOptions = {
      tags: "".split(" "),
      id: "85"
      };
      initTagRenderer("".split(" "), "".split(" "), channelOptions);

      StackExchange.using("externalEditor", function() {
      // Have to fire editor after snippets, if snippets enabled
      if (StackExchange.settings.snippets.snippetsEnabled) {
      StackExchange.using("snippets", function() {
      createEditor();
      });
      }
      else {
      createEditor();
      }
      });

      function createEditor() {
      StackExchange.prepareEditor({
      heartbeatType: 'answer',
      autoActivateHeartbeat: false,
      convertImagesToLinks: false,
      noModals: true,
      showLowRepImageUploadWarning: true,
      reputationToPostImages: null,
      bindNavPrevention: true,
      postfix: "",
      imageUploader: {
      brandingHtml: "Powered by u003ca class="icon-imgur-white" href="https://imgur.com/"u003eu003c/au003e",
      contentPolicyHtml: "User contributions licensed under u003ca href="https://creativecommons.org/licenses/by-sa/3.0/"u003ecc by-sa 3.0 with attribution requiredu003c/au003e u003ca href="https://stackoverflow.com/legal/content-policy"u003e(content policy)u003c/au003e",
      allowUrls: true
      },
      onDemand: true,
      discardSelector: ".discard-answer"
      ,immediatelyShowMarkdownHelp:true
      });


      }
      });














      draft saved

      draft discarded


















      StackExchange.ready(
      function () {
      StackExchange.openid.initPostLogin('.new-post-login', 'https%3a%2f%2ftex.stackexchange.com%2fquestions%2f261537%2fa-guide-on-how-to-produce-accessible-pdf-files%23new-answer', 'question_page');
      }
      );

      Post as a guest















      Required, but never shown

























      2 Answers
      2






      active

      oldest

      votes








      2 Answers
      2






      active

      oldest

      votes









      active

      oldest

      votes






      active

      oldest

      votes









      11














      It seems the answer was hiding in a footnote of this paper on making ADA compliant PDFs. See this project!



      UPDATE: Having spent time attempting to use this tool in conjunction with a complex custom class, I want to temper expectations. While the accessibility.sty package is a useful tool for simple documents, it is incompatible with multiple packages and commands. An improved version of the package, called accessibility_meta, is available here.



      Even the updated package is not perfect. For example neither work with the package "fancyhdr" nor with simple commands like "setlist".






      share|improve this answer






























        11














        It seems the answer was hiding in a footnote of this paper on making ADA compliant PDFs. See this project!



        UPDATE: Having spent time attempting to use this tool in conjunction with a complex custom class, I want to temper expectations. While the accessibility.sty package is a useful tool for simple documents, it is incompatible with multiple packages and commands. An improved version of the package, called accessibility_meta, is available here.



        Even the updated package is not perfect. For example neither work with the package "fancyhdr" nor with simple commands like "setlist".






        share|improve this answer




























          11












          11








          11







          It seems the answer was hiding in a footnote of this paper on making ADA compliant PDFs. See this project!



          UPDATE: Having spent time attempting to use this tool in conjunction with a complex custom class, I want to temper expectations. While the accessibility.sty package is a useful tool for simple documents, it is incompatible with multiple packages and commands. An improved version of the package, called accessibility_meta, is available here.



          Even the updated package is not perfect. For example neither work with the package "fancyhdr" nor with simple commands like "setlist".






          share|improve this answer















          It seems the answer was hiding in a footnote of this paper on making ADA compliant PDFs. See this project!



          UPDATE: Having spent time attempting to use this tool in conjunction with a complex custom class, I want to temper expectations. While the accessibility.sty package is a useful tool for simple documents, it is incompatible with multiple packages and commands. An improved version of the package, called accessibility_meta, is available here.



          Even the updated package is not perfect. For example neither work with the package "fancyhdr" nor with simple commands like "setlist".







          share|improve this answer














          share|improve this answer



          share|improve this answer








          edited Oct 11 '17 at 16:53









          Liam Morland

          32




          32










          answered Mar 4 '16 at 6:05









          RTSRTS

          30126




          30126























              3














              This answer presents what seems to me the most efficient way to improve the accessibility of LaTeX documents. Unfortunately, it requires the use of R and Adobe Acrobat. My previous approach involved using only a modified version of Babett Schaltz’s accessibility.sty. (Schaltz created it as part of her 2007 PhD thesis in Germany.) Despite making hundreds of modifications to the original .sty file, the arrival of new incompatibilities with every MikTeX update led me to switch to my current approach.



              The first step involves knitting an RMarkdown file, however adding the following commands to the header of your standard LaTeX document will allow you to follow along from step two.



              RequirePackage{accsupp}
              RequirePackage{pdfcomment}
              newcommand{AccTool}[2]{BeginAccSupp{method=pdfstringdef,unicode,Alt={{#1}}}pdftooltip{{#2}}{{#1}}EndAccSupp{}}


              Step 1: Generate TeX Output Using RMarkdown



              Click this text to access the example Rmd file, or download all of the content by clicking here. The first difference between this file and a plain Rmd is the YAML. The fontsize command does what you might expect. The keep_tex command ensures we have access to the intermediate files for step two. Finally, the header_includes command adds required LaTeX code to the header.



              fontsize: 11pt
              output:
              pdf_document:
              keep_tex: yes
              header-includes:
              - RequirePackage{accsupp}
              - RequirePackage{pdfcomment}
              - newcommand{AccTool}[2]{BeginAccSupp{method=pdfstringdef,unicode,Alt={{#1}}}pdftooltip{{#2}}{{#1}}EndAccSupp{}}


              Step 2: Make Modifications to the TeX



              This file will modify the TeX output from step one. It uses R's gsub command to add tooltips and accessibility tags to the document. One can design clever regular expressions to capture caption text for the accessibility tags. To learn regular expressions visit this website. I used a ~100-line variation of this file to add more than 1,000 tags to this 218-page document.



              The last line of the script uses the texi2pdf command to generate a PDF file.



              Step 3: Run Adobe Acrobat Scripts



              The final step requires Adobe Acrobat Pro. Open the PDF file generated in step two and perform the accessibilty actions defined in this Acrobat script. You can install the scripts by simply opening the accessibility.sequ file if Acrobat is installed. You can access the script under Tools-->Action Wizard. For those managing multiple documents, Acrobat offers simple batch processing which you can apply to the accessibility.sequ commands.



              Results



              After performing all three steps, your document will be far closer to 508 compliance than the original knitr ouput. Among the four issues remaining after processing, logical reading order and color contrast always require manual judgement, Title is fixed with two clicks, and the final Headings-Nesting rule can be skipped according to Adobe. Specifically they say, "The order of headings is not required under WCAG, and is only an advisory technique."



              accessibility checks



              Notice the figure's alternative text tooltip:
              enter image description here






              share|improve this answer






























                3














                This answer presents what seems to me the most efficient way to improve the accessibility of LaTeX documents. Unfortunately, it requires the use of R and Adobe Acrobat. My previous approach involved using only a modified version of Babett Schaltz’s accessibility.sty. (Schaltz created it as part of her 2007 PhD thesis in Germany.) Despite making hundreds of modifications to the original .sty file, the arrival of new incompatibilities with every MikTeX update led me to switch to my current approach.



                The first step involves knitting an RMarkdown file, however adding the following commands to the header of your standard LaTeX document will allow you to follow along from step two.



                RequirePackage{accsupp}
                RequirePackage{pdfcomment}
                newcommand{AccTool}[2]{BeginAccSupp{method=pdfstringdef,unicode,Alt={{#1}}}pdftooltip{{#2}}{{#1}}EndAccSupp{}}


                Step 1: Generate TeX Output Using RMarkdown



                Click this text to access the example Rmd file, or download all of the content by clicking here. The first difference between this file and a plain Rmd is the YAML. The fontsize command does what you might expect. The keep_tex command ensures we have access to the intermediate files for step two. Finally, the header_includes command adds required LaTeX code to the header.



                fontsize: 11pt
                output:
                pdf_document:
                keep_tex: yes
                header-includes:
                - RequirePackage{accsupp}
                - RequirePackage{pdfcomment}
                - newcommand{AccTool}[2]{BeginAccSupp{method=pdfstringdef,unicode,Alt={{#1}}}pdftooltip{{#2}}{{#1}}EndAccSupp{}}


                Step 2: Make Modifications to the TeX



                This file will modify the TeX output from step one. It uses R's gsub command to add tooltips and accessibility tags to the document. One can design clever regular expressions to capture caption text for the accessibility tags. To learn regular expressions visit this website. I used a ~100-line variation of this file to add more than 1,000 tags to this 218-page document.



                The last line of the script uses the texi2pdf command to generate a PDF file.



                Step 3: Run Adobe Acrobat Scripts



                The final step requires Adobe Acrobat Pro. Open the PDF file generated in step two and perform the accessibilty actions defined in this Acrobat script. You can install the scripts by simply opening the accessibility.sequ file if Acrobat is installed. You can access the script under Tools-->Action Wizard. For those managing multiple documents, Acrobat offers simple batch processing which you can apply to the accessibility.sequ commands.



                Results



                After performing all three steps, your document will be far closer to 508 compliance than the original knitr ouput. Among the four issues remaining after processing, logical reading order and color contrast always require manual judgement, Title is fixed with two clicks, and the final Headings-Nesting rule can be skipped according to Adobe. Specifically they say, "The order of headings is not required under WCAG, and is only an advisory technique."



                accessibility checks



                Notice the figure's alternative text tooltip:
                enter image description here






                share|improve this answer




























                  3












                  3








                  3







                  This answer presents what seems to me the most efficient way to improve the accessibility of LaTeX documents. Unfortunately, it requires the use of R and Adobe Acrobat. My previous approach involved using only a modified version of Babett Schaltz’s accessibility.sty. (Schaltz created it as part of her 2007 PhD thesis in Germany.) Despite making hundreds of modifications to the original .sty file, the arrival of new incompatibilities with every MikTeX update led me to switch to my current approach.



                  The first step involves knitting an RMarkdown file, however adding the following commands to the header of your standard LaTeX document will allow you to follow along from step two.



                  RequirePackage{accsupp}
                  RequirePackage{pdfcomment}
                  newcommand{AccTool}[2]{BeginAccSupp{method=pdfstringdef,unicode,Alt={{#1}}}pdftooltip{{#2}}{{#1}}EndAccSupp{}}


                  Step 1: Generate TeX Output Using RMarkdown



                  Click this text to access the example Rmd file, or download all of the content by clicking here. The first difference between this file and a plain Rmd is the YAML. The fontsize command does what you might expect. The keep_tex command ensures we have access to the intermediate files for step two. Finally, the header_includes command adds required LaTeX code to the header.



                  fontsize: 11pt
                  output:
                  pdf_document:
                  keep_tex: yes
                  header-includes:
                  - RequirePackage{accsupp}
                  - RequirePackage{pdfcomment}
                  - newcommand{AccTool}[2]{BeginAccSupp{method=pdfstringdef,unicode,Alt={{#1}}}pdftooltip{{#2}}{{#1}}EndAccSupp{}}


                  Step 2: Make Modifications to the TeX



                  This file will modify the TeX output from step one. It uses R's gsub command to add tooltips and accessibility tags to the document. One can design clever regular expressions to capture caption text for the accessibility tags. To learn regular expressions visit this website. I used a ~100-line variation of this file to add more than 1,000 tags to this 218-page document.



                  The last line of the script uses the texi2pdf command to generate a PDF file.



                  Step 3: Run Adobe Acrobat Scripts



                  The final step requires Adobe Acrobat Pro. Open the PDF file generated in step two and perform the accessibilty actions defined in this Acrobat script. You can install the scripts by simply opening the accessibility.sequ file if Acrobat is installed. You can access the script under Tools-->Action Wizard. For those managing multiple documents, Acrobat offers simple batch processing which you can apply to the accessibility.sequ commands.



                  Results



                  After performing all three steps, your document will be far closer to 508 compliance than the original knitr ouput. Among the four issues remaining after processing, logical reading order and color contrast always require manual judgement, Title is fixed with two clicks, and the final Headings-Nesting rule can be skipped according to Adobe. Specifically they say, "The order of headings is not required under WCAG, and is only an advisory technique."



                  accessibility checks



                  Notice the figure's alternative text tooltip:
                  enter image description here






                  share|improve this answer















                  This answer presents what seems to me the most efficient way to improve the accessibility of LaTeX documents. Unfortunately, it requires the use of R and Adobe Acrobat. My previous approach involved using only a modified version of Babett Schaltz’s accessibility.sty. (Schaltz created it as part of her 2007 PhD thesis in Germany.) Despite making hundreds of modifications to the original .sty file, the arrival of new incompatibilities with every MikTeX update led me to switch to my current approach.



                  The first step involves knitting an RMarkdown file, however adding the following commands to the header of your standard LaTeX document will allow you to follow along from step two.



                  RequirePackage{accsupp}
                  RequirePackage{pdfcomment}
                  newcommand{AccTool}[2]{BeginAccSupp{method=pdfstringdef,unicode,Alt={{#1}}}pdftooltip{{#2}}{{#1}}EndAccSupp{}}


                  Step 1: Generate TeX Output Using RMarkdown



                  Click this text to access the example Rmd file, or download all of the content by clicking here. The first difference between this file and a plain Rmd is the YAML. The fontsize command does what you might expect. The keep_tex command ensures we have access to the intermediate files for step two. Finally, the header_includes command adds required LaTeX code to the header.



                  fontsize: 11pt
                  output:
                  pdf_document:
                  keep_tex: yes
                  header-includes:
                  - RequirePackage{accsupp}
                  - RequirePackage{pdfcomment}
                  - newcommand{AccTool}[2]{BeginAccSupp{method=pdfstringdef,unicode,Alt={{#1}}}pdftooltip{{#2}}{{#1}}EndAccSupp{}}


                  Step 2: Make Modifications to the TeX



                  This file will modify the TeX output from step one. It uses R's gsub command to add tooltips and accessibility tags to the document. One can design clever regular expressions to capture caption text for the accessibility tags. To learn regular expressions visit this website. I used a ~100-line variation of this file to add more than 1,000 tags to this 218-page document.



                  The last line of the script uses the texi2pdf command to generate a PDF file.



                  Step 3: Run Adobe Acrobat Scripts



                  The final step requires Adobe Acrobat Pro. Open the PDF file generated in step two and perform the accessibilty actions defined in this Acrobat script. You can install the scripts by simply opening the accessibility.sequ file if Acrobat is installed. You can access the script under Tools-->Action Wizard. For those managing multiple documents, Acrobat offers simple batch processing which you can apply to the accessibility.sequ commands.



                  Results



                  After performing all three steps, your document will be far closer to 508 compliance than the original knitr ouput. Among the four issues remaining after processing, logical reading order and color contrast always require manual judgement, Title is fixed with two clicks, and the final Headings-Nesting rule can be skipped according to Adobe. Specifically they say, "The order of headings is not required under WCAG, and is only an advisory technique."



                  accessibility checks



                  Notice the figure's alternative text tooltip:
                  enter image description here







                  share|improve this answer














                  share|improve this answer



                  share|improve this answer








                  edited 14 mins ago

























                  answered Apr 25 '18 at 4:22









                  RTSRTS

                  30126




                  30126






























                      draft saved

                      draft discarded




















































                      Thanks for contributing an answer to TeX - LaTeX Stack Exchange!


                      • Please be sure to answer the question. Provide details and share your research!

                      But avoid



                      • Asking for help, clarification, or responding to other answers.

                      • Making statements based on opinion; back them up with references or personal experience.


                      To learn more, see our tips on writing great answers.




                      draft saved


                      draft discarded














                      StackExchange.ready(
                      function () {
                      StackExchange.openid.initPostLogin('.new-post-login', 'https%3a%2f%2ftex.stackexchange.com%2fquestions%2f261537%2fa-guide-on-how-to-produce-accessible-pdf-files%23new-answer', 'question_page');
                      }
                      );

                      Post as a guest















                      Required, but never shown





















































                      Required, but never shown














                      Required, but never shown












                      Required, but never shown







                      Required, but never shown

































                      Required, but never shown














                      Required, but never shown












                      Required, but never shown







                      Required, but never shown







                      Popular posts from this blog

                      Accessing regular linux commands in Huawei's Dopra Linux

                      Can't connect RFCOMM socket: Host is down

                      Kernel panic - not syncing: Fatal Exception in Interrupt