anchor.diff:  
   giblish is used to convert a source directory tree containing AsciiDoc files to
   a destination directory tree containing the corresponding html or pdf files
  -and add a handy index page for the converted files.
  +and add some handy tools for easier navigation of the resulting files.
   
  -If the source directory tree is part of a git repository, giblish can generate
  -separate html/pdf trees for branches and/or tags that match a user specified
  -regexp (see examples below).
  +The tools include:
  +
  + * An index page listing all rendered documents with clickable links
  + * Document ids - Note: the implementation of this is giblish-specific and thus
  +   you need to render your adoc files using giblish to make this work as intended.
  +   You can use document ids to:
  + ** Reference one doc in the source tree from another doc without depending on file
  +    names or relative paths. The referenced doc can thus be moved within the sourc
  +    tree or change its file name and the reference will still be valid.
  + ** Validate doc id references during document rendering and thus be alerted to
  +    any invalid doc id references.
  + ** Let giblish generate a clickable graph of all document references (requires
  +    graphviz and the 'dot' tool).
  + * A (stripped-down but nonetheless useful) text-search of your documents (requires
  +   that you view your docs via a web-server.
  + * If the source directory tree is part of a git repository, giblish can generate
  +   separate html/pdf trees for branches and/or tags that match a user specified
  +   regexp (see examples below).
   
   == Dependencies and credits
   
  -Giblish is basically a wrapper (with some extra candy) around the awesome
  -*asciidoctor* and *asciidoctor-pdf* projects. Thank you @mojavelinux and others for
  -making these brilliant tools available!!
  +Giblish uses the awesome *asciidoctor* and *asciidoctor-pdf* projects under the hood.
  +Thank you @mojavelinux and others for making these brilliant tools available!!
   
   == Installation
   
  
positive.code: the `my_dst_root` dir.
  ====
  
  .Advanced usage; Publish a static html site from a git repo
  ====
  giblish can be used to inject a tree of html docs suitable for serving via a web
  server (e.g. Apache). Below is an example how to create such a tree. If you
  combine this with a server side git hook that invokes this script after push,
  you will have a way of auto publish your latest documents and/or documents at
  specific git tags. In principle a poor-mans document managing system.
  
  Assumptions:
  
  
negative.code: The `-w` switch above will strip the `/var/www/html` from the css link so that
  the paths to the css will be correct in the context of the serving of the
  pages via the web server.
  
  The `-m` switch above will build a database (JSON file) with enough information
  to enable a cgi-script to provide a text-search capability for your users. The
  cgi-script must be located at http://your_web_site.com/cgi-bin/giblish-search.cgi
  and this gem provides a default implementation that you can copy from the .../lib
  folder to the correct destination.
  ====
  