Sha256: b773c71db56f39e206806f5d8fa8aa290d1c94c6bd9182cf75fcca34cfcd6aae

Contents?: true

Size: 1.11 KB

Versions: 29

Compression:

Stored size: 1.11 KB

Contents

# frozen_string_literal: true

module Nanoc::Helpers
  # @see https://nanoc.ws/doc/reference/helpers/#filtering
  module HTMLEscape
    require 'nanoc/helpers/capturing'
    include Nanoc::Helpers::Capturing

    # @param [String] string
    #
    # @return [String]
    def html_escape(string = nil, &block)
      if block_given?
        # Capture and escape block
        data = capture(&block)
        escaped_data = html_escape(data)

        # Append filtered data to buffer
        buffer = eval('_erbout', block.binding)
        buffer << escaped_data
      elsif string
        unless string.is_a? String
          raise ArgumentError, 'The #html_escape or #h function needs either a ' \
            "string or a block to HTML-escape, but #{string.class} was given"
        end

        string
          .gsub('&', '&amp;')
          .gsub('<', '&lt;')
          .gsub('>', '&gt;')
          .gsub('"', '&quot;')
      else
        raise 'The #html_escape or #h function needs either a ' \
          'string or a block to HTML-escape, but neither a string nor a block was given'
      end
    end

    alias h html_escape
  end
end

Version data entries

29 entries across 29 versions & 1 rubygems

Version Path
nanoc-4.12.7 lib/nanoc/helpers/html_escape.rb
nanoc-4.12.6 lib/nanoc/helpers/html_escape.rb
nanoc-4.12.5 lib/nanoc/helpers/html_escape.rb
nanoc-4.12.4 lib/nanoc/helpers/html_escape.rb
nanoc-4.12.3 lib/nanoc/helpers/html_escape.rb
nanoc-4.12.2 lib/nanoc/helpers/html_escape.rb
nanoc-4.12.1 lib/nanoc/helpers/html_escape.rb
nanoc-4.12.0 lib/nanoc/helpers/html_escape.rb
nanoc-4.11.23 lib/nanoc/helpers/html_escape.rb
nanoc-4.11.22 lib/nanoc/helpers/html_escape.rb
nanoc-4.11.21 lib/nanoc/helpers/html_escape.rb
nanoc-4.11.20 lib/nanoc/helpers/html_escape.rb
nanoc-4.11.19 lib/nanoc/helpers/html_escape.rb
nanoc-4.11.18 lib/nanoc/helpers/html_escape.rb
nanoc-4.11.17 lib/nanoc/helpers/html_escape.rb
nanoc-4.11.16 lib/nanoc/helpers/html_escape.rb
nanoc-4.11.15 lib/nanoc/helpers/html_escape.rb
nanoc-4.11.14 lib/nanoc/helpers/html_escape.rb
nanoc-4.11.13 lib/nanoc/helpers/html_escape.rb
nanoc-4.11.12 lib/nanoc/helpers/html_escape.rb