[docs] Re: документация по docbook

[Kirill Maslinsky]

Привет!

> >Если я правильно понимаю, для раскрытия alt-speciefic entities должно быть 
> >достаточно установить пакет alt-entites и как-то указать в документе, что 
> >они будут использоваться. Например, путём указания docs.dtd. 
> >Специфичный для alt тег один, <alt:distro>. Его нужно просто вычистить 
> >из всех текстов, если мы документируем Сизиф.
> 
> Какими средствами предполагается решать те задачи, которые решались при 
> помощи этой надстройки?

Тег <alt:distro> появился для того, чтобы при сборке автоматически 
подставлять название соответствующего дистрибутива. (Замечу в скобках, 
это свидетельствует о том, что текст, в котором такой тег стоит, годится к 
разным дистрибутивам, а значит, и указывать в тексте название только 
одного конкретного -- не совсем честно).

Поскольку мы хотим, чтобы документация ALT была документацией к Сизифу 
или его срезу, а не дистрибутиву, то такие псевдоупоминания 
(метаупоминания) конкретных дистрибутивов там и ни к чему. 
Если же текст жёстко завязан на конкретный дистрибутив, то нужно 
название этого дистрибутива вписывать явно, а не тегом <alt:distro>. 

-- 
Kirill Maslinsky
ALT Linux Documentation Team