This repository contains the content of accessible-pdf.info. The outsourced content is written in Markdown and in sync with the WordPress website.
Any markdown file needs a bit of Metadata at the beginning of the document. This metadata is necessary to push the content to the database of the website. Right after the import, the WPGHS plugin will create a new git commit containing some additional and missing metadata.
The metadata block needs the following informations:
--- post_title: Name of the Post author: Name of the author layout: tutorials published: true post_excerpt: "A short description about the issue." tags: - Microsoft Word categories: - 01. Real content tagged ---
The title describes the issue as clear and short as possible.
This is the name of the first author of the post. If another user submit changes to the post, the name of the author mustn't change. The name of the new contributor will be added to the post manually.
The layout or better the post type can be
tutorials(for troubleshooting posts)
pages(any other kind of pages like the glossary)
published defines if the post will be published directly.
The excerpt helps to quickly find out what the reader can except when reading the full article. Besides the category/archive page it will be shown on the search results page as well.
Tags help to navigate the content. The tags can describe the authoring software or the way of testing.
- Adobe InDesign
- Microsoft Word
Way of testing
- automatic testing
- manual testing
One of the main reasons for this website is the troubleshooting of PDF/UA errors and issues. Therefore the checkpoint names of the Mattherhorn Protocol will be used as categories.
- Real content tagged
- Role Mapping
- Color and Contrast
- OCR Validation
- Appropriate Tags
- Character Mappings
- Declared Natural Language
- Stretchable Characters
- Mathematical Expressions
- Page Headers and Footers
- Notes and References
- Optional Content
- Embedded Files
- Article Threads
- Digital Signatures
- Non-Interactive Forms
The metadata ID, Permalink and post_date will be added automatically.
This website is meant to be a community project. I wish contributors from all over the world will help me to build and maintain a useful reference for creating accessible PDFs.
In CONTRIBUTING.md you learn what to consider if you want to help with this project.
This work is licensed under the Creative Commons Attribution 4.0 International License.