Entorno TeX / Distribución TeX

Resumen

TeX64 invoca herramientas de línea de comandos como latexmk, lualatex y latexindent. Use una distribución TeX existente o confirme la descarga e instalación de un entorno TeX Live administrado.

Por qué se necesita una distribución TeX

El paquete de la aplicación TeX64 no incluye un motor LaTeX. Invoca comandos de una distribución TeX existente o administrada por la aplicación en su dispositivo. Sin una distribución TeX no se puede compilar.

  • 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)

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.

Configuración de Windows 10/11

En Windows x64 puede usar TeX Live administrado, una instalación normal de TeX Live o MiKTeX.

TeX Live administrado

  • Abra TeX64 > Ajustes > Entorno y elija instalar TeX Live administrado.
  • Revise y apruebe la descarga. Una instalación completa necesita varios GB libres y puede tardar.
  • Mantenga TeX64 abierto hasta terminar; se instala en una carpeta administrada por la app y se detecta automáticamente.

TeX Live (manual)

  • Descargue y ejecute el instalador oficial de Windows de TeX Users Group.
  • Si dispone de varios GB, elija el esquema completo para reducir errores por paquetes faltantes.
  • Añada C:\texlive\<year>\bin\windows al PATH y cierre por completo y vuelva a abrir TeX64.
  • https://www.tug.org/texlive/acquire-netinstall.html

MiKTeX

  • Instale MiKTeX y use MiKTeX Console para actualizar e instalar paquetes faltantes.
  • Active la instalación de paquetes bajo demanda para resolver archivos .sty faltantes durante la compilación.
  • Confirme que el directorio bin de MiKTeX está en PATH y que lualatex, latexmk y synctex están disponibles.
  • https://miktex.org/download

Verificar desde PowerShell

Ejecute estos comandos en una nueva ventana de PowerShell y compruebe Ajustes > Entorno en TeX64:

Get-Command lualatex
Get-Command latexmk
Get-Command latexindent
Get-Command synctex

Si no se encuentra un comando, corrija PATH en Configuración de Windows > Sistema > Acerca de > Configuración avanzada del sistema > Variables de entorno, y reinicie por completo PowerShell y TeX64.

Solución de problemas en Windows

  • TeX Live: compruebe que el año del PATH coincide con la carpeta instalada y que termina en \bin\windows.
  • MiKTeX: actualice en MiKTeX Console e instale latexmk o el paquete indicado en el registro de compilación.
  • Instalación administrada: confirme una conexión estable y varios GB libres, reintente desde Ajustes > Entorno y adjunte el registro al contactar con soporte.

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.