Techniques for WCAG 2.0

Skip to Content (Press Enter)

-

PDF16: Setting the default language using the /Lang entry in the document catalog of a PDF document

Applicability

Tagged PDF documents

This technique relates to:

User Agent and Assistive Technology Support Notes

See PDF Technology Notes for information on user agent and assistive technology support.

Description

The objective of this technique is to specify a document's default language by setting the /Lang entry in the document catalog. This is normally accomplished using a tool for authoring PDF.

Both assistive technologies and conventional user agents can render text more accurately when the language of the document is identified. Screen readers can load the correct pronunciation rules. Visual browsers can display characters and scripts correctly. Media players can show captions correctly. As a result, users with disabilities are better able to understand the content.

Examples

Example 1: Adding a /Lang entry to specify the default document language using Adobe Acrobat 9 Pro

This example is shown with Adobe Acrobat Pro. There are other software tools that perform similar functions. See the list of other software tools in PDF Authoring Tools that Provide Accessibility Support.

  1. Open the document in Adobe Acrobat Pro

  2. From the File menu, select "Properties..."

  3. In the "Properties" dialog, select the "Advanced" tab

  4. In the "Reading Options" field, select the default language from the "Language" combo box

Specifying the default language in Adobe Acrobat's Properties dialog.

Note: Acrobat includes 16 preset language selections. If you need to specify a language that is not on the list, such as Russian, you must type the ISO 639 code for the language, not its name.

This example is shown in operation in the working example of adding a /Lang entry using Acrobat Pro.

Example 2: Specifying the default document language in a PDF document using Microsoft Word 2007

This example is shown with Microsoft Word. There are other software tools that perform similar functions. See the list of other software tools in PDF Authoring Tools that Provide Accessibility Support.

Documents authored in Microsoft Word: "In some instances, even if the document language has been specified in the source file, the information about document language is not conveyed to the PDFMaker. Setting the language for an entire document in the Document Properties dialog box [see Example 1] corrects all errors related to this option."(Adobe® Acrobat® 9 Pro Accessibility Guide: Creating Accessible PDF from Microsoft® Word)

Example 3: Specifying the default document language in a PDF document using a /Lang entry

The natural language used for text in a document is determined in a hierarchical fashion, based on whether an optional /Lang entry is present in any of several possible locations. At the highest level, the document's default language may be specified by a /Lang entry in the document catalog.

The following code fragment illustrates code that is typical for using the /Lang entry in the document catalog for a document's default language (in this case, US English). (This is typically accomplished by an authoring tool.)

 1 0 obj
   << /Type /Catalog
      ...
      /Lang (en-US)
      ...
   >> 
 endobj

Resources

Resources are for information purposes only, no endorsement implied.

Tests

Procedure

  1. Verify that the default language for the document is correctly specified by applying one of the following:

    • Read the PDF document with a screen reader, listening to hear that the text is read in the correct natural language.

    • Using a PDF editor, check that the language is set to the default document language.

    • Use a tool which is capable of showing the /Lang entry value in the document catalog to open the PDF document and view the language settings.

    • Use a tool that exposes the document through the accessibility API and verify that the language is set to the default language.

Expected Results

If this is a sufficient technique for a success criterion, failing this test procedure does not necessarily mean that the success criterion has not been satisfied in some other way, only that this technique has not been successfully implemented and can not be used to claim conformance.