tomlDesde: 0.3.0
Lee datos estructurados de un archivo TOML.
El archivo debe contener una tabla TOML válida. Los valores TOML se convertirán en los valores de Typst correspondientes, según se enumera en la tabla de abajo.
La función devuelve un diccionario que representa la tabla TOML.
El archivo TOML del ejemplo consiste en una tabla con las claves title, version y authors.
Ejemplo
#let details = toml("details.toml")
Title: #details.title \
Version: #details.version \
Authors: #(details.authors
.join(", ", last: " and "))

Detalles de la conversión
Antes que nada, los documentos TOML son tablas. Los demás valores deben ponerse en una tabla para codificarse o decodificarse.
| Valor TOML | Convertido a Typst |
|---|---|
| cadena | str |
| entero | int |
| flotante | float |
| booleano | bool |
| datetime | datetime |
| array | array |
| tabla | dictionary |
| Valor de Typst | Convertido a TOML |
|---|---|
| tipos que se pueden convertir desde TOML | valor TOML correspondiente |
none | se ignora |
bytes | cadena mediante repr |
symbol | cadena |
content | una tabla que describe el contenido |
otros tipos (length, etc.) | cadena mediante repr |
Notas
Tené en cuenta que los enteros TOML mayores que 263−1 o menores que −263 no se pueden representar sin pérdida en Typst y se producirá un error, según la especificación.
Los bytes no se codifican como arrays TOML por razones de rendimiento y legibilidad. Considerá usar
cbor.encodepara datos binarios.La función
repres solo para depuración y no se garantiza que su salida sea estable entre versiones de Typst.
Parámetros
source
Una ruta a un archivo TOML o bytes TOML sin procesar.
Funciones
encodeDesde: 0.8.0
Codifica datos estructurados en una cadena TOML.
value
Valor que se codifica.
Los documentos TOML son tablas. Por lo tanto, solo son adecuados los diccionarios.
prettyPor defecto: true
Si se debe dar formato legible al TOML resultante.