Un libro hoy en día puede estar disponible en varios formatos: HTML, PDF, EPUB, libro impreso, etc. Lo ideal es que esté disponible en la mayoría de formatos posibles para llegar al mayor número de personas posible. Sin embargo, no es cómodo editar varios archivos cuando solo queremos realizar un cambio. Para evitar ese trabajo tedioso podemos usar un formato base y convertir de este a otros formatos con Pandoc.
Podemos escribir el libro con LibreOffice Writer o con un editor de texto plano en formatos como HTML, LaTeX, Markdown, etc. Para convertir ese archivo a otro formato bastaría con ejecutar un comando.
Para ilustrar como hacerlo todo te enseñaré cómo genero este libro. Como sistema de control de versiones decidí usar Git y crear un repositorio público. Puedes clonar el repositorio ejecutando los siguientes comandos:
sudo apt install git
git clone https://notabug.org/jorgesumle/la-cultura-es-libre-una-historia-de-la-resistencia-antipropiedad
Una vez clonado verás una carpeta llamada markdown, allí es donde se
encuentra el texto del libro en formato Markdown. Instala Pandoc y Make
ejecutando sudo apt install make pandoc. Basta con ejecutar make
html en la carpeta raíz del repositorio para generar el HTML; con el
formato EPUB hay que ejecutar make epub.
Hay pocas líneas de código para generar los formatos HTML y EPUB. Sin
embargo, para generar el PDF necesito instalar más dependencias y usar
más código para generar y editar un archivo LaTeX que luzca bien cuando
se convierta a PDF. Para ello yo he añadido código LaTeX personalizado
(se encuentra en la carpeta latex_personalizado) al archivo LaTeX con
el que genero el PDF. También es posible generar un archivo PDF bonito
usando CSS, pues se puede elegir un generador de
PDF basado en HTML
con la opción --pdf-engine.
La documentación de Pandoc es un buen punto de partida para ver cómo añadir metadatos y generar archivos de salida cómo necesites. Si, como yo, optas por usar LaTeX para generar el PDF, en Internet encontrarás documentación y personas que proponen soluciones a problemas comunes.
Comentarios