5. Замечания по установке Borges

Всё готово, так что прикладная часть Borges может быть установлена в систему куда угодно, включая домашний каталог пользователя. Также ведётся работа над тем, чтобы она могла быть установлена на других платформах кроме Mandrakelinux. Если вы попытались установить Borges в GNU/Linux и он не заработал, мы бы хотели, чтобы вы дали нам об этом знать.

5.1. Установка Borges в нестандартный каталог

Согласно «Стандартам иерархии файловой системы» при выполнении команды make install в репозитории Borges, последний устанавливает себя по умолчанию в /usr/share/Borges/. Изменение параметра DESTDIR переопределит это поведение.

Пример 7.1. Установка Borges в домашний каталог

$ make install DESTDIR=~/BORGES

5.2. Адаптация Borges к нестандартному окружению

Borges был разработан в Mandrakelinux и подразумевает наличие в определённых местах различных файлов. Первым делом необходимо обеспечить, чтобы были установлены и корректно работали все зависимости, перечисленные Раздел 1.3, «Зависимости». Если ваша переменная PATH установлена правильно, Borges должен иметь доступ к различным нужным ему исполняемым файлам.

Сейчас мы приведём обзор внешних файлов, необходимых для работы Borges.

5.2.1. Шаблоны DTD и таблицы стилей

Шаблон репозитория и образцы файлов, поставляемые с Borges, в настоящий момент ссылаются непосредственно на файлы вашей локальной файловой системы. Каталоги сейчас не используются, но никто не запрещает вам использовать их. Чтобы адаптировать пути к своей локальной конфигурации, вы должны отредактировать следующие файлы:

template/drivers/docbook-index.dsssl
template/drivers/docbook-jadetex.dsssl
template/drivers/docbook-xhtml-chunk.xsl
template/drivers/docbook-xhtml.xsl
Sample/master.top.xml

Замечание

Рекомендуется использовать ссылки URI и каталоги всякий раз, когда это возможно, чтобы создание документов работало на системах, в которых DocBook находится не там, где ожидалось.

5.2.2. Другие контрольные файлы

openjade - это утилита, используемая для преобразования SGML. Borges'у необходимо имет доступ к некоторым файлам, поставляемым вместе с openjade. Эти файлы перечислены в template/conf/DocBook.xml и их пути должны быть адаптированы к вашей локальной конфигурации. В этом файл также находится путь к скрипту DocBook collateindex.pl.

Замечание

Т.к. локальная конфигурация внутри одного проекта может изменяться от пользователя к пользователю, для них имеется возможность настроить путь к своему собственному конфигурационному файлу conf/author.xml.