unless RUBY_ENGINE == 'opal' # This helper file borrows from the Bespoke converter # https://github.com/asciidoctor/asciidoctor-bespoke require 'asciidoctor' end # This module gets mixed in to every node (the context of the template) at the # time the node is being converted. The properties and methods in this module # effectively become direct members of the template. module Slim::Helpers EOL = %(\n) SliceHintRx = / +/ def slice_text str, active = nil if (active || (active.nil? && (option? :slice))) && (str.include? ' ') (str.split SliceHintRx).map {|line| %(#{line}) }.join EOL else str end end def to_boolean val val && val != 'false' && val.to_s != '0' || false end # bool_data_attr # If the AsciiDoc attribute doesn't exist, no HTML attribute is added # If the AsciiDoc attribute exist and is a true value, HTML attribute is enabled (bool) # If the AsciiDoc attribute exist and is a false value, HTML attribute is a false string # Ex: a feature is enabled globally but can be disabled using a data- attribute on individual items # :revealjs_previewlinks: True # then link::example.com[Link text, preview=false] # Here the template must have data-preview-link="false" not just no data-preview-link attribute def bool_data_attr val return false if !attr?(val) if attr(val).downcase == 'false' || attr(val) == '0' return 'false' else return true end end # false needs to be verbatim everything else is a string. # Calling side isn't responsible for quoting so we are doing it here def to_valid_slidenumber val # corner case: empty is empty attribute which is true return true if val == "" # using to_s here handles both the 'false' string and the false boolean val.to_s == 'false' ? false : "'#{val}'" end ## # These constants and functions are from the asciidictor-html5s project # https://github.com/jirutka/asciidoctor-html5s/blob/a71db48a1dd5196b668b3a3d93693c5d877c5bf3/data/templates/helpers.rb # Defaults DEFAULT_TOCLEVELS = 2 DEFAULT_SECTNUMLEVELS = 3 VOID_ELEMENTS = %w(area base br col command embed hr img input keygen link meta param source track wbr) ## # Creates an HTML tag with the given name and optionally attributes. Can take # a block that will run between the opening and closing tags. # # @param name [#to_s] the name of the tag. # @param attributes [Hash] (default: {}) # @param content [#to_s] the content; +nil+ to call the block. (default: nil). # @yield The block of Slim/HTML code within the tag (optional). # @return [String] a rendered HTML element. # def html_tag(name, attributes = {}, content = nil) attrs = attributes.inject([]) do |attrs, (k, v)| next attrs if !v || v.nil_or_empty? v = v.compact.join(' ') if v.is_a? Array attrs << (v == true ? k : %(#{k}="#{v}")) end attrs_str = attrs.empty? ? '' : ' ' + attrs.join(' ') if VOID_ELEMENTS.include? name.to_s %(<#{name}#{attrs_str}>) else content ||= yield if block_given? %(<#{name}#{attrs_str}>#{content}) end end ## # Returns corrected section level. # # @param sec [Asciidoctor::Section] the section node (default: self). # @return [Integer] # def section_level(sec = self) @_section_level ||= (sec.level == 0 && sec.special) ? 1 : sec.level end ## # Returns the captioned section's title, optionally numbered. # # @param sec [Asciidoctor::Section] the section node (default: self). # @return [String] # def section_title(sec = self) sectnumlevels = document.attr(:sectnumlevels, DEFAULT_SECTNUMLEVELS).to_i if sec.numbered && !sec.caption && sec.level <= sectnumlevels [sec.sectnum, sec.captioned_title].join(' ') else sec.captioned_title end end def revealjs_dependencies(document, node, revealjsdir) dependencies = [] dependencies << "{ src: '#{revealjsdir}/plugin/zoom-js/zoom.js', async: true }" unless (node.attr? 'revealjs_plugin_zoom', 'disabled') dependencies << "{ src: '#{revealjsdir}/plugin/notes/notes.js', async: true }" unless (node.attr? 'revealjs_plugin_notes', 'disabled') dependencies << "{ src: '#{revealjsdir}/plugin/markdown/marked.js', async: true }" if (node.attr? 'revealjs_plugin_marked', 'enabled') dependencies << "{ src: '#{revealjsdir}/plugin/markdown/markdown.js', async: true }" if (node.attr? 'revealjs_plugin_markdown', 'enabled') if (node.attr? 'revealjs_plugins') && !(revealjs_plugins_file = (node.attr 'revealjs_plugins', '').strip).empty? && !(revealjs_plugins_content = (File.read revealjs_plugins_file).strip).empty? dependencies << revealjs_plugins_content end dependencies.join(",\n ") end # Between delimiters (--) is code taken from asciidoctor-bespoke 1.0.0.alpha.1 # Licensed under MIT, Copyright (C) 2015-2016 Dan Allen and the Asciidoctor Project #-- # Retrieve the converted content, wrap it in a `

` element if # the content_model equals :simple and return the result. # # Returns the block content as a String, wrapped inside a `

` element if # the content_model equals `:simple`. def resolve_content @content_model == :simple ? %(

#{content}

) : content end # Capture nested template content and register it with the specified key, to # be executed at a later time. # # This method must be invoked using the control code directive (i.e., -). By # using a control code directive, the block is set up to append the result # directly to the output buffer. (Integrations often hide the distinction # between a control code directive and an output directive in this context). # # key - The Symbol under which to save the template block. # opts - A Hash of options to control processing (default: {}): # * :append - A Boolean that indicates whether to append this block # to others registered with this key (default: false). # * :content - String content to be used if template content is not # provided (optional). # block - The template content (in Slim template syntax). # # Examples # # - content_for :body # p content # - content_for :body, append: true # p more content # # Returns nothing. def content_for key, opts = {}, &block @content = {} unless defined? @content (opts[:append] ? (@content[key] ||= []) : (@content[key] = [])) << (block_given? ? block : lambda { opts[:content] }) nil end # Checks whether deferred template content has been registered for the specified key. # # key - The Symbol under which to look for saved template blocks. # # Returns a Boolean indicating whether content has been registered for this key. def content_for? key (defined? @content) && (@content.key? key) end # Evaluates the deferred template content registered with the specified key. # # When the corresponding content_for method is invoked using a control code # directive, the block is set up to append the result to the output buffer # directly. # # key - The Symbol under which to look for template blocks to yield. # opts - A Hash of options to control processing (default: {}): # * :drain - A Boolean indicating whether to drain the key of blocks # after calling them (default: true). # # Examples # # - yield_content :body # # Returns nothing (assuming the content has been captured in the context of control code). def yield_content key, opts = {} if (defined? @content) && (blks = (opts.fetch :drain, true) ? (@content.delete key) : @content[key]) blks.map {|b| b.call }.join end nil end #-- end # More custom functions can be added in another namespace if required #module Helpers #end