# Autocompletado y comandos de barra

Comandos de LaTeX según los paquetes, funciones y paquetes de Typst, detalles de citas, rutas de archivos, atajos matemáticos y fragmentos reutilizables.

En LaTeX, el editor completa tres cosas mientras escribes: comandos, referencias cruzadas y citas. Añade el menú de barra `/` para la estructura y podrás escribir la mayoría de los documentos sin teclear texto repetitivo. Los archivos de Typst tienen su propio autocompletado y sus propios fragmentos, que se describen en [Autocompletado de Typst](#typst-completion).

Las sugerencias aparecen automáticamente mientras escribes; Ctrl+Space las invoca en cualquier sitio. Acepta con Tab o Enter.

## Autocompletado de comandos

Escribe una barra invertida y sigue: `\sec…` ofrece `\section`, y `\fra…` ofrece `\frac`. El autocompletado se basa en un amplio catálogo de comandos de LaTeX y en los paquetes que usa tu proyecto. También incluye los comandos y entornos personalizados de tu código fuente.

Los autocompletados se insertan como fragmentos con puntos de tabulación: si aceptas `\frac` obtienes `\frac{│}{}` con el cursor en el numerador; Tab salta al denominador. Los autocompletados de entornos como `\itemize`, `\enumerate`, `\equation` y `\align` insertan el bloque `\begin…\end` completo con el cursor dentro.

## Autocompletado de referencias

Dentro de `\ref{`, `\eqref{`, `\pageref{`, `\autoref{`, `\cref{` o `\Cref{`, el menú lista todos los `\label{}` definidos en tu documento. Se acabó subir para acordarte de si lo llamaste `fig:arch` o `fig:architecture`.

![Claves de cita que se autocompletan desde refs.bib, y una llave sin cerrar que queda marcada hasta que se cierra.](https://cdn.oleafly.com/images/gifs/desktop/latex-completion.gif?v=2)

## Autocompletado de citas

Dentro de `\cite{` y sus variantes (`\citep`, `\citet`, `\citeauthor`, `\citeyear`, `\parencite`, `\textcite`), el menú lista las claves de cita de los archivos `.bib` de tu proyecto, que se analizan automáticamente al abrir el proyecto.

Si el artículo todavía no está en tu `.bib`, para eso sirve la [búsqueda de citas](/docs/citations/): pega un DOI o un título y Oleafly añade la entrada y el `\cite` en un solo paso.

## Matemáticas y estructura

Escribe `$`, `\(` o `\[` para insertar su delimitador de cierre. Cuando el cursor llega a un `$` de cierre insertado, escribe `$` otra vez para pasar de largo. Los corchetes se emparejan dentro de las fórmulas en línea, y un par `$$` vacío se convierte en una fórmula destacada cuando pulsas Enter entre los delimitadores.

Al aceptar un entorno de lista se inserta su primer `\item`. Pulsa Enter al final de un elemento para continuar la lista, incluida una etiqueta de descripción o la sangría de una lista anidada. Pulsa Shift+Enter para un salto de línea normal; deja vacío el elemento nuevo y pulsa Enter otra vez para terminar la lista.

Si escribes tú mismo un `\begin{...}` sin cerrar, Enter añade el `\end{...}` correspondiente. Usa **⌘⌥.** (Ctrl+Alt+.) para cerrar el entorno abierto más interno, o ⌘⌥E (Ctrl+Alt+E) para envolver una selección en un entorno. Dentro de una fórmula, escribe `@` para explorar las letras griegas y otros símbolos.

Las sugerencias de referencias incluyen el número compilado cuando está disponible tras una compilación correcta. Las sugerencias de citas ayudan a identificar el artículo que hay detrás de una clave.

## Controla qué se cierra automáticamente

Abre **Ajustes → Apariencia → Editor** cuando quieras que se escriba menos o más automáticamente:

- **Autocompletado** muestra sugerencias mientras escribes. Ctrl+Space sigue abriéndolas cuando está desactivado.
- **Cerrar corchetes automáticamente** inserta los corchetes y paréntesis correspondientes.
- **Cerrar fórmulas automáticamente** empareja `$`, `\(` y `\[` con el delimitador correspondiente.
- **Cerrar entornos automáticamente** inserta el `\end{...}` correspondiente cuando pulsas Enter después de `\begin{...}`.

Desactiva solo la ayuda que choque con tu forma de escribir. El autocompletado manual, el cierre de entornos y los atajos para envolver siguen disponibles.

## El menú de barra

Escribe `/` en cualquier sitio y se abre un menú de inserción que se filtra mientras escribes:

| Comando | Inserta |
|---|---|
| `/section`, `/subsection` | Comandos de seccionado |
| `/itemize` | Lista con viñetas |
| `/enumerate` | Lista numerada |
| `/item` | Un elemento de lista |
| `/equation` | Entorno de ecuación destacada |
| `/align` | Ecuaciones alineadas de varias líneas |
| `/frac` | Una fracción |
| `/figure` | Un flotante de figura completo con `\includegraphics` y `\caption` |
| `/table` | Un flotante de tabla con un `tabular` inicial |
| `/bold`, `/italic` | `\textbf{}`, `\textit{}` |
| `/label` | `\label{}` |
| `/usepackage` | `\usepackage{}` |

Todo se inserta como un fragmento con puntos de tabulación, así que Tab te lleva de hueco en hueco (pie, luego etiqueta y después lo demás).

## Autocompletado de Typst

Los archivos de Typst tienen su propio autocompletado, que procede sobre todo de Tinymist, el servidor de lenguaje de Typst que coincide con la versión de Typst del proyecto.

| Dónde escribes | Qué ofrece el menú |
|---|---|
| `#` seguido de un nombre | Funciones y variables |
| Una cadena en `image(`, `read(`, `csv(`, `json(`, `yaml(`, `toml(` o `bibliography(`, o después de `#include` o `#import` | Rutas de archivos del proyecto |
| `@`, o `<` dentro de `ref(` o `cite(` | Etiquetas y claves de cita, de los archivos `.bib` y los `.yml` de Hayagriva |
| `#import "@preview/` | Paquetes de Typst Universe |
| `style:` en `#bibliography(...)` o `#cite(...)` | Nombres de estilos de bibliografía, con los archivos `.csl` del propio proyecto primero |

Escribe `/` al principio de una línea, o después de un espacio, para ver los fragmentos de Typst: `/heading`, `/figure`, `/tablefigure`, `/table`, `/equation`, `/numberedequation`, `/footnote`, `/quote`, `/code`, `/outline`, `/bibliography`, `/pagebreak`, `/columns`, `/grid`, `/link`, `/list`, `/enum` y `/terms`. En Typst 0.15 y posteriores, `/partbibliography` añade una bibliografía para una parte del documento.

### Matemáticas y listas en Typst

Al escribir `$` en el texto se inserta también el `$` de cierre. Escribe un espacio dentro de un par vacío para obtener una fórmula destacada, `$ | $`, y pulsa Backspace en un par vacío para quitar ambos signos. Con texto seleccionado, escribir `*`, `_`, una comilla invertida o `$` envuelve la selección en lugar de reemplazarla. Esto sigue los ajustes **Cerrar corchetes automáticamente** y **Cerrar fórmulas automáticamente** descritos más arriba.

En una lista, Enter inicia el siguiente elemento con `-`, `+`, `/` o numerado. Enter en un elemento vacío quita su marcador, y Shift+Enter continúa el elemento actual en una línea nueva. Tab anida un elemento bajo el de arriba, y Shift+Tab lo saca de nuevo.

## Conviene saber

- **Tab hace doble función**: acepta una sugerencia abierta y, si no la hay, sangra.
- Los menús de autocompletado se cierran al hacer clic en otro sitio; Esc los descarta de forma explícita.
- Las rutas de archivos del proyecto se autocompletan dentro de los comandos compatibles, como `\input{}` y `\includegraphics{}`.
