Глава 2. Руководство по быстрому старту

1. Установка
1.1. Где его взять?
1.2. Как мне его установить?
1.3. Зависимости
2. Первые шаги
3. Создание нового проекта
3.1. Настройка Borges для создания нового проекта
3.2. Пошаговый пример
3.3. Заключительные замечания

1. Установка

На сегодняшний момент Borges был протестирован только на Mandrakelinux. Он должен работать на любой системе Linux со всеми необходимыми зависимостями. Пожалуйста, сообщите нам о любых своих успехах или неудачах на других системах.

1.1. Где его взять?

Текущие версии публикуются на SourceForge. На нём вы найдёте различные сборки:

  • если ваша система основана на RPM, установите пакеты Borges и Borges-DocBook noarch;

  • вы можете также загрузить тарбол (Borges-*.tar.bz2).

Некоторые пакеты Borges также являются частью дистрибутива Mandrakelinux.

И, наконец, если вы любите рисковать, вы можете загрузить текущую версию с CVS со следующими параметрами: CVS_RSH=ssh и CVSROOT=:ext:anoncvs@cvs.mandrakesoft.com:/cooker. Затем вы можете загрузить модуль Borges, воспользовавшись паролем cvs.

1.2. Как мне его установить?

Просто установите RPM-пакеты или прочтите инструкции в тарболе.

Замечание

По умолчанию Borges устанавливается в /usr/share/Borges/. Если это вас не устраивает, пожалуйста, прочтите Раздел 5.1, «Установка Borges в нестандартный каталог».

1.3. Зависимости

Если вы устанавливаете Borges не из пакетов RPM, вам потребуется проверить, чтобы в вашей системе были доступны следущие программы или бибилиотеки:

  • make

  • libxslt-proc;

  • perl;

  • библиотеки perl-XML-Twig, perl-DateManip и perl-XML-LibXML;

  • обработчик графики ImageMagick для преобразования изображений;

  • редактор диаграмм xfig, если вы хотите работать с диаграммами xfig;

  • DocBook DTD XML версии 4.2 в каталоге /usr/share/sgml/docbook/xml-dtd-4.2/;

  • таблицы стилей DocBook DSSSL в каталоге /usr/share/sgml/docbook/dsssl-stylesheets/;

  • таблицы стилей DocBook XSL в каталоге /usr/share/sgml/docbook/xsl-stylesheets/;

  • openjade

  • tetex-latex

  • jadetex

Подсказка

Если при попытке установки Borges что-то идёт не так, убедитесь, корректно ли установлены эти приложения.