[docs] Сборочная среда
Oleg A. Paraschenko
olpa на xmlhack.ru
Вс Фев 27 23:50:34 MSK 2005
Ещё раз привет,
ответ сразу на два письма.
Есть некое описание сборочной среды:
http://xmlhack.ru/tmp/alt/makefiles/makefiles-html-dir/
> Фиг с ним, с .spec, возможно, это не всем понятный синтаксис.
Да, так и есть.
>
> Но описать на языке sh процесс
> превращения типового DB-документа (например, того, что в
> http://docs.altlinux.ru/alt/devel/ch03s06.html) в html
>
$ cat ~/bin/amake
#!/bin/sh
export DOCS_ROOT=......./p/altlinux-docs/docs
make -f ${DOCS_ROOT}/doc-template/Makefile DOCS_ROOT=${DOCS_ROOT} $*
$ head xxx.xml
<?xml version="1.0" encoding="koi8-r"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
[
<!ENTITY % AltCommonEntities PUBLIC
"-//ALTLINUX//ENTITIES Common Documentation//RU"
"http://docs.altlinux.ru/ru/entities/common.ent">
%AltCommonEntities;
$ amake -n html-dir DOCUMENT_NAME=xxx
mkdir -p tmp
touch tmp/.build
........ длинное описание .......
$ amake -n html-file DOCUMENT_NAME=xxx
mkdir -p tmp
touch tmp/.build
....... длинное описание .......
>
> и перечислить те пакеты, которые для этого нужно установить?
>
Сложно сказать. В первом приближении:
$ cd $DOCS_ROOT/doc-template
$ make -f Makefile.sanity
Это более-менее проверит рабочее окружение.
>
> Невольно возникает вопрос: кто в данном списке рассылки считает себя
> ответственным за поддержание в актуальном состоянии среды сборки
> документации? Интерес не праздный.
>
Скорее всего, я. С учётом различных обстоятельств -- похоже, никто.
>
> Поэтому я вижу создание независимой от CVS сборочной среды
> очень приоритетной задачей.
>
Содержимого каталога doc-template должно хватить, плюс нечто типа
~/bin/amake, приведённого выше.
--
Oleg Paraschenko olpa@ http://xmlhack.ru/ XML news in Russian
Подробная информация о списке рассылки docs