[docs] Re: collect_images при сборке

Kirill Maslinsky kirill на altlinux.ru
Чт Ноя 24 19:10:00 MSK 2005


Добрый вечер!

Извините, что не сразу отвечаю, нужно было разобраться...

> > В комментариях в Makefile'ах написано, что collect_images -- это хак. 
> 
> Где именно и как написано? Сейчас уже не хак.
Ну где-то в Makefile.images. Не думаю, что это имеет большое
значение, поскольку Makefile'ы заброшены и не используются (слишком уж
сильно они завязаны на конкретный CVS и многие соглашения в нём, не 
удалось перенести).

> В текущей инкарнации collect_images.xsl - самостоятельный
> тюнинговый стиль, живёт он здесь:
> http://vyt.vzljot.ru/dcben/browser/dcben/trunk/markup/core/collect_images.xsl
> использует
> http://vyt.vzljot.ru/dcben/browser/dcben/trunk/markup/core/filename.xsl
> который использует
> http://vyt.vzljot.ru/dcben/browser/dcben/trunk/markup/core/str.split.template.xsl
> 
> Пример использования стиля:
> http://vyt.vzljot.ru/dcben/browser/dcben/trunk/build-rules/make/include.d/collect_images

Спасибо! Хорошая и очень полезная штука. Однако diff показывает, что 
в текущем пакете alt-docs-xsl-common (0.3-alt2, от 6 октября 2003)
соответствующие файлы сильно старше и заметно отличаются (и работают
не так, как я уже успел установить эмпирически). 

Как Вы смотрите на то, чтобы этот пакет обновить в Сизифе? 
Если он Вам лично не нужен или нет сейчас времени, то я могу подготовить
NMU. Иначе новый collect_images не получится использовать в сборке -- hasher, 
знаете ли.

> > Вопрос: а как тут правильно быть? 
> > - Сделать свой xsl-стиль, в котором импортировать collect_images.xsl 
> >   и tuning.xsl? 
> 
> tuning.xsl должен быть распилен на отключаемую функциональность,
> в текущей версии обработка картинок отключена и вынесена в
> collect_images.xsl. Текущая версия tuning.xsl:
> http://vyt.vzljot.ru/dcben/browser/dcben/trunk/markup/core/tuning.xsl

Пилить-то tuning.xsl, наверное, не обязательно, а вот отключать функциональность
параметрами было бы удобно. Скажем, для подготовки печатной версии мне не 
требуется обрабатывать пробелы вокруг тире, в TeXe babel это делает, и даже
правильнее.

> > - xsl-стиль тут вообще не нужно писать, а решать задачу другими средствами 
> >   (какими?)?
> 
> Достоверная информация о картинках доступна только из xml
> документа, поэтому правильно собирать её xsl-стилем. Можно решать
> эту задачу организационно с помощью соглашений о префиксах в
> именах картинок и хранении их всех в оговоренном каталоге, как
> это было не так давно в проекте Docs. Но это неудобно и
> неприемлемо в других проектах, поэтому был написан
> collect_images.xsl.

Да-да, полностью согласен со всеми аргументами. :)

-- 
Kirill Maslinsky
ALT Linux Documentation Team
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
Url : http://lists.altlinux.org/pipermail/docs/attachments/20051124/b789ab72/attachment.bin


Подробная информация о списке рассылки docs