Entorno TeX / Distribución TeX

Resumen

TeX64 invoca herramientas de línea de comandos como latexmk, lualatex y latexindent para compilar tus documentos. Debe haber una distribución TeX preinstalada en tu sistema.

Por qué se necesita una distribución TeX

TeX64 no incluye su propio motor LaTeX. Invoca comandos del sistema en tu Mac. Sin una distribución TeX la compilación es imposible.

• TeX64 depende de herramientas TeX externas (latexmk, lualatex, synctex)
• Instalar una distribución TeX es un requisito previo
• Sin una distribución, TeX64 mostrará errores de compilación

Opciones

MacTeX (recomendada)

• Tamaño: ~4 GB
• URL: https://www.tug.org/mactex/
• Instalación: descarga el .pkg y ejecuta el instalador
• Incluye: todo (latexmk, lualatex, latexindent, synctex y todos los paquetes)
• Para usuarios de japonés: incluye los paquetes CJK por defecto
• Ideal para: principiantes y quienes quieren configuración cero

BasicTeX (instalación mínima)

• Tamaño: ~100 MB
• URL: https://www.tug.org/mactex/morepackages.html
• Después de instalar: añade los paquetes que falten manualmente con tlmgr
• Ideal para: usuarios experimentados que quieren un uso mínimo de disco

TeX Live (manual)

• Gestiona TeX Live directamente fuera de MacTeX
• Para usuarios de Homebrew: brew install texlive

Verificación de la instalación

Abre Terminal y ejecuta estos comandos para comprobar que todas las herramientas se localizan:

which lualatex
which latexmk
which latexindent
which synctex

Todos deberían devolver rutas. Si alguno no devuelve nada, la herramienta no está instalada o no está en el PATH.

En TeX64: Ajustes > Entorno muestra estado verde/rojo para cada herramienta.

Gestión de paquetes (tlmgr)

• Actualizar el gestor de paquetes: sudo tlmgr update --self
• Actualizar todos los paquetes: sudo tlmgr update --all
• Instalar paquete: sudo tlmgr install <package>
• Buscar paquetes: sudo tlmgr search --global --file <filename>

Configuración del PATH

• MacTeX añade /Library/TeX/texbin automáticamente
• Homebrew usa /opt/homebrew/bin
• Si el PATH no está definido: añade export PATH="/Library/TeX/texbin:$PATH" a ~/.zshrc
• Reinicia Terminal y TeX64 tras cambiar el PATH

Configuración de LaTeX japonés

• MacTeX: incluye los paquetes CJK por defecto
• BasicTeX: instala los paquetes japoneses por separado: sudo tlmgr install collection-langjapanese
• Usa el paquete luatexja con lualatex
• Añade \usepackage{luatexja} a tu archivo .tex

Problemas comunes

latexmk no se encuentra

Instala MacTeX o ejecuta sudo tlmgr install latexmk

Archivo .sty faltante

Ejecuta sudo tlmgr install <package>

Problemas de PATH

Añádelo al perfil del shell

Permiso denegado

Usa sudo

Si tienes preguntas o necesitas soporte, visita la página de soporte.