[docs] Re: документация по docbook

[Kirill Maslinsky]

Привет!

> [2all] Давайте всё-таки этот вопрос проясним. Фиг с ним, с .spec,
> возможно, это не всем понятный синтаксис. Но описать на языке sh процесс
> превращения типового DB-документа (например, того, что в
> http://docs.altlinux.ru/alt/devel/ch03s06.html) в html и перечислить те пакеты,
> которые для этого нужно установить? Это помогло бы решить бездну проблем

Я попробовал написать для тривиального случая, выглядит так: 

-----Begin sh-script--------------------------------------------
#!/bin/sh
STYLESHEET="/usr/share/xml/docbook/xsl-stylesheets-1.64.0/html/docbook-koi8-r.xsl"
XSLPARAMS="--nonet"
TRANSFORMATOR="/usr/bin/xsltproc"
$TRANSFORMATOR $XSLPARAMS $STYLESHEET $1 > $2
-----End sh-script----------------------------------------------

Чтобы это работало, требуются пакеты: 

xsltproc
docsbook-style-xsl

и всё, от чего они зависят.
При этом, предполагается:
1. Документ xml ($1) -- это настоящий DocBook, без всяких там наворотов, 
alt-speciefic entities и тегов. 
2. Никаких дополнительных требований к html.

Часть требований к html, когда они будут сформулированы, наверное, 
удастся реализовать изменением $XSLTPARAMS, часть, возможно, 
потребует модификации $STYLESHEET

-- 
Kirill Maslinsky
ALT Linux Documentation Team