Add last update date on docs page. (#343)

Signed-off-by: tiaoyuw <tiaoyuw@ca.ibm.com>

Author: travis1111

.gitignore

@@ -1,3 +1,7 @@
 /.DS_Store
 /.settings
 /.project
+/_tmp
+/_jekyllHome
+/vendor
+/docs/.jekyll-cache

build.sh

@@ -4,20 +4,49 @@ RED='\033[0;31m'
 NC='\033[0m' # No Color
 GREEN='\033[0;32m'
 
+# Fix the timestamp
+# https://stackoverflow.com/questions/21735435/git-clone-changes-file-modification-time
+# https://gist.github.com/HackingGate/9e8169c7645b074b2f40c959ca20d738
 
+echo "Fixing file timestamp..."
+
+OS=${OS:-`uname`}
+
+if [ "$OS" = 'Darwin' ]; then
+  get_touch_time() {
+    date -r ${unixtime} +'%Y%m%d%H%M.%S'
+  }
+else
+  # default Linux
+  get_touch_time() {
+    date -d @${unixtime} +'%Y%m%d%H%M.%S'
+  }
+fi
+
+git ls-tree -r --name-only HEAD | while read filename; do 
+  unixtime=$(git log -1 --format="%at" -- "${filename}")
+  touchtime=$(get_touch_time)
+  touch -t ${touchtime} "${filename}"
+done
+
+mkdir -p _tmp
+mkdir -p _jekyllHome
 # Compile the files
 docker run --rm -it \
   --volume="$PWD/docs:/srv/jekyll" \
+  --volume="$PWD/_tmp:/tmp" \
+  --volume="$PWD/_jekyllHome:/home/jekyll" \
   --volume="$PWD/vendor/bundle:/usr/local/bundle" \
   -p 4321:4321 jekyll/jekyll:3.8.5 \
-  jekyll build
+  /bin/bash -c "bundle install && jekyll build"
+
 
 # Launch the site in apache
 
 docker run -dit --name my-apache-app -p 8765:80 -v "$PWD/docs/_site":/usr/local/apache2/htdocs/codewind/ httpd:2.4
 
 # Check link 
-docker run --network="host" --rm -it -u $(id -u):$(id -g) linkchecker/linkchecker --verbose http://localhost:8765/codewind/
+docker run --network="host" --rm -it -u $(id -u):$(id -g) linkchecker/linkchecker http://localhost:8765/codewind/
 rc=$?
 
 # Shut down apache

docs/Gemfile

@@ -0,0 +1,8 @@
+source 'https://rubygems.org'
+
+gem 'jekyll'
+gem 'minima'
+
+group :jekyll_plugins do
+  gem "jekyll-last-modified-at"
+end

docs/Gemfile.lock

@@ -0,0 +1,79 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.7.0)
+      public_suffix (>= 2.0.2, < 5.0)
+    colorator (1.1.0)
+    concurrent-ruby (1.1.5)
+    em-websocket (0.5.1)
+      eventmachine (>= 0.12.9)
+      http_parser.rb (~> 0.6.0)
+    eventmachine (1.2.7)
+    ffi (1.12.2)
+    forwardable-extended (2.6.0)
+    http_parser.rb (0.6.0)
+    i18n (1.8.2)
+      concurrent-ruby (~> 1.0)
+    jekyll (4.0.0)
+      addressable (~> 2.4)
+      colorator (~> 1.0)
+      em-websocket (~> 0.5)
+      i18n (>= 0.9.5, < 2)
+      jekyll-sass-converter (~> 2.0)
+      jekyll-watch (~> 2.0)
+      kramdown (~> 2.1)
+      kramdown-parser-gfm (~> 1.0)
+      liquid (~> 4.0)
+      mercenary (~> 0.3.3)
+      pathutil (~> 0.9)
+      rouge (~> 3.0)
+      safe_yaml (~> 1.0)
+      terminal-table (~> 1.8)
+    jekyll-feed (0.13.0)
+      jekyll (>= 3.7, < 5.0)
+    jekyll-last-modified-at (1.2.1)
+      jekyll (>= 3.7, < 5.0)
+      posix-spawn (~> 0.3.9)
+    jekyll-sass-converter (2.0.1)
+      sassc (> 2.0.1, < 3.0)
+    jekyll-seo-tag (2.6.1)
+      jekyll (>= 3.3, < 5.0)
+    jekyll-watch (2.2.1)
+      listen (~> 3.0)
+    kramdown (2.1.0)
+    kramdown-parser-gfm (1.1.0)
+      kramdown (~> 2.0)
+    liquid (4.0.3)
+    listen (3.2.1)
+      rb-fsevent (~> 0.10, >= 0.10.3)
+      rb-inotify (~> 0.9, >= 0.9.10)
+    mercenary (0.3.6)
+    minima (2.5.1)
+      jekyll (>= 3.5, < 5.0)
+      jekyll-feed (~> 0.9)
+      jekyll-seo-tag (~> 2.1)
+    pathutil (0.16.2)
+      forwardable-extended (~> 2.6)
+    posix-spawn (0.3.13)
+    public_suffix (4.0.3)
+    rb-fsevent (0.10.3)
+    rb-inotify (0.10.1)
+      ffi (~> 1.0)
+    rouge (3.15.0)
+    safe_yaml (1.0.5)
+    sassc (2.2.1)
+      ffi (~> 1.9)
+    terminal-table (1.8.0)
+      unicode-display_width (~> 1.1, >= 1.1.1)
+    unicode-display_width (1.6.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  jekyll
+  jekyll-last-modified-at
+  minima
+
+BUNDLED WITH
+   2.0.2

docs/_config.yml

@@ -12,6 +12,7 @@ markdown: kramdown
 theme: minima
 plugins:
   - jekyll-feed
+  - jekyll-last-modified-at
 exclude: [node_modules]
 collections:
   documentations:

docs/_layouts/docs.html

@@ -112,6 +112,12 @@
         		<div role="main">{{ content }}</div>
         </div>
 
+        {% if page.permalink != "gettingstarted" %}
+        <div class="py-5 px-5 text-right">
+        Last update: {{ page.last_modified_at| date: '%b %d, %Y'}}
+        </div>
+        {% endif %}
+        
     </div>
 
 </div>

serve.sh

@@ -1,6 +1,34 @@
 #!/bin/sh
+# Fix the timestamp
+# https://stackoverflow.com/questions/21735435/git-clone-changes-file-modification-time
+# https://gist.github.com/HackingGate/9e8169c7645b074b2f40c959ca20d738
+
+echo "Fixing file timestamp..."
+
+OS=${OS:-`uname`}
+
+if [ "$OS" = 'Darwin' ]; then
+  get_touch_time() {
+    date -r ${unixtime} +'%Y%m%d%H%M.%S'
+  }
+else
+  # default Linux
+  get_touch_time() {
+    date -d @${unixtime} +'%Y%m%d%H%M.%S'
+  }
+fi
+
+git ls-tree -r --name-only HEAD | while read filename; do 
+  unixtime=$(git log -1 --format="%at" -- "${filename}")
+  touchtime=$(get_touch_time)
+  touch -t ${touchtime} "${filename}"
+done
+mkdir -p _tmp
+mkdir -p _jekyllHome
 docker run --rm -it \
   --volume="$PWD/docs:/srv/jekyll" \
+  --volume="$PWD/_tmp:/tmp" \
+  --volume="$PWD/_jekyllHome:/home/jekyll" \
   --volume="$PWD/vendor/bundle:/usr/local/bundle" \
   -p 4321:4321 jekyll/jekyll:3.8.5 \
-  jekyll serve --port 4321 --host 0.0.0.0
+  /bin/bash -c "bundle install && jekyll serve --trace --port 4321 --host 0.0.0.0"