3. XML-редакторы «WYSIWYG»

Модули, управляемые Borges'ом, не разбираются напрямую другими программами, потому что они должны вызываться из мастер-файла, в котором находятся все необходимые ссылки на DTD и внешние объекты. Вот почему Borges предоставляет средство для добавления необходимой информации в эти файлы модулей, чтобы любой редактор XML мог открыть их. После того, как файл отредактирован, другая операция преобразовывает файл модуля обратно в подходящий для Borges формат.

Эта процедура была протестирована на XML-редакторе XMLmind и должна работать с другими редакторами XML, такими как Morphon и многими другими редакторами.

  1. Экспортирование определённого модуля

    Это выполняется в командной строке:

    make -C modules/xx/ имя_модуля.edit.noents.xml

    замените xx и имя_модуля своим языком и названием модуля, который вы хотите отредактировать. При этом будет сгенерирован файл (modules/xx/имя_модуля.edit.noents.xml), пригодный для редактирования любым редактором XML, при условии корректной настройки конфигурационных файлов (см. Раздел 1.1.5, «conf/repository.xml»).

  2. Редактирование модуля

    Просто откройте в своём редакторе полученный в предыдущей операции файл (modules/xx/имя_модуля.edit.noents.xml).

    Предостережение

    Существует одно важно ограничение, которое нужно учитывать: т.к. некоторые редакторы неправильно обрататывают внешние объекты, последние «экранируются», чтобы они, таким образом, не опознавались редактором как объекты. Например, объект &borges; , будучи найденным в файле XML, будет преобразован в &borges; в подготовленном для редактирования файле. Таким образом он будет выглядеть как &borges; в редакторах WYSIWIG и не будет заменён значением объекта. При использовании объектов в таких редакторах должен использоваться такой же синтаксис.

    По окончании редактирования достаточно сохранить файл локально и перейти к следующему этапу:

  3. Импортирование модуля обратно в Borges

    Для преобразования модуля обратно в формат, совместимый с Borges, необходимо выполнить следующую команду:

    make -C modules/xx/ имя_модуля.revertedit

    при этом содержимое изменённого модуля modules/xx/имя_модуля.edit.noents.xml будет возвращено назад в modules/xx/имя_модуля.xml. Теперь существует возможность проверить модуль или отправить его на сервер CVS.