🐛 Fixing markdown => HTML conversion

Author: pboling

.tool-versions

@@ -1,2 +1,2 @@
 direnv 2.32.2
-ruby   3.4.5
+ruby   3.4.7

.yard_gfm_support.rb

@@ -11,12 +11,24 @@ def initialize(source, options = {})
   end
 end
 
+# Ensure YARD is loaded before modifying its constants
+require 'yard' unless defined?(YARD)
+
 # Insert the new provider as the highest priority option for Markdown.
 # See:
 # - https://github.com/lsegal/yard/issues/1157
 # - https://github.com/lsegal/yard/issues/1017
 # - https://github.com/lsegal/yard/blob/main/lib/yard/templates/helpers/markup_helper.rb
-YARD::Templates::Helpers::MarkupHelper::MARKUP_PROVIDERS[:markdown].insert(
-  0,
-  {const: "KramdownGfmDocument"},
-)
+require 'yard/templates/helpers/markup_helper'
+
+providers = YARD::Templates::Helpers::MarkupHelper::MARKUP_PROVIDERS[:markdown]
+providers.unshift({lib: :kramdown, const: :KramdownGfmDocument})
+
+# Normalize provider entries to what YARD expects (const must be a String)
+providers.each do |provider|
+  const = provider[:const]
+  provider[:const] = const.to_s if const.is_a?(Symbol)
+end
+
+# De-duplicate entries by [lib, const]
+providers.uniq! { |p| [p[:lib], p[:const].to_s] }

docs/.nojekyll

@@ -0,0 +1,32 @@
+#!/usr/bin/env ruby
+require 'bundler/setup'
+require 'yard'
+require 'yard/templates/helpers/markup_helper'
+
+puts "Before loading .yard_gfm_support.rb:"
+YARD::Templates::Helpers::MarkupHelper::MARKUP_PROVIDERS[:markdown].each_with_index do |p, i|
+  puts "  [#{i}] #{p.inspect}"
+end
+
+require './.yard_gfm_support.rb'
+
+puts "\nAfter loading .yard_gfm_support.rb:"
+YARD::Templates::Helpers::MarkupHelper::MARKUP_PROVIDERS[:markdown].each_with_index do |p, i|
+  puts "  [#{i}] #{p.inspect}"
+end
+
+puts "\nTesting KramdownGfmDocument:"
+
+test_md = <<-MD
+  # Test
+
+  ```ruby
+  puts "hello"
+  ```
+MD
+
+doc = KramdownGfmDocument.new(test_md)
+html = doc.to_html
+puts html
+puts "\nDoes output contain <pre>? #{html.include?('<pre>')}"
+puts "Does output contain <code>? #{html.include?('<code')}"