#{CGI.escapeHTML(input_content)}#{CGI.escapeHTML(output_content)}#{escaped})
+ end
+ end
+end
+
+Liquid::Template.register_tag('jinja', Jekyll::JinjaInlineTag)
diff --git a/plugins/output_modder.rb b/plugins/output_modder.rb
index a2ca8164ce18..c71556dfebca 100644
--- a/plugins/output_modder.rb
+++ b/plugins/output_modder.rb
@@ -10,57 +10,60 @@
require 'nokogiri'
module Jekyll
- module OutputModder
- def output_modder(content)
- dom = Nokogiri::HTML.fragment(content)
+ module OutputModder
+ def output_modder(content)
+ dom = Nokogiri::HTML.fragment(content)
- # Find all links, make all external links rel='external nofollow'
- dom.css('a').each do |link|
- rel = ['external', 'nofollow']
+ # Find all links, make all external links rel='external nofollow'
+ dom.css('a').each do |link|
+ rel = %w[external nofollow]
- # All external links start with 'http', skip when this one does not
- next unless link.get_attribute('href') =~ /\Ahttp/i
+ # All external links start with 'http', skip when this one does not
+ next unless link.get_attribute('href') =~ /\Ahttp/i
- # Skip our own links
- next if link.get_attribute('href') =~ /\Ahttps?:\/\/\w*.?home-assistant.io/i
+ # Skip our own links
+ next if link.get_attribute('href') =~ %r{\Ahttps?://\w*.?home-assistant.io}i
- # Play nice with our own links
- next if link.get_attribute('href') =~ /\Ahttps?:\/\/(?:\w+\.)?(?:home-assistant\.io|esphome\.io|nabucasa\.com|openhomefoundation\.org)/i
+ # Play nice with our own links
+ if link.get_attribute('href') =~ %r{\Ahttps?://(?:\w+\.)?(?:home-assistant\.io|esphome\.io|nabucasa\.com|openhomefoundation\.org)}i
+ next
+ end
+
+ # Play nice with links that already have a rel attribute set
+ rel.unshift(link.get_attribute('rel'))
+
+ # Add rel attribute to link
+ link.set_attribute('rel', rel.join(' ').strip)
+ end
- # Play nice with links that already have a rel attribute set
- rel.unshift(link.get_attribute('rel'))
+ # Find all headers, make them linkable with unique slug names
+ used_slugs = {}
- # Add rel attribute to link
- link.set_attribute('rel', rel.join(' ').strip)
- end
+ dom.css('h2,h3,h4,h5,h6,h7,h8').each do |header|
+ # Skip linked headers
+ next if header.at_css('a')
- # Find all headers, make them linkable with unique slug names
- used_slugs = {}
-
- dom.css('h2,h3,h4,h5,h6,h7,h8').each do |header|
- # Skip linked headers
- next if header.at_css('a')
+ title = header.inner_html
+ title_text = header.content
- title = header.content
-
- # Clean the title to create a slug
- base_slug = title.downcase.strip.gsub(' ', '-').gsub(/[^\w-]/, '')
-
- # Make slug unique by adding counter if needed
- if used_slugs[base_slug]
- used_slugs[base_slug] += 1
- slug = "#{base_slug}-#{used_slugs[base_slug] - 1}"
- else
- used_slugs[base_slug] = 1
- slug = base_slug
- end
-
- header.children = "#{title} "
- end
+ # Clean the title to create a slug
+ base_slug = title_text.downcase.strip.gsub(' ', '-').gsub(/[^\w-]/, '')
- dom.to_s
+ # Make slug unique by adding counter if needed
+ if used_slugs[base_slug]
+ used_slugs[base_slug] += 1
+ slug = "#{base_slug}-#{used_slugs[base_slug] - 1}"
+ else
+ used_slugs[base_slug] = 1
+ slug = base_slug
end
+
+ header.children = "#{title} "
+ end
+
+ dom.to_s
end
+ end
end
Liquid::Template.register_filter(Jekyll::OutputModder)
diff --git a/plugins/raw_code_fences.rb b/plugins/raw_code_fences.rb
new file mode 100644
index 000000000000..9c81fc50fe9a
--- /dev/null
+++ b/plugins/raw_code_fences.rb
@@ -0,0 +1,78 @@
+# Automatically protect code fence contents from Liquid processing
+# by replacing {{ }} and {% %} with placeholders before Liquid runs,
+# then restoring them after rendering.
+
+module Jekyll
+ module RawCodeFences
+ OPEN_VAR = "___CODEVAR_OPEN___"
+ CLOSE_VAR = "___CODEVAR_CLOSE___"
+ OPEN_TAG = "___CODETAG_OPEN___"
+ CLOSE_TAG = "___CODETAG_CLOSE___"
+ OPEN_COMMENT = "___CODECOMMENT_OPEN___"
+ CLOSE_COMMENT = "___CODECOMMENT_CLOSE___"
+ end
+end
+
+# Before Liquid: replace Liquid-like syntax inside code fences and inline
+# backtick code with placeholders
+Jekyll::Hooks.register [:documents, :pages], :pre_render do |doc|
+ # First: protect code fences (``` blocks)
+ doc.content = doc.content.gsub(/(^[ \t]*)(`{3,})([^\n]*)\n(.*?)\n\1\2[ \t]*$/m) do
+ indent = $1
+ fence = $2
+ info = $3
+ inner = $4
+ fence_open = "#{indent}#{fence}#{info}\n"
+ fence_close = "#{indent}#{fence}"
+
+ # Skip fences that don't contain any Liquid-like syntax
+ next "#{fence_open}#{inner}\n#{fence_close}" unless inner.match?(/\{\{|\{%|\{#/)
+
+ # Replace Liquid syntax with placeholders, but preserve {% raw %} and {% endraw %} tags
+ inner = inner.gsub(/\{%-?\s*raw\s*-?%\}/) { |m| "___PRESERVE_RAW_#{m.hash.abs}___" }
+ inner = inner.gsub(/\{%-?\s*endraw\s*-?%\}/) { |m| "___PRESERVE_ENDRAW_#{m.hash.abs}___" }
+
+ inner = inner
+ .gsub("{{", Jekyll::RawCodeFences::OPEN_VAR)
+ .gsub("}}", Jekyll::RawCodeFences::CLOSE_VAR)
+ .gsub("{%", Jekyll::RawCodeFences::OPEN_TAG)
+ .gsub("%}", Jekyll::RawCodeFences::CLOSE_TAG)
+ .gsub("{#", Jekyll::RawCodeFences::OPEN_COMMENT)
+ .gsub("#}", Jekyll::RawCodeFences::CLOSE_COMMENT)
+
+ # Restore preserved raw/endraw tags so Liquid can process them
+ inner = inner.gsub(/___PRESERVE_RAW_\d+___/) { "{% raw %}" }
+ inner = inner.gsub(/___PRESERVE_ENDRAW_\d+___/) { "{% endraw %}" }
+
+ "#{fence_open}#{inner}\n#{fence_close}"
+ end
+
+ # Second: protect inline backtick code (`code` and ``code``)
+ doc.content = doc.content.gsub(/(`{1,2})([^`\n]+?)\1/) do
+ ticks = $1
+ inner = $2
+
+ next "#{ticks}#{inner}#{ticks}" unless inner.match?(/\{\{|\{%|\{#/)
+
+ inner = inner
+ .gsub("{{", Jekyll::RawCodeFences::OPEN_VAR)
+ .gsub("}}", Jekyll::RawCodeFences::CLOSE_VAR)
+ .gsub("{%", Jekyll::RawCodeFences::OPEN_TAG)
+ .gsub("%}", Jekyll::RawCodeFences::CLOSE_TAG)
+ .gsub("{#", Jekyll::RawCodeFences::OPEN_COMMENT)
+ .gsub("#}", Jekyll::RawCodeFences::CLOSE_COMMENT)
+
+ "#{ticks}#{inner}#{ticks}"
+ end
+end
+
+# After rendering: restore the placeholders in the final HTML
+Jekyll::Hooks.register [:documents, :pages], :post_render do |doc|
+ doc.output = doc.output
+ .gsub(Jekyll::RawCodeFences::OPEN_VAR, "{{")
+ .gsub(Jekyll::RawCodeFences::CLOSE_VAR, "}}")
+ .gsub(Jekyll::RawCodeFences::OPEN_TAG, "{%")
+ .gsub(Jekyll::RawCodeFences::CLOSE_TAG, "%}")
+ .gsub(Jekyll::RawCodeFences::OPEN_COMMENT, "{#")
+ .gsub(Jekyll::RawCodeFences::CLOSE_COMMENT, "#}")
+end
diff --git a/plugins/template_function_usage.rb b/plugins/template_function_usage.rb
new file mode 100644
index 000000000000..5ac5fb8b3aa2
--- /dev/null
+++ b/plugins/template_function_usage.rb
@@ -0,0 +1,145 @@
+require 'securerandom'
+require_relative 'terminology_helpers'
+
+module Jekyll
+ class TemplateFunctionUsageBlock < Liquid::Raw
+ USAGE_TYPES = {
+ 'function' => { label: 'As a function', icon: 'mdi:function' },
+ 'filter' => { label: 'As a filter', icon: 'mdi:filter-outline' },
+ 'test' => { label: 'As a test', icon: 'mdi:test-tube' }
+ }
+
+ include Jekyll::TerminologyHelpers
+
+ def render(context)
+ # Split on YAML document separator for multiple variants
+ documents = @body.split(/^---\s*$/)
+ parsed = documents.map { |doc| parse_document(doc.strip) }.compact
+
+ return '' if parsed.empty?
+
+ if parsed.length == 1
+ render_single(parsed[0], context)
+ else
+ render_tabbed(parsed, context)
+ end
+ end
+
+ private
+
+ def parse_document(text)
+ return nil if text.empty?
+
+ vars = SafeYAML.load(text)
+ return nil unless vars.is_a?(Hash)
+
+ input_type = USAGE_TYPES.keys.find { |t| vars.key?(t) }
+ return nil unless input_type
+
+ {
+ input_type: input_type,
+ input_content: vars[input_type].to_s.strip,
+ output_content: vars['output']&.to_s&.strip,
+ result_type: vars['type']&.to_s&.strip
+ }
+ end
+
+ def render_output(output_content, result_type, has_input, context)
+ escaped_output = CGI.escapeHTML(output_content)
+ if result_type
+ type_term = render_term(result_type, context)
+ result_label = "#{escaped_output}#{escaped_input}#{escaped_input}{{ func.function_name }}
+
+ {{ func.description }}
+{{ page.function_name }}{{ alias }}{{ page.deprecated_in_favor_of }} instead.
+