<?xml version="1.0" encoding="utf-8"?><!DOCTYPE article  PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN'  'http://www.docbook.org/xml/4.4/docbookx.dtd'><article><articleinfo><title>ПомощьПоXmlСтраницам</title></articleinfo><section><title>XML-страницы и применение XSLT</title><para>Если у Вас установлен <ulink url="http://4suite.org/">Python4Suite</ulink>, то можно использовать XML-документы как страницы вики. Важно начинать подобные страницы с преамбулы «<code>&lt;?xml ...&gt;</code>» на первой строке. Также, необходимо определить таблицу стилей, которая будет использоваться для преобразования XML-документа в HTML. Это реализуется с использованием <ulink url="http://www.w3.org/TR/xml-stylesheet/">стандартной инструкции «xml-stylesheet»</ulink>, с указанием имени страницы, содержащей таблицу стилей, в атрибуте «href». </para><para>Не забудьте разрешить применение XSLT, см. <ulink url="http://research.math.uvt.ro/wiki/%D0%9F%D0%BE%D0%BC%D0%BE%D1%89%D1%8C%D0%9F%D0%BEXml%D0%A1%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D0%B0%D0%BC/wiki/%D0%9A%D0%B0%D0%BA%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%B0%D0%B8%D0%B2%D0%B0%D1%82%D1%8C#">КакНастраивать</ulink>. </para><para>Подробнее см. пример ниже, также см. страницу <ulink url="http://research.math.uvt.ro/wiki/%D0%9F%D0%BE%D0%BC%D0%BE%D1%89%D1%8C%D0%9F%D0%BEXml%D0%A1%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D0%B0%D0%BC/wiki/%D0%92%D0%B5%D1%80%D1%81%D0%B8%D1%8FXslt#">ВерсияXslt</ulink>. </para><section><title>Пример</title><programlisting format="linespecific" language="highlight" linenumbering="numbered" startinglinenumber="1"><![CDATA[<?xml version="1.0" encoding="UTF-8"?>]]>

<![CDATA[<?xml-stylesheet href="ВерсияXslt" type="text/xml"?>]]>

<methodname><![CDATA[<xsl:stylesheet]]></methodname><![CDATA[ ]]><methodname><![CDATA[version=]]></methodname><phrase><![CDATA["1.0"]]></phrase><![CDATA[ ]]><methodname><![CDATA[xmlns:xsl=]]></methodname><phrase><![CDATA["http://www.w3.org/1999/XSL/Transform"]]></phrase><methodname><![CDATA[>]]></methodname>

<![CDATA[   ]]><methodname><![CDATA[<xsl:output]]></methodname><![CDATA[ ]]><methodname><![CDATA[method=]]></methodname><phrase><![CDATA["html"]]></phrase><![CDATA[ ]]><methodname><![CDATA[omit-xml-declaration=]]></methodname><phrase><![CDATA["yes"]]></phrase><![CDATA[ ]]><methodname><![CDATA[indent=]]></methodname><phrase><![CDATA["no"]]></phrase><methodname><![CDATA[/>]]></methodname>

<![CDATA[   ]]><methodname><![CDATA[<xsl:template]]></methodname><![CDATA[ ]]><methodname><![CDATA[match=]]></methodname><phrase><![CDATA["/"]]></phrase><methodname><![CDATA[>]]></methodname>
<![CDATA[     Данная вики использует библиотеку XSLT, разработанную ]]>
<![CDATA[     ]]><methodname><![CDATA[<xsl:value-of]]></methodname><![CDATA[ ]]><methodname><![CDATA[select=]]></methodname><phrase><![CDATA["system-property('xsl:vendor')"]]></phrase><methodname><![CDATA[/>]]></methodname>
<![CDATA[     (]]><methodname><![CDATA[<a]]></methodname><![CDATA[ ]]><methodname><![CDATA[href=]]></methodname><phrase><![CDATA["{system-property('xsl:vendor-url')}"]]></phrase><methodname><![CDATA[>]]></methodname><methodname><![CDATA[<xsl:value-of]]></methodname><![CDATA[ ]]><methodname><![CDATA[select=]]></methodname><phrase><![CDATA["system-property('xsl:vendor-url')"]]></phrase><methodname><![CDATA[/>]]></methodname><methodname><![CDATA[</a>]]></methodname><![CDATA[)]]>
<![CDATA[     и реализующую XSLT версии ]]><methodname><![CDATA[<xsl:value-of]]></methodname><![CDATA[ ]]><methodname><![CDATA[select=]]></methodname><phrase><![CDATA["system-property('xsl:version')"]]></phrase><methodname><![CDATA[/>]]></methodname>
<![CDATA[   ]]><methodname><![CDATA[</xsl:template>]]></methodname>

<methodname><![CDATA[</xsl:stylesheet>]]></methodname>
</programlisting></section></section><section><title>Отображение DocBook</title><para>Для того, чтобы <ulink url="http://research.math.uvt.ro/wiki/%D0%9F%D0%BE%D0%BC%D0%BE%D1%89%D1%8C%D0%9F%D0%BEXml%D0%A1%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D0%B0%D0%BC/wiki/%D0%9C%D0%BE%D0%B9%D0%BD%D0%9C%D0%BE%D0%B9%D0%BD#">МойнМойн</ulink> мог отображать страницы DocBook, необходимо выполнить шаги, указанные ниже. После их выполнения станет возможно писать и сохранять файлы DocBook в <ulink url="http://research.math.uvt.ro/wiki/%D0%9F%D0%BE%D0%BC%D0%BE%D1%89%D1%8C%D0%9F%D0%BEXml%D0%A1%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D0%B0%D0%BC/wiki/%D0%9C%D0%BE%D0%B9%D0%BD%D0%9C%D0%BE%D0%B9%D0%BD#">МойнМойн</ulink> и просматривать их в виде HTML. Важно отметить, что обработка страниц DocBook может занимать несколько секунд (она выполняется при сохранении страницы). </para><section><title>Установка поддержки DocBook</title><orderedlist numeration="arabic"><listitem><para>Установите 4suite и разрешите применение XSLT, см. выше </para></listitem><listitem><para>Откройте <ulink url="http://sourceforge.net/project/showfiles.php?group_id=21935&amp;package_id=16608">список файлов XSLТ для DocBook на SourceForge</ulink> и скачайте самый свежий архив. Он содержит файлы XSLT, необходимые для генерации HTML. </para></listitem><listitem><para>Распакуйте архив и скопируйте каталоги <code>html</code>, <code>lib</code>, <code>common</code> и файл <code>VERSION</code> в каталог, доступный для записи <ulink url="http://research.math.uvt.ro/wiki/%D0%9F%D0%BE%D0%BC%D0%BE%D1%89%D1%8C%D0%9F%D0%BEXml%D0%A1%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D0%B0%D0%BC/wiki/%D0%9C%D0%BE%D0%B9%D0%BD%D0%9C%D0%BE%D0%B9%D0%BD#">МойнМойн</ulink> (например, в каталог <code>data</code>) </para><itemizedlist><listitem><para>После обновления 4suite необходимо удалить файл <code>db_compiled.dat</code> в его каталоге (если он существует). </para></listitem></itemizedlist></listitem><listitem><para>Отредактируйте параметр <code>docbook_html_dir</code> конфигурации вики, задав в качестве значения каталог, созданный на предыдущем шаге (это каталог, где содержится, например, <code>docbook.xsl</code>) </para></listitem><listitem><para>Теперь парсер DocBook должен быть доступен для использования </para></listitem></orderedlist><section><title>Использование DocBook</title><para>Правка файлов DocBook осуществляется также, как и в любом другом окружении. Если необходимо добавить ссылку на другую страницу вики, достаточно просто написать <ulink url="http://research.math.uvt.ro/wiki/%D0%9F%D0%BE%D0%BC%D0%BE%D1%89%D1%8C%D0%9F%D0%BEXml%D0%A1%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D0%B0%D0%BC/wiki/%D0%92%D0%B8%D0%BA%D0%B8%D0%98%D0%BC%D1%8F#">ВикиИмя</ulink> в тексте. Страницы, которые доступны только по свободным ссылкам (<code>[[...]]</code>) пока не могут быть связаны напрямую. </para><para>Файлы в формате DocBook или предваряются <ulink url="http://research.math.uvt.ro/wiki/%D0%9F%D0%BE%D0%BC%D0%BE%D1%89%D1%8C%D0%9F%D0%BEXml%D0%A1%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D0%B0%D0%BC/wiki/%D0%9F%D0%BE%D0%BC%D0%BE%D1%89%D1%8C%D0%9F%D0%BE%D0%98%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BA%D1%86%D0%B8%D1%8F%D0%BC#">инструкцией</ulink> <code>#format docbook</code>, указываемой на первой строке, или же <ulink url="http://research.math.uvt.ro/wiki/%D0%9F%D0%BE%D0%BC%D0%BE%D1%89%D1%8C%D0%9F%D0%BEXml%D0%A1%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D0%B0%D0%BC/wiki/%D0%9F%D0%BE%D0%BC%D0%BE%D1%89%D1%8C%D0%9F%D0%BE%D0%9F%D0%B0%D1%80%D1%81%D0%B5%D1%80%D0%B0%D0%BC#">парсер</ulink> указывается, как в примере ниже: </para><!--RAW HTML: XSLT option disabled, please look at <a href="/wiki/HelpOnConfiguration">HelpOnConfiguration</a>.--><screen><![CDATA[<!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>]]></screen><para><emphasis>Замечание:</emphasis> Для просмотра примера выше необходимо установить DocBook, как описано ранее. </para></section></section></section></article>