write_doc_to_file

in plugindocs.rb [94:131]


  def write_doc_to_file(plugin, release_tag, release_date, changelog_url, is_default_plugin)
    $stderr.puts("#{plugin.desc}: fetching documentation\n")
    content = plugin.documentation

    if content.nil?
      $stderr.puts("#{plugin.desc}: failed to fetch doc; skipping\n")
      return
    end

    output_asciidoc = "#{output_path}/docs/plugins/#{plugin.type}s/#{plugin.name}.asciidoc"
    directory = File.dirname(output_asciidoc)
    FileUtils.mkdir_p(directory) if !File.directory?(directory)

    
    content = content \
      .gsub("%VERSION%", release_tag) \
      .gsub("%RELEASE_DATE%", release_date || "unreleased") \
      .gsub("%CHANGELOG_URL%", changelog_url)

    
    injection_variables = Hash.new
    injection_variables[:default_plugin] = (is_default_plugin ? 1 : 0)
    content = inject_variables(content, injection_variables)

    
    
    
    if skip_existing? && File.exist?(output_asciidoc) \
          && no_version_bump?(output_asciidoc, content)
      $stderr.puts("#{plugin.desc}: skipping since no version bump and doc exists.\n")
      return
    end

    
    File.write(output_asciidoc, content)
    puts "#{plugin.canonical_name}@#{plugin.tag}: #{release_date}\n"
  end