¿Cómo puedo crear documentos PDF LaTeX con ANT (o algún otro sistema de compilación si lo prefiere)?

Question

El equipo para el que trabajo maneja una gran colección de documentación técnica que está escrita en LaTeX.

Actualmente toda la documentación que tenemos es construida manualmente por los editores y luego ingresada en un sistema de control de versiones. A veces las personas olvidan compilar sus documentos, por lo que tenemos una situación en la que los archivos PDF y .tex a menudo están desfasados. Lamentablemente, cuando esto sucede, nuestros usuarios se encuentran leyendo versiones antiguas de nuestro documento.

He logrado hackear una secuencia de comandos simple para construir archivos PDF utilizando Make - es bastante torpe.

Me preguntaba si había una mejor manera de hacerlo. La mayoría de las personas en nuestro departamento usan Eclipse + Pydev para un proyecto de Python, lo que significa que todos estamos muy familiarizados con este IDE. Sé que Ant juega muy bien con Eclipse, así que ¿podríamos usar esta herramienta para construir nuestro doc?

Entonces, ¿cuál es la mejor manera de hacerlo? Espero no tener que aprender todo lo que hay que saber sobre un nuevo sistema de construcción para automatizar la construcción de algunos documentos bastante simples.

Answer 1

Hay un Ant task externo para la generación de PDF LaTeX, aunque el sitio está en alemán.

Para usarlo, descarga el frasco a un lugar en el equipo, a continuación, definir un taskdef de la siguiente manera:

<taskdef name="latex" classname="de.dokutransdata.antlatex.LaTeX" 
    classpath="/path/to/ant/lib/ant_latex.jar"/> 

Luego de usarlo, definir un objetivo de la siguiente manera:

<target name="doLaTeX"> 
    <latex 
    latexfile="${ltx2.file}" 
    verbose="on" 
    clean="on" 
    pdftex="off" 
    workingDir="${basedir}" 
    /> 
</target> 

Donde ltx2.file es el archivo para procesar.

Este es un enlace al howto page que enumera los parámetros. Si necesita más opciones, mi alemán es lo suficientemente aceptable como para explicarlo, tal vez. También hay un maven plugin for LaTeX, pero no puedo encontrar ninguna documentación.

Answer 2

No lo he probado, pero recuerdo seeing a blog post about i t.

Answer 3

Si conoces a pitón, this blog post might be interesting

EDITAR: Además, yo supongo que está utilizando algún tipo de sistema de control de versiones, y no puedo decir con certeza, pero usar Git para gestionar todos mis documentos de látex, y podría ser posible utilizar algún tipo de gancho post-commit para ejecutar un script para reconstruir el documento. Esto dependerá de cómo esté estructurado su repositorio ... solo de pensar en voz alta, por así decirlo.

Answer 4

He entrado en gran detalle sobre una gran cantidad de sistemas de construcción para látex en this question, pero es un poco diferente en su caso. Creo que quieres goma o latexmk. El archivo de látex parece una buena idea, pero solo admite la construcción a través de postscript, que podría no ser su proceso de compilación.

En general, es una buena idea mantener los archivos generados fuera del control de versiones por esta razón. Una buena excepción es cuando las herramientas especializadas de compilación no están ampliamente disponibles, y su situación suena similar. Puede hacer mejor con un commit-hook para compilar automáticamente en commit.

Supongo que también debo señalar que cometer algo sin primero construirlo y verificarlo es un pecado mortal, por lo que una mejor solución podría ser eliminarlo.

Answer 5

Maven es una mejor alternativa que el sistema de compilación en comparación con Ant. Así que recomendaría un maven-plugin para generar PDF a partir de fuentes LaTeX. Eche un vistazo a mathan-latex-maven-plugin