Перейти к содержимому
Topos Uranos
Русский

Указатели и глоссарии

Краткое содержание

Этот урок учит составлять предметный указатель книги или диссертации, а также её глоссарии. Он объясняет, зачем нужен предметный указатель и чем он отличается от оглавления; представляет пакет imakeidx с командами \makeindex, \index и \printindex и цикл компиляции, в котором makeindex сортирует рубрики между двумя проходами движка; учит подрубрикам, ключам сортировки, которые исправляют место слов с заглавной буквы и с буквой ё, отсылкам, которые по-русски обозначаются «см.» и «см. также», диапазонам страниц и выделенным номерам; показывает, как вести несколько указателей сразу, именной и предметный; представляет пакет glossaries с его определёнными терминами и аббревиатурами, которые раскрываются при первом появлении, и вариант glossaries-extra; и завершается самыми частыми ошибками: указатель, который не обновляется, русские слова не на своих местах и рубрики, удвоенные из-за иного написания.

Цели обучения

  1. Отличать предметный указатель от оглавления и от глоссария по тому, что упорядочивает каждый из них и что он даёт читателю.
  2. Размечать рубрики указателя с подрубриками, ключами сортировки, отсылками, диапазонами и выделенными номерами и предсказывать, что печатает каждая разметка.
  3. Объяснять цикл компиляции с makeindex и то, какой файл порождает каждый шаг, и распознавать, почему указатель не обновляется.
  4. Вести несколько указателей в одном документе и направлять каждую рубрику в свой.
  5. Определять термины и аббревиатуры с glossaries, предвидеть, что печатает каждое упоминание, и составлять глоссарий и список аббревиатур.
  6. Диагностировать удвоенные рубрики, слова не на своих местах и ошибки глоссария по напечатанному указателю и по журналу.

Зачем нужен предметный указатель

В уроке о разделах, оглавлении и приложениях мы видели оглавление, которое \tableofcontents набирает в начале документа и которое babel озаглавливает «Содержание»: оно воспроизводит деление текста в порядке следования и отвечает на вопрос, как текст устроен. Предметный указатель, который babel озаглавливает «Предметный указатель», отвечает на другой вопрос: где говорится о чём-то. Он располагает в алфавитном порядке понятия, имена и произведения, о которых идёт речь в тексте, и даёт для каждого страницы, где они встречаются. Читатель, который ищет, что книга по истории науки говорит о Кеплере или что учебник биохимии говорит об энтальпии, не найдёт этого в оглавлении, потому что ни один заголовок раздела этого не называет; он найдёт это в указателе.

Отсюда следует, что предметный указатель не выводится из структуры документа, как оглавление, а вытекает из решения автора: какие термины заслуживают места, в какой форме и с какими подразделениями. Указатель, который собирает каждое появление каждого слова, бесполезен, потому что возвращает читателю все страницы; хороший указатель собирает места, где термин определяется, обсуждается или применяется, и отсылает от форм, которые читатель мог бы искать, к выбранной форме. Поэтому он свойствен книгам, учебникам и объёмным диссертациям, а не статье в десять страниц.

Глоссарий есть третий инструмент. Он говорит не о том, где речь идёт о термине, а о том, что термин означает: это список определений, часто вместе со списком аббревиатур, которыми пользуется текст, с их полной формой. Оба составляются одним и тем же механизмом, который урок сначала изучает на указателе.