Merge pull request #35 from pixelstrolch/v2.1.0

v2.1.0

.prettierrc.js

@@ -0,0 +1,3 @@
+module.exports = {
+  ...require("@pixelstrolch/prettier-config"),
+};

CONTRIBUTING.md

@@ -1,3 +1,5 @@
+[Zur deutschen Übersetzung](https://github.com/pixelstrolch/accessible-pdf/blob/public/_DE_Mithelfen.md) (Link to the German translation)
+
 # Contributors Guide
 
 Please read and understand the contribution guide before writing an issue or pull request.

content/basics/acrobat/add-an-alt-text-in-acrobat/index.de.mdx

@@ -0,0 +1,37 @@
+---
+title: Alt-Texte in Acrobat hinzufügen
+slug: /basics/acrobat/add-an-alt-text-in-acrobat
+lang: de-CH
+template: basics
+author: Stefan Brechbühl
+date: 2021-06-09
+description: Ein Alt-Text (kurz für Alternativtext) beschreibt ein Nicht-Textelement, wie ein Foto oder eine Grafik. In dieser Anleitung schauen wir uns an, wie ein Alt-Text in Acrobat hinzugefügt wird.
+---
+
+Ein Alt-Text (kurz für Alternativtext) beschreibt ein Nicht-Textelement, wie ein Foto oder eine Grafik. Der unsichtbare Text kann durch Software, insbesondere [assistive Technologie (AT)](/de/glossary/#assistive-technologie), ausgelesen und wiedergegeben werden.
+
+Im Glossar kannst du mehr darüber erfahren was ein [Alt-Text](/de/glossary/#alt-text) ist und wie er aussehen sollte. In dieser Anleitung schauen wir uns an, wie ein Alt-Text in Acrobat hinzugefügt wird.
+
+## Besser im Quelldokument
+
+Wie es auch generell für das _Taggen_ von Dokumenten gilt, wird das Hinzufügen von Alt-Texten besser im Quelldokument gemacht. Dies weil bei erneuter PDF-Erstellung sämtliche Arbeiten in Acrobat wiederholt werden müssen.
+
+Bei den folgenden Lösungswegen wird vorausgesetzt, dass die Bilder bereits _getaggt_ wurden. Falls du weitere Infos dazu benötigst, sehe dir folgende Beiträge an:
+
+- [PDF-_Tags_ in Word festlegen](/de/basics/word/defining-pdf-tags-in-word/)
+- [PDF-_Tags_ in InDesign festlegen](/de/basics/indesign/defining-pdf-tags-in-indesign/)
+- [PDF-_Tags_ in Acrobat erstellen und ändern](/de/basics/acrobat/create-and-modify-pdf-tags-in-acrobat/)
+
+### Lösungsvariante 1
+
+1. Öffne das Navigationsfenster „Tags“.
+2. Navigiere zum betroffenen `<Figure>` _Tag_.
+3. Mache einen Rechtsklick auf diesem _Tag_ und wähle „Eigenschaften“.
+4. Ergänze den Alt-Text im Register „Tag“ und der Rubrik „Alternativtext“.
+
+### Lösungsvariante 2
+
+1. Klicke auf „Leserichtung“ innerhalb der „Barrierefreiheit“-Werkzeuge.
+2. Es öffnet sich ein neues Fenster „Leserichtung“ und die Inhalte werden in verschiedenen grauen Flächen dargestellt.
+3. Mache einen Rechtsklick auf die graue Fläche in welcher sich dein Bild befindet.
+4. Wähle „Alternativtext bearbeiten“ und füge deinen Alt-Text im neu geöffneten Fenster „Alternativtext“.

content/basics/acrobat/add-an-alt-text-in-acrobat/index.en.mdx

@@ -0,0 +1,37 @@
+---
+title: Add an alt text in Acrobat
+slug: /basics/acrobat/add-an-alt-text-in-acrobat
+lang: en
+template: basics
+author: Stefan Brechbühl
+date: 2021-06-09
+description: An alt text (short for alternative text) describes a non-text element, such as a photo or graphic. In this tutorial, we’ll look how to add an alt text in Acrobat.
+---
+
+An alt text (short for alternative text) describes a non-text element, such as a photo or graphic. The invisible text can be read and rendered by software, especially [assistive technology (AT)](/glossary/#assistive-technology).
+
+In the glossary you can learn more about what an [alt text](/glossary/#alt-text) is and how it should look like. In this tutorial, we’ll look how to add an alt text in Acrobat.
+
+## Better in the source document
+
+As it is generally the case for tagging documents, the process of adding alt texts is better done in the source document. The reason for this is that all work in Acrobat must be repeated when the PDF is created again.
+
+The following solutions assume that the images have already been tagged. If you need more information about this, have a look at the following articles:
+
+- [Defining PDF tags in Word](/basics/word/defining-pdf-tags-in-word/)
+- [Defining PDF tags in InDesign](/basics/indesign/defining-pdf-tags-in-indesign/)
+- [Create and modify PDF tags in Acrobat](/basics/acrobat/create-and-modify-pdf-tags-in-acrobat/)
+
+### Solution 1
+
+1. Open the navigation pane “Tags”.
+2. Navigate to the affected `<Figure>` tag.
+3. Right click on this tag and select “Properties”.
+4. Add the alt text in the tab “Tag” and the column “Alternate text”.
+
+### Solution 2
+
+1. Click on “Reading Order” within the “Accessibility” tools.
+2. A new window “Reading Order” opens and the contents are displayed in different grey areas.
+3. Right-click on the grey area in which your image is located.
+4. Select “Edit Alternate Text” and write your alt text into the newly opened “Alternate Text” window.

content/basics/acrobat/adjust-logical-reading-order-in-acrobat/index.de.mdx

@@ -8,35 +8,40 @@ date: 2019-12-09
 description: PDF-Tags werden nicht nur benötigt um Inhalten eine semantische Bedeutung zu geben, sondern auch auch um die logische Lesereihenfolge festzulegen. In Acrobat kann die Reihenfolge der Tags im Tagbaum angepasst werden.
 ---
 
-PDF-*Tags* werden nicht nur benötigt um Inhalten eine semantische Bedeutung zu geben, sondern auch auch um die logische Lesereihenfolge festzulegen. In Acrobat kann die Reihenfolge der *Tags* im *Tag*baum angepasst werden.
+PDF-_Tags_ werden nicht nur benötigt um Inhalten eine semantische Bedeutung zu geben, sondern auch auch um die logische Lesereihenfolge festzulegen. In Acrobat kann die Reihenfolge der _Tags_ im *Tag*baum angepasst werden.
 
 <NoteMessage>
-Was bedeutet <Link to="/de/glossary/#logische-lesereihenfolge">logische Lesereihenfolge</Link>? Erfahre mehr im Glossar.
+  Was bedeutet <Link to="/de/glossary/#logische-lesereihenfolge">logische Lesereihenfolge</Link>?
+  Erfahre mehr im Glossar.
 </NoteMessage>
 
 <NoteMessage>
-Softwarehinweis: Um mit den <em>Tags</em> arbeiten zu können, wird der kostenpflichtige <a href="https://acrobat.adobe.com/ch/de/acrobat.html">Adobe Acrobat</a> benötigt. Mit dem kostenlosen <a href="https://get.adobe.com/de/reader/">Adobe Acrobat Reader</a> können <em>Tags</em> weder geprüft noch geändert werden.
+  Softwarehinweis: Um mit den <em>Tags</em> arbeiten zu können, wird der kostenpflichtige{" "}
+  <a href="https://acrobat.adobe.com/ch/de/acrobat.html">Adobe Acrobat</a> benötigt. Mit dem
+  kostenlosen <a href="https://get.adobe.com/de/reader/">Adobe Acrobat Reader</a> können{" "}
+  <em>Tags</em> weder geprüft noch geändert werden.
 </NoteMessage>
 
-## *Tag* in *Tag*baum verschieben
+## _Tag_ in *Tag*baum verschieben
 
-1. Klicke im Navigationsfenster „Tags“ auf den *Tag*, welcher sich an der falschen Stelle befindet und ziehe in an die richtige Position. 
-2. Während dem gedrückt halten wird eine schwarze Linie angezeigt und markiert wo der *Tag* beim Loslassen verschoben wird. 
-	- Wenn sich der kleine Pfeil der Linie ganz links befindet, wird der *Tag* beim Loslassen unterhalb und auf gleicher Ebene des darüber angezeigten *Tags*, verschoben.
-	- Wenn sich der kleine Pfeil der Linie weiter rechts befindet, wird der *Tag* beim Loslassen innerhalb des darüber angezeigten *Tags*, verschoben.
+1. Klicke im Navigationsfenster „Tags“ auf den _Tag_, welcher sich an der falschen Stelle befindet und ziehe in an die richtige Position.
+2. Während dem gedrückt halten wird eine schwarze Linie angezeigt und markiert wo der _Tag_ beim Loslassen verschoben wird.
+   - Wenn sich der kleine Pfeil der Linie ganz links befindet, wird der _Tag_ beim Loslassen unterhalb und auf gleicher Ebene des darüber angezeigten _Tags_, verschoben.
+   - Wenn sich der kleine Pfeil der Linie weiter rechts befindet, wird der _Tag_ beim Loslassen innerhalb des darüber angezeigten _Tags_, verschoben.
 
 <NoteMessage>
 Das Navigationsfenster „Tags“ lässt sich öffnen indem auf das Symbol mit dem Namensschild geklickt wird.
 
 <img src="/images/tag-icon.png" alt="Tag Icon in Acrobat" />
 
 Falls dieses in der linken Leiste noch nicht aufgeführt ist, kann es mit einem Rechtsklick oder unter „Anzeige“ → „Ein-/Ausblenden“ → „Navigationsfenster“ hinzugefügt und das Navigationsfenster angezeigt werden.
+
 </NoteMessage>
 
 ## Sich im *Tag*baum zurechtfinden
 
-Generelle Tipps wie du mit dem *Tag*baum arbeiten kannst, findest du unter [„Generelles Arbeiten mit PDF-*Tags* in Acrobat“](/de/basics/acrobat/general-working-with-pdf-tags-in-acrobat/).
+Generelle Tipps wie du mit dem *Tag*baum arbeiten kannst, findest du unter [„Generelles Arbeiten mit PDF-_Tags_ in Acrobat“](/de/basics/acrobat/general-working-with-pdf-tags-in-acrobat/).
 
 ## Prüfung ausserhalb von Acrobat
- 
-Indem der *Tag*baum in Acrobat geprüft wird, kann die logische Lesereihenfolge geprüft werden. Da dies nicht sehr komfortabel und unübersichtlich ist, sollte ein anderes *Tool* verwendet werden. Der Artikel [„Semantik und logische Lesereihenfolge prüfen“](/de/basics/general/check-semantics-and-logical-reading-order/) zeigt wie diese [manuelle Prüfung](/de/glossary/#manuelle-prüfung) besser gemacht werden kann.
+
+Indem der *Tag*baum in Acrobat geprüft wird, kann die logische Lesereihenfolge geprüft werden. Da dies nicht sehr komfortabel und unübersichtlich ist, sollte ein anderes _Tool_ verwendet werden. Der Artikel [„Semantik und logische Lesereihenfolge prüfen“](/de/basics/general/check-semantics-and-logical-reading-order/) zeigt wie diese [manuelle Prüfung](/de/glossary/#manuelle-prüfung) besser gemacht werden kann.

content/basics/acrobat/adjust-logical-reading-order-in-acrobat/index.en.mdx

@@ -11,32 +11,37 @@ description: PDF tags are not only needed to give content a semantic meaning, bu
 PDF tags are not only needed to give content a semantic meaning, but also to determine the logical reading order. In Acrobat, the order of the tags within the tag tree can be modified.
 
 <NoteMessage>
-What does <Link to="/glossary/#logical-reading-order">logical reading order</Link> mean? [Find out](glossary/#logical-reading-order) more in the glossary.
+  What does <Link to="/glossary/#logical-reading-order">logical reading order</Link> mean? [Find
+  out](glossary/#logical-reading-order) more in the glossary.
 </NoteMessage>
 
 <NoteMessage>
-Software hint: In order to work with the tags, <a href="https://acrobat.adobe.com/uk/en/acrobat.html">Adobe Acrobat</a> is required. With the free <a href="https://get.adobe.com/reader/">Adobe Acrobat Reader</a>, tags can neither be checked nor changed.
+  Software hint: In order to work with the tags,{" "}
+  <a href="https://acrobat.adobe.com/uk/en/acrobat.html">Adobe Acrobat</a> is required. With the
+  free <a href="https://get.adobe.com/reader/">Adobe Acrobat Reader</a>, tags can neither be checked
+  nor changed.
 </NoteMessage>
 
 ## Move a tag in the tag tree
 
 1. In the navigation pane “Tags”, click on the tag which is in the wrong position and drag it to the right position.
-2. While holding down, a black line is displayed and marks where the tag is moved when you release it. 
-	- If the small arrow of the line is on the far left, the tag will be moved below and on the same level as the tag displayed above.
-	- If the small arrow of the line is further to the right, the tag will be moved within the tag displayed above.
+2. While holding down, a black line is displayed and marks where the tag is moved when you release it.
+   - If the small arrow of the line is on the far left, the tag will be moved below and on the same level as the tag displayed above.
+   - If the small arrow of the line is further to the right, the tag will be moved within the tag displayed above.
 
 <NoteMessage>
 The navigation pane “Tags” can be opened by clicking on the icon with the name tag.
 
 <img src="/images/tag-icon.png" alt="Tag icon in Acrobat" />
 
 If this is not yet displayed in the left pane, it can be added with a right click or under “Display” → “Show/Hide” → “Navigation pane” and the navigation pane is displayed.
+
 </NoteMessage>
 
 ## Navigating within the tag tree
 
 For general tips on how to work with the tag tree, see [“General working with PDF tags in Acrobat”](/basics/acrobat/general-working-with-pdf-tags-in-acrobat/).
 
 ## Testing outside of Acrobat
- 
-By checking the tag tree in Acrobat, the logical reading order can be verified. Since this can be confusing and tedious, another tool should be used. The article [“Check semantics and logical reading order”](/basics/general/check-semantics-and-logical-reading-order/) shows how this [manual check](/glossary/#manual-testing) can be done in a better way.
+
+By checking the tag tree in Acrobat, the logical reading order can be verified. Since this can be confusing and tedious, another tool should be used. The article [“Check semantics and logical reading order”](/basics/general/check-semantics-and-logical-reading-order/) shows how this [manual check](/glossary/#manual-testing) can be done in a better way.

content/basics/acrobat/create-and-check-artifacts-in-acrobat/index.de.mdx

@@ -11,32 +11,36 @@ description: Dekorative und unwichtige Informationen müssen als Artefakt gekenn
 Dekorative und unwichtige Informationen müssen als Artefakt gekennzeichnet werden damit sie von [assistiver Technologie (AT)](/de/glossary/#assistive-technologie) ignoriert werden. Können Artefakte nicht bereits im Herstellungsprogramm definiert werden, muss dies in Acrobat manuell nachgeholt werden.
 
 <NoteMessage>
-Erfahre im Glossar was <Link to="/de/glossary/#Artefakt/">Artefakte</Link> sind und was Beispiele davon sind.
+  Erfahre im Glossar was <Link to="/de/glossary/#Artefakt/">Artefakte</Link> sind und was Beispiele
+  davon sind.
 </NoteMessage>
 
 Der effizienteste Weg ist jedoch die Artefakte bereits im Erstellungsprogramm zu bestimmen und beim PDF-Export mitzugeben. Hierzu stehen folgende Anleitungen zur Verfügung:
 
 - [Artefakte in InDesign festlegen](/de/basics/indesign/defining-artifacts-in-indesign/)
 - [Artefakte in Word festlegen](/de/basics/word/defining-artifacts-in-word/)
 
-In Acrobat können Artefakte entweder [im *Tagbaum*](#artefakt-in-navigationsfenster-tags-erstellen) oder mit [dem Leserichtung-Werkzeug](#artefakt-mit-leserichtung-werkzeug-erstellen) definiert werden. Welche Inhalte als Artefakte gekennzeichnet wurden, können im [Navigationsfenster „Inhalt“ je Seite geprüft](#artefakte-in-navigationsfenster-inhalt-prüfen) werden.
+In Acrobat können Artefakte entweder [im _Tagbaum_](#artefakt-in-navigationsfenster-tags-erstellen) oder mit [dem Leserichtung-Werkzeug](#artefakt-mit-leserichtung-werkzeug-erstellen) definiert werden. Welche Inhalte als Artefakte gekennzeichnet wurden, können im [Navigationsfenster „Inhalt“ je Seite geprüft](#artefakte-in-navigationsfenster-inhalt-prüfen) werden.
 
 <NoteMessage>
-Softwarehinweis: Um mit <em>Tags</em> und Artefakten arbeiten zu können, wird der kostenpflichtige <a href="https://acrobat.adobe.com/ch/de/acrobat.html">Adobe Acrobat</a> benötigt. Mit dem kostenlosen <a href="https://get.adobe.com/de/reader/">Adobe Acrobat Reader</a> können diese weder geprüft noch geändert werden.
+  Softwarehinweis: Um mit <em>Tags</em> und Artefakten arbeiten zu können, wird der kostenpflichtige{" "}
+  <a href="https://acrobat.adobe.com/ch/de/acrobat.html">Adobe Acrobat</a> benötigt. Mit dem
+  kostenlosen <a href="https://get.adobe.com/de/reader/">Adobe Acrobat Reader</a> können diese weder
+  geprüft noch geändert werden.
 </NoteMessage>
 
-## Artefakt in Navigationsfenster *Tags* erstellen
+## Artefakt in Navigationsfenster _Tags_ erstellen
 
-Bei dieser Anleitung ist die Ausgangslage ein vollständig *getaggtes* Dokument.
+Bei dieser Anleitung ist die Ausgangslage ein vollständig _getaggtes_ Dokument.
 
 1. Öffne das Navigationsfenster „Tags“.  
-Es lässt sich öffnen indem auf das Symbol mit dem Namensschild klickst.  
-![Tag Icon in Acrobat](/images/tag-icon.png)
-Falls dieses in der linken Leiste noch nicht aufgeführt ist, kann es mit einem Rechtsklick oder unter „Anzeige“ → „Ein-/Ausblenden“ → „Navigationsfenster“ hinzugefügt und das Navigationsfenster angezeigt werden.
+   Es lässt sich öffnen indem auf das Symbol mit dem Namensschild klickst.  
+   ![Tag Icon in Acrobat](/images/tag-icon.png)
+   Falls dieses in der linken Leiste noch nicht aufgeführt ist, kann es mit einem Rechtsklick oder unter „Anzeige“ → „Ein-/Ausblenden“ → „Navigationsfenster“ hinzugefügt und das Navigationsfenster angezeigt werden.
 2. Suche dir den dekorativen Inhalt innerhalb der Tags, siehe dazu auch „[Getaggter Text im Tagbaum finden](/de/basics/acrobat/general-working-with-pdf-tags-in-acrobat/#getaggter-text-im-tagbaum-finden)“ innerhalb von „[Generelles Arbeiten mit PDF-Tags in Acrobat](/de/basics/acrobat/general-working-with-pdf-tags-in-acrobat/)“
-3. Mache einen Rechtsklick auf den Inhalt (mit dem kleinen Kistensymbol) und wähle „*Tag* in aussertextliches Element ändern“. ![Kontextmenü mit ausgewählter Option „Tag in aussertextliches Element ändern“. Bildschirmfoto aus Acrobat.](acrobat-tag-in-aussertextliches-element-aendern.png)
-3. Der öffnende Dialog erlaubt dir noch die Art des Artefakt und dessen Seitenposition näher zu beschreiben. ![In den Artifact Optionen kann zwischen den Typen „Seite“, „Paginierung“ und „Layout“ unterschieden werden. Zusätzlich stehen vier Optionsfelder der Positionen zur Verfügung: Links, Oben, Rechts und Unten. Bildschirmfoto aus Acrobat.](acrobat-artefakt-optionen.png)
-4. Falls dieses Artefakt alleine innerhalb eines *Tags* platziert war, sollte das leere Tag noch gelöscht werden.
+3. Mache einen Rechtsklick auf den Inhalt (mit dem kleinen Kistensymbol) und wähle „_Tag_ in aussertextliches Element ändern“. ![Kontextmenü mit ausgewählter Option „Tag in aussertextliches Element ändern“. Bildschirmfoto aus Acrobat.](acrobat-tag-in-aussertextliches-element-aendern.png)
+4. Der öffnende Dialog erlaubt dir noch die Art des Artefakt und dessen Seitenposition näher zu beschreiben. ![In den Artifact Optionen kann zwischen den Typen „Seite“, „Paginierung“ und „Layout“ unterschieden werden. Zusätzlich stehen vier Optionsfelder der Positionen zur Verfügung: Links, Oben, Rechts und Unten. Bildschirmfoto aus Acrobat.](acrobat-artefakt-optionen.png)
+5. Falls dieses Artefakt alleine innerhalb eines _Tags_ platziert war, sollte das leere Tag noch gelöscht werden.
 
 ## Artefakt mit Leserichtung-Werkzeug erstellen
 
@@ -51,10 +55,16 @@ Mit dem Leserichtung-Werkzeug geht es schneller. Im Gegenzug kann man weniger pr
 
 ## Artefakte in Navigationsfenster „Inhalt“ prüfen
 
-Falls bereits *getaggte* Inhalte als Artefakte gekennzeichnet werden, verschwinden sie im „Tagbaum“. Artefakte sind jedoch im Navigationsfenster „Inhalt“ weiterhin vorhanden. Erkennbar sind sie durch die Kennzeichnung: „Container `<Artifact>` …“.
+Falls bereits _getaggte_ Inhalte als Artefakte gekennzeichnet werden, verschwinden sie im „Tagbaum“. Artefakte sind jedoch im Navigationsfenster „Inhalt“ weiterhin vorhanden. Erkennbar sind sie durch die Kennzeichnung: „Container `<Artifact>` …“.
 
 ![Das Navigationsfenster „Inhalt“ mit einem gekennzeichneten Artifact Container. Bildschirmfoto in Acrobat.](acrobat-artifact.png)
 
 <NoteMessage>
-Im Navigationsfenster „Inhalt“ liegt das Element, das sich an oberster Stelle befindet, auf der untersten Ebene. Die Reihenfolge dieser Auflistung und die Darstellungsebene ist daher umgekehrt. In diesem Zusammenhang kann folgendes Problem auftreten: „<Link to="/de/tutorials/general/incorrect-display-order-makes-contents-disappear/">Falsche Anzeigereihenfolge lässt Inhalte verschwinden</Link>“
-</NoteMessage>
+  Im Navigationsfenster „Inhalt“ liegt das Element, das sich an oberster Stelle befindet, auf der
+  untersten Ebene. Die Reihenfolge dieser Auflistung und die Darstellungsebene ist daher umgekehrt.
+  In diesem Zusammenhang kann folgendes Problem auftreten: „
+  <Link to="/de/tutorials/general/incorrect-display-order-makes-contents-disappear/">
+    Falsche Anzeigereihenfolge lässt Inhalte verschwinden
+  </Link>
+  “
+</NoteMessage>