1.5 Other accessibility information

This is not the whole picture. There are other things to consider when creating accessible documents that is not handled by materials being in HTML. Additionally, there are other alternatives to a to HTML conversion.

1.5.1 Other considerations

  • •
    ​

    Images: Ensure that all images have quality alternative text. This is not done automatically by BookML, so you will need to add this manually. Information on how to add alt text is in the demo portion of this document (see Section 2.4), with information about images.

  • •
    ​

    Links: Ensure that all link text is accessible.

  • •
    ​

    Use of colour: Colour should not be used exclusively to communicate information. This is often missed in graphs and charts. For example, portions of a pie chart should be directly labelled, or the legend should be additionally texture-based.

1.5.2 Alternatives to BookML

If you are not strongly attached to using , then instead of using BookML, you can create course materials in accessible formats using the Markdown language. Software such as Bookdown or Quarto offer Markdown support and extended features, and allow you to produce materials in a range of formats (including PDF, HTML, computational notebooks…) directly from Markdown source.