Online Dokumentation

Kurzbeschreibung

Mit der Anwendung werden „alternative Texte“ für Grafiken und Bilder automatisch erzeugt. Diese Beschreibungen sind zwingende Voraussetzungen bei der Erstellung barrierefreier PDF und werden durch Screenreader beim Vorlesen einer PDF verwendet.

Installation

Mit Hilfe des Installer wird die Anwendung mit allen notwendigen Komponenten auf die Festplatte kopiert und kann über die Systemsteuerung bei Bedarf wieder entfernt werden.

Die Ablage der Programmdateien erfolgt in dem Ordner: „C:\ProgramData\Actino Software GmbH\AlternateTextCreator“

Lizenzierung OpenAI

Zur Erstellung der „alternativen Texte“ wird OpenAI genutzt. Aus diesem Grund benötigen die Anwender ein Konto mit Budget sowie einen Key für die Nutzung der Web API.

Mit jedem Aufruf werden diese Daten übergeben und die Nutzung anhand der Anzahl verbrauchter Token abgerechnet. Der Defaultwert für den maximalen Verbrauch sind 150, mit dem ein sehr gutes Ergebnis erzielt wird. Bei umfangreichen Grafiken wie z.B. Balkendiagrammen kann die Erhöhung auf z.B. 300 sinnvoll sein, damit die Grafik bis ins letzte Detail beschrieben wird.

Vorbereitung der PDF

Die PDF-Dokumente sollten im Vorwege vollständig und standardkonform getaggt werden. Die relevanten Bilder oder Grafiken müssen mit einem „Figure“ Tag versehen werden, da genau dieser Bereich als Bild an OpenAI übergeben werden.

Abb. Getaggte PDF, so dass die alternativen Texte automatisch dem Figure Tag hinzugefügt werden können.

Anwendung – Parameter Befehlszeile

Die Applikation wird mit Hilfe einer Befehlszeile wie folgt aufgerufen:

atc.exe –pdf „C:\…\Input.pdf“ –pdfOut „C:\…\Output.pdf“ -k „sk-xxxxxxxxxx“

Insgesamt stehen folgende Parameter zur Verfügung:

-i, –pdf –> Vollständiger Pfad zu dem zu bearbeitenden PDF (Required).

-o, –pdfOut –> Vollständiger Pfad zu dem bearbeiteten PDF (Required).

-k, –openAIAPIKey –> OpenAI API-Key (Required). 

-x, –tagsDelete –> Alle Tags vor der Verarbeitung aus dem PDF entfernen (Default: False). 

-a, –tagsAdd –> Tags vor der Verarbeitung automatisch erstellen (Default: False). 

-l, –outputLanguage –> Ausgabesprache für den alternativen Text wie z.B. DE oder EN (Default: DE). 

-p, –openAIPrompt -> Nur englisch. Hebt den Sprachparameter auf. Pfad zu einer Textdatei, die den Custom AI Prompt beinhaltet (Default: False).

-n, –noAPICall –> Es erfolgt kein API-Call. Es wird lediglich ein Testtext gesetzt (Default: False). 

-u, –saveImages –> Pfad angeben, in dem die gefundenen Bilder gespeichert werden (Default: False).

-t, –> Maximale Anzahl an Token, die zur Erstellung des Text eingesetzt werden (Default 150).

–help –> Anzeige Hilfe (Default: False). 

–version –> Anzeige Versionsinformation (Default: False).