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

[cornet]

"Anton V. Boyarshinov" wrote:
> 
> Добрый день
> 
> 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 не наблюдаю.

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

ИМХО, но стоит увеличить хотя бы еще на 2 шага. Очень неудобно
делать документы класса section с плоским оглавлением :-(

-- 
Власенко Олег.
Отдел технической поддержки ALT Linux Team.
mailto:cornet на altlinux.ru