add "Getting Started" example

Author: b3b

.gitignore

@@ -18,6 +18,7 @@ coverage.xml
 *.cover
 .pytest_cache/
 
+*.ipynb
 .ipynb_checkpoints
 
 *~

examples/Getting_started.md

@@ -0,0 +1,132 @@
+---
+jupyter:
+  jupytext:
+    text_representation:
+      extension: .md
+      format_name: markdown
+      format_version: '1.2'
+      jupytext_version: 1.7.1
+  kernelspec:
+    display_name: Python 3
+    language: python
+    name: python3
+---
+
+# Getting started with <span style="color:#306998">Python</span><span style="color:#FFD43B">Here</span>
+
+
+#### Load the extension, and connect to the remote instance
+
+```python
+%load_ext pythonhere
+%connect-there
+```
+
+#### Execute some code on the remote
+
+```python
+%%there
+from kivy import platform
+print("Hello from", platform)
+```
+
+#### Use widgets
+
+```python
+%%there
+from kivy.uix.label import Label
+
+# Kivy's root widget is available via the `root` variable.
+root.clear_widgets()  # Remove all current childrens
+
+# And add the new one
+widget = Label(text="Kivy", font_size="80sp")
+root.add_widget(widget)
+```
+
+#### Objects introspection 
+
+```python
+%%there
+print(root.children)
+print(widget.color)
+```
+
+ #### Modify widget properties
+
+```python
+%%there
+widget.color = [1, .5, 0, 1]
+widget.text += " Rocks!"
+```
+
+ #### Make things dynamic with  [Clock](https://kivy.org/doc/stable/api-kivy.clock.html)
+
+```python
+%%there
+from kivy.clock import Clock
+
+def clock_callback(delta_time):
+    widget.color[1] = (widget.color[1] + .1) % 1
+
+clock = Clock.schedule_interval(clock_callback, 0.2)
+```
+
+```python
+%%there
+Clock.unschedule(clock)
+```
+
+#### Use platform specific features with [Plyer](https://github.com/kivy/plyer)
+
+```python
+%%there
+from plyer import tts
+tts.speak("yo" * 10)
+```
+
+#### Declare interface with the [KV](https://kivy.org/doc/stable/guide/lang.html) language
+
+```python
+%%there kv
+Button:
+    text: "Click me"
+    font_size: 10
+    on_release: self.font_size += 1
+```
+
+#### Combine Python with KV
+
+```python
+%%there
+from plyer import vibrator
+from kivy.uix.button import Button
+
+class VibroClone(Button):
+
+    def on_release(self):
+        self.root.add_widget(
+            VibroClone(root=self.root)
+        )
+        vibrator.vibrate(0.05 * int(self.text))
+
+root.clear_widgets()
+```
+
+```python
+%%there kv
+#:import get_random_color kivy.utils.get_random_color
+#:import random random
+
+<VibroClone>:
+    text: str(random.randint(1, 9))
+    color: get_random_color()
+    background_color: get_random_color()
+    size_hint: 1, 1
+
+GridLayout:
+    cols: 10
+    size_hint: 1, 1
+    VibroClone:
+        root: root
+```

examples/README.md

@@ -0,0 +1,24 @@
+---
+jupyter:
+  jupytext:
+    text_representation:
+      extension: .md
+      format_name: markdown
+      format_version: '1.2'
+      jupytext_version: 1.7.1
+  kernelspec:
+    display_name: Python 3
+    language: python
+    name: python3
+---
+
+## Before run
+
+These examples use connection settings from the **there.env** file.
+
+**there.env** should be filled with values from the PythonHere app Settings section.
+
+## When using with Docker 
+
+Content of **examples** directory are not preserved.
+**work** directory can store data that you want to be kept between runs.

examples/there.env

@@ -0,0 +1,11 @@
+# PythonHere device IP address
+THERE_HOST=
+
+# Port, as set in PythonHere app Settings section
+THERE_PORT=8022
+
+# Username, as set in PythonHere app Settings section
+THERE_USERNAME=here
+
+# Password, as set in PythonHere app Settings section
+THERE_PASSWORD=