Skip to content

Cómo compilar los apuntes

Pablo edited this page Dec 28, 2019 · 5 revisions

Requisitos

Las dependencias necesarias para compilar los apuntes son

  • texlive, en su versión completa (texlive-full o texlive-most dependiendo de la distribución),
  • pandoc (para los apuntes de informática) y
  • make.

Los apuntes están diseñados para ser compilados con la última versión disponible de ambos programas en macOS o Linux; si no puedes compilar los apuntes con las versiones que aparecen en la siguiente sección, rellena una incidencia. El sistema de make no tiene compatibilidad completa con Windows.

Puedes encontrar fácilmente en Internet guías de instalación de estos programas para tu sistema operativo.

Versiones compatibles con los apuntes

La siguiente tabla resume la compatibilidad de los apuntes con distintas versiones del sistema operativo. ":heavy_check_mark:" indica que todos los apuntes han podido compilarse correctamente, mientras que ":x:" indica que hay algún error.

texlive 2018 texlive 2019
pandoc 1.x
pandoc 2.7.x ✔️
pandoc 2.8.x ✔️

Compilación

De una sola asignatura

El Makefile define automáticamente un objetivo para cada asignatura cuyos apuntes siguen la estructura soportada.

Para compilar una asignatura con nombre asignatura (en minúsculas) la orden a ejecutar es

make asignatura

El archivo compilado (de nombre asignatura.pdf) se produce por defecto en la carpeta .out/.

De todas las asignaturas

Podemos obtener un .tar.gz con todos los apuntes con el objetivo por defecto de make, esto es, ejecutando

make

Variables de Makefile

Pueden pasarse como argumentos distintas variables para personalizar el proceso de compilación. Las variables disponibles actualmente son:

  • OUT: carpeta de salida
  • TARGET: Nombre del .tar.gz que contiene todos los apuntes
  • TEX_TEMPLATE: Plantilla de apuntes basados en LaTeX (apuntes de matemáticas)
  • MD_TEMPLATE: Plantilla de apuntes basados en Markdown (apuntes de informática)
  • CONT: Si es true activa la compilación continua para apuntes de matemáticas

Por ejemplo, si queremos compilar la asignatura Sistemas Operativos (so) con la plantilla mi_plantilla.tex y queremos que se genere en la carpeta raíz ejecutaríamos

make MD_TEMPLATE=mi_plantilla.tex OUT=. so