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

[Kirill Maslinsky]

Добрый день!

> > Я попробовал написать для тривиального случая, выглядит так: 
> > -----Begin sh-script--------------------------------------------
> > #!/bin/sh
> > STYLESHEET="/usr/share/xml/docbook/xsl-stylesheets-1.64.0/html/docbook-koi8-r.xsl"
> 
> Наверное, здесь s/1.64.0/*/ (это нестрого, но afair несколько
> версий штатно не сосуществуют).
Хотелось бы вообще избавиться от явного пути. Не уверен, подходит ли 
для этого xmlcatatlog?

> > XSLPARAMS="--nonet"
> > TRANSFORMATOR="/usr/bin/xsltproc"
> > $TRANSFORMATOR $XSLPARAMS $STYLESHEET $1 > $2
> > -----End sh-script----------------------------------------------
> > При этом, предполагается:
> > 1. Документ xml ($1) -- это настоящий DocBook, без всяких там
> > наворотов, alt-speciefic entities и тегов. 
> 
> А если?  У нас же вроде только с ними и наблюдалось?
> (нет среза под рукой и пишу урывками между сборками)
Если я правильно понимаю, для раскрытия alt-speciefic entities должно быть 
достаточно установить пакет alt-entites и как-то указать в документе, что 
они будут использоваться. Например, путём указания docs.dtd. 
Специфичный для alt тег один, <alt:distro>. Его нужно просто вычистить 
из всех текстов, если мы документируем Сизиф.

-- 
Kirill Maslinsky
ALT Linux Documentation Team