Traducción no oficial al español rioplatense, generada con IA (Claude Sonnet 5.5) bajo la dirección y revisión de Jassiel Ovando. No es una publicación de Typst GmbH ni cuenta con su aval; ante cualquier duda, prevalece la documentación oficial en inglés. ¿Un error de traducción o una sugerencia? Reportalo. Tipografía: Reforma, de PampaType.

artifactElemento
Signo de pregunta
Desde: 0.14.0Ir al código fuente

Marca contenido como artefacto de PDF.

Los artefactos son partes del documento que no están pensadas para ser leídas por tecnologías de asistencia (TA), como los lectores de pantalla. Algunos ejemplos típicos son las imágenes puramente decorativas que no contribuyen al significado del documento, las marcas de agua o el contenido repetido, como los números de página.

Typst marcará automáticamente cierto contenido, como los encabezados, pies de página, fondos y primeros planos de las páginas, como artefactos. Del mismo modo, las rutas y las formas se marcan automáticamente como artefactos, pero su contenido no. Los números de línea creados con par.line se marcan automáticamente como artefactos, al igual que las repeticiones de encabezados y pies de tabla.

Una vez que algo se marca como artefacto, no podés volver a hacer accesible ninguna parte de su contenido. Si necesitás marcar como artefacto solo una parte de algo, quizás tengas que usar esta función varias veces.

Si no estás seguro de qué constituye un artefacto, consultá la guía de accesibilidad.

En el futuro, esta función podría moverse fuera del módulo pdf, lo que permitiría ocultar contenido a las TA en la exportación a HTML.

Parámetros

pdf.artifact() → content

kind
str
Configurable con set
Signo de pregunta
Por defecto: "other"

El tipo de artefacto.

Podés mejorar la accesibilidad usando el tipo de artefacto más específico disponible. Tu elección determinará cómo trata el lector de PDF al artefacto durante el reflujo y la extracción de contenido (por ejemplo, copiar y pegar).

Los tipos de artefacto se introdujeron en varias especificaciones de PDF distintas. Según la versión de PDF que apuntes, Typst seleccionará el tipo de artefacto más apropiado a partir de tu selección acá.

ExpandirVer opciones
VarianteDetalles
"header"Se repite en la parte superior de cada página.
"footer"Se repite al pie de cada página.
"watermark"Texto o gráficos en el fondo o en el primer plano de todas las páginas.
"page-number"Números de página.
"line-number"Números de línea o de párrafo.
"redaction"Marcadores de posición para áreas en las que había contenido en otra versión del documento y que desde entonces se eliminó.
"bates"Numeración Bates.
"page"No forma parte del documento, sino de la página en la que se imprime. Un ejemplo son las marcas de corte o las barras de color.
"pagination-other"Artefactos que surgen de paginar el documento y que no están cubiertos por otros tipos de artefacto. Esta categoría se aplica, en general, si el artefacto no aparecería en tu documento si fuera un sitio web. Si tu artefacto está cubierto por otras categorías, preferí esas categorías.
"layout"Contenido puramente cosmético o adornos tipográficos que no contribuyen al contenido del documento.
"background"Fondo de una página o de un elemento gráfico. Este tipo de artefacto se agregó en PDF 1.7. Sin embargo, por requisitos de la especificación de PDF 1.7 que las especificaciones posteriores eliminaron, Typst solo usa este tipo de artefacto en PDF 2.0. Si lo usás en PDF 1.7 o anterior, Typst usará en su lugar el tipo "other".
"other"Otros artefactos.

body
content
ObligatorioPosicional
Signo de pregunta

El contenido que es un artefacto.