super-pro-rb 0.0.1

data/gollum-6.1.0/bin/gollum

@@ -0,0 +1,301 @@
+#!/usr/bin/env -S ruby -Eutf-8
+
+$:.unshift File.join(File.dirname(__FILE__), *%w[.. lib])
+
+require 'optparse'
+require 'rubygems'
+require 'gollum'
+require 'erb'
+require 'sprockets'
+
+exec         = {}
+options      = {
+  :port => 4567,
+  :bind => '0.0.0.0',
+}
+wiki_options = {
+  :allow_uploads => false,
+  :allow_editing => true
+}
+
+default_math_config = 'math.config.js'
+
+opts = OptionParser.new do |opts|
+  # define program name (although this defaults to the name of the file, just in case...)
+  opts.program_name = 'gollum'
+
+  # set basic info for the '--help' command (options will be appended automatically from the below definitions)
+  opts.banner = '
+  Gollum is a multi-format Wiki Engine/API/Frontend.
+
+  Usage:
+      gollum [options] [git-repo]
+
+  Arguments:
+      [git-repo]                     Path to the git repository being served. If not specified, current working directory is used.
+
+  Notes:
+      Paths for all options are relative to <git-repo> unless absolute.
+      This message is only a basic description. For more information, please visit:
+          https://github.com/gollum/gollum
+
+  OPTIONS'
+
+  # define gollum options
+  opts.separator ''
+  opts.separator '  Major:'
+
+  opts.on('-h', '--host [HOST]', 'Specify the hostname or IP address to listen on. Default: \'0.0.0.0\'.') do |host|
+    options[:bind] = host
+  end
+  opts.on('-p', '--port [PORT]', 'Specify the port to bind Gollum with. Default: \'4567\'.') do |port|
+    begin
+      # don't use 'port.to_i' here... it doesn't raise errors which might result in a nice confusion later on
+      options[:port] = Integer(port)
+    rescue ArgumentError
+      puts "Error: '#{port}' is not a valid port number."
+      exit 1
+    end
+  end
+  opts.on('-c', '--config [FILE]', 'Specify path to the Gollum\'s configuration file.') do |file|
+    options[:config] = file
+  end
+  opts.on('-r', '--ref [REF]', 'Specify the branch to serve. Default: \'master\'.') do |ref|
+    wiki_options[:ref] = ref
+  end
+  opts.on("--bare", "Declare '<git-repo>' to be bare.") do
+    wiki_options[:repo_is_bare] = true
+  end
+  opts.on('-a', '--adapter [ADAPTER]', 'Launch Gollum using a specific git adapter. Default: \'rugged\'.') do |adapter|
+    Gollum::GIT_ADAPTER = adapter
+  end
+  opts.on('-b', '--base-path [PATH]', 'Specify the leading portion of all Gollum URLs (path info). Default: \'/\'.',
+    'Example: setting this to \'/wiki\' will make the wiki accessible under \'http://localhost:4567/wiki/\'.') do |base_path|
+
+    # first trim a leading slash, if any
+    base_path.sub!(/^\/+/, '')
+
+    # make a backup of the option and sanitize it
+    base_path_original = base_path.dup
+    base_path = ERB::Util.url_encode(base_path)
+    base_path.gsub!('%2F', '/')
+
+    # then let the user know if we changed the URL
+    unless base_path_original == base_path
+      puts <<MSG
+Warning: your base-path has been sanitized:
+  - original: "#{base_path_original}"
+  - sanitized: "#{base_path}"
+MSG
+    end
+
+    # and finally, let others enjoy our hard work:
+    wiki_options[:base_path] = base_path unless base_path.empty?
+  end
+  opts.on('--page-file-dir [PATH]', 'Specify the subdirectory for all pages. Default: repository root.',
+    'Example: setting this to \'pages\' will make Gollum serve only pages at \'<git-repo>/pages/*\'.') do |path|
+    wiki_options[:page_file_dir] = path
+  end
+  opts.on('--assets [PATH]', 'Set the path to look for stylesheets and javascript. Only used if environment is production/staging. Default: ./public/assets') do |path|
+    wiki_options[:static_assets_path] = path
+  end
+  opts.on('--css', 'Inject custom CSS into each page. The \'<wiki-root>/custom.css\' file is used (must be committed).') do
+    wiki_options[:css] = true
+  end
+  opts.on('--js', 'Inject custom JavaScript into each page. The \'<wiki-root>/custom.js\' file is used (must be committed).') do
+    wiki_options[:js] = true
+  end
+  opts.on('--no-edit', 'Disable the feature of editing pages.')  do
+    wiki_options[:allow_editing] = false
+  end
+  opts.on('--allow-uploads [MODE]', [:dir, :page], 'Enable file uploads.',
+    'If set to \'dir\', Gollum will store all uploads in the \'<git-repo>/uploads/\' directory.',
+    'If set to \'page\', Gollum will store uploads per page in \'<git-repo>/uploads/[pagename]\'.') do |mode|
+    wiki_options[:allow_uploads]    = true
+    wiki_options[:per_page_uploads] = true if mode == :page
+  end
+  opts.on('--math [RENDERER]', [:mathjax, :katex], 'Enable rendering of mathematical equations.',
+    'Valid renderers: mathjax, katex. Default: katex.') do |mode|
+    wiki_options[:math] = mode.nil? ? :katex : mode.to_sym
+    wiki_options[:math_config] = default_math_config
+    puts "To set a custom configuration for #{wiki_options[:math]} please add it to \'#{default_math_config}\' and commit it to the repo."
+  end
+  opts.on('--mathjax', 'Enable rendering of mathematical equations via mathjax.') do |mode|
+    puts 'DEPRECATION WARNING: --mathjax. This switch will be removed in the future. Please use: "--math mathjax".'
+    puts "If you are using a custom mathjax.config.js, please remame it to #{default_math_config}."
+    wiki_options[:math] = :mathjax
+    wiki_options[:math_config] = default_math_config
+  end
+  opts.on('--critic-markup', 'Enable support for annotations using CriticMarkup.') do
+    wiki_options[:critic_markup] = true
+  end
+  opts.on('--irb', 'Launch Gollum in \'console mode\', with a predefined API.') do
+    options[:irb] = true
+  end
+
+  opts.separator ''
+  opts.separator '  Minor:'
+
+  opts.on('--h1-title', 'Use the first \'<h1>\' as page title.') do
+    wiki_options[:h1_title] = true
+  end
+  opts.on('--no-display-metadata', 'Do not render metadata tables in pages.') do
+    wiki_options[:display_metadata] = false
+  end
+  opts.on('--user-icons [MODE]', [:gravatar, :identicon], 'Use specific user-icons for history view.',
+    'Can be set to \'gravatar\' or \'identicon\'. Default: standard avatar.') do |mode|
+    wiki_options[:user_icons] = mode.to_s
+  end
+  opts.on('--template-dir [PATH]', 'Specify custom mustache template directory. Only overrides templates that exist in this directory.') do |path|
+    wiki_options[:template_dir] = path
+  end
+  opts.on('--template-page', 'Use _Template.{ext} as a template for new pages.') do
+    wiki_options[:template_page] = true
+  end
+  opts.on('--lenient-tag-lookup', 'Internal links resolve case-insensitively, will treat spaces as hyphens, and will match the first page found with a certain filename, anywhere in the repository. Provides compatibility with Gollum 4.x.') do
+    puts 'DEPRECATION WARNING: --lenient-tag-lookup. This switch will be removed in the future. You will still be able to set the option via config.rb.'
+    wiki_options[:case_insensitive_tag_lookup] = true
+    wiki_options[:global_tag_lookup] = true
+    wiki_options[:hyphened_tag_lookup] = true
+  end
+  opts.on('--emoji', 'Parse and interpret emoji tags (e.g. :heart:) except when the leading colon is backslashed (e.g. \\:heart:).') do
+    wiki_options[:emoji] = true
+  end
+  opts.separator ''
+  opts.separator '  Common:'
+
+  opts.on('--help', 'Display this message.') do
+    puts opts
+    exit 0
+  end
+  opts.on('--version', 'Display the current version of Gollum.') do
+    puts 'Gollum ' + Gollum::VERSION
+    exit 0
+  end
+  opts.on('--versions', 'Display the current version of Gollum and auxiliary gems.') do
+    require 'gollum-lib'
+    puts 'Gollum ' + Gollum::VERSION
+    puts "Running on: #{RUBY_PLATFORM} with Ruby version #{RUBY_VERSION}"
+    puts 'Using:'
+    loaded_gemspecs =  Gem.loaded_specs
+    gollum_gems = ['gollum-lib', 'gollum-rjgit_adapter', 'rjgit', 'gollum-rugged_adapter', 'rugged']
+    puts Gem.loaded_specs.select{|name, spec| gollum_gems.include?(name)}.map {|name, spec| "#{name} #{spec.version}"}
+    puts "Markdown rendering gem: #{GitHub::Markup::Markdown.implementation_name}"
+    puts 'Other rendering gems:'
+    renderer_gems = ['RedCloth', 'org-ruby', 'creole', 'asciidoctor', 'wikicloth']
+    renderer_gems.each do |renderer|
+      begin
+        require renderer
+      rescue LoadError
+      end
+    end
+    results = Gem.loaded_specs.select{|name, spec| renderer_gems.include?(name)}.map {|name, spec| "#{name} #{spec.version}"}
+    puts results.empty? ? 'none' : results
+    exit 0
+  end
+
+  opts.separator ''
+  opts.separator '  Development:'
+
+  opts.on('--development-assets', 'For development purposes only. Use local instead of packaged assets.') do
+    wiki_options[:static] = false
+  end
+end
+
+# Read command line options into `options` hash
+begin
+  opts.parse!
+rescue OptionParser::InvalidOption => e
+  puts "gollum: #{e.message}"
+  puts 'gollum: try \'gollum --help\' for more information'
+  exit 1
+end
+
+# --gollum-path wins over ARGV[0]
+gollum_path = ARGV[0] || Dir.pwd
+
+if options[:irb]
+  require 'irb'
+  # http://jameskilton.com/2009/04/02/embedding-irb-into-your-ruby-application/
+  module IRB # :nodoc:
+    def self.start_session(binding)
+      unless @__initialized
+        args = ARGV
+        ARGV.replace(ARGV.dup)
+        IRB.setup(nil)
+        ARGV.replace(args)
+        @__initialized = true
+      end
+
+      ws  = WorkSpace.new(binding)
+      irb = Irb.new(ws)
+
+      @CONF[:IRB_RC].call(irb.context) if @CONF[:IRB_RC]
+      @CONF[:MAIN_CONTEXT] = irb.context
+
+      catch(:IRB_EXIT) do
+        irb.eval_input
+      end
+    end
+  end
+
+  begin
+    require 'gollum-lib'
+    wiki = Gollum::Wiki.new(gollum_path, wiki_options)
+    if !wiki.exist? then
+      raise Gollum::InvalidGitRepositoryError
+    end
+
+    puts
+    puts 'Loaded Gollum wiki at:'
+    puts "#{File.expand_path(gollum_path).inspect}"
+    puts
+    puts 'Example API calls:'
+    puts %(    page = wiki.page('page-name'))
+    puts %(    # => <Gollum::Page>)
+    puts
+    puts %(    page.raw_data)
+    puts %(    # => '# My wiki page')
+    puts
+    puts %(    page.formatted_data)
+    puts %(    # => '<h1>My wiki page</h1>')
+    puts
+    puts 'Full API documentation at:'
+    puts 'https://github.com/gollum/gollum-lib'
+    puts
+    IRB.start_session(binding)
+  rescue Gollum::InvalidGitRepositoryError, Gollum::NoSuchPathError
+    puts "Invalid Gollum wiki at #{File.expand_path(gollum_path).inspect}"
+    exit 0
+  end
+else
+  require 'gollum/app'
+  # TODO: Remove RACK_ENV fallback once gollum-7 is released (4 lines)
+  if ENV['RACK_ENV'] && !ENV['APP_ENV']
+    warn "[DEPRECATION] RACK_ENV will be ignored as of gollum-6.0.0, please use APP_ENV instead."
+    ENV['APP_ENV'] = ENV['RACK_ENV']
+  end
+  Precious::App.set(:environment, ENV.fetch('APP_ENV', :production).to_sym)
+  Precious::App.set(:gollum_path, gollum_path)
+  Precious::App.set(:wiki_options, wiki_options)
+
+  if cfg = options[:config]
+    # If the path begins with a '/' it will be considered an absolute path,
+    # otherwise it will be relative to the CWD
+    cfg = File.join(Dir.getwd, cfg) unless cfg.slice(0) == File::SEPARATOR
+    require cfg
+    # The options may have been updated. Reload them.
+    wiki_options = Precious::App.wiki_options
+  end
+
+  base_path = wiki_options[:base_path]
+
+  if base_path.nil?
+    Precious::App.run!(options)
+  else
+    require 'rackup'
+
+    # Rackup::Handler does not work with Ctrl + C. Use Rackup::Server instead.
+    Rackup::Server.new(:app => Precious::MapGollum.new(base_path), :Port => options[:port], :Host => options[:bind]).start
+  end
+end

data/gollum-6.1.0/bin/gollum-migrate-tags

@@ -0,0 +1,283 @@
+#!/usr/bin/env ruby
+#coding:utf-8
+require 'optparse'
+require 'pathname'
+require 'rubygems'
+
+wiki_options = {}
+options = {}
+
+migrate_options = {
+  :hyphenate => true
+}
+
+def setting(variable_name)
+  class_variable_name = :"@@#{variable_name.to_s}"
+
+  Object.class_variable_defined?(class_variable_name) &&
+    Object.class_variable_get(class_variable_name)
+end
+
+opts = OptionParser.new do |opts|
+opts.banner = <<EOF
+Use this tool to migrate a wiki repository created under Gollum versions 4.x or earlier to a 5.x compatible repo.
+It finds and repairs Gollum link tags that no longer work under 5.x for three reasons:
+
+* 5.x wiki internal links may contain spaces. [[Bilbo Baggins]] and [[Bilbo-Baggins]] therefore link to distinct pages.
+* 5.x wiki internal links are case sensitive
+* 5.x wiki internal links are no longer 'global'.
+
+* NB: you can use the --lenient-tag-lookup option in gollum >= 5.x to enable 4.x-backwards compatible tags.
+
+See https://github.com/gollum/gollum/wiki/5.0-release-notes#filename-handling for more information.
+Usage of this script comes without any warranty.
+
+Usage: gollum-migrate-tags /path/to/repo
+
+NB: without the --write flag, this will be a 'dry run' that doesn't actually make any changes, but outputs the changes that would be made.
+
+You can use the --page-file-dir and --config options as you would normally with gollum.
+
+Requires a non-bare repository. Recommended usage:
+
+1. Clone your wiki's repository to create a backup.
+2. Run this script on your cloned repo.
+3. If all looks sane, run the script with the --write option. This will overwrite files in your working directory, but not commit the changes, so you have time to review them.
+4. Do a 'git diff' to inspect the changes.
+5. Commit the changes if all looks sane, and push/pull them back into your original repo.
+
+Options:
+EOF
+  opts.on('-c', '--config [FILE]', 'Specify path to the Gollum\'s configuration file.') do |file|
+    options[:config] = file
+  end
+
+  opts.on('--page-file-dir [PATH]', 'Specify the subdirectory for all pages. Default: repository root.') do |path|
+    wiki_options[:page_file_dir] = path
+  end
+
+  opts.on('--prefer-relative-links', 'When specified, will try to replace broken links with relative links (\'[[Foo/Bar]]\' instead of \'[[/Subdir/Foo/Bar]]\') where possible.') do
+    migrate_options[:prefer_relative] = true
+  end
+
+  opts.on('--hyphenate', 'Default. Repair links that use spaces instead of hyphens: [[Bilbo Baggins]] -> [[Bilbo-Baggins]]') do
+    migrate_options[:hyphenate] = true
+  end
+
+  opts.on('--no-hyphenate', 'Turn off the --hyphenate option.') do
+    migrate_options[:hyphenate] = false
+  end
+
+  opts.on('--run-silent', 'Don\'t output anything.') do
+    migrate_options[:run_silent] = true
+  end
+
+  opts.on('--write', 'No dry run: actually perform the substitutions.') do
+    migrate_options[:no_dry_run] = true
+  end
+end
+
+# Read command line options into `options` hash
+begin
+  opts.parse!
+  migrate_options.each do |setting, value|
+    variable_name = :"@@#{setting.to_s}"
+
+    unless Object.class_variable_defined?(variable_name)
+      Object.class_variable_set(variable_name, value)
+    end
+  end
+  wiki_options[:page_file_dir] = setting(:page_file_dir) ? setting(:page_file_dir) : wiki_options[:page_file_dir] # Allow settings :page_file_dir through PAGE_FILE_DIR constant.
+rescue OptionParser::InvalidOption
+  puts "gollum-migrate-tags: #{$!.message}"
+  puts "gollum-migrate-tags: try 'gollum-migrate-tags --help' for more information"
+  exit
+end
+
+wiki_directory = ARGV[0] || Dir.pwd
+
+require 'gollum-lib'
+
+if cfg = options[:config]
+  # If the path begins with a '/' it will be considered an absolute path,
+  # otherwise it will be relative to the CWD
+  cfg = File.join(Dir.getwd, cfg) unless cfg.slice(0) == File::SEPARATOR
+  require cfg
+end
+
+class Gollum::Filter::CodeMigrator < Gollum::Filter::Code
+  def extract(data)
+    case @markup.format
+    when :asciidoc
+      data.gsub!(/^(\[source,([^\r\n]*)\]\n)?----\n(.+?)\n----$/m) do
+        cache_codeblock($~.to_s)
+      end
+    when :org
+      org_headers = %r{([ \t]*#\+HEADER[S]?:[^\r\n]*\n)*}
+      org_name = %r{([ \t]*#\+NAME:[^\r\n]*\n)?}
+      org_lang = %r{[ ]*([^\n \r]*)[ ]*[^\r\n]*}
+      org_begin = %r{([ \t]*)#\+BEGIN_SRC#{org_lang}\r?\n}
+      org_end = %r{\r?\n[ \t]*#\+END_SRC[ \t\r]*}
+      data.gsub!(/^#{org_headers}#{org_name}#{org_begin}(.+?)#{org_end}$/mi) do
+        cache_codeblock($~.to_s)
+      end
+    when :markdown
+      data.gsub!(/^([ ]{0,3})(~~~+) ?([^\r\n]+)?\r?\n(.+?)\r?\n[ ]{0,3}(~~~+)[ \t\r]*$/m) do
+        m_indent = Regexp.last_match[1]
+        m_start  = Regexp.last_match[2] # ~~~
+        m_lang   = Regexp.last_match[3]
+        m_code   = Regexp.last_match[4]
+        m_end    = Regexp.last_match[5] # ~~~
+        # The closing code fence must be at least as long as the opening fence
+        next '' if m_end.length < m_start.length
+        lang = m_lang ? m_lang.strip.split.first : nil
+        cache_codeblock($~.to_s)
+      end
+    end
+
+    data.gsub!(/^([ ]{0,3})``` ?([^\r\n]+)?\r?\n(.+?)\r?\n[ ]{0,3}```[ \t]*\r?$/m) do
+      cache_codeblock($~.to_s)
+    end
+    data
+  end
+
+  def process(data)
+    return data if data.nil? || data.size.zero? || @map.size.zero?
+    @map.each do |id, block| ## Just put the code blocks back in verbatim
+      data.gsub!(id, block)
+    end
+    data
+  end
+
+  def cache_codeblock(block)
+    id = "#{open_pattern}#{Digest::SHA1.hexdigest(block)}#{close_pattern}"
+    @map[id] = block
+    id
+  end
+end
+
+class ::Gollum::Filter::TagMigrator < Gollum::Filter::Tags
+  def process_tag(tag)
+    link_part, extra = parse_tag_parts(tag)
+    orig_tag = %{[[#{tag}]]}
+    return orig_tag if link_part.nil?
+
+    img_args = extra ? [extra, link_part] : [link_part]
+    mime = MIME::Types.type_for(::File.extname(img_args.first.to_s)).first
+
+    # For any kind of tag other than an internal link: just return the tag.
+    if tag =~ /^_TOC_/ || link_part =~ /^_$/ || link_part =~ /^#{INCLUDE_TAG}/ || (mime && mime.content_type =~ /^image/) || process_external_link_tag(link_part, extra) || process_file_link_tag(link_part, extra)
+      return orig_tag
+    end
+
+    # Try to resolve it as an internal Page link tag.
+    link = link_part
+    page = find_page_or_file_from_path(link)
+    anchor = nil
+
+    if page.nil? # No match yet, now try finding the page with anchor removed
+      if pos = link.rindex('#')
+        anchor = link[pos..-1]
+        link  = link[0...pos]
+      end
+
+      if link.empty? && anchor # Internal anchor link, don't search for the page but return the original tag
+        return orig_tag
+      end
+
+      page  = find_page_or_file_from_path(link)
+    end
+
+    if page
+      # Great, the link is not broken. Return the original tag.
+      return orig_tag
+    else
+      possibles = find_linked(link)
+      if possibles.empty?
+        log(:info, "Found no candidates for broken link: #{orig_tag}")
+        return orig_tag
+      else
+        if possibles.size > 1
+          log(:empty)
+          log(:warn, "Found multiple possibilities for the link '#{orig_tag}':")
+          possibles.map! {|p| Pathname.new(p)}
+          possibles.sort!
+          possibles.each{|p| log(:none, "* #{p}")}
+          log(:warn,"Picking #{possibles.first}")
+          log(:empty)
+        end
+        pick = possibles.first
+        return tag_for_pick(pick, orig_tag, extra, anchor, @markup.page.path)
+      end
+
+    end
+  end
+
+  private
+
+  def tag_for_pick(pick, orig_tag, extra, anchor, linking_page_path)
+    pick = if setting(:prefer_relative)
+      overlapping_path = Pathname.new(linking_page_path).dirname.to_s
+      overlapping_path = overlapping_path == '.' ? '' : ::File.join('/', overlapping_path)
+      relative_path = pick.to_s.match(/^#{overlapping_path}\/(.+)/)
+      relative_path ? relative_path[1] : pick
+    else
+      pick
+    end
+    new_tag = extra.nil? ? %{[[#{pick}#{anchor}]]} : %{[[#{extra}|#{pick}#{anchor}]]}
+    log(:info, "#{@markup.page.path}: Changing #{orig_tag} -> #{new_tag}")
+    new_tag
+  end
+end
+
+class ::Gollum::Filter::PlainTextMigrator < Gollum::Filter::PlainText
+  def extract(data)
+    data
+  end
+end
+
+filter_chain = [:PlainTextMigrator, :CodeMigrator, :TagMigrator]
+
+wiki = ::Gollum::Wiki.new(wiki_directory, wiki_options.merge({:filter_chain => filter_chain}))
+
+Object.class_variable_set(
+  :"@@wiki_tree",
+  wiki.tree_list(wiki.ref, true, true).map {|file| ::File.join('/', file.path)}
+)
+
+def find_linked(link)
+  link.gsub!(' ', '-') if setting(:hyphenate) # Match paths containing dashes instead of spaces
+  # If the link has no explicit file extension, test against the link + the '.' character.
+  # This is to avoid that 'Samwi' matches 'Samwise.md'
+  # If it has an explicit file extension ('Samwi.md'), just test against that.
+  test_path = ::File.extname(link).empty? ? /#{link}\..+/ : link
+  # Select pages from the wiki whose path =~ 'Foo/Bar/Samwi.*'
+  # Match case-insensitively to mimic 4.x behavior!
+  Object.class_variable_get(:"@@wiki_tree").select { |path|
+    path =~ /^\/(.*\/)?#{test_path}/i
+  }
+end
+
+def log(kind, msg = nil)
+  unless setting(:run_silent)
+    if kind == :none
+      puts msg
+    elsif kind == :empty
+      puts
+    else
+    puts "[#{kind.to_s.upcase}] #{msg}"
+    end
+  end
+end
+
+wiki.pages.each do |page|
+  log(:info,"Page #{page.path}")
+  new_data = page.formatted_data
+  if setting(:no_dry_run)
+    path = ::File.join(wiki.path, page.path)
+    f = File.new(path, 'w')
+    f.write(new_data)
+    f.close
+  end
+  log(:none, '====')
+end

data/gollum-6.1.0/config.rb

@@ -0,0 +1,12 @@
+=begin
+This file can be used to (e.g.):
+- alter certain inner parts of Gollum,
+- extend it with your stuff.
+
+It is especially useful for customizing supported formats/markups. For more information and examples:
+- https://github.com/gollum/gollum#config-file
+- https://github.com/gollum/gollum/wiki/Sample-config.rb
+
+=end
+
+# enter your Ruby code here ...

data/gollum-6.1.0/config.ru

@@ -0,0 +1,12 @@
+=begin
+You should use this file, if you wish to:
+- launch Gollum as a Rack app,
+- alter certain startup behaviour of Gollum.
+
+For more information and examples:
+- https://github.com/gollum/gollum/wiki/Gollum-via-Rack
+- https://github.com/gollum/gollum#config-file
+
+=end
+
+# enter your Ruby code here ...

data/gollum-6.1.0/contrib/automation/gollum-post

@@ -0,0 +1,66 @@
+#!/usr/bin/env ruby
+#
+# Distributed under the terms of the MIT License.
+#
+# Author: Sam Baskinger <basking2@yahoo.com>
+#
+# Description: gollum-post is an example script that shows how 
+#              to post a file to Gollum. This may be used
+#              to build scripts around CI/CD pipelines that 
+#              publish their documentation to Gollum.
+#
+
+require 'uri'
+require 'mechanize'
+require 'digest'
+
+GOLLUM=URI('https://mygollum.server')
+
+m = Mechanize.new()
+
+page="TestPage"
+path="/automated/docs"
+format="asciidoc"
+content="""
+= This is #{page}
+
+This page is automatically generated.
+"""
+message='Posting current documentation.'
+
+# Check if the page exists.
+p = m.get("#{GOLLUM}#{path}/#{page}")
+
+# If we were redirected to the creat page...
+if p.uri.to_s =~ /\/gollum\/create/
+
+  # ... then create the page.
+  p = m.post("#{GOLLUM}/gollum/create",
+             'keybinding' => 'default',
+             'page' => page,
+             'path' => path,
+             'format' => 'asciidoc',
+             'message' => 'Publish bot.',
+             'content' => content)
+else
+  # ... else, get the previous content and update it.
+  p = m.get("#{GOLLUM}/gollum/edit#{path}/#{page}")
+
+  # Get the previous content. You _could_ check if this is unchanged at this 
+  # step and post nothing.
+  previous_content = p.xpath('//textarea[@id="gollum-editor-body"]')[0].text
+
+  # The previous ETag is the Git SHA-1. We need this to replace the previous contents.
+  prev_etag = Digest::SHA1.hexdigest("blob #{previous_content.length}\0#{previous_content}")
+
+  # Post the updated document using the ETag of the previous document to avoid collisions.
+  p = m.post("#{GOLLUM}/gollum/edit#{path}/#{page}",
+             'keybinding' => 'default',
+             'page' => page,
+             'path' => path,
+             'format' => 'asciidoc',
+             'message' => message,
+             'etag' => prev_etag,
+             'content' => content)
+end
+

data/gollum-6.1.0/contrib/openrc/conf.d/gollum

@@ -0,0 +1,3 @@
+GOLLUM_USER=gollum
+GOLLUM_BASE=/home/gollum/wiki
+GOLLUM_OPTS="--config /home/gollum/config.rb"