Accessibility

By default, the PDF documents produced using this plugin are partially accessible in the sense that most of the paragraphs, tables, lists, headers, and footers are tagged automatically so a PDF reader can use this information to present the content.

Accessibility - Built-in CSS

Accessibility properties are defined in [PLUGIN_DIR]css/print/p-accessibility.css.

How to Create Fully Accessible Documents

To make your documents fully accessible (PDF/UA1 compliant), do the following:

The accessibility standard requires that all the fonts be embedded in the PDF. To force font embedding, you have to specify fonts for all elements and for all page margin boxes in your customization CSS. For instance, you can use:

body { font-family: Arial }

*[class ~= "pr-d/codeph"], *[class ~= "pr-d/codeblock"] {
  font-family: "Courier New";
}

@page {
    @top-left {font-family: Arial }
    @top-right {font-family: Arial }
    @top-center {font-family: Arial }
    @top-left-corner {font-family: Arial }
    @top-right-corner {font-family: Arial }
    
    @bottom-left {font-family: Arial }
    @bottom-right {font-family: Arial }
    @bottom-center {font-family: Arial }
    @bottom-left-corner {font-family: Arial }
    @bottom-right-corner {font-family: Arial }
}

Create a new transformation scenario (based on the DITA Map PDF - based on HTML5 & CSS or the DITA PDF - based on HTML5 & CSS built-in scenario).
In the Parameters tab, change the value of the pdf.accessibility parameter to yes.
Run the transformation scenario.