Configurar LaTeX localmente puede ser bastante doloroso para principiantes. Sin embargo, puede ser muy ventajoso a largo plazo. Por ejemplo, te permitirá escribir y editar documentos sin necesidad de conexión a internet. También, no tendrás que depender de editores online, esto quiere decir que si sus servidores están caídos no tienes que entrar en una crisis de nervios si se aproxima una fecha de entrega.
Nota: existen muchas maneras para configurar LaTeX localmente. Aquí explico una forma que ha funcionado para mí.
Visual Studio Code (or comúnmente conocido como VSCode) es un editor de código fuente, que puedes descargar gratis en tu computador.
Ir a extensiones en VSCode e instalar LaTeX Workshop.
Los pasos 1 y 2 te permitirán usar LaTeX en VSCode
Para usar LaTeX localmente tienes que instalar TeX Live.
Dependiendo de tu sistema operativo, existen diferente opciones de descarga. Por ejemplo, si utilizas Mac OS X, puedes descargar MacTeX, el cual instalará la distribución completa de TeX Live, junto con herramientas adicionales en tu computador. (No te preocupes si la página web de MacTex tiene un aspecto algo "retro". En realidad, muchas páginas y contenido relacionado a LaTeX tienen este mismo aspecto.)
Advertencia: si descargas la distribución completa de TeX Live, por ejemplo a través de MacTeX, se descargará y se instalará un archivo de ~5GB en tu computador.
Si te gustaría descargar una versión más pequeña de TeX Live en Mac OS X, puedes descargar BasicTex, la cual tiene un tamaño de tan solo ~100MB.
Una vez instalado TeX Live, se ubicará en /usr/local
.
Para acceder a esta carpeta a través del finder, ir a ubicaciones -> macOS -> usr -> local
(cmd + shift + .
para mostrar archivos ocultos en mac.)
Una vez realizados los pasos 1, 2 y 3, todo está listo para empezar a escribir documentos en LaTeX.
Los siguientes son comandos útiles para usar LaTeX en VSCode de manera más fácil:
cmd + alt + B
or cmd + S
Compila el proyecto y construye en archivo pdf
cmd + alt + V
Ubicar el cursor en la ubicación específica del archivo tex y presionar cmd + alt + J
cmd + click
en la ubicación específica del archivo pdf
cmd + click + C
Archivos que se consideran auxiliares pueden tener las siguientes extensiones: .aux, .log, .synctex.gz, ...
alt + Z
Errores comunes que encontrarás, especialmente si has descargado BasicTeX, son:
Ejemplo del error:
! LaTeX Error: File 'needspace.sty' not found
Para solucionar este error debes descargar el paquete faltante needspace
a través de tlmgr (el administrador de TeX Live):
- Escribir en la terminal
sudo tlmgr install <nombre-paquete>
Usualmente, cuando utilizas el comando sudo
, el computador te pedirá la contraseña. Esto se debe a que necesita tu autorización para realizar la operación deseada. En este caso la operación es instalar un paquete.
Note: algunos paquetes son parte de "bundles" o colecciones, por lo tanto para instalar el paquete debes instalar el "bundle" mediante sudo tlmgr install <nombre-bundle>
.
Por ejemplo, para instalar el paquete authblk
se debe instalar el bundle preprint
.
Para encontrar información sobre paquetes y bundles, puedes visitar la página web CTAN.
- Para actualizar un paquete
sudo tlmgr update <nombre-paquete>
- Para actualizar todos los paquetes
sudo tlmgr update -all
- Para que tlmgr se actualice a sí mismo
sudo tlmgr update -self
Acá puedes encontrar una guía para el uso general de tlmgr.
Ejemplo del error:
! I can't find file 'phvr8t'.
<*> ...ljfour; mag:=1; ; nonstopmode; input phvr8t
Para solucionar este error debes descargar el tipo de letra faltante phvr8t
a través de tlmgr (el administrador de TeX Live):
Para instalar un tipo de letra es recomendable instalar una colección de tipos de letra mediante un "bundle". Los siguientes son "bundles" de tipos de letra útiles:
sudo tlmgr install psnfss
ysudo tlmgr install collection-fontsrecommended
Si te gustaría contar el número de palabras en tu documento tex al usar VSCode:
Ir a extensiones en VSCode e instalar LaTeX Utilities.
Escribir en la terminal sudo tlmgr install texcount
Para compartir preguntas o sugerencias, la creación de issues es bienvenida :)
Gracias a Saumil Shah por su gran poder cerebral 👾