Книга: Искусство программирования для Unix

Пример 18.1. Разметка groff(1)

Это непрерывный текст.
." Комментарии начинаются с обратной косой черты и двойных кавычек.
.ft В
Данный текст будет выделен жирным шрифтом.
.ft R
Данный текст будет выведен снова стандартным шрифтом (Roman).
Данные строки снова, как и "Это непрерывный текст", будут
отформатированы как заполненный абзац.
.bp
Запрос bp приводит к созданию новой страницы и разрыву абзаца.
Эта строка будет частью второго заполненного абзаца.
.sp 3
Запрос .sp выводит заданное аргументом количество пустых строк,
.nf
Запрос nf отключает заполнение абзаца.
До тех пор, пока оно снова не будет включено запросом fi,
пустые места и макет страницы будут сохраняться.
Одно слово данной строки будет выделено fBboldfR жирным шрифтом.
.fi
Снова включено заполнение абзаца.

Средства инструментария Documenter's Workbench очень хорошо решают задачи по форматированию технических документов, для которых они и предназначены, именно поэтому они непрерывно используются в течение более чем 30 лет, тогда как производительность компьютеров возросла в тысячи раз. Они создают форматированный текст приемлемого качества на графических принтерах и способны корректно отображать форматированные man-страницы на экране.

Однако в некоторых областях они плохо применимы. Их стандартный выбор доступных шрифтов ограничен. Они слабо обрабатывают изображения. Сложно обеспечить точное управление позиционированием текста, изображений или диаграмм внутри страницы. Поддержка многоязычных документов отсутствует. Существует множество других проблем. Некоторые из них хронические, но незначительные, другие абсолютно затрудняют специфическое применение. Но наиболее серьезная причина заключается в том, что, ввиду того, что большая часть разметки осуществляется на уровне представления, создавать хорошие Web-страницы из немодифицированных troff-текстов очень трудно.

Тем не менее, на момент написания книги man-страницы остаются единственной наиболее важной формой Unix-документации.

Оглавление книги