[docs] Степень вложенности оглавления.

[Anton V. Boyarshinov]

Добрый день

On Thu, 24 Oct 2002 15:54:34 +0400
cornet <cornet на altlinux.ru> wrote:

> 1. В документации:
> http://docs.altlinux.ru/alt/devel/ar01s05.html
> сказано, что иерархия документов должна быть:
> <book>
>        <part>
>              <article>
>              <chapter>
> Между тем, имеющиеся документы имеют доктайп section. При этом
> в документации ни где не объясняется суть различий между
> <article><chapter> и <section>, что напрягает. Налицо явное
> противоречие документации и жизни.

Да, документация тут отстала от жизни. Некоторое ремя назад было
решено делать всё что ниже chapter section-ами, так как их можно
произвольно вкладывать друг в друга и они более органично
выглядят в руководстве (если мы считаем руководство единой
книгой, а не сборником статей).
 
> 2. Если конечный документ имеет доктайп <article> или <chapter>
> то он сам и его оглавление не попадает в общее оглавление book.

Он сам должен попадать. Если находится на правильном месте в
иерархии. Его содержание -- для article не должно. Непопадания
chapter не наблюдаю.

> Что странно и не понятно и расходится с документацией.
 
> 3. Если конечный документ оформлен как <section>, то информация
> о нем присутствует в оглавлении, однако почему то происходит
> обрезание степени вложенности этого оглавления.

Общая глубина вложенность оглавления ограничена. Это разумно и
это настраивается.

Антон
-- 
mailto:boyarsh на mail.ru
mailto:boyarsh на ru.echo.fr
  4:00pm  up 9 days,  4:57,  4 users,  load average: 1.07, 0.49,
0.20