Tools

Code Formatting

google-java-format-diff.py helps to identify any code formatting gap between current HEAD and origin/master in Git. To run formatting in-place (-i):

~/cloud-opensource-java$ git fetch; git diff -U0 origin/master...HEAD | google-java-format-diff.py -p1 --skip-sorting-imports -i

Jekyll for GitHub Pages

https://jlbp.dev is running on GitHub Pages. Developing HTML and CSS for the page requires to run Jekyll locally. Here is the steps to use Jekyll.

Install Jekyll.

$ cd cloud-opensource-java/docs
$ sudo apt-get install ruby-dev
$ sudo gem install bundler
$ bundle install --path vendor/bundle

Run Jekyll to serve GitHub pages locally.

# In docs directory
$ bundle exec jekyll serve
...
 Server address: http://127.0.0.1:4000

Then access http://localhost:4000 to see the page: