Merge branch 'master' of https://github.com/ruby-processing/PiCrate

Author: monkstone

docs/_posts/2018-05-06-getting_started.md

@@ -1,6 +1,6 @@
 ---
 layout: post
-title:  "Getting Started Command Line"
+title:  "Getting Started Stretch"
 date:   2018-05-24 07:34:13
 categories: PiCrate update
 permalink: /getting/

docs/_posts/2018-11-18-building-gem.md

@@ -12,7 +12,7 @@ Requirements:-
 
 Simply clone this distribution, then rake to build and test gem
 ```bash
-git clone -b stretch --single-branch https://github.com/ruby-processing/PiCrate.git
+git clone --depth 1 https://github.com/ruby-processing/PiCrate.git
 cd PiCrate
 rake # to build gem
 ```

docs/_posts/2019-11-11-getting_started_buster.md

@@ -0,0 +1,111 @@
+---
+layout: post
+title:  "Getting Started Buster"
+date:   2019-11-11 07:34:13
+categories: PiCrate update
+permalink: /getting_buster/
+---
+Currently Raspbian Buster does not come with a pre-installed java. So the first step is to install a `jdk` we currently recommend installing openjdk8 (_there a complications you don't need using jdk11_) to benefit from `client` optimisations.
+
+```bash
+sudo apt-get update # sync your local database with current release
+sudo update # update to latest release
+sudo apt install openjdk-8-jdk # installs latest jdk8
+java -version # check installed version
+```
+If you have already installed a version java the java version may not match you can control the _active_ java version on Debian using `update-alternatives` as follows:-
+```bash
+sudo update-alternatives --config java
+sudo update-alternatives --config javac
+sudo update-alternatives --config jar
+```
+See [java][java] install for more explanations.
+
+__Then install JRuby see__ [jruby][jruby].
+
+We strongly recommend that you create a local storage for gems on your system, as follows:-
+
+```bash
+mkdir -p ~/.gem/jruby/2.5.0
+```
+Now set your `GEM_HOME`, `GEM_PATH` and amend your `PATH` as follows:-
+
+```bash
+echo "export GEM_HOME=\"\${HOME}/.gem/ruby/${MRI_RUBY}\"" >> ~/.profile
+echo "export GEM_PATH=\"\${HOME}/.gem/ruby/${MRI_RUBY}\"" >> ~/.profile
+echo "export PATH=\"\${PATH}:\${GEM_PATH}/bin\"" >> ~/.profile
+source ~/.profile # to update environment without re-logging in
+```
+Now should be ready to install `picrate` and other gems.
+Install a local version of rake:-
+```bash
+jgem install rake
+```
+To install picrate and its dependencies:-
+
+```bash
+jgem install picrate
+```
+__For a first install:-__
+
+```bash
+picrate --install # no args, install samples and geany config
+# or
+picrate -i Samples # to omit geany config
+```
+
+This installs example sketches in `~/sample_sketches` and ties them into a `geany` project `picrate.geany`. It should also be possible to run sketches from the `geany` ide.
+
+To create a template sketch from the command line:-
+
+```bash
+picrate -c my_sketch 600 400
+```
+creates file my_sketch.rb
+
+```ruby
+#!/usr/bin/env jruby
+# frozen_string_literal: false
+require 'picrate'
+
+class MySketch < Processing::App
+  def settings
+    size 200, 200
+  end
+
+  def setup
+    sketch_title 'My Sketch'
+  end
+
+  def draw
+
+  end
+end
+MySketch.new
+
+```
+
+Edit in `vim` (at command line) or `geany` (gui), you may need to install `vim`
+```bash
+vim my_sketch.rb
+:!jruby % # from vim runs the sketch
+```
+
+To run sketches from command line:-
+
+```bash
+jruby my_sketch.rb
+```
+
+Or even `chmod +x my_sketch.rb` to make an executable script.
+
+See [editors][geany] geany, for how to run sketches from a gui.
+
+### JWishy Sketch Running on RaspberryPI
+
+![jwishy_buster]({{ site.github.url }}/assets/jwishy_buster.png)
+
+
+[java]:http://ruby-processing.github.io/java/raspberry/
+[jruby]:{{ site.github.url }}/install_jruby/
+[geany]:{{ site.github.url }}/editors/geany