¿Por qué la plantilla compila en Ubuntu y no siempre en Windows?

La plantilla usa paquetes y herramientas recientes de LaTeX. Si su sistema los tiene, compila sin problemas. Esta guía explica la causa del error más común y le ofrece cinco caminos para resolverlo.

Ubuntu (Linux)

Compila correctamente: TeX Live y las herramientas auxiliares se instalan juntos y quedan disponibles desde la terminal.

Windows + TeX Live actualizado

Compila correctamente, siempre que TeX Live sea la distribución que el sistema usa por defecto.

Windows + MiKTeX

Suele fallar. Vea la explicación abajo.

Veredicto

Linux es el entorno de referencia para make4ht. Windows con TeX Live completo y actualizado también compila la plantilla sin problemas. MiKTeX no se recomienda.

La plantilla se probó con TeX Live 2026 en Windows y compiló sin errores de TeX. Los detalles que aparecieron después (una fórmula mal escrita, un icono dentro de un enlace, estilos CSS) no dependían del sistema operativo: habrían ocurrido igual en Ubuntu. Lo que decide si compila es la distribución, no Windows o Linux.

Por qué Linux sigue siendo más cómodo

Qué le recomendamos

  1. Si usa o puede usar Ubuntu (opciones c, d o e): es donde la plantilla se desarrolla y prueba.
  2. Si trabaja en Windows (opción b): instale TeX Live completo, elimine MiKTeX y use carpetas sin espacios ni tildes.
  3. Si en Windows falla algo externo, como la conversión a SVG o Inkscape: use WSL (opción c) y obtendrá el mismo entorno que en Linux sin salir de Windows.

La causa: MiKTeX frente a TeX Live

Ambas son distribuciones de LaTeX, pero se mantienen de forma distinta.

TeX Live es la distribución de referencia. La mantiene el TeX Users Group (TUG) junto con una comunidad amplia de voluntarios, recibe los paquetes de CTAN rápidamente y es la misma en Linux, Windows y macOS.

MiKTeX está pensada para Windows y la sostiene un equipo mucho más pequeño. Tiene su propio sistema de actualización (MiKTeX Console), pero en la práctica algunos paquetes llegan con retraso, otros no se actualizan bien y ciertas herramientas que la plantilla necesita no están disponibles o se comportan distinto. El resultado típico son errores de paquetes desconocidos o versiones incompatibles.

Tener MiKTeX y TeX Live instalados a la vez es otra fuente frecuente de errores: el editor puede estar llamando a MiKTeX aunque usted ya haya instalado TeX Live.

Resumen de soluciones

OpciónQué haceEsfuerzoRecomendada para
aInstalar TeX Live y darle prioridad sobre MiKTeXQuien necesita conservar MiKTeX
bBorrar MiKTeX e instalar TeX Live completoLa mayoría de usuarios de Windows
cUbuntu dentro de Windows con WSLQuien quiere el entorno Linux sin reiniciar
dUbuntu junto a Windows (arranque dual)Uso intensivo y máximo rendimiento
eUsar una computadora con UbuntuQuien ya tiene o puede dedicar un equipo
a

Instalar TeX Live y darle prioridad

Conserva MiKTeX, pero requiere ajustar variables del sistema.

  1. Descargue el instalador install-tl-windows.exe desde tug.org/texlive/windows.html.
  2. Ejecútelo como administrador y elija el esquema completo (scheme-full). La instalación desde internet puede tardar una o dos horas.
  3. Abra Configuración → Sistema → Información → Configuración avanzada del sistema → Variables de entorno.
  4. En la variable Path (del sistema y del usuario), mueva la carpeta de TeX Live por encima de la de MiKTeX. La ruta suele ser: 
    C:\texlive\2026\bin\windows
    (el año cambia según la versión instalada).
  5. Cierre y vuelva a abrir la terminal y el editor. Verifique cuál distribución responde: 
    where pdflatex
pdflatex --version
    La primera ruta debe ser la de C:\texlive y la versión debe decir TeX Live.
  6. En su editor (TeXstudio, TeXworks, VS Code…) revise que las rutas de los compiladores apunten a TeX Live y no a MiKTeX.
b

Borrar MiKTeX e instalar TeX Live completo

La solución más limpia si se queda en Windows.

  1. Desinstale MiKTeX desde Configuración → Aplicaciones → Aplicaciones instaladas.
  2. Elimine las carpetas que quedan (si existen). Puede pegarlas en la barra del Explorador de archivos: 
    %APPDATA%\MiKTeX
%LOCALAPPDATA%\MiKTeX
%LOCALAPPDATA%\Programs\MiKTeX
C:\ProgramData\MiKTeX
C:\Program Files\MiKTeX
  3. Revise la variable Path y borre cualquier entrada que mencione MiKTeX.
  4. Reinicie el equipo.
  5. Instale TeX Live completo con install-tl-windows.exe desde tug.org/texlive/windows.html.
  6. Guarde sus proyectos en una carpeta sin espacios ni tildes y fuera de OneDrive, por ejemplo C:\proyectos\plantilla.
  7. Para mantenerlo al día, abra una terminal como administrador y ejecute periódicamente: 
    tlmgr update --self --all
c

Ubuntu dentro de Windows con WSL

Un Ubuntu real que corre como una aplicación más. En Windows 11 también abre programas gráficos como Kile, Okular e Inkscape.

  1. Abra PowerShell como administrador y ejecute: 
    wsl --install
    Esto instala WSL y Ubuntu. Reinicie cuando se lo pida.
  2. Abra la aplicación Ubuntu desde el menú Inicio y cree su usuario y contraseña de Linux.
  3. Actualice el sistema e instale todo lo necesario: 
    sudo apt update && sudo apt upgrade -y
sudo apt install -y texlive-full kile okular inkscape
    texlive-full ocupa varios GB; tenga paciencia.
  4. Inicie el editor escribiendo kile en la terminal de Ubuntu.
  5. Sus archivos de Windows están en /mnt/c/Users/SuUsuario/. Para mayor velocidad, trabaje los proyectos dentro de su carpeta de Linux (~/).

Documentación oficial: learn.microsoft.com/windows/wsl/install

Requiere Windows 10 (versión 2004 o posterior) o Windows 11. Las aplicaciones gráficas funcionan de forma directa en Windows 11 y en versiones recientes de Windows 10.
d

Ubuntu junto a Windows (arranque dual)

Al encender la computadora elige Windows o Ubuntu. Es perfectamente posible y ambos sistemas conviven sin problema.

  1. Haga un respaldo de sus archivos importantes antes de empezar.
  2. Si usa BitLocker, anote su clave de recuperación o suspéndalo. Desactive el Inicio rápido de Windows (Panel de control → Opciones de energía).
  3. Descargue la última versión LTS de ubuntu.com/download/desktop.
  4. Cree una memoria USB de arranque (8 GB o más) con Rufus o balenaEtcher.
  5. Reinicie y arranque desde la USB (tecla F12, F2, Esc o F10, según el fabricante).
  6. En el instalador elija Instalar Ubuntu junto a Windows y reserve al menos 50 GB.
  7. Ya en Ubuntu, abra una terminal e instale las herramientas: 
    sudo apt update && sudo apt upgrade -y
sudo apt install -y texlive-full kile okular inkscape

Guía oficial: ubuntu.com/tutorials/install-ubuntu-desktop

e

Usar una computadora con Ubuntu

La opción más sencilla: el entorno donde la plantilla fue probada.

Si tiene un equipo con Ubuntu (o puede instalarlo en una laptop antigua, siguiendo los pasos 3 a 6 de la opción d y eligiendo Borrar disco e instalar Ubuntu), solo necesita:

sudo apt update && sudo apt upgrade -y
sudo apt install -y texlive-full kile okular inkscape
Consejo: el TeX Live de los repositorios de Ubuntu queda fijo en la versión de cada lanzamiento. Si algún paquete resulta demasiado antiguo, instale TeX Live directamente desde tug.org/texlive/quickinstall.html y actualícelo con tlmgr.

Comprobación final

En cualquiera de las opciones, confirme que usa TeX Live antes de compilar la plantilla:

pdflatex --version
tlmgr --version

Ambos comandos deben responder y mencionar TeX Live. Si tlmgr no existe, el sistema todavía está usando otra distribución.

Videos: compilar la plantilla con make4ht

Estos videos muestran el proceso completo de compilación de la plantilla con make4ht, primero en Ubuntu y luego en Windows con TeX Live.

Ubuntu Compilación con make4ht en Linux · descargar
Windows Compilación con make4ht y TeX Live · descargar
Los archivos Make4htUBUNTU.mp4 y Make4htWINDOWS.mp4 deben estar en la misma carpeta que esta guía.