[devel] проблема: документация и alternatives

[devel] проблема: документация и alternatives

[Kirill Maslinsky]

Добрый день!

Я сейчас пытаюсь организовать гибкую модульную систему документации, 
в частности, с использованием системы альтернатив. Однако  
обнаружилась следующая неприятная особенность поведения
пакетов alt-docs-main и alt-docs-junior:

Файл /usr/share/doc/alt-docs/distrib.html
является альтернативой, указывающей на 
/usr/share/doc/alt-docs-junior-0.1/index.html

Однако все ссылки при этом оказываются битыми, поскольку предполагают, 
что текущий каталог /usr/share/doc/alt-docs-junior-0.1/, 
а броузер считает текущим /usr/share/doc/alt-docs/. 

Может ли кто-нибудь посоветовать выход из этой ситуации, не предполагающий 
указания в документации абсолютных ссылок и не предполагающий
размещения всех файлов в одном каталоге?

-- 
Kirill Maslinsky
ALT Linux Team * Documentation Project   

[devel] Re: проблема: документация и alternatives

[Vitaly Ostanin]

[-- Attachment #1: Type: text/plain, Size: 1381 bytes --]

Kirill Maslinsky пишет:
> Добрый день!
> 
> Я сейчас пытаюсь организовать гибкую модульную систему документации, 
> в частности, с использованием системы альтернатив. Однако  
> обнаружилась следующая неприятная особенность поведения
> пакетов alt-docs-main и alt-docs-junior:
> 
> Файл /usr/share/doc/alt-docs/distrib.html
> является альтернативой, указывающей на 
> /usr/share/doc/alt-docs-junior-0.1/index.html

Что имеется в виду под "альтернативой"? Symlink?

Не стоит ли всю документацию сложить в один подкаталог
/usr/share/doc/alt-docs/distrib.html (каталог и набор ссылок, 
принадлежащие базовому пакету с документацией - какой-нибудь 
alt-docs-base)
/usr/share/doc/alt-docs/junior-0.1/index.html
(дистрибутивная документация в пакете, где есть зависимость от 
alt-docs-base)
?

> Однако все ссылки при этом оказываются битыми, поскольку предполагают, 
> что текущий каталог /usr/share/doc/alt-docs-junior-0.1/, 
> а броузер считает текущим /usr/share/doc/alt-docs/. 
> 
> Может ли кто-нибудь посоветовать выход из этой ситуации, не предполагающий 
> указания в документации абсолютных ссылок и не предполагающий
> размещения всех файлов в одном каталоге?

Браузеру можно передавать путь через realpath.
Мало деталей. Как предполагается вызывать браузер?

PS Было бы удобнее видеть такие обсуждения в docs@.

-- 
Regards, Vyt
mailto:  vyt@vzljot.ru
JID:     vyt@vzljot.ru

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 252 bytes --]