Referencia
Esta documentación de referencia es una guía completa de toda la sintaxis, los conceptos, las funciones, los tipos y otras definiciones de Typst. Usá la referencia para responder preguntas específicas sobre Typst y para ampliar tu comprensión de las características disponibles.
Si sos completamente nuevo en Typst, te recomendamos empezar con el tutorial y después volver a la referencia para aprender más sobre las características de Typst a medida que las necesites.
Lenguaje
La referencia empieza cubriendo los fundamentos del lenguaje Typst. Primero, damos un panorama de la sintaxis de Typst. Las siguientes secciones cubren conceptos centrales del lenguaje Typst, como dar estilo a los documentos, usar las capacidades de scripting de Typst y razonar sobre el contenido de tu documento.
Biblioteca
La segunda parte incluye secciones sobre todas las funciones, los tipos y otras definiciones que ofrece la biblioteca estándar del lenguaje Typst.
Las secciones de definiciones están agrupadas por tema. Por ejemplo, si querés explorar todas las herramientas que ofrece Typst para ajustar dónde caen los elementos en la página, deberías empezar en la sección Diseño. Si en cambio preferís saber más sobre los formatos a los que puede exportar Typst, deberías recorrer la sección de formatos.
Cómo leer la referencia
Esta referencia usa algunas convenciones gráficas y etiquetas para que puedas recorrer rápidamente sus secciones.
- str
Estas píldoras indican que un valor es de un tipo particular. El capítulo de cada tipo usa la píldora respectiva como título. Los tipos similares comparten un color. Por ejemplo, todos los tipos numéricos tienen el mismo color.
- Element
Algunas funciones están etiquetadas como elementos. Esto significa que se pueden usar con reglas set y show. Algunos elementos se pueden ubicar y usar con la función
query. Los elementos generalmente producen salida visible en el documento. Es posible que uses elementos aunque no llames a funciones, ya que hay marcado dedicado para algunos elementos.- Contextual
Estas funciones pueden razonar sobre el contenido de tu documento. Solo se pueden usar cuando hay contexto disponible, por ejemplo mediante un bloque de contexto. Consultá la sección Contexto para más información.
- Required
Aparece en un parámetro de una función si llamar a la función sin ese parámetro produciría un error.
- Positional
Aparece en un parámetro de una función que se especifica sin nombre de parámetro ni dos puntos. En cambio, Typst usará el orden de los parámetros para determinar qué argumento es cuál. Los parámetros que no están marcados como posicionales son parámetros con nombre.
- Variadic
Aparece en los parámetros de funciones que se pueden especificar varias veces.
- Settable
Aparece en los parámetros de funciones de elementos que se pueden personalizar con una regla set.