HomeNotes

Notes

Short notes, each about one effect or one fact you can check, with a real example made by our software. Follow them with the Atom feed.

  • Why a formula copied from a LaTeX PDF falls apart

    A PDF is a page of glyphs at positions. Copy a formula out of one made by pdflatex and the pieces arrive in the order they sit on the page. A real example, taken when this site was built.

  • A reading needs its closing words

    Why a screen reader says "end root" after "the square root of x plus 1", and why that short phrase carries the whole meaning of the formula.

  • What a copied formula should paste as

    A formula copied out of a PDF should paste as one line that a person can read and software can read back. The conventions our copy text follows, with real examples.

  • Rebuilt from the PDF alone

    A PDF that carries its source and a record of its checks can be rebuilt from nothing but itself. When this site was built, ours came back the same, byte for byte.

  • A theorem number is a promise

    When a lecture says Theorem 2.1, the PDF and the web page must say Theorem 2.1 too. How the numbers are kept, and checked against the numbers LaTeX itself printed.

  • A formula on a web page should be text

    A picture of a formula blurs when zoomed, copies as a picture and says nothing to a screen reader unless someone describes it. MathML is text: it scales, copies and speaks.

  • How a matrix is read aloud

    A matrix is a grid, and a listener needs its shape before its entries. How our documents read a 2 by 2 matrix aloud, and how it pastes.

  • Slides are documents too

    A Beamer deck is often the only written record of a lecture. As a web page it becomes a document with a heading for each frame, and a frame that builds up step by step appears once, complete.

  • Problem sets keep their parts

    Question 1(b) has to stay 1(b). A problem set's parts come through as lists inside lists, with their printed labels, so students can cite them and screen readers can count them.

  • What a machine check cannot say

    Software can check that every formula carries words and every number matches. It cannot check that a figure's description is right or a sentence is clear. Where the line falls, and who stands on the other side of it.