[docs] Re: Images collection

[Oleg A. Paraschenko]

  Привет!

On Mon, 22 Dec 2003 19:52:12 +0300
Vitaly Ostanin <vyt на vzljot.ru> wrote:

> On Mon, 22 Dec 2003 18:30:21 +0300
> "Oleg A. Paraschenko" <olpa на xmlhack.ru> wrote:
> 
> >   Привет!
> > 
> > On Mon, 22 Dec 2003 17:23:06 +0300
> > Vitaly Ostanin <vyt на vzljot.ru> wrote:
> > 
> > > Hello, All!
> > > 
> > > В данный момент сбор картинок из документов работает только
> > > при условии, что картинки документов лежат в каталогах
> > > "images/".
> > 
> >   Сбор картинок должен работать, даже если картинки лежат не в
> >   "images".
> > Я в своё время даже порадовался, что всё так хорошо сделано. 
> 
> Как всё хорошо сделано? Сбор картинок никогда не работал без
> "images".

  Тогда я не понимаю, что хочется сделать.

  Показываю, что есть сейчас.

  Создаём каталог $DOCS/admin/xxx, в этом каталоге создаём файл xxx.xml:

----- <xxx.xml>
<xi:include href="../admin.xml"
  xmlns:xi="http://www.w3.org/2001/XInclude"/>
----- </xxx.xml>

  Говорим "make", получаем результат и проверяем его.

  Список картинок получился такой:

----- <screen>
$ cat tmp/xxx.none.imglist 
../print/cups/images/admin-print-webcups-main.png
../print/setup/images/admin-print-webcups-login.png
../print/setup/images/admin-print-choose-action.png
../print/setup/images/admin-print-choose-local.png
../print/summary/images/admin-print-gimpprint.png
----- </screen>

  В выходном html-файле ссылки на картинки такие:

----- <screen>
$ xmllint --html --format output/xxx-html-dir/index.html 2>/dev/null \
 | grep png
<img  src="images/admin-print-webcups-main.png"
  alt="Настройка CUPS через web-интерфейс"/>
<img  src="images/admin-print-webcups-login.png"
  alt="Вход на web-CUPS для администратора"/>
<img  src="images/admin-print-choose-action.png"
  alt="Диалог выбора действия"/>
<img  src="images/admin-print-choose-local.png"
  alt="Выбор локального типа подключения принтера"/>
<img  src="images/admin-print-gimpprint.png" alt="Настройка gimp-print"/>
----- </screen>

  Смотрим, а есть ли эти картинки:

----- <screen>
$ ls output/xxx-html-dir/images/
admin-print-choose-action.png  admin-print-webcups-login.png
admin-print-choose-local.png   admin-print-webcups-main.png
admin-print-gimpprint.png
----- </screen>

  Картинки на месте.

  По-моему, всё правильно.

> 
> <skipped/>
> 
> > > Так вот, какие есть правильные методы убирания относительных
> > > путей?
> > 
> >   Кажется, нет таких.
> 
> Ну почему же.
> 
> Начальный корень "/" можно отрезать. "../.." можно либо убирать,
> либо заменять на какие-нибудь каталоги вроде "up/up".

  Теоретически разделителями также могут быть '\' (dos) или ':' (mac).

> 
> При этом нужно менять пути в ссылки на картинки в самих
> документах (как это делается сейчас для ссылки вида
> "../document/images/pic.png").
> 
> Лично мне кажутся правильными варианты:
> 
> 1.
> Обрывать сборку с ошибкой при обнаружении абсолютных или ".."
> путей.
> 
> 2.
> Изменять такие пути, как описано выше.
> 
> <skipped/>
> 
> -- 
> Regards, Vyt
> mailto:  vyt на vzljot.ru
> JID:     vyt на vzljot.ru


-- 
Oleg