Artikelen

Opgeschreven, zodat het na te trekken is

Wat we geleerd hebben van documenten door een pijplijn halen, uitgeschreven in plaats van samengevat. Twee stukken staan hier; de rest staat waar het thuishoort. Op één na is alles waar deze pagina naar verwijst Engelstalig, en dat staat erbij.

Lakken zonder zorgen

Over redigeren van documenten, en waarom een zwarte balk het zwakste middel is dat u kunt kiezen. Het stuk laat twee technieken zien die elkaar aanvullen: het gegeven dat het bestand nooit haalt omdat de openbare versie het sjabloon zonder de gegevens opmaakt, en de balk die u wél tekent en die de tagging overneemt van de woorden eronder.

Dat tweede is waar het om gaat. Een balk die alleen bovenop de tekst ligt verbergt niets — de woorden staan nog in het bestand en een schermlezer leest ze voor. Een balk die de structuur meeneemt haalt de tekst weg en houdt het document navigeerbaar. Het artikel bouwt dat op in gewone taal, met zichzelf als voorbeeld.

Vier pagina's, Nederlandstalig. Het bestand is gebouwd volgens PDF/A-4f en PDF/UA-2 en de rapporten van de validator staan erbij — inclusief wat er niet gemeten is.

Download het artikel Bekijk de validatierapporten

Packaging guidelines (Engelstalig)

Voor wie LaTeX-pakketten bouwt en ze naar TeX Live wil brengen: mappenindeling, gedocumenteerde bronnen als .dtx, bundelen voor CTAN, en de versiebeheerpraktijk die een pakket uitgeefbaar houdt. Geschreven voor Xerdi's Documentation Project en toepasbaar op elk pakket.

Het is één bron die zowel een pagina als een PDF oplevert, dus de versie die u leest en de versie die u archiveert kunnen niet uiteenlopen.

Lees de packaging guidelines Download de PDF

Gepubliceerd in TUGboat

  • Executable document templates for safe and reproducible document redaction

    TUGboat 47:2 (2026), p. 181-185

    Eén bron, twee documenten: de interne versie en een openbare waarin de gevoelige waarden uit de tekstlaag van de PDF verdwenen zijn in plaats van overheen getekend. Redactie als bouwstap, dus herhaalbaar en controleerbaar.

  • Experimental lists and titling for PDF/UA-2 conformance

    TUGboat 47:2 (2026), p. 222-226

    Lijsten en kopregels zijn waar tagging breekt: enumitem en titlesec gingen langs de tagging-interfaces van LaTeX heen, waardoor PDF/UA-2 buiten bereik lag voor een pakket als regulatory. Wat de kern sindsdien heeft dichtgezet, en waar nog een andere weg omheen nodig is.

  • Xerdi's Documentation Project: intertwined documents

    TUGboat 46:2 (2025), p. 277-284

    De architectuur waarop dit bedrijf gebouwd is, opgeschreven voor een publiek dat het zou merken als ze niet klopte: hoe structuur, gegevens en context uit elkaar gehouden worden zodat een document gegenereerd kan worden en toch leesbaar blijft.

  • Integrating Git information into LaTeX documents: gitinfo-lua

    TUGboat 45:3 (2024), p. 354-356

    Een document dat kan zeggen uit welke commit het gebouwd is. Het pakket staat op CTAN en is wat de versie in de voetnoot van een handleiding zet.

  • Specifying and populating documents in YAML with lua-placeholders

    TUGboat 45:1 (2024), p. 65-76

    De scheiding tussen recept en gegevens: een schema voor wat een document verwacht en een apart bestand voor wat het krijgt, zodat een sjabloon en zijn gegevens tegen elkaar te toetsen zijn in plaats van met de hand samengevoegd.

Elders gepubliceerd

  • maclotsen.com

    Eriks essays over documenttechniek, vrije software en digitale autonomie. Gepubliceerd onder zijn eigen naam in plaats van die van Xerdi, en te lezen bij de bron in plaats van hier overgenomen.

  • Pakketten op CTAN

    ctan.org/author/nijenhuis

    Zeven pakketten die Eriks naam dragen, waaronder lua-placeholders, gitinfo-lua, regulatory en comment2tex. Gepubliceerd werk met gedocumenteerde bronnen, geïnstalleerd door TeX Live en in de openbaarheid onderhouden.