[mdk-re] docbook/xml question

[mdk-re] docbook/xml question

[Vyt]

[-- Attachment #1: Type: text/plain, Size: 557 bytes --]

Hello, All!

То ли лыжи не едут, то ли как обычно:

Подскажите, пожалуйста, подходящую конструкцию для описания
возможных значений переменной в docbook/xml, например:

VARNAME (Value1|Value2)

Используется 
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">

В теле документа есть конструкция с перечислением и описанием
переменных (<variablelist>), где и нужно разместить VARNAME.

В тэге <parameter> нужного не нашел.

-- 
Regards, Vyt
mailto:  vyt@vzljot.ru
JID:     vyt@vzljot.ru

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

[mdk-re] Re: docbook/xml question

[Mikhail Zabaluev]

Hello Vyt,

On Tue, Mar 26, 2002 at 02:49:00PM +0300, Vyt wrote:
>
> Подскажите, пожалуйста, подходящую конструкцию для описания
> возможных значений переменной в docbook/xml, например:
> 
> VARNAME (Value1|Value2)
> 
> Используется 
> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
> "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">

Кстати, экспериментальным путём было установлено, что system ID должен
быть абсолютным именем файла (даже не URL со схемой file:),
чтобы openjade обработал XML-документ правильно, например, нашёл
определения charater entities. Можно его вообще выкинуть, но этого
не переносят уже чистые XML-процессоры.
Sucks. Остаётся констатировать, что на данный момент openjade пригоден
лишь для SGML документов. У кого-нибудь есть в загашнике XSL-процессор
в виде пакета RPM?

> В теле документа есть конструкция с перечислением и описанием
> переменных (<variablelist>), где и нужно разместить VARNAME.
> 
> В тэге <parameter> нужного не нашел.

В DocBook: TDG ничего на этот счёт не сказано?

-- 
Stay tuned,
  MhZ                                     JID: mookid@jabber.org
___________
The onset and the waning of love make themselves felt in the uneasiness
experienced at being alone together.
		-- Jean de la Bruyere

Re: [mdk-re] Re: docbook/xml question

[Vyt]

[-- Attachment #1: Type: text/plain, Size: 1626 bytes --]

On Wed, 27 Mar 2002 11:06:24 +0300
Mikhail Zabaluev <mhz@alt-linux.org> wrote:

<skipped>

> > Используется 
> > <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
> > "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
> 
> Кстати, экспериментальным путём было установлено, что system ID должен
> быть абсолютным именем файла (даже не URL со схемой file:),
> чтобы openjade обработал XML-документ правильно, например, нашёл
> определения charater entities. Можно его вообще выкинуть, но этого
> не переносят уже чистые XML-процессоры.
> Sucks. Остаётся констатировать, что на данный момент openjade пригоден
> лишь для SGML документов. У кого-нибудь есть в загашнике XSL-процессор
> в виде пакета RPM?

Посоветуйте, pls, хоть не в виде rpm. Желательно со способом
использования :)

> > В теле документа есть конструкция с перечислением и описанием
> > переменных (<variablelist>), где и нужно разместить VARNAME.
> > 
> > В тэге <parameter> нужного не нашел.
> 
> В DocBook: TDG ничего на этот счёт не сказано?

Собственно, об этом и вопрос. Там нет даже тэга 'value', пытаюсь
сделать это с 'option' или 'optional'. Кстати, 'value' очень не
хватает, например, для текста "значение YES определяет..."

Также очень не хватает внятной терминологии на русском, я,
например, путаюсь в терминах "опция" и "параметр", а секретарша
так и вообще плюнет на такие тонкости... Вот и приучай их к
docbook/xml...

Кстати, редакторы тоже не фонтан - emacs с sgml-mode не
выравнивает отступы, а kxmleditor неудобен для последовательного
текста.

<skipped>

-- 
Regards, Vyt
mailto:  vyt@vzljot.ru
JID:     vyt@vzljot.ru

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [mdk-re] Re: docbook/xml question

[Sergey Vlasov]

On Wed, 27 Mar 2002 11:06:24 +0300
Mikhail Zabaluev <mhz@alt-linux.org> wrote:

> > Используется 
> > <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
> > "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
> 
> Кстати, экспериментальным путём было установлено, что system ID должен
> быть абсолютным именем файла (даже не URL со схемой file:),
> чтобы openjade обработал XML-документ правильно, например, нашёл
> определения charater entities. Можно его вообще выкинуть, но этого
> не переносят уже чистые XML-процессоры.
> Sucks. Остаётся констатировать, что на данный момент openjade пригоден
> лишь для SGML документов. У кого-нибудь есть в загашнике XSL-процессор
> в виде пакета RPM?

xsltproc из xml-utils по крайней мере HTML генерировать умеет.

$ xsltproc  --param default.encoding \"KOI8-R\" /usr/share/xml/docbook/xsl-stylesheets/html/chunk.xsl postfix.xml 
Writing ch01s02.html for section
Writing ch01s03.html for section
Writing ch01s04.html for section
Writing ch01s05.html for section
Writing ch01s06.html for section
Writing ch01s07.html for section
Writing index.html for chapter

(без chunk кодировка не ставится, получается сплошь &#1234;)

Если в docbook.xml дописать к chapter lang="ru", вообще красота :-)

[mdk-re] Re: docbook/xml question

[Vyt]

[-- Attachment #1: Type: text/plain, Size: 1430 bytes --]

On Wed, 27 Mar 2002 17:26:46 +0300
Sergey Vlasov <vsu@mivlgu.murom.ru> wrote:

> On Wed, 27 Mar 2002 11:06:24 +0300
> Mikhail Zabaluev <mhz@alt-linux.org> wrote:

<skipped>

> > лишь для SGML документов. У кого-нибудь есть в загашнике XSL-процессор
> > в виде пакета RPM?
> 
> xsltproc из xml-utils по крайней мере HTML генерировать умеет.

Спасибо! Я не тормоз, просто только что добрался до этого 
письма :)

> $ xsltproc  --param default.encoding \"KOI8-R\" /usr/share/xml/docbook/xsl-stylesheets/html/chunk.xsl postfix.xml 
> Writing ch01s02.html for section
> Writing ch01s03.html for section
> Writing ch01s04.html for section
> Writing ch01s05.html for section
> Writing ch01s06.html for section
> Writing ch01s07.html for section
> Writing index.html for chapter
> 
> (без chunk кодировка не ставится, получается сплошь &#1234;)

Да, у меня эти номера при docbook.xsl, с chunk.xsl все ок.

> Если в docbook.xml дописать к chapter lang="ru", вообще красота :-)

Офигеть!! После lang="ru" теперь вместо "Tip" - "Подсказка" !! Не
говоря уже о ссылках "В начало" на русском. Нет, вещь все-таки :)

Кстати, писал в sisyphus@ о разных отступах в зависимости от
разделителей вокруг "para" как результат db2html. Так вот,
xsltproc делает правильные отступы и вообще вид html ощутимо
приятнее, чем после db2html, даже автора и revhistory показывает.
Вещь.

<skipped>

-- 
Regards, Vyt
mailto:  vyt@vzljot.ru
JID:     vyt@vzljot.ru

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]