icinga-docs-tools/build-docs.rb

#!/usr/bin/env ruby
require 'fileutils'
require 'yaml'
require 'git'

config = YAML::load_file('config.yml')
mkdocs = YAML::load_file('mkdocs.template.yml')
categories = {}

config['projects'].each do |project_name, project_config|
  puts "== #{project_name}"

  project_dir = config['projects_dir'] + '/' + project_config['target']

  if project_config['latest'] == true
    clone_target = project_dir + '/latest'
  elsif project_config['ref'] == 'master'
    clone_target = project_dir + '/snapshot'
  else
    clone_target = project_dir + '/' + project_config['ref'].gsub('tags/', '')
  end

  project_docs_dir = clone_target + '/' + project_config['docs_dir']
  pages = []

  if !File.directory?(clone_target)
    puts 'Cloning ...'
    FileUtils.mkdir_p(project_dir)
    repo = Git.clone(project_config['git'], clone_target)
    puts "Checkout ref '#{project_config['ref']}'"
    repo.branch(project_config['ref']).checkout
  else
    repo = Git.open(clone_target)
    repo.fetch()
    puts "Checkout ref '#{project_config['ref']}'"
    repo.branch(project_config['ref']).checkout
    repo.pull('origin', project_config['ref'])
  end

  puts "Building page index from #{project_docs_dir}"
  Dir.glob("#{project_docs_dir}/*.md", File::FNM_CASEFOLD).sort.each do |file|
    filepath = file.gsub('projects/', '')
    filename = filepath.match(/(\d+)-(.*).md$/)
    header = filename[2].gsub('-', ' ').split.map(&:capitalize).join(' ')
    pages.push(header => filepath)
  end

  if project_config['category']
    categories[project_config['category']] = [] unless categories[project_config['category']]
    categories[project_config['category']].push(project_name => pages)
  else
    mkdocs['pages'].push(project_name => pages)
  end
end

if categories
  categories.each do |cat, proj|
    mkdocs['pages'].push(cat => proj)
  end
end

mkdocs['extra']['append_pages'].each do |name, target|
  mkdocs['pages'].push(name => target)
end

File.write('mkdocs.yml', mkdocs.to_yaml)

%x( mkdocs build )