En tagg beskriver vad innehållet är, inte hur det ser ut. Stor text är inte alltid en rubrik. En ruta är inte automatiskt en tabell. Namnen nedan är skiftlägeskänsliga tekniska namn. Träden i våra exempel är förklaringsmodeller, inte kod att klistra in i en PDF.
Referensen nedan är användbar först när du vet vilket innehåll taggen ska beskriva. Börja på sidan: är det en rubrik som inleder ett avsnitt, ett stycke i löptexten, en listpost eller en tabellcell? Gå därefter till strukturen och kontrollera både typen och vad objektet innehåller.
En Table med barn som alla heter P beskriver inte cellrelationer bara för att den yttersta behållaren heter tabell. En normal radstruktur behöver TR och celler med TH eller TD. På samma sätt beskriver en L inte en välformad lista om varje listpost saknar rätt placering. Behållarens namn är en del av betydelsen, medan relationerna inuti gör den användbar.
Taggträdet är inte en avbildning av sidans koordinater. Ett enda stycke kan fortsätta över en sidbrytning. En rubrik som råkar brytas på två rader är fortfarande en rubrik. Undvik att skapa nya innehållsobjekt för varje rad eller sida om det delar upp en sammanhängande tanke.
| Tagg | Användning i korthet |
|---|---|
| Document | Dokumentets samlade struktur. |
| Part, Art, Sect | Del, artikel och avsnitt. Välj efter innehållets organisation. |
| Div, NonStruct | Gruppering; använd inte för att ersätta en mer betydelsefull tagg. |
| BlockQuote | Citat som ett eget textblock. |
| Caption | Bild-, tabell- eller listtext. |
| TOC, TOCI | Innehållsförteckning och en post i den. |
| Index | Register. |
| Private | Programspecifikt privat innehåll; ingen genväg för att gömma läsarens information. |
| Tagg | Användning i korthet |
|---|---|
| P | Stycke. |
| H, H1–H6 | Rubrik. Numrerade typer anger nivån uttryckligen i PDF 1.7. |
| L, LI | Lista och listpost. |
| Lbl, LBody | Listans etikett eller nummer respektive postens innehåll. |
| Span | En del av texten utan egen särskild strukturbetydelse. |
| Quote, Note | Infogat citat respektive not. |
| Reference, BibEntry | Hänvisning respektive bibliografisk post. |
| Code | Programkod. |
Källor: [1]
| Tagg | Användning i korthet |
|---|---|
| Table, TR | Tabell och rad. |
| TH, TD | Rubrikcell och datacell. |
| THead, TBody, TFoot | Grupper av rader: huvud, kropp och fot. |
| Figure | Bild eller annan grafisk information. |
| Formula | Matematisk formel. |
| Link | Länkens struktur; även kopplingen till länkannoteringen behöver fungera. |
| Annot | Annan annotering i strukturen. |
| Form | Interaktivt formulärfält; etikett, egenskaper och tangentbordsanvändning behöver också kontrolleras. |
Ruby beskriver uttals- eller andra annotationer till bastext. Warichu används för särskilda inpass i östasiatisk typografi. De är egna textstrukturer, inte generella metoder för fotnoter.
| Tagg | Del |
|---|---|
| Ruby, RB, RT, RP | Helhet, bastext, annotationstext och avgränsande tecken. |
| Warichu, WT, WP | Helhet, text och avgränsande tecken. |
Källor: [1]
PDF 2.0 har bland annat Title, FENote, Aside, DocumentFragment, Em, Strong, Sub och strukturtypen Artifact. Numrerade rubriker kan gå över H6. Sub betyder en underindelning av ett block, inte automatiskt nedsänkt text.
Art, BlockQuote, BibEntry, Code, Index, Note, Private, Quote, Reference, TOC och TOCI ingår inte i PDF 2.0:s standardnamnrymd. Det betyder inte att de orden är förbjudna i varje PDF 2.0-fil: namnrymd och eventuell rollmappning måste bedömas. Även betydelsen av vissa gemensamma namn har ändrats.
I PDF 1.7 hanteras artefakter som särskilt markerat sidinnehåll, inte som en standardstrukturtyp i taggträdet. PDF 2.0 har också en strukturtyp som heter Artifact. Blanda inte ihop mekanismerna när du rättar eller validerar.
En faktaruta är inte automatiskt en tabell. Om rutan innehåller en rubrik och två stycken är det de betydelserna som ska beskrivas. En tabell är motiverad när läsaren behöver förstå relationer i både rader och kolumner. Använd inte Table bara för att originalprogrammet använde en tabell för layout.
Ett citat behöver skiljas från vanlig text när skillnaden bär betydelse, men ett godtyckligt kursiverat ord är inte därför ett eget citatblock. Välj också en strukturtyp som hör till rätt PDF-version och namnrymd; tabellen för PDF 1.7 kan inte tillämpas oförändrad på varje PDF 2.0-fil.
En not behöver både begripligt innehåll och en väg mellan hänvisningen och nottexten när sådan navigering behövs. Att enbart döpa om P till Note eller FENote skapar inte hela sambandet. Kontrollera också att nottexten inte avbryter huvudtexten mitt i en mening.
En Formel är ett matematiskt uttryck, inte bara en bild med ovanliga tecken. Hur den ska representeras och förmedlas beror på målstandard och verktygsstöd. En enkel uppläsbar ersättning kan vara användbar i vissa sammanhang, men ska inte beskrivas som en generell lösning för all matematik.
Källor
- Tagged PDF Best Practice Guide: SyntaxPDF Association
- Well-Tagged PDF 1.0PDF Association
- PDF10: Labels for interactive form controlsW3C
- PDF12: Name, role and value for form fieldsW3C
Exemplen är våra egna om inget annat anges. Guiderna skiljer på lagkrav, standarder och praktiska råd. En godkänd maskinkontroll räcker inte för att bedöma hela dokumentets tillgänglighet.