[docs] Re: on olinking

[Vitaly Ostanin]

On Mon, 17 Nov 2003 14:39:11 +0300
"Oleg A. Paraschenko" <olpa на xmlhack.ru> wrote:

<skipped/>

>   Я правильно понимаю, что docs.xml должен выглядеть так:
> 
> ---------
> <!DOCTYPE targetset SYSTEM 
> "/usr/share/xml/docbook/xsl-stylesheets/common/targetdatabase.
> dtd"
> >
> 
> <targetset>
>   <document targetdoc="admin">
>     <xi:include 
>       href="target.db"  
>       xmlns:xi="http://www.w3.org/2001/XInclude"/>
>   </document>
>   <document targetdoc="devel">
>     <xi:include 
>       href="../devel/target.db"  
>       xmlns:xi="http://www.w3.org/2001/XInclude"/>
>   </document>
> </targetset>
> --------
> 
>   ?

Примерно так.

> > > > >   Предлагаю такой подход к обработке olink-ссылок:
> > > > > 
> > > > > * на этапе тюнинга, для каждой olink-ссылки:
> > > > >     если targetptr указывает на id, существующий в
> > > > >     самом документе,
> > > > >       то olink-ссылка превращается в обычную
> > > > >       xref-ссылку
> > > > >   (для реальных книг, думаю, должно быть в 99.9%
> > > > >   случаев);
> > > > 
> > > > Зачем?
> > > 
> > >   Потому что для большинства итоговых документов попадание
> > >   должно
> > > быть 100%, и тогда пляски с OLINKING=yes, созданием
> > > targetsets и прочим убираются.
> > 
> > Targetsets нужны ещё и для независимой пересборки части
> > документации. То есть admin может собираться отдельно от
> > install, но содержать ссылки на него.
> 
>   Или включать его.

Это вряд ли.

> > Наличие битых ссылок нужно проверять в любом случае.
> > 
> > olink не обязательно преобразовывается в xref - это может
> > быть и link, а дублировать логику работы с olink из
> > оригинальных стилей- лишняя работа.
> 
>   А ведь действительно -- лишняя работа. Замечание принято. Эта
> функциональность должна быть непосредственно в
> docbook-style-xsl. Надо будет Бобу написать.

Скепсис - раньше DocBook V5 такой функциональности не будет, и
скорее всего, что не будет вообще. Она не вписывается в идеологию
DocBook, а локальные фичи предлагается делать через customization
layers.

> > > > > * базу данных ссылок вести вручную (да, именно вручную,
> > > > > никакой
> > > > >   автоматики). Учитывая, что межбуквенных ссылок должно
> > > > >   быть мало, это не должно быть большой проблемой.
> > > > 
> > > > Это была бы большая проблема.
> > > 
> > >   На данный момент у нас межкнижных ссылок -- 0 штук. Не
> > >   думаю, что их число будет стремительно расти.
> > 
> > Стремительно, конечно, не будет. Но мне бы не хотелось
> > допускать то, что потом может оказаться ошибкой дизайна.
> 
>   Именно поэтому предлагаю устроить развлечение: я буду
>   придумывать противоречия и проблемы, а ты объяснять, почему
>   их нет.

У меня это развлечение каждый день с 9.30 до 20.00 :) Предлагаю
лучше снова выбраться в Морфей.

<skipped/>

> > > > Чтобы менять семантику olink, нужны веские причины.
> > > 
> > >   В данном случае семантика уже поменена, ибо сейчас база
> > >   olink-ссылок
> > > создаётся не из тех документов, в которые ведут ссылки, а
> > > из самого документа, из которого ведут ссылки.
> > 
> > Это не так. База создаётся (должна создаваться) для каждого
> > раздела независимо.
> 
>   Я правильно понимаю, что на самом деле "для каждого раздела"
>   -- это "для каждой бумажной книжки"?

Я имею в виду, что в $CVSROOT есть несколько каталогов с
документами, разбитыми по тематике - admin, user, install,
junior. Каждый из них я называю отдельным разделом.

Готовые книги (бумажные и html-версии) собираются (должны
собираться) из фрагментов одного или нескольких разделов. Отсюда
и books/junior-2.2 и т.п.

> > > * Это несколько неочевидно, так как собирать надо не так
> > > как сейчас.* Предложенная замена "olink" на "xref" делает
> > > явным и понятным, что происходит на самом деле.
> > 
> > Хорошо, пусть будет замена, но не вместо, а дополнительно к
> > текущей схеме - они не конфликтуют. Идёт?
> 
>   Нет, ни в коем случае. Две похожие "гениальные" идеи
>   одновременно --
> это ужасно. 

Это совершенно нормально. Просто надо сделать две реализации, тем
более, что это несложно и бесконфликтно. А потом посмотреть,
какая выживет :)

> Кроме того, я уже понял, что замену на "xref" надо
> вводить в родные стили docbook.

Они слишком консервативны. Но попробовать можно :)

В общем, итог - я против убийства текущей схемы, но не против
добавления новой.

<skipped/>

-- 
Regards, Vyt
mailto:  vyt на vzljot.ru
JID:     vyt на vzljot.ru
----------- следущая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : отсутствует
Тип     : application/pgp-signature
Размер  : 189 байтов
Описание: отсутствует
Url     : /pipermail/docs/attachments/20031117/cb826ff6/attachment.bin