使用DITA OT Epub插件更改epub输出中的xhtml主题文件名

时间:2018-05-17 09:37:10

标签: xml xslt-2.0 epub dita dita-ot

我需要使用EPUB DITA OT插件更改EPUB输出中的主题文件名:

我的Ditamap文件:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE pubmap
  PUBLIC "urn:pubid:com.sam.doctypes:dita:pubmap" "pubmap.dtd">
<pubmap xml:lang="en-US">
  <pubtitle>
    <mainpubtitle outputclass="book">Sample Word</mainpubtitle>
  </pubtitle>
  <topicref href="topics/topic_1.dita">
    <topicmeta>
      <navtitle>Ram-Files-Raj (RFR)</navtitle>
      <metadata/>
    </topicmeta>
  </topicref>
  <topicref href="topics/topic_2.dita">
    <topicmeta>
      <navtitle>Files-Sampletitle (FST)</navtitle>
      <metadata/>
    </topicmeta>
  </topicref>
</pubmap>

我的topic_1.dita文件

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE topic
  PUBLIC "urn:pubid:com.sam.doctypes:dita:topic" "topic.dtd">
<topic id="topic_1" xml:lang="en-US" outputclass="Ram-Files-RajRFR"><title>Ram-Files-Raj (RFR)</title></topic>

我的topic_2.dita文件

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE topic
  PUBLIC "urn:pubid:com.sam.doctypes:dita:topic" "topic.dtd">
<topic id="topic_2" xml:lang="en-US" outputclass="Files-SampletitleFST"><title>Files-Sampletitle (FST)</title></topic>

使用DITA OT EPUB插件中的以下模板更改文件名

<xsl:template match="*[df:class(., 'topic/topic')]" mode="generate-content">
    <xsl:param name="doDebug" as="xs:boolean" tunnel="yes" select="false()"/>
    <!-- This template generates the output file for a referenced topic.
      -->
    <!-- The topicref that referenced the topic -->
    <xsl:param name="topicref" as="element()?" tunnel="yes"/>    
    <!-- Result URI to which the document should be written. -->
    <xsl:param name="resultUri" as="xs:string" tunnel="yes"/>


    <xsl:if test="$doDebug">
      <xsl:message> + [DEBUG] generate-content: handling topic <xsl:value-of select="name(.)"/>...</xsl:message>
      <xsl:message> + [DEBUG] generate-content:    Generating base HTML using default-mode HTML generation....</xsl:message>
    </xsl:if>
    <xsl:variable name="htmlNoNamespace" as="node()*">
      <xsl:apply-templates select="." mode="map-driven-content-processing">
        <xsl:with-param name="topicref" select="$topicref" as="element()?" tunnel="yes"/>
      </xsl:apply-templates>      
    </xsl:variable>
    <xsl:if test="$doDebug">
      <xsl:message> + [DEBUG] generate-content:    Generating XHTML from base HTML...</xsl:message>
    </xsl:if>
    <xsl:variable name="xhtml" as="node()*">
      <xsl:apply-templates select="$htmlNoNamespace" mode="html2xhtml">
        <xsl:with-param name="topicref" select="$topicref" as="element()?" tunnel="yes"/>   
        <xsl:with-param name="resultUri" as="xs:string" tunnel="yes" select="$resultUri"/>
      </xsl:apply-templates>
    </xsl:variable>
    <xsl:if test="$doDebug">
      <xsl:message> + [DEBUG] xhtml:
<xsl:sequence select="$xhtml"/></xsl:message>
    </xsl:if>
    <xsl:message> + [INFO] Writing topic <xsl:value-of select="$topicref/@href"/> to HTML file "<xsl:sequence select="$resultUri"/>"...</xsl:message>
    <xsl:result-document format="html5" 
      href="{$resultUri}" 
      exclude-result-prefixes="opf">
      <xsl:sequence select="$xhtml"/>
    </xsl:result-document>
  </xsl:template>

<xsl:template match="*[df:isTopicRef(.)]" mode="generate-content">
    <xsl:param name="doDebug" as="xs:boolean" tunnel="yes" select="false()"/>
    <xsl:param name="rootMapDocUrl" as="xs:string" tunnel="yes"/>

<!--    <xsl:variable name="doDebug" as="xs:boolean" select="true()"/>-->

    <xsl:if test="$doDebug">
      <xsl:message> + [DEBUG] Handling topicref to "<xsl:sequence select="string(@href)"/>" in mode generate-content</xsl:message>
    </xsl:if>
    <xsl:variable name="topic" select="df:resolveTopicRef(.)" as="element()*"/>
    <xsl:choose>
      <xsl:when test="not($topic)">
        <xsl:message> + [WARNING] generate-content: Failed to resolve topic reference to href "<xsl:sequence select="string(@href)"/>"</xsl:message>
      </xsl:when>
      <xsl:otherwise>
        <xsl:variable name="topicResultUri" 
          select="htmlutil:getTopicResultUrl($outdir, root($topic), $rootMapDocUrl, $doDebug)"
          as="xs:string"
        />
        <!-- Do href fixup before doing full default-mode processing: -->
        <xsl:variable name="tempTopic" as="document-node()">
          <xsl:document>
            <xsl:apply-templates select="$topic" mode="href-fixup">
              <xsl:with-param name="topicResultUri" select="$topicResultUri"
                tunnel="yes"/>                           
              <xsl:with-param name="topicref" as="element()" select="." tunnel="yes"/>
            </xsl:apply-templates>
          </xsl:document>
        </xsl:variable>
        <!-- Apply templates in default mode to the topic with fixed up hrefs: -->
        <xsl:apply-templates select="$tempTopic" mode="#current">
          <xsl:with-param name="topicref" as="element()" select="." tunnel="yes"/>
          <xsl:with-param name="resultUri" select="$topicResultUri"
           tunnel="yes"/>
        </xsl:apply-templates>
      </xsl:otherwise>
    </xsl:choose>    
  </xsl:template>

输出主题文件名在epub输出中我得到&#34; topic_1_d76.xhtml&#34;,&#34; topic_2_d77.xhtml&#34;,等等...... 但我需要在epub输出中使用主题标题作为文件名&#34; Ram_Files_Raj_RFR.xhtml&#34;,&#34; Files_Sampletitle_FST.xhtml&#34;。

请就此问题向我提出建议。

先谢谢

1 个答案:

答案 0 :(得分:1)

函数htmlutil:getResultTopicBaseName()生成从主题生成的结果HTML文件的文件名。

此函数使用模式get-result-topic-base-name中的模板(如果您尚未明确启用单目录文件组织策略),其基本实现是:

<xsl:template match="/" mode="get-result-topic-base-name">
<xsl:param name="topicref" tunnel="yes" as="element()?"/>
<xsl:param name="topicUri" as="xs:string"/>

<!-- Default template for organizational strategies other than single-dir -->
<xsl:variable name="baseName"  as="xs:string">      
  <xsl:choose>
    <xsl:when test="string($topicref/@copy-to) != ''">
      <xsl:sequence select="relpath:getNamePart($topicref/@copy-to)"/>
    </xsl:when>
    <xsl:otherwise>
      <xsl:sequence select="relpath:getNamePart($topicUri)"/>  
    </xsl:otherwise>
  </xsl:choose>
</xsl:variable>
<xsl:sequence select="$baseName"/>
</xsl:template>

默认情况下,只使用@ copy-to或@href值。

您可以覆盖此模板以执行您想要的操作,例如,使用主题标题。

如果你使用的是OT 1.8.5,另一个选择是扩展Adjust Copy-to插件,将@ copy-to属性设置为你想要的文件名。这具有将这些文件名应用于任何OT进程的效果,而不仅仅是EPUB,但要求您使用D4P特定的预处理自定义,D4P提供的转换(EPUB,D4P HTML2,D4P HTML5)使用该自定义。 / p>

Adjust Copy-to插件(当前)不能与2.x和3.x Open Toolkit一起使用,因为预处理已经在很大程度上被重写,我没有机会更新EPUB插件。我目前正在努力更新EPUB转换以使用OT 2.5.4和3.x。