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

[Vitaly Ostanin]

On Thu, 24 Oct 2002 16:48:45 +0400
cornet <cornet на altlinux.ru> wrote:

<skipped/>

> > Какие именно документы?
> 
> Все, относящиеся к "Сетевые сервисы" 

Понятно.

В network.xml (part) не должно быть собственного содержания,
только включения других документов. Однако есть глава "Сетевые
сервисы". Эту главу нужно вынести в отдельный документ (chapter),
каталогом ниже, и уже в этом каталоге сделать подкаталоги для тех
section, которые относятся к сетевым сервисам.

Собственно, это я и имел в виду в FIXME.

<skipped/>

> Но chapter уже определен в admin/network/network.xml :
> 
> <!-- FIXME:  Each document must be in separate file! -->
> <chapter><title>Сетевые сервисы</title>

<skipped/>

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

Ещё кстати, в абзаце, сразу перед первым замечанием написано про
собственное содержимое рядом с включениями.

> Дык, я имено этим обсуждением в сей момент и занят ;-)

Спасибо, это действительно ошибка в структуре каталогов.

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

http://docs.altlinux.ru/alt/devel/ar01s09.html
в конце ссылка на само Guide:
http://docbook.org/tdg/en/html/docbook.html
там же ссылка на него в одном файле:
http://docbook.org/tdg/en/tdg-en-html-2.0.7.zip

<skipped/>

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