[docs] Re: docs about docs

[Vitaly Ostanin]

On Tue, 22 Oct 2002 18:02:05 +0300
"Andriy Dobrovol's'kii" <dobr на iop.kiev.ua> wrote:

> Andriy Dobrovol's'kii wrote:
> > Hi,
> > Я перечитываю нашу документацию о написании документации.
> > Может кто-то из активно пишущих в DocBook поделиться
> > конкретным опытом работы?
> > Что нужно установить, как настроить, как писать? Я правильно
> > понял, что реально возможно писать только в emacs? Хотелось

Что больше нравится. Совсем удобного свободного редактора
docbook не существует. Лично мне удобен emacs-psgml.

Конкретный опыт работы есть в примере в docs-howto.
Примеры более сложных документов есть в cvs docs уже на любой
вкус. Чего именно не хватает (удобного редактора нет ;)) ?

> > бы присоединиться к активной работе, но нужно от чего-то

Что есть "активная работа" ? Список задач недавно высылался в эту
рассылку, чем конкретно Вы хотели бы заняться?

> > оттолкнуться и не только мне. P.S. можно высылать другие
> > куски готовые к вычитке. Или я слишком зануден? ;(

У Вас есть доступ на чтение в cvs docs?
Кстати, кое-что уже выложено в html на тот же
http://docs.altlinux.ru

> Извиняюсь за кодировку.

Да вроде нормально всё в первом письме прочиталось.

> Гдето есть в сети перечень тегов которые можно использовать?

В ссылках на
http://docs.altlinux.ru/alt/devel/ar01s09.html
упоминается
http://docbook.org/tdg/en/html/docbook.html
Рядом ссылка на то же самое, но одним файлом.

Лучше отталкиваться не от доступных тегов, а от смысла, который
нужно передать.

Кстати, emacs-psgml показывает перечень тегов, которые можно
использовать в данном месте, и даже занимается автодополнением
обязательных тегов там, где они нужны. Причём делает это в
соответствии с DocBook DTD (см. /usr/share/xml/docbook).

<skipped/>

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