# Ajustes del documento

Cambia el tamaño de página, los márgenes, la tipografía, el idioma, el interlineado y la numeración en un diálogo que edita el preámbulo de LaTeX, las reglas set de Typst o el front matter de Markdown.

Cada lenguaje guarda su configuración de página en un sitio distinto: opciones de clase y comandos del preámbulo en LaTeX, reglas `#set` en Typst, front matter en Markdown. **Ajustes del documento** te da un único formulario para todos. Cuando lo aplicas, Oleafly escribe el cambio en tu archivo principal como código normal que puedes leer y editar después.

Ábrelo con el botón **Ajustes del documento** en el extremo derecho de la barra de herramientas del editor, o ejecuta **Ajustes del documento** desde la paleta ⌘K (Ctrl+K). El diálogo siempre edita el documento principal del proyecto, sea cual sea el archivo que tengas abierto.

## Los campos

El formulario tiene cuatro secciones. Los campos dependen del motor:

| Sección | LaTeX | Typst | Markdown |
| --- | --- | --- | --- |
| Página | Tamaño de página, Columnas, Márgenes | Tamaño de página, Márgenes, Columnas | Tipo de documento, Clase de documento, Tamaño de página, Columnas, Márgenes |
| Texto | Tipografía del texto, Tamaño de letra, Idioma | Tipografía del texto, Tamaño de letra, Idioma, Región | Tipografía del texto, Tamaño de letra, Idioma |
| Párrafo | Interlineado | Justificación, Interlineado | Interlineado |
| Numeración | Niveles numerados, Numeración de ecuaciones | Numeración de títulos, Numeración de ecuaciones | Números de sección |

Las listas empiezan con **Predeterminado**, que quita el ajuste para que vuelva a aplicarse el valor predeterminado de la clase, la plantilla o el motor. Deja un campo de texto vacío para el mismo efecto. Las longitudes llevan unidades, como `2.5cm`, `1in` o `11pt`, y los márgenes de Typst también aceptan `auto`. Un valor que Oleafly no puede usar recibe una nota breve debajo del campo, y **Aplicar** espera hasta que lo corrijas.

**Tipografía del texto** sugiere tipografías mientras escribes. En los proyectos de Typst, la lista contiene todas las tipografías que Typst puede encontrar e indica de dónde viene cada una: la carpeta `fonts` del proyecto, el ordenador o el conjunto incluido de Typst. En los proyectos de LaTeX y Markdown, enumera las tipografías instaladas en el ordenador.

Elige **Aplicar** para escribir los cambios, o **Cancelar** para dejar el archivo como está. Cuando el archivo principal está abierto en el editor, un solo ⌘Z (Ctrl+Z) deshace todo el cambio.

## Adónde van los valores

### LaTeX

- **Tamaño de página**, **Columnas** y **Tamaño de letra** se convierten en opciones de `\documentclass`.
- **Márgenes** va al paquete geometry. Oleafly edita un `\geometry{…}` existente o una opción de geometry, o añade `\usepackage[margin=…]{geometry}`.
- **Tipografía del texto** escribe `\setmainfont{…}` y carga fontspec. En un proyecto de latexmk necesita el compilador XeLaTeX o LuaLaTeX, y el campo lo indica hasta que eliges uno en el menú de compilación o el documento pide uno, por ejemplo con una línea `% !TeX program = xelatex`.
- **Idioma** añade el idioma a babel, usa `\setdefaultlanguage` cuando el documento carga polyglossia, o añade `\usepackage[language]{babel}`. Usa nombres de babel como `english`.
- **Interlineado** es **Sencillo**, **Uno y medio**, **Doble** o un número como `1.5`. Usa el paquete setspace, o `\linespread` cuando eso es lo que el documento ya tiene.
- **Niveles numerados** define `secnumdepth`. Elige **Ninguno**, **Solo capítulos**, o hasta qué profundidad llega la numeración, desde **Hasta las secciones** hasta **Hasta los subpárrafos**.
- **Numeración de ecuaciones** escribe `\numberwithin{equation}{…}` para **Por sección**, **Por capítulo** o **Por subsección**.

### Typst

Los valores van a las reglas `#set` del archivo principal. Cuando falta una regla, Oleafly la añade cerca del principio:

- `#set page(paper: …, margin: …, columns: …)`
- `#set text(font: …, size: …, lang: …, region: …)`
- `#set par(justify: …, leading: …)`, donde **Justificación** es **Justificado** o **Alineado a la izquierda**
- `#set heading(numbering: …)`, con patrones como `1.`, `1.1`, `1.a`, `I.` o `A.`
- `#set math.equation(numbering: …)`, con `(1)`, `(1.1)` o `1`

**Idioma** admite un código de dos o tres letras como `en`, y **Región** un código de dos letras como `GB`.

Los proyectos de Typst también tienen una sección **Variantes de compilación**. Cada variante es un conjunto de valores con nombre que el documento lee con `sys.inputs`, como una compilación de borrador y otra final. Usa **Añadir variante**, ponle un nombre y añade cada valor con **Añadir valor**. Elige la variante que compilar en **Variante (este proyecto)** en el menú de compilación.

### Markdown

Los valores van al front matter YAML que Pandoc lee cuando genera el PDF: `type`, `documentclass`, `papersize`, `classoption` para las columnas, `geometry` para los márgenes, `mainfont`, `fontsize`, `lang`, `linestretch` y `numbersections`. **Tipo de documento** ofrece **Artículo**, **Informe o tesis**, **Libro**, **Diapositivas**, **Póster**, **Carta** y **Currículum**, y decide qué genera el documento. Consulta [Tipos de documento](/docs/writing/markdown/#document-types). **Clase de documento** ofrece `article`, `report`, `book`, `scrartcl`, `scrreprt` y `memoir`. **Idioma** admite una etiqueta como `en-US`.

Donde no hayas definido una tipografía, Oleafly elige una para cada escritura del documento, como coreano, árabe o devanagari. **Idioma** también decide qué tipografía reciben los caracteres chinos: `ja` da la japonesa, `zh` el chino simplificado y `zh-TW` el chino tradicional. Consulta [Texto en otros idiomas](/docs/writing/markdown/#text-in-other-languages).

Si el archivo todavía no tiene front matter, el diálogo lo indica, y **Aplicar** añade un bloque al principio. Un front matter sin línea de cierre `---` hay que arreglarlo antes a mano.

## Campos de solo lectura

Algunos valores pertenecen a otra cosa, y el diálogo los muestra en gris con el motivo debajo:

- **Lo define la clase …**: clases como `acmart`, `IEEEtran`, `llncs` y `beamer` fijan sus propios márgenes, y algunas también fijan el tamaño de página, el tamaño de letra, las columnas, el interlineado o el idioma. Una nota en la parte superior del diálogo nombra la clase.
- **Lo define el estilo …**: los paquetes de estilo de congresos, como los de NeurIPS, ICML, ICLR, CVPR y ACL, fijan el tamaño de página y los márgenes. Una nota en la parte superior del diálogo dice qué estilo manda.
- **El código define cada margen por separado**: el documento da los márgenes izquierdo, derecho, superior e inferior por separado en lugar de un único valor `margin`.
- **Se define dentro de un bloque condicional**: el valor está dentro de código `\if…`, así que cambiarlo aquí podría romper la lógica.
- **Lo define la plantilla**: en Typst, la regla `#set` que contiene el valor tiene una condición `if` o pasa argumentos `..`, como suele hacer el código de las plantillas, así que el diálogo no la toca.
- **Lo define una expresión en el código**: el valor se calcula, no está escrito literalmente, así que edita el código.

Cuando un documento de Typst aplica una plantilla, una nota en la parte superior dice que los valores definidos dentro de la plantilla no se muestran, y que un valor que definas aquí sustituye al de la plantilla. En LaTeX aparece una nota parecida cuando parte del preámbulo está en otros archivos.

## Páginas relacionadas

- [Paquetes](/docs/packages/): añade otros paquetes de LaTeX o Typst
- [Compilación](/docs/compiling/): elige XeLaTeX o LuaLaTeX, y elige una variante de compilación de Typst
- [Análisis del documento](/docs/document-insights/): mira qué contiene el documento
