Как я могу собрать документы PDF LaTeX с помощью ANT (или другой системы сборки, если вы предпочитаете)?

Question

Команда, в которой я работаю, управляет большой коллекцией технической документации, написанной на LaTeX.

В настоящее время вся имеющаяся у нас документация создается редакторами вручную, а затем проверяется в системе контроля версий. Иногда люди забывают скомпилировать свои документы, поэтому у нас возникает ситуация, когда файлы PDF и .tex часто выходят за рамки. К сожалению, когда это происходит, наши пользователи читают старые версии нашего документа.

Мне удалось взломать простой скрипт для создания PDF-файлов с помощью Make - это довольно неуклюже.

Мне было интересно, есть ли лучший способ сделать это? Большинство сотрудников нашего отдела используют Eclipse + Pydev для проекта Python, что означает, что мы все хорошо знакомы с этой IDE. Я знаю, что Ant прекрасно работает с Eclipse, поэтому можем ли мы использовать этот инструмент для создания документации?

Так, каков лучший способ сделать это? Я надеюсь, что мне не придется изучать все, что нужно знать о новой сборочной системе, чтобы автоматизировать сборку некоторых довольно простых документов.

Answer 1

Существует внешняя Задача Ant для генерации LaTeX PDF, хотя сайт на немецком языке.

Чтобы использовать его, загрузите флягу в папку на вашем компьютере, затем определите taskdef следующим образом:

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

Затем, чтобы использовать его, определите цель следующим образом:

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

Где ltx2.file - файл для обработки.

Это ссылка на страницу с инструкциями , в которой перечислены параметры. Если вам нужны дополнительные варианты, мой немецкий почти достаточно сносен, чтобы объяснить, может быть.

Существует также плагин maven для LaTeX , но я не могу найти никакой документации.

Answer 2

Я подробно рассказал о большом количестве систем сборки для латекса в этот вопрос , но в вашем случае он немного отличается. Я думаю, что вы хотите резину или латекс. Латексный make-файл кажется хорошей идеей, но он поддерживает сборку только через postscript, что может не соответствовать процессу сборки.

Как правило, по этой причине рекомендуется хранить сгенерированные файлы вне контроля версий. Хорошим исключением является случай, когда специальные инструменты сборки не доступны широко, и ваша ситуация звучит похоже. Вы можете сделать лучше с коммит-хуком, чтобы автоматически строить при коммите.

Полагаю, мне следует также указать, что совершать что-либо, не создав его сначала и не проверив, что это смертельный грех, поэтому лучшим решением может быть искоренение этого.

Answer 3

Если вы знаете Python, этот пост может быть интересным

EDIT : Кроме того, я бы предположил, что вы используете какую-то систему контроля версий, и я не могу сказать точно, но я использую git для управления всеми своими латексными документами, и это может быть возможно использовать какой-то хук post-commit для выполнения скрипта для перестроения документа. Это будет зависеть от того, как структурирован ваш репозиторий ... просто думать вслух, так сказать.

Answer 4

Не пробовал, но я помню , увидев сообщение в блоге о i t.

Answer 5

Maven - лучшая альтернатива в качестве системы сборки по сравнению с Ant. Поэтому я бы порекомендовал подключаемый модуль maven для создания PDF-файлов из источников LaTeX. Взгляните на mathan-latex-maven-plugin