## Please edit system and help pages ONLY in the moinmaster wiki! For more
## information, please see MoinMaster:MoinPagesEditorGroup.
##master-date:Unknown-Date
##master-page:HelpOnXmlPages
#acl MoinPagesEditorGroup:read,write,delete,revert All:read
#format wiki
#language zh


<<TableOfContents(1)>>

= XML页面 & XSLT转换 =
如果你的系统中安装了[[http://4suite.org/|Python4Suite]]，那么就可以编写XML格式的页面。首先你必须在XML页面正文第一行插入"{{{<?xml ...>}}}"声明，此外你还得指定样式表（stylesheet），用于将XML转换成HTML。可以通过[[http://www.w3.org/TR/xml-stylesheet/|standard "xml-stylesheet" processing instruction]]来指定样式表，需要把包含样式表（stylesheet）的页面的名称作为"{{{href}}}"的参数。

别忘了开启XSLT转换功能，请参考HelpOnConfiguration。

详细请参照下面的例子，你也可以在XsltVersion页面看到该例子。

== 例子 ==
{{{
<?xml version="1.0" encoding="ISO-8859-1"?>

<?xml-stylesheet href="XsltVersion" type="text/xml"?>

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

   <xsl:output method="html" omit-xml-declaration="yes" indent="no"/>

   <xsl:template match="/">
     This Wiki is running an XSLT engine by
     <xsl:value-of select="system-property('xsl:vendor')"/>
     (<a href="{system-property('xsl:vendor-url')}"><xsl:value-of select="system-property('xsl:vendor-url')"/></a>)
     implementing XSLT v<xsl:value-of select="system-property('xsl:version')"/>
   </xsl:template>

</xsl:stylesheet>
}}} 

= DocBook页面 =
下面的步骤告诉你如何在MoinMoin中编写DocBook页面，并最终以HTML格式显示出来。需要注意的是这个处理过程要耗费一定的时间（在页面被保存之后）。

== 安装DocBook支持 ==
 1. 安装4suite并开启XSLT转换功能，如上所述。
 1. 到[[http://sourceforge.net/project/showfiles.php?group_id=21935&package_id=16608|DocBook files at SourceForge]]下载最新版的DocBook包，它包括了生成HTML所必须的XSLT文件。
 1. 把DocBook包里的{{{html}}}, {{{lib}}}, {{{common}}}目录和{{{VERSION}}}文件全部拷到一个MoinMoin具有写权限的目录，比如{{{data}}}目录。
  * 如果升级了4suite，你必须把{{{db_compiled.dat}}}（如果存在的话）从目录中删除。
 1. 编辑你的wiki配置，把属性{{{docbook_html_dir}}}指向上一步中所创建的目录（也就是包含{{{docbook.xsl}}}等文件的目录）。
 1. 现在你应该可以使用DocBook解析器了。

=== 使用DocBook ===
你只要照平常在其他环境中所做的那样来编写DocBook就可以了。如果你想要插入到其他维基页面的链接，只需要简单地插入WikiName就行了。注意，那些在通常维基语法中需要使用{{{["..."]}}}来链接的页面还不能在DocBook文件中直接链接。

DocBook标记可以在DocBook页面的的第一行以{{{#format docbook}}} 方式出现，也可以在维基页面中以如下方式出现：
{{{#!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>Bernd</firstname>
<surname>Le Pain</surname>
</author>
<copyright>
<year>2005</year>
</copyright>
</bookinfo>
<chapter>
<title>This is a title of a chapter</title>
<sect1>
<title>This is a title of a section</title>
<para>This is a paragraph.</para>
<para>
<emphasis role="bold">
This is a paragraph in bold.
</emphasis>
</para>
</sect1>
</chapter>
</book>
}}}

注意，你需要照上面的方法安装好DocBook后，才能使这个例子正常工作。

此页的英文版本：HelpOnXmlPages
