[docs] Re: on olinking

[Oleg A. Paraschenko]

  Привет,

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

...

>   Переработанный подход:
> 
> * На этапе тюнинга olink-ссылки по возможности заменяются
>   на xref или ulink.
> * Если теги "olink" остались, то это значит, что в документе есть
> внешние
>   ссылки. Тогда:
> 
> + Документ module-targetset.xml стандартным образом подключает базы
> данных
>   ссылок внешних модулей.
> 
> + В Makefile установлена переменная OLINK_DATABASES, в которой
> перечислены
>   базы данных ссылок внешних модулей, от которых зависит
>   "module-targetset.xml", например:
> 
>     OLINK_DATABASES := ../devel/devel-targets.olinkdb \
>          ../some/where/where-targets.olinkdb
> 
> + make, прежде чем преобразовывать документ в html, fo или ещё что-то,
>   проверяет список OLINK_DATABASES и пересоздаёт базы ссылок, если они
>   устарели.
> 
>   Теперь, вроде бы, всё сходится. Делаю?
> 

  Итак, сделано.

  Обновлять надо:

$DOCS_ROOT/doc_template/
$DOCS_ROOT/xsl/common/tuning.xsl

  Текущее описание:

http://xmlhack.ru/tmp/alt/makefiles/makefiles-html-dir/ch01s05.html

  make-файлы обновлены в:

$DOCS_ROOT/admin/network/jabber-server/
$DOCS_ROOT/books/master-2.2/devel
$DOCS_ROOT/devel/cvs
$DOCS_ROOT/devel

  Интересно, что все olink-ссылки оказались фактически внутренними.
Поэтому пришлось писать пример использования межкнижных ссылок.
Он во вложении.

--

  Всплыла проблема с описанием cvs. В devel/cvs (а значит, и в
books/master-2.2/devel и devel) есть такой фрагмент:

[[quote]]
Полное описание файла <filename moreinfo="none">modules</filename>'
можно найти в разделе
<olink targetdoc="devel.cvs" targetptr="devel.cvs.admin-files.modules"/>.
[[/quote]]

  но в самом cvs.xml этот раздел закомментирован:

[[quote]]
<!--
...
  <xi:include
    href="administrative-files-manual/administrative-files-manual.xml" 
    parse="xml" 
    xmlns:xi="http://www.w3.org/2001/XInclude"/>
...
-->
[[/quote]]

  Соответственно, возникает "битая" ссылка. Что делать?


-- 
Oleg
----------- следущая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : olinking.tar.gz
Тип     : application/x-gzip
Размер  : 1906 байтов
Описание: отсутствует
Url     : /pipermail/docs/attachments/20031123/26a7875b/olinking.tar.bin