Saltar a contenido

Instalación de LaTeX con VSCode y MikTex

Índice

Nota

Puedes navegar cómodamente por el tutorial usando los enlaces a la derecha en ordenador, en el botón de arriba a la izquierda si estás en móvil.

Requisitos

Obligatorio

Opcional

Instalación con MikTex y Perl

VSCode

Descarga e instala VSCode desde aqui: https://code.visualstudio.com/. Este es el paso más sencillo, y ya que no es el objetivo de este tutorial, no se explicará más.

Ya que estamos con el paso de VSCode, para instalar la extensión:

  1. Abre VSCode
  2. Pulsa Ctrl+Shift+X o ve a la pestaña de extensiones, señalada con la flecha roja 1.
  3. Busca LaTeX Workshop, señalado con la flecha roja 2.
  4. Pulsa en la extensión LaTeX Workshop, señalado con la flecha roja 3.
  5. Pulsa en Install, señalado con la flecha roja 4.

Extensión

Una vez que tengas todo instalado en VSCode, no necesitas hacer nada más por ahora.

MikTex

Para instalar MikTex, dirigete a su página web: https://miktex.org/download. Es más, MikTex ofrece un tutorial de instalación el cual hare referencia en esta página, aunque puedes consultarlo en cualquier momento aquí: https://miktex.org/howto/install-miktex.

Si quieres descargar MikTex directamente, puedes usar este enlace:

Descargar MikTex

Para instalar MikTex paso a paso:

  1. Deja seleccionado Install MikTex only for me y presiona Next.
  2. Mantén el directorio de instalación por defecto y presiona Next.
  3. Recomiendo dejar la opción en vez de Ask me first por Always en Install missing packages on-the-fly, para que se instalen los paquetes automáticamente si al compilar un documento falta ese paquete.
  4. En Review, comprueba que las opciones son las mismas que en la cuarta imagen de abajo y presiona Start para comenzar la instalación.

Alt text Alt text Alt text Alt text

Una vez finalizada la instalación, tendrás un nuevo programa llamado MikTex Console, el cual es un gestor de paquetes de MikTex.

Desde aquí puedes instalar, actualizar y desinstalar paquetes de MikTex de forma sencilla, además de actualizarlos.

También recomiendo, al menos, abrir una vez MikTex Console para que se actualicen los repositorios de paquetes de MikTex.

Instalar todos los paquetes disponibles en MikTex (avanzado)

Si prefieres instalar TODOS los paquetes disponibles con MikTex tienes que hacer lo siguiente:

  1. Ve a la pestaña Packages.
  2. Ordena los paquetes por Installed on para que los paquetes que no tengas instalados aparezcan arriba.
  3. Cuando tengas ordenados los paquetes, selecciona el primero, y haz scroll hasta que veas el primer paquete con una fecha. MANTEN Shift y haz click en ese paquete.
  4. IMPORTANTE: BUSCA EL PAQUETE autosp, este paquete no esste en ningún repositorio y NO podrás instalar todo de forma automática. Deselecciona el paquete con Ctrl+Click.
  5. Una vez deseleccionado, presiona el botón de un + para instalar todos los paquetes.
  6. Mientras se instalan los paquetes, aparece una ventana "Package Installation" con descripnión: "The required file " desmarca la casilla "Always show this dialog before installing packages" y presiona "Install"; para automatizar la instalación al completo.
  7. Cuando el botón "Cancel" cambie a "Close", significa que todo el proceso ha finalizado. Cierra MikTex Console para proceder a instalar Perl.

Instalación de Perl

Explicación

La extensión de Latex Workshop requiere de Perl para poder compilar los documentos de LaTeX. Por lo que, si no instalas Perl, no podrás compilar los documentos.

Dirigete a: https://strawberryperl.com/ y descarga System installer version. También puedes usar este botón para descargarlo directamente:

Descargar Strawberry Perl

E instala Straberry Perl, no necesitar configurar nada del instalador, así que continúa hasta instalar el programa (recuerda aceptar los requisitos de administrador).

Una vez instalado, puedes utilizar Latex-Workshop

Post-instalación de MikTex y Strawberry Perl

Dirigete a Latex-Workshop para continuar con la instalación de Latex-Workshop.

Instalación con TinyTex

Por qué no recomiendo TinyTex

Si no tienes experiencia con la consola de comandos, es preferible que prefieras usar los métodos de instalación gráficos de MikTex con VSCode o TexStudio.

Si aun así quieres usar TinyTex, puedes seguir este tutorial:

Instalar TinyTex

VSCode

Descarga e instala VSCode desde aqui: https://code.visualstudio.com/. Este es el paso más sencillo, y ya que no es el objetivo de este tutorial, no se explicará más.

Ya que estamos con el paso de VSCode, para instalar la extensión:

  1. Abre VSCode
  2. Pulsa Ctrl+Shift+X o ve a la pestaña de extensiones, señalada con la flecha roja "1".
  3. Busca "LaTeX Workshop", señalado con la flecha roja "2".
  4. Pulsa en la extensión "LaTeX Workshop", señalado con la flecha roja "3".
  5. Pulsa en "Install", señalado con la flecha roja "4".

Extensión

Una vez que tengas todo instalado en VSCode, no necesitas hacer nada más por ahora.

TinyTex

Este es el proceso más delicado, ya que se requiere de pasos específicos para que funcione correctamente.

Ve al siguiente enlace: https://github.com/rstudio/tinytex-releases Y baja abajo hasta encontrar el apartado de "Releases":

TinyTex

Descarga el instalador de TinyTex, señalado en amarillo.

Explicación técnica

Descargamos específicamente el TinyTex-2 debido a que contiene la mayória de paquetes de CTAN, es decir, equipara los paquetes instalados a los que tiene disponible Overleaf.

Una vez descargado, ejecuta el instalador de TinyTex, el cual abrirá una consola de comandos. Este proceso descomprimirá los paquetes en una nueva carpeta para ser usado como un instalador normal. Este proceso puede llevar un tiempo dependiendo de como de buenos sean tu CPU y disco.

Cuando se cierre automáticamente la consola, puedes dirigirte a la nueva carpeta llamada "TinyTex" y ejecutar install-tl-windows.bat. No necesitas configurar nada, simplemente pulsa "Instalar" y espera hasta que se instale.

Si el instalador no funciona

En mi ordenador, por alguna razón, no funciona el instalador de TexLive, devolviendo un error "Broken Pipe". He estado mucho tiempo intentando arreglar este error y no he podido. Así que, si no quieres tener un gestor de paquetes roto, recomiendo instalar MikTex como he comentado aqui: Requisitos, "Por qué TinyTex".

Así que, lo mejor que puedes hacer es:

  1. Abrir la consola de comandos con la ruta de la carpeta de TinyTex y escribir este comando (puedes copiarlo con el botón a la derecha del bloque de código):
Comando
install-tl-windows.bat --no-gui

Y debería salir algo así:

Consola Texlive

Escribe como comando: I y pulsa Enter. Esto instalará TexLive en tu ordenador. Este proceso puede llevar un tiempo dependiendo de como de buenos sean tu CPU y disco.

Post-instalación de TinyTex

Dirigete a Latex-Workshop para continuar con la instalación de Latex-Workshop.

Latex-Workshop

Una vez que tengas todo instalado, puedes abrir VSCode, crear un nuevo archivo de LaTeX, o puedes usar uno desde Overleaf, mientras tengas un archivo .tex, el compilador detectará automaticamente el archivo main y lo compilará.

Este es la interfaz general de Latex-Workshop:

alttext

A la izquierda, cuando cargue la extensión, verás nuevas pestañas correspondientes al uso de Latex-Workshop. La más importante es Latex: Commands. Desde aquí puedes compilar, ver logs, limpiar archivos temporales, ver tu archivo compilado, etc.

Vamos a probar a compilar unos apuntes de la asignatura de Consolas.

Para realizarlo, haz clic en el botón Build Latex Project con una flecha verde.

IMPORTANTE: necesitas que el cursor para escribir este en la pestaña del documento de LaTeX, si no es el caso, los botones NO funcionarán.

Esto compilará el archivo .tex y generará un archivo .pdf. El tiempo de compilado depende de muchos más factores que Overleaf, debido a que depende en como de potente sea tu CPU. Cuando el archivo se compile, aparecerá un check en la barra inferior de VSCode, indicando una compilación correcta.

Para abrir el archivo .pdf generado, puedes hacer clic en el botón View LaTeX PDF file. Esto abrirá el archivo .pdf en el propio visor de interno de VSCode.

Además, la mayoría de comandos están disponibles con el Intellisense de VSCode, por lo que puedes usarlos sin necesidad de usar los botones. Solo tienes que pulsar Control + Espacio y aparecerán los comandos disponibles.

Synctex

De hecho, puedes usar comandos muy útiles; si haces "Control + Click" en el documento .pdf, te llevara a la línea de código correspondiente en el archivo .tex. Para hacerlo al contrario, haz click en la línea de código en archivo .tex, y pulsa "Control + Alt + J".

Cambiar compilador

Es posible que estés utilizando comandos especiales que requieran de compilador específico (1), como el uso de fuentes personalizadas. Para cambiarlo, donde Build Latex Project hay un desplegable con el nombre del compilador. Puedes cambiarlo al que desees. Normalmente, utilizarás latexmk (2) el cual es el equivalente a pdflatex de Overleaf. Y latexmk (xelatex), el que usa si usas fuentes personalizadas.

  1. Por ejemplo, \setmainfont es exclusivo de Xelatex.
  2. Latexmk, de hecho, es el compilador que utiliza Strawberry Perl.
Los captions o índices no se actualizan

Simplemente compila varias veces el documento hasta que aparezcan, esto es una limitación del propio Latex que Overleaf arregla de forma automática.

Configuración de Latex-Workshop

En el menú superior de VSCode, presiona: "File -> Preferences -> Settings" y en el buscador escribe: "latex-workshop". Aparecerán todas las opciones de configuración de Latex-Workshop.

Si necesitas algún ajuste específico puedes buscarlo en la documentación de Latex-Workshop: https://github.com/James-Yu/LaTeX-Workshop/wiki

Última actualización: October 22, 2023
Creado: October 22, 2023