asciidoctor-external-callout 1.1.4 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 92129f0b6fe96367004f4aa8e3f44b8bdf1182e56b07f296bb1d341a9568c7a1
-  data.tar.gz: c342a82f9630d128c38d1b87a802aa8a59791dc4666576cea6ced8ccea99aaae
+  metadata.gz: 9071bcc8bd5b3d881297e12f8a9f27cb9220dd4633584f35aa537a33b2a1ffcc
+  data.tar.gz: 6e1e73370eb5ee7df1c5128f0178975ba30852c69b450fb0cb02e5ca105db3a6
 SHA512:
-  metadata.gz: 6c292169bea665e64331fbd2a9e473860d26845c953c8fa64666b10a262c205cd978dc786ec31584df864c04fa59c0301ad2d00e8db218dff033ecd9320baad1
-  data.tar.gz: 2d571d81ea89b61250050c64ecdf6f7b94b18ca60ce9653c294d1c95fdd8fe824807791d0e98e82fa9026571569dba93daaa5a26ce439be96517ea02e6ef1888
+  metadata.gz: a62d43ad6fee410aa7d71862f71bb28ad67e12a44d102fce91ea5130c19b9ac14b5fbe905278eb9aaf6a2d39e347f99f8caadf68ae3c737119086ab17902455a
+  data.tar.gz: 2a0671db148dd4c7e855fbd5e00a87c885167a31716fa387810e1cacc0368c9b4d0af3131b5b26fbf23834c40c74a4dd5fe579f13638524e37755f598a4dc668

data/.gitignore

@@ -7,10 +7,8 @@
 /spec/reports/
 /tmp/
 /.idea
-**/sample.html
-**/sample_global_search.html
-**/callout-list-block-sample.html
-**/sample.pdf
+/test/*.html
+/test/*.pdf
 *.gem
 /Gemfile.lock
 /.asciidoctor

data/CHANGELOG.md

@@ -2,10 +2,14 @@
 
 Record of bug fixes, enhancements, and changes.
 
+## [1.2.0] – 2022-07-30
+
+### Added
+- If you add the role `[calloutlist]` to an ordered list then it will be styled to look like a callout list. This allows you to add callouts to annotated images etc. 
+
 ## [1.1.3] – 2022-07-07-16
 
 ### Fixed
-
 - The global and case-insensitive flags (ig) are now parsing correctly: using ii or gg will cause prevent the callout block from being processed. Thanks to Hakim Cassimally for finding the bug.
 - Escaped slash characters were not being processed in the search.  Thanks to Hakim Cassimally for finding the bug.
 

data/README.md

@@ -70,6 +70,14 @@ Using the text search method means that the location of the callout will move wi
 **@/_text_/gi**
 : And of course, you can combine the two, though I'm not sure why you'd want to.
 
+## Standalone callout lists
+You can create a standalone callout list by adding the `calloutlist` role to an ordered list. This simply styles the list to make it look like a list of callouts so you can use it as a reference to annoted images etc.
+```asciidoc
+[calloutlist]
+. This list can be used to add references to annotated images
+. The list will look like a standard callout list.
+```
+
 ## Installation
 
 Add this line to your application's Gemfile:

data/lib/asciidoctor-external-callout.rb

@@ -18,6 +18,8 @@ Asciidoctor::Extensions::register do
   CALLOUT_SOURCE_BLOCK_ROLE ||= 'external-callout-block'
   CALLOUT_ORDERED_LIST_ROLE ||= 'external-callout-list'
 
+  STANDALONE_CALLOUT_LIST_STYLE ||= 'calloutlist'
+
   LOCATION_TOKEN_RX ||= /@(\d+)|(@\/(?:\\\/|[^\/])+?\/[ig]{0,2})/
   LOCATION_TOKEN_ARRAY_RX ||= /^(@\d+|@\/(?:\\\/|[^\/]|)+?\/[ig]{0,2})((\s+@\d+)|(\s+@\/(?:\\\/|[^\/]|)+?\/[ig]{0,2}))*$/
 
@@ -33,18 +35,30 @@ Asciidoctor::Extensions::register do
         # The makes sure it's the right kind of list.
         document.find_by context: :olist do |list|
 
-          if external_callout_list? list
+          # if there is as calloutlist style attached to the block
+          # then simply style the block as a colist. This will allow folk
+          # to create callout blocks that can be attached to annotated images etc.
 
-            owner_block = owning_block list
+          if list.style.include? STANDALONE_CALLOUT_LIST_STYLE
 
-            owner_block.subs.replace(owner_block.subs + [:callouts]).uniq
+            list.context = :colist
 
-            process_callouts(list, owner_block)
+          else
 
-            list.context = :colist
+            if external_callout_list? list
+
+              owner_block = owning_block list
 
-            owner_block.add_role(CALLOUT_SOURCE_BLOCK_ROLE) unless owner_block.has_role?(CALLOUT_SOURCE_BLOCK_ROLE)
-            list.add_role(CALLOUT_ORDERED_LIST_ROLE) unless list.has_role?(CALLOUT_ORDERED_LIST_ROLE)
+              owner_block.subs.replace(owner_block.subs + [:callouts]).uniq
+
+              process_callouts(list, owner_block)
+
+              list.context = :colist
+
+              owner_block.add_role(CALLOUT_SOURCE_BLOCK_ROLE) unless owner_block.has_role?(CALLOUT_SOURCE_BLOCK_ROLE)
+              list.add_role(CALLOUT_ORDERED_LIST_ROLE) unless list.has_role?(CALLOUT_ORDERED_LIST_ROLE)
+
+            end
 
           end
 

data/lib/version.rb

@@ -3,7 +3,7 @@
 module Asciidoctor
   module External
     module Callout
-      VERSION = "1.1.4"
+      VERSION = "1.2.0"
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: asciidoctor-external-callout
 version: !ruby/object:Gem::Version
-  version: 1.1.4
+  version: 1.2.0
 platform: ruby
 authors:
 - Ray Offiah
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-07-17 00:00:00.000000000 Z
+date: 2022-07-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: asciidoctor