Instalación de paquetes LaTeX

Para compilar con LaTeX, necesitará el compilador pdfLaTeX; este compilador viene junto con los paquetes básicos que necesitará para crear documentos PDF. Algunos paquetes no estan en el conjunto de paquetes que LaTeX instala; los paquetes faltantes serán descargados vía tlmgr.

Los requerimientos para elaborar documentos PDF con md2tex son los siguientes:

• Sistema operativo Linux (de preferencia Debian).
• Instalación de paquete texlive-latex-base.

# En debian o derivados
$ apt install texlive-latex-base

Instalación de biber

Biber es un software utilizado para manejar las bibliografías en LaTeX. Deberá instalarlo en su sistema ejecutando el siguiente comando:

$ apt install biber

Es posible que necesite permisos de superusuario para ejecutar el comando anterior.

Configuración de tlmgr

tlmgr administra una instalación existente de TeXLive, tanto los paquetes como las opciones de configuración. Para empezar a configurar tlmgr en su sistema, ejecute:

$ tlmgr init-usertree

El comando anterior configurará tlmgr para que funcione en modo usuario. Se creará una carpeta denominada texmf en la ruta /home/<your user>/ (sistemas Debian y derivados).

Dentro de la carpeta texmf se crearán las siguientes archivos y carpetas:

texmf/
├── tlpkg/
└── web2c/
    └── tlmgr.log

Se crearán varios archivos auxiliares; el archivo tlmgr.log es importante, ya que lleva un registro detallado de las acciones que se han ejecutado con tlmgr.

Para que tlmgr descargue paquetes, deberá indicarle un repositorio del cual descargarlos. Utilice el siguiente comando para que tlmgr apunte a un repositorio.

$ tlmgr option repository <url repository>

Si está utilizando un sistema Debian o derivado, se recomienda utilizar el siguiente repositorio: ftp://tug.org/historic/systems/texlive/2018/tlnet-final

Para instalar paquetes con tlmgr, utilice el siguiente comando:

$ tlmgr install <package>

La operación anterior tardará varios minutos, los paquetes descargados se instalarán en la carpeta texmf.
Se recomienda poner todos los paquetes a descargar en un solo comando.

Los paquetes que necesitará descargar para el funcionamiento de md2tex son los siguientes:

subfigure

md2tex hace uso del paquete setspace pero este no se puede descargar a través de tlmgr; este paquete se deberá instalar manualmente. Descargue el paquete setspace aquí o busquelo en la sección Recursos, en el apartado Paquete setspace.

Una vez descargado descomprima el archivo en la ruta: /home/<your user>/texmf/tex/latex.

Pruebas unitarias

Se ha desarrollado un script para que usted pueda verificar que los paquetes de LaTeX requeridos se encuentran en su sistema. En este apartado encontrará un conjunto de pruebas unitarias que interpretan con md2tex un archivo, luego lo compilan con pdfLaTeX y muestran el resultado en una carpeta llamada output.

La estructura de la carpeta de pruebas unitarias es la siguiente:

unit-tests/
├── chktex
├── md2tex
├── run-tests
├── <test 1>/
├── <test 2>/
└── <test n>/

En la carpeta de unit-tests encontrará lo siguiente:

• La versión mas reciente de md2tex; en este caso md2tex es utilizado en el entorno local por el script run-tests.
• La versión mas reciente de chktex; este es un ejecutable que verifica que los paquetes requeridos se encuentran en el sistema.

  Este ejecutable está escrito en C++, en el fondo ejecuta el comando
  tlmgr list --only-installed. chktex puede recibir el flag --manual-config como segundo parámetro, con lo cual NO ejecutará el comando de tlmgr sino que irá a verificar que las carpetas de los paquetes requeridos existan en la ruta
  /home/<your user>/texmf/tex/latex/.

• El script run-tests ejecuta md2tex y pdfLaTeX por cada carpeta de test que encuentra.
• Las carpetas de tests; los nombres de estas carpetas no deberán ser modificados.

  Por cada carpeta de test se generará una carpeta output en la ruta <test>/latex/tex/.

Descargue las pruebas unitarias aquí

Ejecución de pruebas unitarias

Para ejecutar las pruebas unitarias, escriba en la línea de comandos:

$ cd unit-tests
$ bash run-tests

Si el archivo run-tests necesita permisos de ejecución, ejecute el siguiente comando: chmod +rwx run-tests.

La ejecución del script será similar a la siguiente:

Configuración manual

Debido a que tlmgr tarda mucho tiempo en descargar paquetes; usted puede hacer una configuración manual de los paquetes, si así lo desea. Cuando el compilador de pdfLaTeX no encuentra un paquete en sus archivos, vá a consultar la carpeta de usuario llamada texmf; si encuentra el paquete, lo utilizará para generar el documento final.

Para crear la carpeta texmf vaya a la ruta /home/<your user>/ y escriba lo siguiente:

# comando para inicializar tlmgr en modo usuario
$ tlmgr init-usertree

# o puede crear la carpeta directamente
$ mkdir texmf

Independientemente del comando que haya ejecutado; dentro de texmf deberá crear la carpeta tex y dentro de la carpeta tex, creará la carpeta latex. En línea de comandos lo haría de la siguiente manera:

$ cd texmf
$ mkdir tex
$ cd tex
$ mkdir latex

Dentro de la carpeta latex, podrá descomprimir los archivos y carpetas que se brindan en esta documentación.

Descargue los paquetes de LaTeX requeridos por md2tex aquí.

Ejecución de pruebas unitarias

Para ejecutar las pruebas unitarias deberá ejecutar el script run-tests, con el flag --manual-config.

$ bash run-tests --manual-config