гума - Онлайн в Хмарі

ПРОГРАМА:

ІМ'Я

rubber - система побудови документів LaTeX

СИНТАКСИС

гумовий [опції] джерел ...
гумова труба [опції]

ОПИС

Rubber — це обгортка для LaTeX і супутніх програм. Його мета полягає в тому, щоб надати LaTeX
джерело для обробки, компілювати його достатньо разів, щоб розв’язати всі посилання, можливо, запущені
супутникові програми, такі як BibTeX, makeindex, Metapost тощо для отримання відповідних даних
файли.

Команда гумовий будує зазначені документи повністю. Вихідні файли можуть бути
джерела LaTeX (у цьому випадку суфікс .tex може бути пропущений), або документи в
формат Rubber знає, як перекладати на LaTeX. Якщо одна компіляція не вдається, вся
процес зупиняється, включаючи компіляцію наступних документів у командному рядку, і
гумовий повертає ненульовий код виходу.

Команда гумова труба робить те саме для одного документа, але зчитує джерело LaTeX
стандартного введення та виводить скомпільований документ на стандартний вихід.

Деяку інформацію неможливо отримати з джерел LaTeX. Це той випадок, для
екземпляром із пошуковими шляхами (які можна вказати у змінних середовища, наприклад
TEXINPUTS), або стиль, який буде використовуватися з Makeindex. Щоб вирішити цю проблему, можна додати
інформацію про Rubber у коментарях джерел LaTeX, див. розділ ДИРЕКТИВИ.

ВАРІАНТИ

Параметри використовуються або для вибору дії, яку потрібно виконати, або для налаштування
будівельний процес. Вони переважно однакові в гумовий та гумова труба. Параметри аналізуються
використовуючи конвенції GNU Getopt.

-б, --bzip2
Стисніть кінцевий документ (у bzip2 формат). Це еквівалентно сказати -o
bzip2 після всіх інших варіантів.

--чистий
Видаліть усі файли, створені компіляцією, замість того, щоб створювати документ.
Ця опція присутня в гумовий тільки До компіляції це відноситься так само
можна виконати за допомогою інших параметрів командного рядка, тобто сказати "rubber --clean
foo" не видалить foo.ps, а "rubber --ps --clean foo" видалить.

-c, -- команда
Виконати вказану команду (або директиву) перед тим розбір вхідних файлів. Побачити
розділ ДИРЕКТИВИ for details.

-е, --епілог
Виконати вказану команду (або директиву) після розбір вхідних файлів. Побачити
розділ ДИРЕКТИВИ for details.

-f, --сила
Примусово скласти принаймні одну компіляцію джерела. Це може бути корисно, наприклад, якщо
була змінена деяка незвичайна залежність (наприклад, пакет у системному каталозі). Це
варіант не має значення в гумова труба.

-z, --gzip
Стисніть кінцевий документ (у gzip формат). Це еквівалентно сказати -o gz
після всіх інших варіантів.

-h, --допомога
Відобразіть список усіх доступних опцій і добре вийдіть.

--на місці
Перед компіляцією перейдіть до каталогу вихідних файлів, щоб здійснити компіляцію
результати знаходяться там же, де їх джерела.

--в
Перед компіляцією перейдіть до вказаного каталогу, щоб створити всі файли
там, а не в поточному каталозі.

--назва роботи
Вкажіть назву завдання, відмінну від імені базового файлу. Це змінює назву
вихідні файли і застосовується лише до першої цілі.

-к, -- тримати
Цей параметр використовується в гумова труба тільки За допомогою цього параметра тимчасові файли
не буде видалено після компіляції документа та додавання результатів
стандартний вихід. Тимчасовий документ називається rubtmpX.tex, де X — число
таким, що спочатку не існує файлу з такою назвою.

-л, -- пейзаж
Вкажіть, що кінцевий документ має використовувати альбомну орієнтацію. Це актуально
тільки при використанні dvips or dvipdfm.

-n, --maxerr
Встановіть максимальну кількість відображаються помилок. За замовчуванням допускається до 10 помилок
повідомив, мовляв -n -1 відображає всі помилки.

-м, -- модуль [:]
Використовуйте вказаний модуль на додаток до пакетів документа. Аргументи можуть бути
передається до пакета, додаючи їх після двокрапки, вони відповідають пакету
параметри в LaTeX. Модуль завантажено перед тим розбір джерел документа.

--тільки
Складіть документ частково, включаючи лише вказані джерела. Це працює
вставивши виклик \includeonly у командному рядку. Аргументом є кома-
окремий список імен файлів.

-о, --пост [:]
Використовуйте вказаний модуль як постпроцесор. Це схоже на -m опції
крім того, що модуль завантажений після розбір документа.

-d, --pdf
Створити вихідний PDF. Коли ця опція настане після --ps (наприклад, у формі
-пд) це синонім до -o ps2pdf, інакше він діє як -m pdftex, щоб використовувати
pdfLaTeX замість LaTeX.

-p, --ps
Обробіть DVI, отриманий цим процесом dvips(1) для створення PostScript
документ. Цей варіант є синонімом для -o dvips, це не може бути після --pdf.

-q, --спокійно
Зменшіть рівень багатослівності. Це зворотне -v.

-р, --прочитати
Прочитати додаткові директиви із зазначеного файлу (див. також директиву «читання»).

-S, --src-specials
Увімкніть генерацію вихідних специфікацій, якщо компілятор це підтримує. Це
еквівалентно встановленню змінної src-спец до так.

-так, --короткі
Відображати повідомлення про помилки LaTeX у компактному вигляді (одна помилка на рядок).

-я, --texpath
Додайте вказаний каталог до шляху пошуку TeX.

--synctex
Увімкнути підтримку SyncTeX під час запуску LaTeX.

-- небезпечно
Дозволити документу викликати довільні зовнішні програми. Це потенційно
небезпечно, використовуйте цей параметр лише для документів, які надходять із надійного джерела.

-v, -багатослівний
Збільште рівень багатослівності. Існують рівні від 0 до 4, рівень за замовчуванням – 1
та цінності гумовий і 0 для гумова труба. Обережно, кажучи -ввв змушує Гуму багато говорити.

-- версія
Роздрукуйте номер версії та вийдіть.

-W, -- попередити
Повідомити інформацію даного типу, якщо під час компіляції не було помилок. The
доступні види: коробки (переповнені та недоповні коробки), рек (невизначений або
помножити визначені посилання), Різне (інші попередження) і всі щоб повідомити про всі попередження.

МОДУЛІ

На дію гуми впливають модулі. Модулі піклуються про особливі особливості
пакети та зовнішні програми.

Пакети
Для кожного пакета, який використовує документ, Rubber шукає модуль з такою ж назвою
виконувати завдання, які вимагає цей пакет, крім компіляції LaTeX.
Модулі можна додати до тих, які надаються за замовчуванням, щоб включити нові функції (це
точка модульної системи). Стандартні модулі наступні:

асимптота
Обробляти файли .asy, згенеровані пакетом LaTeX, потім запускає a
перекомпіляції.

відеопроектор Цей модуль обробляє додаткові файли Beamer так само, як і інші таблиці змісту.

bibtex, біблатекс
За потреби дбає про обробку бібліографії документа за допомогою BibTeX. Це
модуль автоматично завантажується, якщо документ містить макрос \bibliography
(див. також в ДИРЕКТИВИ для варіантів).

об'єднувати
Пакет комбінування використовується для збору кількох документів LaTeX в один,
і цей модуль обробляє залежності в цьому випадку.

epsfig Цей модуль обробляє включення графіки для документів, які використовують старий стиль
Макрос \psfig. Насправді це інтерфейс для графічного модуля, дивіться цей
for details.

глосарії
Запустіть makeglossaries і перекомпілюйте, коли файл .glo змінюється.

графіка, graphicx
Ці модулі ідентифікують графічні елементи, що входять до документа, і розглядають їх як
залежності для компіляції. Вони також використовують стандартні правила для створення цих файлів
із зовнішніми програмами. Подробиці дивіться в інформаційній документації.

гіперреф
У деяких випадках обробляйте додаткові файли, які створює цей пакет.

індекс, makeidx, номенкл
Опрацювати індекси та номенклатури документа за допомогою makeindex(1) за потреби (див
розділ ДИРЕКТИВИ для варіантів).

ltxtable
Додайте залежності для файлів, вставлених через пакет LaTeX ltxtable.

мініток, мініток-гіпер
Після очищення видаліть додаткові файли, створені для створення часткових таблиць
зміст.

більше дієслово, дослівно
Додає файли, включені в \verbatiminput та подібні макроси, до списку
залежності.

мультибіб
Обробляє додаткові бібліографії, які створює цей пакет, і видаляє зайві
файли про очищення.

xr Додайте додаткові файли .aux, які використовуються для зовнішніх посилань до списку залежностей,
тому перекомпіляція відбувається автоматично, коли документ, на який посилається, змінюється.

Попередня обробка
Наступні модулі надаються для використання програм, які генерують джерело LaTeX з a
інший формат файлу:

cweb Метою цього модуля є запуск плести(1) за потреби перед процесом компіляції до
створити джерело LaTeX. Цей модуль автоматично завантажується, якщо файл
вказано в командному рядку has .w як його суфікс.

lhs2TeX
Цей модуль використовує lhs2TeX препроцесор для створення джерела LaTeX з a
Грамотна програма Haskell. Він автоматично запускається, якщо ім’я вхідного файлу
закінчується на .lhs.

Подальша обробка
Наступні модулі надаються для підтримки різних видів постобробки. Примітка
що порядок має значення при використанні цих модулів: якщо ви хочете використовувати ланцюжок обробки
як
foo.tex -> foo.dvi -> foo.ps -> foo.pdf -> foo.pdf.gz
потрібно завантажити модулі dvips, ps2pdf та gz в такому порядку, наприклад, використовуючи
командного рядка
гумовий -p -o ps2pdf -z foo.tex

bzip2 Створіть версію остаточного файлу, стиснутого за допомогою bzip2(1).

dvipdfm
Runs dvipdfm(1) наприкінці компіляції, щоб створити PDF-документ.

dvips Runs dvips(1) в кінці компіляції, щоб створити документ PostScript. Це
модуль також завантажується за допомогою параметра командного рядка --ps.

Розширювати Створіть розширене джерело LaTeX, замінивши \input макроси включеними файлами,
макроси бібліографії за бібліографією, створеною bibtex(1) та місцеві класи
та пакети за їх джерелом. Якщо основний файл foo.tex потім розгорнутий файл
буде названо foo-final.tex. Подробиці дивіться в інформаційній документації.

gz Створіть версію остаточного файлу, стиснутого за допомогою gzip(1).

ps2pdf Якщо припустити, що компіляція створює документ PostScript (наприклад, використовуючи
Модулі dvips), конвертуйте цей документ у PDF за допомогою ps2pdf(1).

компілятор вибір
Для зміни компілятора LaTeX використовуються такі модулі:

алеф Використовуйте компілятор Aleph замість TeX, тобто компілює документ за допомогою кульгавий(1)
замість латекс.

омега Використовуйте компілятор Omega замість TeX, тобто компілює документ за допомогою лямбда(1)
замість латекс. Якщо модуль dvips використовується також, він буде використовувати відвіпс(1) на
перекласти файл DVI. Зауважте, що цей модуль запускається автоматично, коли
документ використовує пакет омега.

pdftex Інструктує Гуму використовувати pdflatex(1) замість латекс(1) скласти документ. За
за замовчуванням, це створює файл PDF замість DVI, але під час завантаження модуля
з опцією Двійки (наприклад, сказавши -m pdftex:dvi) документ складено
в DVI за допомогою pdflatex. Цей модуль також завантажується опцією командного рядка
--pdf.

vtex Доручає Rubber використовувати компілятор VTeX. За замовчуванням це використовується влатекс в якості
компілятор для виведення PDF. З опцією ps (наприклад, коли кажуть «гума -м
vtex:ps foo.tex") компілятор vlatexp і результатом є файл PostScript.

кселатекс
Інструктує Гуму використовувати кселатекс(1) замість латекс.

ДИРЕКТИВИ

Автоматична поведінка Rubber заснована на пошуку макросів у джерелах LaTeX.
Коли цього недостатньо, директиви можна додати в коментарі джерел. А
Директива схожа на рядок
% гуми: cmd args
Рядок має починатися з «%», потім з будь-якої послідовності знаків «%» і пробілів, потім з тексту
"rubber:", за яким слідують пробіли та ім'я команди, за яким, можливо, слідують пробіли та
аргументів.

Загальне директиви
псевдонім
Уявіть, що макрос LaTeX ім'я1 еквівалентна ім'я2. Це може бути корисно, коли
визначення обгорток навколо підтримуваних макросів.

очистити
Вказує на те, що вказаний файл слід видалити під час очищення за допомогою --чистий.

залежати
Розглянемо вказаний файл як залежність, так що час його зміни буде
перевірено

зробити []
Оголосити, що вказаний файл має бути згенерований. Параметри можуть вказати шлях
його слід виготовити, доступні варіанти є від щоб вказати джерело
та з щоб вказати правило перетворення. Наприклад, сказавши «зробити foo.pdf
з foo.eps» вказує на це foo.pdf повинні бути виготовлені з foo.eps, з будь-яким
правило перетворення, яке може це зробити. Перегляньте інформаційну документацію для отримання детальної інформації у файлі
конверсія.

Модулі []
Завантажує вказаний модуль, можливо з параметрами. Це еквівалентно
параметр командного рядка -- модуль.

ми змінюємось
Виконайте вказану команду оболонки після компіляції, якщо вміст файлу
вказаний файл змінився. Ім'я файлу закінчується на першому пробілі.

папір
Вкажіть параметри, пов’язані з розміром паперу. В даний час вони використовуються для надання -t опції
до dvips та -p варіанти для dvipdfm.

шлях
Додає вказаний каталог до шляху пошуку TeX (і Rubber). Ім'я
каталог - це все, що йде після пробілів після "шляху".

виробляти
Заявляє, що запуск LaTeX створить або оновить вказані файли.

зчитування
Прочитайте вказаний файл директив. Файл повинен містити одну директиву per
лінія. Порожні рядки та рядки, які починаються з "%", ігноруються.

Правила
Прочитайте додаткові правила перетворення із зазначеного файлу. Формат цього файлу
те саме, що й у правила.ini, подробиці дивіться в інформаційній документації.

комплект
Встановити значення змінної як рядок. Щоб дізнатися більше про існуючі змінні та
їх значення див. в інформаційній документації.

сет-лист
Встановіть значення змінної як список рядків (розділених пробілами). Для деталей на
існуючі змінні та їх значення див. в інформаційній документації.

shell_escape
Позначте документ як такий, що потребує зовнішніх програм (shell-escape або write18). гумовий
насправді не вмикає це, якщо не викликано з опцією --unsafe.

синктекс
Увімкнути підтримку SyncTeX під час запуску LaTeX.

дивитися
Слідкуйте за змінами у вказаному файлі. Якщо вміст цього файлу змінився
після компіляції запускається інша компіляція. Це корисно в
наприклад, випадок змісту.

Специфічний модуль директиви
Якщо команда має форму foo.bar, це вважається командою бар для модуля Foo. Якщо
цей модуль не реєструється, коли директива знайдена, тоді команда виконується без звуку
ігнорується. Для стандартних модулів директиви такі:

biblatex.path
Додає вказаний каталог до шляху пошуку для баз даних BibTeX (файли .bib).

bibtex.crossrefs
Встановіть мінімальну кількість перехресне посилання необхідний для автоматичного включення
посилання на запис у списку цитат. Це встановлює параметр -мін-перехресні посилання коли
покликання bibtex(1).

bibtex.path
Додає вказаний каталог до шляху пошуку для баз даних BibTeX (файли .bib).

bibtex.stylepath
Додає вказаний каталог до шляху пошуку стилів BibTeX (файли .bst).

bibtex.tool
Використовуйте інший інструмент бібліографії замість BibTeX.

dvipdfm.options
Передайте вказані перемикачі командного рядка до dvipdfm.

dvips.options
Передайте вказані перемикачі командного рядка до dvips.

індекс.інструмент (індекс)
Вказує, який інструмент буде використовуватися для обробки індексу. Наразі підтримується
інструменти є makeindex(1) (вибір за замовчуванням) і xindy(1). Аргумент індекс is
необов’язково, його можна використовувати для визначення списку індексів, до яких команда застосовується.
Якщо він присутній, він повинен бути взятий у дужки; список розділений комами.
Якщо аргумент відсутній, команда застосовується до всіх індексів.

покажчик.мова (індекс)
Вибирає мову, яка використовується для сортування індексу. Це стосується лише при використанні
xindy(1) як інструмент індексації. Необов’язковий аргумент має ту ж семантику, що й
вище.

індекс.модулі (індекс) ...
Вкажіть, які модулі використовувати під час обробки індексу xindy(1). Необов’язковий
аргумент має ту ж семантику, що й вище.

індекс.порядок (індекс)
Змінює параметри сортування для індексів. Аргументами є слова (відокремлені
пробілами) серед standard, german та лист. Це стосується лише при використанні
makeindex(1). Необов’язковий аргумент має ту ж семантику, що й вище.

index.path (індекс)
Додає вказаний каталог до шляху пошуку для стилів індексу (файлів .ist). The
необов'язковий аргумент має ту ж семантику, що й вище.

індекс.стиль (індекс)
Визначає стиль індексу, який буде використано. Необов’язковий аргумент має ту ж семантику
як зазначено вище.

makeidx.language, .модулі, .замовлення, .шлях, .стиль, .інструмент
Ці директиви такі ж, як і для індекс модуля, за винятком того, що вони цього не роблять
прийняти необов’язковий аргумент.

multibib.crossrefs, .шлях, .stylepath, .інструмент
Ці директиви такі ж, як і для bibtex модуля, але вони стосуються
бібліографії, якими керує в мультибіб пакет. Спочатку вони беруть необов’язковий
аргумент, з тією ж умовою, що і для директив індекс модуль, який
може використовуватися для визначення списку бібліографій, до яких застосовується команда.

Використовуйте гуму онлайн за допомогою служб onworks.net