giblish 0.2.3 → 0.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 10f9c75389bc10dda386f5cd9cfb0855f62e06ca
-  data.tar.gz: fe089e9bff2e72e3eccff4e34f011cc70c4d88de
+  metadata.gz: 40b38c28081c397793557e264413ee5929ff6cfc
+  data.tar.gz: 07f92ab1e58fcd19b9584f29dbc9198aa0076108
 SHA512:
-  metadata.gz: 804bfc3f306c990d510039667041115854a2a7ab4853b39fd4139e7170e2b718ed1229a039c6212c0a5fd6a622c93d81ea24ca029cc2e7ca94d90cd87b13b87c
-  data.tar.gz: 06dc7ba624c02f6efae6ac2a34da8ee46d3f9615d0bf6264af357fe83f60398bf64ff89d7f28e1e45197f081f1268ee323397c6bc0ef8d3fda70247a43d28167
+  metadata.gz: 238635d62f4c703c9f0bb86600b7effd1aadadad53d9c8a84d082ec96473ca032e2cf57cc643832b05f8e8b930466a08ecce751c21503cbfe715d63599fcce8f
+  data.tar.gz: 57715ef6f6db7a14215b235aead2d567d025a46c9e810b67b0e249c39e64a89dd6288fc58b83496ecaa3a152e6c453d373652358cff34071b8129505b855001a

data/.rubocop.yml

@@ -0,0 +1,8 @@
+
+AllCops:
+  TargetRubyVersion: 2.3
+  Enabled: true
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+  Enabled: true

data/Rakefile

@@ -7,5 +7,13 @@ Rake::TestTask.new(:test) do |t|
   t.test_files = FileList["test/**/*_test.rb"]
 end
 
+Rake::TestTask.new(:current_test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/run_test.rb"]
+  # t.test_files = FileList["test/**/docid_test.rb"]
+end
+
+
 # task :default => :spec
 task :default => :test

data/data/testdocs/malformed/no_header.adoc

@@ -0,0 +1,5 @@
+This document does not have any title and sections. Only a couple of plain text paragraphs. It does however, contain a docid which should not be parsed.
+:docid: MF-001
+
+
+Lets see if that will mess anything up

data/data/testdocs/toplevel.adoc

@@ -0,0 +1,19 @@
+= Toplevel document for Giblish test suite
+:toc: left
+:docid: GT-001
+:imagesdir: images
+:numbered:
+
+This is the preamble
+
+== Purpose
+
+This doc tests some aspects of giblish.
+
+== Another section
+
+With some text...
+
+=== A sub-section
+
+With some more text...

data/data/testdocs/wellformed/docidtest/docid_1.adoc

@@ -0,0 +1,24 @@
+= Testing document ids
+:toc:
+:docid: WF-013
+
+== Purpose
+
+To test the basic functionality of document id references.
+This paragraph can be referenced as <<:docid:WF-013#Purpose,This paragraph>>.
+
+Other valid docid references::
+
+  * << :docid:WF-013,Using space before>>
+  * << :docid: WF-013,Using space and tabs>>
+  * <<:docid:WF-013#Testing Document ids>> No title but hash and section.
+  * <<:docid:WF-013>> No title and no hash
+  * <<:docid:WF-022,docid_2 adoc>> Another document within the tree.
+  * <<:docid:WF-001#Purpose>> Reference a section in another document
+
+Invalid docid references::
+
+ * <<:DOCID:WF-022>> Wrong case
+ * <<:docid:WF-013 No ending signs
+ * <<:docid:WF-0134567890123>> Doc id longer than max chars
+ * <<:docid:W>> Doc id too short

data/data/testdocs/wellformed/docidtest/docid_2.adoc

@@ -0,0 +1,8 @@
+= Docid test doc 2
+:toc: left
+:numbered:
+:docid: WF-022
+
+== Purpose
+
+To test that Giblish can use <<:docid: WF-013, doc-id references>> to refer to external documents.

data/data/testdocs/wellformed/simple.adoc

@@ -0,0 +1,14 @@
+= A simple Ascidoc document
+Using the author line as sub-title
+:toc:
+:docid: WF-001
+:imagesdir: images
+:numbered:
+
+== Purpose
+
+To provide a barebone, wellformed asciidoc document.
+
+== The gist
+
+This paragraph is the only content.

data/exe/giblish

@@ -4,4 +4,4 @@
 
 require_relative "../lib/giblish"
 
-Giblish.application.run
+Giblish.application.run_from_cmd_line

data/giblish.gemspec

@@ -33,6 +33,10 @@ Gem::Specification.new do |spec|
 
   # Usage: spec.add_runtime_dependency "[gem name]", [[version]]
   spec.add_runtime_dependency "git", "~> 1.3"
-  spec.add_runtime_dependency "asciidoctor", "~> 1.5"
-  spec.add_runtime_dependency "asciidoctor-pdf", [">= 1.5.0.alpha.15"]
+  spec.add_runtime_dependency "asciidoctor", "1.5", ">= 1.5.6.1"
+  spec.add_runtime_dependency "asciidoctor-pdf", [">= 1.5.0.alpha.16"]
+  # needed by asciidoctor-pdf, see instructions at
+  # https://github.com/asciidoctor/asciidoctor-pdf/releases
+  spec.add_runtime_dependency "prawn-svg", "0.27", ">= 0.27.1"
+
 end

data/lib/giblish/application.rb

@@ -5,29 +5,51 @@ require_relative "utils"
 
 module Giblish
   class Application
-    def run
+
+    def run_with_args(args)
+      run args
+    end
+
+    def run_from_cmd_line
+      run ARGV
+    end
+
+    def run(args)
       # setup logging
       Giblog.setup
 
       # Parse cmd line
-      cmdline = CmdLineParser.new ARGV
+      cmdline = CmdLineParser.new args
 
-      Giblog.logger.debug { "cmd line args: #{cmdline.args.to_s}" }
+      Giblog.logger.debug { "cmd line args: #{cmdline.args}" }
 
       # Convert using given args
       begin
         if cmdline.args[:gitRepoRoot]
-          Giblog.logger.info {"User asked to parse a git repo"}
+          Giblog.logger.info { "User asked to parse a git repo" }
           GitRepoParser.new cmdline.args
         else
           tc = TreeConverter.new cmdline.args
           tc.walk_dirs
         end
+        Giblog.logger.info { "Giblish is done!" }
       rescue Exception => e
-        puts "Error: #{e.message}"
-        puts "\n"
-        puts "Backtrace:\n\t#{e.backtrace.join("\n\t")}"
-        puts cmdline.usage
+        log_error e
+        exit(1)
+      end
+    end
+
+    private
+
+    def log_error(ex)
+      Giblog.logger.error do
+        <<~ERR_MSG
+          Error: #{ex.message}
+          Backtrace:
+          \t#{ex.backtrace.join("\n\t")}
+
+          cmdline.usage
+        ERR_MSG
       end
     end
   end

data/lib/giblish/buildindex.rb

@@ -41,6 +41,7 @@ class BasicIndexBuilder
   # set up the basic index building info
   def initialize(path_manager)
     @paths = path_manager
+    @nof_missing_titles = 0
     @added_docs = []
     @src_str = ""
   end
@@ -305,6 +306,8 @@ end
 class GitRepoIndexBuilder < BasicIndexBuilder
   def initialize(path_manager, git_repo_root)
     super path_manager
+
+    # initialize state variables
     @git_repo_root = git_repo_root
 
     # no repo root given...
@@ -314,9 +317,6 @@ class GitRepoIndexBuilder < BasicIndexBuilder
       # Make sure that we can "talk" to git if user feeds us
       # a git repo root
       @git_repo = Git.open(@git_repo_root)
-
-      # initialize state variables
-      @nof_missing_titles = 0
     rescue Exception => e
       Giblog.logger.error { "No git repo! exception: #{e.message}" }
     end

data/lib/giblish/cmdline.rb

@@ -51,6 +51,11 @@ class CmdLineParser
                              a separate subdir under the destination root dir.
   -c --local-only            do not try to fetch git info from any remotes of the
                              repo before generating documents.
+  -d --resolve-docid         use two passes, the first to collect :docid:
+                             attributes in the doc headers, the second to
+                             generate the documents and use the collected
+                             doc ids to resolve relative paths between the
+                             generated documents
   --log-level                set the log level explicitly. Must be one of
                              debug, info, warn (default), error or fatal.
 ENDHELP
@@ -60,12 +65,14 @@ ENDHELP
 
     # handle help and version requests
     if @args[:help]
+      puts USAGE
+      puts ""
       puts HELP
-      exit
+      exit 0
     end
     if @args[:version]
       puts "Giblish v#{Giblish::VERSION}"
-      exit
+      exit 0
     end
 
     # set log level
@@ -96,7 +103,7 @@ ENDHELP
     else
       puts "Invalid log level specified. Run with -h to see supported levels"
       puts USAGE
-      exit
+      exit 1
     end
   end
 
@@ -115,6 +122,7 @@ ENDHELP
       flatten: false,
       suppressBuildRef: false,
       localRepoOnly: false,
+      resolveDocid: false,
       webRoot: false
     }
 
@@ -136,9 +144,10 @@ ENDHELP
       when "-g", "--git-branches" then next_arg = :gitBranchRegexp
       when "-t", "--git-tags"     then next_arg = :gitTagRegexp
       when "-c", "--local-only"   then @args[:localRepoOnly] = true
+      when "-d", "--resolve-docid" then @args[:resolveDocid] = true
       when "-s", "--style"        then next_arg = :userStyle
       when "-w", "--web-root"     then next_arg = :webRoot
-      when "--log-level"            then next_arg = :logLevel
+      when "--log-level"          then next_arg = :logLevel
       else
         if next_arg
           @args[next_arg] = arg
@@ -159,7 +168,7 @@ ENDHELP
     end
 
     puts USAGE
-    exit
+    exit 1
   end
 
   def ensure_required_args
@@ -168,7 +177,7 @@ ENDHELP
 
     puts "Error: Too few arguments."
     puts USAGE
-    exit
+    exit 1
   end
 
   def set_gitrepo_root
@@ -185,6 +194,6 @@ ENDHELP
     # We should not get here if everything is koscher...
     puts "Error: Source dir not in a git working dir despite -g or -t option given!"
     puts USAGE
-    exit
+    exit 1
   end
 end

data/lib/giblish/core.rb

@@ -13,6 +13,7 @@ require "asciidoctor-pdf"
 
 require_relative "cmdline"
 require_relative "buildindex"
+require_relative "docid"
 
 # Base class for document converters. It contains a hash of
 # conversion options used by derived classes
@@ -42,26 +43,53 @@ class DocConverter
     @converter_options[:backend] = options[:backend]
   end
 
+  def convert_str(input_str, src_path, output_file = nil)
+    unless input_str.is_a?(String)
+      raise ArgumentError("Trying to invoke convert_str with non-string!")
+    end
+
+    # use the same options as when converting all docs
+    # in the tree but make sure Asciidoctor doesn't write to file
+    index_opts = @converter_options.dup
+    index_opts.delete(:to_file)
+    index_opts.delete(:to_dir)
+
+    # load and convert the string using the converter options
+    doc = Asciidoctor.load input_str, index_opts
+    output = doc.convert index_opts
+
+    # determine the correct output path
+    if output_file.nil?
+      output_file = @paths.adoc_output_file(src_path,
+                                            @converter_options[:fileext])
+    end
+
+    # write the converted document to file and return the doc
+    doc.write output, output_file.to_s
+    doc
+  end
+
   # Public: Convert one single adoc file using the specific conversion
   # options.
   #
-  # filepath - a string with the absolute path to the input file to convert
+  # filepath - a pathname with the absolute path to the input file to convert
   #
   # Returns: The resulting Asciidoctor::Document object
   def convert(filepath)
+    unless filepath.is_a?(Pathname)
+      raise ArgumentError, "Trying to invoke convert with non-pathname!"
+    end
+
     Giblog.logger.info { "Processing: #{filepath}" }
 
     # create an asciidoc doc object and convert to requested
     # output using current conversion options
     @converter_options[:to_dir] = @paths.adoc_output_dir(filepath).to_s
-    @converter_options[:base_dir] = Giblish::PathManager.closest_dir(
-      filepath
-    ).to_s
-    @converter_options[:to_file] = Giblish::PathManager.get_new_basename(
-      filepath,
-      @converter_options[:fileext]
-    )
-
+    @converter_options[:base_dir] =
+      Giblish::PathManager.closest_dir(filepath).to_s
+    @converter_options[:to_file] =
+      Giblish::PathManager.get_new_basename(filepath,
+                                            @converter_options[:fileext])
 
     Giblog.logger.debug { "converter_options: #{@converter_options}" }
     # do the actual conversion
@@ -160,6 +188,18 @@ class PdfConverter < DocConverter
   def initialize(options)
     super options
 
+    pdf_attrib = setup_pdf_attribs
+
+    backend_options = { backend: "pdf", fileext: "pdf" }
+    add_backend_options backend_options, pdf_attrib
+  end
+
+  private
+
+  def setup_pdf_attribs()
+    # only set this up if user has specified a resource dir
+    return {} unless @paths.resource_dir_abs
+
     pdf_attrib = {
       "pdf-stylesdir" => "#{@paths.resource_dir_abs}/themes",
       "pdf-style" => "giblish.yml",
@@ -172,21 +212,12 @@ class PdfConverter < DocConverter
       pdf_attrib["pdf-style"] =
         /\.(yml|YML)$/ =~ @user_style ? @user_style : "#{@user_style}.yml"
 
-    backend_options = { backend: "pdf", fileext: "pdf" }
-    add_backend_options backend_options, pdf_attrib
+    pdf_attrib
   end
 end
 
 class TreeConverter
 
-  # def init_dst_root
-  #   # make sure destination dir exists
-  #   Giblog.logger.info do
-  #     "Will generate docs to destination root: #{@paths.dst_root_abs}"
-  #   end
-  #   Dir.exist?(@paths.dst_root_abs) || FileUtils.mkdir_p(@paths.dst_root_abs)
-  # end
-
   # Required options:
   #  srcDirRoot
   #  dstDirRoot
@@ -243,7 +274,7 @@ class TreeConverter
       # do the conversion and capture eventual errors that
       # the asciidoctor lib writes to stderr
       adoc_stderr = Giblish.with_captured_stderr do
-        adoc = @conversion.convert(filepath)
+        adoc = @conversion.convert filepath
       end
 
       # build the reference index if the user wants it
@@ -251,17 +282,20 @@ class TreeConverter
     rescue Exception => e
       str = "Error when converting doc: #{e.message}\n"
       e.backtrace.each { |l| str << "#{l}\n" }
-      Giblog.logger.warn { str }
+      Giblog.logger.error { str }
       @options[:suppressBuildRef] || @index_builder.add_doc_fail(filepath, e)
     end
   end
 
   def walk_dirs
+    # pass 1: collect all found doc ids if user wishes
+    collect_doc_ids if @options[:resolveDocid]
+
     # traverse the src file tree and convert all files that ends with
     # .adoc or .ADOC
     Find.find(@paths.src_root_abs) do |path|
-      ext = File.extname(path)
-      to_asciidoc(path) if !ext.empty? && ext.casecmp(".ADOC").zero?
+      p = Pathname.new(path)
+      to_asciidoc(p) if adocfile? p
     end
 
     # check if we shall build index or not
@@ -274,6 +308,30 @@ class TreeConverter
     @index_builder = nil
     GC.start
   end
+
+  private
+
+  def adocfile?(path)
+    path.extname.casecmp(".ADOC").zero?
+  end
+
+  def collect_doc_ids
+    # Register the docid preprocessor hook
+    Giblish.register_extensions
+
+    # Make sure that no prior docid's are hangning around
+    Giblish::DocidCollector.clear_cache
+    idc = Giblish::DocidCollector.new
+
+    # traverse the src file tree and collect ids from all
+    # .adoc or .ADOC files
+    Find.find(@paths.src_root_abs) do |path|
+      p = Pathname.new(path)
+      idc.parse_file(p) if adocfile? p
+    end
+    idc
+  end
+
 end
 
 class GitRepoParser
@@ -325,7 +383,7 @@ class GitRepoParser
       end
     end
 
-    # Get the branches the user wants to parse
+    # Get the tags the user wants to parse
     if options[:gitTagRegexp]
       regexp = Regexp.new options[:gitTagRegexp]
       @user_tags = @git_repo.tags.select do |t|

data/lib/giblish/docid.rb

@@ -0,0 +1,163 @@
+
+require_relative "./utils.rb"
+
+require 'asciidoctor'
+require 'asciidoctor/extensions'
+
+module Giblish
+  # Parse all adoc files for :docid: attributes
+  class DocidCollector < Asciidoctor::Extensions::Preprocessor
+    # Use a class-global docid_cache since asciidoctor creates a new instance
+    # for each preprocessor hook
+    @docid_cache = {}
+    class << self
+      def docid_cache
+        @docid_cache
+      end
+
+      def clear_cache
+        @docid_cache = {}
+      end
+    end
+
+    # The minimum number of characters required for a valid doc id
+    ID_MIN_LENGTH = 2
+
+    # The maximum number of characters required for a valid doc id
+    ID_MAX_LENGTH = 10
+
+    # Note: I don't know how to hook into the 'initialize' or if I should
+    # let this be, currently it is disabled...
+    # def initialize(*everything)
+    #   super(everything)
+    # end
+
+    # Helper method that provides the user with a way of processing only the
+    # lines within the asciidoc header block.
+    # The user must return nil to get the next line.
+    #
+    # ex:
+    # process_header_lines(file_path) do |line|
+    #   if line == "Quack!"
+    #      puts "Donald!"
+    #      1
+    #   else
+    #      nil
+    #   end
+    # end
+    def process_header_lines(path)
+      state = "before_header"
+      File.foreach(path) do |line|
+        case state
+        when "before_header" then (state = "in_header" if line =~ /^=+.*$/)
+        when "in_header" then (state = "done" if line =~ /^\s*$/ || yield(line))
+        when "done" then break
+        end
+      end
+    end
+
+    # Check if a :docid: <id> entry exists in the header.
+    # According to http://www.methods.co.nz/asciidoc/userguide.html#X95
+    # the header is optional, but if it exists it:
+    # - must start with a titel (=+ <My Title>)
+    # - ends with one or more blank lines
+    # - does not contain any blank line
+    def parse_file(path)
+      Giblog.logger.debug { "parsing file #{path} for docid..." }
+      process_header_lines(path) do |line|
+        m = /^:docid: +(.*)$/.match(line)
+        if m
+          # There is a docid defined, cache the path and doc id
+          validate_and_add m[1], path
+        end
+      end
+    end
+
+    # This hook is called by Asciidoctor once for each document _before_
+    # Asciidoctor processes the adoc content.
+    #
+    # It replaces references of the format <<:docid: ID-1234,Hello >> with
+    # references to a resolved relative path.
+    def process(document, reader)
+      reader.lines.each do |line|
+        line.gsub!(/<<\s*:docid:\s*(.*)>>/) do |_m|
+          replace_doc_id Regexp.last_match(1), document.attributes["docfile"]
+        end
+      end
+      reader
+    end
+
+    def substitute_ids_file(path)
+      substitute_ids(File.read(path), path)
+    end
+
+    def substitute_ids(src_str, src_path)
+      src_str.gsub!(/<<\s*:docid:\s*(.*)>>/) do |_m|
+        replace_doc_id Regexp.last_match(1), src_path
+      end
+      src_str
+    end
+
+    private
+
+    # Helper method to shorten calls to docid_cache from instance methods
+    def docid_cache
+      self.class.docid_cache
+    end
+
+    def get_rel_path(src_path, doc_id)
+      return "UNKNOWN_DOC" unless docid_cache.key? doc_id
+
+      rel_path = docid_cache[doc_id]
+                 .dirname
+                 .relative_path_from(Pathname.new(src_path).dirname) +
+                 docid_cache[doc_id].basename
+      rel_path.to_s
+    end
+
+    # The input string shall contain the expression between
+    # <<:docid:<input_str>>> where the <input_str> is in the form
+    # <id>[#section][,display_str]
+    #
+    # The result shall be a valid ref in the form
+    # <<target_doc.adoc#[section][,display_str]>>
+    def replace_doc_id(input_str, src_path)
+      ref, display_str = input_str.split(",").each(&:strip)
+      display_str = "" if display_str.nil?
+      display_str.prepend "," if display_str.length.positive?
+
+      id, section = ref.split "#"
+      section = "" if section.nil?
+
+      Giblog.logger.debug { "Replace docid ref in doc #{src_path}..." }
+      "<<#{get_rel_path(src_path, id)}##{section}#{display_str}>>"
+    end
+
+    def validate_and_add(doc_id, path)
+      id = doc_id.strip
+      Giblog.logger.debug { "found possible docid: #{id}" }
+
+      # make sure the id is within the designated length and
+      # does not contain a '#' symbol
+      if id.length.between?(ID_MIN_LENGTH, ID_MAX_LENGTH) &&
+         !id.include?("#")
+        # the id is ok
+        if docid_cache.key? id
+          Giblog.logger.warn { "Found same doc id twice (#{id}). Using last found id."}
+        end
+        docid_cache[id] = Pathname(path)
+      else
+        Giblog.logger.error { "Invalid docid: #{id}, this will be ignored!" }
+      end
+    end
+  end
+
+  # Helper method to register the docid preprocessor extension with
+  # the asciidoctor engine.
+  def register_extensions
+    Asciidoctor::Extensions.register do
+      preprocessor DocidCollector
+    end
+  end
+  module_function :register_extensions
+end

data/lib/giblish/utils.rb

@@ -4,15 +4,19 @@ require "fileutils"
 
 class Giblog
   def self.setup
-    if @logger.nil?
-      @logger = Logger.new(STDOUT)
-      @logger.formatter = proc do |_severity, datetime, _progname, msg|
-        "#{datetime.strftime('%H:%M:%S')} - #{msg}\n"
-      end
+    return if defined? @logger
+    @logger = Logger.new(STDOUT)
+    @logger.formatter = proc do |_severity, datetime, _progname, msg|
+      "#{datetime.strftime('%H:%M:%S')} - #{msg}\n"
     end
   end
 
   def self.logger
+    unless defined? @logger
+      puts "!!!! Error: Trying to access logger before setup !!!!"
+      puts caller
+      exit
+    end
     @logger
   end
 end
@@ -61,6 +65,21 @@ module Giblish
       src_abs.relative_path_from(@src_root_abs)
     end
 
+    def adoc_output_file(infile_path, extension)
+      # Get absolute source dir path
+      src_dir_abs = self.class.closest_dir infile_path
+
+      # Get relative path from source root dir
+      src_dir_rel = src_dir_abs.relative_path_from(@src_root_abs)
+
+      # Get the destination path relative the absolute source
+      # root
+      dst_dir_abs = @dst_root_abs.realpath.join(src_dir_rel)
+
+      # return full file path with correct extension
+      dst_dir_abs + get_new_basename(infile_path, extension)
+    end
+
     # Public: Get the path to the directory where to generate the given
     #         file. The path is given as the relative path from the source adoc
     #         file to the desired output directory (required by the Asciidoctor

data/lib/giblish/version.rb

@@ -1,3 +1,3 @@
 module Giblish
-  VERSION = "0.2.3"
+  VERSION = "0.2.5"
 end

data/lib/giblish.rb

@@ -18,5 +18,5 @@ module Giblish
 end
 
 if __FILE__ == $PROGRAM_NAME
-  Giblish.application.run
+  Giblish.application.run_from_cmd_line
 end

data/resources/themes/giblish.yml

@@ -245,14 +245,14 @@ thematic_break:
   margin_bottom: $vertical_rhythm * 2.5
 description_list:
   term_font_style: bold
-  term_font_color: $giblish_green
+  term_font_color: $primecolor
   term_spacing: $vertical_rhythm / 4
   description_indent: $horizontal_rhythm * 1.25
 outline_list:
   indent: $horizontal_rhythm * 1.5
   # NOTE item_spacing applies to list items that do not have complex content
   item_spacing: $vertical_rhythm / 4
-  marker_font_color: $giblish_green
+  marker_font_color: $primecolor
 table:
   border_color: $primecolor
   border_width: $base_border_width * 0.25

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: giblish
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.2.5
 platform: ruby
 authors:
 - Anders Rillbert
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-06-24 00:00:00.000000000 Z
+date: 2017-09-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -70,30 +70,56 @@ dependencies:
   name: asciidoctor
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - '='
       - !ruby/object:Gem::Version
         version: '1.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.5.6.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - '='
       - !ruby/object:Gem::Version
         version: '1.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.5.6.1
 - !ruby/object:Gem::Dependency
   name: asciidoctor-pdf
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.5.0.alpha.15
+        version: 1.5.0.alpha.16
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.5.0.alpha.15
+        version: 1.5.0.alpha.16
+- !ruby/object:Gem::Dependency
+  name: prawn-svg
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: '0.27'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.27.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: '0.27'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.27.1
 description: TBD...
 email:
 - anders.rillbert@kutso.se
@@ -103,12 +129,18 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".rubocop.yml"
 - Gemfile
 - LICENSE
 - README.adoc
 - Rakefile
 - bin/console
 - bin/setup
+- data/testdocs/malformed/no_header.adoc
+- data/testdocs/toplevel.adoc
+- data/testdocs/wellformed/docidtest/docid_1.adoc
+- data/testdocs/wellformed/docidtest/docid_2.adoc
+- data/testdocs/wellformed/simple.adoc
 - exe/giblish
 - giblish.gemspec
 - lib/giblish.rb
@@ -116,6 +148,7 @@ files:
 - lib/giblish/buildindex.rb
 - lib/giblish/cmdline.rb
 - lib/giblish/core.rb
+- lib/giblish/docid.rb
 - lib/giblish/pathtree.rb
 - lib/giblish/utils.rb
 - lib/giblish/version.rb