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

ПРОГРАММА:

ИМЯ

tth, latex2gif, ps2gif, ps2png - переводчик TeX и LaTeX в HTML и его вспомогательные средства
программа

СИНТАКСИС

TTH [кредита] [<файл.tex] [> file.html] [2> ошибка]

TTH [кредита] файл.tex [2> ошибка]

латекс2gif файл (без расширения)

ps2gif файл.ps файл.gif [значок.gif]

ps2png файл.ps файл.gif [значок.gif]

ОПИСАНИЕ

TTH переводит исходный текст TeX, который использует простой пакет макросов или LaTeX, включая большинство
математика, в почти эквивалент в HTML. Официальный стандарт, переведенный на TTH
документы следуют строго HTML4.0 Переходный.

Полная документация содержится в "tth_manual.html", который распространяется вместе с программой.
Эта страница руководства представляет собой неполное резюме и обновляется нерегулярно. [Последнее обновление 1
Май 2002 г., Ханс Фредрик Нордхауг.]

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

При обработке встроенных графических файлов TTH может использовать вспомогательные программы, ps2gif or
ps2png, которые, в свою очередь, используют интерпретатор ghostscript gs (1) и портативный
Набор команд Bitmap Graphics, см. pbm (1).

TTH работает очень быстро в режиме по умолчанию на любом разумном оборудовании. Преобразование даже
большие файлы TeX должны занимать считанные секунды или две. Это позволяет использовать TTH
в сценарии CGI для вывода HTML непосредственно из источника TeX, если это необходимо; (стандартная ошибка может
тогда нужно перенаправить.)

TTH обрабатывает такие вещи TeX, как:
Практически вся математика, включая символы, дроби, разделители.
{} \ begingroup \ endgroup grouping.
\ it \ bf \ sl и т. д. стилей.
\ beginsection.
\ centerline {}.
\ item {...} \ itemitem {...} {\ obeylines ...}.
Почти все латинские символы с акцентом пишутся как \ "o или \" {e}.
\ повесить \ повесить \ уже для целых абзацев
(\ Hangafter игнорируется).
\ заголовок превращается в заголовок.
% Комментарии. Просто удалил.
\ halign таблицы, проверяет шаблон на наличие \ vrule,
чтобы решить, будет ли таблица иметь стиль границы.
\ setabs \ + таблицы стилей.
\ input: Но, конечно, не из неявного пути texinputs.
\ newcount, \ number, \ advance и установка счетчика.
\ def, \ edef, \ xdef, но без аргументов с разделителями.
Все определения глобальны.
\ matrix, \ pmatrix, но не \ bordermatrix. \случаи.

Поддержка LaTeX включает практически всю математику плюс следующие среды:
em, дословно, по центру, ровно по центру [только один абзац], стих, цитата, цитата,
пункт, перечисление, описание, список [рассматривается как описание], рисунок, таблица,
tabular [*, x], формула, displaymath, eqnarray [только один номер уравнения], math, array,
thebibliography, [raw] html, index [as description].
и команды LaTeX:
[re] newcommand, newenvironment [необязательный аргумент не разрешен], глава, раздел,
подраздел, вложенный раздел, заголовок, метка, ссылка, ссылка на страницу [без номера], emph, textit,
texttt, textbf, centering, raggedleft, includegraphics, [e] psfig, название, автор, дата
[не автоматически], lefteqn, frac, tableofcontents, input, include [as input], textcolor,
цвет [8 стандартных цветов], сноска [без учета необязательного аргумента], cite, bibitem,
библиография, крошечный ... нормальный размер ... огромный, новый счетчик [без поддержки "внутри"],
setcounter, addtocounter, value [внутри set или addto counter], арабский, the,
stepcounter, новая строка, глагол [*], bfseries, itshape, ttfamily ,textc, suremath,
listoftables, listoffigures, newtheorem [дополнительные аргументы не разрешены], сегодня,
printindex, boldmath, unboldmath, newfont, спасибо, makeindex, index.

Гипертекстовые перекрестные ссылки в документе автоматически генерируются (например) ref,
и оглавление.

После появления TTH встречает конструкции TeX, которые он не может обработать, потому что нет HTML
эквивалент, или потому что он недостаточно умен, он пытается устранить беспорядок, который они могли бы
в противном случае вызвать в HTML-коде, как правило, предупреждение о действии, если оно не
уверен, что делает. Непереводимые математические токены TeX вставляются дословно.

Независимость of [Латекс установка и -L переключатель

Основное различие между TTH и латекс2html является то, что TTH не называет латекс or текс
программ по умолчанию и не зависит от них или каких-либо
другое (например, Perl), программы, устанавливаемые в системе перевода. Его портативность
поэтому практически универсален.

Прямые ссылки в LaTeX обрабатываются несколькими проходами, которые записывают вспомогательные файлы. TTH
делает только один проход через источник. Если хочешь TTH использовать конструкции LaTeX (например,
tableofcontents, библиографические команды и т. д.), которые зависят от вспомогательных файлов, то вы делаете
необходимо запустить LaTeX в коде, чтобы эти файлы были сгенерированы. В качестве альтернативы TTH
переключатель -a причины TTH автоматически попытаться запустить латекс на файле, если нет вспомогательного
файл .aux существует.

При запуске с указанием имени файла в командной строке в качестве аргумента без переключения, x TTH
создает имя ожидаемых вспомогательных файлов LaTeX обычным способом и ищет
их в том же каталоге, что и файл. Если вы используете TTH как фильтр, вы должны сказать
TTH , используя переключатель -Lfilename, базовое имя файла этих вспомогательных файлов (которое
имя исходного файла без расширения). Если TTH не могу найти соответствующий
вспомогательный файл, потому что вы не запускали LaTeX и не генерировали файлы или не включали
switch, то он пропустит конструкцию и предупредит вас. Прямые ссылки через ref не будут
работают, если файл .aux недоступен, но обратные ссылки будут. Переключатель -L без
имя файла может использоваться, чтобы сказать TTH что переводимый документ должен быть интерпретирован
как файл LaTeX, хотя в нем отсутствуют обычные команды заголовка LaTeX. Это может быть полезно
для перевода отдельных уравнений, которые (неразумно) используют команду \ frac.

BibTeX библиография

TTH поддерживает библиографии, созданные вручную с помощью \ begin {thebibliography} и т. д.
Такие библиографии не требуют ничего, кроме файла .aux. TTH также поддерживает
библиографии, созданные с помощью BibTeX из базы данных библиографии. Файл filename.bbl
ввод в нужном месте документа. Однако это filename.bbl не создается
автоматически латекс. Помимо бега латекс в исходном файле, чтобы создать
вспомогательный файл, вы также должны выполнить bibtex filename в том же каталоге, чтобы создать
filename.bbl файл, а затем запустите латекс снова, чтобы получить правильные ссылки. (Это из
конечно, не более чем стандартная процедура использования бибтекс латекс но это должно быть
сделано, если хочешь TTH чтобы правильно составить библиографию). Если вы не создадите
.bbl файл, или если вы создаете его в другом месте, TTH не ищет, то естественно
TTH не найду. Поскольку процесс BibTeX относительно сложен, TTH предлагает
альтернатива. Использование переключателя -a с TTH заставит его попытаться сгенерировать
требуется файл .bbl автоматически с использованием бибтекс и латекс.

Есть много разных стилей для библиографий и большое количество разных LaTeX.
пакеты расширений выросли для их реализации, которые TTH не поддерживает. Более
в последнее время существенная рационализация ситуации была достигнута пакетом
натбиб. TTH имеет элементарную поддержку, встроенную для его команд \ citep и citet в
форма по умолчанию с датой автора без второго необязательного аргумента. Файл стиля для natbib - это
распространяется с TTHgold, что позволяет использовать большую часть его более полезных
стили и команды и легко переключайтесь с цитирования по дате автора на числовое цитирование.

Индексирование

TTH может создать чрезвычайно полезный гиперссылочный индекс, используя записи автоматического индексирования LaTeX.
Но индексирование документа HTML отличается от индексации печатного документа, потому что
печатный индекс относится к номерам страниц, которые не имеют значения в HTML, потому что нет
разрывы страниц. TTH индексирует документы LaTeX по номерам разделов, а не по страницам; предполагая,
конечно, что они были подготовлены с индексными записями стандартным способом LaTeX.

TTH построит индекс на основе стандартных команд LaTeX "\ makeindex" и
"\ index {...}", и автоматически обработать его и прочитать, когда "\ printindex"
столкнулся. Командная строка для вызова программы makeindex (не входит в эту
распределение) можно изменить с помощью -x выключатель. Для файла без "\ makeindex"
команда, tth не будет записывать индексные файлы, просто считывает существующий файл "file.ind", если он
существует.

Графика включение: epsfbox / includegraphics

Стандартный способ включения графики в обычном TeX - использование макросов epsf. Работа
сделано \ epsfbox {file.ps}, который TTH может разбирать. По умолчанию TTH создает простую ссылку на
такой файл postscript или вообще файл любого формата.

При желании TTH может использовать более подходящий графический формат, используя ps2gif or ps2png в
преобразовать файл postscript в файл png или gif, "file.png" loading = "lazy" или file.gif "Когда переключатель
-e1 или -e2 указано, если файл `` file.png '', `` file.gif '' или `` file.jpg '' уже существует в
тот же каталог, что подразумевается ссылкой на `` file.ps '', тогда преобразование не выполняется
и вместо этого используется найденный файл. Затем этот графический файл автоматически
связаны (-e1) или встроены (-e2) в документе. Если такого файла не найдено, TTH пытается найти
файл postscript с расширением, который начинается либо с .ps, либо с .eps и сначала преобразует его
используя ps2png, а в случае неудачи - ps2gif. По многочисленным просьбам третий вариант графики
-e3 для генерации иконок теперь доступен.

Команда LaTeX \ includegraphics {...} и более старая команда \ [e] psfig {file = ...} обрабатываются как
то же, что и \ epsfbox. Их необязательные аргументы игнорируются.

Картина Среды

Окружение изображений не может быть переведено в HTML. Картинки с использованием встроенного LaTeX
команды должны быть преобразованы в графический файл, такой как gif или png, а затем включены
используя \ includegraphics. Ключ -a вызывает TTH попытаться выполнить автоматическое преобразование изображений
через латекс2gif.

ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

-a попытаться автоматически преобразовать среду изображения. По умолчанию опущено.

-c заголовок префикса "Content-type: text / HTML" (для прямого веб-показа).

-d отключить определения с аргументами с разделителями. По умолчанию включено.

-e? обработка epsfbox: -e1 преобразовать рисунок в png / gif с помощью предоставленного пользователем файла ps2png / ps2gif.
-e2 преобразовать и включить встроенный. -e3 как e2, но с иконкой. -e0 (по умолчанию) нет
преобразование, только исх.

-f? устанавливает глубину группировки, до которой строятся фракции f5 (По умолчанию)
позволяет застроить пять уровней, f0 никто, f9 много.

-g не угадывайте HTML-эквивалент для определений шрифтов, просто удалите.

-h распечатайте справку. -? использование печати

-i используйте курсивный шрифт для уравнений (например, TeX). По умолчанию римский.

-Дж? использовать длину страницы индекса?. По умолчанию 20 строк. -j одиночный столбец.

-L-файл говорит TTH базовый файл (без расширения) для вспомогательного ввода LaTeX.

-н? Управление форматом заголовка HTML. 0 сырой. 1 раскрыть макросы. 2 развернуть ур.

-ppath укажите дополнительные каталоги (путь) для поиска входных файлов.

-r выводить необработанный HTML (без преамбулы или постлюда) для включения в другой HTML.

-t разрешить создание элементов в уравнениях текстового стиля. Только встроенные позиции по умолчанию.

-u кодировка символов юникода. (По умолчанию iso-8859-1).

-v давать подробные комментарии.

-V еще более подробный (для отладки).

-ш? Стиль написания HTML. По умолчанию без тегов головы / тела. -w -w0 без заголовка. -w1 одиночный заголовок
только теги голова / тело. -w2 XHTML.

-xmakindxcmd
укажите нестандартную командную строку makeindex.

-у? стиль уравнения: бит 1 сжимается по вертикали; бит 2 - встроенное превышение скорости.

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