pelinski / accessibility

A CTAN-compliant version of the LaTeX `accessibility` package

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Status

The Accessibility LaTeX package

Authors: Babett Schalitz, Andrew (Andy) Clifton

Accessibility was written as a proof-of-concept showing how to improve the structure and tagging of PDF files generated from LaTeX. These features would make PDF documents machine readable and thus enable document readers (e.g. the Adobe Acrobat series) to automatically process and present the document.

What's in this repository

This repository contains all of the files required to build and test the accessibility.sty file. It is not intended to be used directly in LaTeX.

News

What the package did

Accessibility was written as a proof-of-concept showing how to improve the structure and tagging of PDF files generated from LaTeX. These features would make PDF documents machine readable and thus enable document readers (e.g. the Adobe Acrobat series) to automatically process and present the document.

This package was predominantly targeted at documents produced using the KOMA-Script document classes.

Using the accessibility packge

accessibility should be considered broken and unusable for any application. If you want to see how it sort-of-works anyway, keep reading.

Installation

... from CTAN

You can obtain the accessibility package through CTAN. That distribution has all of the files that you might require to install accessibility on your system. I suggest installation using an appropriate package manager.

... from source (not recommended)

If you really want to download the accessibility package from here, please download the current release from releases/. You can then install it on your own system. I cannot provide any help for this. Please see the 'Tex stackexchange for more information on the installation process.

Using the package in a document

Include

\usepackage[tagged, _options_]{accessibility}

in your preamble, where options should include either highstructure or flatstructure. Compile as normal.

Checking the output

You should use a tool such as Adobe Acrobat or PAC3 to check the output. Please see the manuals for those tools for more information.

Known problems

  • Changes to the LaTeX distribution since acccessibility was first released appear to have broken the package quite comprehensively. It is no longer recommended for use at all.
  • acccessibility fails when sections cross page boundaries
  • acccessibility was designed for KOMA-script documents.

See the issue tracker for more.

Support, bugs, errors, and feedback

This package was experimental and is no longer maintained.

This style file might or might not work. The PDF output might be junk. Or you might have a document that needs something more. You might also have a suggestion on how to fix something.

Please report all problems and ideas to the accessibility package issue tracker on Github. Please provide a minimum working example.

History

The package was originally created as part of a diploma thesis by Babett Schalitz in 2007. The thesis was called 'Accessibility-Erhöhung von LATEX-Dokumenten'. More information can be found at her home page.

Andy Clifton took on maintenance of the package in May 2019 with permission and support from Babett Schalitz. Babett provided copies of the original files from 2007, not all of which were available online before. Those files can be found in the source/v1 directory and as release v0.2.

My immediate goal was to get accessibility on to CTAN. It is now available there and as of November 2019 it is included in the TEXLive and MIKTEX distributions.

Several changes were required to the source code to make it CTAN compliant. The updated source code for accessibility can be found in source/v2 directory. More information can also be found in that directory.

Cooperation and Collaboration

Now that the licensing for this package is clearly defined, I hope people will consider collaborating on maintaining and improving the package. If you are interested, please just get on and do whatever, or raise an issue to discuss.

Licence

This material is subject to the LaTeX Project Public License.

About

A CTAN-compliant version of the LaTeX `accessibility` package


Languages

Language:TeX 54.4%Language:HTML 43.9%Language:CSS 1.2%Language:Shell 0.5%