anchor.diff:  
   image::Render Documents.png[]
   
  -=== Sequence for viewing documents
  +=== The setup process for Jenkins and git hook combo
   
  -This is just the standard way of accessing a web site. The html page served by the web server will be the latest generated html page.
  -
  -image::View Documents.png[]
  -
  -== Server requirements
  -
  -The server that will render the documents need the following tools installed:
  -
  - * git
  - * giblish
  -
  -The server that runs Jenkins will (of course) need Jenkins installed.
  -
  -=== Setup server for both Jenkins and doc rendering on Ubuntu 16.04
  -
  -The easiest setup is to use the same server to run Jenkins and to render the documents. For an Ubuntu 16.04 installation, you can install the needed tools as follows:
  -
  - * install git `sudo apt install git`
  - * install Jenkins See https://www.digitalocean.com/community/tutorials/how-to-install-jenkins-on-ubuntu-16-04[this doc].
  - * install giblish `sudo gem install giblish`
  -
  -
  -== server side git hooks
  -
  -git supports hooks in several parts of the sequence of getting changes ommitted and pushed to a remote repo. For details on git hooks see https://git-scm.com/book/en/v2/Customizing-Git-Git-Hooks[this doc]. See <<post-update-hook>> An example of a `post-update` hook that triggers Jenkins
  -
  +bla bla ö
   
   [appendix]
   [[post-update-hook]]
  
positive.code: = Setup web site powered by giblish
  :imagesdir: setup_server_assets
  :numbered:
  
  == Purpose
  
  To describe how to use giblish as a tool in creating a static web site with documents automatically generated from a git repo.
  
  This text covers two deployment scenarios; one using git hooks only, and one using a combination of git hooks and Jenkins. It has only been tested on Linux servers (Ubuntu). Most of the tools and scripts should work on a Windows server as well but might need some tweaking and is, again, not tested.
  
  == Deploy using git hooks only
  
  
negative.code: == Jenkins pipeline script
  
  Below is a very basic example of a Jenkins pipeline that triggers giblish to render html and pdf documents located in a specific directory in a git repository.
  
  TBD
  