Re: Jade, docbook

[Andrey Taranov <andrey@custis.dol.ru>]

Привет

Paul Romanchenko wrote:

> Вообще-то хочется документацию на нашу систему писать (под win32, unix),
> jade+docbook для этого используются? Или есть более специализированные
> средства? (На выходе -- .rtf(.ps, .dvi), .html)

Используются. Мы ведем всю проектную документацию ( а это около 10 мег
под CVS'ом) в docbook'e. У меня подавляющее большинство рабочих мест под
win32. Для ввода в основном используется Multi-Edit 7.1, лично я
пользуюсь только виндовым Emacs'om + psgml-mode. В принципе, можно
использовать какой-нибудь Autor/Editor для набора, но для многофайловых
документов он IMHO мало годится. Более специализированные средства есть,
но они редки и дороги, на пиратских дисках (почти) не встречаются; не
всегда гладко русифицируются(рованы).

> Решил сделать все с нуля (win32) -- поставил jade, docbook.
> Тестовый документ затребовал ISO entities. Какой-то набор я скачал, но в
> нем отсутсвуют iso-grk[1-4].gml. В каком наборе они находятся? Хотя, я
> думаю, на них можно забить.

Стоит иметь полный набор стандартных файлов с каталогами. У меня есть
заготовка (стандартные DTD+entities c головным каталогом для Jade'a).
Могу выслать...

> Вторая проблема -- non SGML character number xxxxx. Где и как
> прописываются допустимые символы?

Суть проблемы в том, что Jade не знает отображения кириллического
алфавита в Юникод по именам (в виде SDATA).  Это можно обойти
несколькими способами. Я поступил так:

1. файл iso-cyr1.ent, в котором кириллица прописана через SDATA, что
Jade не воспринимает, выкидывается (сохраняется как iso-cyr1.ent.sdata)

2. вместо SDATA в этом файле прописывается кириллица через Юникод
(CDATA):
................
<!ENTITY acy    CDATA "&#1072;"--=small a, Cyrillic-->
<!ENTITY Acy    CDATA "&#1040;"--=capital A, Cyrillic-->
<!ENTITY bcy    CDATA "&#1073;"--=small be, Cyrillic-->
<!ENTITY Bcy    CDATA "&#1041;"--=capital BE, Cyrillic-->
................
и так далее. Этот файл могу выслать прямо в RU-SGML

3. кроме того, необходима правка стандартной SGML-декларации, которая
используется в данный момент. Конкретно, описание той части кодировки,
что выше 160. Для своих целей я скопировал кусок, описывающий CHARSET из
xml.dcl:
.....................................
CHARSET
	BASESET
	.....<skip>........
	DESCSET
	.....<skip>........
        -- use this instead of the official declaration because SP only
           supports 16-bit characters --
           160     65374   160
           65534   2       UNUSED
.....................................
Можно править default.dcl, как у меня. Можно править docbook.dcl

4. в основном каталоге Валшевского style-sheet'a (лежит в корне
дистрибутива style-sheet'a) -- закомментировать строчку SGMLDECL (или
сослаться на исправленный docbook.dcl)

Regards
Andrey Taranov
Customized Information Systems, Moscow