bundledoc - Интернет в облаке

ПРОГРАММА:

ИМЯ

bundledoc - объединить все файлы, необходимые для документа LaTeX

СИНТАКСИС

пакетдок [--версия] [--Помогите] [--[нет]подробный] [--texfile=файл] [- каталог=каталог]
[--[нет]только локально] [--исключать=string] [--включают=спецификация файла] [- манифест=файл]
[--listdeps= [да | нет | только | отн] ...] [--[нет]хранители] [--config=файл] .деп файл

ОПИСАНИЕ

в комплектеoc постпроцессор для снимок пакет, который объединяет все
классы, пакеты и файлы, необходимые для создания данного документа LaTeX. Он читает .деп
файл, который снимок производит, находит каждый из упомянутых в нем файлов и упаковывает их
в один архивный файл (например, .tar.gz файл), пригодный для перемещения между системами,
передача коллеге и т. д.

В качестве простейшего возможного примера рассмотрим файл LaTeX с именем, скажем, привет.текс:

\ RequirePackage {снимок}% Требуется bundledoc
\ documentclass [11pt] {статья}

\ Begin {документ}
Привет, мир!
\ End {документ}

"\ RequirePackage {snapshot}" вызывает привет.деп файл, который будет создан. Когда в комплектеoc is
затем, используя "hello.dep" в качестве аргумента, он находит зависимые файлы - снимок.sty,
статья.clsкачества размер11.clo - и объединяет их в один архивный файл вместе с
привет.текс и еще один МАНИФЕСТ файл (описан ниже в разделе «ОПЦИИ»).

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

В следующих описаниях какой-нибудь файл относится к имени вашего основного документа LaTeX (нет
расширение).

в комплектеoc требует имя файла зависимости, созданного снимок (обычно
какой-то файл.dep). Также могут быть предоставлены следующие варианты:

--версия
Выведите в комплектеoc номер версии скрипта. Это отменяет все остальные
настройки.

--Помогите
Дайте краткое сообщение об использовании. Это отменяет все остальные параметры.

--[нет]подробный (по умолчанию: "noverbose")
в комплектеoc обычно ничего не выводит, кроме сообщений об ошибках. С "--verbose",
он выводит обильные сообщения о состоянии.

--texfile=main .tex файл (дефолт: какой-то файл.tex)
снимокфайл зависимостей не перечисляет основной файл LaTeX (тот, который передается
в латекс). Для того чтобы в комплектеoc найти и связать этот файл, в комплектеoc предполагает это
имеет то же имя, что и снимок файл зависимостей, но с .tex расширение. Если это
это не так, тогда используйте "--texfile", чтобы указать правильное имя файла.

- каталог=архив каталог (дефолт: какой-нибудь файл)
После появления в комплектеoc создает архив (например, .tar or .zip файл), содержащий
файлы документа, он помещает их все в каталог, чтобы не загромождать текущий
каталог с файлами. Если данный файл зависимости вызывается какой-то файл.dep то
итоговый архив по умолчанию будет хранить все зависимые файлы в какой-нибудь файл
каталог. Чтобы изменить имя каталога, используйте параметр «--directory».

--[нет]только локально (по умолчанию: "nolocalonly")
Несмотря на то, что в комплектеoc обычно архивирует все файлы, указанные в .деп файл,
Опция "--localonly" сообщает в комплектеoc исключить все файлы, находящиеся в директории, другой
чем .tex каталог файла или один из его подкаталогов.

--исключать=string (дефолт: никто)
В то время как "--localonly" вызывает файлы за пределами .tex дерево каталогов файла должно быть
исключено из архива, "--exclude" обеспечивает более детальный контроль над файлами для
исключить из архива. Параметр «--exclude», который можно указывать повторно на
командная строка, вызывает все файлы, имя которых содержит string быть исключенным из
архив.

--включают=спецификация файла (дефолт: никто)
Параметр "--include", который можно повторно указывать в командной строке,
инструктирует в комплектеoc включить в архив все файлы, соответствующие спецификация файла, Даже
если они не упоминаются в .деп .

- манифест=проявлять файл (дефолт: МАНИФЕСТ)
Помимо зависимых файлов, в комплектеoc включает в архивный файл один лишний
файл, который по умолчанию называется ``МАНИФЕСТ''. МАНИФЕСТ текстовый файл, в котором перечислены
оригинальные имена файлов всех зависимостей. Чтобы изменить имя файла с ``МАНИФЕСТ''
для чего-то еще, используйте параметр "--manifest". В особом случае "--manifest =" ""
говорит в комплектеoc чтобы вообще не включать файл манифеста.

--listdeps= [да | нет | только | отн] ...] (по умолчанию: "нет")
"--listdeps" принимает одно или несколько из "да", "нет", "только" или "отн." как разделенные запятыми.
список. Пока «нет» не отображается в этом списке, в комплектеoc выводит все основные
Зависимости файла LaTeX. Если список содержит "rel", то в комплектеoc выводит
список зависимостей с относительными путями. Если в списке есть «только», то
в комплектеoc завершает работу после отображения списка без создания архива.

--[нет]хранители (по умолчанию: "nokeepdirs")
Обычно архивный файл, в комплектеoc производит содержит единственный каталог - и
подкаталоги, если документ явно ссылается на них - в которых все
зависимые файлы лежат. Если указан "--keepdirs", все зависимые файлы сохраняются.
с их исходными путями. Например, если какой-то файл.tex зависит от
цифры / somefigure.eps, статья.clsкачества снимок.sty, то какой-нибудь файл архив будет
обычно содержат следующие файлы:

· somefile / somefile.tex

· somefile / цифры / somefigure.eps

· somefile / article.cls

· somefile / snapshot.sty

· somefile / МАНИФЕСТ

Однако "--keepdirs" вызовет какой-нибудь файл архив, содержащий следующие виды
вместо имен файлов:

· домой / меня / mydocs / somefile.tex

· главная / я / mydocs / цифры / somefigure.eps

· USR / доля / texmf / текс / латекс / база / article.cls

· USR / доля / texmf / текс / латекс / снимок / snapshot.sty

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

--config=конфигурация файл (дефолт: )
Параметр "--config" используется для указания в комплектеoc в соответствующую конфигурацию
(.cfg) для вашего дистрибутива TeX и операционной системы. в комплектеoc поставляется с
несколько файлов конфигурации, и легко написать больше. См. «КОНФИГУРАЦИОННЫЕ ФАЙЛЫ»
(ниже) для описания формата файла конфигурации.

КОНФИГУРАЦИЯ FILES

Формат
Файлы конфигурации имеют довольно простой формат. Строки, начинающиеся с "#", являются комментариями.
Пустые строки игнорируются. Все остальные строки имеют вид:

переменная: значение

Текущая версия в комплектеoc распознает следующие переменные:

пакет
Команда, используемая для объединения набора файлов в один архивный файл

раковина
Аффикс команды, отменяющей ее вывод

найдите
Команда для поиска файла в дереве (ах) TeX.

Значения, которые слишком длинные для одной строки, можно разделить на несколько строк с помощью символа "\" в качестве
символ продолжения строки.

Есть две переменные среды, которые в комплектеoc делает доступным для использования
команды конфигурационного файла: "BDBASE", для которого установлено значение какой-нибудь файл (как в "ОПЦИИ"), и
"BDINPUTS", который представляет собой список файлов, разделенных пробелами, с которыми должна работать команда.
на. То есть, когда команда, связанная с "bundle", выполняется, "BDINPUTS" содержит
список всех файлов, которые нужно заархивировать. Напротив, когда команда
связанный с "find" запущен, "BDINPUTS" содержит имя файла для поиска.

Примеры
Следующие параллели файла конфигурации в комплектеocзначения по умолчанию для различных
переменные файла конфигурации, которые представляют собой дистрибутив TeX на основе kpathsea, работающий
в общей системе Unix, которая не обязательно имеет какие-либо инструменты GNU, такие как
GZIP или GNU деготь:

# Файл конфигурации "по умолчанию"
# Скотт Пакин[электронная почта защищена]>

пакет: (tar -cvf - $ BDINPUTS | compress> $ BDBASE.tar.Z)
раковина:> / dev / null 2> & 1
найти: kpsewhich -progname = latex $ BDINPUTS

Скобки в строке "bundle:" указывают оболочке Unix запускать команду в
подоболочка. Это необходимо для правильной работы аффикса "раковина:" (т. Е. Чтобы не было двух
">" в той же команде).

Обратите внимание, как команды обрабатывают "BDBASE" и "BDINPUTS" как любые другие переменные среды.
в оболочке Unix, используя "$", чтобы получить их значение. Другие операционные системы используют разные
соглашения для ссылки на переменные среды. Например, файл конфигурации
для распространения TeX на базе Windows вместо этого следует использовать "% BDBASE%" и "% BDINPUTS%".

Значение для «сток:» специфично для операционной системы. Значение для "find:" равно
специфичен для дистрибутива TeX. "bundle:" - это то место, где больше всего возможностей для настройки
ложь. Вы можете использовать "bundle:", чтобы указать ваш любимый формат архива. Например, вы
может создать файл shar в Unix с чем-то вроде:

пакет: (shar --archive-name = "$ BDBASE" $ BDINPUTS> $ BDBASE.sh)

или CAB-файл в Microsoft Windows с чем-то вроде:

пакет: cabarc -r -p N% BDBASE% .cab% BDINPUTS%

ПРИМЕРЫ

Предположим, что мой файл.dep был произведен из мой файл.tex следуя инструкциям в
Раздел описания. Следующая команда производит .zip файл с MikTeX TeX
Дистрибутив, работающий в Microsoft Windows:

bundledoc --config = miktex.cfg myfile.dep

(На практике, вероятно, необходимо указать в "--config" полный путь к
в комплектеoc's miktex.cfg конфигурационный файл.)

Следующее строит .tar.gz архив с дистрибутивом TeX Live, работающим на Unix-
как операционная система. в комплектеoc будет производить подробный вывод, описывающий его операции.
Все файлы не в том же дереве каталогов, что и мой файл.tex и все файлы, содержащие ".fd" или
".sty" в их именах опускается. Однако все .биб файлы в текущем каталоге будут
быть включены в архив, даже если ни один из них не упоминается мой файл.dep.
Наконец, нет МАНИФЕСТ файл будет создан.

bundledoc --config = texlive-unix.cfg --verbose --localonly \
--exclude = .fd --exclude = .cfg --include = "*. bib" --manifest = "" \
мой файл.dep

Используйте bundledoc онлайн с помощью сервисов onworks.net