Команды описания структуры глав разделяют документ на иерархию глав, разделов, подразделов и подподразделов. Эти команды создают большие заголовки, а также предоставляют сведения для составления содержания печатного руководства (see section Создание содержания).
Команды описания структуры глав не создают структуры Info-нод, поэтому
обычно вы должны помещать команду @node непосредственно перед
каждой командой описания структуры глав (see section Ноды). Единственный
случай, когда вы, вероятно, будете использовать команды описания
структуры глав, не описывая структуру нод, -- это если вы пишите
документ, не содержащий перекрестных ссылок, и который никогда не будет
преобразован в формат Info.
Вряд ли вам когда-нибудь придется писать Texinfo-файл, предназначенный только для чтения в виде Info-файла, но не печатного документа. Если же вам пришлось, все равно имеет смысл использовать команды описания структуры глав для создания заголовка в начале каждой ноды, но вам не обязательно это делать.
Обычно Texinfo-файл организован подобно книге с главами, разделами, подразделами и так далее. Такую структуру можно изобразить в виде дерева (или даже дерева, направленного сверху вниз) с корнем наверху и уровнями, соответствующими главам, разделам, подразделам и подподразделам.
Ниже приведена диаграмма, изображающая Texinfo-файл из трех глав, каждая из которых имеет два раздела.
Вершина
|
-------------------------------------
| | |
Глава 1 Глава 2 Глава 3
| | |
-------- -------- --------
| | | | | |
Раздел Раздел Раздел Раздел Раздел Раздел
1.1 1.2 2.1 2.2 3.1 3.2
В Texinfo-файле с такой структурой начало Главы 2 выглядит таким образом:
@node Глава 2, Глава 3, Глава 1, top @chapter Глава 2
Команды описания структуры глав рассмотрены в последующих разделах;
команды @node и @menu -- в последующих
главах. (See section Ноды, и section Меню.)
Команды описания структуры глав делятся на четыре группы или серии, каждая из которых содержит команды описания структур, соответствующих иерархическому уровню глав, разделов, подразделов и подподразделов.
Эти четыре группы составляют: серия @chapter, серия
@unnumbered, серия @appendix и серия @heading.
Каждая команда создает заголовки, выглядящие по-разному на напечатанной странице и в Info-файле; только некоторые команды создают заголовки, которые будут перечислены в содержании печатной книги или руководства.
@chapter и @appendix создает нумерованные
или перечисленные по буквам вхождения как в теле печатного произведения,
так и в его содержании.
@unnumbered создает ненумерованные вхождения как в
теле печатного произведения, так и в его содержании. Команда
@top, имеющая особое значение, является членом этой серии
(see section @top).
@heading создает ненумерованные заголовки, которые
не появляются в содержании. Команды создания заголовка никогда не
начинают новую страницу.
@majorheading дает результат, похожий на результат
применения команды @chapheading, но делает больший вертикальный
пропуск перед заголовком.
@setchapternewpage, то
@chapter, @unnumbered, и @appendix начинают
новую страницу в печатном руководстве; команда @heading не
начинает.Вот четыре группы команд описания структуры глав:
| Не начинают новую страницу | |||
| Нумерованные | Ненумерованные | Нумерованные или перечисленные по буквам | Ненумерованные |
| В содержании | В содержании | В содержании | Нет в содержании |
@top | @majorheading
| ||
@chapter | @unnumbered | @appendix |
@chapheading
|
@section | @unnumberedsec | @appendixsec |
@heading
|
@subsection | @unnumberedsubsec |
@appendixsubsec | @subheading
|
@subsubsection | @unnumberedsubsubsec |
@appendixsubsubsec | @subsubheading
|
@top
Команда @top -- это специальная команда, которую вы используете
после строки `@node Top' в начале Texinfo-файла. Команда
@top сообщает форматирующей программе @command{makeinfo}, какая
нода является нодой `Top', чтобы @command{makeinfo} могла использовать
эту ноду в качестве корневой, если в вашем руководстве применяются
неявные указатели. Ее результат при наборе такой же, как при применении
@unnumbered (see section @unnumbered и @appendix). Для подробной информации смотрите section Команда @top.
Нода @top и ее меню (если оно есть) обычно окружается в условную
конструкцию @ifnottex, чтобы они появлялись только при выводе в
выводе Info и HTML, но не TeX.
@chapter
Команда @chapter обозначает главу в документе. Пишите эту
команду в начале строки и за ней название главы на той же
строке.
Например, данная глава в этом руководстве озаглавлена
"Структура глав"; строка @chapter выглядит так:
@chapter Структура глав
В TeX, команда @chapter создает в документе главу и задает
название этой главы. Глава автоматически получает номер.
В Info, команда @chapter создает название на отдельной строке и
строку звездочек под ним. Таким образом, в Info предыдущий пример дает
такой вывод:
Структура глав **************
Texinfo также предоставляет команду @centerchap; она аналогична
@unnumbered, но центрирует свой аргумент в печатном выводе.
Обычно такой стиль не рекомендуется к использованию в Texinfo.
@unnumbered и @appendix
Используйте команду @unnumbered для создания в печатном
руководстве главы без какого-либо номера. Используйте команду
@appendix для создания в печатном руководстве приложения,
помеченного буквой, а не числом.
При выводе в Info-файл команды @unnumbered и @appendix
действуют эквивалентно @chapter: заголовок печатается на
отдельной строке, а под ним печатается строка звездочек.
(See section @chapter.)
Чтобы создать приложение или ненумерованную главу, напишите в начале
строки команду @appendix или @unnumbered, а после нее на
той же строке -- название, как бы вы написали при создании главы.
@majorheading, @chapheading
Команды @majorheading и @chapheading помещают в тело
документа заголовки, подобные заголовкам глав.
Однако, эти команды не говорят TeX создавать нумерованные заголовки или вхождения в содержании, а также начинать в печатном руководстве новую страницу.
В TeX, команда @majorheading создает больший вертикальный
пропуск перед заголовком, чем команда @chapheading, но в
остальном эти команды одинаковы.
В Info, команды @majorheading и @chapheading
эквивалентны @chapter: заголовок печатается на отдельной строке,
и под ним печатается строка звездочек. (See section @chapter.)
@section
В печатном руководстве, команда @section обозначает нумерованный
раздел внутри главы. Заголовок раздела появляется в содержании. В Info
команда @section делает для сегмента текста заголовок,
подчеркнутый символами `='.
Данный раздел озаглавлен с помощью команды @section следующим
образом:
@section @code{@@section}
Чтобы создать раздел, напишите команду @section в начале строки,
и после нее название раздела на той же строке.
Таким образом,
@section Это раздел
дает в Info
Это раздел ==========
@unnumberedsec, @appendixsec, @heading
Команды @unnumberedsec, @appendixsec и @heading
--- это эквиваленты команды @section для, соответственно,
ненумерованных разделов, приложений и заголовков. (See section @section.)
@unnumberedsec
@unnumberedsec может применяться внутри ненумерованной
или обычной главы или приложения для создания ненумерованного
раздела.
@appendixsec
@appendixsection
@appendixsection -- более длинный вариант написания
@appendixsec; эти команды являются синонимами.
Команда @appendixsec или @appendixsection по соглашению
используется только внутри приложений.
@heading
@heading везде, где захотите, для
создания заголовка, подобного заголовку раздела, который не появится в
содержании.@subsection
Подразделы соотносятся с разделами так же, как разделы с главами.
(See section @section.) В Info заголовки подразделов
подчеркиваются символами `-'. Например,
@subsection Это подраздел
дает
Это подраздел -------------
В печатном руководстве подразделы вносятся в содержание и нумеруются до третьего уровня глубины.
@subsection
Команды @unnumberedsubsec, @appendixsubsec и
@subheading -- это эквиваленты команды @subsection для,
соответственно, ненумерованных разделов, приложений и заголовков.
(See section Команда @subsection.)
В Info команды, подобные @subsection, создают заголовок,
подчеркнутый строкой дефисов. В печатном руководстве, команда
@subheading создает заголовок, как для подраздела, за
исключением того, что он не нумеруется и не вносится в содержание.
Аналогично, команда @unnumberedsubsec создает ненумерованный
заголовок, как для подраздела, а команда @appendixsubsec ---
заголовок, подобный заголовку подраздела, помеченный буквой и числами;
заголовки, создаваемые обеими этими командами, вносятся в содержание.
Команды Texinfo для описания структуры глав четвертого, нижнего уровня --- это команды, начинающиеся с `subsub'. Они включают:
@subsubsection
@subsection.) В печатном
руководстве заголовки подподразделов вносятся в содержание и нумеруются
до четвертого уровня.
@unnumberedsubsubsec
@appendixsubsubsec
@subsubheading
@subsubheading применяется везде, где вам нужен
маленький заголовок, который не вносится в содержание. В Info такие
заголовки выглядят так же, как и заголовки простых
подподразделов.В Info заголовки подподразделов подчеркиваются строкой точек. Например,
@subsubsection Это подподраздел
дает
Это подподраздел ................
@raisesections и @lowersections
Команды @raisesections и @lowersections повышают и
понижают иерархический уровень глав, разделов, подразделов и подобных
сегментов. Команда @raisesections меняет разделы на главы,
подразделы на разделы и так далее. Команда @lowersections
меняет главы на разделы, разделы на подразделы и так далее.
Команда @lowersections полезна, если вы хотите включить текст,
записанный в отдельном или самостоятельном Texinfo-файле, в виде
внутреннего, включаемого файла. Если вы напишите эту команду в начале
файла, все команды @chapter будут отформатированы, как если бы
они были командами @section, все команды @section будут
отформатированы как команды @subsection, и так далее.
@raisesections увеличивает уровень команды в иерархии
структурирования глав на один:
Изменяет на
@subsection @section,
@section @chapter,
@heading @chapheading,
etc.
@lowersections уменьшает уровень команды в иерархии
структурирования глав на один:
Изменяет на
@chapter @section,
@subsection @subsubsection,
@heading @subheading,
etc.
Команда @raisesections или @lowersections изменяет
только те команды описания структуры, которые идут в исходном
Texinfo-файле после нее. Пишите команды @raisesections и
@lowersections на отдельной строке.
Команда @lowersections отменяет действие @raisesections
и наоборот. Как правило, эти команды используются следующим образом:
@lowersections @include somefile.texi @raisesections
Если не написать @raisesections, все последующие разделы в вашем
документе будут на уровень ниже.
Повторное применение этих команд продолжает поднимание или опускание иерархического уровня, на один каждый раз.
Попытка подняться выше уровня глав дает снова команды для глав, попытка спуститься ниже уровня подподразделов дает снова команды для подподразделов.
Go to the first, previous, next, last section, table of contents.