texfot - онлайн у хмарі

ПРОГРАМА:

ІМ'Я

texfot - запустіть TeX, фільтруючи онлайн-розшифровку цікавих повідомлень

СИНТАКСИС

Texfot [варіант]... texcmd [texarg...]

ОПИС

"texfot" викликає texcmd з даним texarg аргументи, фільтруючи онлайн-вивід для
``цікаві'' повідомлення. Його вихідне значення дорівнює texcmd. Приклади:

# Зразок основного виклику:
texfot файл pdflatex.tex

# Зазвичай весь вихід копіюється в /tmp/fot перед фільтрацією;
#, який можна пропустити:
texfot pdflatex --tee=/dev/нульовий файл.tex

# Приклад більш складного виклику двигуна:
texfot lualatex --recorder '\nonstopmode\вхідний файл'

Окрім власних опцій, описаних нижче, "texfot" просто запускає дану команду за допомогою
задані аргументи (такий самий підхід до синтаксису командного рядка, як "env", "nice", "time", "timeout",
тощо). Таким чином, «texfot» працює з будь-яким движком і будь-якими параметрами командного рядка.

"texfot" не переглядає файл журналу або будь-який інший можливий вихідний файл(и); це тільки виглядає
на стандартному виводі та стандартній помилці з команди. stdout обробляється першим,
потім stderr. Рядки з stderr мають ідентифікаційний префікс. "texfot" пише все прийнято
рядків до його стандартного виведення.

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

ПОТІК OF РОБОТА

Ось порядок, у якому перевіряються рядки виводу:

1. Якщо ``наступний рядок'' потрібно надрукувати (див. нижче), роздрукуйте його.

2. Інакше, якщо рядок відповідає вбудованому списку регулярних виразів, які слід ігнорувати, або будь-який користувач
наданий список регулярних виразів, які потрібно ігнорувати (вказано з "--ignore", див. нижче), у такому порядку,
ігноруйте це.

3. Інакше, якщо рядок відповідає списку регулярних виразів, для яких наступний рядок (два рядки
в цілому), показати цей рядок і встановити прапор ``наступного рядка'' для наступного
час навколо циклу. Прикладом є звичайне "!" і помилка "ім'я файлу: lineno:".
повідомлення, за якими зазвичай слідує рядок із конкретними деталями про помилку.

4. В іншому випадку, якщо рядок відповідає списку регулярних виразів для відображення, покажіть його.

5. В іншому випадку за замовчуванням: якщо рядок прийшов із стандартного виведення, ігноруйте його; якщо лінія прийшла з
stderr, роздрукуйте його (у стандартний вихід). (Це розрізнення відбувається тому, що движки TeX пишуть
відносно мало повідомлень до stderr, і цілком ймовірно, що таке має бути
розглянуто.

Було б легко додати більше параметрів, щоб дозволити користувачам додавати до різних регулярних виразів
списки, якщо це здається корисним. Або напишіть мені (див. кінець).

Як тільки певна перевірка відповідає, програма переходить до обробки наступного рядка.

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

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

ВАРІАНТИ

Нижче наведено параметри самого "texfot" (а не двигун TeX, який викликається;
для цього зверніться до документації TeX або до виводу «--help» двигуна).

Перший неопція завершує розбір параметрів "texfot", а решта
командний рядок викликається як команда TeX без подальшого аналізу. Наприклад, «texfot
--debug tex --debug" виведе інформацію про налагодження як з "texfot", так і з "tex".

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

"--відлагоджувати"
"--no-debug"
Вивести (чи ні), що робиться за стандартною помилкою. Вимкнено за замовчуванням.

"--ігнорувати" RegExp
Ігнорувати рядки у відповідності вихідних даних TeX (Perl) RegExp. Можна повторити. Додає до
за замовчуванням набір ігнорувати регулярні вирази замість заміни. Ці регулярні вирази не є
автоматично прив’язується (або іншим чином змінюється), просто використовується як є.

"--інтерактивний"
"--no-interactive"
За замовчуванням стандартний вхід до процесу TeX закритий, тому інтерактивний режим TeX
(очікування введення у разі помилки, підказки «*» тощо) ніколи не вводиться. Дарування
"--interactive" дозволяє здійснювати взаємодію.

"--спокійно"
"--ні-тихо"
За замовчуванням команда TeX, яка викликається, повідомляється на стандартному виводі. "--спокійно"
опускає цю звітність.

"--stderr"
"--no-stderr"
За замовчуванням «texfot» повідомляє про все, що написано в stderr командою TeX
(на стандартному виведенні). "--no-stderr" пропускає цей звіт. (Деякі програми, "dvisvgm" є одним,
може бути досить багатослівним на stderr.)

"--трійник" файл
За замовчуванням вихідні дані, які фільтруються, перед фільтруванням відображаються на "$TMPDIR/fot"
("/tmp/fot", якщо "TMPDIR" не встановлено), щоб було легко перевірити повний вихід, коли
фільтрація виглядає підозрілою. Цей параметр дозволяє вказати інший файл. Використовуйте
"--tee /dev/null", якщо вам взагалі не потрібен вихідний вихід.

"--версія"
Вивести інформацію про версію та успішно вийти.

"--допомога"
Відобразіть цю довідку та успішно вийдіть.

ОБГОВОРЕННЯ

Я написав це тому, що в моїй роботі як редактор TUGboat (http://tug.org/TUGboat>, журнал
подання завжди вітаються!), я в кінцевому підсумку запускаю та перевипускаю багато робіт, багато разів кожну.
Було надто легко втратити попередження, які мені потрібно було побачити в масі незмінних і
нецікавий вихід із TeX, наприклад, файли стилів, які читаються, і використовувані шрифти. я
хотів бачити всі і тільки ті повідомлення, які потребували певної дії з моєї сторони.

Я знайшов деякі інші програми подібного характеру, пакет LaTeX "тиша", і багато
інших обгорток (La)TeX, але здавалося, що жоден з них не зробив того, що я хотів. Або вони читають
файл журналу (я хотів лише онлайн-виведення), або вони виводять більше чи менше, ніж я хотів,
або вони вимагали викликати TeX по-іншому (я хотів зберегти свій процес збірки саме таким
те саме, що особливо важливо, виклик TeX, який може ускладнитися). Тому я це написав.

Ось кілька ключових слів, якщо ви хочете вивчити інші варіанти: texloganalyser, pydflatex,
logfilter, latexmk, rubber, arara і шукає "log" athttp://ctan.org/search>.

"texfot" написаний на Perl, працює на Unix і не працює в Windows. (Якщо деякі
можливо, хтось захоче використовувати цю програму в Windows, будь ласка, створіть свій власний форк; я не
зацікавлений у підтримці цієї ОС.)

Назва походить від файлів "trip.fot" і "trap.fot", які є частиною подорожі Кнута і
тести на катування пастками, які записують онлайн-вихід програм. Я не знаю що
"fot" означає trip and trap, але я можу зробити вигляд, що це означає "фільтр онлайн
стенограма» у цій справі :).

AUTHORS І АВТОРСЬКЕ

Цей сценарій та його документація були написані Карлом Беррі, і обидва випущені в
публічний домен. Електронна пошта "[захищено електронною поштою]" зі звітами про помилки. За його межами немає домашньої сторінки
пакет на CTAN:http://www.ctan.org/pkg/texfot>.

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