[docs] Re: docs about docs

[Vitaly Ostanin]

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

<skipped/>

> > Конкретный опыт работы есть в примере в docs-howto.
> > Примеры более сложных документов есть в cvs docs уже на любой
> > вкус. Чего именно не хватает (удобного редактора нет ;)) ?
> > 
> 
> Что нет удобного, я уже понял. Конкретный пример не в смысле 
> готового файла, а как настроить конкретную программу со 
> всеми дополнениями и начать работать. Невозможно быть профи 
> во всем. И, например, я с emacs по жизни не сталкиваюсь, а 
> писать что-то, как я понял, можно только в нем.

Для дистрибутивов от ALT с добавками из Sisyphus нужно поставить
пакеты (с соблюдением зависимостей):

emacs-mode-psgml 
(режим редактирования XML)

docbook-dtds 
(локально установленные DTD, чтобы не качать каждый раз из сети) 

docbook-style-xsl
(локально установленные xsl-стили для обработки xml, например, в
html)

alt-entities
(локально установленные public entities от ALT)

xsltproc
(xsl-процессор для обработки документов xsl-стилями)

make
(для использования Makefiles из cvs docs)

cvs
(для работы с cvs)

<skipped/>

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

Все теги и их структура уже продуманы DocBook Technical Committee
и описаны в DTD DocBook, также есть стили для их обработки. 

Если Вы придумаете свои теги - это будет не DocBook.

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

На домашней странице psgml есть ссылка на manual:
http://www.lysator.liu.se/~lenst/about_psgml/psgml.html

На русском языке есть такой интересный документ, который я забыл
сегодня добавить в список ссылок :(
http://xtalk.msk.su/SGML/em.html

<skipped/>

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