sleeping_king_studios-docs 0.1.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4efbec5418a43dab48ee3f399e9461fd64f17f1b31931d384f6bd5b3de0407cb
-  data.tar.gz: a609dd607d8b1c9a71495e09c0f01e70bac9d92ad91a29817f5abbfb1baefeb8
+  metadata.gz: 187804266272946364341348fd3889893752cc218af1049326fa56856c7f8751
+  data.tar.gz: 2eed4cc2aea0b359d1487b0c94b5c1ab860334021093546cb8748352dac5cc44
 SHA512:
-  metadata.gz: b2c4d06f1f2ff5cf128cee30e748a5255d99699f80a3e69054f54d544d1389aa045752b38be64b0c002e6b71e3fb654e77856293eb66d2297565e65315b2aba3
-  data.tar.gz: d01dd772621dbaac3c8261089ea997ad471edabd9f7b2a65d01467cd062415dae4a15a1b04f4198baa7c6bd117dd1852d2342bef2297c35befb75a03e9c7ca56
+  metadata.gz: 7908bf7a9412828c78783ca387450ef9ea5029d35495dcb3575e5eff7b4c99090c98b00d1cba7f0754f996bca9e11dde4361b2c9a47ac47a15764eafe72b4a79
+  data.tar.gz: 186ec6c0d7a9a711579d6b4d0f4d444c9e03bf3f3be28ec7072df90e64de1827fe99ce4923811d2127a30319afc90a08c2bc094dbe2dcd30f43f1e5e0b4da5ff

data/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+# 0.2.1
+
+Added support for Ruby 4.0.
+
+# 0.2.0
+
+> **Upgrade Notes**
+>
+> Add the following to your `_config.yml` files:
+>
+> ```markdown
+> plugins:
+>   - sleeping_king_studios/docs/jekyll/plugins/required
+> ```
+
+- Improved handling of method names with characters that are not valid for HTML anchors, such as `[]`, `=`, and `?`.
+
 # 0.1.0
 
 Initial development release.

data/lib/sleeping_king_studios/docs/data/see_tags/class_method_tag.rb

@@ -70,7 +70,7 @@ module SleepingKingStudios::Docs::Data::SeeTags
       @normalized_path = @normalized_path.reverse.sub('::', '.').reverse
     end
 
-    def query_registry(name)
+    def registry_item_exists?(name)
       registry_query.class_method_exists?(name)
     end
 

data/lib/sleeping_king_studios/docs/data/see_tags/constant_tag.rb

@@ -40,7 +40,7 @@ module SleepingKingStudios::Docs::Data::SeeTags
 
     private
 
-    def query_registry(name)
+    def registry_item_exists?(name)
       registry_query.constant_exists?(name)
     end
 

data/lib/sleeping_king_studios/docs/data/see_tags/definition_tag.rb

@@ -39,7 +39,7 @@ module SleepingKingStudios::Docs::Data::SeeTags
 
     private
 
-    def query_registry(name)
+    def registry_item_exists?(name)
       registry_query.definition_exists?(name)
     end
 

data/lib/sleeping_king_studios/docs/data/see_tags/instance_method_tag.rb

@@ -55,7 +55,7 @@ module SleepingKingStudios::Docs::Data::SeeTags
 
     private
 
-    def query_registry(name)
+    def registry_item_exists?(name)
       registry_query.instance_method_exists?(name)
     end
 

data/lib/sleeping_king_studios/docs/data/see_tags/reference_tag.rb

@@ -51,10 +51,10 @@ module SleepingKingStudios::Docs::Data::SeeTags
     def absolute_path?
       return @absolute_path unless @absolute_path.nil?
 
-      @absolute_path = query_registry(reference)
+      @absolute_path = registry_item_exists?(reference)
     end
 
-    def query_registry(_)
+    def registry_item_exists?(_)
       false
     end
 
@@ -78,7 +78,7 @@ module SleepingKingStudios::Docs::Data::SeeTags
 
       return @relative_path = false if parent.root?
 
-      @relative_path = query_registry(qualified_path)
+      @relative_path = registry_item_exists?(qualified_path)
     end
 
     def slugify_path(path)

data/lib/sleeping_king_studios/docs/data/types/parser.rb

@@ -74,12 +74,12 @@ module SleepingKingStudios::Docs::Data::Types
         .select { |const_name| const_name.to_s.end_with?('0') }
         .sort
         .to_h \
-      do |const_name|
-        ext   = TypesSpecifierList.const_get(const_name)
-        value = tools.string_tools.underscore(const_name.to_s[0...-1]).intern
+        do |const_name|
+          ext   = TypesSpecifierList.const_get(const_name)
+          value = tools.string_tools.underscore(const_name.to_s[0...-1]).intern
 
-        [ext, value]
-      end
+          [ext, value]
+        end
     end
 
     def handle_key_value_type(node)

data/lib/sleeping_king_studios/docs/jekyll/plugins/liquid/filters/anchorize_slug.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require 'sleeping_king_studios/docs/jekyll/plugins/liquid/filters'
+
+module SleepingKingStudios::Docs::Jekyll::Plugins::Liquid::Filters
+  # Liquid filter for converting a reference slug to a safe HTML anchor.
+  module AnchorizeSlug
+    # Converts the slug to a string usable as an HTML anchor.
+    #
+    # Certain characters are valid Ruby identifiers but cause issues when used
+    # as HTML anchors, such as equals signs, hashes, question marks, and square
+    # brackets. This method replaces each with a placeholder value.
+    #
+    # @param slug [String] the slug to convert.
+    #
+    # @return [String] the converted slug.
+    def anchorize_slug(slug)
+      slug
+        .to_s
+        .gsub('=', '--equals')
+        .gsub('?', '--predicate')
+        .gsub('[]', '--brackets')
+    end
+
+    ::Liquid::Template.register_filter(self) if defined?(::Liquid::Template)
+  end
+end

data/lib/sleeping_king_studios/docs/jekyll/plugins/liquid/filters.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require 'sleeping_king_studios/docs/jekyll/plugins/liquid'
+
+module SleepingKingStudios::Docs::Jekyll::Plugins::Liquid
+  # Filters for extending Liquid template functionality.
+  module Filters
+    autoload :AnchorizeSlug,
+      'sleeping_king_studios/docs/jekyll/plugins/liquid/filters/anchorize_slug'
+  end
+end

data/lib/sleeping_king_studios/docs/jekyll/plugins/liquid.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require 'sleeping_king_studios/docs/jekyll/plugins'
+
+module SleepingKingStudios::Docs::Jekyll::Plugins
+  # Plugins for extending Liquid template functionality.
+  module Liquid
+    autoload :Filters,
+      'sleeping_king_studios/docs/jekyll/plugins/liquid/filters'
+  end
+end

data/lib/sleeping_king_studios/docs/jekyll/plugins/required.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require 'sleeping_king_studios/docs/jekyll/plugins'
+
+module SleepingKingStudios::Docs::Jekyll::Plugins
+  # Helper module for loading all required Jekyll plugins.
+  module Required
+    include Liquid::Filters::AnchorizeSlug
+  end
+end

data/lib/sleeping_king_studios/docs/jekyll/plugins.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require 'sleeping_king_studios/docs/jekyll'
+
+module SleepingKingStudios::Docs::Jekyll
+  # Plugins for extending Jekyll functionality.
+  module Plugins
+    autoload :Liquid,   'sleeping_king_studios/docs/jekyll/plugins/liquid'
+    autoload :Required, 'sleeping_king_studios/docs/jekyll/plugins/required'
+  end
+end

data/lib/sleeping_king_studios/docs/jekyll.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require 'sleeping_king_studios/docs'
+
+module SleepingKingStudios::Docs
+  # Namespace for working with Jekyll-specific functionality.
+  module Jekyll
+    autoload :Plugins, 'sleeping_king_studios/docs/jekyll/plugins'
+  end
+end

data/lib/sleeping_king_studios/docs/templates/config.yml.erb

@@ -1,4 +1,6 @@
 ---
+plugins:
+  - sleeping_king_studios/docs/jekyll/plugins/required
 collections:
   classes:
     output: false

data/lib/sleeping_king_studios/docs/templates/includes/reference/attribute.md

@@ -1,6 +1,6 @@
 {% assign method = site.methods | where: "data_path", include.attribute.path | where: "version", page.version | first %}
 {% capture prefix %}{{ include.type }}-attribute{% endcapture %}
-{% capture heading_id %}{{ prefix }}-{{ method.slug | replace: "=", "--equals" }}{% endcapture %}
+{% capture heading_id %}{{ prefix }}-{{ method.slug | anchorize_slug }}{% endcapture %}
 
 {% include reference/attributes/heading.md attribute=include.attribute heading_id=heading_id method=method type=include.type %}
 

data/lib/sleeping_king_studios/docs/templates/includes/reference/definitions/table-of-contents/class_attributes.md

@@ -3,7 +3,7 @@
   <a href="#class-attributes">Class Attributes</a>
   <ul style="margin-bottom: 0px;">
   {% for attribute in include.definition.class_attributes %}
-    <li><a href="#class-attribute-{{ attribute.slug | replace: "=", "--equals" }}">{{ attribute.name }}</a></li>
+    <li><a href="#class-attribute-{{ attribute.slug | anchorize_slug }}">{{ attribute.name }}</a></li>
   {% endfor %}
   </ul>
 </li>

data/lib/sleeping_king_studios/docs/templates/includes/reference/definitions/table-of-contents/class_methods.md

@@ -3,7 +3,7 @@
   <a href="#class-methods">Class Methods</a>
   <ul style="margin-bottom: 0px;">
   {% for method in include.definition.class_methods %}
-    <li><a href="#class-method-{{ method.slug | replace: "=", "--equals" | replace: "?", "--predicate" }}">{{ method.name }}</a></li>
+    <li><a href="#class-method-{{ method.slug | anchorize_slug }}">{{ method.name }}</a></li>
   {% endfor %}
   </ul>
 </li>

data/lib/sleeping_king_studios/docs/templates/includes/reference/definitions/table-of-contents/instance_attributes.md

@@ -3,7 +3,7 @@
   <a href="#instance-attributes">Instance Attributes</a>
   <ul style="margin-bottom: 0px;">
   {% for attribute in include.definition.instance_attributes %}
-    <li><a href="#instance-attribute-{{ attribute.slug | replace: "=", "--equals" }}">{{ attribute.name }}</a></li>
+    <li><a href="#instance-attribute-{{ attribute.slug | anchorize_slug }}">{{ attribute.name }}</a></li>
   {% endfor %}
   </ul>
 </li>

data/lib/sleeping_king_studios/docs/templates/includes/reference/definitions/table-of-contents/instance_methods.md

@@ -3,7 +3,7 @@
   <a href="#instance-methods">Instance Methods</a>
   <ul style="margin-bottom: 0px;">
   {% for method in include.definition.instance_methods %}
-    <li><a href="#instance-method-{{ method.slug | replace: "=", "--equals" | replace: "?", "--predicate" }}">{{ method.name }}</a></li>
+    <li><a href="#instance-method-{{ method.slug | anchorize_slug }}">{{ method.name }}</a></li>
   {% endfor %}
   </ul>
 </li>

data/lib/sleeping_king_studios/docs/templates/includes/reference/method.md

@@ -1,7 +1,7 @@
 {% assign method = site.methods | where: "data_path", include.path | where: "version", page.version | first %}
 {% if method %}
 {% capture prefix %}{{ include.type }}-method{% endcapture %}
-{% capture heading_id %}{{ prefix }}-{{ method.slug | replace: "=", "--equals" | replace: "?", "--predicate" }}{% endcapture %}
+{% capture heading_id %}{{ prefix }}-{{ method.slug | anchorize_slug }}{% endcapture %}
 
 {% include reference/methods/heading.md heading_id=heading_id method=method type=include.type %}
 

data/lib/sleeping_king_studios/docs/version.rb

@@ -11,9 +11,9 @@ module SleepingKingStudios
       # Major version.
       MAJOR = 0
       # Minor version.
-      MINOR = 1
+      MINOR = 2
       # Patch version.
-      PATCH = 0
+      PATCH = 1
       # Prerelease version.
       PRERELEASE = nil
       # Build metadata.

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: sleeping_king_studios-docs
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Rob "Merlin" Smith
 bindir: bin
 cert_chain: []
-date: 2025-03-31 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cuprum
@@ -15,14 +15,20 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '1.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '1.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.1
 - !ruby/object:Gem::Dependency
   name: erubi
   requirement: !ruby/object:Gem::Requirement
@@ -44,6 +50,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -51,6 +60,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.1
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
@@ -151,6 +163,12 @@ files:
 - lib/sleeping_king_studios/docs/errors/file_not_found.rb
 - lib/sleeping_king_studios/docs/errors/invalid_directory.rb
 - lib/sleeping_king_studios/docs/errors/invalid_file.rb
+- lib/sleeping_king_studios/docs/jekyll.rb
+- lib/sleeping_king_studios/docs/jekyll/plugins.rb
+- lib/sleeping_king_studios/docs/jekyll/plugins/liquid.rb
+- lib/sleeping_king_studios/docs/jekyll/plugins/liquid/filters.rb
+- lib/sleeping_king_studios/docs/jekyll/plugins/liquid/filters/anchorize_slug.rb
+- lib/sleeping_king_studios/docs/jekyll/plugins/required.rb
 - lib/sleeping_king_studios/docs/registry.rb
 - lib/sleeping_king_studios/docs/registry_query.rb
 - lib/sleeping_king_studios/docs/tasks.rb
@@ -228,16 +246,19 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - "~>"
+  - - ">="
     - !ruby/object:Gem::Version
       version: '3.1'
+  - - "<"
+    - !ruby/object:Gem::Version
+      version: '5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.5
+rubygems_version: 4.0.2
 specification_version: 4
 summary: Tools for generating a versioned documentation site from YARD docs.
 test_files: []