neo4j-asciidoctor-extensions 0.0.4 → 0.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f56c5e2f8d13065832c148fb4b3724e45a2542a19062b77953b92235e675010c
-  data.tar.gz: 3129172a1921f8fb0fd666e36dff542255b5b797c5c6b68278cff728dabca7cb
+  metadata.gz: b9aa5c3d1385aa9d4dd4ac11820ffb24ab9dca9fd02b99bcffe6979031469adc
+  data.tar.gz: 129476850c9147c0fbc8accaf0309f59c787f2e4defb8a3c5ecd444a28060086
 SHA512:
-  metadata.gz: 4a348aefd8422a543a9608907e3861386078ed6004715bbd0fac40f323c856c2d30925dc43b2a7d2d5086a34b8e8fa31475248fd7b02b628a6ab051e0a943fc4
-  data.tar.gz: 7abdf4c55bab07472dc5b50f8e4891bf7555d07626d6ae0152a34d92e07f641101a95952169276de95e3994a2638d6315f0df332d6ad2530a2ad6dcc7a51ea81
+  metadata.gz: 6f0c5596adbf742abb16103642445284bb0be42720e1ed57fdc1f9cfa7322c0191261af133f2ae0c9a556696e0af2406e11157d935e5667c52793194101afe45
+  data.tar.gz: c0640a5f5a47220d006bcc2d84aca356dfdcadfb17554b1f121df9cb0aa2c81085566d0a946a8eab1842a36eda39a63b594802ce125522ad45a16062fe8f3986

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    neo4j-asciidoctor-extensions (0.0.4)
+    neo4j-asciidoctor-extensions (0.0.5)
       asciidoctor (~> 2.0.0)
       asciidoctor-pdf (= 1.5.3)
       rouge (~> 3.18.0)

data/README.adoc

@@ -1,4 +1,5 @@
 = Neo4j Asciidoctor Extensions
+:caution-caption: :fire:
 :uri-neo4j: https://neo4j.com
 
 image:https://github.com/neo4j-contrib/neo4j-asciidoctor-extensions/workflows/CI/badge.svg[CI,link=https://github.com/neo4j-contrib/neo4j-asciidoctor-extensions/actions?query=workflow%3ACI]
@@ -41,15 +42,30 @@ See below for the complete list of extensions.
 
 The Ruby gem contains 6 distinct extensions:
 
-=== `course_document_attributes`
+=== Neo4j course attributes
 
-A postprocessor that adds attributes about the course.
+A postprocessor that adds attributes about a course on the `Document`.
 
-=== `cypher_syntax_role`
+[CAUTION]
+====
+This extension is tightly coupled to the course publishing project and should not be used for other purposes
+====
+
+[source,rb]
+----
+require 'neo4j/asciidoctor/extensions/course_document_attributes'
+----
+
+=== Cypher syntax role
 
 A tree processor that adds a role on code blocks using "cypher-syntax" as a language.
 
-*Usage:*
+==== Usage
+
+[source,rb]
+----
+require 'neo4j/asciidoctor/extensions/cypher_syntax_role'
+----
 
 [source]
 ....
@@ -62,11 +78,16 @@ A tree processor that adds a role on code blocks using "cypher-syntax" as a lang
 ----
 ....
 
-=== `document_metadata_generator`
+=== Metadata generator (YAML)
 
 A postprocess that generates a metadata file (in YAML format) from a list of document attributes.
 
-*Usage:*
+==== Usage
+
+[source,rb]
+----
+require 'neo4j/asciidoctor/extensions/document_metadata_generator'
+----
 
 .file.adoc
 [source,adoc]
@@ -79,7 +100,7 @@ A postprocess that generates a metadata file (in YAML format) from a list of doc
 ----
 
 .file.yml
-[source,adoc]
+[source,yaml]
 ----
 slug: intro-neo4j-4-0
 parent_path: /intro
@@ -104,12 +125,17 @@ taxonomies:
       - 3-6
 ----
 
-=== `inline_highlighter_rouge`
+=== Inline syntax highlighter based on Rouge
 
 Inline syntax highlighter based on Rouge.
 It applies syntax highlighting on both monospaced text cypher and `src` inline macro:
 
-*Usage:*
+==== Usage
+
+[source,rb]
+----
+require 'neo4j/asciidoctor/extensions/inline_highlighter_rouge'
+----
 
 [source,adoc]
 ----
@@ -118,16 +144,29 @@ It applies syntax highlighting on both monospaced text cypher and `src` inline m
 src:cypher[MATCH (c:Customer {customerName: 'ABCCO'}) RETURN c.BOUGHT.productName]
 ----
 
-=== `revealjs_linear_navigation`
+=== Linear navigation for reveal.js
 
 A tree process that "flatten" a reveal.js presentation to use a linear navigation.
 By default, the reveal.js converter will use a vertical navigation for the second levels of section titles (and below).
 This extension will effectively prevent that by using only first level section titles.
 
-=== `revealjs_speaker_notes_aggregator`
+==== Usage
+
+[source,rb]
+----
+require 'neo4j/asciidoctor/extensions/revealjs_linear_navigation'
+----
+
+=== Notes aggregator for reveal.js
+
 A tree processor that aggregates multiple `[.notes]` blocks in a section (slide).
 
-*Usage:*
+==== Usage
+
+[source,rb]
+----
+require 'neo4j/asciidoctor/extensions/revealjs_speaker_notes_aggregator'
+----
 
 [source,adoc]
 ----
@@ -146,6 +185,34 @@ This is another speaker note.
 --
 ----
 
+=== Document attribute update
+
+A tree processor that update an attribute depending on a given rule.
+
+==== Usage
+
+In the example below, we update the value of the `slug` attribute depending on the `stage` attribute:
+[source,rb]
+----
+require 'asciidoctor/extensions'
+require 'neo4j/asciidoctor/extensions/attribute_update/extension'
+
+Asciidoctor::Extensions.register do
+  ext = Neo4j::AsciidoctorExtensions::AttributeUpdateTreeProcessor
+  tree_processor ext.new attr_name: 'slug',
+                         update_rule: lambda { |document, value|
+                           case document.attr('stage')
+                           when 'production'
+                             value
+                           when 'development'
+                             "_dev_#{value}"
+                           else
+                             "_test_#{value}"
+                           end
+                         }
+end
+----
+
 == Release
 
 The release process is automated and relies on GitHub Actions.

data/lib/neo4j/asciidoctor/extensions.rb

@@ -6,3 +6,4 @@ require_relative 'extensions/document_metadata_generator'
 require_relative 'extensions/inline_highlighter_rouge'
 require_relative 'extensions/revealjs_linear_navigation'
 require_relative 'extensions/revealjs_speaker_notes_aggregator'
+require_relative 'extensions/stage_slug'

data/lib/neo4j/asciidoctor/extensions/attribute_update/extension.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require 'asciidoctor/extensions' unless RUBY_ENGINE == 'opal'
+
+module Neo4j
+  # Asciidoctor extensions by Neo4j
+  module AsciidoctorExtensions
+    include Asciidoctor
+
+    # A tree processor that update an attribute depending on a given rule.
+    #
+    class AttributeUpdateTreeProcessor < Extensions::TreeProcessor
+      use_dsl
+
+      def process(document)
+        if (attribute_name = @config[:attr_name]) &&
+           (current_value = document.attr attribute_name) &&
+           (update_rule = @config[:update_rule])
+          new_value = update_rule.call(document, current_value)
+          document.set_attr attribute_name, new_value if new_value != current_value
+        end
+        document
+      end
+    end
+
+    # A tree processor that update the "slug" attribute depending on the "stage" attribute.
+    #
+    class StageSlugTreeProcessor < AttributeUpdateTreeProcessor
+      TESTING_SLUG_PREFIX = '_testing_'
+
+      def initialize(config = nil)
+        super
+        @config[:attr_name] = 'slug'
+        @config[:update_rule] = lambda { |document, value|
+          case document.attr('stage')
+          when 'production'
+            value
+          else
+            "#{TESTING_SLUG_PREFIX}#{value}"
+          end
+        }
+      end
+    end
+  end
+end

data/lib/neo4j/asciidoctor/extensions/stage_slug.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require 'asciidoctor/extensions' unless RUBY_ENGINE == 'opal'
+require_relative 'attribute_update/extension'
+
+Asciidoctor::Extensions.register do
+  tree_processor Neo4j::AsciidoctorExtensions::StageSlugTreeProcessor
+end

data/neo4j-asciidoctor-extensions.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
   s.name = 'neo4j-asciidoctor-extensions'
-  s.version = '0.0.4'
+  s.version = '0.0.5'
   s.summary = 'Asciidoctor extensions by Neo4j.'
   s.description = 'Asciidoctor extensions by Neo4j.'
 

data/spec/stage_slug_spec.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require 'asciidoctor'
+require 'asciidoctor/extensions'
+require_relative '../lib/neo4j/asciidoctor/extensions/attribute_update/extension'
+
+describe Neo4j::AsciidoctorExtensions::StageSlugTreeProcessor do
+  context 'convert to html5' do
+    it 'should update slug' do
+      registry = Asciidoctor::Extensions.create
+      registry.tree_processor Neo4j::AsciidoctorExtensions::StageSlugTreeProcessor
+      input = <<~'ADOC'
+        = Introduction to Neo4j 4.0
+        :slug: intro-neo4j-4-0
+
+        {slug}
+      ADOC
+      output = Asciidoctor.convert(input, extension_registry: registry, standalone: false, doctype: 'inline')
+      (expect output).to eql '_testing_intro-neo4j-4-0'
+    end
+    it 'should not update slug' do
+      registry = Asciidoctor::Extensions.create
+      registry.tree_processor Neo4j::AsciidoctorExtensions::StageSlugTreeProcessor
+      input = <<~'ADOC'
+        = Introduction to Neo4j 4.0
+        :stage: production
+        :slug: intro-neo4j-4-0
+
+        {slug}
+      ADOC
+      output = Asciidoctor.convert(input, extension_registry: registry, standalone: false, doctype: 'inline')
+      (expect output).to eql 'intro-neo4j-4-0'
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: neo4j-asciidoctor-extensions
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.0.5
 platform: ruby
 authors:
 - Guillaume Grossetie
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-04-24 00:00:00.000000000 Z
+date: 2020-04-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: asciidoctor
@@ -127,6 +127,7 @@ files:
 - README.adoc
 - Rakefile
 - lib/neo4j/asciidoctor/extensions.rb
+- lib/neo4j/asciidoctor/extensions/attribute_update/extension.rb
 - lib/neo4j/asciidoctor/extensions/course_document_attributes.rb
 - lib/neo4j/asciidoctor/extensions/course_document_attributes/extension.rb
 - lib/neo4j/asciidoctor/extensions/cypher_syntax_role.rb
@@ -139,6 +140,7 @@ files:
 - lib/neo4j/asciidoctor/extensions/revealjs_linear_navigation/extension.rb
 - lib/neo4j/asciidoctor/extensions/revealjs_speaker_notes_aggregator.rb
 - lib/neo4j/asciidoctor/extensions/revealjs_speaker_notes_aggregator/extension.rb
+- lib/neo4j/asciidoctor/extensions/stage_slug.rb
 - neo4j-asciidoctor-extensions.gemspec
 - spec/.rubocop.yml
 - spec/cypher_syntax_role_spec.rb
@@ -146,6 +148,7 @@ files:
 - spec/inline_highlighter_rouge_spec.rb
 - spec/revealjs_linear_navigation_spec.rb
 - spec/revealjs_speaker_notes_aggregator_spec.rb
+- spec/stage_slug_spec.rb
 - tasks/bundler.rake
 - tasks/lint.rake
 - tasks/rspec.rake
@@ -181,3 +184,4 @@ test_files:
 - spec/inline_highlighter_rouge_spec.rb
 - spec/revealjs_linear_navigation_spec.rb
 - spec/revealjs_speaker_notes_aggregator_spec.rb
+- spec/stage_slug_spec.rb