# Reportes FONDEF IT24I0091 Manito

Reportes en [Typst](https://typst.app) con una plantilla compartida en
`template/report.typ`. Requiere Typst (probado con 0.15.1) y Bash; para la vista
previa, un visor de PDF predeterminado.

`template/` contiene solo la plantilla y el documento base reutilizable.
Los scripts no generan PDF de las plantillas; cópielas a `reports/` para usarlas.
`reports/` contiene los reportes, cada uno en su propia carpeta.
El primero es `reports/respuesta-observaciones-avance-1/main.typ`, con el título
interno «RESPUESTA OBSERVACIONES INF. DE AVANCE 1».

## Compilar y ver

```bash
./scripts/build.sh                 # compila solo si no existe el PDF
./scripts/preview.sh               # abre el PDF existente; lo crea si falta
./scripts/build.sh --force         # regenera el PDF aunque exista
./scripts/preview.sh --force       # regenera, abre y recompila al guardar
./scripts/build.sh reports/respuesta-observaciones-avance-1
./scripts/preview.sh reports/respuesta-observaciones-avance-1/main.typ
```

Ambos scripts aceptan un archivo `.typ` o una carpeta con `main.typ`. Los PDF se
guardan en `pdf/` en la raíz, con el nombre del reporte: por ejemplo,
`pdf/respuesta-observaciones-avance-1.pdf`. Para `main.typ` se usa el nombre de
su carpeta; para otros archivos, el nombre del archivo sin `.typ`.
El PDF se conserva aunque cambien los fuentes. Para
actualizarlo, use `--force` (o `-f`). Las rutas relativas parten del directorio
actual; los scripts configuran la raíz de Typst automáticamente. Use Ctrl+C para
detener la vista previa con `--force`.

## Crear un reporte

```bash
mkdir -p reports/nombre-corto/figures
cp template/main.typ reports/nombre-corto/main.typ
```

Edite los datos de `report.with(...)` y el contenido de `main.typ`. Guarde las
imágenes en `figures/` y use nombres de carpeta cortos, en minúsculas y con guiones.
Los PDF no se versionan; las entregas se guardan en Google Drive.

Las reglas para agentes están en [AGENTS.md](AGENTS.md): los commits y pushes
requieren una solicitud explícita del usuario.