需要帮助理解来自DITA-OT xsl的xsl导入语句

Question

声明如下：

<xsl:import href="plugin:org.dita.xhtml:xsl/dita2html-base.xsl"/>

我是XSL的新手。我知道href属性需要一个URI，但是在上面的语句中，href值是如何解析为URI的。这段代码是DITA-OT中xhtml插件xsl的一部分。有多个这样的语句。这些是根目录中的相对路径吗？DITA-OT代码如何解析这些路径？

Answer 1

如果您查看您的DITA-OT的根安装文件夹，您将发现一个名为catalog-tua.xml的文件。这是一个XML目录，旨在为XML实体提供解析方案。摘自XML目录规范的摘要：

此OASIS标准定义了将外部标识符和任意URI引用映射到URI引用的实体目录。

打开目录-tua.xml文件，并搜索plugin:org.dita.xhtml。你会发现这个条目：

<rewriteURI uriStartString='plugin:org.dita.xhtml:' rewritePrefix='plugins/org.dita.xhtml/'/>

因此，任何以<xsl:import href="...">开头的引用uri (以及<xsl:include href="...">和document()函数)都将被“重定向”文件夹plugins/org.dita.xhtml/，以便在您的示例中搜索相对于DITA安装文件夹的plugins/org.dita.xhtml/xsl/dita2html-base.xsl文件。

，但是这个目录是如何使用的？

例如，在$DITAOT_DIR$\plugins\org.dita.xhtml\build_general.xml中(它在DITA-OT中广泛使用，因此可能会在几乎所有的build_xxx.xml文件中找到这些说明)，您会发现如下所示：

<xslt basedir="${dita.temp.dir}" destdir="${output.dir}" includesfile="${dita.temp.dir}${file.separator}${fullditatopicfile}" reloadstylesheet="${dita.xhtml.reloadstylesheet}" classpathref="dost.class.path" extension="${out.ext}" style="${args.xsl}" filenameparameter="FILENAME" filedirparameter="FILEDIR">

  <!-- A huge bunch of parameters comes here ... -->
  <param name="[...]" expression="[...]"></param>

  <xmlcatalog refid="dita.catalog"></xmlcatalog>
</xslt>

这意味着使用目录调用XSL转换(<xslt>这里是蚂蚁任务)，该目录将为转换期间所需的所有资源提供适当的URI映射。显然，dita.catalog是对其他地方声明的目录的引用。

打开$DITAOT_DIR$\plugins\org.dita.basebuild_init.xml，您会发现以下内容：

<xmlcatalog id="dita.catalog">
  <catalogpath path="${dita.plugin.org.dita.base.dir}/catalog-dita.xml"/>
</xmlcatalog>

它指向开始时已打开的XML目录。