[devel] problem using docbook

[devel] problem using docbook

[Sviataslau Svirydau]

Приветствую,

помогите решить проблемму:
при сборке синаптика используется jade для создания html-документации из 
xml. Так вот этот jade пытается лезть в интернет во время сборки... 
Вернее, сначала в инет лезет sgmlnorm, потом jade (а может и ещё 
что-нить, я в этом мало чего понимаю...).
При отсутствии соединения с инетом сборка обламывется вот так:

db2html -o  ../../doc/html synaptic.xml
output is synaptic
Using catalogs: /etc/sgml/xml-docbook-4.1.2.cat
Using stylesheet: 
/usr/share/sgml/docbook/utils-0.6.13/docbook-utils.dsl#html
Working on: /home/svd/RPM/BUILD/synaptic-0.47/help/C/synaptic.xml
jade:/home/svd/RPM/BUILD/synaptic-0.47/help/C/synaptic.xml:9:0:E: could 
not resolve host "www.oasis-open.org" (try again later)
jade:/home/svd/RPM/BUILD/synaptic-0.47/help/C/synaptic.xml:9:0:E: DTD 
did not contain element declaration for document type name

При прямом подключении всё собирается нормально.  В случае, когда надо 
использовать прокси, а он не используется, сборка останавливается, и 
сообщение об ошибке выдаётся, конечно же, только после истечения таймаута.

Я не спец в docboot, xml, etc., поэтому прошу помощи в этом вопросе. Как 
отучить jade и sgmlnorm лазить в инет?

Вроде бы все пакеты, касающиеся docbook, установлены. Может ещё чего не 
хватает в системе для полного счастья?

ЗЫ
$ head synaptic.xml
<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY legal SYSTEM "gpl.xml">
<!ENTITY appversion "0.46">
<!ENTITY app "<application>Synaptic Package Manager</application>">
<!ENTITY manrevision "0.1">
<!ENTITY date "October 2003">
]>
<!-- =============Document Header ============================= -->


-- 
Regards,
Sviatoslav Sviridov <Sviataslau_Svirydau at epam.com>
/* icq: 10845380; jid: svd at altlinux.org; */
--
You will be attacked by a beast who has the body of a wolf, the tail of
a lion, and the face of Donald Duck.

[devel] Re: problem using docbook

[Vitaly Ostanin]

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

On Sun, 14 Dec 2003 01:50:22 +0200
Sviataslau Svirydau <Sviataslau_Svirydau@epam.com> wrote:

> Приветствую,
> 
> помогите решить проблемму:
> при сборке синаптика используется jade для создания
> html-документации из xml. 

Самый правильный вариант - перевести сборку на xsltproc. Сборка
html из XML с помощью dsssl-процессора вместо xslt-процессора -
хуже, чем хуже не придумаешь. В случае pdf ещё может быть смысл.

> Так вот этот jade пытается лезть в интернет во время сборки... 
> Вернее, сначала в инет лезет sgmlnorm, потом jade (а может и
> ещё что-нить, я в этом мало чего понимаю...).
> При отсутствии соединения с инетом сборка обламывется вот так:
> 
> db2html -o  ../../doc/html synaptic.xml
> output is synaptic
> Using catalogs: /etc/sgml/xml-docbook-4.1.2.cat
> Using stylesheet: 
> /usr/share/sgml/docbook/utils-0.6.13/docbook-utils.dsl#html
> Working on:
> /home/svd/RPM/BUILD/synaptic-0.47/help/C/synaptic.xml
> jade:/home/svd/RPM/BUILD/synaptic-0.47/help/C/synaptic.xml:9:0
> :E: could not resolve host "www.oasis-open.org" (try again
> later)
> jade:/home/svd/RPM/BUILD/synaptic-0.47/help/C/synaptic.xml:9:0
> :E: DTD did not contain element declaration for document type
> name
> 
> При прямом подключении всё собирается нормально.  В случае,
> когда надо использовать прокси, а он не используется, сборка
> останавливается, и сообщение об ошибке выдаётся, конечно же,
> только после истечения таймаута.
> 
> Я не спец в docboot, xml, etc., поэтому прошу помощи в этом
> вопросе. Как отучить jade и sgmlnorm лазить в инет?

> Вроде бы все пакеты, касающиеся docbook, установлены. Может ещё
> чего не хватает в системе для полного счастья?

Либо не установлены docbook-dsssl-style (и docbook-dtds), либо
неправильно настроен SGML Catalog resolving.

<skipped/>

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

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

Re: [devel] Re: problem using docbook

[Sviataslau Svirydau]

Vitaly Ostanin wrote:

>Самый правильный вариант - перевести сборку на xsltproc. Сборка
>html из XML с помощью dsssl-процессора вместо xslt-процессора -
>хуже, чем хуже не придумаешь. В случае pdf ещё может быть смысл.
>  
>
А как это сделать? Это сложно? Самостоятельно на коленке можно?

...

>>Вроде бы все пакеты, касающиеся docbook, установлены. Может ещё
>>чего не хватает в системе для полного счастья?
>>    
>>
>
>Либо не установлены docbook-dsssl-style (и docbook-dtds), либо
>  
>
Установлены
$ rpmquery -a|grep docbook
docbook-style-xsl-1.62.0-alt1
emacs-docbookide-0.1-alt4
docbook-dtds-1.0-alt8
docbook-utils-0.6.13-alt1
docbook-style-dsssl-1.78-alt3

>неправильно настроен SGML Catalog resolving.
>  
>
А как это проверить?
Всё, что я смог обнаружить неверного - так это в /etc/sgml/catalog была 
лишняя строчка с указанием на dsssl-1.3.1.cat. Её я убил 
(dsssl-1.3.2.cat осталась). Это было дома, на работе лишнего вроде нет.

-- 
Regards,
Sviatoslav Sviridov <Sviataslau_Svirydau at epam.com>
/* icq: 10845380; jid: svd at altlinux.org; */
-- 
Ask not for whom the <CONTROL-G>\a tolls.

[devel] Re: problem using docbook

[Vitaly Ostanin]

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

On Mon, 15 Dec 2003 12:59:49 +0200
Sviataslau Svirydau <Sviataslau_Svirydau@epam.com> wrote:

> Vitaly Ostanin wrote:
> 
> >Самый правильный вариант - перевести сборку на xsltproc.
> >Сборка html из XML с помощью dsssl-процессора вместо
> >xslt-процессора - хуже, чем хуже не придумаешь. В случае pdf
> >ещё может быть смысл.
> >  
> >
> А как это сделать? Это сложно? Самостоятельно на коленке можно?

Да.

Для chunked html (отдельные файлы для разделов)

xsltproc --nonet  \
--stringparam base.dir $(HTML_DIR)/ \
--stringparam chunker.output.encoding $(HTML_OUT_ENCODING) \
http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl
document.xml

document.xml не на отдельной строке, это мыльница переносит.

Для одного большого html:

xsltproc --nonet  \
--stringparam base.dir $(HTML_DIR)/ \
--stringparam chunker.output.encoding $(HTML_OUT_ENCODING) \
--param suppress.navigation 1 \
http://docbook.sourceforge.net/release/xsl/current/html/onechunk.xsl
document.xml

Должны стоять пакеты xsltproc и docbook-style-xsl со всеми
зависимостями.

HTML_DIR - каталог для складывания вывода html
HTML_OUT_ENCODING - кодировка html

Вообще в сборке с помощью xsltproc должен быть заинтересован
upstream. Если будут сложности с картинками и т.п., welcome to
http://altlinux.ru/mailman/listinfo/docs

<skipped/>

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

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

Re: [devel] Re: problem using docbook

[Sviataslau Svirydau]

Vitaly Ostanin wrote:

>...
>
>Для chunked html (отдельные файлы для разделов)
>
>xsltproc --nonet  \
>--stringparam base.dir $(HTML_DIR)/ \
>--stringparam chunker.output.encoding $(HTML_OUT_ENCODING) \
>http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl
>document.xml
>
>document.xml не на отдельной строке, это мыльница переносит.
>
>Для одного большого html:
>
>xsltproc --nonet  \
>--stringparam base.dir $(HTML_DIR)/ \
>--stringparam chunker.output.encoding $(HTML_OUT_ENCODING) \
>--param suppress.navigation 1 \
>http://docbook.sourceforge.net/release/xsl/current/html/onechunk.xsl
>document.xml
>
>Должны стоять пакеты xsltproc и docbook-style-xsl со всеми
>зависимостями.
>
>HTML_DIR - каталог для складывания вывода html
>HTML_OUT_ENCODING - кодировка html
>  
>
Спасибо, это работает.

>Вообще в сборке с помощью xsltproc должен быть заинтересован
>upstream. Если будут сложности с картинками и т.п., welcome to
>http://altlinux.ru/mailman/listinfo/docs
>
Попробую предложить в upstream.

-- 
Regards,
Sviatoslav Sviridov <Sviataslau_Svirydau at epam.com>
/* icq: 10845380; jid: svd at altlinux.org; */
-- 
Price's Advice:
	It's all a game -- play it to have fun.