pdfElementoDesde: 0.13.0
El formato de exportación a PDF de Typst.
Los archivos PDF se centran en describir documentos visualmente con precisión, pero también tienen facilidades para anotar su estructura. Este enfoque híbrido los hace muy adecuados para el intercambio de documentos: se renderizan exactamente igual en todos los dispositivos, pero también admiten la extracción del contenido y la estructura de un documento (al menos hasta cierto punto). A diferencia de los archivos PNG, los PDF no están atados a una resolución específica. Por lo tanto, podés verlos a cualquier tamaño sin sufrir una pérdida de calidad.
Exportar como PDF
Línea de comandos
PDF es el formato de exportación por defecto de Typst. Ejecutar el subcomando compile o watch sin especificar un formato creará un PDF. Al exportar a PDF, tenés las siguientes opciones de configuración:
Con qué estándares de PDF debe garantizar Typst la conformidad, especificando
--pdf-standardseguido de uno o varios estándares separados por comas. Los estándares válidos son1.4,1.5,1.6,1.7,2.0,a-1b,a-1a,a-2b,a-2u,a-2a,a-3b,a-3u,a-3a,a-4,a-4f,a-4eyua-1. Por defecto, Typst produce archivos conformes con PDF-1.7.Podés desactivar por completo el etiquetado del PDF con
--pdf-tagged=false. Por defecto, Typst siempre escribirá un PDF etiquetado (Tagged PDF) para ofrecer un nivel básico de accesibilidad. Con este indicador, podés desactivar las etiquetas. Esto hará que tu archivo sea inaccesible e impedirá la conformidad con los niveles de conformidad accesibles de PDF/A y con todas las partes de PDF/UA.Qué páginas exportar, especificando
--pagesseguido de una lista de números separados por comas o de rangos de números separados por guiones. Los rangos pueden ser semiabiertos. Ejemplo:2,3,7-9,11-.
App web
Hacé clic en el botón de descarga rápida de la parte superior derecha para exportar un PDF con la configuración por defecto. Para configurar más, hacé clic en “File” > “Export as” > “PDF” o hacé clic en la flecha hacia abajo junto al botón de descarga rápida y seleccioná “Export as PDF”. Al exportar a PDF, tenés las siguientes opciones de configuración:
Con qué estándares de PDF debe garantizar Typst la conformidad. Por defecto, Typst produce archivos conformes con PDF-1.7. Podés elegir libremente la versión de PDF entre 1.4 y 2.0. Los estándares adicionales válidos son
A-1b,A-1a,A-2b,A-2u,A-2a,A-3b.A-3u,A-3a,A-4,A-4f,A-4eyUA-1.Qué páginas exportar. Las opciones válidas son “All pages”, “Current page” y “Custom ranges”. Los rangos personalizados son una lista de números separados por comas o de rangos de números separados por guiones. Los rangos pueden ser semiabiertos. Ejemplo:
2,3,7-9,11-.
Funcionalidad específica de PDF
Typst expone la funcionalidad específica de PDF en el elemento global pdf. Mirá abajo las definiciones y opciones que contiene.
Este elemento contiene algunas funciones sin una API definitiva. Están diseñadas para mejorar la accesibilidad de documentos con tablas complejas. Esto incluye @[table-summary], header-cell y data-cell. Todas estas funciones se eliminarán en una futura versión de Typst, ya sea integrándolas en las funciones de tablas o eliminándolas por completo. Podés habilitar estas funciones pasando --features o estableciendo la variable de entorno
a11y-extrasTYPST_FEATURES en a11y-extras. En la app web, estas características no están disponibles por el momento.
Parámetros
pagesPor defecto: none
Especifica qué rangos de páginas se deben incluir en el PDF. Puede ser:
nonepara exportar todas las páginas.- Un único rango de páginas.
- Un array de rangos de páginas.
Un rango de páginas es uno de los siguientes:
- Un número que especifica exactamente una página (los números de página empiezan en uno).
- Un diccionario con las claves
from(que indica el inicio de un rango de páginas) y/oto(que indica el final de un rango de páginas). Debe estar presente al menos una de las claves y tanto el número inicial como el final son inclusivos. Por lo tanto, el rango(from: 1, to: 3)es la lista de páginas(1, 2, 3).
Especificar una única página o rango de páginas:
#set pdf(pages: 3)
#set pdf(pages: (from: 3))
#set pdf(pages: (to: 5))
#set pdf(pages: (from: 3, to: 5))Especificar varias páginas, rangos de páginas o una mezcla:
#set pdf(pages: (5, 7, 9))
#set pdf(pages: ((to: 3), 5, (from: 7, to: 8), (from: 10)))standardPor defecto: ("1.7",)
Una lista de estándares de PDF con los que Typst garantizará la conformidad. Puede ser un único estándar o un array de estándares.
La Organización Internacional de Normalización (ISO) publicó el estándar PDF base y varios estándares que lo extienden para que los PDF sean más adecuados para casos de uso específicos. Por defecto, Typst exporta archivos PDF 1.7. Adobe Acrobat 8 y posteriores, así como todos los demás visores de PDF de uso común, son compatibles con esta versión de PDF.
Algunas características de Typst pueden no estar disponibles según el estándar de PDF que elijas. Podés combinar estándares PDF/A y PDF/UA compatibles. En particular, PDF/UA-1 y PDF/A-4 son mutuamente incompatibles, ya que el primero requiere PDF 1.7 o anterior y el segundo requiere PDF 2.0.
Versiones de PDF
Typst admite cinco versiones distintas de PDF: 1.4, 1.5, 1.6, 1.7 (por defecto) y 2.0. Podés elegir cualquiera de estas versiones para la exportación de tu documento. Sin embargo, según las características que hayas usado puede haber una versión mínima. Del mismo modo, los estándares a los que apuntes pueden limitar qué versiones podés elegir (mirá más abajo para más información).
Esta es una lista de cómo cada versión nueva mejora respecto de PDF 1.4 para los documentos de Typst:
- PDF 1.5 (2003): Mejor gestión del color, extracción de texto, accesibilidad de tablas, reflujo y fuentes de emojis
- PDF 1.6 (2004): Enlaces más flexibles
- PDF 1.7 (2006): Permite archivos adjuntos, mejor reflujo
- PDF 2.0 (2017): Mejores metadatos y semántica de etiquetas para la accesibilidad
El software que se use para leer tu archivo debe admitir tu versión de PDF. En circunstancias normales, esto no plantea ningún problema, pero puede ser una fuente de errores al trabajar con hardware más antiguo. Para el intercambio general, recomendamos mantener la configuración por defecto de PDF 1.7 o elegir PDF 2.0.
Al usar archivos PDF como imágenes en tu documento, la versión de PDF de exportación debe igualar o superar las versiones de los archivos de imagen.
PDF/UA
Typst admite escribir archivos conformes con PDF/UA. Los archivos PDF/UA están diseñados para el acceso universal. Cuando elegís este estándar de PDF, Typst ejecutará comprobaciones adicionales al exportar tu documento. Estas comprobaciones se asegurarán de que estés siguiendo las mejores prácticas de accesibilidad. Por ejemplo, se asegurará de que todas tus imágenes vengan con descripciones alternativas.
Tené en cuenta que hay algunas reglas en PDF/UA que son cruciales para la accesibilidad pero que no se pueden comprobar automáticamente. Por lo tanto, al exportar un documento PDF/UA-1, asegurate de haber hecho lo siguiente:
- Si tu documento está escrito en un idioma distinto del inglés, asegurate de establecer el idioma del texto antes de cualquier contenido.
- Asegurate de usar los elementos semánticos de Typst (como los títulos, las figuras y las listas) cuando corresponda, en lugar de definir construcciones personalizadas. Esto le permite a Typst saber (y exportar) el rol que cumple una construcción en el documento. Mirá la guía de accesibilidad para más detalles.
- No uses exclusivamente el contraste, el color, el formato o el diseño para comunicar una idea. Usá texto o descripciones alternativas en lugar de estos elementos, o además de ellos.
- Envolvé en
pdf.artifacttodos los elementos decorativos sin significado semántico. - No uses imágenes de texto. En cambio, insertá el texto directamente en tu marcado.
Actualmente, Typst solo admite la parte uno (PDF/UA-1), que se basa en PDF 1.7 (2006). Al exportar a PDF/UA-1, tené en cuenta que vas a tener que proporcionar manualmente descripciones alternativas de la matemática en lenguaje natural.
Se agregaron nuevas características de accesibilidad a PDF 2.0 (2017). Cuando se establece la exportación a PDF 2.0, Typst aprovechará algunas de estas características. Sin embargo, PDF 2.0 y PDF/UA-1 son mutuamente incompatibles. Para documentos accesibles, actualmente recomendamos exportar a PDF/UA-1 en lugar de PDF 2.0, por las comprobaciones adicionales y la mayor compatibilidad. La segunda parte de PDF/UA está diseñada para PDF 2.0, pero Typst todavía no la admite.
PDF/A
Typst admite opcionalmente emitir archivos conformes con PDF/A. Los archivos PDF/A están orientados a la máxima compatibilidad con las herramientas de PDF actuales y futuras. No dependen de características difíciles de implementar o propietarias y contienen metadatos exhaustivos. Esto los hace adecuados para el archivado a largo plazo.
El estándar PDF/A tiene varias versiones (partes en la terminología de ISO) y la mayoría de las partes tienen varios perfiles que indican el nivel de conformidad del archivo. Podés apuntar a una parte y a un nivel de conformidad a la vez. Actualmente, Typst admite estos perfiles de salida PDF/A:
PDF/A-1b: El nivel de conformidad básico de ISO 19005-1. Esta versión de PDF/A se basa en PDF 1.4 (2001) y produce archivos PDF autocontenidos y archivables. A diferencia de las partes posteriores del estándar PDF/A, no se permite la transparencia en los archivos PDF/A-1.
PDF/A-1a: Este es el nivel de conformidad accesible que se construye sobre el nivel básico PDF/A-1b. Para cumplir con este nivel, tu archivo debe ser un PDF etiquetado accesible. Tené en cuenta que la accesibilidad mejora en las partes posteriores, ya que no todas las características de accesibilidad de PDF están disponibles para archivos PDF 1.4. Además, todo el texto del archivo debe consistir en puntos de código Unicode conocidos.
PDF/A-2b: El nivel de conformidad básico de ISO 19005-2. Esta versión de PDF/A se basa en PDF 1.7 (2006) y produce archivos PDF autocontenidos y archivables.
PDF/A-2u: Este es el nivel de conformidad asignable a Unicode que se construye sobre el nivel básico A-2b. También agrega reglas según las cuales todo el texto del documento debe consistir en puntos de código Unicode conocidos. Si es posible, preferí siempre este estándar en lugar de PDF/A-2b.
PDF/A-2a: Este es el nivel de conformidad accesible que se construye sobre el nivel asignable a Unicode A-2u. Este nivel de conformidad también agrega dos requisitos: tu archivo debe ser un PDF etiquetado accesible. Typst agrega automáticamente etiquetas para ayudarte a alcanzar este nivel de conformidad. Prestá atención también a las secciones de accesibilidad a lo largo de la referencia y a la guía de accesibilidad cuando apuntes a este nivel de conformidad. Por último, PDF/A-2a te prohíbe usar puntos de código del área de uso privado de Unicode. Si querés construir un archivo accesible, considerá también apuntar adicionalmente a PDF/UA-1, que habilita más comprobaciones de accesibilidad automáticas.
PDF/A-3b: El nivel de conformidad básico de ISO 19005-3. Esta versión de PDF/A se basa en PDF 1.7 (2006) y produce archivos PDF archivables que pueden contener otros archivos relacionados arbitrarios como archivos adjuntos. La única diferencia con PDF/A-2b es la capacidad de adjuntar archivos que no cumplen con PDF/A.
PDF/A-3u: Este es el nivel de conformidad asignable a Unicode que se construye sobre el nivel básico A-3b. Igual que PDF/A-2b, requiere que todo el texto consista en puntos de código Unicode conocidos. Estas reglas no se aplican a los archivos adjuntos. Si es posible, preferí siempre este estándar en lugar de PDF/A-3b.
PDF/A-3a: Este es el nivel de conformidad accesible que se construye sobre el nivel asignable a Unicode A-3u. Igual que PDF/A-2a, requiere que los archivos sean un PDF etiquetado accesible y que no usen caracteres del área de uso privado de Unicode. Igual que antes, estas reglas no se aplican a los archivos adjuntos.
PDF/A-4: El nivel de conformidad básico de ISO 19005-4. Esta versión de PDF/A se basa en PDF 2.0 (2017) y produce archivos PDF autocontenidos y archivables. PDF/A-4 no tiene partes relacionadas con la accesibilidad. En cambio, el tema se elaboró más en el estándar PDF/UA dedicado. Los archivos PDF/A-4 pueden cumplir con PDF/UA-2 (actualmente no admitido en Typst).
PDF/A-4f: El nivel de conformidad de archivos incrustados que se construye sobre el nivel básico A-4. Los archivos que cumplen con este nivel pueden contener otros archivos relacionados arbitrarios como archivos adjuntos, igual que los archivos que cumplen con la parte 3 de ISO 19005. La única diferencia con PDF/A-4 es la capacidad de adjuntar archivos que no cumplen con PDF/A.
PDF/A-4e: El nivel de conformidad de ingeniería que se construye sobre el nivel de archivos incrustados A-4f. Los archivos que cumplen con este nivel pueden contener objetos 3D. Typst no admite contenido 3D, por lo que, desde la perspectiva de Typst, esto es funcionalmente equivalente a PDF/A-4f.
Si querés apuntar a PDF/A pero no estás seguro de qué configuración particular usar, hay algunas buenas reglas empíricas. Primero, tenés que determinar tu parte, que es el “número de versión” del estándar. Hacete estas preguntas:
¿Necesita leer mi archivo software o equipamiento anterior a 2006? Si es así, elegí la parte uno (PDF/A-1).
Si no, ¿necesita mi archivo archivos adjuntos? Si es así, tenés que elegir la parte tres (PDF/A-3) o el nivel de archivos incrustados de la parte cuatro (PDF/A-4f).
¿Necesita tu archivo usar características introducidas en PDF 2.0? Actualmente, el uso de características de PDF 2.0 en Typst se limita a mejoras menores en accesibilidad, por ejemplo para el elemento title. Si podés prescindir de estas mejoras, maximizá la compatibilidad eligiendo la parte dos (cuando no necesitás adjuntos) o la parte tres (cuando sí necesitás adjuntos). Si dependés de características de PDF 2.0, usá la parte cuatro.
Ahora solo necesitás elegir un nivel de conformidad (la letra minúscula del final).
Si elegiste la parte uno, dos o tres, normalmente deberías elegir el nivel de conformidad accesible de tu parte, indicado con una
aminúscula al final. Si tu documento es inherentemente inaccesible, por ejemplo el portafolio de un artista que no se puede reducir a descripciones alternativas, elegí en cambio el nivel de conformidadu. Solo si esto produce un error del compilador, por ejemplo porque usaste puntos de código del área de uso privado de Unicode, usá el nivel básicob.Si elegiste la parte cuatro, deberías elegir el nivel de conformidad básico (PDF/A-4), salvo que necesites incrustar archivos.
Al elegir entre exportar PDF/A y PDF normal, tené en cuenta que los archivos PDF/A contienen metadatos adicionales y que algunos lectores impedirán que el usuario modifique un archivo PDF/A.
Ver opciones
| Variante | Detalles |
|---|---|
"1.4" | PDF 1.4. |
"1.5" | PDF 1.5. |
"1.6" | PDF 1.6. |
"1.7" | PDF 1.7. |
"2.0" | PDF 2.0. |
"a-1b" | PDF/A-1b. |
"a-1a" | PDF/A-1a. |
"a-2b" | PDF/A-2b. |
"a-2u" | PDF/A-2u. |
"a-2a" | PDF/A-2a. |
"a-3b" | PDF/A-3b. |
"a-3u" | PDF/A-3u. |
"a-3a" | PDF/A-3a. |
"a-4" | PDF/A-4. |
"a-4f" | PDF/A-4f. |
"a-4e" | PDF/A-4e. |
"ua-1" | PDF/UA-1. |
taggedPor defecto: auto
Si se produce un documento PDF etiquetado.
El etiquetado está habilitado por defecto para ofrecer un nivel básico de accesibilidad. Se puede desactivar manualmente, por ejemplo para reducir el tamaño del documento, y se desactivará automáticamente al exportar un rango de páginas específico.
prettyPor defecto: false
Si se da formato legible al documento PDF producido.
Esto da formato a la salida de una manera más legible para las personas, pero menos eficiente en espacio.
Definiciones
artifactMarca contenido como artefacto de PDF.attachUn archivo que se adjuntará al PDF de salida.data-cellDefine explícitamente esta celda como una celda de datos.header-cellDefine explícitamente una celda como celda de encabezado.table-summaryUn resumen del propósito y la estructura de una tabla compleja.