Pagecraft

Erklärung zur Barrierefreiheit

Wenn Ihre Organisation eine Konformitätserklärung verlangt, bevor sie ein Werkzeug freigibt: Das hier ist sie. Sie ist aus dem geschrieben, was die Testsuite tatsächlich prüft, und nicht aus dem, was wir gern behaupten würden — und jeder Satz darin zeigt auf die Datei, die ihn prüft.

Was behauptet wird

Norm
WCAG 2.2
Stufe
AA, vollständig erfüllt, wobei jeder gewöhnliche Text an 7:1 gehalten wird — dem erhöhten Kontrastschwellenwert, also AAA. Für große Schrift gilt weiterhin der normale Schwellenwert, so wie das Erfolgskriterium selbst es sagt.
Was geprüft wurde
Jede Seite, die dieser Build veröffentlicht hat: 334 davon, in 4 Sprachen, jede einmal im hellen und noch einmal im dunklen Erscheinungsbild.
Zuletzt geprüft
Die Prüfungen unten laufen bei jeder Änderung; dies ist der Tag, an dem zuletzt jemand das ganze Ergebnis gelesen und diese Seite unterschrieben hat.

Was geprüft wurde, und wo jeder Teil geprüft wird

Fünf Dinge, über die ganze veröffentlichte Website statt über eine Stichprobe daraus. Die Seite eines Werkzeugs ist eine einzige Vorlage mit anderen Wörtern darin, deshalb sieht eine Stichprobe so aus, als würde sie genügen. Sie genügt nicht: Was kaputtgeht, sind die Wörter.

Wie Sie es selbst laufen lassen

Nichts davon muss geglaubt werden — derselbe Maßstab, an dem sich das Versprechen, nichts hochzuladen, auf der Seite „Wie es funktioniert“ messen lässt. Diese Website ist quelloffen und der Quelltext ist das ganze Produkt, die oben genannten Dateien lassen sich also öffnen, und sie laufen bei jeder Änderung in der Continuous Integration. Auf einer Arbeitskopie ist die ganze Suite ein einziger Befehl:

pnpm test:e2e

Ein Fehlschlag nennt die Seite, die Sprache, das Erscheinungsbild und das Element. Wenn Sie etwas finden, das diese Tests durchgehen lassen und Sie nicht, ist das ebenso ein Fehler in den Tests wie auf der Seite, und wir würden gern davon hören.

Die zwei schwierigsten Stellen

Eine Aussage über „die Website“ ist meist eine Aussage über die Seiten neben der schwierigen Stelle. Dies sind die beiden schwierigen Stellen, deshalb stehen sie hier einzeln.

Seiten von Hand neu ordnen

Der Seitenordner ist ein Raster von Seiten, die sich mit der Maus verschieben lassen, und alles, was ein Ziehen tut, geht auch ohne sie. Die Tabulatortaste erreicht das Raster einmal und nicht einmal je Seite; die Pfeiltasten bewegen eine Einfügemarke; die Leertaste wählt aus, die Eingabetaste hebt Seiten auf und legt sie ab, Escape legt sie dorthin zurück, wo sie waren, und Entfernen wirft sie weg. Jede dieser Aktionen sagt in einem Live-Bereich, was sie getan hat — „Jetzt bei 3 von 12.“, während eine Seite getragen wird, „Abgelegt bei 3 von 12.“, wenn sie landet, „Gelöscht: 1. Übrig: 11.“ — und jede Zelle trägt ihre eigene Position und die Gesamtzahl, sodass ein Screenreader von der Seite selbst liest, wo er ist, und nicht von einer Überschrift darüber. Diesen Weg geht ein Test ab; dieser Absatz behauptet ihn nur.

Geprüft in apps/web/tests/site/organize.spec.ts

Eine KI etwas über ein Dokument fragen

Die KI-Werkzeuge setzen einen Prüfschritt zwischen Fragen und Senden: Der genaue Text, der Ihren Browser verlassen würde, wird vollständig gezeigt, und es geht nichts hinaus, bis Sie den Knopf darunter drücken. Dieser Schritt ist ein echter Teil der Oberfläche und kein Bestätigungsfenster, also wird der ganze Weg durch ihn mit der Tabulatortaste und der Eingabetaste gegangen und mit sonst nichts: einen Tresor anlegen, einen Anbieter hinzufügen, ausrechnen lassen, was gesendet würde, es lesen, es senden und eine bereits laufende Anfrage abbrechen. Die Antwort erscheint in einem Live-Bereich, während sie geschrieben wird.

Geprüft in apps/web/tests/site/ai.spec.ts

Was weiterhin nicht funktioniert

Vier Dinge, deutlich benannt. Jedes ist von einem Test festgehalten, der behauptet, dass es weiterhin zutrifft — diese Liste kann also kein Produkt mehr beschreiben, das darüber hinweg ist: Wird eines behoben, schlägt der Build fehl, bis der Eintrag gelöscht ist.

Das Bild einer Seite ist nicht beschrieben

Worauf Sie stoßen
Überall, wo Seiten als Vorschaubilder erscheinen — vor allem im Seitenordner —, heißt jede nach ihrem Platz und der Datei, aus der sie kam: „Seite 3 von 12, aus deck.pdf Seite 3“. Das Bild selbst ist als Schmuck ausgezeichnet. Nichts sagt, was auf der Seite gedruckt steht, denn hier hat sie niemand gelesen.
Was Sie stattdessen tun können
Finden Sie zuerst heraus, was auf welcher Seite steht — mit PDF zu Text oder PDF durchsuchen, die beide die Seitenzahl nennen. Danach lässt sich der Seitenordner vollständig über Zahlen bedienen, und PDF-Seiten löschen, PDF-Seiten herausziehen und PDF-Seiten neu ordnen nehmen einen getippten Seitenbereich und zeigen überhaupt kein Vorschaubild.

Ein langes Dokument steht nur zum Teil auf der Seite

Worauf Sie stoßen
Ein Dokument mit 500 Seiten wird als ein paar Dutzend Zellen nahe dem Sichtfenster gezeichnet und nicht als 500, damit das Raster bedienbar bleibt. Jede Zelle sagt die Wahrheit über die Gesamtzahl, und die Pfeiltasten erreichen jede Seite — aber ein Screenreader, der die Liste als Liste durchgeht, findet Seite 400 darin erst, wenn das Raster dorthin gerollt ist.
Was Sie stattdessen tun können
Bewegen Sie sich mit den Pfeiltasten, Pos1 und Ende statt durch Durchblättern: Die Einfügemarke rollt das Raster zu allem, was sie erreicht, und so ist jede Seite erreichbar. Bei einem so langen Dokument ist ein getippter Seitenbereich in PDF-Seiten löschen, PDF-Seiten herausziehen oder PDF-Seiten neu ordnen meist weniger Arbeit als jedes Raster.

Was herauskommt, ist nicht barrierefreier als das, was hineinging

Worauf Sie stoßen
Pagecraft ordnet Dokumente um, wandelt sie und schreibt sie neu. Es fügt ihnen keine Tags, keine Überschriften und keine Lesereihenfolge hinzu und beansprucht keine PDF/UA-Konformität: Zwei nicht getaggte Dateien zusammenzuführen ergibt eine nicht getaggte Datei, und ein nicht barrierefreies Dokument ist hinterher genauso wenig barrierefrei.
Was Sie stattdessen tun können
Zwei Werkzeuge machen ein Dokument tatsächlich lesbarer, soweit sie reichen: Scan durchsuchbar machen legt eine Textebene über die Fotografie einer Seite, was der Unterschied zwischen etwas, das ein Screenreader lesen kann, und einem Bild ist; und Alternativtexte für PDF-Bilder hinzufügen schreibt die Beschreibungen samt dem Tag-Baum, an dem sie hängen müssen. Für vollständiges Taggen nehmen Sie ein Programm, das Struktur verfasst.

Die Dateiauswahl gehört Ihrem Betriebssystem

Worauf Sie stoßen
Die Tastatur erreicht in jedem Werkzeug das Bedienelement für Dateien, und das wird geprüft. Was sich beim Drücken öffnet, ist das eigene Fenster Ihres Browsers, das diese Website weder benennen noch gestalten noch reparieren kann — wenn dieses Fenster für Sie schwer zu bedienen ist, ändert nichts hier daran etwas. Die Norm misst die Oberfläche der Seite und nicht die des Browsers, das hier ist also kein Verstoß gegen sie; es steht hier, weil jemand trotzdem darauf stößt.
Was Sie stattdessen tun können
Lassen Sie es aus. Eine auf die Seite gezogene Datei kommt genauso an, und ebenso eine mit Strg+V eingefügte — das ist die, die eine Tastatur hat.

Eine Barriere melden

Öffnen Sie ein Issue unter github.com/amanawasthi2025/pagecraft. Zu beschreiben, was Sie vorhatten, hilft mehr als die Nummer eines Kriteriums, und wenn es etwas ist, das diese Tests hätten finden müssen, ist die Behebung ebenso ein Test wie eine Änderung. Eine Meldung braucht ein GitHub-Konto — eine Barriere, die diese Erklärung Ihnen lieber nicht in den Weg stellen würde, aber der einzige Weg, den es gibt, bis dieses Projekt eine eigene Adresse hat.

Wenn Sie das selbst betreiben

Diese Erklärung gilt für den Build, der unter dieser Adresse veröffentlicht ist. Eine Kopie von Pagecraft, die von woanders ausgeliefert wird, ist eine Installation, die wir nie gesehen haben — und wenn Ihre Organisation eine eigene Erklärung veröffentlichen muss, muss es ihre sein und kein Verweis auf diese. Die Suite, die diese Seite hervorgebracht hat, liegt im Repository und läuft gegen jeden Build; ehrlich ist also, sie gegen Ihren laufen zu lassen und zu veröffentlichen, was sie sagt.