module Jekyll
  module AsciiDoc
    module Filters
      # A Liquid filter for converting an AsciiDoc string to HTML using {Converter#convert}.
      #
      # @param input [String] the AsciiDoc String to convert.
      # @param doctype [String] the target AsciiDoc doctype.
      #
      # @example Convert the AsciiDoc page excerpt to inline HTML
      #   {{ page.excerpt | asciidocify: 'inline' }}
      #
      # @return [String] the converted result as an HTML-formatted String.
      def asciidocify input, doctype = nil
        (@context.registers[:cached_asciidoc_converter] ||= (Converter.get_instance @context.registers[:site]))
          .convert(doctype ? %(:doctype: #{doctype}#{Utils::NewLine}#{input}) : (input || ''))
      end

      # A Liquid filter for generating an HTML table of contents from a parsed AsciiDoc document.
      #
      # @param document [Asciidoctor::Document] the parsed AsciiDoc document for which to generate an HTML table of
      # contents.
      # @param levels [Integer] the maximum section depth to use; if not specified, uses the value of toclevels document
      # attribute.
      #
      # @example Generate a table of contents from the document for the current page
      #   {{ page.document | tocify_asciidoc: 3 }}
      #
      # @return [String] the table of contents as an HTML-formatted String.
      def tocify_asciidoc document, levels = nil
        ::Asciidoctor::Document === document ?
          (document.converter.convert document, 'outline', toclevels: (levels.nil_or_empty? ? nil : levels.to_i)) : nil
      end
    end

    ::Liquid::Template.register_filter Filters
  end
end