[docs] сборочная среда

[Kirill Maslinsky]

Господа!

Предлагаю самый простейший вариант сборочной среды для документов DocBook/XML 
для Сизифа. Прошу исправлять, дополнять и комментировать.

Сборочную среду можно представить в виде пакета rpm-build-alt-docs
В нём будет:

--/etc/rpm/macros.d/alt-docs------------------------------------

%_adtmodulesdir		/usr/share/doc/alt-docs/modules/sisyphus
%_heapdocprefix		doc

%_tohtml() \
/usr/bin/dbktohtml %1 index.html \
%nil
-----------------------------------------------------------------

--/usr/bin/dbktohtml----------------------------------------------------------

#!/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
------------------------------------------------------------------------------

Подставить значения макросов в начало спека, взяв их из архива документа
Кучи вполне может довольно несложная программа. Человеку останется 
заполнить только несколько полей и добавить нестандартное.

--/usr/share/doc/rpm-build-alt-docs/adt-modile-fish.spec----------

%define heap_document
%define heap_name
%define heap_maindocname
%define docinfo_title
%define docinfo_version
%define docinfo_license
%define docinfo_abstract
%define docinfo_url
Name: adt-module-%heap_name
Version: %docinfo_version
Release: alt1
# Заполнить по-английски
Summary:  
#Заполнить по-русски
Summary(ru_RU.KOI8-R):  
License: %docinfo_license
Group: Books/Other
Url: %docinfo_url
Buildarch: noarch
Source: %heap_document.tar.bz2 
# Заполнить по-анлийски
%description

%description -l ru_RU.KOI8-R
%docinfo_abstract

%prep
%setup -q -n %heap_document

%build
%_tohtml %_heapdocprefix/%heap_maindocname 

%install
%__install -d %buildroot/%_adtmodulesdir/%heap_name
%__install -m 0644 *.html %buildroot/%_adtmodulesdir/%heap_name

%files
%buildroot/%_adtmodulesdir/%heap_name
%doc docinfo License

%changelog
----------------------------------------------------------------

Комментарии?

-- 
Kirill Maslinsky
ALT Linux Documentation Team