[docs] Re: Q: docs status

[Vitaly Ostanin]

Alexandre Prokoudine пишет:

<skipped/>

>>- именование файлов со скриншотами
> 
> имя_книги-имя_проги-признак
> 
> Пример:
> 
> admin-draknet-first_window.png

Может, лучше разделять через точку?

admin.draknet.first-window.png ?

Дефис может использоваться и в имени документа, например,

admin.jabber-server.protocol-overview
admin.connect-to-net...

И стоит ли выбрасывать промежуточный уровень network, system ?
См. ниже про BASEID.

>>- формирование id для ссылок
> 
> с удовольствием выслушаю мнения коллег

В jabber-server используется именование с использованием BASEID.
В начале документа объявлена сущность
<!ENTITY BASEID "admin.network.jabber-server">

и id задаётся как
id="&BASEID;.intro"
При обработке таких документов с xmllint нужно задавать параметр 
--noent.

Годится?

Этот же BASEID можно использовать для ссылок на скриншоты.

<skipped/>

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