[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