[docs] Сборка из cvs

[cornet]

"Oleg A. Paraschenko" wrote:
> 
>   Привет,
> 
> On Tue, 13 Jan 2004 16:20:32 +0300
> cornet <cornet на altlinux.ru> wrote:
> 
> ...
> 
> > Откатился:
> > xml-utils-2.5.10-alt1
> > xsltproc-1.0.32-alt1
> > libxml2-2.5.10-alt1
> > libxslt-1.0.32-alt1
> > проблемы остались аналогичные, но уже иначе выглядят:
> >
> > [cornet на smart junior-2.3]$ make
> > mkdir -p tmp
> > touch tmp/.build
> > xmllint --xinclude --nonet --loaddtd --noent junior-2.3.xml |
> > sed 's/ENTITY percnt "%"/ENTITY percnt "\&#37;"/' >
> > tmp/junior-2.3.xinclude
> > Attempt to load network entity
> > http://docs.altlinux.ru/dtd/docs.dtd
> > Attempt to load network entity
> > http://docs.altlinux.ru/dtd/docs.dtd
> > intro/linux/devmodel/devmodel.xml:20: error: Entity 'LINUX' not
> > defined
> >   <title>п п╟п╥я─п╟п╠п╬я┌п╨п╟ &LINUX;</title>
> > skip...
> 
>   Попробуйте сказать:
> 
> $ xmlcatalog /etc/xml/catalog \
> '-//ALTLINUX//DTD DocBook XML Based Extension//EN' \
> 'http://docs.altlinux.ru/dtd/docs.dtd'
> 
>   Должно получиться что-то типа:
> 
> file:///usr/share/xml/alt-entities/dtd/docs.dtd
> No entry for SYSTEM http://docs.altlinux.ru/dtd/docs.dtd
> 
>   Если нет "file://...", обновите пакет alt-entities. У меня
> alt-entities-0.7-alt1, а кажется, уже есть и свежее).
> И попробуйте ещё раз.

Ага!

Вот:

[cornet на smart junior-2.3]$ rpm -q alt-entities
alt-entities-0.3-alt1
[cornet на smart junior-2.3]$ xmlcatalog /etc/xml/catalog
'-//ALTLINUX//DTD DocBook XML Based Extension//EN'
'http://docs.altlinux.ru/dtd/docs.dtd'
No entry for PUBLIC -//ALTLINUX//DTD DocBook XML Based
Extension//EN
No entry for SYSTEM http://docs.altlinux.ru/dtd/docs.dtd

[cornet на smart junior-2.3]$ rpm -q alt-entities
alt-entities-0.7-alt1
[cornet на smart junior-2.3]$ xmlcatalog /etc/xml/catalog
'-//ALTLINUX//DTD DocBook XML Based Extension//EN'
'http://docs.altlinux.ru/dtd/docs.dtd'
file:///usr/share/xml/alt-entities/dtd/docs.dtd
No entry for SYSTEM http://docs.altlinux.ru/dtd/docs.dtd

[cornet на smart junior-2.3]$ make
И заработало!!
:-)) Спасибо огромное, Олег!

Надеюсь, что проведённый мною (невольно) эксперимент разметил
часть таких граблей, которые для тех, кто постоянно занимается
развитием dosc, не слишком очевидны ;-)

> >
> > > > Объясню чуть подробнее. Проводимый мною сейчас эксперимент
> > > > достаточно чист, а именно: Поскольку у меня недавно умер винт, то
> > > > пришлось преустанавливаться полностью. Сейчас моя система это
> > > > Master2.2+updates в конфигурации по умолчанию, плюс немногочисленные
> > > > и уже указанные ранее пакеты из Сизифа, касающиеся xml.
> > >
> > >   Если честно, меня смущает использование в производстве самой
> > >   последней
> > > версии ПО.
> >
> > Аналогично. По тому и не спешу обычно обновляться без явной
> > необходимости, что занимаюсь производством.
> >
> > > Может, жёстко зафиксировать версии?
> >
> > Очень может быть и так.
> 
>   Если честно, я бы предпочёл ещё более кардивальное решение: локальное
> окружение для создания документации, безо всяких зависимостей от системы.
> См. "In Defense of Not-Invented-Here Syndrome" by Joel Spolsky:
> http://joelonsoftware.com/articles/fog0000000007.html

Хмм... получается эдакий hasher но не для rpm а для документации
из xml ;-)
В принципе - да поддерживаю, это наверняка упростит
производство. Кроме того мы развязываем по версиям производство
документов и производство Сизифа.
Однако такие вещи нужно таки заворачивать в rpm дабы все
участники производственного цикла подготовки докуметации имели
строго одинаковые сборочные среды. Иначе всеравно получим то,
что сегодня - у всех срезы Сизифа разной давности и начинается
полный разброд по багам :-\
 
> > По крайней мере есть смысл огласить "вилку" младших и старших
> > версий всех компонентов, необходимых и пригодных для работы в
> > docs.
> 
> > Подозреваю, что эта информация должна поддерживаться в
> > актуальном состоянии где то в:
> > http://docs.altlinux.ru/alt/devel/ch03.html
> 
>   Вот с этим очень сложно: я не уверен, что можно внести изменения
> в документ и сразу выложить актуальную версию. Кроме того, я
> предпочёл бы идеалогически неверную, но удобную WiKi.
> 
> >
> > --
> > Vlasenko Oleg.
> > Technical support department ALT Linux Team.
> > mailto:cornet на altlinux.ru
> > _______________________________________________
> > docs mailing list
> > docs на altlinux.ru
> > http://www.altlinux.ru/mailman/listinfo/docs
> >
> 
> --
> Oleg
> _______________________________________________
> docs mailing list
> docs на altlinux.ru
> http://www.altlinux.ru/mailman/listinfo/docs

-- 
Vlasenko Oleg.
Technical support department ALT Linux Team.
mailto:cornet на altlinux.ru