asciidoctor-dita-topic 1.1.4 → 1.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c8500891ad21dc6be419992bbb3ce0746bfb3c5e96f4cdb5c0faea28cd00fe59
-  data.tar.gz: df920f7ae7d468b8e981a05d1a16c932e2fcd31d9e22d22b5e7406cef880ca01
+  metadata.gz: 21b3a4a2065dec2230fd5c554325dc804cc37b69a95caa246ff3dbf43c5ecd9d
+  data.tar.gz: 57a4b6a9275e71b8388d4cadb10e99a25d566ba106871fc02f2c965f4fd042b7
 SHA512:
-  metadata.gz: d788246489a2ce5c11b1f293401d70efbc373c4561e266a497bee45a7de82fc20cae10a3cf3dcded6635e1054279a51250405d36fb6bd219c7602636d6ed2aa9
-  data.tar.gz: 9d4a9e9638f983baf60e401d3d4477c29036d028a12c751acd9e6e88527bcb97238838cccd9234cb750b560b76b23693bfa50726b483c853355eedaee0bf5f52
+  metadata.gz: 5ed40b0ee61e31a1d03880b3bcbd20c831dff0e9204acd7b7e334ea3d22dde069fd8e7e2fae737e06e59a86d948e905ec698b381d5709a500284d6bdf31ab903
+  data.tar.gz: 7387aa7846f42eb746e0f37b2484052f259f2e64aa4578fee5fb9bacb3563b49020279ff0c8cafb1f6dbad8831b66ff1aba0b388b1d4f889f2ba8522e206a6aa

data/README.adoc

@@ -166,6 +166,8 @@ Block titles not supported in DITA:: AsciiDoc allows you to include `._Block tit
 
 Callouts not supported in DITA:: AsciiDoc allows you to use `<1>`, `<2>`, `<3>` and so on in verbatim blocks to add annotations to the specific lines. Unlike AsciiDoc, DITA does not provide a direct equivalent for this functionality. `dita-topic` issues this warning when the `-a dita-topic-callouts=off` option is specified and these annotations are present in the converted AsciiDoc file.
 
+Examples not supported within _object_ in DITA:: AsciiDoc allows you to use an example block anywhere in the document. Unlike AsciiDoc, DITA only allows examples to appear directly in the topic body. `dita-topic` issues a warning whenever an example is nested in another AsciiDoc element.
+
 Floating titles not supported in DITA:: AsciiDoc allows you to use floating titles anywhere in the document. Unlike AsciiDoc, DITA does not support floating titles. `dita-topic` issues this warning when the `-a dita-topic-titles=off` option is specified and a floating title is present in the converted AsciiDoc file.
 
 Inline breaks not supported in DITA:: AsciiDoc provides multiple ways to insert line breaks in paragraphs, such as inserting `{nbsp}+` at the end of the line or specifying `[%hardbreaks]` on the line preceding the paragraph. Unlike AsciiDoc, DITA does not provide direct equivalent for this functionality. `dita-topic` issues this warning whenever an inline line break is present in the converted AsciiDoc file and places the `<!-- break -\->` comment in the output file to mark its place.
@@ -174,7 +176,7 @@ Nesting of sections not supported in DITA:: AsciiDoc allows you to nest sections
 
 Page breaks not supported in DITA:: AsciiDoc allows you to use `<<<` on a separate line to enforce a page break in output formats that support it. Unlike AsciiDoc, DITA does not support page breaks. `dita-topic` issues this warning whenever a page break is present in the converted AsciiDoc file and places the `<p outputclass="page-break"></p>` in the output file to mark its place.
 
-Possible invalid reference: _reference_:: AsciiDoc allows you to cross reference by using an ID no matter if this ID is defined within or outside of the converted document. Unlike AsciiDoc, DITA requires both the target ID and the ID of the target topic to be included in the cross reference if the reference leads outside of the current file. As `dita-topic` is meant to be run on individual AsciiDoc files, it does not have access to information from referenced files during conversion. `dita-topic` issues this warning whenever a cross reference is present in the converted AsciiDoc file.
+Possible invalid reference: _reference_:: AsciiDoc allows you to cross reference by using an ID no matter if this ID is defined within or outside of the converted document. Unlike AsciiDoc, DITA requires both the target ID and the ID of the target topic to be included in the cross reference if the reference leads outside of the current file. As `dita-topic` is meant to be run on individual AsciiDoc files, it does not have access to information from referenced files during conversion. `dita-topic` issues this warning whenever the cross reference target is not present in the converted AsciiDoc file.
 
 STEM support not implemented:: AsciiDoc provides multiple ways to insert Science, Technology, Engineering and Math (STEM) expressions in the document, including the `\stem:[_formula_]` inline macro and the `[stem]` delimited block. `dita-topic` does not implement this feature and issues this warning whenever such an expression is present in the converted AsciiDoc file.
 

data/lib/dita-topic.rb

@@ -222,6 +222,12 @@ class DitaTopic < Asciidoctor::Converter::Base
   end
 
   def convert_example node
+    # Issue a warning if the example is nested:
+    unless (parent = node.parent.context) == :document
+      logger.warn "#{NAME}: Examples not supported within #{parent} in DITA"
+    end
+
+    # Return the XML output:
     <<~EOF.chomp
     <example#{compose_id node.id}>
     #{node.title ? %(<title>#{node.title}</title>\n) : ''}#{node.content}
@@ -352,7 +358,7 @@ class DitaTopic < Asciidoctor::Converter::Base
     end
 
     # Return the XML entity:
-    compose_circled_number node.text.to_i
+    %(<b outputclass="callout">#{compose_circled_number node.text.to_i}</b>)
   end
 
   def convert_inline_footnote node

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: asciidoctor-dita-topic
 version: !ruby/object:Gem::Version
-  version: 1.1.4
+  version: 1.1.5
 platform: ruby
 authors:
 - Jaromir Hradilek
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-04-02 00:00:00.000000000 Z
+date: 2025-04-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: asciidoctor
@@ -90,7 +89,6 @@ metadata:
   homepage_uri: https://github.com/jhradilek/asciidoctor-dita-topic
   bug_tracker_uri: https://github.com/jhradilek/asciidoctor-dita-topic/issues
   documentation_uri: https://github.com/jhradilek/asciidoctor-dita-topic/blob/main/README.adoc
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -105,8 +103,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: A custom AsciiDoc converter that generates individual DITA topics
 test_files: []