La distribución de TeX¶
Didacta genera PDF llamando a LaTeX, así que hace falta una distribución de TeX en la máquina. Didacta no lleva una dentro, y conviene decir por qué:
- la completa son varios gigas, y meterla en cada instalador sería repartir varios gigas a cada persona para que use tres paquetes;
- qué versión de cada paquete se usa lo tiene que poder elegir quien compila, no la aplicación;
- las actualizaciones de CTAN no pueden depender de que alguien publique una versión de Didacta.
Lo que sí hace es encontrar la que haya, decir dónde ha mirado cuando no encuentra ninguna, y bajar la que le digas si prefieres no instalarla tú. Las tres razones de arriba siguen en pie: por eso se elige, con el tamaño delante, en lugar de que la aplicación decida por ti.
Cuál instalar¶
Sirve cualquiera de estas. Hace falta TeX Live 2023 o posterior, con
latexmk.
| Sistema | Opción cómoda | Opción ligera |
|---|---|---|
| macOS | MacTeX (~5 GB) | brew install --cask basictex (~100 MB) |
| Windows | TeX Live o MiKTeX | MiKTeX instala paquetes según los necesita |
| Linux | el texlive-full de tu distribución |
texlive + texlive-latex-extra + latexmk |
| las tres | TinyTeX, ~100 MB y ampliable con tlmgr |
Que la instale Didacta¶
En Ajustes → Herramientas, la fila de LaTeX tiene un botón que abre esta misma tabla: se elige una y Didacta se encarga.
| Qué hace el botón | |
|---|---|
| TinyTeX | descarga el instalador oficial y lo ejecuta. No pide contraseña de administrador y queda en tu carpeta personal. Al terminar, Didacta le pide a tlmgr los paquetes que el preámbulo usa |
| BasicTeX y MacTeX | descargan el .pkg de CTAN y abren el instalador de macOS, que te pedirá la contraseña de administrador |
| MiKTeX | lo instala winget, que viene con Windows |
| TeX Live (Windows) | descarga el instalador oficial y lo abre |
El texlive de tu distribución |
instalar paquetes del sistema pide sudo, y eso se teclea en un terminal: Didacta enseña las órdenes en lugar de pedirte la contraseña |
Los instaladores que se abren en su propia ventana terminan fuera de Didacta, así que la fila se queda esperando y hay un «Volver a comprobar» para cuando acabe. Es lo honesto: Didacta no sabe cuándo termina el instalador de Apple.
Si algo falla --la red de la facultad corta CTAN, el gestor de paquetes no está, la máquina no es tuya-- sale un aviso con lo que contestó el programa, las órdenes para hacerlo a mano y el enlace a la guía oficial. No hay ningún camino que acabe en un callejón sin salida.
Todos los paquetes que Didacta usa están en CTAN
Una TeX Live estándar basta: no hay que instalar ningún .sty suelto ni
ninguna fuente empaquetada aparte. Eso es un requisito del sistema, no una
casualidad, y es lo que permite compilar en una máquina limpia o en un
runner de integración continua.
Con una instalación mínima como BasicTeX o TinyTeX puede faltar algún
paquete la primera vez. El log lo dice con nombre y apellido, y se añade
con tlmgr install <paquete>: qué orden, en cada
distribución.
Las citas necesitan biber
Si tu repositorio tiene un .bib, la bibliografía la compone biber.
Viene con MacTeX, con TeX Live y con MiKTeX, y Didacta se lo pide a
tlmgr al instalar TinyTeX. Si falta, la comprobación de herramientas lo
dice debajo de LaTeX --sin quitarle el tick: todo lo que no cita compila
igual-- con la orden para añadirlo: tlmgr install biblatex biber.
Si Didacta no la encuentra¶
Aparece en Ajustes → Herramientas, con la lista de los sitios donde ha mirado, y en Ajustes → Herramientas, debajo, en Compilar, hay un botón para buscar otra vez y un campo para decirle dónde está.
Esto pasa más de lo que parece, y la razón no es evidente:
Una aplicación no hereda el PATH del terminal
Cuando lanzas Didacta desde el Finder o desde el menú de aplicaciones, el
sistema le da un PATH mínimo: en macOS, /usr/bin:/bin:/usr/sbin:/sbin y
nada más. Y latexmk vive en /Library/TeX/texbin, que entra en el PATH
porque lo añade /etc/paths.d/TeX, que solo lee un shell de login.
El resultado era una Didacta diciendo «hace falta una distribución de TeX» con TeX Live instalada y compilando perfectamente en el terminal.
Por eso Didacta busca en los sitios de siempre en lugar de preguntarle al PATH: las rutas por defecto de TeX Live, MacTeX, MiKTeX y TinyTeX. Lo que se escriba en Ajustes manda sobre todo eso.
Comprobarlo desde el terminal¶
Si quieres saber qué ve tu sistema antes de abrir Didacta:
La segunda orden dice si LaTeX encuentra sus propias clases. Si la primera falla pero el binario existe, el problema es el PATH y no la instalación.