Changeset 99198 in vbox for trunk

Timestamp:

Mar 28, 2023 1:51:21 PM (22 months ago)

Author:

vboxsync

Message:

manual: More work on the refentry to dita converter - attempt at using non-breaking hyphens (dashes), but doesn't work for the currently PDF monospace font selection (win). bugref:10302

File:

• trunk/doc/manual/docbook-refentry-to-manual-dita.xsl (modified) (6 diffs)

trunk/doc/manual/docbook-refentry-to-manual-dita.xsl

@@ -38 +38 @@
   <xsl:preserve-space elements="*"/>
   <!-- xsl:strip-space elements="*"/ - never -->
+
+
+<!-- - - - - - - - - - - - - - - - - - - - - - -
+  parameters
+ - - - - - - - - - - - - - - - - - - - - - - -->
+<!-- Replace dashes with non-breaking dashes.
+     Note! If the monospace font used in the PDF doesn't support it,
+           then '#' shows up instead for instance.  This is currently
+           the case, so it's disabled by default. -->
+<xsl:param name="g_fReplaceHypens">false</xsl:param>
 
 
@@ -325 +335 @@
   <xsl:element name="kwd">
     <xsl:attribute name="rev">command/text</xsl:attribute>
-    <xsl:value-of select="."/>
+    <xsl:call-template name="emit-text-with-replacements"/>
   </xsl:element>
 </xsl:template>
@@ -385 +395 @@
       <xsl:element name="kwd">
         <xsl:attribute name="rev">arg=</xsl:attribute>
-        <xsl:value-of select="substring(., 1, string-length(.) - 1)"/>
+        <xsl:call-template name="emit-text-with-replacements">
+          <xsl:with-param name="a_sText" select="substring(., 1, string-length(.) - 1)"/>
+        </xsl:call-template>
       </xsl:element>
       <xsl:element name="delim">
@@ -397 +409 @@
       <xsl:element name="sep">
         <xsl:attribute name="rev">arg-space</xsl:attribute>
-        <xsl:value-of select="."/>
+        <xsl:text> </xsl:text>
       </xsl:element>
     </xsl:when>
@@ -421 +433 @@
       <xsl:element name="kwd">
         <xsl:attribute name="rev">arg</xsl:attribute>
-        <xsl:value-of select="normalize-space(.)"/>
+        <xsl:call-template name="emit-text-with-replacements">
+          <xsl:with-param name="a_sText" select="normalize-space(.)"/>
+        </xsl:call-template>
       </xsl:element>
       <xsl:if test="normalize-space(substring(., string-length(.), 1)) = ''
@@ -745 +759 @@
   <xsl:value-of select="substring($text,2)"/>
 </xsl:template>
+
+
+<!--
+ Maybe replace hypens (dashes) with non-breaking ones.
+ -->
+<xsl:template name="emit-text-with-replacements">
+  <xsl:param name="a_sText" select="."/>
+  <xsl:choose>
+    <xsl:when test="$g_fReplaceHypens = 'true' or $g_fReplaceHypens = 'yes'">
+      <xsl:message terminate="yes">wtf?</xsl:message>
+      <xsl:call-template name="str:subst">
+          <xsl:with-param name="text"    select="$a_sText"/>
+          <xsl:with-param name="replace">-</xsl:with-param>
+          <xsl:with-param name="with">‑</xsl:with-param> <!-- U+2011 / &#8209; -->
+      </xsl:call-template>
+    </xsl:when>
+    <xsl:otherwise>
+      <xsl:value-of select="$a_sText"/>
+    </xsl:otherwise>
+  </xsl:choose>
+</xsl:template>
+
 
 <!--