From 5190215940c36518fb7a23a6cfc4ecbc1e1a8a79 Mon Sep 17 00:00:00 2001 From: pixelstrolch Date: Fri, 5 Mar 2021 22:56:16 +0100 Subject: [PATCH 01/23] Fix duplicate lead --- src/templates/basics.js | 1 - 1 file changed, 1 deletion(-) diff --git a/src/templates/basics.js b/src/templates/basics.js index 1c4a4d12..5e22929c 100644 --- a/src/templates/basics.js +++ b/src/templates/basics.js @@ -44,7 +44,6 @@ export default function PageTemplate({ data: { mdx } }) { {intl.formatMessage({ id: "article.meta.updated" })}

-

{mdx.frontmatter.description}

{mdx.body} From fa616e2e2bcf13b294993180e07bf4fa5c5ceef8 Mon Sep 17 00:00:00 2001 From: pixelstrolch Date: Sat, 6 Mar 2021 12:20:09 +0100 Subject: [PATCH 02/23] Split tables for improved overview of PDF tags --- .../overview-of-the-pdf-tags/index.de.mdx | 613 ++++++++++++++++-- .../overview-of-the-pdf-tags/index.en.mdx | 611 +++++++++++++++-- src/styles/general.css | 20 +- 3 files changed, 1143 insertions(+), 101 deletions(-) diff --git a/content/basics/general/overview-of-the-pdf-tags/index.de.mdx b/content/basics/general/overview-of-the-pdf-tags/index.de.mdx index e90fed97..333d60b9 100644 --- a/content/basics/general/overview-of-the-pdf-tags/index.de.mdx +++ b/content/basics/general/overview-of-the-pdf-tags/index.de.mdx @@ -4,7 +4,7 @@ slug: /basics/general/overview-of-the-pdf-tags lang: de-CH template: basics author: Stefan Brechbühl -date: 2020-12-07 +date: 2021-03-05 description: Diese Zusammenstellung zeigt alle verfügbaren Tags nach dem Standard PDF 1.7. Sie hilft als Nachschlagewerk um semantisch korrekte Tags zu vergeben. --- @@ -24,75 +24,588 @@ da sie für die Verwendung nicht empfohlen oder nicht relevant sind. Es liegt nahe, dass gruppierende Elemente grundsätzlich Block-Elemente und Block-Elemente grundsätzlich Inline-Elemente enthalten. Der Standard gibt nicht immer klar vor, welche Konstellationen möglich sind. Die illustrierende Elemente können als Block- oder Inline-Elemente fungieren. - -In der dritten und vierten Spalte der Übersicht werden semantisch sinnvolle Kombinationen aufgezeigt. Zwar lässt der Standard noch weitere Konstellationen zu, sie werden aber nicht als semantisch sinnvoll erachtet. Auf Vollständigkeit wird jedoch keine Gewähr gegeben. - - Praktische Anwendungsbeispiele und Informationen bietet das Dokument “Tagged PDF Best Practice Guide: Syntax” der PDF Association. +```toc +# This code block gets replaced with the TOC +from-heading: 2 +to-heading: 4 +``` + ## Gruppierende Elemente -| PDF *Tag* | Semantische Bedeutung | Mögliche und semantisch sinnvolle Elternelemente | Mögliche und semantisch sinnvolle Kindelemente | -|:--|:--|:--|:--| -| `Document` | Bildet ein komplettes Dokument ab | – | [Gruppierende Elemente](#gruppierende-elemente), [Block-Elemente](#block-elemente) | -| `Part` | Teilung eines grösseren Dokuments in kleinere, zusammengehörende Teile | `Document` | `Art`, `Sect`, `Div`, `BlockQuote`, `Caption`, `TOC`, `Index`, [Block-Elemente](#block-elemente) | -| `Art` | Inhaltsteile, die zusammen abschliessend sind, also ein Artikel oder ein Teil eines Dokuments | `Document`, `Part`, `Sect`, `Div`, `BlockQuote` | `Sect`, `Div`, `BlockQuote`, `Caption`, `TOC`, `Index`, [Block-Elemente](#block-elemente) | -| `Sect` | Gruppierte zusammenhängende Inhaltsteile, beispielsweise mehrere Absätze, die zu einer Gruppe zusammengefasst werden können | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote` | `Art`, `Sect`, `Div`, `BlockQuote`, `Caption`, `TOC`, `Index`, [Block-Elemente](#block-elemente) | -| `Div` | Generisches Gruppenelement ohne semantische Bedeutung | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote` | `Art`, `Sect`, `Div`, `BlockQuote`, `Caption`, `TOC`, `Index`, [Block-Elemente](#block-elemente) | -| `BlockQuote` | Ein oder mehrere Absätze, die von einer anderen Autorin / einem anderen Autoren stammt, also zitiert wurde | `Document`, `Part`, `Art`, `Sect`, `Div` | `Art`, `Sect`, `Div`, `Caption`, [Block-Elemente](#block-elemente) | -| `Caption` | Eine Beschriftung um beispielsweise ein Bild oder eine Tabelle zu beschreiben | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote`, `Table`, `L` | `Sect`, `Div`, `BlockQuote`, [Block-Elemente](#block-elemente) | -| `TOC` | Container für Inhaltsverzeichniseinträge. Kann entweder als flache (alle enthaltene `TOCI` auf einer Ebene) oder komplexe Hierarchie (`TOC` innerhalb eines `TOCI` als Untergruppe) angewendet werden. Kann mehrfach in einem Dokument enthalten sein, da es auch für Bilder- oder Tabellenverzeichnisse verwendet werden kann. Englisch abgekürzt für *Table of contents* | `Document`, `Part`, `Art`, `Sect`, `Div`| `TOCI` | -| `TOCI` | Eintrag innerhalb eines Inhaltsverzeichnisses (`TOC`). Englisch abgekürzt für *Table of contents item* | `TOC` | `TOC`, `P`, `Lbl`, `Reference` | -| `Index` | Container für ein Stichwortverzeichnis |`Document`, `Part`, `Art`, `Sect`, `Div` | `L` | +### `Document` + + + + + + + + + + + + + + +
Semantische BedeutungBildet ein komplettes Dokument ab
Mögliche und semantisch sinnvolle Elternelemente–
Mögliche und semantisch sinnvolle KindelementeGruppierende Elemente, Block-Elemente
+ +### `Part` + + + + + + + + + + + + + + +
Semantische BedeutungTeilung eines grösseren Dokuments in kleinere, zusammengehörende Teile
Mögliche und semantisch sinnvolle ElternelementeDocument
Mögliche und semantisch sinnvolle KindelementeArt, Sect, Div, BlockQuote, Caption, TOC, Index, Block-Elemente
+ + +### `Art` + + + + + + + + + + + + + + +
Semantische BedeutungInhaltsteile, die zusammen abschliessend sind, also ein Artikel oder ein Teil eines Dokuments
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Sect, Div, BlockQuote
Mögliche und semantisch sinnvolle KindelementeSect, Div, BlockQuote, Caption, TOC, Index, Block-Elemente
+ +### `Sect` + + + + + + + + + + + + + + +
Semantische BedeutungGruppierte zusammenhängende Inhaltsteile, beispielsweise mehrere Absätze, die zu einer Gruppe zusammengefasst werden können
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote
Mögliche und semantisch sinnvolle KindelementeArt, Sect, Div, BlockQuote, Caption, TOC, Index, Block-Elemente
+ +### `Div` + + + + + + + + + + + + + + +
Semantische BedeutungGenerisches Gruppenelement ohne semantische Bedeutung
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote
Mögliche und semantisch sinnvolle KindelementeArt, Sect, Div, BlockQuote, Caption, TOC, Index, Block-Elemente
+ +### `BlockQuote` + + + + + + + + + + + + + + +
Semantische BedeutungEin oder mehrere Absätze, die von einer anderen Autorin / einem anderen Autoren stammt, also zitiert wurde
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div
Mögliche und semantisch sinnvolle KindelementeArt, Sect, Div, Caption, Block-Elemente
+ +### `Caption` + + + + + + + + + + + + + + +
Semantische BedeutungEine Beschriftung um beispielsweise ein Bild oder eine Tabelle zu beschreiben
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote, Table, L
Mögliche und semantisch sinnvolle KindelementeSect, Div, BlockQuote, Block-Elemente
+ +### `TOC` + + + + + + + + + + + + + + +
Semantische BedeutungContainer für Inhaltsverzeichniseinträge. Kann entweder als flache (alle enthaltene
Mögliche und semantisch sinnvolle ElternelementeTOCI auf einer Ebene) oder komplexe Hierarchie (TOC innerhalb eines TOCI als Untergruppe) angewendet werden. Kann mehrfach in einem Dokument enthalten sein, da es auch für Bilder- oder Tabellenverzeichnisse verwendet werden kann. Englisch abgekürzt für „Table of contents“
Mögliche und semantisch sinnvolle KindelementeDocument, Part, Art, Sect, Div| TOCI
+ +### `TOCI` + + + + + + + + + + + + + + +
Semantische BedeutungEintrag innerhalb eines Inhaltsverzeichnisses (TOC). Englisch abgekürzt für „Table of contents item“
Mögliche und semantisch sinnvolle ElternelementeTOC
Mögliche und semantisch sinnvolle KindelementeTOC, P, Lbl, Reference
+ +### `Index` + + + + + + + + + + + + + + +
Semantische BedeutungContainer für ein Stichwortverzeichnis
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div
Mögliche und semantisch sinnvolle KindelementeL
## Block-Elemente ### Absatzelemente -| PDF *Tag* | Semantische Bedeutung | Mögliche und semantisch sinnvolle Elternelemente | Mögliche und semantisch sinnvolle Kindelemente | -|:--|:--|:--|:--| -| `P` | Gewöhnlicher Absatz; Englisch abgekürzt für *Paragraph* | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote`, `Caption`, `TOCI` | [Inline-Elemente](#inline-elemente) | -| `H1`, `H2`, `H3`, `H4`, `H5`, `H6` | Hierarchische Überschriften der Ebene 1 bis 6; H ist die englisch Abkürzung für *Heading* | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote` | [Inline-Elemente](#inline-elemente) | +#### `P` + + + + + + + + + + + + + + +
Semantische BedeutungGewöhnlicher Absatz; Englisch abgekürzt für „Paragraph“
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote, Caption, TOCI
Mögliche und semantisch sinnvolle KindelementeInline-Elemente
+ +#### `H1`, `H2`, `H3`, `H4`, `H5`, `H6` + + + + + + + + + + + + + + +
Semantische BedeutungHierarchische Überschriften der Ebene 1 bis 6; H ist die englisch Abkürzung für „Heading“
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote
Mögliche und semantisch sinnvolle KindelementeInline-Elemente
### Listenelemente -| PDF *Tag* | Semantische Bedeutung | Mögliche und semantisch sinnvolle Elternelemente | Mögliche und semantisch sinnvolle Kindelemente | -|:--|:--|:--|:--| -| `L` | Listencontainer; fasst alle zusammengehörigen Listenelemente zusammen | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote`, `Index` | `LI`, `Caption` | -| `LI` | Container eines Listeneintrags; Kann ein `L` enthalten um mehrstufige Listen zu erstellen | `L` | `Lbl`, `LBody`, `L` | -| `Lbl` | Kommt vom englischen Begriff „Label“ und steht innerhalb einer Liste für die Nummerierung oder das Aufzählungszeichen. *Ist eigentlich kein Blockelement und kann auch in anderen Elementen wie z.B. `TOCI` oder `Caption` verwendet werden.* | `LI` | – | -| `LBody` | Enthält den Inhalt eines Listeneintrags | `LI` | [Inline-Elemente](#inline-elemente) | +#### `L` + + + + + + + + + + + + + + +
Semantische BedeutungListencontainer; fasst alle zusammengehörigen Listenelemente zusammen
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote, Index
Mögliche und semantisch sinnvolle KindelementeLI, Caption
+ +#### `LI` + + + + + + + + + + + + + + +
Semantische BedeutungContainer eines Listeneintrags; Kann ein L enthalten um mehrstufige Listen zu erstellen
Mögliche und semantisch sinnvolle ElternelementeL
Mögliche und semantisch sinnvolle KindelementeLbl, LBody, L
+ +#### `Lbl` + + + + + + + + + + + + + + +
Semantische BedeutungKommt vom englischen Begriff „Label“ und steht innerhalb einer Liste für die Nummerierung oder das Aufzählungszeichen. Ist eigentlich kein Blockelement und kann auch in anderen Elementen wie z.B. TOCI oder Caption verwendet werden.
Mögliche und semantisch sinnvolle ElternelementeLI
Mögliche und semantisch sinnvolle Kindelemente–
+ +#### `LBody` + + + + + + + + + + + + + + +
Semantische BedeutungEnthält den Inhalt eines Listeneintrags
Mögliche und semantisch sinnvolle ElternelementeLI
Mögliche und semantisch sinnvolle KindelementeInline-Elemente
### Tabellenelemente -| PDF *Tag* | Semantische Bedeutung | Mögliche und semantisch sinnvolle Elternelemente | Mögliche und semantisch sinnvolle Kindelemente | -|:--|:--|:--|:--| -| `Table` | Tabellencontainer; fasst alle zusammengehörigen Tabellennelemente zusammen | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote` | `TR`, `Caption`, `THead`, `TBody`, `TFoot` | -| `TR` | Fasst eine Tabellenzeile zusammen; englische abgekürzt für “table row” | `Table`, `THead`, `TBody`, `TFoot` | `TH`, `TD` | -| `TH` | Tabellenüberschriftszelle; beschreiben die Bedeutung entweder auf horizontaler (Zeile) oder auf vertikaler (Spalte) Ebene | `TR` | [Inline-Elemente](#inline-elemente) | -| `TD` | Gewöhnliche Tabellendatenzellen | `TR` | [Inline-Elemente](#inline-elemente) | -| `THead` | Eine Gruppe Tabellenzeilen (`TR`) um sie als Tabellenkopf zu kennzeichnen; kann optional angewendet werden | `Table` | `TR` | -| `TBody` | Eine Gruppe Tabellenzeilen (`TR`) um sie als Tabelleninhalt zu kennzeichnen; kann optional angewendet werden | `Table` | `TR` | -| `TFoot` | Eine Gruppe Tabellenzeilen (`TR`) um sie als Tabellenfusszeile (Ergebniszeile) zu kennzeichnen; kann optional angewendet werden | `Table` | `TR` | +#### `Table` + + + + + + + + + + + + + + +
Semantische BedeutungTabellencontainer; fasst alle zusammengehörigen Tabellennelemente zusammen
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote
Mögliche und semantisch sinnvolle KindelementeTR, Caption, THead, TBody, TFoot
+ +#### `TR` + + + + + + + + + + + + + + +
Semantische BedeutungFasst eine Tabellenzeile zusammen; englische abgekürzt für “table row”
Mögliche und semantisch sinnvolle ElternelementeTable, THead, TBody, TFoot
Mögliche und semantisch sinnvolle KindelementeTH, TD
+ +#### `TH` + + + + + + + + + + + + + + +
Semantische BedeutungTabellenüberschriftszelle; beschreiben die Bedeutung entweder auf horizontaler (Zeile) oder auf vertikaler (Spalte) Ebene
Mögliche und semantisch sinnvolle ElternelementeTR
Mögliche und semantisch sinnvolle KindelementeInline-Elemente
+ +#### `TD` + + + + + + + + + + + + + + +
Semantische BedeutungGewöhnliche Tabellendatenzellen
Mögliche und semantisch sinnvolle ElternelementeTR
Mögliche und semantisch sinnvolle KindelementeInline-Elemente
+ +#### `THead` + + + + + + + + + + + + + + +
Semantische BedeutungEine Gruppe Tabellenzeilen (TR) um sie als Tabellenkopf zu kennzeichnen; kann optional angewendet werden
Mögliche und semantisch sinnvolle ElternelementeTable
Mögliche und semantisch sinnvolle KindelementeTR
+ +#### `TBody` + + + + + + + + + + + + + + +
Semantische BedeutungEine Gruppe Tabellenzeilen (TR) um sie als Tabelleninhalt zu kennzeichnen; kann optional angewendet werden
Mögliche und semantisch sinnvolle ElternelementeTable
Mögliche und semantisch sinnvolle KindelementeTR
+ +#### `TFoot` + + + + + + + + + + + + + + +
Semantische BedeutungEine Gruppe Tabellenzeilen (TR) um sie als Tabellenfusszeile (Ergebniszeile) zu kennzeichnen; kann optional angewendet werden
Mögliche und semantisch sinnvolle ElternelementeTable
Mögliche und semantisch sinnvolle KindelementeTR
## Inline-Elemente -| PDF *Tag* | Semantische Bedeutung | Mögliche und semantisch sinnvolle Elternelemente | Mögliche und semantisch sinnvolle Kindelemente | -|:--|:--|:--|:--| -| `Span` | Generischer Container ohne semantische Bedeutung; wird unter anderem für visuelle Auszeichnungen, Sprachenwechsel oder zum Hinzufügen von ActualText (z.B. zum Ignorieren von Trennstrichen) verwendet | `P`, `H1`–`H6`, `LBody`, `TD`, `Quote`, `Note` | – | -| `Quote` | Wird wie `BlockQuote` für zitierte Inhalte verwendet; `Quote` wird jedoch auf Zeilenebene verwendet | `P`, `H1`–`H6`, `LBody`, `TD` | `Span` | -| `Note` | Fuss- oder Endnotentext (nicht das Referenzzeichen im Fliesstext). Das Fuss-/Endnotenzeichen wird innerhalb von `Note` und `Reference` in einem `Lbl` platziert. | `P`, `H1`–`H6`, `LBody`, `TD` | `Lbl`, `P`, `Span` | -| `Reference` | Referenziert auf eine andere Stelle im Dokument, z.B. Fussnote oder Verzeichniseintrag | `P`, `H1`–`H6`, `LBody`, `TD` | `Lbl` | -| `Code` | Auszeichnung von Programmiersprache | `P`, `H1`–`H6`, `LBody`, `TD` | – | -| `Link` | Link auf eine Webseite oder auf eine Stelle im Dokument | `P`, `H1`–`H6`, `LBody`, `TD` | – | -| `Annot` | Anmerkungen (Annotations) die keine Verknüpfung oder Widget (Formularfeld) sind, wie Kommentaren und Videos. | `P`, `H1`–`H6`, `LBody`, `TD` | – | +### `Span` + + + + + + + + + + + + + + +
Semantische BedeutungGenerischer Container ohne semantische Bedeutung; wird unter anderem für visuelle Auszeichnungen, Sprachenwechsel oder zum Hinzufügen von ActualText (z.B. zum Ignorieren von Trennstrichen) verwendet
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD, Quote, Note
Mögliche und semantisch sinnvolle Kindelemente–
+ +### `Quote` + + + + + + + + + + + + + + +
Semantische BedeutungWird wie BlockQuote für zitierte Inhalte verwendet; Quote wird jedoch auf Zeilenebene verwendet
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle KindelementeSpan
+ +### `Note` + + + + + + + + + + + + + + +
Semantische BedeutungFuss- oder Endnotentext (nicht das Referenzzeichen im Fliesstext). Das Fuss-/Endnotenzeichen wird innerhalb von Note und Reference in einem Lbl platziert.
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle KindelementeLbl, P, Span
+ +### `Reference` + + + + + + + + + + + + + + +
Semantische BedeutungReferenziert auf eine andere Stelle im Dokument, z.B. Fussnote oder Verzeichniseintrag
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle KindelementeLbl
+ +### `Code` + + + + + + + + + + + + + + +
Semantische BedeutungAuszeichnung von Programmiersprache
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle Kindelemente–
+ +### `Link` + + + + + + + + + + + + + + +
Semantische BedeutungLink auf eine Webseite oder auf eine Stelle im Dokument
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle Kindelemente–
+ +### `Annot` + + + + + + + + + + + + + + +
Semantische BedeutungAnmerkungen (Annotations) die keine Verknüpfung oder Widget (Formularfeld) sind, wie Kommentaren und Videos.
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle Kindelemente–
## Illustrative Elemente -| PDF *Tag* | Semantische Bedeutung | Mögliche und semantisch sinnvolle Elternelemente | Mögliche und semantisch sinnvolle Kindelemente | -|:--|:--|:--|:--| -| `Figure` | Foto oder Grafik | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote`, `P`, `LBody`, `TD` | – | -| `Formula` | Mathematische Formel | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote`, `P`, `H1`–`H6`, `LBody`, `TD` | – | -| `Form` | Formularelement | `Document`, `Part`, `Art`, `Sect`, `Div`, `P`, `TD` | – | \ No newline at end of file +### `Figure` + + + + + + + + + + + + + + +
Semantische BedeutungFoto oder Grafik
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote, P, LBody, TD
Mögliche und semantisch sinnvolle Kindelemente–
+ +### `Formula` + + + + + + + + + + + + + + +
Semantische BedeutungMathematische Formel
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote, P, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle Kindelemente–
+ +### `Form` + + + + + + + + + + + + + + +
Semantische BedeutungFormularelement
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, P, TD
Mögliche und semantisch sinnvolle Kindelemente–
\ No newline at end of file diff --git a/content/basics/general/overview-of-the-pdf-tags/index.en.mdx b/content/basics/general/overview-of-the-pdf-tags/index.en.mdx index f795330c..bb4191a1 100644 --- a/content/basics/general/overview-of-the-pdf-tags/index.en.mdx +++ b/content/basics/general/overview-of-the-pdf-tags/index.en.mdx @@ -4,7 +4,7 @@ slug: /basics/general/overview-of-the-pdf-tags lang: en template: basics author: Stefan Brechbühl -date: 2020-12-07 +date: 2021-03-05 description: This overview shows the most important tags from the PDF 1.7 standard. The reference helps you to choose the correct and semantic tags. --- @@ -24,75 +24,586 @@ because they are not recommended or not relevant for use. It is obvious that grouping elements basically contain block elements and block elements basically contain inline elements. The standard does not always clearly specify which constellations are possible. The illustrative elements can function as block or inline elements. - -The third and fourth columns of the overview show semantically meaningful combinations. Although the standard allows other constellations, they are not considered semantically meaningful. However, no guarantee is given for completeness. - - Practical examples and further informations can be found in the document “Tagged PDF Best Practice Guide: Syntax” of the PDF Association. +```toc +# This code block gets replaced with the TOC +from-heading: 2 +to-heading: 4 +``` + ## Grouping elements -| PDF tag | Semantic meaning | Possible and semantically meaningful parent elements | Possible and semantically meaningful child elements | -|:--|:--|:--|:--| -| `Document` | Represents a complete document | – | [Grouping elements](#grouping-elements), [Block-level structure elements](#block-level-structure-elements) | -| `Part` | Division of a larger document into smaller, associated parts | `Document` | `Art`, `Sect`, `Div`, `BlockQuote`, `Caption`, `TOC`, `Index`, [Block-level structure elements](#block-level-structure-elements) | -| `Art` | Parts of content which together are conclusive, i.e. an article or part of a document | `Document`, `Part`, `Sect`, `Div`, `BlockQuote` | `Sect`, `Div`, `BlockQuote`, `Caption`, `TOC`, `Index`, [Block-level structure elements](#block-level-structure-elements) | -| `Sect` | Grouped related content parts, for example several paragraphs, which can be combined into a group | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote` | `Art`, `Sect`, `Div`, `BlockQuote`, `Caption`, `TOC`, `Index`, [Block-level structure elements](#block-level-structure-elements) | -| `Div` | Generic group element without semantic meaning | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote` | `Art`, `Sect`, `Div`, `BlockQuote`, `Caption`, `TOC`, `Index`, [Block-level structure elements](#block-level-structure-elements) | -| `BlockQuote` | One or more paragraphs that originate from another author, in other words, that have been quoted | `Document`, `Part`, `Art`, `Sect`, `Div` | `Art`, `Sect`, `Div`, `Caption`, [Block-level structure elements](#block-level-structure-elements) | -| `Caption` | A caption to describe for example a picture or a table | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote`, `Table`, `L` | `Sect`, `Div`, `BlockQuote`, [Block-level structure elements](#block-level-structure-elements) | -| `TOC` | Container for table of contents entries. Can be used either as a flat hierarchy (all contained `TOCI` on one level) or as a complex hierarchy (`TOC` within a `TOCI` as a subgroup). Can be contained multiple times in a document, since it can also be used for image or table directories. | `Document`, `Part`, `Art`, `Sect`, `Div`| `TOCI` | -| `TOCI` | Entry within a table of contents (`TOC`). | `TOC` | `TOC`, `P`, `Lbl`, `Reference` | -| `Index` | Container for a subject index |`Document`, `Part`, `Art`, `Sect`, `Div` | `L` | +### Document + + + + + + + + + + + + + + +
Semantische BedeutungRepresents a complete document
Mögliche und semantisch sinnvolle Elternelemente–
Mögliche und semantisch sinnvolle KindelementeGrouping elements, Block-level structure elements
+ +### Part + + + + + + + + + + + + + + +
Semantische BedeutungDivision of a larger document into smaller, associated parts
Mögliche und semantisch sinnvolle ElternelementeDocument
Mögliche und semantisch sinnvolle KindelementeArt, Sect, Div, BlockQuote, Caption, TOC, Index, Block-level structure elements
+ +### Art + + + + + + + + + + + + + + +
Semantische BedeutungParts of content which together are conclusive, i.e. an article or part of a document
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Sect, Div, BlockQuote
Mögliche und semantisch sinnvolle KindelementeSect, Div, BlockQuote, Caption, TOC, Index, Block-level structure elements
+ +### Sect + + + + + + + + + + + + + + +
Semantische BedeutungGrouped related content parts, for example several paragraphs, which can be combined into a group
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote
Mögliche und semantisch sinnvolle KindelementeArt, Sect, Div, BlockQuote, Caption, TOC, Index, Block-level structure elements
+ +### Div + + + + + + + + + + + + + + +
Semantische BedeutungGeneric group element without semantic meaning
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote
Mögliche und semantisch sinnvolle KindelementeArt, Sect, Div, BlockQuote, Caption, TOC, Index, Block-level structure elements
+ +### BlockQuote + + + + + + + + + + + + + + +
Semantische BedeutungOne or more paragraphs that originate from another author, in other words, that have been quoted
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div
Mögliche und semantisch sinnvolle KindelementeArt, Sect, Div, Caption, Block-level structure elements
+ +### Caption + + + + + + + + + + + + + + +
Semantische BedeutungA caption to describe for example a picture or a table
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote, Table, L
Mögliche und semantisch sinnvolle KindelementeSect, Div, BlockQuote, Block-level structure elements
+ +### TOC + + + + + + + + + + + + + + +
Semantische BedeutungContainer for table of contents entries. Can be used either as a flat hierarchy (all contained TOCI on one level) or as a complex hierarchy (TOC within a TOCI as a subgroup). Can be contained multiple times in a document, since it can also be used for image or table directories.
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div
Mögliche und semantisch sinnvolle KindelementeTOCI
+ +### TOCI + + + + + + + + + + + + + + +
Semantische BedeutungEntry within a table of contents (TOC).
Mögliche und semantisch sinnvolle ElternelementeTOC
Mögliche und semantisch sinnvolle KindelementeTOC, P, Lbl, Reference
+ +### Index + + + + + + + + + + + + + + +
Semantische BedeutungContainer for a subject index
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div
Mögliche und semantisch sinnvolle KindelementeL
## Block-level structure elements ### Paragraph elements -| PDF tag | Semantic meaning | Possible and semantically meaningful parent elements | Possible and semantically meaningful child elements | -|:--|:--|:--|:--| -| `P` | Ordinary paragraph | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote`, `Caption`, `TOCI` | [Inline-level structure elements](#inline-level-structure-elements) | -| `H1`, `H2`, `H3`, `H4`, `H5`, `H6` | Hierarchical headings on levels 1 to 6 | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote` | [Inline-level structure elements](#inline-level-structure-elements) | +#### P + + + + + + + + + + + + + + +
Semantische BedeutungOrdinary paragraph
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote, Caption, TOCI
Mögliche und semantisch sinnvolle KindelementeInline-level structure elements
+ +#### H1, H2, H3, H4, H5, H6 + + + + + + + + + + + + + + +
Semantische BedeutungHierarchical headings on levels 1 to 6
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote
Mögliche und semantisch sinnvolle KindelementeInline-level structure elements
### List elements -| PDF tag | Semantic meaning | Possible and semantically meaningful parent elements | Possible and semantically meaningful child elements | -|:--|:--|:--|:--| -| `L` | List container; groups together all list elements that belong together | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote`, `Index` | `LI`, `Caption` | -| `LI` | Container of a list entry; can contain an `L` to create multi-level lists | `L` | `Lbl`, `LBody`, `L` | -| `Lbl` | Comes from the term “label” and represents the numbering or bullet character within a list. *It’s not actually a block-level structure element and can also be used in other elements such as `TOCI` or `Caption`.* | `LI` | – | -| `LBody` | Contains the contents of a list entry | `LI` | [Inline-level structure elements](#inline-level-structure-elements) | +#### L + + + + + + + + + + + + + + +
Semantische BedeutungList container; groups together all list elements that belong together
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote, Index
Mögliche und semantisch sinnvolle KindelementeLI, Caption
+ +#### LI + + + + + + + + + + + + + + +
Semantische BedeutungContainer of a list entry; can contain an L to create multi-level lists
Mögliche und semantisch sinnvolle ElternelementeL
Mögliche und semantisch sinnvolle KindelementeLbl, LBody, L
+ +#### Lbl + + + + + + + + + + + + + + +
Semantische BedeutungComes from the term “label” and represents the numbering or bullet character within a list. It’s not actually a block-level structure element and can also be used in other elements such as TOCI or Caption.
Mögliche und semantisch sinnvolle ElternelementeLI
Mögliche und semantisch sinnvolle Kindelemente–
+ +#### LBody + + + + + + + + + + + + + + +
Semantische BedeutungContains the contents of a list entry
Mögliche und semantisch sinnvolle ElternelementeLI
Mögliche und semantisch sinnvolle KindelementeInline-level structure elements
### Tabellenelemente -| PDF tag | Semantic meaning | Possible and semantically meaningful parent elements | Possible and semantically meaningful child elements | -|:--|:--|:--|:--| -| `Table` | Table container; combines all related table elements | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote` | `TR`, `Caption`, `THead`, `TBody`, `TFoot` | -| `TR` | Groups a table row | `Table`, `THead`, `TBody`, `TFoot` | `TH`, `TD` | -| `TH` | Table heading cell; describes the meaning either at horizontal (line) or vertical (column) level | `TR` | [Inline-level structure elements](#inline-level-structure-elements) | -| `TD` | Ordinary table data cells | `TR` | [Inline-level structure elements](#inline-level-structure-elements) | -| `THead` | A group of table rows (`TR`) to mark them as table header; can be used optionally | `Table` | `TR` | -| `TBody` | A group of table rows (`TR`) to mark them as table content; can be used optionally | `Table` | `TR` | -| `TFoot` | A group of table rows (`TR`) to mark them as table footer; can be used optionally | `Table` | `TR` | +#### Table + + + + + + + + + + + + + + +
Semantische BedeutungTable container; combines all related table elements
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote
Mögliche und semantisch sinnvolle KindelementeTR, Caption, THead, TBody, TFoot
+ +#### TR + + + + + + + + + + + + + + +
Semantische BedeutungGroups a table row
Mögliche und semantisch sinnvolle ElternelementeTable, THead, TBody, TFoot
Mögliche und semantisch sinnvolle KindelementeTH, TD
+ +#### TH + + + + + + + + + + + + + + +
Semantische BedeutungTable heading cell; describes the meaning either at horizontal (line) or vertical (column) level
Mögliche und semantisch sinnvolle ElternelementeTR
Mögliche und semantisch sinnvolle KindelementeInline-level structure elements
+ +#### TD + + + + + + + + + + + + + + +
Semantische BedeutungOrdinary table data cells
Mögliche und semantisch sinnvolle ElternelementeTR
Mögliche und semantisch sinnvolle KindelementeInline-level structure elements
+ +#### THead + + + + + + + + + + + + + + +
Semantische BedeutungA group of table rows (TR) to mark them as table header; can be used optionally
Mögliche und semantisch sinnvolle ElternelementeTable
Mögliche und semantisch sinnvolle KindelementeTR
+ +#### TBody + + + + + + + + + + + + + + +
Semantische BedeutungA group of table rows (TR) to mark them as table content; can be used optionally
Mögliche und semantisch sinnvolle ElternelementeTable
Mögliche und semantisch sinnvolle KindelementeTR
+ +#### TFoot + + + + + + + + + + + + + + +
Semantische BedeutungA group of table rows (TR) to mark them as table footer; can be used optionally
Mögliche und semantisch sinnvolle ElternelementeTable
Mögliche und semantisch sinnvolle KindelementeTR
## Inline-level structure elements -| PDF tag | Semantic meaning | Possible and semantically meaningful parent elements | Possible and semantically meaningful child elements | -|:--|:--|:--|:--| -| `Span` | Generic container without semantic meaning; is used, among other things, for visual markups, language changes or for adding ActualText (e.g. for ignoring hyphens) | `P`, `H1`–`H6`, `LBody`, `TD`, `Quote`, `Note` | – | -| `Quote` | Used like `BlockQuote` for quoted content; however, `Quote` is used at line level | `P`, `H1`–`H6`, `LBody`, `TD` | `Span` | -| `Note` | Footnote or endnote text (not the reference character in the body text). The footer/end-note character within `Note` and `Reference` will be placed in a `Lbl`. | `P`, `H1`–`H6`, `LBody`, `TD` | `Lbl`, `P`, `Span` | -| `Reference` | Refers to another place in the document, e.g. footnote or directory entry | `P`, `H1`–`H6`, `LBody`, `TD` | `Lbl` | -| `Code` | Marking of programming language | `P`, `H1`–`H6`, `LBody`, `TD` | – | -| `Link` | Link to a web page or to a place within the document | `P`, `H1`–`H6`, `LBody`, `TD` | – | -| `Annot` | Annotations that are not a link or a widget (form field), like comments and videos. | `P`, `H1`–`H6`, `LBody`, `TD` | – | +### Span + + + + + + + + + + + + + + +
Semantische BedeutungGeneric container without semantic meaning; is used, among other things, for visual markups, language changes or for adding ActualText (e.g. for ignoring hyphens)
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD, Quote, Note
Mögliche und semantisch sinnvolle Kindelemente–
+ +### Quote + + + + + + + + + + + + + + +
Semantische BedeutungUsed like BlockQuote for quoted content; however, Quote is used at line level
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle KindelementeSpan
+ +### Note + + + + + + + + + + + + + + +
Semantische BedeutungFootnote or endnote text (not the reference character in the body text). The footer/end-note character within Note and Reference will be placed in a Lbl.
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle KindelementeLbl, P, Span
+ +### Reference + + + + + + + + + + + + + + +
Semantische BedeutungRefers to another place in the document, e.g. footnote or directory entry
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle KindelementeLbl
+ +### Code + + + + + + + + + + + + + + +
Semantische BedeutungMarking of programming language
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle Kindelemente–
+ +### Link + + + + + + + + + + + + + + +
Semantische BedeutungLink to a web page or to a place within the document
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle Kindelemente–
+ +### Annot + + + + + + + + + + + + + + +
Semantische BedeutungAnnotations that are not a link or a widget (form field), like comments and videos.
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle Kindelemente–
## Illustration elements -| PDF tag | Semantic meaning | Possible and semantically meaningful parent elements | Possible and semantically meaningful child elements | -|:--|:--|:--|:--| -| `Figure` | Photo or graphic | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote`, `P`, `LBody`, `TD` | – | -| `Formula` | Mathematical formula | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote`, `P`, `H1`–`H6`, `LBody`, `TD` | – | -| `Form` | Form element | `Document`, `Part`, `Art`, `Sect`, `Div`, `P`, `TD` | – | \ No newline at end of file +### Figure + + + + + + + + + + + + + + +
Semantische BedeutungPhoto or graphic
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote, P, LBody, TD
Mögliche und semantisch sinnvolle Kindelemente–
+ +### Formula + + + + + + + + + + + + + + +
Semantische BedeutungMathematical formula
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote, P, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle Kindelemente–
+ +### Form + + + + + + + + + + + + + +
Semantische BedeutungForm element
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, P, TD
Mögliche und semantisch sinnvolle Kindelemente–
\ No newline at end of file diff --git a/src/styles/general.css b/src/styles/general.css index 0238c83d..8c0a03ac 100644 --- a/src/styles/general.css +++ b/src/styles/general.css @@ -73,6 +73,23 @@ ol li { padding-left: 1rem; } +/* Table */ + +table { + border-collapse: collapse; + margin-top: 1rem; +} + +th, td { + border-top: 1px solid var(--color-gray); + border-bottom: 1px solid var(--color-gray); + vertical-align: top; +} + +.w30 { + width: 30%; +} + /* Links */ @@ -121,8 +138,9 @@ blockquote > p { /* Code */ code, kbd, tt, var { + background: var(--color-gray-bright); font-family: Consolas, Monaco, "Andale Mono", "DejaVu Sans Mono", monospace; - font-size: inherit; + font-size: .9em; } From 4085c2deaf51b88a4d0664d3f71bdbeb03b22bb6 Mon Sep 17 00:00:00 2001 From: pixelstrolch Date: Sat, 6 Mar 2021 13:15:40 +0100 Subject: [PATCH 03/23] Font as path in logo #23 --- static/images/logo_accessiblePDF.svg | 38 +++++++++++++++++++++++++++- 1 file changed, 37 insertions(+), 1 deletion(-) diff --git a/static/images/logo_accessiblePDF.svg b/static/images/logo_accessiblePDF.svg index 9adc3086..3a5b2867 100644 --- a/static/images/logo_accessiblePDF.svg +++ b/static/images/logo_accessiblePDF.svg @@ -1 +1,37 @@ -logo_accessiblePDF \ No newline at end of file + + + + + + + + From 3fb285c58e2346f31d0867f6007ab059dfc0304a Mon Sep 17 00:00:00 2001 From: pixelstrolch Date: Wed, 2 Jun 2021 07:23:44 +0200 Subject: [PATCH 04/23] Missing translations | Prettier Print Width --- .../overview-of-the-pdf-tags/index.en.mdx | 983 +++++++++++------- 1 file changed, 585 insertions(+), 398 deletions(-) diff --git a/content/basics/general/overview-of-the-pdf-tags/index.en.mdx b/content/basics/general/overview-of-the-pdf-tags/index.en.mdx index bb4191a1..2d43f89a 100644 --- a/content/basics/general/overview-of-the-pdf-tags/index.en.mdx +++ b/content/basics/general/overview-of-the-pdf-tags/index.en.mdx @@ -25,7 +25,11 @@ because they are not recommended or not relevant for use. It is obvious that grouping elements basically contain block elements and block elements basically contain inline elements. The standard does not always clearly specify which constellations are possible. The illustrative elements can function as block or inline elements. -Practical examples and further informations can be found in the document “Tagged PDF Best Practice Guide: Syntax” of the PDF Association. + Practical examples and further informations can be found in the document{" "} + + “Tagged PDF Best Practice Guide: Syntax” + {" "} + of the PDF Association. ```toc @@ -39,171 +43,240 @@ to-heading: 4 ### Document - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungRepresents a complete document
Mögliche und semantisch sinnvolle Elternelemente–
Mögliche und semantisch sinnvolle KindelementeGrouping elements, Block-level structure elements
Semantic meaningRepresents a complete document
Possible and semantically meaningful parent elements–
Possible and semantically meaningful child elements + Grouping elements,{" "} + Block-level structure elements +
### Part - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungDivision of a larger document into smaller, associated parts
Mögliche und semantisch sinnvolle ElternelementeDocument
Mögliche und semantisch sinnvolle KindelementeArt, Sect, Div, BlockQuote, Caption, TOC, Index, Block-level structure elements
Semantic meaningDivision of a larger document into smaller, associated parts
Possible and semantically meaningful parent elements + Document +
Possible and semantically meaningful child elements + Art, Sect, Div, BlockQuote,{" "} + Caption, TOC, Index,{" "} + Block-level structure elements +
### Art - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungParts of content which together are conclusive, i.e. an article or part of a document
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Sect, Div, BlockQuote
Mögliche und semantisch sinnvolle KindelementeSect, Div, BlockQuote, Caption, TOC, Index, Block-level structure elements
Semantic meaningParts of content which together are conclusive, i.e. an article or part of a document
Possible and semantically meaningful parent elements + Document, Part, Sect, Div,{" "} + BlockQuote +
Possible and semantically meaningful child elements + Sect, Div, BlockQuote, Caption,{" "} + TOC, Index,{" "} + Block-level structure elements +
### Sect - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungGrouped related content parts, for example several paragraphs, which can be combined into a group
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote
Mögliche und semantisch sinnvolle KindelementeArt, Sect, Div, BlockQuote, Caption, TOC, Index, Block-level structure elements
Semantic meaning + Grouped related content parts, for example several paragraphs, which can be combined into a + group +
Possible and semantically meaningful parent elements + Document, Part, Art, Sect,{" "} + Div, BlockQuote +
Possible and semantically meaningful child elements + Art, Sect, Div, BlockQuote,{" "} + Caption, TOC, Index,{" "} + Block-level structure elements +
### Div - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungGeneric group element without semantic meaning
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote
Mögliche und semantisch sinnvolle KindelementeArt, Sect, Div, BlockQuote, Caption, TOC, Index, Block-level structure elements
Semantic meaningGeneric group element without semantic meaning
Possible and semantically meaningful parent elements + Document, Part, Art, Sect,{" "} + Div, BlockQuote +
Possible and semantically meaningful child elements + Art, Sect, Div, BlockQuote,{" "} + Caption, TOC, Index,{" "} + Block-level structure elements +
### BlockQuote - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungOne or more paragraphs that originate from another author, in other words, that have been quoted
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div
Mögliche und semantisch sinnvolle KindelementeArt, Sect, Div, Caption, Block-level structure elements
Semantic meaning + One or more paragraphs that originate from another author, in other words, that have been + quoted +
Possible and semantically meaningful parent elements + Document, Part, Art, Sect,{" "} + Div +
Possible and semantically meaningful child elements + Art, Sect, Div, Caption,{" "} + Block-level structure elements +
### Caption - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungA caption to describe for example a picture or a table
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote, Table, L
Mögliche und semantisch sinnvolle KindelementeSect, Div, BlockQuote, Block-level structure elements
Semantic meaningA caption to describe for example a picture or a table
Possible and semantically meaningful parent elements + Document, Part, Art, Sect,{" "} + Div, BlockQuote, Table, L +
Possible and semantically meaningful child elements + Sect, Div, BlockQuote,{" "} + Block-level structure elements +
### TOC - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungContainer for table of contents entries. Can be used either as a flat hierarchy (all contained TOCI on one level) or as a complex hierarchy (TOC within a TOCI as a subgroup). Can be contained multiple times in a document, since it can also be used for image or table directories.
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div
Mögliche und semantisch sinnvolle KindelementeTOCI
Semantic meaning + Container for table of contents entries. Can be used either as a flat hierarchy (all contained{" "} + TOCI on one level) or as a complex hierarchy (TOC within a{" "} + TOCI as a subgroup). Can be contained multiple times in a document, since it can + also be used for image or table directories. +
Possible and semantically meaningful parent elements + Document, Part, Art, Sect,{" "} + Div +
Possible and semantically meaningful child elements + TOCI +
### TOCI - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungEntry within a table of contents (TOC).
Mögliche und semantisch sinnvolle ElternelementeTOC
Mögliche und semantisch sinnvolle KindelementeTOC, P, Lbl, Reference
Semantic meaning + Entry within a table of contents (TOC). +
Possible and semantically meaningful parent elements + TOC +
Possible and semantically meaningful child elements + TOC, P, Lbl, Reference +
### Index - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungContainer for a subject index
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div
Mögliche und semantisch sinnvolle KindelementeL
Semantic meaningContainer for a subject index
Possible and semantically meaningful parent elements + Document, Part, Art, Sect,{" "} + Div +
Possible and semantically meaningful child elements + L +
## Block-level structure elements @@ -213,35 +286,45 @@ to-heading: 4 #### P - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungOrdinary paragraph
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote, Caption, TOCI
Mögliche und semantisch sinnvolle KindelementeInline-level structure elements
Semantic meaningOrdinary paragraph
Possible and semantically meaningful parent elements + Document, Part, Art, Sect,{" "} + Div, BlockQuote, Caption, TOCI +
Possible and semantically meaningful child elements + Inline-level structure elements +
#### H1, H2, H3, H4, H5, H6 - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungHierarchical headings on levels 1 to 6
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote
Mögliche und semantisch sinnvolle KindelementeInline-level structure elements
Semantic meaningHierarchical headings on levels 1 to 6
Possible and semantically meaningful parent elements + Document, Part, Art, Sect,{" "} + Div, BlockQuote +
Possible and semantically meaningful child elements + Inline-level structure elements +
### List elements @@ -249,69 +332,92 @@ to-heading: 4 #### L - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungList container; groups together all list elements that belong together
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote, Index
Mögliche und semantisch sinnvolle KindelementeLI, Caption
Semantic meaningList container; groups together all list elements that belong together
Possible and semantically meaningful parent elements + Document, Part, Art, Sect,{" "} + Div, BlockQuote, Index +
Possible and semantically meaningful child elements + LI, Caption +
#### LI - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungContainer of a list entry; can contain an L to create multi-level lists
Mögliche und semantisch sinnvolle ElternelementeL
Mögliche und semantisch sinnvolle KindelementeLbl, LBody, L
Semantic meaning + Container of a list entry; can contain an L to create multi-level lists +
Possible and semantically meaningful parent elements + L +
Possible and semantically meaningful child elements + Lbl, LBody, L +
#### Lbl - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungComes from the term “label” and represents the numbering or bullet character within a list. It’s not actually a block-level structure element and can also be used in other elements such as TOCI or Caption.
Mögliche und semantisch sinnvolle ElternelementeLI
Mögliche und semantisch sinnvolle Kindelemente–
Semantic meaning + Comes from the term “label” and represents the numbering or bullet character within a list.{" "} + + It’s not actually a block-level structure element and can also be used in other elements + such as TOCI or Caption. + +
Possible and semantically meaningful parent elements + LI +
Possible and semantically meaningful child elements–
#### LBody - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungContains the contents of a list entry
Mögliche und semantisch sinnvolle ElternelementeLI
Mögliche und semantisch sinnvolle KindelementeInline-level structure elements
Semantic meaningContains the contents of a list entry
Possible and semantically meaningful parent elements + LI +
Possible and semantically meaningful child elements + Inline-level structure elements +
### Tabellenelemente @@ -319,120 +425,159 @@ to-heading: 4 #### Table - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungTable container; combines all related table elements
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote
Mögliche und semantisch sinnvolle KindelementeTR, Caption, THead, TBody, TFoot
Semantic meaningTable container; combines all related table elements
Possible and semantically meaningful parent elements + Document, Part, Art, Sect,{" "} + Div, BlockQuote +
Possible and semantically meaningful child elements + TR, Caption, THead, TBody,{" "} + TFoot +
#### TR - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungGroups a table row
Mögliche und semantisch sinnvolle ElternelementeTable, THead, TBody, TFoot
Mögliche und semantisch sinnvolle KindelementeTH, TD
Semantic meaningGroups a table row
Possible and semantically meaningful parent elements + Table, THead, TBody, TFoot +
Possible and semantically meaningful child elements + TH, TD +
#### TH - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungTable heading cell; describes the meaning either at horizontal (line) or vertical (column) level
Mögliche und semantisch sinnvolle ElternelementeTR
Mögliche und semantisch sinnvolle KindelementeInline-level structure elements
Semantic meaning + Table heading cell; describes the meaning either at horizontal (line) or vertical (column) + level +
Possible and semantically meaningful parent elements + TR +
Possible and semantically meaningful child elements + Inline-level structure elements +
#### TD - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungOrdinary table data cells
Mögliche und semantisch sinnvolle ElternelementeTR
Mögliche und semantisch sinnvolle KindelementeInline-level structure elements
Semantic meaningOrdinary table data cells
Possible and semantically meaningful parent elements + TR +
Possible and semantically meaningful child elements + Inline-level structure elements +
#### THead - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungA group of table rows (TR) to mark them as table header; can be used optionally
Mögliche und semantisch sinnvolle ElternelementeTable
Mögliche und semantisch sinnvolle KindelementeTR
Semantic meaning + A group of table rows (TR) to mark them as table header; can be used optionally +
Possible and semantically meaningful parent elements + Table +
Possible and semantically meaningful child elements + TR +
#### TBody - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungA group of table rows (TR) to mark them as table content; can be used optionally
Mögliche und semantisch sinnvolle ElternelementeTable
Mögliche und semantisch sinnvolle KindelementeTR
Semantic meaning + A group of table rows (TR) to mark them as table content; can be used optionally +
Possible and semantically meaningful parent elements + Table +
Possible and semantically meaningful child elements + TR +
#### TFoot - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungA group of table rows (TR) to mark them as table footer; can be used optionally
Mögliche und semantisch sinnvolle ElternelementeTable
Mögliche und semantisch sinnvolle KindelementeTR
Semantic meaning + A group of table rows (TR) to mark them as table footer; can be used optionally +
Possible and semantically meaningful parent elements + Table +
Possible and semantically meaningful child elements + TR +
## Inline-level structure elements @@ -440,120 +585,151 @@ to-heading: 4 ### Span - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungGeneric container without semantic meaning; is used, among other things, for visual markups, language changes or for adding ActualText (e.g. for ignoring hyphens)
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD, Quote, Note
Mögliche und semantisch sinnvolle Kindelemente–
Semantic meaning + Generic container without semantic meaning; is used, among other things, for visual markups, + language changes or for adding ActualText (e.g. for ignoring hyphens) +
Possible and semantically meaningful parent elements + P, H1–H6, LBody, TD,{" "} + Quote, Note +
Possible and semantically meaningful child elements–
### Quote - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungUsed like BlockQuote for quoted content; however, Quote is used at line level
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle KindelementeSpan
Semantic meaning + Used like BlockQuote for quoted content; however, Quote is used at + line level +
Possible and semantically meaningful parent elements + P, H1–H6, LBody, TD +
Possible and semantically meaningful child elements + Span +
### Note - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungFootnote or endnote text (not the reference character in the body text). The footer/end-note character within Note and Reference will be placed in a Lbl.
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle KindelementeLbl, P, Span
Semantic meaning + Footnote or endnote text (not the reference character in the body text). The footer/end-note + character within Note and Reference will be placed in a{" "} + Lbl. +
Possible and semantically meaningful parent elements + P, H1–H6, LBody, TD +
Possible and semantically meaningful child elements + Lbl, P, Span +
### Reference - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungRefers to another place in the document, e.g. footnote or directory entry
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle KindelementeLbl
Semantic meaningRefers to another place in the document, e.g. footnote or directory entry
Possible and semantically meaningful parent elements + P, H1–H6, LBody, TD +
Possible and semantically meaningful child elements + Lbl +
### Code - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungMarking of programming language
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle Kindelemente–
Semantic meaningMarking of programming language
Possible and semantically meaningful parent elements + P, H1–H6, LBody, TD +
Possible and semantically meaningful child elements–
### Link - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungLink to a web page or to a place within the document
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle Kindelemente–
Semantic meaningLink to a web page or to a place within the document
Possible and semantically meaningful parent elements + P, H1–H6, LBody, TD +
Possible and semantically meaningful child elements–
### Annot - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungAnnotations that are not a link or a widget (form field), like comments and videos.
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle Kindelemente–
Semantic meaningAnnotations that are not a link or a widget (form field), like comments and videos.
Possible and semantically meaningful parent elements + P, H1–H6, LBody, TD +
Possible and semantically meaningful child elements–
## Illustration elements @@ -561,49 +737,60 @@ to-heading: 4 ### Figure - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungPhoto or graphic
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote, P, LBody, TD
Mögliche und semantisch sinnvolle Kindelemente–
Semantic meaningPhoto or graphic
Possible and semantically meaningful parent elements + Document, Part, Art, Sect,{" "} + Div, BlockQuote, P, LBody, TD +
Possible and semantically meaningful child elements–
### Formula - - - - - - - - - - - - + + + + + + + + + + + +
Semantische BedeutungMathematical formula
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote, P, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle Kindelemente–
Semantic meaningMathematical formula
Possible and semantically meaningful parent elements + Document, Part, Art, Sect,{" "} + Div, BlockQuote, P, H1–H6,{" "} + LBody, TD +
Possible and semantically meaningful child elements–
### Form + - - - - - - - - - - - - -
Semantische BedeutungForm element
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, P, TD
Mögliche und semantisch sinnvolle Kindelemente–
\ No newline at end of file + + Semantic meaning + Form element + + + Possible and semantically meaningful parent elements + + Document, Part, Art, Sect,{" "} + Div, P, TD + + + + Possible and semantically meaningful child elements + – + + From bda5f87fcd21963d309d69b2a02f7207182fcd4f Mon Sep 17 00:00:00 2001 From: pixelstrolch Date: Wed, 2 Jun 2021 21:44:52 +0200 Subject: [PATCH 05/23] Prettier updates --- src/components/buymeacoffee.module.css | 2 +- src/components/footer.module.css | 2 +- src/components/footernav.module.css | 6 ++-- src/components/header.module.css | 4 +-- src/components/layout.module.css | 6 ++-- src/components/mainnav.module.css | 7 ++--- src/components/shortcodes.module.css | 6 ++-- src/pages/404.module.css | 2 +- src/styles/accessibility.css | 2 +- src/styles/general.css | 27 ++++++++---------- src/styles/global.module.css | 3 +- src/templates/templates.module.css | 18 ++++++------ static/images/logo_accessiblePDF.svg | 38 +------------------------- 13 files changed, 40 insertions(+), 83 deletions(-) diff --git a/src/components/buymeacoffee.module.css b/src/components/buymeacoffee.module.css index c9753668..194f6b4f 100644 --- a/src/components/buymeacoffee.module.css +++ b/src/components/buymeacoffee.module.css @@ -22,4 +22,4 @@ .logoBmc { grid-row: span 2; max-width: 2rem; -} \ No newline at end of file +} diff --git a/src/components/footer.module.css b/src/components/footer.module.css index 70e8a48b..96f0b519 100644 --- a/src/components/footer.module.css +++ b/src/components/footer.module.css @@ -2,7 +2,7 @@ background: var(--primary-color-8); border-top: 0.5rem solid var(--primary-color-9); color: #000; - font-size: .8rem; + font-size: 0.8rem; margin-top: auto; padding: 1rem; width: 100%; diff --git a/src/components/footernav.module.css b/src/components/footernav.module.css index 71f49cfc..a0833f2e 100644 --- a/src/components/footernav.module.css +++ b/src/components/footernav.module.css @@ -8,7 +8,7 @@ .footernav .menuitem { list-style-type: none; - margin: 0 .5rem 1rem 0; + margin: 0 0.5rem 1rem 0; } .footernav .menuitem a { @@ -16,7 +16,7 @@ border-bottom: 3px solid var(--primary-color-9); color: var(--primary-color-9); display: block; - padding: .5rem; + padding: 0.5rem; text-decoration: none; } @@ -28,4 +28,4 @@ .footernav .menuitem a:focus { border-bottom-color: transparent; color: var(--secondary-color); -} \ No newline at end of file +} diff --git a/src/components/header.module.css b/src/components/header.module.css index 1bf14bc2..abefd735 100644 --- a/src/components/header.module.css +++ b/src/components/header.module.css @@ -27,7 +27,7 @@ font-size: 1.25rem; } -@media screen and (min-width:60rem) { +@media screen and (min-width: 60rem) { .masthead { text-align: left; } @@ -55,7 +55,7 @@ } } -@media screen and (min-width:80rem) { +@media screen and (min-width: 80rem) { .masthead { padding: 2rem 1rem; } diff --git a/src/components/layout.module.css b/src/components/layout.module.css index a4eb3388..767163b2 100644 --- a/src/components/layout.module.css +++ b/src/components/layout.module.css @@ -2,7 +2,7 @@ html { background: var(--primary-color-8); scroll-behavior: smooth; } - + @media (prefers-reduced-motion: reduce) { html { scroll-behavior: auto; @@ -29,7 +29,7 @@ body { flex-direction: column; margin: 1rem auto 2rem; padding: 0 1rem; - max-width: var(--content-w-regular ); + max-width: var(--content-w-regular); } @media screen and (min-width: 60rem) { @@ -43,4 +43,4 @@ body { .site_main { padding: 0; } -} \ No newline at end of file +} diff --git a/src/components/mainnav.module.css b/src/components/mainnav.module.css index fce0fcc6..02853927 100644 --- a/src/components/mainnav.module.css +++ b/src/components/mainnav.module.css @@ -5,7 +5,7 @@ margin: 1rem; padding: 0; } - + .mainnav .menuitem { margin: 0 0.5rem; list-style-type: none; @@ -47,8 +47,8 @@ background: var(--color-gray-bright); padding: 0.25rem 0.5rem; } - -@media screen and (min-width:60rem) { + +@media screen and (min-width: 60rem) { .mainnav { display: flex; align-items: center; @@ -60,4 +60,3 @@ justify-content: flex-end; } } - \ No newline at end of file diff --git a/src/components/shortcodes.module.css b/src/components/shortcodes.module.css index 177e9752..b195d73a 100644 --- a/src/components/shortcodes.module.css +++ b/src/components/shortcodes.module.css @@ -1,11 +1,11 @@ .note { background: #e7f5ff; border-left: 5px solid #228be6; - padding: .5rem .5rem .5rem .75rem; + padding: 0.5rem 0.5rem 0.5rem 0.75rem; } .warning { background: #fff9db; border-left: 5px solid #fab005; - padding: .5rem .5rem .5rem .75rem; -} \ No newline at end of file + padding: 0.5rem 0.5rem 0.5rem 0.75rem; +} diff --git a/src/pages/404.module.css b/src/pages/404.module.css index dcf35cf9..0c689a08 100644 --- a/src/pages/404.module.css +++ b/src/pages/404.module.css @@ -17,4 +17,4 @@ float: right; width: 50%; } -} \ No newline at end of file +} diff --git a/src/styles/accessibility.css b/src/styles/accessibility.css index 0cb694d6..ebad16e3 100644 --- a/src/styles/accessibility.css +++ b/src/styles/accessibility.css @@ -37,4 +37,4 @@ /* Do not show the outline on the skip link target. */ #primary[tabindex="-1"]:focus { outline: 0; -} \ No newline at end of file +} diff --git a/src/styles/general.css b/src/styles/general.css index 8c0a03ac..48545168 100644 --- a/src/styles/general.css +++ b/src/styles/general.css @@ -8,7 +8,6 @@ p { margin-top: 1rem; } - /* Headings */ h1, @@ -51,7 +50,6 @@ h6 { font-weight: normal; } - /* Lists */ ul, @@ -61,7 +59,7 @@ ol { } li { - margin: .5rem 0 0; + margin: 0.5rem 0 0; } li ul, @@ -120,30 +118,29 @@ a:focus { outline: none; } - /* Blockquote */ blockquote { border-left: 5px solid var(--color-gray); background: var(--color-gray-bright); margin-top: 1rem; - padding: .5rem .5rem .5rem .75rem; + padding: 0.5rem 0.5rem 0.5rem 0.75rem; } blockquote > p { margin-top: 0; } - /* Code */ -code, kbd, tt, var { - background: var(--color-gray-bright); +code, +kbd, +tt, +var { font-family: Consolas, Monaco, "Andale Mono", "DejaVu Sans Mono", monospace; font-size: .9em; } - /* HR */ hr { @@ -152,7 +149,6 @@ hr { margin-top: 3rem; } - /* TOC */ .toc + ul p, @@ -160,22 +156,20 @@ hr { margin-top: 0; } - /* Messages */ .note { background: #e7f5ff; border-left: 5px solid #228be6; - padding: .5rem .5rem .5rem .75rem; + padding: 0.5rem 0.5rem 0.5rem 0.75rem; } .warning { background: #fff9db; border-left: 5px solid #fab005; - padding: .5rem .5rem .5rem .75rem; + padding: 0.5rem 0.5rem 0.5rem 0.75rem; } - /* Glossary TOC */ .glossary-toc + ul, @@ -189,5 +183,6 @@ hr { background: #fff; display: inline-block; margin: 1rem 1rem 0 0; - padding: 0 .25rem; -} \ No newline at end of file + padding: 0 0.25rem; +} + diff --git a/src/styles/global.module.css b/src/styles/global.module.css index 032f9cdc..923a579b 100644 --- a/src/styles/global.module.css +++ b/src/styles/global.module.css @@ -1,6 +1,7 @@ :root { /* Fonts */ - --primary-font: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif; + --primary-font: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, + sans-serif; /* Colors */ --primary-color-6: #12b886; diff --git a/src/templates/templates.module.css b/src/templates/templates.module.css index 38a2be1a..ad9715e0 100644 --- a/src/templates/templates.module.css +++ b/src/templates/templates.module.css @@ -36,7 +36,7 @@ article.tutorials .maincontent { } article.default .article_title { - color: var(--text-color); + color: var(--color-text); } @media screen and (min-width: 60rem) { @@ -46,18 +46,18 @@ article.default .article_title { } .article_metadata { - font-size: .8rem; - margin-top: .5rem; + font-size: 0.8rem; + margin-top: 0.5rem; } .article_metadata + p { font-size: 1.25rem; line-height: 1.3; - margin: 1.5rem 0 + margin: 1.5rem 0; } article.default .article_title + p { - color: var(--text-color); + color: var(--color-text); font-size: 1.25rem; line-height: 1.3; margin-top: 1rem; @@ -66,7 +66,7 @@ article.default .article_title + p { @media screen and (min-width: 60rem) { article.default .article_title + p { font-size: 1.5rem; - } + } } article.basics a, @@ -74,7 +74,6 @@ article.tutorials a { color: var(--secondary-color); } - /* Media */ .default img { @@ -82,7 +81,6 @@ article.tutorials a { box-sizing: content-box; } - /* Sidebar */ @media screen and (min-width: 40rem) { @@ -122,7 +120,7 @@ article.tutorials a { } .sidebar_nav_list { - font-size: .8rem; + font-size: 0.8rem; list-style: none; padding: 0; } @@ -136,7 +134,7 @@ article.tutorials a { border-bottom: 3px solid var(--primary-color-6); color: var(--primary-color-9); display: block; - padding: .5rem; + padding: 0.5rem; text-decoration: none; } diff --git a/static/images/logo_accessiblePDF.svg b/static/images/logo_accessiblePDF.svg index 3a5b2867..9adc3086 100644 --- a/static/images/logo_accessiblePDF.svg +++ b/static/images/logo_accessiblePDF.svg @@ -1,37 +1 @@ - - - - - - - - +logo_accessiblePDF \ No newline at end of file From 49a3e763561934921b9f28b29b144959d151e58a Mon Sep 17 00:00:00 2001 From: pixelstrolch Date: Wed, 2 Jun 2021 21:54:24 +0200 Subject: [PATCH 06/23] Update color variables --- src/components/header.module.css | 2 +- src/components/layout.module.css | 2 +- src/styles/general.css | 4 ++-- src/styles/global.module.css | 5 ++++- 4 files changed, 8 insertions(+), 5 deletions(-) diff --git a/src/components/header.module.css b/src/components/header.module.css index abefd735..11187b9a 100644 --- a/src/components/header.module.css +++ b/src/components/header.module.css @@ -15,7 +15,7 @@ } .masthead_info { - color: var(--text-color); + color: var(--color-text); } .masthead_info a { diff --git a/src/components/layout.module.css b/src/components/layout.module.css index 767163b2..52a0527b 100644 --- a/src/components/layout.module.css +++ b/src/components/layout.module.css @@ -18,7 +18,7 @@ html { body { background: var(--primary-color-6); box-sizing: border-box; - color: var(--text-color); + color: var(--color-text); font-family: var(--primary-font); letter-spacing: -0.015em; text-align: left; diff --git a/src/styles/general.css b/src/styles/general.css index 48545168..fc37a162 100644 --- a/src/styles/general.css +++ b/src/styles/general.css @@ -92,11 +92,11 @@ th, td { /* Links */ a { - color: var(--text-color); + color: var(--color-text); } a:hover { - color: var(--text-color); + color: var(--color-text); } #primary a:hover { diff --git a/src/styles/global.module.css b/src/styles/global.module.css index 923a579b..7ab6eec3 100644 --- a/src/styles/global.module.css +++ b/src/styles/global.module.css @@ -8,8 +8,11 @@ --primary-color-8: #099268; --primary-color-9: #087f5b; --secondary-color: #c92a2a; - --text-color: #212529; + --color-text: #212529; --color-gray: #adb5bd; + --color-gray-r: 173; + --color-gray-g: 181; + --color-gray-b: 189; --color-gray-bright: #f1f3f5; /* Sizes and widths */ From b0b2a684345bef27257844dc7eca6c081f9ec66a Mon Sep 17 00:00:00 2001 From: pixelstrolch Date: Thu, 3 Jun 2021 20:18:54 +0200 Subject: [PATCH 07/23] New table styles --- src/styles/general.css | 82 ++++++++++++++++++++++++++++++++---------- 1 file changed, 63 insertions(+), 19 deletions(-) diff --git a/src/styles/general.css b/src/styles/general.css index fc37a162..e0ea91fa 100644 --- a/src/styles/general.css +++ b/src/styles/general.css @@ -71,24 +71,6 @@ ol li { padding-left: 1rem; } -/* Table */ - -table { - border-collapse: collapse; - margin-top: 1rem; -} - -th, td { - border-top: 1px solid var(--color-gray); - border-bottom: 1px solid var(--color-gray); - vertical-align: top; -} - -.w30 { - width: 30%; -} - - /* Links */ a { @@ -138,7 +120,7 @@ kbd, tt, var { font-family: Consolas, Monaco, "Andale Mono", "DejaVu Sans Mono", monospace; - font-size: .9em; + font-size: 0.9em; } /* HR */ @@ -186,3 +168,65 @@ hr { padding: 0 0.25rem; } +/* Tables */ + +table { + border-collapse: collapse; + margin-top: 1rem; +} + +th { + border-bottom: 2px solid var(--color-text); + font-weight: bold; +} + +td { + border-bottom: 1px solid var(--color-gray); +} + +th, +td { + padding: 0.25em 1em 0.25em 0; + vertical-align: top; +} + +.pdfTags table { + width: 60em; +} + +.pdfTags td:nth-child(1) { + width: 5em; +} +.pdfTags td:nth-child(2) { + width: 15em; +} + +.pdfTags td:nth-child(3) { + width: 20em; +} + +.pdfTags td:nth-child(4) { + width: 20em; +} + +.tableResponsive { + background-image: linear-gradient(to right, white, white), linear-gradient(to right, white, white), + linear-gradient( + to right, + rgba(var(--color-gray-r), var(--color-gray-g), var(--color-gray-b), 0.2), + rgba(255, 255, 255, 0) + ), + linear-gradient( + to left, + rgba(var(--color-gray-r), var(--color-gray-g), var(--color-gray-b), 0.2), + rgba(255, 255, 255, 0) + ); + /* Shadows */ + /* Shadow covers */ + background-position: left center, right center, left center, right center; + background-repeat: no-repeat; + background-color: white; + background-size: 20px 100%, 20px 100%, 20px 100%, 20px 100%; + background-attachment: local, local, scroll, scroll; + overflow: auto; +} From e3308e188b90b8a93d68966187a00d5f5fd89fd2 Mon Sep 17 00:00:00 2001 From: pixelstrolch Date: Fri, 4 Jun 2021 07:46:57 +0200 Subject: [PATCH 08/23] Layout optimizations --- src/components/footer.module.css | 4 +- src/components/header.module.css | 6 +- src/components/layout.module.css | 25 ++-- src/pages/404.module.css | 1 + src/styles/general.css | 61 ++++++--- src/templates/basics.js | 12 +- src/templates/basics.navigation.js | 172 +++++++++++++------------- src/templates/templates.module.css | 114 ++++++++++++----- src/templates/tutorials.js | 8 +- src/templates/tutorials.navigation.js | 2 - 10 files changed, 232 insertions(+), 173 deletions(-) diff --git a/src/components/footer.module.css b/src/components/footer.module.css index 96f0b519..9db99ea4 100644 --- a/src/components/footer.module.css +++ b/src/components/footer.module.css @@ -2,13 +2,13 @@ background: var(--primary-color-8); border-top: 0.5rem solid var(--primary-color-9); color: #000; - font-size: 0.8rem; + font-size: 0.75rem; margin-top: auto; - padding: 1rem; width: 100%; } .footer_container { margin: 0 auto; + padding: 2rem 1rem 1rem; max-width: var(--content-w-wide); } diff --git a/src/components/header.module.css b/src/components/header.module.css index 11187b9a..cfe94ebc 100644 --- a/src/components/header.module.css +++ b/src/components/header.module.css @@ -1,11 +1,12 @@ .masthead { background-color: white; border-bottom: 0.5rem solid var(--primary-color-8); - padding: 1rem; text-align: center; } .header_container { + padding: 1rem; + margin: 0 auto; max-width: var(--content-w-wide); } @@ -35,7 +36,6 @@ .header_container { display: flex; justify-content: space-between; - margin: 0 auto; } .masthead_info a { @@ -56,7 +56,7 @@ } @media screen and (min-width: 80rem) { - .masthead { + .header_container { padding: 2rem 1rem; } } diff --git a/src/components/layout.module.css b/src/components/layout.module.css index 52a0527b..f2f2c615 100644 --- a/src/components/layout.module.css +++ b/src/components/layout.module.css @@ -25,22 +25,11 @@ body { } .site_main { - display: flex; - flex-direction: column; - margin: 1rem auto 2rem; - padding: 0 1rem; - max-width: var(--content-w-regular); -} - -@media screen and (min-width: 60rem) { - .site_main { - flex-direction: row; - margin: 2rem auto; - } -} - -@media screen and (min-width: 80rem) { - .site_main { - padding: 0; - } + display: grid; + grid-template-columns: 1fr 1fr 1fr 1fr; + gap: 2rem; + justify-items: stretch; + margin: 1rem auto; + padding: 1rem; + max-width: var(--content-w-wide); } diff --git a/src/pages/404.module.css b/src/pages/404.module.css index 0c689a08..5d539411 100644 --- a/src/pages/404.module.css +++ b/src/pages/404.module.css @@ -1,5 +1,6 @@ .container { font-size: 1.25rem; + grid-column: 1 / span 4; } @media screen and (min-width: 60rem) { diff --git a/src/styles/general.css b/src/styles/general.css index e0ea91fa..b8b3ec2f 100644 --- a/src/styles/general.css +++ b/src/styles/general.css @@ -29,24 +29,24 @@ h6 { } h1 { - font-size: 2rem; + font-size: 2em; font-weight: normal; } h2 { - font-size: 1.5rem; + font-size: 1.5em; font-weight: bold; } h3 { - font-size: 1.25rem; + font-size: 1.25em; font-weight: bold; } h4, h5, h6 { - font-size: 1.25rem; + font-size: 1.25em; font-weight: normal; } @@ -55,20 +55,37 @@ h6 { ul, ol { padding: 0; - margin: 1rem 0 0 2rem; + margin: 1rem 0 0 0; } -li { - margin: 0.5rem 0 0; +ul { + list-style: none outside; +} + +ul > li { + margin: 0.5rem 0 0 2em; +} + +ol > li { + margin: 0.5rem 0 0 2em; + padding-left: 0.25em; } li ul, li ol { - margin-left: 1rem; + margin: 0.5rem 0 0 0.5em; } -ol li { - padding-left: 1rem; +li ul > li { + margin-left: 1em; +} + +li ol { + list-style-type: lower-latin; +} + +li ol > li { + margin-left: 0.5em; } /* Links */ @@ -81,11 +98,6 @@ a:hover { color: var(--color-text); } -#primary a:hover { - background-color: #fff; - color: var(--secondary-color); -} - *:focus { outline: 2px solid var(--secondary-color); } @@ -168,10 +180,15 @@ hr { padding: 0 0.25rem; } +.glossary-toc + ul li::before { + content: none; +} + /* Tables */ table { border-collapse: collapse; + font-size: 1rem; margin-top: 1rem; } @@ -191,22 +208,22 @@ td { } .pdfTags table { - width: 60em; + width: 54em; } .pdfTags td:nth-child(1) { width: 5em; } .pdfTags td:nth-child(2) { - width: 15em; + width: 19em; } .pdfTags td:nth-child(3) { - width: 20em; + width: 15em; } .pdfTags td:nth-child(4) { - width: 20em; + width: 15em; } .tableResponsive { @@ -230,3 +247,9 @@ td { background-attachment: local, local, scroll, scroll; overflow: auto; } + +/* Embeds */ + +.gatsby-resp-iframe-wrapper { + margin-top: 1rem; +} diff --git a/src/templates/basics.js b/src/templates/basics.js index 5e22929c..e90c9e0b 100644 --- a/src/templates/basics.js +++ b/src/templates/basics.js @@ -25,14 +25,6 @@ export default function PageTemplate({ data: { mdx } }) { /> <> - - {intl.formatMessage({ id: "skip.article" })} - - - -

{mdx.frontmatter.title}

@@ -50,6 +42,10 @@ export default function PageTemplate({ data: { mdx } }) {
+ + diff --git a/src/templates/basics.navigation.js b/src/templates/basics.navigation.js index 912c5d45..51a94413 100644 --- a/src/templates/basics.navigation.js +++ b/src/templates/basics.navigation.js @@ -12,96 +12,94 @@ const BasicsNavigation = () => { <>

{intl.formatMessage({ id: "subnav.basics.title" })}

-
- + - + - + - -
+ ) } diff --git a/src/templates/templates.module.css b/src/templates/templates.module.css index ad9715e0..14febd0f 100644 --- a/src/templates/templates.module.css +++ b/src/templates/templates.module.css @@ -4,8 +4,16 @@ article.basics, article.tutorials { background: #fff; box-shadow: 0.5rem 0.5rem 0 var(--primary-color-8); - order: 2; - margin-top: 1rem; + display: flex; + flex-direction: column; + grid-column: 1 / span 4; + justify-content: space-between; + width: 100%; +} + +article.default { + grid-column: 1 / span 4; + max-width: var(--content-w-regular); } article.basics .maincontent, @@ -13,22 +21,27 @@ article.tutorials .maincontent { padding: 0.8rem 1rem 1rem; } -@media screen and (min-width: 60rem) { +@media screen and (min-width: 80rem) { article.basics, article.tutorials { + grid-column: 2 / span 3; margin-top: 0; - width: 40rem; + order: 2; } article.basics .maincontent, article.tutorials .maincontent { padding: 1.8rem 2rem 2rem; } -} -@media screen and (min-width: 60rem) { + article.default { font-size: 1.25rem; } + + article.basics, + article.tutorials { + font-size: 1.25rem; + } } .article_title { @@ -46,12 +59,18 @@ article.default .article_title { } .article_metadata { - font-size: 0.8rem; + font-size: 0.75rem; margin-top: 0.5rem; } +@media screen and (min-width: 80rem) { + .article_metadata { + font-size: 1rem; + } +} + .article_metadata + p { - font-size: 1.25rem; + font-size: 1.25em; line-height: 1.3; margin: 1.5rem 0; } @@ -74,6 +93,22 @@ article.tutorials a { color: var(--secondary-color); } +.maincontent ul li::before { + color: var(--primary-color-8); + content: "–"; + display: inline-block; + margin-left: -1.25em; + width: 1.25em; +} + +.default li::before { + color: inherit; + content: "–"; + display: inline-block; + margin-left: -1.25em; + width: 1.25em; +} + /* Media */ .default img { @@ -83,44 +118,61 @@ article.tutorials a { /* Sidebar */ +.sidebar { + display: flex; + flex-direction: row; + flex-wrap: wrap; + grid-column: 1 / span 4; + width: 100%; +} + +.sidebar_title { + font-size: 1.5em; + margin: 0 0 -1rem; + width: 100%; +} + +.sidebar nav { + width: 100%; +} + @media screen and (min-width: 40rem) { - .flex_nav { - display: flex; - flex-wrap: nowrap; - flex-direction: row; - gap: 1rem; + .sidebar nav { + width: 50%; } -} -@media screen and (min-width: 60rem) { - .sidebar { - padding-right: 0.5rem; - width: 20rem; + .sidebar nav:nth-of-type(even) { + padding-left: 1rem; } - .flex_nav { - display: block; + .sidebar nav:nth-of-type(odd) { + padding-right: 1rem; } } -.sidebar_title { - font-size: 1.5rem; - margin-top: 0; -} +@media screen and (min-width: 80rem) { + .sidebar { + flex-direction: column; + grid-column: 1 / span 1; + } -@media screen and (min-width: 60rem) { - .sidebar_title { - margin-top: 2.25rem; + .sidebar nav { + width: 100%; + } + + .sidebar nav:nth-of-type(even), + .sidebar nav:nth-of-type(odd) { + padding: 0; } } .sidebar_nav_subtitle { - font-size: 1rem; - margin: 1rem 0 0.5rem; + font-size: 1em; + margin: 2rem 0 1rem; } .sidebar_nav_list { - font-size: 0.8rem; + font-size: 1rem; list-style: none; padding: 0; } @@ -134,7 +186,7 @@ article.tutorials a { border-bottom: 3px solid var(--primary-color-6); color: var(--primary-color-9); display: block; - padding: 0.5rem; + padding: 0.75rem; text-decoration: none; } diff --git a/src/templates/tutorials.js b/src/templates/tutorials.js index c6a23ed2..73d3933f 100644 --- a/src/templates/tutorials.js +++ b/src/templates/tutorials.js @@ -24,9 +24,6 @@ export default function PageTemplate({ data: { mdx } }) { lang={mdx.frontmatter.lang} /> -
@@ -48,6 +45,11 @@ export default function PageTemplate({ data: { mdx } }) {
+ + + ) diff --git a/src/templates/tutorials.navigation.js b/src/templates/tutorials.navigation.js index 5674799d..56467620 100644 --- a/src/templates/tutorials.navigation.js +++ b/src/templates/tutorials.navigation.js @@ -12,7 +12,6 @@ const TutorialsNavigation = () => { <>

{intl.formatMessage({ id: "subnav.tutorials.title" })}

-
-
) } From 3e2adc75af6ab698acbaca0fd53a34e1cff51b80 Mon Sep 17 00:00:00 2001 From: pixelstrolch Date: Sun, 6 Jun 2021 17:12:03 +0200 Subject: [PATCH 09/23] Go back to markdown tables #30 --- .../overview-of-the-pdf-tags/index.de.mdx | 643 +++--------------- .../overview-of-the-pdf-tags/index.en.mdx | 631 ++--------------- 2 files changed, 147 insertions(+), 1127 deletions(-) diff --git a/content/basics/general/overview-of-the-pdf-tags/index.de.mdx b/content/basics/general/overview-of-the-pdf-tags/index.de.mdx index 333d60b9..31a8e21e 100644 --- a/content/basics/general/overview-of-the-pdf-tags/index.de.mdx +++ b/content/basics/general/overview-of-the-pdf-tags/index.de.mdx @@ -4,15 +4,15 @@ slug: /basics/general/overview-of-the-pdf-tags lang: de-CH template: basics author: Stefan Brechbühl -date: 2021-03-05 +date: 2020-12-07 description: Diese Zusammenstellung zeigt alle verfügbaren Tags nach dem Standard PDF 1.7. Sie hilft als Nachschlagewerk um semantisch korrekte Tags zu vergeben. --- Diese Zusammenstellung zeigt alle verfügbaren Tags nach dem Standard PDF 1.7. Sie hilft als Nachschlagewerk um semantisch korrekte Tags zu vergeben. -Die unten aufgeführten *Tags* entsprechen dem [ISO Standard PDF 1.7](https://www.adobe.com/content/dam/acom/en/devnet/pdf/pdfs/PDF32000_2008.pdf). Im Jahr 2018 ist der neuere Standard PDF 2.0 erschienen. Darin sind einige der hier beschriebenen *Tags* weggefallen und neue hinzugekommen. Da der Standard aber noch zu wenig verbreitet ist und eine Überarbeitung des PDF/UA-Standards noch offen ist, entspricht diese Übersicht noch PDF 1.7. +Die unten aufgeführten _Tags_ entsprechen dem [ISO Standard PDF 1.7](https://www.adobe.com/content/dam/acom/en/devnet/pdf/pdfs/PDF32000_2008.pdf). Im Jahr 2018 ist der neuere Standard PDF 2.0 erschienen. Darin sind einige der hier beschriebenen _Tags_ weggefallen und neue hinzugekommen. Da der Standard aber noch zu wenig verbreitet ist und eine Überarbeitung des PDF/UA-Standards noch offen ist, entspricht diese Übersicht noch PDF 1.7. -In der Übersicht nicht enthalten, sind die PDF-*Tags* +In der Übersicht nicht enthalten, sind die PDF-_Tags_ - `NonStruct` (Gruppierendes Element) - `Private` (Gruppierendes Element) @@ -25,587 +25,98 @@ da sie für die Verwendung nicht empfohlen oder nicht relevant sind. Es liegt nahe, dass gruppierende Elemente grundsätzlich Block-Elemente und Block-Elemente grundsätzlich Inline-Elemente enthalten. Der Standard gibt nicht immer klar vor, welche Konstellationen möglich sind. Die illustrierende Elemente können als Block- oder Inline-Elemente fungieren. -Praktische Anwendungsbeispiele und Informationen bietet das Dokument “Tagged PDF Best Practice Guide: Syntax” der PDF Association. + Praktische Anwendungsbeispiele und Informationen bietet das Dokument{" "} + + “Tagged PDF Best Practice Guide: Syntax” + {" "} + der PDF Association. -```toc -# This code block gets replaced with the TOC -from-heading: 2 -to-heading: 4 -``` - ## Gruppierende Elemente -### `Document` - - - - - - - - - - - - - - -
Semantische BedeutungBildet ein komplettes Dokument ab
Mögliche und semantisch sinnvolle Elternelemente–
Mögliche und semantisch sinnvolle KindelementeGruppierende Elemente, Block-Elemente
- -### `Part` - - - - - - - - - - - - - - -
Semantische BedeutungTeilung eines grösseren Dokuments in kleinere, zusammengehörende Teile
Mögliche und semantisch sinnvolle ElternelementeDocument
Mögliche und semantisch sinnvolle KindelementeArt, Sect, Div, BlockQuote, Caption, TOC, Index, Block-Elemente
- - -### `Art` - - - - - - - - - - - - - - -
Semantische BedeutungInhaltsteile, die zusammen abschliessend sind, also ein Artikel oder ein Teil eines Dokuments
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Sect, Div, BlockQuote
Mögliche und semantisch sinnvolle KindelementeSect, Div, BlockQuote, Caption, TOC, Index, Block-Elemente
- -### `Sect` - - - - - - - - - - - - - - -
Semantische BedeutungGruppierte zusammenhängende Inhaltsteile, beispielsweise mehrere Absätze, die zu einer Gruppe zusammengefasst werden können
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote
Mögliche und semantisch sinnvolle KindelementeArt, Sect, Div, BlockQuote, Caption, TOC, Index, Block-Elemente
- -### `Div` - - - - - - - - - - - - - - -
Semantische BedeutungGenerisches Gruppenelement ohne semantische Bedeutung
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote
Mögliche und semantisch sinnvolle KindelementeArt, Sect, Div, BlockQuote, Caption, TOC, Index, Block-Elemente
- -### `BlockQuote` - - - - - - - - - - - - - - -
Semantische BedeutungEin oder mehrere Absätze, die von einer anderen Autorin / einem anderen Autoren stammt, also zitiert wurde
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div
Mögliche und semantisch sinnvolle KindelementeArt, Sect, Div, Caption, Block-Elemente
- -### `Caption` - - - - - - - - - - - - - - -
Semantische BedeutungEine Beschriftung um beispielsweise ein Bild oder eine Tabelle zu beschreiben
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote, Table, L
Mögliche und semantisch sinnvolle KindelementeSect, Div, BlockQuote, Block-Elemente
- -### `TOC` - - - - - - - - - - - - - - -
Semantische BedeutungContainer für Inhaltsverzeichniseinträge. Kann entweder als flache (alle enthaltene
Mögliche und semantisch sinnvolle ElternelementeTOCI auf einer Ebene) oder komplexe Hierarchie (TOC innerhalb eines TOCI als Untergruppe) angewendet werden. Kann mehrfach in einem Dokument enthalten sein, da es auch für Bilder- oder Tabellenverzeichnisse verwendet werden kann. Englisch abgekürzt für „Table of contents“
Mögliche und semantisch sinnvolle KindelementeDocument, Part, Art, Sect, Div| TOCI
- -### `TOCI` - - - - - - - - - - - - - - -
Semantische BedeutungEintrag innerhalb eines Inhaltsverzeichnisses (TOC). Englisch abgekürzt für „Table of contents item“
Mögliche und semantisch sinnvolle ElternelementeTOC
Mögliche und semantisch sinnvolle KindelementeTOC, P, Lbl, Reference
- -### `Index` - - - - - - - - - - - - - - -
Semantische BedeutungContainer für ein Stichwortverzeichnis
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div
Mögliche und semantisch sinnvolle KindelementeL
+
+ +| PDF _Tag_ | Semantische Bedeutung | Mögliche und semantisch sinnvolle Elternelemente | Mögliche und semantisch sinnvolle Kindelemente | +| :-- | :-- | :-- | :-- | +| `Document` | Bildet ein komplettes Dokument ab | – | [Gruppierende Elemente](#gruppierende-elemente), [Block-Elemente](#block-elemente) | +| `Part` | Teilung eines grösseren Dokuments in kleinere, zusammengehörende Teile | `Document` | `Art`, `Sect`, `Div`, `BlockQuote`, `Caption`, `TOC`, `Index`, [Block-Elemente](#block-elemente) | +| `Art` | Inhaltsteile, die zusammen abschliessend sind, also ein Artikel oder ein Teil eines Dokuments | `Document`, `Part`, `Sect`, `Div`, `BlockQuote` | `Sect`, `Div`, `BlockQuote`, `Caption`, `TOC`, `Index`, [Block-Elemente](#block-elemente) | +| `Sect` | Gruppierte zusammenhängende Inhaltsteile, beispielsweise mehrere Absätze, die zu einer Gruppe zusammengefasst werden können | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote` | `Art`, `Sect`, `Div`, `BlockQuote`, `Caption`, `TOC`, `Index`, [Block-Elemente](#block-elemente) | +| `Div` | Generisches Gruppenelement ohne semantische Bedeutung | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote` | `Art`, `Sect`, `Div`, `BlockQuote`, `Caption`, `TOC`, `Index`, [Block-Elemente](#block-elemente) | +| `BlockQuote` | Ein oder mehrere Absätze, die von einer anderen Autorin / einem anderen Autoren stammt, also zitiert wurde | `Document`, `Part`, `Art`, `Sect`, `Div` | `Art`, `Sect`, `Div`, `Caption`, [Block-Elemente](#block-elemente) | +| `Caption` | Eine Beschriftung um beispielsweise ein Bild oder eine Tabelle zu beschreiben | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote`, `Table`, `L` | `Sect`, `Div`, `BlockQuote`, [Block-Elemente](#block-elemente) | +| `TOC` | Container für Inhaltsverzeichniseinträge. Kann entweder als flache (alle enthaltene `TOCI` auf einer Ebene) oder komplexe Hierarchie (`TOC` innerhalb eines `TOCI` als Untergruppe) angewendet werden. Kann mehrfach in einem Dokument enthalten sein, da es auch für Bilder- oder Tabellenverzeichnisse verwendet werden kann. Englisch abgekürzt für _Table of contents_ | `Document`, `Part`, `Art`, `Sect`, `Div` | `TOCI` | +| `TOCI` | Eintrag innerhalb eines Inhaltsverzeichnisses (`TOC`). Englisch abgekürzt für _Table of contents item_ | `TOC` | `TOC`, `P`, `Lbl`, `Reference` | +| `Index` | Container für ein Stichwortverzeichnis | `Document`, `Part`, `Art`, `Sect`, `Div` | `L` | + +
## Block-Elemente ### Absatzelemente -#### `P` - - - - - - - - - - - - - - -
Semantische BedeutungGewöhnlicher Absatz; Englisch abgekürzt für „Paragraph“
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote, Caption, TOCI
Mögliche und semantisch sinnvolle KindelementeInline-Elemente
- -#### `H1`, `H2`, `H3`, `H4`, `H5`, `H6` - - - - - - - - - - - - - - -
Semantische BedeutungHierarchische Überschriften der Ebene 1 bis 6; H ist die englisch Abkürzung für „Heading“
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote
Mögliche und semantisch sinnvolle KindelementeInline-Elemente
+
+ +| PDF _Tag_ | Semantische Bedeutung | Mögliche und semantisch sinnvolle Elternelemente | Mögliche und semantisch sinnvolle Kindelemente | +| :-- | :-- | :-- | :-- | +| `P` | Gewöhnlicher Absatz; Englisch abgekürzt für _Paragraph_ | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote`, `Caption`, `TOCI` | [Inline-Elemente](#inline-elemente) | +| `H1`, `H2`, `H3`, `H4`, `H5`, `H6` | Hierarchische Überschriften der Ebene 1 bis 6; H ist die englisch Abkürzung für _Heading_ | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote` | [Inline-Elemente](#inline-elemente) | + +
### Listenelemente -#### `L` - - - - - - - - - - - - - - -
Semantische BedeutungListencontainer; fasst alle zusammengehörigen Listenelemente zusammen
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote, Index
Mögliche und semantisch sinnvolle KindelementeLI, Caption
- -#### `LI` - - - - - - - - - - - - - - -
Semantische BedeutungContainer eines Listeneintrags; Kann ein L enthalten um mehrstufige Listen zu erstellen
Mögliche und semantisch sinnvolle ElternelementeL
Mögliche und semantisch sinnvolle KindelementeLbl, LBody, L
- -#### `Lbl` - - - - - - - - - - - - - - -
Semantische BedeutungKommt vom englischen Begriff „Label“ und steht innerhalb einer Liste für die Nummerierung oder das Aufzählungszeichen. Ist eigentlich kein Blockelement und kann auch in anderen Elementen wie z.B. TOCI oder Caption verwendet werden.
Mögliche und semantisch sinnvolle ElternelementeLI
Mögliche und semantisch sinnvolle Kindelemente–
- -#### `LBody` - - - - - - - - - - - - - - -
Semantische BedeutungEnthält den Inhalt eines Listeneintrags
Mögliche und semantisch sinnvolle ElternelementeLI
Mögliche und semantisch sinnvolle KindelementeInline-Elemente
+
+ +| PDF _Tag_ | Semantische Bedeutung | Mögliche und semantisch sinnvolle Elternelemente | Mögliche und semantisch sinnvolle Kindelemente | +| :-- | :-- | :-- | :-- | +| `L` | Listencontainer; fasst alle zusammengehörigen Listenelemente zusammen | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote`, `Index` | `LI`, `Caption` | +| `LI` | Container eines Listeneintrags; Kann ein `L` enthalten um mehrstufige Listen zu erstellen | `L` | `Lbl`, `LBody`, `L` | +| `Lbl` | Kommt vom englischen Begriff „Label“ und steht innerhalb einer Liste für die Nummerierung oder das Aufzählungszeichen. _Ist eigentlich kein Blockelement und kann auch in anderen Elementen wie z.B. `TOCI` oder `Caption` verwendet werden._ | `LI` | – | +| `LBody` | Enthält den Inhalt eines Listeneintrags | `LI` | [Inline-Elemente](#inline-elemente) | + +
### Tabellenelemente -#### `Table` - - - - - - - - - - - - - - -
Semantische BedeutungTabellencontainer; fasst alle zusammengehörigen Tabellennelemente zusammen
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote
Mögliche und semantisch sinnvolle KindelementeTR, Caption, THead, TBody, TFoot
- -#### `TR` - - - - - - - - - - - - - - -
Semantische BedeutungFasst eine Tabellenzeile zusammen; englische abgekürzt für “table row”
Mögliche und semantisch sinnvolle ElternelementeTable, THead, TBody, TFoot
Mögliche und semantisch sinnvolle KindelementeTH, TD
- -#### `TH` - - - - - - - - - - - - - - -
Semantische BedeutungTabellenüberschriftszelle; beschreiben die Bedeutung entweder auf horizontaler (Zeile) oder auf vertikaler (Spalte) Ebene
Mögliche und semantisch sinnvolle ElternelementeTR
Mögliche und semantisch sinnvolle KindelementeInline-Elemente
- -#### `TD` - - - - - - - - - - - - - - -
Semantische BedeutungGewöhnliche Tabellendatenzellen
Mögliche und semantisch sinnvolle ElternelementeTR
Mögliche und semantisch sinnvolle KindelementeInline-Elemente
- -#### `THead` - - - - - - - - - - - - - - -
Semantische BedeutungEine Gruppe Tabellenzeilen (TR) um sie als Tabellenkopf zu kennzeichnen; kann optional angewendet werden
Mögliche und semantisch sinnvolle ElternelementeTable
Mögliche und semantisch sinnvolle KindelementeTR
- -#### `TBody` - - - - - - - - - - - - - - -
Semantische BedeutungEine Gruppe Tabellenzeilen (TR) um sie als Tabelleninhalt zu kennzeichnen; kann optional angewendet werden
Mögliche und semantisch sinnvolle ElternelementeTable
Mögliche und semantisch sinnvolle KindelementeTR
- -#### `TFoot` - - - - - - - - - - - - - - -
Semantische BedeutungEine Gruppe Tabellenzeilen (TR) um sie als Tabellenfusszeile (Ergebniszeile) zu kennzeichnen; kann optional angewendet werden
Mögliche und semantisch sinnvolle ElternelementeTable
Mögliche und semantisch sinnvolle KindelementeTR
+
+ +| PDF _Tag_ | Semantische Bedeutung | Mögliche und semantisch sinnvolle Elternelemente | Mögliche und semantisch sinnvolle Kindelemente | +| :-- | :-- | :-- | :-- | +| `Table` | Tabellencontainer; fasst alle zusammengehörigen Tabellennelemente zusammen | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote` | `TR`, `Caption`, `THead`, `TBody`, `TFoot` | +| `TR` | Fasst eine Tabellenzeile zusammen; englische abgekürzt für “table row” | `Table`, `THead`, `TBody`, `TFoot` | `TH`, `TD` | +| `TH` | Tabellenüberschriftszelle; beschreiben die Bedeutung entweder auf horizontaler (Zeile) oder auf vertikaler (Spalte) Ebene | `TR` | [Inline-Elemente](#inline-elemente) | +| `TD` | Gewöhnliche Tabellendatenzellen | `TR` | [Inline-Elemente](#inline-elemente) | +| `THead` | Eine Gruppe Tabellenzeilen (`TR`) um sie als Tabellenkopf zu kennzeichnen; kann optional angewendet werden | `Table` | `TR` | +| `TBody` | Eine Gruppe Tabellenzeilen (`TR`) um sie als Tabelleninhalt zu kennzeichnen; kann optional angewendet werden | `Table` | `TR` | +| `TFoot` | Eine Gruppe Tabellenzeilen (`TR`) um sie als Tabellenfusszeile (Ergebniszeile) zu kennzeichnen; kann optional angewendet werden | `Table` | `TR` | + +
## Inline-Elemente -### `Span` - - - - - - - - - - - - - - -
Semantische BedeutungGenerischer Container ohne semantische Bedeutung; wird unter anderem für visuelle Auszeichnungen, Sprachenwechsel oder zum Hinzufügen von ActualText (z.B. zum Ignorieren von Trennstrichen) verwendet
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD, Quote, Note
Mögliche und semantisch sinnvolle Kindelemente–
- -### `Quote` - - - - - - - - - - - - - - -
Semantische BedeutungWird wie BlockQuote für zitierte Inhalte verwendet; Quote wird jedoch auf Zeilenebene verwendet
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle KindelementeSpan
- -### `Note` - - - - - - - - - - - - - - -
Semantische BedeutungFuss- oder Endnotentext (nicht das Referenzzeichen im Fliesstext). Das Fuss-/Endnotenzeichen wird innerhalb von Note und Reference in einem Lbl platziert.
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle KindelementeLbl, P, Span
- -### `Reference` - - - - - - - - - - - - - - -
Semantische BedeutungReferenziert auf eine andere Stelle im Dokument, z.B. Fussnote oder Verzeichniseintrag
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle KindelementeLbl
- -### `Code` - - - - - - - - - - - - - - -
Semantische BedeutungAuszeichnung von Programmiersprache
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle Kindelemente–
- -### `Link` - - - - - - - - - - - - - - -
Semantische BedeutungLink auf eine Webseite oder auf eine Stelle im Dokument
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle Kindelemente–
- -### `Annot` - - - - - - - - - - - - - - -
Semantische BedeutungAnmerkungen (Annotations) die keine Verknüpfung oder Widget (Formularfeld) sind, wie Kommentaren und Videos.
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle Kindelemente–
+
+ +| PDF _Tag_ | Semantische Bedeutung | Mögliche und semantisch sinnvolle Elternelemente | Mögliche und semantisch sinnvolle Kindelemente | +| :-- | :-- | :-- | :-- | +| `Span` | Generischer Container ohne semantische Bedeutung; wird unter anderem für visuelle Auszeichnungen, Sprachenwechsel oder zum Hinzufügen von ActualText (z.B. zum Ignorieren von Trennstrichen) verwendet | `P`, `H1`–`H6`, `LBody`, `TD`, `Quote`, `Note` | – | +| `Quote` | Wird wie `BlockQuote` für zitierte Inhalte verwendet; `Quote` wird jedoch auf Zeilenebene verwendet | `P`, `H1`–`H6`, `LBody`, `TD` | `Span` | +| `Note` | Fuss- oder Endnotentext (nicht das Referenzzeichen im Fliesstext). Das Fuss-/Endnotenzeichen wird innerhalb von `Note` und `Reference` in einem `Lbl` platziert. | `P`, `H1`–`H6`, `LBody`, `TD` | `Lbl`, `P`, `Span` | +| `Reference` | Referenziert auf eine andere Stelle im Dokument, z.B. Fussnote oder Verzeichniseintrag | `P`, `H1`–`H6`, `LBody`, `TD` | `Lbl` | +| `Code` | Auszeichnung von Programmiersprache | `P`, `H1`–`H6`, `LBody`, `TD` | – | +| `Link` | Link auf eine Webseite oder auf eine Stelle im Dokument | `P`, `H1`–`H6`, `LBody`, `TD` | – | +| `Annot` | Anmerkungen (Annotations) die keine Verknüpfung oder Widget (Formularfeld) sind, wie Kommentaren und Videos. | `P`, `H1`–`H6`, `LBody`, `TD` | – | + +
## Illustrative Elemente -### `Figure` - - - - - - - - - - - - - - -
Semantische BedeutungFoto oder Grafik
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote, P, LBody, TD
Mögliche und semantisch sinnvolle Kindelemente–
- -### `Formula` - - - - - - - - - - - - - - -
Semantische BedeutungMathematische Formel
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote, P, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle Kindelemente–
- -### `Form` - - - - - - - - - - - - - - -
Semantische BedeutungFormularelement
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, P, TD
Mögliche und semantisch sinnvolle Kindelemente–
\ No newline at end of file +
+ +| PDF _Tag_ | Semantische Bedeutung | Mögliche und semantisch sinnvolle Elternelemente | Mögliche und semantisch sinnvolle Kindelemente | +| :-- | :-- | :--| :-- | +| `Figure` | Foto oder Grafik | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote`, `P`, `LBody`, `TD` | – | +| `Formula` | Mathematische Formel | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote`, `P`, `H1`–`H6`, `LBody`, `TD` | – | +| `Form` | Formularelement | `Document`, `Part`, `Art`, `Sect`, `Div`, `P`, `TD` | – | + +
\ No newline at end of file diff --git a/content/basics/general/overview-of-the-pdf-tags/index.en.mdx b/content/basics/general/overview-of-the-pdf-tags/index.en.mdx index bb4191a1..1fa86fc6 100644 --- a/content/basics/general/overview-of-the-pdf-tags/index.en.mdx +++ b/content/basics/general/overview-of-the-pdf-tags/index.en.mdx @@ -4,7 +4,7 @@ slug: /basics/general/overview-of-the-pdf-tags lang: en template: basics author: Stefan Brechbühl -date: 2021-03-05 +date: 2020-12-07 description: This overview shows the most important tags from the PDF 1.7 standard. The reference helps you to choose the correct and semantic tags. --- @@ -28,582 +28,91 @@ It is obvious that grouping elements basically contain block elements and block Practical examples and further informations can be found in the document “Tagged PDF Best Practice Guide: Syntax” of the PDF Association. -```toc -# This code block gets replaced with the TOC -from-heading: 2 -to-heading: 4 -``` - ## Grouping elements -### Document - - - - - - - - - - - - - - -
Semantische BedeutungRepresents a complete document
Mögliche und semantisch sinnvolle Elternelemente–
Mögliche und semantisch sinnvolle KindelementeGrouping elements, Block-level structure elements
- -### Part - - - - - - - - - - - - - - -
Semantische BedeutungDivision of a larger document into smaller, associated parts
Mögliche und semantisch sinnvolle ElternelementeDocument
Mögliche und semantisch sinnvolle KindelementeArt, Sect, Div, BlockQuote, Caption, TOC, Index, Block-level structure elements
- -### Art - - - - - - - - - - - - - - -
Semantische BedeutungParts of content which together are conclusive, i.e. an article or part of a document
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Sect, Div, BlockQuote
Mögliche und semantisch sinnvolle KindelementeSect, Div, BlockQuote, Caption, TOC, Index, Block-level structure elements
- -### Sect - - - - - - - - - - - - - - -
Semantische BedeutungGrouped related content parts, for example several paragraphs, which can be combined into a group
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote
Mögliche und semantisch sinnvolle KindelementeArt, Sect, Div, BlockQuote, Caption, TOC, Index, Block-level structure elements
- -### Div - - - - - - - - - - - - - - -
Semantische BedeutungGeneric group element without semantic meaning
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote
Mögliche und semantisch sinnvolle KindelementeArt, Sect, Div, BlockQuote, Caption, TOC, Index, Block-level structure elements
- -### BlockQuote - - - - - - - - - - - - - - -
Semantische BedeutungOne or more paragraphs that originate from another author, in other words, that have been quoted
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div
Mögliche und semantisch sinnvolle KindelementeArt, Sect, Div, Caption, Block-level structure elements
- -### Caption - - - - - - - - - - - - - - -
Semantische BedeutungA caption to describe for example a picture or a table
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote, Table, L
Mögliche und semantisch sinnvolle KindelementeSect, Div, BlockQuote, Block-level structure elements
- -### TOC - - - - - - - - - - - - - - -
Semantische BedeutungContainer for table of contents entries. Can be used either as a flat hierarchy (all contained TOCI on one level) or as a complex hierarchy (TOC within a TOCI as a subgroup). Can be contained multiple times in a document, since it can also be used for image or table directories.
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div
Mögliche und semantisch sinnvolle KindelementeTOCI
- -### TOCI - - - - - - - - - - - - - - -
Semantische BedeutungEntry within a table of contents (TOC).
Mögliche und semantisch sinnvolle ElternelementeTOC
Mögliche und semantisch sinnvolle KindelementeTOC, P, Lbl, Reference
- -### Index - - - - - - - - - - - - - - -
Semantische BedeutungContainer for a subject index
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div
Mögliche und semantisch sinnvolle KindelementeL
+
+ +| PDF tag | Semantic meaning | Possible and semantically meaningful parent elements | Possible and semantically meaningful child elements | +|:--|:--|:--|:--| +| `Document` | Represents a complete document | – | [Grouping elements](#grouping-elements), [Block-level structure elements](#block-level-structure-elements) | +| `Part` | Division of a larger document into smaller, associated parts | `Document` | `Art`, `Sect`, `Div`, `BlockQuote`, `Caption`, `TOC`, `Index`, [Block-level structure elements](#block-level-structure-elements) | +| `Art` | Parts of content which together are conclusive, i.e. an article or part of a document | `Document`, `Part`, `Sect`, `Div`, `BlockQuote` | `Sect`, `Div`, `BlockQuote`, `Caption`, `TOC`, `Index`, [Block-level structure elements](#block-level-structure-elements) | +| `Sect` | Grouped related content parts, for example several paragraphs, which can be combined into a group | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote` | `Art`, `Sect`, `Div`, `BlockQuote`, `Caption`, `TOC`, `Index`, [Block-level structure elements](#block-level-structure-elements) | +| `Div` | Generic group element without semantic meaning | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote` | `Art`, `Sect`, `Div`, `BlockQuote`, `Caption`, `TOC`, `Index`, [Block-level structure elements](#block-level-structure-elements) | +| `BlockQuote` | One or more paragraphs that originate from another author, in other words, that have been quoted | `Document`, `Part`, `Art`, `Sect`, `Div` | `Art`, `Sect`, `Div`, `Caption`, [Block-level structure elements](#block-level-structure-elements) | +| `Caption` | A caption to describe for example a picture or a table | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote`, `Table`, `L` | `Sect`, `Div`, `BlockQuote`, [Block-level structure elements](#block-level-structure-elements) | +| `TOC` | Container for table of contents entries. Can be used either as a flat hierarchy (all contained `TOCI` on one level) or as a complex hierarchy (`TOC` within a `TOCI` as a subgroup). Can be contained multiple times in a document, since it can also be used for image or table directories. | `Document`, `Part`, `Art`, `Sect`, `Div`| `TOCI` | +| `TOCI` | Entry within a table of contents (`TOC`). | `TOC` | `TOC`, `P`, `Lbl`, `Reference` | +| `Index` | Container for a subject index |`Document`, `Part`, `Art`, `Sect`, `Div` | `L` | + +
## Block-level structure elements ### Paragraph elements -#### P - - - - - - - - - - - - - - -
Semantische BedeutungOrdinary paragraph
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote, Caption, TOCI
Mögliche und semantisch sinnvolle KindelementeInline-level structure elements
- -#### H1, H2, H3, H4, H5, H6 - - - - - - - - - - - - - - -
Semantische BedeutungHierarchical headings on levels 1 to 6
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote
Mögliche und semantisch sinnvolle KindelementeInline-level structure elements
+
+ +| PDF tag | Semantic meaning | Possible and semantically meaningful parent elements | Possible and semantically meaningful child elements | +|:--|:--|:--|:--| +| `P` | Ordinary paragraph | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote`, `Caption`, `TOCI` | [Inline-level structure elements](#inline-level-structure-elements) | +| `H1`, `H2`, `H3`, `H4`, `H5`, `H6` | Hierarchical headings on levels 1 to 6 | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote` | [Inline-level structure elements](#inline-level-structure-elements) | + +
### List elements -#### L - - - - - - - - - - - - - - -
Semantische BedeutungList container; groups together all list elements that belong together
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote, Index
Mögliche und semantisch sinnvolle KindelementeLI, Caption
- -#### LI - - - - - - - - - - - - - - -
Semantische BedeutungContainer of a list entry; can contain an L to create multi-level lists
Mögliche und semantisch sinnvolle ElternelementeL
Mögliche und semantisch sinnvolle KindelementeLbl, LBody, L
- -#### Lbl - - - - - - - - - - - - - - -
Semantische BedeutungComes from the term “label” and represents the numbering or bullet character within a list. It’s not actually a block-level structure element and can also be used in other elements such as TOCI or Caption.
Mögliche und semantisch sinnvolle ElternelementeLI
Mögliche und semantisch sinnvolle Kindelemente–
- -#### LBody - - - - - - - - - - - - - - -
Semantische BedeutungContains the contents of a list entry
Mögliche und semantisch sinnvolle ElternelementeLI
Mögliche und semantisch sinnvolle KindelementeInline-level structure elements
+
+ +| PDF tag | Semantic meaning | Possible and semantically meaningful parent elements | Possible and semantically meaningful child elements | +|:--|:--|:--|:--| +| `L` | List container; groups together all list elements that belong together | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote`, `Index` | `LI`, `Caption` | +| `LI` | Container of a list entry; can contain an `L` to create multi-level lists | `L` | `Lbl`, `LBody`, `L` | +| `Lbl` | Comes from the term “label” and represents the numbering or bullet character within a list. *It’s not actually a block-level structure element and can also be used in other elements such as `TOCI` or `Caption`.* | `LI` | – | +| `LBody` | Contains the contents of a list entry | `LI` | [Inline-level structure elements](#inline-level-structure-elements) | + +
### Tabellenelemente -#### Table - - - - - - - - - - - - - - -
Semantische BedeutungTable container; combines all related table elements
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote
Mögliche und semantisch sinnvolle KindelementeTR, Caption, THead, TBody, TFoot
- -#### TR - - - - - - - - - - - - - - -
Semantische BedeutungGroups a table row
Mögliche und semantisch sinnvolle ElternelementeTable, THead, TBody, TFoot
Mögliche und semantisch sinnvolle KindelementeTH, TD
- -#### TH - - - - - - - - - - - - - - -
Semantische BedeutungTable heading cell; describes the meaning either at horizontal (line) or vertical (column) level
Mögliche und semantisch sinnvolle ElternelementeTR
Mögliche und semantisch sinnvolle KindelementeInline-level structure elements
- -#### TD - - - - - - - - - - - - - - -
Semantische BedeutungOrdinary table data cells
Mögliche und semantisch sinnvolle ElternelementeTR
Mögliche und semantisch sinnvolle KindelementeInline-level structure elements
- -#### THead - - - - - - - - - - - - - - -
Semantische BedeutungA group of table rows (TR) to mark them as table header; can be used optionally
Mögliche und semantisch sinnvolle ElternelementeTable
Mögliche und semantisch sinnvolle KindelementeTR
- -#### TBody - - - - - - - - - - - - - - -
Semantische BedeutungA group of table rows (TR) to mark them as table content; can be used optionally
Mögliche und semantisch sinnvolle ElternelementeTable
Mögliche und semantisch sinnvolle KindelementeTR
- -#### TFoot - - - - - - - - - - - - - - -
Semantische BedeutungA group of table rows (TR) to mark them as table footer; can be used optionally
Mögliche und semantisch sinnvolle ElternelementeTable
Mögliche und semantisch sinnvolle KindelementeTR
+
+ +| PDF tag | Semantic meaning | Possible and semantically meaningful parent elements | Possible and semantically meaningful child elements | +|:--|:--|:--|:--| +| `Table` | Table container; combines all related table elements | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote` | `TR`, `Caption`, `THead`, `TBody`, `TFoot` | +| `TR` | Groups a table row | `Table`, `THead`, `TBody`, `TFoot` | `TH`, `TD` | +| `TH` | Table heading cell; describes the meaning either at horizontal (line) or vertical (column) level | `TR` | [Inline-level structure elements](#inline-level-structure-elements) | +| `TD` | Ordinary table data cells | `TR` | [Inline-level structure elements](#inline-level-structure-elements) | +| `THead` | A group of table rows (`TR`) to mark them as table header; can be used optionally | `Table` | `TR` | +| `TBody` | A group of table rows (`TR`) to mark them as table content; can be used optionally | `Table` | `TR` | +| `TFoot` | A group of table rows (`TR`) to mark them as table footer; can be used optionally | `Table` | `TR` | + +
## Inline-level structure elements -### Span - - - - - - - - - - - - - - -
Semantische BedeutungGeneric container without semantic meaning; is used, among other things, for visual markups, language changes or for adding ActualText (e.g. for ignoring hyphens)
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD, Quote, Note
Mögliche und semantisch sinnvolle Kindelemente–
- -### Quote - - - - - - - - - - - - - - -
Semantische BedeutungUsed like BlockQuote for quoted content; however, Quote is used at line level
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle KindelementeSpan
- -### Note - - - - - - - - - - - - - - -
Semantische BedeutungFootnote or endnote text (not the reference character in the body text). The footer/end-note character within Note and Reference will be placed in a Lbl.
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle KindelementeLbl, P, Span
- -### Reference - - - - - - - - - - - - - - -
Semantische BedeutungRefers to another place in the document, e.g. footnote or directory entry
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle KindelementeLbl
- -### Code - - - - - - - - - - - - - - -
Semantische BedeutungMarking of programming language
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle Kindelemente–
- -### Link - - - - - - - - - - - - - - -
Semantische BedeutungLink to a web page or to a place within the document
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle Kindelemente–
- -### Annot - - - - - - - - - - - - - - -
Semantische BedeutungAnnotations that are not a link or a widget (form field), like comments and videos.
Mögliche und semantisch sinnvolle ElternelementeP, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle Kindelemente–
+
+ +| PDF tag | Semantic meaning | Possible and semantically meaningful parent elements | Possible and semantically meaningful child elements | +|:--|:--|:--|:--| +| `Span` | Generic container without semantic meaning; is used, among other things, for visual markups, language changes or for adding ActualText (e.g. for ignoring hyphens) | `P`, `H1`–`H6`, `LBody`, `TD`, `Quote`, `Note` | – | +| `Quote` | Used like `BlockQuote` for quoted content; however, `Quote` is used at line level | `P`, `H1`–`H6`, `LBody`, `TD` | `Span` | +| `Note` | Footnote or endnote text (not the reference character in the body text). The footer/end-note character within `Note` and `Reference` will be placed in a `Lbl`. | `P`, `H1`–`H6`, `LBody`, `TD` | `Lbl`, `P`, `Span` | +| `Reference` | Refers to another place in the document, e.g. footnote or directory entry | `P`, `H1`–`H6`, `LBody`, `TD` | `Lbl` | +| `Code` | Marking of programming language | `P`, `H1`–`H6`, `LBody`, `TD` | – | +| `Link` | Link to a web page or to a place within the document | `P`, `H1`–`H6`, `LBody`, `TD` | – | +| `Annot` | Annotations that are not a link or a widget (form field), like comments and videos. | `P`, `H1`–`H6`, `LBody`, `TD` | – | + +
## Illustration elements -### Figure - - - - - - - - - - - - - - -
Semantische BedeutungPhoto or graphic
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote, P, LBody, TD
Mögliche und semantisch sinnvolle Kindelemente–
- -### Formula - - - - - - - - - - - - - - -
Semantische BedeutungMathematical formula
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, BlockQuote, P, H1–H6, LBody, TD
Mögliche und semantisch sinnvolle Kindelemente–
- -### Form - - - - - - - - - - - - - -
Semantische BedeutungForm element
Mögliche und semantisch sinnvolle ElternelementeDocument, Part, Art, Sect, Div, P, TD
Mögliche und semantisch sinnvolle Kindelemente–
\ No newline at end of file +
+ +| PDF tag | Semantic meaning | Possible and semantically meaningful parent elements | Possible and semantically meaningful child elements | +|:--|:--|:--|:--| +| `Figure` | Photo or graphic | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote`, `P`, `LBody`, `TD` | – | +| `Formula` | Mathematical formula | `Document`, `Part`, `Art`, `Sect`, `Div`, `BlockQuote`, `P`, `H1`–`H6`, `LBody`, `TD` | – | +| `Form` | Form element | `Document`, `Part`, `Art`, `Sect`, `Div`, `P`, `TD` | – | + +
\ No newline at end of file From 5ee7c9cb8ee5320f2084320e099ff1291e16f113 Mon Sep 17 00:00:00 2001 From: pixelstrolch Date: Sun, 6 Jun 2021 17:15:55 +0200 Subject: [PATCH 10/23] Add start pages for basics and troubleshooting #34 --- content/basics/index.de.mdx | 56 ++++++++++++++++++++++++++++++++++ content/basics/index.en.mdx | 56 ++++++++++++++++++++++++++++++++++ content/tutorials/index.de.mdx | 40 ++++++++++++++++++++++++ content/tutorials/index.en.mdx | 40 ++++++++++++++++++++++++ src/components/mainnav.js | 4 +-- 5 files changed, 194 insertions(+), 2 deletions(-) create mode 100644 content/basics/index.de.mdx create mode 100644 content/basics/index.en.mdx create mode 100644 content/tutorials/index.de.mdx create mode 100644 content/tutorials/index.en.mdx diff --git a/content/basics/index.de.mdx b/content/basics/index.de.mdx new file mode 100644 index 00000000..8545dfc6 --- /dev/null +++ b/content/basics/index.de.mdx @@ -0,0 +1,56 @@ +--- +title: Grundlagen +slug: /basics +lang: de-CH +template: basics +author: Stefan Brechbühl +date: 2021-06-05 +description: Wer kennt es nicht? Steigt man in ein neues Thema ein, ist man schnell von der Menge und Komplexität der Informationen überfordert. In diesem Grundlagen-Bereich bist du genau richtig um mit der Erstellung von barrierefreien Dokumenten loszulegen. +--- + +Wer kennt es nicht? Steigt man in ein neues Thema ein, ist man schnell von der Menge und Komplexität der Informationen überfordert. In diesem Grundlagen-Bereich bist du genau richtig um mit der Erstellung von barrierefreien Dokumenten loszulegen. + +Aber nicht nur blutigen Anfängerinnen und Anfängern soll hier geholfen werden. Die Grundlagen decken auch technische Themen ab und helfen fortgeschrittenen Anwenderinnen und Anwendern als Nachschlagewerk. + +Im Moment werden auf [accessible-pdf.info](/de) zwei Programme für die Erstellung von PDF-Dokumenten behandelt, nämlich Adobe InDesign und Microsoft Word. Daher werden die Grundlagen in folgende Unterbereiche gegliedert: + +## Allgemeine Anleitungen + +Hier sind Beiträge enthalten, die keinem spezifischen Programm zugeordnet werden können. + +- [Strukturieren mithilfe von hierarchischen Überschriften](/de/basics/general/structure-with-the-help-of-multi-level-headings) +- [Semantik und logische Lesereihenfolge prüfen](/de/basics/general/check-semantics-and-logical-reading-order) +- [Übersicht der PDF-Tags](/de/basics/general/overview-of-the-pdf-tags) + + + Leseempfehlung: Für einen allerersten Einstieg wird der erste, kurze Beitrag + wärmstens empfohlen. Da es beim zweiten Beitrag um die Prüfung des Dokuments geht, kann dieser gut + später, nach den programmspezifischen Anleitungen, gelesen werden. Der dritte Beitrag ist + technisch und zu Beginn nicht wichtig. + + +## InDesign spezifische Anleitungen + +Wer Dokumente aus dem Desktop-Publishing Programm InDesign von Adobe erstellt, findet hier entsprechende Anleitungen. + +- [PDF-Tags in InDesign festlegen](/de/basics/indesign/defining-pdf-tags-in-indesign) +- [Logische Lesereihenfolge in InDesign festlegen](/de/basics/indesign/defining-logical-reading-order-in-indesign) +- [Artefakte in InDesign festlegen](/de/basics/indesign/defining-artifacts-in-indesign) + +## Word spezifische Anleitungen + +Wer Dokumente aus dem Textverarbeitungsprogramm Word von Microsoft erstellt, findet hier entsprechende Anleitungen. + +- [PDF-Tags in Word festlegen](/de/basics/word/defining-pdf-tags-in-word) +- [Artefakte in Word festlegen](/de/basics/word/defining-artifacts-in-word) + +## Acrobat spezifische Anleitungen + +Wie besser das Dokument in InDesign oder Word erstellt wurde, desto weniger Arbeit fällt bei der Nachbearbeitung in Acrobat Pro an. + +Es gibt auch die Möglichkeit die Barrierfreiheit erst nach der Konvertierung zu einem PDF zu beachten. Dies wird aber wenn immer möglich nicht empfohlen. + +- [Generelles Arbeiten mit PDF-Tags in Acrobat](/de/basics/acrobat/general-working-with-pdf-tags-in-acrobat) +- [PDF-Tags in Acrobat erstellen und ändern](/de/basics/acrobat/create-and-modify-pdf-tags-in-acrobat) +- [Logische Lesereihenfolge in Acrobat anpassen](/de/basics/acrobat/adjust-logical-reading-order-in-acrobat) +- [Artefakte in Acrobat erstellen und prüfen](/de/basics/acrobat/create-and-check-artifacts-in-acrobat) diff --git a/content/basics/index.en.mdx b/content/basics/index.en.mdx new file mode 100644 index 00000000..fde743c0 --- /dev/null +++ b/content/basics/index.en.mdx @@ -0,0 +1,56 @@ +--- +title: Basics +slug: /basics +lang: en +template: basics +author: Stefan Brechbühl +date: 2021-06-06 +description: Who doesn’t feel this way? When you get into a new topic, you are quickly overwhelmed by the amount and complexity of information. In this basics section you are exactly right to get started with the production of accessible documents. +--- + +Who doesn’t feel this way? When you get into a new topic, you are quickly overwhelmed by the amount and complexity of information. In this basics section you are exactly right to get started with the production of accessible documents. + +But not only absolute beginners will be helped here. The basics also cover technical topics and help advanced users as a reference guide. + +At the moment, [accessible-pdf.info](/) covers two applications for creating PDF documents, namely Adobe InDesign and Microsoft Word. Therefore, the basics are divided into the following subsections: + +## General tutorials + +Posts that cannot be assigned to a specific application are listed here. + +- [Structure with the help of multi-level headings](/basics/general/structure-with-the-help-of-multi-level-headings) +- [Check semantics and logical reading order](/basics/general/check-semantics-and-logical-reading-order) +- [Overview of the PDF tags](/basics/general/overview-of-the-pdf-tags) + + + Reading recommendation: For a very first start, the first, short article is + highly recommended. Since the second contribution is about testing the document, this can be read + well later, after the application-specific instructions, been read. The third article is technical + and not important at the beginning. + + +## InDesign specific tutorials + +Those who create documents from Adobe’s desktop publishing program InDesign will find appropriate instructions here. + +- [Defining PDF tags in InDesign](/basics/indesign/defining-pdf-tags-in-indesign) +- [Defining logical reading order in InDesign](/basics/indesign/defining-logical-reading-order-in-indesign) +- [Defining artifacts in InDesign](/basics/indesign/defining-artifacts-in-indesign) + +## Word specific tutorials + +Those who create documents from Microsoft’s Word text processing program will find appropriate instructions here. + +- [Defining PDF tags in Word](/basics/word/defining-pdf-tags-in-word) +- [Defining artifacts in Word](/basics/word/defining-artifacts-in-word) + +## Acrobat specific tutorials + +The better the document was created in InDesign or Word, the less work is required for post-processing in Acrobat Pro. + +There is also the option to consider accessibility only after converting to a PDF. However, this is not recommended whenever possible. + +- [General working with PDF tags in Acrobat](/basics/acrobat/general-working-with-pdf-tags-in-acrobat) +- [Create and modify PDF tags in Acrobat](/basics/acrobat/create-and-modify-pdf-tags-in-acrobat) +- [Adjust logical reading order in Acrobat](/basics/acrobat/adjust-logical-reading-order-in-acrobat) +- [Create and check artifacts in Acrobat](/basics/acrobat/create-and-check-artifacts-in-acrobat) diff --git a/content/tutorials/index.de.mdx b/content/tutorials/index.de.mdx new file mode 100644 index 00000000..c5dbd8ea --- /dev/null +++ b/content/tutorials/index.de.mdx @@ -0,0 +1,40 @@ +--- +title: Problemlösungen +slug: /tutorials +lang: de-CH +template: tutorials +author: Stefan Brechbühl +date: 2021-06-06 +description: In diesem Bereich geht um Probleme, die im Zusammenhang mit der Erstellung von PDF/UA-konformen Dokumenten entstehen können. Die Probleme bestehen meist, weil die Erstellungsprogramme (noch) nicht optimal für die Ausgabe von barrierefreien PDFs ausgestattet sind. +--- + +In diesem Bereich geht um Probleme, die im Zusammenhang mit der Erstellung von PDF/UA-konformen Dokumenten entstehen können. Die Probleme bestehen meist, weil die Erstellungsprogramme (noch) nicht optimal für die Ausgabe von barrierefreien PDFs ausgestattet sind. + +## Allgemeine Anleitungen + +Hier sind Probleme und Lösungswege dokumentiert, die allgemein gültig sind und keinem spezifischen Programm zugeordnet sind. + +- [Dokumenttitel ist nicht gesetzt](/de/tutorials/general/document-title-is-not-set) +- [Falsche Anzeigereihenfolge lässt Inhalte verschwinden](/de/tutorials/general/incorrect-display-order-makes-contents-disappear) +- [Liste ist nicht als Liste getaggt](/de/tutorials/general/list-is-not-tagged-as-list) +- [PDF/UA-Identifier fehlt](/de/tutorials/general/pdf-ua-identifier-is-missing) +- [Übersprungene Überschriftsebenen](/de/tutorials/general/skipped-heading-levels) + +## InDesign spezifische Anleitungen + +Wer Dokumente aus dem Desktop-Publishing Programm InDesign von Adobe erstellt, findet hier Problembeschreibungen und Lösungswege dafür. + +- [Verankerte Objekte nicht getaggt](/de/tutorials/indesign/anchored-objects-not-tagged) + +## Word spezifische Anleitungen + +Wer Dokumente aus dem Textverarbeitungsprogramm Word von Microsoft erstellt, findet hier Problembeschreibungen und Lösungswege dafür. + +- [Geteilte Block-Elemente](/de/tutorials/word/divided-block-elements) +- [Document ist nicht Tag auf oberster Ebene](/de/tutorials/word/document-is-not-the-top-level-tag) +- [Figure ohne Begrenzungsrahmen](/de/tutorials/word/figure-without-bounding-box) +- [Überschriften-Tags anstatt TOCI innerhalb von TOC](/de/tutorials/word/heading-tags-instead-of-toci-within-toc) +- [Bild als Block-Element](/de/tutorials/word/image-as-block-element) +- [Kein Figure Tag im Kompatibilitätsmodus](/de/tutorials/word/no-figure-tag-in-compatibility-mode) +- [Getaggte Bilder in Kopf- und Fusszeile](/de/tutorials/word/tagged-image-in-header-or-footer) +- [Getaggte Tabellenlinien](/de/tutorials/word/tagged-table-lines) \ No newline at end of file diff --git a/content/tutorials/index.en.mdx b/content/tutorials/index.en.mdx new file mode 100644 index 00000000..cac2b998 --- /dev/null +++ b/content/tutorials/index.en.mdx @@ -0,0 +1,40 @@ +--- +title: Troubleshooting +slug: /tutorials +lang: en +template: tutorials +author: Stefan Brechbühl +date: 2021-06-06 +description: This section deals with problems that can occur in relation to the production of PDF/UA-compliant documents. The problems mostly exist because the creation applications are not (yet) best configured for the output of accessible PDFs. +--- + +This section deals with problems that can occur in relation to the production of PDF/UA-compliant documents. The problems mostly exist because the creation applications are not (yet) best configured for the output of accessible PDFs. + +## General tutorials + +This is where problems and solutions are documented that are generally valid and are not assigned to any specific application. + +- [Document title isn’t set](/tutorials/general/document-title-is-not-set) +- [Incorrect display order makes contents disappear](/tutorials/general/incorrect-display-order-makes-contents-disappear) +- [List is not tagged as list](/tutorials/general/list-is-not-tagged-as-list) +- [PDF/UA identifier is missing](/tutorials/general/pdf-ua-identifier-is-missing) +- [Skipped heading levels](/tutorials/general/skipped-heading-levels) + +## InDesign specific tutorials + +For those who create documents from Adobe’s desktop publishing application InDesign, here are problem descriptions and solutions for them. + +- [Anchored objects not tagged](/tutorials/indesign/anchored-objects-not-tagged) + +## Word specific tutorials + +For those who create documents from Microsoft’s Word text processing program, here you will find problem descriptions and solutions for them. + +- [Divided block elements](/tutorials/word/divided-block-elements) +- [Document isn’t the top-level tag](/tutorials/word/document-is-not-the-top-level-tag) +- [Figure without Bounding Box](/tutorials/word/figure-without-bounding-box) +- [Heading tags instead of TOCI within TOC](/tutorials/word/heading-tags-instead-of-toci-within-toc) +- [Image as block element](/tutorials/word/image-as-block-element) +- [No Figure tag in compatibility mode](/tutorials/word/no-figure-tag-in-compatibility-mode) +- [Tagged image in header or footer](/tutorials/word/tagged-image-in-header-or-footer) +- [Tagged table lines](/tutorials/word/tagged-table-lines) diff --git a/src/components/mainnav.js b/src/components/mainnav.js index 736ae5cd..a70c811b 100644 --- a/src/components/mainnav.js +++ b/src/components/mainnav.js @@ -13,12 +13,12 @@ const MainNav = () => {