mywiki

XML-страницы и применение XSLT

Contents

  1. XML-страницы и применение XSLT
    1. Пример
  2. Отображение DocBook
    1. Установка поддержки DocBook
      1. Использование DocBook

Уведомление о безопасности: включение обработки XSLT посредством 4suite может быть опасным (см. справку по параметру allow_xslt для дополнительной информации).

Если у Вас установлен Python4Suite, то можно использовать XML-документы как страницы вики. Важно начинать подобные страницы с преамбулы «<?xml ...>» на первой строке. Также, необходимо определить таблицу стилей, которая будет использоваться для преобразования XML-документа в HTML. Это реализуется с использованием стандартной инструкции «xml-stylesheet», с указанием имени страницы, содержащей таблицу стилей, в атрибуте «href».

Не забудьте разрешить применение XSLT, см. КакНастраивать.

Подробнее см. пример ниже, также см. страницу ВерсияXslt.

Пример

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 
   3 <?xml-stylesheet href="ВерсияXslt" type="text/xml"?>
   4 
   5 <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
   6 
   7    <xsl:output method="html" omit-xml-declaration="yes" indent="no"/>
   8 
   9    <xsl:template match="/">
  10      Данная вики использует библиотеку XSLT, разработанную 
  11      <xsl:value-of select="system-property('xsl:vendor')"/>
  12      (<a href="{system-property('xsl:vendor-url')}"><xsl:value-of select="system-property('xsl:vendor-url')"/></a>)
  13      и реализующую XSLT версии <xsl:value-of select="system-property('xsl:version')"/>
  14    </xsl:template>
  15 
  16 </xsl:stylesheet>

Отображение DocBook

Для того, чтобы МойнМойн мог отображать страницы DocBook, необходимо выполнить шаги, указанные ниже. После их выполнения станет возможно писать и сохранять файлы DocBook в МойнМойн и просматривать их в виде HTML. Важно отметить, что обработка страниц DocBook может занимать несколько секунд (она выполняется при сохранении страницы).

Установка поддержки DocBook

  1. Установите 4suite и разрешите применение XSLT, см. выше

  2. Откройте список файлов XSLТ для DocBook на SourceForge и скачайте самый свежий архив. Он содержит файлы XSLT, необходимые для генерации HTML.

  3. Распакуйте архив и скопируйте каталоги html, lib, common и файл VERSION в каталог, доступный для записи МойнМойн (например, в каталог data)

    • После обновления 4suite необходимо удалить файл db_compiled.dat в его каталоге (если он существует).

  4. Отредактируйте параметр docbook_html_dir конфигурации вики, задав в качестве значения каталог, созданный на предыдущем шаге (это каталог, где содержится, например, docbook.xsl)

  5. Теперь парсер DocBook должен быть доступен для использования

Использование DocBook

Правка файлов DocBook осуществляется также, как и в любом другом окружении. Если необходимо добавить ссылку на другую страницу вики, достаточно просто написать ВикиИмя в тексте. Страницы, которые доступны только по свободным ссылкам ([[...]]) пока не могут быть связаны напрямую.

Файлы в формате DocBook или предваряются инструкцией #format docbook, указываемой на первой строке, или же парсер указывается, как в примере ниже:

XSLT option disabled, please look at HelpOnConfiguration.
<!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, как описано ранее.