[KYLIN-3079] Use Docker for document build environment

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: all
• Fix Version/s: v2.3.0
• Component/s: Documentation
• Environment: POSIX, docker
• Flags: Patch
• Assignee: yongjie zhao
• Reporter: yongjie zhao
• Due: 09/Dec/17
• Created: 04/Dec/17 09:29
• Updated: 22/Jan/18 07:19
• Resolved: 05/Dec/17 06:25

Description

Background: Kylin document compilation depends on jeklly2 and jekyll-multiple-languages plugins v1; by gem default installation, jeklly is version3, and jekyll-multiple-languages is not compatible with jeklly3.

To reduce build complexity using docker and Makefile can call docker command.

• build docker image:
  make docker.build

• run a daemon&auto reload web server on localhost:4000
  make runserver

• only build site
  make document.build

• clean build file
  make clean