3.4 The elephant in the room: What about LaTeX?

  • The past: Try to use tools which may or may not work and that cannot tell you, in general why something doesn’t work
  • The future? lwarp but beware of some hard work (documentation currently 1237 pages) - what happens depends on what you are doing in LaTeX and how and you have to work that out and test for accessibility for yourself.
    • It is not possible to convert LaTeX to html in the general case.
    • I’m not sure how to produce Word or EPub but it is probably possible e.g. via Pandoc
  • Easiest: Use (R)Markdown/Bookdown, incorporating LaTeX for equations and a simple markup language for the rest of the document. You will be confined to a transformable subset with will a quick compile loop. The output has known accessibility features. It is still extensible, just more reasonably so.

3.4.1 Markdown/RMarkdown/Bookdown

But, you will probably want Bookdown or more eventually:

Theorem 3.1: Bookdown is needed for things like theorems and internal references

Now go to 3.1.

3.4.2 Work in progress: Claverton Down

Added over the top of Bookdown and aimed specifically at making resources for students. * This document and the variants are produced using it.

For instance:

Thought 3.1: You can create new theorem types

Nugget 3.2: And you can have theorem types share numbering

Information about how to access and use this will be at ClavertonDown

  • At some point the name might change if it is used outside of Bath!