[docs] Re: docs about docs

[Andriy Dobrovol's'kii]

Vitaly Ostanin wrote:
> 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 уже на любой
> вкус. Чего именно не хватает (удобного редактора нет ;)) ?
> 

Что нет удобного, я уже понял. Конкретный пример не в смысле 
готового файла, а как настроить конкретную программу со 
всеми дополнениями и начать работать. Невозможно быть профи 
во всем. И, например, я с emacs по жизни не сталкиваюсь, а 
писать что-то, как я понял, можно только в нем.

> 
>>>бы присоединиться к активной работе, но нужно от чего-то
>>
> 
> Что есть "активная работа" ? Список задач недавно высылался в эту
> рассылку, чем конкретно Вы хотели бы заняться?
> 
> 
>>>оттолкнуться и не только мне. 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/>
> 

Вот я и прошу описание как писать доки в emacs-psgml.

-- 
Rgrds,
Andriy
*********************************************************************
email: dobr at iop dot kiev dot ua               Kyiv, Ukraine
Phone: (380-44)   265-7824               Department of Gas 
Electronics
Fax:   (380-44)   265-2329                Institute of 
Physics of NASU
*********************************************************************