Declaración de accesibilidad
Si tu organización exige una declaración de conformidad antes de aprobar una herramienta, es esta. Está escrita a partir de lo que el conjunto de pruebas comprueba de verdad, y no de lo que nos gustaría afirmar, y cada frase señala el archivo que la comprueba.
Qué se afirma
- Norma
- WCAG 2.2
- Nivel
- AA, cumplido por completo, con todo el texto corriente sujeto a 7:1, el umbral de contraste mejorado, que es AAA. El texto grande mantiene el umbral normal, que es lo que dice el propio criterio.
- Qué se evaluó
- Todas las páginas que publicó esta compilación: 334, en 4 idiomas, cada una con el tema claro y otra vez con el oscuro.
- Última comprobación
- Las comprobaciones de abajo se ejecutan con cada cambio; esta es la fecha en que alguien leyó por última vez el resultado entero y firmó esta página.
Qué se evaluó, y dónde se comprueba cada parte
Cinco cosas, sobre todo el sitio publicado y no sobre una muestra. La página de una herramienta es una sola plantilla con palabras distintas dentro, así que una muestra parece suficiente; y no lo es, porque lo que se rompe son las palabras.
Todas las páginas de la compilación, cargadas con los dos temas y juzgadas por una auditoría automática con la regla de contraste mejorado activada. No una página de cada forma: todas.
Se comprueba en apps/web/tests/site/conformance.spec.ts
Todas las herramientas recorridas desde el selector de archivos hasta el archivo terminado con el tabulador, las letras y la tecla Intro, y nada más. La lista de herramientas es la del propio motor, así que una herramienta nueva llega a Pagecraft con esta prueba ya fallando hasta que alguien dice qué necesita.
Se comprueba en apps/web/tests/site/keyboard.spec.ts
Todas las páginas dispuestas en 320 por 256 píxeles —una ventana de 1280 píxeles ampliada al 400 %, que es también el móvil más estrecho que alguien sigue llevando encima— sin nada que arrastrar de lado para leer una línea.
Se comprueba en apps/web/tests/site/conformance.spec.ts
El borde o el relleno de cada campo de texto, lista desplegable, botón y zona de soltar archivos, medido contra lo que se pinta detrás, con los dos temas. Ninguna auditoría automática mide esto, así que se mide pintando el color y volviendo a leer el píxel.
Se comprueba en apps/web/tests/site/conformance.spec.ts
Cada parada del recorrido de una página con el tabulador, comprobando que hay un anillo de foco realmente dibujado y que de verdad se distingue de la página que hay debajo.
Se comprueba en apps/web/tests/site/conformance.spec.ts
Cómo ejecutarlo por tu cuenta
Nada de esto hay que creérselo, que es el mismo criterio al que se somete la promesa de no subir archivos en la página «Cómo funciona». Este sitio es software libre y el código es el producto entero, así que los archivos nombrados arriba se pueden abrir, y se ejecutan en integración continua con cada cambio. Sobre una copia del repositorio, todo el conjunto es una sola orden:
pnpm test:e2e
Un fallo nombra la página, el idioma, el tema y el elemento. Si encuentras algo que estas pruebas dan por bueno y tú no, eso es un error de las pruebas tanto como de la página, y nos gustaría saberlo.
Las dos partes más difíciles
Una afirmación sobre «el sitio» suele ser en realidad una afirmación sobre las páginas que rodean la parte difícil. Estas son las dos partes difíciles, así que se declaran aparte.
Reordenar páginas a mano
El organizador de páginas es una cuadrícula de páginas que se pueden arrastrar con el ratón, y todo lo que hace un arrastre se puede hacer sin él. El tabulador llega a la cuadrícula una vez, no una vez por página; las flechas mueven un cursor; el espacio elige, Intro levanta las páginas y las deja, Escape las devuelve a donde estaban y Supr las quita. Cada una de esas acciones dice lo que hizo en una región activa —«Ahora en 3 de 12.» mientras se lleva una página, «Dejadas en 3 de 12.» al soltarla, «Eliminadas 1. Quedan 11.»— y cada celda lleva su propia posición y el total, así que un lector de pantalla lee dónde está en la propia página y no en un encabezado que hay encima. El recorrido lo recorre una prueba; no lo afirma este párrafo.
Se comprueba en apps/web/tests/site/organize.spec.ts
Preguntarle a una IA sobre un documento
Las herramientas de IA ponen un paso de revisión entre preguntar y enviar: se muestra entero el texto exacto que saldría de tu navegador, y no se envía nada hasta que pulsas el botón que hay debajo. Ese paso es una parte real de la interfaz y no un cuadro de confirmación, así que todo el recorrido a través de él se hace con el tabulador e Intro y nada más: crear una caja fuerte, añadir un proveedor, calcular lo que se enviaría, leerlo, enviarlo y detener una petición que ya está en curso. La respuesta llega a una región activa a medida que se escribe.
Se comprueba en apps/web/tests/site/ai.spec.ts
Qué sigue sin funcionar
Cuatro cosas, dichas con claridad. Cada una está sujeta por una prueba que afirma que sigue siendo cierta, así que esta lista no puede seguir describiendo un producto que ya la ha dejado atrás: si se arregla una, la compilación falla hasta que se borra la entrada.
La imagen de una página no está descrita
- Con qué te encuentras
- Allí donde las páginas se muestran como miniaturas —el organizador sobre todo—, cada una se nombra por el lugar que ocupa y el archivo del que vino: «Página 3 de 12, de deck.pdf página 3». La imagen en sí está marcada como decorativa. Nada dice qué hay impreso en la página, porque aquí nadie la ha leído.
- Qué hacer en su lugar
- Averigua antes qué hay en cada página con PDF a texto o Buscar en un PDF: los dos indican el número de página. A partir de ahí el organizador se maneja entero por números, y Borrar páginas de un PDF, Extraer páginas de un PDF y Reordenar páginas de un PDF aceptan un intervalo escrito y no muestran ninguna miniatura.
Un documento largo solo está en parte en la página
- Con qué te encuentras
- Un documento de 500 páginas se dibuja como unas pocas decenas de celdas cerca de la ventana, no como 500, para que la cuadrícula siga siendo manejable. Cada celda dice la verdad sobre el total y las flechas llegan a todas las páginas, pero un lector de pantalla que recorra la lista como lista no encontrará en ella la página 400 hasta que la cuadrícula se haya desplazado hasta allí.
- Qué hacer en su lugar
- Muévete con las flechas, Inicio y Fin en lugar de recorrer la lista: el cursor desplaza la cuadrícula hasta donde llegue, así que por ahí toda página es alcanzable. Para un documento así de largo, un intervalo escrito en Borrar páginas de un PDF, Extraer páginas de un PDF o Reordenar páginas de un PDF suele ser menos trabajo que cualquier cuadrícula.
Lo que sale no es más accesible que lo que entró
- Con qué te encuentras
- Pagecraft reordena, convierte y reescribe documentos. No le añade etiquetas, encabezados ni un orden de lectura, y no declara conformidad con PDF/UA: unir dos archivos sin etiquetar da un archivo sin etiquetar, y un documento inaccesible procesado aquí sigue siendo inaccesible después.
- Qué hacer en su lugar
- Dos herramientas sí hacen un documento más legible, hasta donde llegan: Hacer buscable un escaneo pone una capa de texto sobre la fotografía de una página, que es la diferencia entre algo que un lector de pantalla puede leer y una imagen; y Añadir texto alternativo a las imágenes de un PDF escribe las descripciones junto con el árbol de etiquetas del que tienen que colgar. Para etiquetar del todo, usa un editor que cree estructura.
El selector de archivos es el de tu sistema operativo
- Con qué te encuentras
- El teclado llega al control de archivos en todas las herramientas, y eso se comprueba. Lo que se abre al pulsarlo es el cuadro de diálogo de tu propio navegador, que este sitio no puede nombrar, ni maquetar, ni arreglar: si ese cuadro te resulta difícil de usar, nada de aquí lo cambia. La norma juzga la interfaz de la página y no la del navegador, así que esto no es un incumplimiento suyo; está aquí porque aun así alguien se lo encuentra.
- Qué hacer en su lugar
- Sáltatelo. Un archivo soltado sobre la página llega exactamente igual, y también uno pegado con Ctrl+V, que es el que tiene un teclado.
Informar de una barrera
Abre una incidencia en github.com/amanawasthi2025/pagecraft. Contar qué intentabas hacer sirve más que citar el número de un criterio, y si es algo que estas pruebas deberían haber detectado, el arreglo es una prueba además de un cambio. Informar requiere una cuenta de GitHub, una barrera que esta declaración preferiría no ponerte delante: es la única vía que existe hasta que este proyecto tenga una dirección propia.
Si alojas esto tú mismo
Esta declaración habla de la compilación publicada en esta dirección. Una copia de Pagecraft servida desde otro sitio es una instalación que no hemos visto, y si tu organización está obligada a publicar su propia declaración, tiene que ser suya y no un enlace a esta. El conjunto de pruebas que produjo esta página está en el repositorio y se ejecuta contra cualquier compilación, así que lo honesto es ejecutarlo contra la tuya y publicar lo que diga.