cristhian
2009e91465
- Reemplazar plantillas Markdown por template/report.typ y template/main.typ - Agregar primer reporte: respuesta-observaciones-avance-1 - Agregar scripts build.sh, preview.sh y common.sh con salida en pdf/ - Actualizar README y AGENTS.md; simplificar .gitignore
46 lines
2.0 KiB
Markdown
46 lines
2.0 KiB
Markdown
# 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.
|