Для того, чтобы МойнМойн мог отображать страницы DocBook, необходимо выполнить шаги, указанные ниже. После их выполнения станет возможно писать и сохранять файлы DocBook в МойнМойн и просматривать их в виде HTML. Важно отметить, что обработка страниц DocBook может занимать несколько секунд (она выполняется при сохранении страницы).
Установка поддержки DocBook
- Установите 4suite и разрешите применение XSLT, см. выше
Откройте список файлов XSLТ для DocBook на SourceForge и скачайте самый свежий архив. Он содержит файлы XSLT, необходимые для генерации HTML.
Распакуйте архив и скопируйте каталоги html, lib, common и файл VERSION в каталог, доступный для записи МойнМойн (например, в каталог data)
После обновления 4suite необходимо удалить файл db_compiled.dat в его каталоге (если он существует).
Отредактируйте параметр docbook_html_dir конфигурации вики, задав в качестве значения каталог, созданный на предыдущем шаге (это каталог, где содержится, например, docbook.xsl)
Теперь парсер DocBook должен быть доступен для использования
Использование DocBook
Правка файлов DocBook осуществляется также, как и в любом другом окружении. Если необходимо добавить ссылку на другую страницу вики, достаточно просто написать ВикиИмя в тексте. Страницы, которые доступны только по свободным ссылкам ([[...]]) пока не могут быть связаны напрямую.
Файлы в формате DocBook или предваряются инструкцией #format docbook, указываемой на первой строке, или же парсер указывается, как в примере ниже:
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"> <book> <bookinfo> <author> <firstname>Александр</firstname> <surname>Привалов</surname> </author> <copyright> <year>2005</year> </copyright> </bookinfo> <chapter> <title>Заголовок главы</title> <sect1> <title>Заголовок раздела</title> <para>Это — абзац.</para> <para> <emphasis role="bold"> Этот абзац набран шрифтом с полужирным начертанием. </emphasis> </para> </sect1> </chapter> </book>
Замечание: Для просмотра примера выше необходимо установить DocBook, как описано ранее.