Go to the first, previous, next, last section, table of contents.


Структура глав

Команды описания структуры глав разделяют документ на иерархию глав, разделов, подразделов и подподразделов. Эти команды создают большие заголовки, а также предоставляют сведения для составления содержания печатного руководства (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-файле; только некоторые команды создают заголовки, которые будут перечислены в содержании печатной книги или руководства.

Вот четыре группы команд описания структуры глав:
Не начинают новую страницу
Нумерованные Ненумерованные Нумерованные или
перечисленные по
буквам
Ненумерованные
В содержании В содержании В содержании Нет в содержании
@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 --- заголовок, подобный заголовку подраздела, помеченный буквой и числами; заголовки, создаваемые обеими этими командами, вносятся в содержание.

Команды subsub

Команды Texinfo для описания структуры глав четвертого, нижнего уровня --- это команды, начинающиеся с `subsub'. Они включают:

@subsubsection
Подподразделы соотносятся с подразделами так же, как подразделы с разделами. (See section Команда @subsection.) В печатном руководстве заголовки подподразделов вносятся в содержание и нумеруются до четвертого уровня.
@unnumberedsubsubsec
Заголовки ненумерованных подподразделов вносятся в содержание печатного руководства, но не имеют номеров. В остальном ненумерованные подподразделы эквиваленты простым подподразделам. В Info ненумерованные подподразделы выглядят точно так же, как и простые подподразделы.
@appendixsubsubsec
По соглашению, команды для приложений используются только внутри приложений. В печатном руководстве они создают заголовки, помеченные буквами или числами. Эти заголовки также появляются в содержании. В Info, подподразделы приложения выглядят так же, как и простые подподразделы.
@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.