Merge pull request #159 from vim-jp/fix-environment

Fix environment

Author: koron

Gemfile

@@ -8,17 +8,60 @@ Join [vim-jp slack](https://vim-jp.org/docs/chat.html) instead, or contact [us](
 
 ## How to serve in your machine
 
-### Setup
+### Pre requirements
 
-Follow the instructions on [Testing your GitHub Pages site locally with Jekyll - GitHub Docs](https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll).
+* Docker
+* (OPTION) Python 3: to preview with local HTTP server
+
+### Build
+
+The following command will build your site in the \_site/ directory:
 
 ```console
-# Setup Ruby
-# You can use rbenv.
+$ ./_scripts/docker_jekyll jekyll build
+```
+
+You can also specify options such as incremental options.
+
+```console
+$ ./_scripts/docker_jekyll jekyll build -I
+```
+
+### Serve
+
+You can run `jekyll serve` with the following command.
+
+```console
+$ ./_scripts/docker_jekyll_serve
+```
+
+It uses port 4000 to serve the contents.
+Open http://127.0.0.1:4000 with your browser.
 
-cd vimconf.org
-bundle install
-bundle exec jekyll serve
+This command accepts options as you know.
+To use watch and incremental builds:
+
+```console
+$ ./_scripts/docker_jekyll_serve -wI
+```
+
+Auto-regeneration may not work on some Windows versions.
+In that case, it might be easier to serve it in Python
+and generate it manually in the "Build" step.
+
+If you just want to serve without watching or building, you may do as follows.
+
+```console
+$ ./_scripts/docker_jekyll_serve --skip-initial-build --no-watch
+```
+
+#### Serve with Python
+
+You can run Python local HTTP server with the following command.
+
+```console
+$ ./_scripts/python_http_server
 ```
 
-TODO: Add container version to keep the environment clean.
+It uses ports 8000 to serve the contents.
+Open http://127.0.0.1:8000 with your browser.