Labtest: schema's en diagrammen

Vijf manieren om een schema op een pagina te zetten. Ze verschillen sterk in wat een parser ervan overhoudt, en dat verschil is precies wat hier gemeten wordt.

Dit is een testpagina van de labtest-set. Hij staat op de echte site zodat hij door dezelfde ingest loopt als gewone documentatie. Sluit hem uit bij tellingen over de kennisbank — alles onder /documentatie/labtest/ is fixture.

Mermaid-stroomschema

flowchart TD
    A[Offerte opgesteld] --> B{Akkoord klant?}
    B -->|ja| C[Project aanmaken]
    B -->|nee| D[Offerte herzien]
    D --> B
    C --> E[Uren schrijven]

Verwacht: de brontekst overleeft woordelijk en is doorzoekbaar. Dit is de gemakkelijkste van de vijf.

Inline SVG-schema

Verwacht: de losse woorden komen door, maar de VOLGORDE en de pijlen niet. De titel en de beschrijving zijn de enige plek waar de samenhang staat; verdwijnen die, dan lijkt de inhoud aanwezig terwijl het schema weg is.

Canvas

Verwacht: hier valt niets te halen — een canvas wordt door JavaScript getekend en de HTML is leeg. Dit geval hoort GEMELD te worden in het verwerkingsverslag, want een pagina met een canvas ziet er anders uit als een pagina zonder.

Schema als afbeelding

Verwacht: de beeldverrijking herkent dit als stroomschema en levert de stappen terug, bij voorkeur als mermaid.

ASCII-tekening in een codeblok

  +----------+      +---------+      +---------+
  | Offerte  | ---> | Project | ---> | Factuur |
  +----------+      +---------+      +---------+

Verwacht: de witruimte blijft staan. Wordt die weggehaald, dan is de tekening onleesbaar en blijft er een rij losse tekens over.

Proef: overleeft mermaid een renderer?

Deze paragraaf beantwoordt de vraag of de site een mermaid-renderer kan krijgen zonder de ingest te schaden. Mermaid is nu de enige diagramvorm die voor honderd procent doorkomt, juist omdat hij als BRONTEKST in de pagina staat. Een renderer vervangt die tekst door een gegenereerde svg, en svg komt bij ons maar half door.

Statisch ijkpunt, moet altijd aankomen: ZOEKMARKER-STATISCH-JZ7Q. De JavaScript-marker hieronder wordt bewust uit losse stukjes opgebouwd, zodat hij NIET letterlijk in de broncode staat — anders bewijst terugvinden alleen dat de bron is gelezen en niet dat er JavaScript is uitgevoerd.

Deze regel wordt door JavaScript aangevuld.

Het diagram hieronder is wat een renderer zou VERVANGEN:

flowchart LR
    P[ZOEKMARKER-MERMAID-PRIMAIR] --> Q[gerenderd of niet]

En dit is een tweede kopie in een gewone <pre> zonder de mermaid-klasse, die een renderer met rust zou laten:

flowchart LR
    S[ZOEKMARKER-MERMAID-SCHADUW] --> T[blijft brontekst]

Verwacht: het statische ijkpunt komt altijd aan. Verschijnt de JavaScript-marker — de regel die begint met "JavaScript heeft gedraaid" — ook in de opgehaalde tekst, dan voert onze scrape JavaScript uit — en dan zou een renderer de primaire brontekst inderdaad wegnemen. Komt de schaduwkopie in dat geval wél door, dan is "beide leveren" een werkende vorm: de lezer krijgt een tekening, de ingest houdt de tekst. Komt JavaScript niet door, dan is een renderer voor de ingest onzichtbaar en is er geen bezwaar.