asciidoctor-dita-topic 1.1.1 → 1.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 687ae8806b7e15e26af816a9c422c4eb9f6d641952d3322ecec1a548e3818b27
-  data.tar.gz: 1831689de933e1fb931b156f4a9d7333e4200597ac352caf8a83345b819b120e
+  metadata.gz: 172e330842b5b5f390c287fd0adfe4e51a055c669145c09a0a4b07d7a85057ba
+  data.tar.gz: 3e76bd3a36ed2954827156500d393ac982506862395fbceb30b84c075db95e72
 SHA512:
-  metadata.gz: c41f5028246471fd6f82eced7c21d15bcef16dadf480a29dc51a5089b60d0c1b8987198ae5d7bf615f377e230b736563f576fad179897bc7e0e3b95324880a1d
-  data.tar.gz: 4ab12c7fbeeb054aa08200b9c1a16163459d9a0c9bd3852a7fc348ae8943e73a4872ff1e26a634b171aaa46e2cb916d11d9b65f9c53f5f4df2b5e4a781345198
+  metadata.gz: 4f5cc15df1b03d9198a87d9996859b067a957928375a6469c8901c3850d76dc0f06f5f3e9e3ff9eb86a8f369c55bf9d7c9a9074e2937ff5798b7b9157bb4a428
+  data.tar.gz: 2986bb1e278b253df0d1d0768d695e8799191253f3527c58f8ef027159ce237e7a09e517dfa78d6cc1043d0c437ff09866848c6ddbe8db7cbb7781806c342252

data/README.adoc

@@ -1,6 +1,6 @@
 = dita-topic
 
-`dita-topic` is a custom converter for Asciidoctor that converts a single AsciiDoc file to a corresponding DITA topic. To convert the produced DITA topic to a specialized DITA concept, reference, or task, use the link:https://github.com/jhradilek/dita-custom-xslt[dita_convert Python package].
+`dita-topic` is a custom converter for Asciidoctor that converts a single AsciiDoc file to a corresponding DITA topic. To convert the produced DITA topic to a specialized DITA concept, reference, or task, use the link:https://github.com/jhradilek/dita-custom-xslt#installation[dita-convert Python package].
 
 [#install]
 == Installation
@@ -121,6 +121,18 @@ To disable this behavior, set the value of the `dita-topic-callouts` to `off`:
 $ **asciidoctor -r dita-topic -b dita-topic -a dita-topic-callouts=off _your_file_.adoc**
 ....
 
+[#abstracts]
+=== Disable abstracts
+
+By default, the `dita-topic` converter recognizes a paragraph preceded by the `[role="_abstract"]` attribute list and preserves this information by adding the `outputclass="abstract"` attribute to it in DITA. The link:https://github.com/jhradilek/dita-custom-xslt#installation[dita-convert Python package] uses this attribute to populate the `<shortdesc>` element during conversion to a specialized DITA concept, reference, or task.
+
+To disable this behavior, set the value of the `dita-topic-abstracts` to `off`:
+
+[literal,subs="+quotes"]
+....
+$ **asciidoctor -r dita-topic -b dita-topic -a dita-topic-abstracts=off _your_file_.adoc**
+....
+
 [#includes]
 === Disabling include directives
 

data/lib/dita-topic.rb

@@ -36,6 +36,9 @@ class DitaTopic < Asciidoctor::Converter::Base
     # Disable the author line by default:
     @authors_allowed = false
 
+    # Enable abstract paragraphs by default:
+    @abstracts_allowed = true
+
     # Enable callouts by default:
     @callouts_allowed = true
 
@@ -47,14 +50,20 @@ class DitaTopic < Asciidoctor::Converter::Base
     # Check if the author line is enabled:
     @authors_allowed = true if (node.attr 'dita-topic-authors') == 'on'
 
+    # Check if abstract paragraphs are enabled:
+    @abstracts_allowed = false if (node.attr 'dita-topic-abstracts') == 'off'
+
     # Check if callouts are enabled:
     @callouts_allowed = false if (node.attr 'dita-topic-callouts') == 'off'
 
     # Check if floating and block titles are enabled:
     @titles_allowed = false if (node.attr 'dita-topic-titles') == 'off'
 
-    # Check if the modular documentation content type is specified:
+    # Check if the modular documentation content type is specified; both
+    # _module-type and _content-type are deprecated, but still present in
+    # some modules:
     outputclass = ''
+    outputclass = %( outputclass="#{(node.attr '_module-type').downcase}") if node.attr? '_module-type'
     outputclass = %( outputclass="#{(node.attr '_content-type').downcase}") if node.attr? '_content-type'
     outputclass = %( outputclass="#{(node.attr '_mod-docs-content-type').downcase}") if node.attr? '_mod-docs-content-type'
 
@@ -460,8 +469,7 @@ class DitaTopic < Asciidoctor::Converter::Base
     node.items.each do |item|
       # Check if the list item contains multiple block elements:
       if item.blocks?
-        result << %(<li>)
-        result << %(<p>#{item.text}</p>)
+        result << %(<li>#{item.text})
         result << item.content
         result << %(</li>)
       else
@@ -507,7 +515,11 @@ class DitaTopic < Asciidoctor::Converter::Base
   end
 
   def convert_paragraph node
-    add_block_title %(<p>#{node.content}</p>), node.title
+    if @abstracts_allowed and (node.attr 'role') == '_abstract'
+      add_block_title %(<p outputclass="abstract">#{node.content}</p>), node.title
+    else
+      add_block_title %(<p>#{node.content}</p>), node.title
+    end
   end
 
   def convert_preamble node
@@ -691,8 +703,7 @@ class DitaTopic < Asciidoctor::Converter::Base
 
       # Check if the list item contains multiple block elements:
       if item.blocks?
-        result << %(<li>)
-        result << %(<p>#{check_box}#{item.text}</p>)
+        result << %(<li>#{check_box}#{item.text})
         result << item.content
         result << %(</li>)
       else

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: asciidoctor-dita-topic
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 1.1.2
 platform: ruby
 authors:
 - Jaromir Hradilek
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-03-17 00:00:00.000000000 Z
+date: 2025-03-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: asciidoctor