Ditamap trial

Signed-off-by: Jason Porter <jporter@ibm.com>

Author: Jason Porter

.github/workflows/convert-adoc.yml

@@ -33,7 +33,7 @@ jobs:
           node-version: v22.14.0
 
       - name: "Install asciidoctor and asciidoctor-dita-topic converter"
-        run: gem install asciidoctor asciidoctor-dita-topic
+        run: bundle install
 
       - name: "Install xslt3"
         run: npm install xslt3
@@ -49,7 +49,7 @@ jobs:
       # location using the same structure. rsync makes this really easy and pretty quick.
       # However, we don't want any of the git files, github files, or other build related files included.
       - name: "Copy non-adoc files to output directory"
-        run: rsync -zarv --exclude="*.adoc" --exclude=".git" --exclude=".github" --exclude "node_modules" --exclude "package.json" --exclude "package.lock" . generated-dita
+        run: rsync -zarv --exclude="*.adoc" --exclude=".git" --exclude=".github" --exclude "node_modules" --exclude "package.json" --exclude "package.lock" --exclude "Gemfile*". generated-dita
 
       # The dita-topic converter was already downloaded and installed above.
       # Using the '-r' flag instructs asciidoctor to include it and the 

Gemfile

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+gem "asciidoctor-dita-topic", git: 'https://github.com/lightguard/asciidoctor-dita-topic', branch: 'ditamap-support'
+
+# gem "rails"

breakout-subsections.xslt

@@ -13,23 +13,35 @@
     <xsl:strip-space elements="*" />
     <xsl:preserve-space elements="codeblock pre screen" />
 
+    <!-- set the language for the topic -->
+    <xsl:template match="/topic">
+        <topic id="{@id}" xml:lang="en-us">
+            <xsl:copy>
+                <xsl:apply-templates select="node()" />
+            </xsl:copy>
+        </topic>
+    </xsl:template>
+
+    <!-- body/title isn't necessary -->
+    <xsl:template match="//body/title" />
+
+    <!-- Some of our files have body/style, it isn't appropriate for dita -->
+    <xsl:template match="//body/style" />
+
     <!-- Fix up any xref links that reference adoc documents
          since adoc will not be used after the dita conversion -->
     <xsl:template match="//xref[contains(@href, '.adoc')]">
         <xref href="{replace(@href, '.adoc', '.dita')}"><xsl:value-of select="text()" /></xref>
     </xsl:template>
 
     <!--
-        Sections cannot be nested in DITA, but you can do a content reference.
-        This splits out the nested section into its own topic file and creates a conref in the original document.
+        Sections cannot be nested in DITA. This splits out the nested section into its own topic file.
         The new subsection file will be created alongside the original with the id of the current topic and the
         subsection concatenated together.
     -->
     <xsl:template match="/topic/body/section//section">
         <xsl:variable name="sub-section-filename" select="concat(ancestor::topic/@id, @id, $file-extension)" />
-        <div conref="{$sub-section-filename}">
-            <xsl:value-of select="@id" />
-        </div>
+        <!-- We are removing the content from the main document and putting it into a new one -->
         <xsl:result-document href="{$sub-section-filename}" format="sub-section">
             <topic id="{@id}">
                 <xsl:copy-of select="title" />