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

Vitaly Ostanin vyt на vzljot.ru
Чт Окт 24 16:32:40 MSD 2002


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

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

Нет, там сказано
"Элементы DocBook, соответствующие каталогам в CVS"

> <book>
admin
>        <part>
----------network
>              <article>
----------------samba

> Между тем, имеющиеся документы имеют доктайп section. При этом

Какие именно документы?

Если это samba.xml - то
admin/network/samba
должен иметь корневой тег
book/part/chapter
то есть chapter.

Либо дока по самбе - не статья (глава), а раздел (section), и её
нужно поместить уровнем ниже. Либо нужно поменять корневой тег на
chapter.

Кстати, там же
http://docs.altlinux.ru/alt/devel/ar01s05.html
написано, что нужно обсуждать в рассылке, куда и с каким
корневым тегом класть документы.

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

В "DocBook: The Definitive Guide" есть описания этих тегов, какие
различия не ясны?

<skipped/>

-- 
Regards, Vyt
mailto:  vyt на vzljot.ru
JID:     vyt на vzljot.ru
----------- следущая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : отсутствует
Тип     : application/pgp-signature
Размер  : 189 байтов
Описание: отсутствует
Url     : /pipermail/docs/attachments/20021024/b108b4fd/attachment.bin


Подробная информация о списке рассылки docs