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

[cornet]

Привет всем!

Вот, обнуружил странности.

1. В документации:
http://docs.altlinux.ru/alt/devel/ar01s05.html
сказано, что иерархия документов должна быть:
<book>
       <part>
             <article>
             <chapter>
       <part>
             <article>

Между тем, имеющиеся документы имеют доктайп section. При этом в
документации ни где не объясняется суть различий между <article>
<chapter> и <section>, что напрягает. Налицо явное противоречие
документации и жизни.

2. Если конечный документ имеет доктайп <article> или <chapter>
то он сам и его оглавление не попадает в общее оглавление book.
Что странно и не понятно и расходится с документацией.

3. Если конечный документ оформлен как <section>, то информация
о нем присутствует в оглавлении, однако почему то происходит
обрезание степени вложенности этого оглавления. А именно -
получается, что конечный документ может иметь только плоское
оглавление из разделов <section>. Структура уровня 2 уже
игнорируется и обрезается. В то же время, если тот же самый
документ оформить как <article> и конвертнуть в html только его,
то можно увидеть все вложения его внутреннего оглавления.
Требовать же плоского одноуровневого оглавлеия от сколько ни
будь объемных и сложных документов, ИМХО, не разумно.
Все это можно пронаблюдать на файле
$CVSROOT/admin/network/samba/samba.xml который имеет
двухуровневое оглавление.


Вот такие вопросы, которые требуют разъяснений со стороны
знающих людей. Я же в этом всём сейчас выступаю как просто
пассивный пользователь этого инструмента, столкнувшийся с
некоторыми проблемами.

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