HomeA document that proves itself
A document that proves itself
Every PDF and web page our software makes carries a record of what it checked about that document. A PDF built with its source can be rebuilt from the PDF alone, and comes back the same, byte for byte.
The record inside the PDF, in plain words
- Nothing left out. Every word of the source reaches both the PDF and the web page. (53 words in the source, 0 lost)Passed
- Every formula is mathematics. Each formula carries MathML and spoken words; none is left as LaTeX code. (9 of 9 formulas)Passed
- The numbers are LaTeX's numbers. Every number LaTeX printed for the document is the number in the PDF and the page. (18 numbers compared)Passed
- Copies read back. Each formula's copy text reads back as the same formula. (9 formulas)Passed
- The PDF and the page agree. The same numbered things, formulas and headings in both. (6 labels, 9 of 9 formulas, 4 of 4 headings)Passed
- Same source, same bytes. A second build of the same source gives the same file, byte for byte. (built twice)Passed
Built twice, then rebuilt from itself
When this page was built, the lecture notes were built into a PDF, then built again from the same source in another folder. Then the first PDF was copied, alone, into an empty folder and rebuilt from nothing but what it carries.
First buildsha256 a9d47e54dda2304213074fb5759f62d02e7287e3cbc1d5c984472b3927b138c7
Second buildsha256 a9d47e54dda2304213074fb5759f62d02e7287e3cbc1d5c984472b3927b138c7
The two builds are the same file. The rebuild from the PDF alone came back as 71,058 bytes, byte for byte the PDF it started from, and the record worked out again was the record the PDF carried.
- 71,058bytes in the PDF of the lecture notes, its record and its source included.
- 2,118bytes of that, the record: plain text a person can read, attached to the PDF.
- 0bytes different when the PDF was rebuilt from itself.
The structure checks it records
- Every tagged part of the PDF has a standard role. (181 parts)Passed
- The document opens with a heading. (4 headings)Passed
- Headings never skip a level. (4 headings)Passed
- Lists keep their numbering. (1 list)Passed
- Every link says where it goes. (7 links)Passed
- The document has a title.Passed
- The language is declared.Passed
- The reading order is the source's order.Passed
- Tables name their header cells. No tables in this document.Nothing to check
- Figures carry descriptions. No figures in this document.Nothing to check
- Passages in another language are marked. No passages in this document.Nothing to check
- Coloured text has enough contrast. No coloured texts in this document.Nothing to check
The WCAG 2.1 criteria it speaks to
- 1.1.1 Non-text ContentPassed
- 1.3.1 Info and RelationshipsPassed
- 1.3.2 Meaningful SequencePassed
- 1.4.3 Contrast (Minimum)Passed
- 2.4.2 Page TitledPassed
- 2.4.4 Link Purpose (In Context)Passed
- 3.1.1 Language of PagePassed
- 3.1.2 Language of PartsPassed
- 4.1.2 Name, Role, ValuePassed
Each criterion stands on the checks above it: headings, roles and lists for 1.3.1, the title for 2.4.2, link names for 2.4.4, and so on.
What the record does not say
The record says what the software checked, and only that. It cannot judge whether a figure's description is good, whether a sentence is clear, or whether a document meets a law. It never uses the word compliant, and neither do we about anything a machine alone has checked.
That is why a person reviews every document Intex delivers. The record shows the reviewer what the software has already checked, so their attention can go to what only a person can judge.
A document delivered to a university carries its record but not its LaTeX, since a delivery carries no source. Its record can be read from it; a full rebuild needs the source, as with the sample on this page.
Measured on real documents
We measured the rebuild on our test list of 100 LaTeX documents of six kinds: research papers, lecture notes, problem sets and exams, slides, theses and textbooks. Of the 85 that build, built with their source, every one of the 85 PDFs rebuilt from itself to the same bytes, and in every one the record worked out again was the record it carried.
That measurement used documents built with their source, the way our test bench builds them. It is a statement about rebuilding, not about how many of those documents need no human attention: that is a separate number, and a smaller one.
The idea in a short note: rebuilt from the PDF alone. For a project of your own, the archival copy comes with all of it at Intex Institute.