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

[cornet]

Vitaly Ostanin wrote:
> 
> 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.

Но chapter уже определен в admin/network/network.xml :

<!-- FIXME:  Each document must be in separate file! -->
<chapter><title>Сетевые сервисы</title>

<xi:include
href="postfix/postfix.xml"
parse="xml"
xmlns:xi="http://www.w3.org/2001/XInclude"/>

<xi:include
href="ldap/ldap.xml"
parse="xml"
xmlns:xi="http://www.w3.org/2001/XInclude"/>

<xi:include
href="ftpd/ftpd.xml"
parse="xml"
xmlns:xi="http://www.w3.org/2001/XInclude"/>

<xi:include
href="samba/samba.xml" parse="xml"
xmlns:xi="http://www.w3.org/2001/XInclude"/>
</chapter>

и все вложенные в него документы сейчас имеют статус section,
это нормально? chapter могут быть вложенными? И насколько
правомерно применение chapter внутри файла
admin/network/network.xml который сам по себе part в chapter
должны быть в каталогах под ним?

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

Дык, я имено этим обсуждением в сей момент и занят ;-)
 
> > в документации ни где не объясняется суть различий между
> > <article><chapter> и <section>, что напрягает. Налицо явное
> > противоречие документации и жизни.
> 
> В "DocBook: The Definitive Guide" есть описания этих тегов, какие
> различия не ясны?

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