glimmer-dsl-gtk 0.0.1 → 0.0.2

data/README.md

@@ -1,4 +1,4 @@
-# [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer/master/images/glimmer-logo-hi-res.png" height=85 />](https://github.com/AndyObtiva/glimmer) Glimmer DSL for GTK 0.0.1
+# [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer/master/images/glimmer-logo-hi-res.png" height=85 />](https://github.com/AndyObtiva/glimmer) Glimmer DSL for GTK 0.0.2
 ## Ruby-GNOME Desktop Development GUI Library
 [![Gem Version](https://badge.fury.io/rb/glimmer-dsl-gtk.svg)](http://badge.fury.io/rb/glimmer-dsl-gtk)
 [![Join the chat at https://gitter.im/AndyObtiva/glimmer](https://badges.gitter.im/AndyObtiva/glimmer.svg)](https://gitter.im/AndyObtiva/glimmer?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
@@ -26,11 +26,11 @@ window {
 }.show
 ```
 
-Mac Screenshot:
+Linux | Mac | Windows
+------|-----|--------
+![hello world screenshot Windows](/screenshots/glimmer-dsl-gtk-linux-hello-world.png) | ![hello world screenshot Mac](/screenshots/glimmer-dsl-gtk-mac-hello-world.png) | ![hello world screenshot Windows](/screenshots/glimmer-dsl-gtk-windows-hello-world.png)
 
-![hello world screenshot](/screenshots/glimmer-dsl-gtk-mac-hello-world.png)
-
-NOTE: Glimmer DSL for GTK is currently in early alpha mode (incomplete proof-of-concept). Please help make better by contributing, adopting for small or low risk projects, and providing feedback. It is still an early alpha, so the more feedback and issues you report the better.
+NOTE: Glimmer DSL for GTK is currently in early alpha mode (incomplete proof-of-concept). If you want it developed faster, then [open an issue report](https://github.com/AndyObtiva/glimmer-dsl-gtk/issues/new). I have completed some GitHub project features much faster before due to [issue reports](https://github.com/AndyObtiva/glimmer-dsl-gtk/issues) and [pull requests](https://github.com/AndyObtiva/glimmer-dsl-gtk/pulls). Please help make better by contributing, adopting for small or low risk projects, and providing feedback. It is still an early alpha, so the more feedback and issues you report the better. Please help make better by contributing, adopting for small or low risk projects, and providing feedback. It is still an early alpha, so the more feedback and issues you report the better.
 
 Other [Glimmer](https://rubygems.org/gems/glimmer) DSL gems you might be interested in:
 - [glimmer-dsl-swt](https://github.com/AndyObtiva/glimmer-dsl-swt): Glimmer DSL for SWT (JRuby Desktop Development GUI Framework)
@@ -40,6 +40,32 @@ Other [Glimmer](https://rubygems.org/gems/glimmer) DSL gems you might be interes
 - [glimmer-dsl-xml](https://github.com/AndyObtiva/glimmer-dsl-xml): Glimmer DSL for XML (& HTML)
 - [glimmer-dsl-css](https://github.com/AndyObtiva/glimmer-dsl-css): Glimmer DSL for CSS
 
+## Prerequisites
+
+### Linux
+
+GNOME-based Linux installations do not need any pre-requisites since they have GTK built-in, so you can skip to [Setup](#setup) right away.
+
+Still, if you run into issues installing the GTK gem in [Setup](#setup), you may try these commands first:
+```
+sudo apt-get install libgtk-3-dev
+```
+
+Or run this command if all else fails:
+```
+sudo apt install -y -V libgirepository1.0-dev
+```
+
+### Mac
+
+On the Mac, make sure to:
+- Have [Homebrew](https://brew.sh/) installed
+- Run this [Homebrew](https://brew.sh/) command to have GTK display GUI icons: `brew install adwaita-icon-theme`
+
+### Windows
+
+Make sure to install [Ruby](https://www.ruby-lang.org) with MSYS & MING toolchains from [RubyInstaller](https://rubyinstaller.org/downloads/)
+
 ## Setup
 
 ### Option 1: Install
@@ -53,7 +79,7 @@ gem install glimmer-dsl-gtk
 
 Add the following to `Gemfile`:
 ```
-gem 'glimmer-dsl-gtk', '~> 0.0.1'
+gem 'glimmer-dsl-gtk', '~> 0.0.2'
 ```
 
 And, then run:
@@ -80,9 +106,9 @@ window {
 }.show
 ```
 
-For actual application development outside of simple demos, mixin the `Glimmer` module into an application class instead:
+For actual application development outside of simple demos, mixin the `Glimmer` module into a custom application class instead:
 
-```
+```ruby
 require 'glimmer-dsl-gtk'
 
 class SomeGlimmerApplication
@@ -117,7 +143,17 @@ You can run the `girb` command (`bin/girb` if you cloned the project locally):
 girb
 ```
 
-![girb screenshot](/screenshots/glimmer-dsl-gtk-mac-girb.png)
+Linux
+
+![girb screenshot linux](/screenshots/glimmer-dsl-gtk-linux-girb.png)
+
+Mac
+
+![girb screenshot mac](/screenshots/glimmer-dsl-gtk-mac-girb.png)
+
+Windows
+
+![girb screenshot windows](/screenshots/glimmer-dsl-gtk-windows-girb.png)
 
 This gives you `irb` with the `glimmer-dsl-gtk` gem loaded and the `Glimmer` module mixed into the main object for easy experimentation with GUI.
 
@@ -125,15 +161,17 @@ Gotcha: On the Mac, when you close a window opened in `girb`, it remains open un
 
 ## Samples
 
+You may checkout the [samples](samples) directory for examples of using [Glimmer DSL for GTK](https://rubygems.org/gems/glimmer-dsl-gtk).
+
 ### Hello Samples
 
 #### Hello, World!
 
 [samples/hello/hello_world.rb](/samples/hello/hello_world.rb)
 
-Mac Screenshot:
-
-![hello world screenshot](/screenshots/glimmer-dsl-gtk-mac-hello-world.png)
+Linux | Mac | Windows
+------|-----|--------
+![hello world screenshot Windows](/screenshots/glimmer-dsl-gtk-linux-hello-world.png) | ![hello world screenshot Mac](/screenshots/glimmer-dsl-gtk-mac-hello-world.png) | ![hello world screenshot Windows](/screenshots/glimmer-dsl-gtk-windows-hello-world.png)
 
 Run (via installed gem):
 
@@ -161,9 +199,9 @@ window {
 
 [samples/hello/hello_application.rb](/samples/hello/hello_application.rb)
 
-Mac Screenshot:
-
-![hello application screenshot](/screenshots/glimmer-dsl-gtk-mac-hello-application.png)
+Linux | Mac | Windows
+------|-----|--------
+![hello application screenshot](/screenshots/glimmer-dsl-gtk-linux-hello-application.png) | ![hello application screenshot](/screenshots/glimmer-dsl-gtk-mac-hello-application.png) | ![hello application screenshot](/screenshots/glimmer-dsl-gtk-windows-hello-application.png)
 
 Run (via installed gem):
 
@@ -197,11 +235,9 @@ application('org.glimmer.hello-application', :flags_none) {
 
 [samples/hello/hello_button.rb](/samples/hello/hello_button.rb)
 
-Mac Screenshot:
-
-![hello button screenshot](/screenshots/glimmer-dsl-gtk-mac-hello-button.png)
-
-![hello button clicked screenshot](/screenshots/glimmer-dsl-gtk-mac-hello-button-clicked.png)
+Linux | Mac | Windows
+------|-----|--------
+![hello button screenshot](/screenshots/glimmer-dsl-gtk-linux-hello-button.png) ![hello button clicked screenshot](/screenshots/glimmer-dsl-gtk-linux-hello-button-clicked.png) | ![hello button screenshot](/screenshots/glimmer-dsl-gtk-mac-hello-button.png) ![hello button clicked screenshot](/screenshots/glimmer-dsl-gtk-mac-hello-button-clicked.png) | ![hello button screenshot](/screenshots/glimmer-dsl-gtk-windows-hello-button.png) ![hello button clicked screenshot](/screenshots/glimmer-dsl-gtk-windows-hello-button-clicked.png)
 
 Run (via installed gem):
 
@@ -244,11 +280,9 @@ window { |w|
 
 [samples/hello/hello_entry.rb](/samples/hello/hello_entry.rb)
 
-Mac Screenshot:
-
-![hello entry screenshot](/screenshots/glimmer-dsl-gtk-mac-hello-entry.png)
-
-![hello entry submitted screenshot](/screenshots/glimmer-dsl-gtk-mac-hello-entry-submitted.png)
+Linux | Mac | Windows
+------|-----|--------
+![hello entry screenshot](/screenshots/glimmer-dsl-gtk-linux-hello-entry.png) ![hello entry submitted screenshot](/screenshots/glimmer-dsl-gtk-linux-hello-entry-submitted.png) | ![hello entry screenshot](/screenshots/glimmer-dsl-gtk-mac-hello-entry.png) ![hello entry submitted screenshot](/screenshots/glimmer-dsl-gtk-mac-hello-entry-submitted.png) | ![hello entry screenshot](/screenshots/glimmer-dsl-gtk-windows-hello-entry.png) ![hello entry submitted screenshot](/screenshots/glimmer-dsl-gtk-windows-hello-entry-submitted.png)
 
 Run (via installed gem):
 
@@ -297,6 +331,484 @@ window { |w|
 }.show
 ```
 
+#### Hello, Drawing Area!
+
+This demonstrates the very intuitive (Glimmer-only) declarative cairo shape drawing syntax for the `drawing_area` widget.
+
+[samples/hello/hello_drawing_area.rb](/samples/hello/hello_drawing_area.rb)
+
+Linux | Mac | Windows
+------|-----|--------
+![hello drawing area screenshot](/screenshots/glimmer-dsl-gtk-linux-hello-drawing-area.png) | ![hello drawing area screenshot](/screenshots/glimmer-dsl-gtk-mac-hello-drawing-area.png) | ![hello drawing area screenshot](/screenshots/glimmer-dsl-gtk-windows-hello-drawing-area.png)
+
+Run (via installed gem):
+
+```
+ruby -r glimmer-dsl-gtk -e "require 'samples/hello/hello_drawing_area'"
+```
+
+Run (via locally cloned project):
+
+```
+ruby -r ./lib/glimmer-dsl-gtk.rb samples/hello/hello_drawing_area.rb
+```
+
+Code:
+
+```ruby
+require 'glimmer-dsl-gtk'
+
+include Glimmer
+
+window {
+  title 'Hello, Drawing Area!'
+  default_size 400, 400
+  
+  drawing_area {
+    rectangle(0, 0, 400, 400) {
+      fill 255, 255, 255
+    }
+    
+    arc(85, 85, 45, (Math::PI/180)*90, -(Math::PI/180)*90) {
+      fill 255, 0, 0
+      stroke 0, 128, 255
+      line_width 3
+    }
+
+    arc(85, 185, 45, (Math::PI/180)*100, -(Math::PI/180)*30) {
+      fill 255, 0, 0
+      stroke 0, 128, 255
+      line_width 3
+    }
+    
+    circle(85, 285, 45) {
+      fill 255, 0, 0
+      stroke 0, 128, 255
+      line_width 3
+    }
+    
+    rectangle(140, 40, 180, 90) {
+      fill 255, 255, 0
+      stroke 255, 0, 0
+      line_width 3
+    }
+    
+    rounded_rectangle(140, 140, 180, 90, 30, 20) {
+      fill 255, 255, 0
+      stroke 255, 0, 0
+      line_width 3
+    }
+
+    triangle(140, 240, 320, 240, 230, 330) {
+      fill 255, 255, 0
+      stroke 255, 0, 0
+      line_width 3
+    }
+
+    path {
+      move_to 160, 100
+      curve_to 190, 60, 200, 80, 210, 70
+      curve_to 240, 80, 250, 100, 260, 90
+      curve_to 290, 90, 300, 110, 310, 100
+
+      fill 0, 255, 0
+      stroke 0, 0, 255
+      line_width 3
+    }
+
+    path {
+      move_to 200, 150
+      line_to 270, 170
+      line_to 250, 220
+      line_to 220, 190
+      line_to 200, 200
+      line_to 180, 170
+      close_path
+
+      fill 0, 255, 0
+      stroke 0, 0, 255
+      line_width 3
+    }
+    
+    polygon(200, 260, 270, 270, 250, 290, 220, 290, 200, 280, 180, 270) {
+      fill 0, 255, 0
+      stroke 0, 0, 255
+      line_width 3
+    }
+    
+    polyline(270, 320, 250, 340, 220, 340, 200, 330, 180, 320) {
+      stroke 0, 0, 255
+      line_width 3
+    }
+  }
+}.show
+```
+
+#### Hello, Drawing Area (Manual)!
+
+This demonstrates the manual (non-Glimmer) imperative cairo shape drawing syntax for the `drawing_area` widget (might be useful in very exceptional rare cases).
+
+[samples/hello/hello_drawing_area_manual.rb](/samples/hello/hello_drawing_area_manual.rb)
+
+Linux | Mac | Windows
+------|-----|--------
+![hello drawing area manual screenshot](/screenshots/glimmer-dsl-gtk-linux-hello-drawing-area-manual.png) | ![hello drawing area manual screenshot](/screenshots/glimmer-dsl-gtk-mac-hello-drawing-area-manual.png) | ![hello drawing area manual screenshot](/screenshots/glimmer-dsl-gtk-windows-hello-drawing-area-manual.png)
+
+Run (via installed gem):
+
+```
+ruby -r glimmer-dsl-gtk -e "require 'samples/hello/hello_drawing_area_manual'"
+```
+
+Run (via locally cloned project):
+
+```
+ruby -r ./lib/glimmer-dsl-gtk.rb samples/hello/hello_drawing_area_manual.rb
+```
+
+Code:
+
+```ruby
+require 'glimmer-dsl-gtk'
+
+include Glimmer
+
+window {
+  title 'Hello, Drawing Area (Manual)!'
+  default_size 400, 400
+  
+  drawing_area {
+    on(:draw) do |drawing_area_widget, cairo_context|
+      cairo_context.rectangle(0, 0, 400, 400)
+      cairo_context.set_source_rgb(255, 255, 255)
+      cairo_context.fill
+      
+      cairo_context.arc(85, 85, 45, (Math::PI/180)*90, -(Math::PI/180)*90)
+      cairo_context.set_source_rgb(255, 0, 0)
+      cairo_context.fill
+      
+      cairo_context.arc(85, 85, 45, (Math::PI/180)*90, -(Math::PI/180)*90)
+      cairo_context.set_source_rgb(0, 128, 255)
+      cairo_context.set_line_width(3)
+      cairo_context.stroke
+
+      cairo_context.arc(85, 185, 45, (Math::PI/180)*100, -(Math::PI/180)*30)
+      cairo_context.set_source_rgb(255, 0, 0)
+      cairo_context.fill
+      
+      cairo_context.arc(85, 185, 45, (Math::PI/180)*100, -(Math::PI/180)*30)
+      cairo_context.set_source_rgb(0, 128, 255)
+      cairo_context.set_line_width(3)
+      cairo_context.stroke
+      
+      cairo_context.circle(85, 285, 45)
+      cairo_context.set_source_rgb(255, 0, 0)
+      cairo_context.fill
+      
+      cairo_context.circle(85, 285, 45)
+      cairo_context.set_source_rgb(0, 128, 255)
+      cairo_context.set_line_width(3)
+      cairo_context.stroke
+      
+      cairo_context.rectangle(140, 40, 180, 90)
+      cairo_context.set_source_rgb(255, 255, 0)
+      cairo_context.fill
+      
+      cairo_context.rectangle(140, 40, 180, 90)
+      cairo_context.set_source_rgb(255, 0, 0)
+      cairo_context.set_line_width(3)
+      cairo_context.stroke
+      
+      cairo_context.rounded_rectangle(140, 140, 180, 90, 30, 20)
+      cairo_context.set_source_rgb(255, 255, 0)
+      cairo_context.fill
+      
+      cairo_context.rounded_rectangle(140, 140, 180, 90, 30, 20)
+      cairo_context.set_source_rgb(255, 0, 0)
+      cairo_context.set_line_width(3)
+      cairo_context.stroke
+      
+      cairo_context.triangle(140, 240, 320, 240, 230, 330)
+      cairo_context.set_source_rgb(255, 255, 0)
+      cairo_context.fill
+      
+      cairo_context.triangle(140, 240, 320, 240, 230, 330)
+      cairo_context.set_source_rgb(255, 0, 0)
+      cairo_context.set_line_width(3)
+      cairo_context.stroke
+      
+      cairo_context.new_path
+      cairo_context.move_to 160, 100
+      cairo_context.curve_to 190, 60, 200, 80, 210, 70
+      cairo_context.curve_to 240, 80, 250, 100, 260, 90
+      cairo_context.curve_to 290, 90, 300, 110, 310, 100
+      cairo_context.set_source_rgb(0, 255, 0)
+      cairo_context.fill
+      
+      cairo_context.new_path
+      cairo_context.move_to 160, 100
+      cairo_context.curve_to 190, 60, 200, 80, 210, 70
+      cairo_context.curve_to 240, 80, 250, 100, 260, 90
+      cairo_context.curve_to 290, 90, 300, 110, 310, 100
+      cairo_context.set_source_rgb(0, 0, 255)
+      cairo_context.stroke
+      
+      cairo_context.new_path
+      cairo_context.move_to 200, 150
+      cairo_context.line_to 270, 170
+      cairo_context.line_to 250, 220
+      cairo_context.line_to 220, 190
+      cairo_context.line_to 200, 200
+      cairo_context.line_to 180, 170
+      cairo_context.close_path
+      cairo_context.set_source_rgb(0, 255, 0)
+      cairo_context.fill
+      
+      cairo_context.new_path
+      cairo_context.move_to 200, 150
+      cairo_context.line_to 270, 170
+      cairo_context.line_to 250, 220
+      cairo_context.line_to 220, 190
+      cairo_context.line_to 200, 200
+      cairo_context.line_to 180, 170
+      cairo_context.close_path
+      cairo_context.set_source_rgb(0, 0, 255)
+      cairo_context.stroke
+      
+      cairo_context.new_path
+      cairo_context.move_to 200, 260
+      cairo_context.line_to 270, 270
+      cairo_context.line_to 250, 290
+      cairo_context.line_to 220, 290
+      cairo_context.line_to 200, 280
+      cairo_context.line_to 180, 270
+      cairo_context.close_path
+      cairo_context.set_source_rgb(0, 255, 0)
+      cairo_context.fill
+      
+      cairo_context.new_path
+      cairo_context.move_to 200, 260
+      cairo_context.line_to 270, 270
+      cairo_context.line_to 250, 290
+      cairo_context.line_to 220, 290
+      cairo_context.line_to 200, 280
+      cairo_context.line_to 180, 270
+      cairo_context.close_path
+      cairo_context.set_source_rgb(0, 0, 255)
+      cairo_context.stroke
+      
+      cairo_context.new_path
+      cairo_context.move_to 200, 260
+      cairo_context.move_to 270, 320
+      cairo_context.line_to 250, 340
+      cairo_context.line_to 220, 340
+      cairo_context.line_to 200, 330
+      cairo_context.line_to 180, 320
+      cairo_context.set_source_rgb(0, 0, 255)
+      cairo_context.stroke
+    end
+  }
+}.show
+```
+
+### Elaborate Samples
+
+#### Widget Gallery
+
+[samples/elaborate/widget_gallery.rb](/samples/elaborate/widget_gallery.rb)
+
+Linux | Mac | Windows
+------|-----|--------
+![widget gallery text](/screenshots/glimmer-dsl-gtk-linux-widget-gallery-text.png) ![widget gallery button](/screenshots/glimmer-dsl-gtk-linux-widget-gallery-button.png) ![widget gallery selection](/screenshots/glimmer-dsl-gtk-linux-widget-gallery-selection.png) ![widget gallery organizer](/screenshots/glimmer-dsl-gtk-linux-widget-gallery-organizer.png) ![widget gallery progress](/screenshots/glimmer-dsl-gtk-linux-widget-gallery-progress.png) | ![widget gallery text](/screenshots/glimmer-dsl-gtk-mac-widget-gallery-text.png) ![widget gallery button](/screenshots/glimmer-dsl-gtk-mac-widget-gallery-button.png) ![widget gallery selection](/screenshots/glimmer-dsl-gtk-mac-widget-gallery-selection.png) ![widget gallery organizer](/screenshots/glimmer-dsl-gtk-mac-widget-gallery-organizer.png) ![widget gallery progress](/screenshots/glimmer-dsl-gtk-mac-widget-gallery-progress.png) | ![widget gallery text](/screenshots/glimmer-dsl-gtk-windows-widget-gallery-text.png) ![widget gallery button](/screenshots/glimmer-dsl-gtk-windows-widget-gallery-button.png) ![widget gallery selection](/screenshots/glimmer-dsl-gtk-windows-widget-gallery-selection.png) ![widget gallery organizer](/screenshots/glimmer-dsl-gtk-windows-widget-gallery-organizer.png) ![widget gallery progress](/screenshots/glimmer-dsl-gtk-windows-widget-gallery-progress.png)
+
+Run (via installed gem):
+
+```
+ruby -r glimmer-dsl-gtk -e "require 'samples/elaborate/widget_gallery'"
+```
+
+Run (via locally cloned project):
+
+```
+ruby -r ./lib/glimmer-dsl-gtk.rb samples/elaborate/widget_gallery.rb
+```
+
+Code:
+
+```ruby
+require 'glimmer-dsl-gtk'
+
+include Glimmer
+
+application('org.glimmer.hello-application') {
+  on(:activate) do |app|
+    application_window(app) {
+      title 'Widget Gallery'
+      
+      notebook { |n|
+        f1 = frame {
+          alignment(1, 1, 1, 1) {
+            padding 15, 15, 15, 15
+            
+            box(:vertical) {
+              spacing 10
+              
+              label('Entry')
+              entry {
+                text 'Enter One Line of Text'
+              }
+              
+              label('Search Entry')
+              search_entry {
+                text 'Enter Search Term'
+              }
+              
+              label('Spin Button')
+              spin_button(1, 100, 1) {
+              }
+              
+              label('Combo Box Text')
+              cb = combo_box_text {
+              }
+              3.times { |n| cb.append_text "Option #{n + 1}" }
+            }
+          }
+        }
+        n.set_tab_label_text(f1.gtk, 'Text')
+        
+        f2 = frame {
+          alignment(1, 1, 1, 1) {
+            padding 15, 15, 15, 15
+            
+            box(:vertical) {
+              spacing 10
+              
+              label('Button')
+              button('Push Me')
+              
+              label('Radio Button')
+              box(:horizontal) {
+                rb = radio_button('One')
+                radio_button(rb, 'Two')
+                radio_button(rb, 'Three')
+              }
+              
+              label('Check Button')
+              box(:horizontal) {
+                check_button('One')
+                check_button('Two')
+                check_button('Three')
+              }
+            }
+          }
+        }
+        n.set_tab_label_text(f2.gtk, 'Button')
+        
+        f3 = frame {
+          alignment(1, 1, 1, 1) {
+            padding 15, 15, 15, 15
+            
+            box(:vertical) {
+              spacing 10
+              
+              label('Horizontal Scale')
+              h_scale(1, 100, 1) {
+                visible true
+              }
+              
+              label('Vertical Scale')
+              v_scale(1, 100, 1) {
+                visible true
+                height_request 200
+              }
+            }
+          }
+        }
+        n.set_tab_label_text(f3.gtk, 'Selection')
+        
+        f4 = frame {
+          alignment(1, 1, 1, 1) {
+            padding 15, 15, 15, 15
+            
+            box(:vertical) {
+              spacing 10
+              
+              label('Expander')
+              3.times do |n|
+                expander {
+                  label "Item #{n + 1}"
+                  
+                  label("Item #{n + 1} Expanded") {
+                  }
+                }
+              end
+            }
+          }
+        }
+        n.set_tab_label_text(f4.gtk, 'Organizer')
+        
+        f5 = frame {
+          alignment(1, 1, 1, 1) {
+            padding 15, 15, 15, 15
+            
+            box(:vertical) {
+              spacing 10
+              
+              label('Progress Bar')
+              pb = progress_bar {
+                text 'Progress Bar'
+              }
+              Thread.new do
+                101.times.cycle do |n|
+                  pb.fraction = n / 100.0
+                  sleep(0.1) # yields back to main GUI thread
+                end
+              end
+              
+              label('Spinner')
+              spinner {
+                active true
+              }
+            }
+          }
+        }
+        n.set_tab_label_text(f5.gtk, 'Progress')
+      }
+    }.present
+  end
+}.run
+```
+
+## Resources
+
+- Ruby-Gnome Project: https://github.com/ruby-gnome/ruby-gnome
+- GTK3 API Documentation: https://gnome.pages.gitlab.gnome.org/gtk/gtk3/
+- GTK3 Widget Gallery: https://docs.gtk.org/gtk3/visual_index.html
+
+## Process
+
+[Glimmer Process](https://github.com/AndyObtiva/glimmer/blob/master/PROCESS.md)
+
+## Help
+
+### Issues
+
+If you encounter [issues](https://github.com/AndyObtiva/glimmer-dsl-gtk/issues) that are not reported, discover missing features that are not mentioned in [TODO.md](TODO.md), or think up better ways to use GTK than what is possible with [Glimmer DSL for GTK](https://rubygems.org/gems/glimmer-dsl-gtk), you may submit an [issue](https://github.com/AndyObtiva/glimmer-dsl-gtk/issues/new) or [pull request](https://github.com/AndyObtiva/glimmer-dsl-gtk/compare) on [GitHub](https://github.com). In the meantime while waiting for a fix, you may try older gem versions of [Glimmer DSL for GTK](https://rubygems.org/gems/glimmer-dsl-gtk) in case you find one that does not have the issue and actually works.
+
+### Chat
+
+If you need live help, try to [![Join the chat at https://gitter.im/AndyObtiva/glimmer](https://badges.gitter.im/AndyObtiva/glimmer.svg)](https://gitter.im/AndyObtiva/glimmer?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+
+## Planned Features and Feature Suggestions
+
+These features have been planned or suggested. You might see them in a future version of [Glimmer DSL for GTK](https://rubygems.org/gems/glimmer-dsl-gtk). You are welcome to contribute more feature suggestions.
+
+[TODO.md](TODO.md)
+
+## Change Log
+
+[CHANGELOG.md](CHANGELOG.md)
+
 ## Contributing
 
 -   Check out the latest master to make sure the feature hasn't been
@@ -313,16 +825,6 @@ window { |w|
     is fine, but please isolate to its own commit so I can cherry-pick
     around it.
 
-## Planned Features and Feature Suggestions
-
-These features have been planned or suggested. You might see them in a future version of [Glimmer DSL for GTK](https://rubygems.org/gems/glimmer-dsl-gtk). You are welcome to contribute more feature suggestions.
-
-[TODO.md](TODO.md)
-
-## Change Log
-
-[CHANGELOG.md](CHANGELOG.md)
-
 ## Contributors
 
 * [Andy Maleh](https://github.com/AndyObtiva) (Founder)
@@ -331,7 +833,7 @@ These features have been planned or suggested. You might see them in a future ve
 
 ## Copyright
 
-[MIT](LICENSE.txt)
+[LGPL](LICENSE.txt)
 
 Copyright (c) 2021 Andy Maleh.
 

data/VERSION

@@ -1 +1 @@
-0.0.1
+0.0.2