green_shoes 1.0.309 → 1.0.320

data/VERSION

@@ -1 +1 @@
-1.0.309
+1.0.320

data/lib/plugins/video.rb

@@ -14,6 +14,10 @@ class Shoes
             @eos = true; pause
           when Gst::Message::WARNING, Gst::Message::ERROR
             p message.parse
+          when Gst::Message::ELEMENT
+            duration = Gst::QueryDuration.new Gst::Format::TIME
+            @real.query duration
+            @length = duration.parse.last
           else
             #p message.type
         end
@@ -22,7 +26,7 @@ class Shoes
       @app.win.signal_connect('destroy'){@real.stop}
       @stime = 0
     end
-
+    
     def playing?
       @eos ? false : @playing
     end
@@ -35,6 +39,11 @@ class Shoes
         @ready = @playing  = true
         (self.time, @eos = 0, nil) if @eos
       end
+      unless @whdl
+        @whdl = @app.win.window.class.method_defined?(:xid) ? @app.win.window.xid : 
+          Win32API.new('user32', 'GetForegroundWindow', [], 'N').call
+        @real.video_sink.xwindow_id = @whdl
+      end
       @real.play
     end
 
@@ -50,6 +59,18 @@ class Shoes
       @eos = true
       @real.stop
     end
+    
+    def length
+      @length / 1_000_000 if @length
+    end
+    
+    def position
+      @length ? time.to_f / length : 0.0
+    end
+    
+    def position=(x)
+      self.time = length * x if @length
+    end
 
     def time
       seek_time / 1_000_000
@@ -81,7 +102,9 @@ class Shoes
       args = {}
       uri = File.join('file://', uri.gsub("\\", '/').sub(':', '')) unless uri =~ /^(http|https|file):\/\//
       require 'gst'
+      require 'win32api'
       v = Gst::ElementFactory.make 'playbin2'
+      v.video_sink = Gst::ElementFactory.make('dshowvideosink')
       v.uri = uri
       args[:real], args[:app] = v, self
       Video.new args

data/lib/shoes/app.rb

@@ -288,6 +288,8 @@ class Shoes
       tv.wrap_mode = Gtk::TextTag::WRAP_WORD
       tv.buffer.text = args[:text].to_s
       tv.modify_font(Pango::FontDescription.new(args[:font])) if args[:font]
+      tv.accepts_tab = args[:accepts_tab]
+      args.delete :accepts_tab
 
       eb = Gtk::ScrolledWindow.new
       eb.set_size_request args[:width], args[:height]

data/lib/shoes/basic.rb

@@ -270,6 +270,7 @@ class Shoes
     end
 
     def focus
+      real.grab_focus
       @app.focus_ele = self
     end
     
@@ -358,6 +359,15 @@ class Shoes
     def change &blk
       super @textview.buffer, &blk
     end
+
+    def focus
+      textview.grab_focus
+      @app.focus_ele = self
+    end
+
+    def accepts_tab=(t)
+      textview.accepts_tab = t
+    end
   end
   
   class ListBox < Native

data/lib/shoes/helper_methods.rb

@@ -90,7 +90,7 @@ class Shoes
     def make_link_index msg
       start, links = 0, []
       msg.each do |e|
-        len = e.to_s.gsub(/<\/.*?>/, '').gsub(/<.*?>/, '').length
+        len = e.to_s.gsub(/<\/.*?>/, '').gsub(/<.*?>/, '').bytesize
         (links << e; e.index = [start, start + len]) if e.is_a? Link
         start += len
       end
@@ -221,7 +221,7 @@ class Shoes
     repaint_all_by_order app
     repaint_textcursors app
     app.canvas.set_size 0, scrollable_height unless(app.prjct or app.trvw)
-    n = app.focusables.index app.focus_ele
+    n = app.focus_ele ? app.focusables.index(app.focus_ele) : 0
     app.canvas.focus_chain = (app.focusables[n..-1] + app.focusables[0...n]).map(&:real) if n
     true
   end

data/lib/shoes/style.rb

@@ -2,13 +2,13 @@ class Shoes
   class App
     def style klass, args={}
       if klass == Shoes::Link
-        @link_style = LINK_DEFAULT
+        @link_style = LINK_DEFAULT.dup
         @link_style.sub!('single', 'none') if args[:underline] == false
         @link_style.sub!("foreground='#06E'", "foreground='#{args[:stroke]}'") if args[:stroke]
         @link_style.sub!('>', " background='#{args[:fill]}'>") if args[:fill]
         @link_style.sub!('normal', "#{args[:weight]}") if args[:weight]
       elsif klass == Shoes::LinkHover
-        @linkhover_style = LINKHOVER_DEFAULT
+        @linkhover_style = LINKHOVER_DEFAULT.dup
         @linkhover_style.sub!('single', 'none') if args[:underline] == false
         @linkhover_style.sub!("foreground='#039'", "foreground='#{args[:stroke]}'") if args[:stroke]
         @linkhover_style.sub!('>', " background='#{args[:fill]}'>") if args[:fill]

data/lib/shoes/text.rb

@@ -16,7 +16,7 @@ class Shoes
     end
 
     def link str, arg = {}, &blk
-      Link.new "#{LINK_DEFAULT}#{str}</span>", arg, &blk
+      Link.new "#{@link_style}#{str}</span>", arg, &blk
     end
 
     def font name

data/static/manual-en.txt

@@ -670,7 +670,7 @@ When the above script is run, the person at the computer will see a window with
 a blank box for entering their name. The name will then be saved in the `name`
 variable.
 
-=== ask_color(title: a string) » Shoes::Color ===
+=== ask_color(title: a string) » a RGB array ===
 
 Pops up a color picker window. The program will wait for a color to be picked,
 then gives you back a Color object. See the `Color` help for some ways you can
@@ -1561,7 +1561,7 @@ Possible settings are:
 
 '''Note:''' Green Shoes doesn't support `:stretch` style.
 
-=== :strikecolor » a Shoes::Color ===
+=== :strikecolor » a RGB array ===
 
 For: ''banner, caption, inscription, para, span, subtitle, tagline, title''.
 
@@ -1607,7 +1607,7 @@ placed 40 pixels beneath the top edge of the top slot (window).  If no
 `:top` style is given, the object is automatically placed in the natural flow
 of the slot it contains.
 
-=== :undercolor » a Shoes::Color ===
+=== :undercolor » a RGB array ===
 
 For: ''banner, caption, inscription, para, span, subtitle, tagline, title''.
 
@@ -2131,12 +2131,16 @@ window is given a dialog box look.
 
 '''Note:''' Green Shoes doesn't support `dialog` method.
 
-=== edit_box(text) » Shoes::EditBox ===
+=== edit_box(text, :accepts_tab => true or false) » Shoes::EditBox ===
 
 Adds a large, multi-line textarea to this slot.  The `text` is optional and
 should be a string that will start out the box.  An optional block can be
 attached here which is called any type the user changes the text in the box.
 
+If `accepts_tab` is true a tab character is inserted. 
+If `accepts_tab` is false the keyboard focus is moved to the next element 
+in the focus chain. This accepts_tab defaults to false.
+
 {{{
  #!ruby
  Shoes.app do
@@ -3775,11 +3779,30 @@ already running, it is stopped.
 
 == Video ==
 
-Green Shoes is trying to support embedding of MP4 video format with Ruby/GStreamer. 
-But for now, not available any video formats. Just available some audio formats, 
-such as MP3 and Ogg Vorbis.
+Green Shoes supports embedding of MP4, AVI, WMV, QuickTime and various other popular video formats. 
+This is all thanks to Ruby/GStreamer. Use the `video` method to setup a Shoes::Video object. !{:margin_left => 70}man-ele-video.png!
+
+{{{
+ Shoes.app width: 400, height: 300 do
+   background gold..cyan, angle: 90
+   space = ' ' * 3
+   v = video 'http://is.gd/xZ6Jih'
+   links = para space, 
+     link('play'){v.play; links.move(0, 300)}, 
+     space, link('pause'){v.pause}, 
+     space, link('-1sec'){v.time -= 1000},
+     space, link('+1sec'){v.time += 1000}, 
+     top: 250
+   msg = para left: 250, top: 300
+   every do
+     msg.text = fg("#{(v.position*100).to_i}% " + 
+       "(#{v.time/1000}/#{v.length.to_i/1000}sec)", 
+       darkcyan)
+   end
+ end
+}}}
 
-'''Note:''' Green Shoes doesn't support any video formats so far. !{:margin_left => 70}man-ele-video.png!
+In addition to video formats, some audio formats are also supported, such as MP3, WAV and Ogg Vorbis.
 
 === hide() » self ===
 
@@ -3794,8 +3817,6 @@ the video area when it is playing an audio file, such as an MP3.
 The full length of the video in milliseconds. Returns nil if the video is not
 yet loaded.
 
-'''Note:''' Green Shoes doesn't support length method so far.
-
 === move(left, top) » self ===
 
 Moves the video to specific coordinates, the (left, top) being the upper left
@@ -3823,15 +3844,11 @@ The position of the video as a decimanl number (a Float) between the beginning
 (0.0) and the end (1.0). For instance, a Float value of 0.5 indicates the
 halfway point of the video.
 
-'''Note:''' Green Shoes doesn't support position method so far.
-
 === position = a decimal ===
 
 Sets the position of the video using a Float value. To move the video to its
 25% position: `@video.position = 0.25`.
 
-'''Note:''' Green Shoes doesn't support position= method so far.
-
 === remove() » self ===
 
 Removes the video from its slot. This will stop the video as well.

data/static/manual-ja.txt

@@ -1,71 +1,96 @@
+# -*- encoding: utf-8 -*-
 = Hello! =
 
-Shoesは軽量なグラフィックツールキットです。これは単純で分かりやすいです。Shoesは簡単になるように生まれました。本当に、これは全くの初心者のために作られました。本当に簡単です。
+Shoesは軽量なグラフィックツールキットです。これは単純で分かりやすいです。
+Shoesは簡単になるように生まれました。本当に、これは全くの初心者のために作られました。
+本当に簡単です。
+Green ShoesはカラフルなShoesの一つです。Ruby/GTK2を使ってRubyだけで書かれています。
 
 このたった一行の取るに足りないShoesのプログラムを見てください：
 
 {{{
  #!ruby
- Shoes.app { button("Click me!") { alert("Good job.") } }
+ Shoes.app{button("Click me!"){alert("Good job.")}}
 }}}
 
-ShoesプログラムはRubyと呼ばれる言語で書かれています。ShoesがこのRubyコードの単純な行を渡されたとき、"Click me!"と中に書かれたボタンを持ったウィンドウを表示します。このボタンをクリックすると、メッセージがポップアップします。
+ShoesプログラムはRubyと呼ばれる言語で書かれています。
+ShoesがこのRubyコードの単純な行を渡されたとき、"Click me!"と中に書かれたボタンを持った
+ウィンドウを表示します。このボタンをクリックすると、メッセージがポップアップします。
 
-Linuxでは、このように見えるでしょう: !{:margin_left => 100}man-shot1.png!
+Windows 7では、このように見えるでしょう: !{margin_left: 100}man-shot1.png!
 
-多くのShoesのアプリケーションがグラフィカルなゲームやアートのプログラムである一方、テキストを配置したり編集したりすることも簡単にできます。 !{:margin_left => 40}shoes-manual-apps.gif!
+多くのShoesのアプリケーションがグラフィカルなゲームやアートのプログラムである一方、
+テキストを配置したり編集したりすることも簡単にできます。 !{margin_left: 80}shoes-manual-apps.png!
 
-そして、理想的には、Shoesプログラムは世の中のいくつかの有名なプラットフォームで実行できるでしょう。マイクロソフトWindows、アップルのMac OS X、Linuxや多くの他のプラットフォームで。
+そして、理想的には、Shoesプログラムは世の中のいくつかの有名なプラットフォームで実行できるでしょう。
+マイクロソフトWindows、アップルのMac OS X、Linuxや多くの他のプラットフォームで。
 
-^そして、Shoesのビルトインマニュアルへようこそ。このマニュアルはShoesのプログラムそのものです。^
+^Green Shoesのビルトインマニュアルへようこそ。このマニュアルはGreen Shoesのプログラムそのものです。^
 
-== Introducing Shoes ==
+== Introducing Green Shoes ==
 
-OS XやWindowsではShoesはどのように見えるでしょうか？見栄えはいいですか？全体的に見苦しくて不格好ですか？みんなすぐに身悶えしたに違いないです！それは何をしようとしても、とても質が落ちたものに違いありません。
+Green Shoesは、OS XやLinuxではどうですか？Windowsと同様ですか?
+人々はすぐにもそのように攻め立てます！
+でも大丈夫、全て試していますからね。
 
-それでは、Shoesのインストールや実行について入る前に、何ができるのかの参考に、ちょっといくつかのスクリーンショットを確認します。
+それでは、Green Shoesのインストールや実行について入る前に、何ができるのかの参考に、
+ちょっといくつかのスクリーンショットを確認します。
 
 ==== Mac OS X ====
 
-ShoesはアップルのMac OS X Leopardで、同様にTigerでも動作します。ShoesはPowerPCマシンの同様にサポートしますが、そのプラットフォームではビデオ機能はサポートされません。 !man-look-tiger.png!
+Green ShoesはアップルのMac OSX10.5 PPC via X11で動作します。
+!{margin_left: 100}../snapshots/sample3-osx.png!
 
-これはTigerで実行している`simple-sphere.rb`サンプルです。アプリケーションは通常のOS Xウィンドウの枠の中で実行されていることに注意して下さい。
-
-この球の全体は不鮮明な楕円形と影によって描かれています。Shoesでは、生き生きとした形状を描くことや、それらの形状に効果を適用することができます。
+これはMac OS X上で`sample3.rb`を実行した時のスナップショットです。
+全ての円がランダムに描かれています。
+Green Shoesではさまざまな図形を描いたり動かしたりすることができます。
 
 ==== Windows ====
 
-Shoesはすべてのバージョンの'''Microsoft Windows XP'''、 '''Windows Vista'''、 '''Windows 7'''で実行でき、他にも'''Windows 2000'''で互換性があります。 !man-look-vista.png!
-
-上記はWindows Vistaで`simple-clock.rb`サンプルが動作している図です。この例でも時計を作るために楕円と線が描かれており、これは一秒に何回かそれ自信が再描画するのので生き生きと描かれます。
+Green Shoesは'''Microsoft Windows XP'''と'''Windows 7'''で動作を確認しています。
+!{margin_left: 0}../snapshots/sample33.png!
 
-アプリケーション上部のテキストが、現在の時刻を表示していることに注意してください。Shoesは、いくつかの色、太字、斜字、下線、そしてファイルからフォントをロードして語句を配置する機能を持っています。
+上記はWindows 7で`sample33.rb`サンプルが動作している図です。
+Green Shoesは3つの拡張ライブラリを含んでいます。
+chipmunk physicsとbloopsaphoneと3D texture mappingです。
+最初の2つはバイナリで提供しているため、今のところWindowsでしか動作しません。
 
 ==== Linux ====
 
-これは'''Ubuntu Linux'''上で`simple-downloader.rb`サンプルが動作しているスクリーンショットです。!man-look-ubuntu.png!
+これは'''Ubuntu on VirtualBox for Windows'''上で`sample44.rb`サンプルが動作しているスクリーンショットです。
+!{margin_left: 130}../snapshots/sample44-linux.png!
 
-ボタンとプログレスバーに注意してください。これらの種類のコントロールはOS XとWindowsとは異なるように見えます。しかし、テキストとリンクは同じように見えるでしょう。
+この例では時計を作るために線や円を描いています。
+時計の針の動作は線の表示/非表示を毎秒数回切り替えることにより実現しています。
 
-形状、テキスト、画像や動画はすべてのプラットフォームで同じように見えます。しかしながら、ネイティブコントロール（エディットラインやエディットボックスのような）はウィンドウテーマの見た目に一致します。Shoesはネイティブコントロールを、見た目は変化しますが、指定した大きさの範囲内で維持しようとします。
+アプリケーション上部のテキストが、現在の時刻を表示していることに注意してください。
+Green Shoesは、いくつかの色、太字、斜字、下線、そしてファイルからフォントをロードして語句を配置する
+機能を持っています。
 
-== Installing Shoes ==
+== Installing Green Shoes ==
 
-はい、ではShoesのインストールを行います。あなたは次のような疑問を持っているでしょう:Rubyのインストールは必要ですか？なにも解凍しなくてもいいですか？どんなコマンドをタイプする必要がありますか？
- 
-いや。Rubyを必要としません。WinZipを必要としません。なにもタイプしなくていいです。
+はい、ではGreen Shoesのインストールを行います。あなたは次のような疑問を持っているでしょう:
+Rubyのインストールは必要ですか？なにも解凍しなくてもいいですか？どんなコマンドをタイプする必要がありますか？
+
+はい。RubyやGemをインストールする必要はあります。でも心配しないで下さい。
+以下に必要なステップを全て示しますから。
+
+==== Step 1: Green Shoesのインストール ====
+
+まず最初にRubyをインストールします。
+Windowsの場合はこのサイト[[http://rubyinstaller.org/ RubyInstaller for Windows]]
+にアクセスして、最新の'''RubyInstaller 1.9.2'''をインストールして下さい。
 
-Shoesを開始するには、多くのシステムではShoesのアイコンをクリックしてインストーラを実行するだけです。Shoesはすべてを組み込みで備えています。もっとも、まさしくそれに関して明確になるように、私たちはすべてのステップについて話をします。
+そして、以下のコマンドを実行してください。
 
-==== Step 1: Shoesのインストール ====
+ * gem install green_shoes
 
-[[http://shoesrb.com/ the site of Shoes]]へアクセスしてShoesのインストーラをダウンロードします。通常はホームページの上部の角にあるインストーラのひとつを手に入れます。 !man-builds.png!
+これだけです。簡単でしょう?
 
-ここにインストーラの実行方法があります：
+'''注意:''' green_shoes gemはこのサイト[[http://rubygems.org/gems/green_shoes RubyGems.org]]
+にあります。
 
- * '''Mac OS X'''では、'''.dmg'''で終わっているファイルを手に入れます。このファイルをダブルクリックすると、'''Shoes'''アイコンと'''Applications'''フォルダと共にウィンドウが表示されます。矢印に従って'''Applications'''フォルダにShoesアイコンをドラッグします。 !man-intro-dmg.png!
-*  '''Windows'''では、'''.exe'''ファイルをダウンロードします。このファイルをダブルクリックして次の指示に従ってください。!man-intro-exe.png!
-* '''Linux'''では、'''.run'''で終わっているファイルをダウンロードします。このファイルをダブルクリックするとShoesが起動します。(シェルスクリプトのようにプロンプトからこのファイルを実行することもできます。実際には、これは小さなシェルスクリプトです。)
+もしriやrdocの作成でエラーが発生したら、次のオプション`--no-ri --no-rdoc`を試してみて下さい。
 
 ==== Step 2: 新しいテキストファイルの作成 ====
 
@@ -80,8 +105,8 @@ Shoesプログラムは'''.rb'''の拡張子で終わる、ただの単純なテ
 そして、空のウィンドウに次のようにタイプしてください:
 
 {{{
+ require 'green_shoes'
  Shoes.app do
-   background "#DFA"
    para "Welcome to Shoes"
  end
 }}}
@@ -90,46 +115,59 @@ Shoesプログラムは'''.rb'''の拡張子で終わる、ただの単純なテ
 
 ==== Step 3: それを実行してください！Shoesへ行こう！ ====
 
-プログラムを実行するためには:
+プログラムを実行するためには、コンソールウィンドウを開いて、以下のコマンドを実行します。
 
- * '''Mac OS X'''では、'''Applications'''へ再度行きます。今度は、そのフォルダの'''Shoes'''アイコンをダブルクリックします。そのドックの中に赤い靴のアイコンが現れます。'welcome.rb'をデスクトップから、そのドックアイコンへドラッグしてください。
- * '''Windows'''では、スタートメニューへから'''All Programs'''、'''Shoes'''そして'''Shoes'''へ行きます。ファイルの選択ボックスが表示されます。デスクトップに目を通して'welcome.rb'を選択します。'''OK'''をクリックしたら、後は自分でやってください。!man-run-xp.png! !man-run-vista.png!
- * '''Linux'''では、ほとんど一回の手続きでだけでShoesを実行します。あなたはファイル選択ボックスを見るはずです。デスクトップに目を通して、`welcome.rb`を選択して'''OK'''を押してください。
+ * ruby welcome.rb !man-editor-osx.png!
 
 まだ大したものではないですが、確かにそれはプログラムです！少なくとも、そのコツが分かったでしょう！
 
 ==== Shoesで何を作りますか？ ====
 
-さて、ウィンドウアプリケーションを作成することができます。しかし、Shoesはウェブから影響を受けているので、アプリケーションは多くのウィジェットよりも、画像を使ったりテキストを配置する傾向があります。例えば、Shoesはタブコントロールやツールバーを備えていません。Shoesは''軽量な''ツールきっとだと言うことを覚えていますか？
+さて、ウィンドウアプリケーションを作成することができます。
+しかし、Shoesはウェブから影響を受けているので、アプリケーションは多くのウィジェットよりも、
+画像を使ったりテキストを配置する傾向があります。例えば、Shoesはタブコントロールやツールバーを備えていません。
+Shoesは''軽量な''ツールキットだと言うことを覚えていますか？
 
-それでもShoesはボタンやエディットボックスのようなウィジェットを少しだけ持っています。そして、多くの（タブコントロールまたはツールバーのような）不足している要素は、画像でシミュレーションすることができます。
+それでもShoesはボタンやエディットボックスのようなウィジェットを少しだけ持っています。
+そして、多くの（タブコントロールまたはツールバーのような）不足している要素は、画像でシミュレーションすることが
+できます。
 
-ShoesはCairoと呼ばれるとてもよくできた描画エンジンによって一部書かれており、それは形状や色彩を描くのに利用されています。このように、Shoesは、生き生きとしたグラフィックを描画するためにとてもいい言語である、NodeBoxとProcessingから影響を受けています。
+ShoesはCairoと呼ばれるとてもよくできた描画エンジンによって一部書かれており、
+それは形状や色彩を描くのに利用されています。このように、Shoesは、生き生きとしたグラフィックを描画するために
+とてもいい言語である、NodeBoxとProcessingから影響を受けています。
 
-== The Rules of Shoes ==
+== The Rules of Green Shoes ==
 
-Shoesがどのように動作するのか推測するのはやめましょう。トリッキーな動作で悩むと思います。私はShoesの中心的な規則を要約しまいた。これらは、それにすべての働きをさせるためには知らなくてはならないものです。
+Green Shoesがどのように動作するのか推測するのはやめましょう。トリッキーな動作で悩むと思います。
+私はShoesの中心的な規則を要約しまいた。これらは、それにすべての働きをさせるためには知らなくては
+ならないものです。
 
-これらはShoesの至る所に目にする一般的な規則です。Shoesは単純さと明解さという全体的な理念を持っていますが、いくつか勉強したり覚えたりする必要のあるポイントがあります。
+これらはGreen Shoesの至る所で目にする一般的な規則です。Green Shoesは単純さと明解さという
+全体的な理念を持っていますが、いくつか勉強したり覚えたりする必要のあるポイントがあります。
 
 ==== Shoesのトリッキーなブロック ====
 
-はい、これは極めて重要です。Shoesはブロックによってトリックをします。このトリックはすべてのものを読みやすくします。しかし、これは深い階層でブロックを利用することを難しくもします。
+はい、これは極めて重要です。Green Shoesはブロックによってトリックをします。
+このトリックはすべてのものを読みやすくします。しかし、これは深い階層でブロックを利用することを難しくもします。
 
 '''普通のRubyブロックを試しましょう：'''
 
 {{{
- ary = ['potion', 'swords', 'shields']
- ary.each do |item|
-   puts item
+ Shoes.app do
+   ary = ['potion', 'swords', 'shields']
+   ary.each do |item|
+     puts item
+   end
  end
 }}}
 
-Shoesでは、これらの種類のブロックは同じ働きをします。この上記のブロックは配列をループして各オブジェクトを`item`変数に格納します。この`item`変数はブロックが終わると消滅（スコープから出る）します。
+Green Shoesでは、これらの種類のブロックは同じ働きをします。この上記のブロックは配列をループして
+各オブジェクトを`item`変数に格納します。この`item`変数はブロックが終わると消滅（スコープから出る）します。
 
-考え方を守っているもう一つのことは、普通のRubyブロックの内部と`self`を同じままにしています。`each`の前に呼ばれるどんな`self`でも、それは`each`ブロック内部と同じです。
+考え方を守っているもう一つのことは、普通のRubyブロックの内部と`self`を同じままにしています。
+`each`の前に呼ばれるどんな`self`でも、それは`each`ブロック内部と同じです。
 
-'''これらはどちらも大部分のShoesのブロックで正しいです。'''
+'''これらはどちらも大部分のGreen Shoesのブロックで正しいです。'''
 
 {{{
  Shoes.app do
@@ -145,7 +183,8 @@ Shoesでは、これらの種類のブロックは同じ働きをします。こ
 
 もう一方のブロックは`stack`ブロックです。このブロックはselfを変更しません。
 
-'''どんな理由があって`app`ブロックはselfを変更するのでしょうか？''' 最後の例を徹底的に詳しく説明することから始めましょう。
+'''どんな理由があって`app`ブロックはselfを変更するのでしょうか？''' 最後の例を徹底的に詳しく説明することから
+始めましょう。
 
 {{{
  Shoes.app do
@@ -157,7 +196,9 @@ Shoesでは、これらの種類のブロックは同じ働きをします。こ
  end
 }}}
 
-上記の例におけるすべての`self`はアプリケーションオブジェクトです。Shoesは`app`ブロック内部でselfを変更するために、Rubyの`instance_eval`を利用します。そして、そのメソッドは`stack`を呼び出して`para`をアプリケーションへ送ります。
+上記の例におけるすべての`self`はアプリケーションオブジェクトです。Shoesは`app`ブロック内部でselfを
+変更するために、Rubyの`instance_eval`を利用します。そして、そのメソッドは`stack`を呼び出して
+`para`をアプリケーションへ送ります。
 
 '''これはShoesアプリケーション全体でインスタンス変数が利用できる理由でもあります：'''
 
@@ -173,13 +214,13 @@ Shoesでは、これらの種類のブロックは同じ働きをします。こ
 
 これらのインスタンス変数は、すべてアプリケーションオブジェクト内部で終了します。
 
-'''新しいウィンドウを作成するときはいつでも、`self`も変更されます。'''そして、Shoes.appに加えて、これは[[Element.window]]と[[Element.dialog]]メソッドを意味します。
+'''新しいウィンドウを作成するときはいつでも、`self`も変更されます。'''
 
 {{{
- Shoes.app :title => "MAIN" do
+ Shoes.app title: "MAIN" do
    para self
    button "Spawn" do
-     window :title => "CHILD" do
+     Shoes.app title: "CHILD" do
        para self
      end
    end
@@ -190,9 +231,12 @@ Shoesでは、これらの種類のブロックは同じ働きをします。こ
 
 もっとも、`stack`ブロックは別の話です。これは`self`を変えませんし、基本的に標準のブロックです。
 
-'''しかしトリックがあります：'''`stack`を配置してブロックを与えたとき、アプリケーションオブジェクトはstackをメモリへ配置します。ブロックが終了するときstackは立ち去ります。そのため、アプリケーションのトップスロットから新しいstackまで、ブロック内部のすべての描画は'''リダイレクト'''されます。
+'''しかしトリックがあります：'''`stack`を配置してブロックを与えたとき、アプリケーションオブジェクトはstackを
+メモリへ配置します。ブロックが終了するときstackは立ち去ります。
+そのため、アプリケーションのトップスロットから新しいstackまで、ブロック内部のすべての描画は'''リダイレクト'''されます。
 
-そのため、まず、たとえ彼らが確かにアプリケーションオブジェクトへ渡したとしても、それらの3つの`para`は`stack`上に描画されます。
+そのため、まず、たとえ彼らが確かにアプリケーションオブジェクトへ渡したとしても、それらの3つの`para`は
+`stack`上に描画されます。
 
 {{{
  Shoes.app do
@@ -206,49 +250,65 @@ Shoesでは、これらの種類のブロックは同じ働きをします。こ
 
 少しトリッキーですよね？これについて知っていても噛みつかれるかもしれません。
 
-それがあなたをつかまえる一つの方法は、`app`ブロック外のプログラム内のどこか他で、stackを編集しようとすることです。
+それがあなたをつかまえる一つの方法は、`app`ブロック外のプログラム内のどこか他で、stackを編集しようと
+することです。
 
 例えばstackオブジェクトを使いまわすとしましょう。そして、そのオブジェクトを編集するクラスを持ちます。
 
 {{{
  class Messenger
-   def initialize(stack)
-     @stack = stack
+   def initialize slot
+     @slot = slot
    end
-   def add(msg)
-     @stack.append do
-       para msg
-     end
+   def add msg
+     para msg rescue puts $!
    end
  end
+ 
+ Shoes.app do
+   slot = stack
+   m = Messenger.new slot
+   m.add 'hello'
+ end
 }}}
 
-アプリケーションが始まるときに、stackオブジェクトをMessengerクラスへ渡すと仮定します。そして、後で、メッセージが来るとき、`add`メソッドはそのstackにパラグラフを追加するのに用いられます。正しく動作するでしょうか？
+アプリケーションが始まるときに、stackオブジェクトをMessengerクラスへ渡すと仮定します。
+そして、後で、メッセージが来るとき、`add`メソッドはそのstackにパラグラフを追加するのに用いられます。
+正しく動作するでしょうか？
 
-いや、それは動作しません。`para`メソッドが見つかりません。すでにアプリケーションオブジェクトはまわりにありません。そして、それは`para`メソッドによるものです。
+いや、それは動作しません。`para`メソッドが見つかりません。すでにアプリケーションオブジェクトは
+まわりにありません。そして、それは`para`メソッドによるものです。
 
-幸いにも、それぞれのShoesオブジェクトはアプリケーションオブジェクトを再び開かせる`app`メソッドを持っているため、さらなる編集ができます。
+幸いにも、それぞれのShoesオブジェクトはアプリケーションオブジェクトを再び開かせる`app`メソッドを
+持っているため、さらなる編集ができます。
 
 {{{
  class Messenger
-   def initialize(stack)
-     @stack = stack
+   def initialize slot
+     @slot = slot
    end
-   def add(msg)
-     @stack.app do
-       @stack.append do
-         para msg
-       end
+   def add msg
+     @slot.app do
+       para msg rescue puts $!
      end
    end
  end
+ 
+ Shoes.app do
+   slot = stack
+   m = Messenger.new slot
+   m.add 'hello'
+ end
 }}}
 
 ご想像のとおり、その`app`オブジェクトは`self`をアプリケーションオブジェクトに変更します。
 
 ルールは次のようになります：
 
-1. '''"app"という名前か新しいウィンドウを作成するメソッドはアプリケーションオブジェクトの`self`を変更します。'''[[BR]]（これは、[[Element.window]] と[[Element.dialog]]同様に、Shoes.appとSlot.appの両方にとって正しいです。）[[BR]]2. '''stackへ加えられるブロックは、フローや（追加などの）どんな操作メソッドでもselfを変更しません。その代わりに、彼らはスロットをアプリケーションの編集stackにポップします。'''
+1. '''"app"という名前か新しいウィンドウを作成するメソッドはアプリケーションオブジェクトの`self`を変更します。
+'''[[BR]]（これは、[[Element.window]] と[[Element.dialog]]同様に、Shoes.appとSlot.appの両方にとって正しいです。）
+[[BR]]2. '''stackへ加えられるブロックは、フローや（追加などの）どんな操作メソッドでもselfを
+変更しません。その代わりに、彼らはスロットをアプリケーションの編集stackにポップします。'''
 
 ==== 固定された高さに注意 ====
 
@@ -258,10 +318,12 @@ Shoesでは、これらの種類のブロックは同じ働きをします。こ
  Shoes.app do
    flow do
      stack :width => 200 do
+       background lavender
        caption "Column one"
        para "is 200 pixels wide"
      end
      stack :width => -200 do
+       background bisque
        caption "Column two"
        para "is 100% minus 200 pixels wide"
      end
@@ -269,15 +331,18 @@ Shoesでは、これらの種類のブロックは同じ働きをします。こ
  end
 }}}
 
-スロットの固定された高さは、より一般的ではありません。通常は、テキストや画像がウィンドウの下へできるだけ流れることを望みます。高さは通常は自然に決定します。
+スロットの固定された高さは、より一般的ではありません。通常は、テキストや画像がウィンドウの下へ
+できるだけ流れることを望みます。高さは通常は自然に決定します。
 
-ここで重要なことは、固定された高さが実際はスロットに違うように振る舞わせることです。確かに最後にはスロットは完全に切り離なされて、'''入れ子のウィンドウ'''になります。新しいレイヤーはオペレーティングシステムによってスロットを一定の正方形に保つために作成されます。
+ここで重要なことは、固定された高さが実際はスロットに違うように振る舞わせることです。
+確かに最後にはスロットは完全に切り離なされて、'''入れ子のウィンドウ'''になります。
+新しいレイヤーはオペレーティングシステムによってスロットを一定の正方形に保つために作成されます。
 
 通常のスロットと入れ子ウィンドウのスロットとの違いは、後者はスクロールバーを持てることです。
 
 {{{
  Shoes.app do
-   stack :width => 200, :height => 200, :scroll => true do
+   stack width: 200, height: 200, scroll: true do
      background "#DFA"
      100.times do |i|
        para "Paragraph No. #{i}"
@@ -286,43 +351,63 @@ Shoesでは、これらの種類のブロックは同じ働きをします。こ
  end
 }}}
 
-これらの入れ子ウィンドウはより多くのメモリを必要とします。彼らはアプリケーションにもう少し負担をかけます。もしあなたが、固定された高さのたくさんのスロットで遅さを経験しているなら、違うアプローチを試してください。
+これらの入れ子ウィンドウはより多くのメモリを必要とします。彼らはアプリケーションにもう少し負担をかけます。
+もしあなたが、固定された高さのたくさんのスロットで遅さを経験しているなら、違うアプローチを試してください。
+
+'''注意:''' 固定された高さのマジック(スロットを入れ子のウィンドウにする)は今のところGreen Shoesでは
+サポートしていません。スクロールバーは自動的に現れますがメインウィンドウに対してのみです。
+
+{{{
+ Shoes.app do
+   stack :width => 200 do
+     background "#DFA"
+     100.times do |i|
+       para "Paragraph No. #{i}"
+     end
+   end
+ end
+}}}
 
 ==== 画像と形状のブロック ====
 
-多くの初心者が形状でウィンドウを散らかし始めます。すべての長方形や楕円形をスロットへ投げ入れるのは確かに簡単です。
+多くの初心者が形状でウィンドウを散らかし始めます。すべての長方形や楕円形をスロットへ投げ入れるのは
+確かに簡単です。
 
 '''しかしながら、Shoesはそれらすべての形状のためにオブジェクトを生成することを覚えておいて下さい！。'''
 
 {{{
  Shoes.app do
-   fill black(0.1)
+   fill black.push(0.1)
    100.times do |i|
-     oval i, i, i * 2
+     oval i, i, i * 2 if i > 0
    end
  end
 }}}
 
-この例では、100個の楕円形オブジェクトが生成されます。これは悪すぎるわけではありません。しかし、一つの形状の中にこれらを作成するのなら、これはより軽量になるでしょう。
+この例では、100個の楕円形オブジェクトが生成されます。これは悪すぎるわけではありません。
+しかし、一つの形状の中にこれらを作成するのなら、これはより軽量になるでしょう。
 
 {{{
+ # Not yet available
  Shoes.app do
    fill black(0.1)
    shape do
      100.times do |i|
-       oval i, i, i * 2
+       oval i, i, i * 2 if i > 0
      end
    end
  end
 }}}
 
-ああ、待ってください。この楕円形は今回は満たされません。なぜなら、この形状たちは一つの大きな形状に結合されたからです。そして、このケースではShoesはどこを満たすべきか、分かりません。
+ああ、待ってください。この楕円形は今回は満たされません。なぜなら、この形状たちは一つの大きな形状に
+結合されたからです。そして、このケースではShoesはどこを満たすべきか、分かりません。
 
 そして、アウトラインを厳密に扱うとき、通常は一つの形状に結合することを望みます。
 
 別のオプションでは、これらすべての楕円形を一つの画像に結合します。
 
 {{{
+ # Not yet available
  Shoes.app do
    fill black(0.1)
    image 300, 300 do
@@ -333,24 +418,34 @@ Shoesでは、これらの種類のブロックは同じ働きをします。こ
  end
 }}}
 
-そうしよう！その楕円形はすべて一つの300 x 300の画像に結合されます。この場合では、その画像をメモリに保管するのは、おそらく100個の楕円形を持つよりはるかに大きくなるかもしれません。しかし、何千もの形状を扱う場合には、イメージブロックはより安っぽくなる可能性があります。
+そうしよう！その楕円形はすべて一つの300 x 300の画像に結合されます。この場合では、その画像を
+メモリに保管するのは、おそらく100個の楕円形を持つよりはるかに大きくなるかもしれません。
+しかし、何千もの形状を扱う場合には、イメージブロックはより安っぽくなる可能性があります。
 
-ポイントは以下の通りです：画像やブロックへ形状をグループ化することは簡単ですので、もし速度を得ようとするのなら、それを試してください。形状ブロックは特にメモリと速度を節約させるでしょう。
+ポイントは以下の通りです：画像やブロックへ形状をグループ化することは簡単ですので、もし速度を
+得ようとするのなら、それを試してください。形状ブロックは特にメモリと速度を節約させるでしょう。
+
+''注意:'' 今のところGreen Shoesではこのマジック(複数の形状をグループにして一つの画像や形状にする)
+はサポートしていません。
 
 ==== どこでもUTF-8 ====
 
-Ruby自体はUnicodeを意識しません。そして、UTF-8は一種のUnicodeです。(UTF-8の完全な説明は[[http://en.wikipedia.org/wiki/UTF-8 Wikipedia]]を見てください。)
+Ruby自体はUnicodeを意識しません。そして、UTF-8は一種のUnicodeです。
+(UTF-8の完全な説明は[[http://en.wikipedia.org/wiki/UTF-8 Wikipedia]]を見てください。)
 
-しかしながら、UTF-8はWEBで一般的です。そして、多くの異なったプラットホームがそれをサポートします。そこで、Shoesがしなくてはならない変換の量を減らすために、Shoesはすべての文字列がUTF-8フォーマットであることを期待します。
+しかしながら、UTF-8はWEBで一般的です。そして、多くの異なったプラットホームがそれをサポートします。
+そこで、Green Shoesがしなくてはならない変換の量を減らすために、Green Shoesはすべての文字列が
+UTF-8フォーマットであることを期待します。
 
-すばらしいことに、ShoesでUTF-8を使えば無数の言語（ロシア語、日本語、スペイン語、英語）を表示ことができます。テキストエディタでUTF-8を使用することだけを確認してください!
+すばらしいことに、Green ShoesでUTF-8を使えば無数の言語（ロシア語、日本語、スペイン語、英語）を
+表示ことができます。テキストエディタでUTF-8を使用することだけを確認してください!
 
 実例を示します：
 
 {{{
  Shoes.app do
    stack :margin => 10 do
-     @edit = edit_box :width => 1.0 do
+     @edit = edit_box do
        @para.text = @edit.text
      end
      @para = para ""
@@ -358,32 +453,42 @@ Ruby自体はUnicodeを意識しません。そして、UTF-8は一種のUnicode
  end
 }}}
 
-このアプリケーションは何でもコピーして編集ボックスに貼り付けて、Shoesパラグラフで表示することができます。外国語（ギリシャ語か日本語のような）のテキストをこのボックスにコピーして、どのように表示されるかを見ることができます。
+このアプリケーションは何でもコピーして編集ボックスに貼り付けて、Green Shoesパラグラフで表示することが
+できます。外国語（ギリシャ語か日本語のような）のテキストをこのボックスにコピーして、どのように表示されるかを
+見ることができます。
 
-これは、その編集ボックスがUTF-8の文字を返すことを確かめるのにいいテストです。そして、そのパラグラフはどんなUTF-8の文字でも設定することができます。
+これは、その編集ボックスがUTF-8の文字を返すことを確かめるのにいいテストです。
+そして、そのパラグラフはどんなUTF-8の文字でも設定することができます。
 
-'''重要事項：'''もしいくつかのUTF-8の文字が表示されないなら、パラグラフのフォントを変更する必要があります。これは特にOS Xで一般的です。
+'''重要事項：'''もしいくつかのUTF-8の文字が表示されないなら、パラグラフのフォントを変更する必要があります。
+これは特にOS Xで一般的です。
 
 そして、OS Xでのおすすめの日本語フォントは'''AppleGothic'''です。Windowsでは'''MS UI Gothic'''です。
 
 {{{
  Shoes.app do
-   para "てすと (te-su-to)", :font => case RUBY_PLATFORM
-   when /mingw/; "MS UI Gothic"
-   when /darwin/; "AppleGothic, Arial"
-   else "Arial"
-   end
+   para "てすと (te-su-to)",
+    font: case RUBY_PLATFORM
+    when /mingw/; "MS UI Gothic"
+    when /darwin/; "AppleGothic, Arial"
+    else "Arial"
+    end
  end
 }}}
 
-さらに、Shoesで文字列を扱う場合もUTF-8の文字列を必要とします。編集ボックス、編集ライン、リストボックス、ウィンドウタイトルやテキストブロックはすべてUTF-8をとります。間違った文字の入った文字列をあたえた場合は、コンソールにエラーが表示されます。
+さらに、Green Shoesで文字列を扱う場合もUTF-8の文字列を必要とします。
+編集ボックス、編集ライン、リストボックス、ウィンドウタイトルやテキストブロックはすべてUTF-8をとります。
+間違った文字の入った文字列をあたえた場合は、コンソールにエラーが表示されます。
 
 ==== メインアプリケーションとRequire ====
 
-'''注意:''' このルールはRaisinsのためのものです。PolicemanではTOPLEVEL_BINDINGを使っているので、最初の例では `main` (Rubyトップレベルオブジェクト)が表示されます。`Shoes.app`ブロックの外側では、`Para`ではなく`Shoes::Para`と記述する必要がありますが。
-
+'''注意:''' このルールはRaisinsのためのものです。PolicemanとGreen ShoesではTOPLEVEL_BINDINGを
+使っているので、最初の例では `main` (Rubyトップレベルオブジェクト)が表示されます。
+`Shoes.app`ブロックの外側では、`Para`ではなく`Shoes::Para`と記述する必要がありますが。
 
-それぞれのShoesアプリケーションは、それ自体を作ることができる小さな部屋を与えられます。クラスを作成したり変数を設定できますが、それらは他のShoesプログラムから見ることはできません。それぞれのプログラムはそれ自身の匿名クラス内で実行されます。
+それぞれのShoesアプリケーションは、それ自体を作ることができる小さな部屋を与えられます。
+クラスを作成したり変数を設定できますが、それらは他のShoesプログラムから見ることはできません。
+それぞれのプログラムはそれ自身の匿名クラス内で実行されます。
 
 {{{
  main = self
@@ -392,7 +497,9 @@ Ruby自体はUnicodeを意識しません。そして、UTF-8は一種のUnicode
  end
 }}}
 
-この匿名クラスは`(shoes)`と呼ばれ、それは空の無名クラスです。`Shoes`モジュールは（`include Shoes`を利用して）このクラスにミックスインされているため、パラグラフクラスを参照しているときに`Para`や`Shoes::Para`を利用することができます。
+この匿名クラスは`(shoes)`と呼ばれ、それは空の無名クラスです。`Shoes`モジュールは
+（`include Shoes`を利用して）このクラスにミックスインされているため、パラグラフクラスを参照しているときに
+`Para`や`Shoes::Para`を利用することができます。
 
 このアプローチの長所は：
 
@@ -405,95 +512,125 @@ Ruby自体はUnicodeを意識しません。そして、UTF-8は一種のUnicode
 
 {{{
  class Storage; end
-
+ 
  Shoes.app do
    para Storage.new
  end
 }}}
 
-アプリケーションが完了すれば`Storage`クラスは消えます。ほかのアプリケーションはStorageクラスを利用できません。そして、それは`require`を利用してロードされるファイルから手に入れることはできません。
+アプリケーションが完了すれば`Storage`クラスは消えます。ほかのアプリケーションはStorageクラスを
+利用できません。そして、それは`require`を利用してロードされるファイルから手に入れることはできません。
 
 もっとも、`require`するときそのコードは近くにいます。それはRubyのトップレベル環境に保持されます。
 
-そして、この規則は：'''アプリケーションのコードに一時的なクラスを保持し、requireに永続的なクラスを保持しなさい'''です。
+そして、この規則は：'''アプリケーションのコードに一時的なクラスを保持し、requireに永続的なクラスを
+保持しなさい'''です。
 
 = Shoes =
 
-Shoesはウィンドウや、それらウィンドウ内部の要素を描くことがすべてです。今はウィンドウ自体に焦点を当てましょう。他のセクションの[[Slots]]や[[Elements]]がウィンドウ内部に関してのすべてを対象としています。
+Green Shoesはウィンドウや、それらウィンドウ内部の要素を描くことがすべてです。
+今はウィンドウ自体に焦点を当てましょう。
+他のセクションの[[Slots]]や[[Elements]]がウィンドウ内部に関してのすべてを対象としています。
 
-ここでは、このマニュアルはより辞書のように読んでください。それぞれのページのほとんどは、利用可能なメソッドの一覧であり、各トピックを対象としています。この考えは、すべてに関してとても詳細かつ明確であることです。
+ここでは、このマニュアルはより辞書のように読んでください。それぞれのページのほとんどは、利用可能なメソッドの
+一覧であり、各トピックを対象としています。この考えは、すべてに関してとても詳細かつ明確であることです。
 
-そして、このマニュアルの難しさにぶつかって、始めることについてまだ分からないなら、おそらくこのマニュアルの[[Hello! beginning]]に戻るべきです。
-または、ウェブ上の初心者のリーフレットである[[https://github.com/downloads/shoes/shoes/nks.pdf Nobody Knows Shoes]]を試してください。
+そして、このマニュアルの難しさにぶつかって、始めることについてまだ分からないなら、おそらくこのマニュアルの
+[[Hello! beginning]]に戻るべきです。
+または、ウェブ上の初心者のリーフレットである
+[[https://github.com/downloads/shoes/shoes/nks.pdf Nobody Knows Shoes]]を試してください。
 
 ==== 方法の見つけ方 ====
 
 このセクションは以下を対象とします：
 
- * [[Built-in Built-in methods]] - Shoesプログラムのどこでも利用できる一般的なメソッド。
- * [[App The App window]] - Shoesのすべてのメインウィンドウに添付されたメソッド。
- * [[Styles The Styles Master List]] - Shoesのすべてのスタイルの完全な一覧。
- * [[Classes The Classes list]] - Shoesのクラスやサブクラスについて表示している表。
+ * [[Built-in Built-in methods]] - Green Shoesプログラムのどこでも利用できる一般的なメソッド。
+ * [[App The App window]] - Green Shoesのすべてのメインウィンドウに添付されたメソッド。
+ * [[Styles The Styles Master List]] - Green Shoesのすべてのスタイルの完全な一覧。
+ * [[Classes The Classes list]] - Green Shoesのクラスやサブクラスについて表示している表。
  * [[Colors The Colors list]] - すべてのビルトインカラーと[[Built-in.rgb]]におけるそれぞれの数の表。
 
-ページをよく見ても見つからないものがあれば、[[Search]]ページを試してください。それは問題をさける手っ取り早い方法です。
+ページをよく見ても見つからないものがあれば、[[Search]]ページを試してください。
+それは問題をさける手っ取り早い方法です。
 
 この一般的なリファレンスのあとに、他の２つの特別なセクションがあります：
 
  * [[Slots]] - [[Element.stack]]と[[Element.flow]]を対象とする、２つの種類のスロット。
  * [[Elements]] - すべてのボタン、形状、画像などのためのドキュメント。
 
-ここに[[Element Element Creation]]ページ（追加できるすべてのエレメントの一覧）と[[Common Common Methods]] ページ（すべてのスロットやエレメントにあるメソッドの一覧）の２つのとても大切なページがあります。
+ここに[[Element Element Creation]]ページ（追加できるすべてのエレメントの一覧）と
+[[Common Common Methods]] ページ（すべてのスロットやエレメントにあるメソッドの一覧）の
+２つのとても大切なページがあります。
 
 == Built-in Methods ==
 
-これらのメソッドはShoesのプログラムを通してどこでも利用できます。
+これらのメソッドはGreen Shoesのプログラムを通してどこでも利用できます。
 
-これらすべてのコマンドは、あなたがドットを彼らに付与しない点が珍しいです。
+これらすべてのコマンドは、あなたがドットをそれらに付与しない点が珍しいです。
 '''このマニュアルのほかのすべてのメソッドはオブジェクトにドットを付与すべきです。'''
 しかし、これらのビルトインメソッド（カーネルメソッドとも呼ばれている）はドットがないことを意味します。
 
 一般的なものとして`alert`があります：
 
 {{{
- #!ruby
- alert "No dots in sight"
+  alert "No dots in sight"
 }}}
 
-これと、カーネルメソッドはなくArrayとStringに対してだけ利用可能な`reverse`メソッドを比較してください：
+これと、ArrayとStringに対してだけ利用可能な、カーネルメソッドではない、
+`reverse`メソッドを比較してください：
 
 {{{
  #!ruby
- "Plaster of Paris".reverse
-  #=> "siraP fo retsalP"
- [:dogs, :cows, :snakes].reverse
-  #=> [:snakes, :cows, :dogs]
+ Shoes.app do
+   para "Plaster of Paris".reverse
+   #=> "siraP fo retsalP"
+   para [:dogs, :cows, :snakes].reverse
+   #=> [:snakes, :cows, :dogs]
+ end
 }}}
 
-描画やボタンを作成したりするための多くのShoesメソッドはスロットへ付与されます。より詳しい情報については[[Slots]]のセクションを見てください。
+描画やボタンを作成したりするための多くのGreen Shoesメソッドはスロットへ付与されます。
+より詳しい情報については[[Slots]]のセクションを見てください。
 
 ==== ビルトイン定数 ====
 
-Shoesにはいくつかのビルトイン定数があり、それはどんなバージョンのShoesが実行されているかを判別することを証明するのに利用できるかもしれません
+Green Shoesにはいくつかのビルトイン定数があり、それはどんなバージョンのGreen Shoesが
+実行されているかを判別することを証明するのに利用できるかもしれません
 
-'''Shoes::RELEASE_NAME''' Shoesリリース名の文字列定数です。Curiousから始まって、すべてのShoesリリースは名付けられます。
+'''DIR''' は、`green_shoes/lib`のフルパスです。
 
-'''Shoes::RELEASE_ID''' Shoesリリース表す数字を含みます。そして、例えばCuriousはナンバー1であり、それは初めての公式リリースです。
+'''COLORS''' は、アプリケーションで利用できる色の完全な一覧です。
 
-'''Shoes::REVISION''' は、そのビルドのSubversionのリビジョン番号です。
+'''FONTS''' は、アプリケーションで利用できるフォントの完全な一覧です。
 
-'''Shoes::FONTS''' は、アプリケーションで利用できるフォントの完全な一覧です。この一覧は[[Built-in.font]]メソッドによってロードされたすべてのフォントを含みます。
+'''VERSION''' は、Green Shoesのバージョンです。
 
-=== alert(message: a string) » nil ===
+{{{
+ Shoes.app do
+   para VERSION
+   para fg(DIR, red)
+   image File.join(DIR, '../static/gshoes-icon.png')
+   para fg(FONTS.join(', '), green)
+   para COLORS.map{|k, v| [k, v]}
+ end
+}}}
+
+=== alert(message: a string, :block => true or false, title: a string) » nil ===
 
 短いメッセージを含むウィンドウをポップアップします。
 
 {{{
  #!ruby
- alert("I'm afraid I must interject!")
+ alert "I'm afraid I must interject!"
 }}}
 
-alertは信じられないほど煩わしいので控えめに利用してください！プログラムをデバッグする手助けのメッセージを表示するためにalertを利用するなら、[[Built-in.debug]]または[[Built-in.info]]メソッドを調べてみてください。
+alertは信じられないほど煩わしいので控えめに利用してください！
+プログラムをデバッグする手助けのメッセージを表示するためにalertを利用するなら、
+Rubyの標準メソッド`puts`や`p`を試してみて下さい。
+
+もしalert()メソッドをスレッドセーフにしたい場合、すなわちメインスレッドをブロックしたくない場合は、
+`:block => false`オプションを使ってください。またウィンドウのタイトルを変更したい場合は、
+`:title => a string`オプションを使ってください。
 
 === ask(message: a string) » a string ===
 
@@ -501,26 +638,31 @@ alertは信じられないほど煩わしいので控えめに利用してくだ
 
 {{{
  #!ruby
- name = ask("Please, enter your name:")
+ if name = ask("Please, enter your name:")
+   Shoes.app{para "Welcome, #{name}!"}
+ end
 }}}
 
-上記のスクリプトを実行するとき、コンピュータを利用している人は、名前を入力するための空のボックスを持つウィンドウを見るでしょう。そして、その名前は`name`変数に保存されます。
+上記のスクリプトを実行するとき、コンピュータを利用している人は、名前を入力するための空のボックスを
+持つウィンドウを見るでしょう。そして、その名前は`name`変数に保存されます。
 
-=== ask_color(title: a string) » Shoes::Color ===
+=== ask_color(title: a string) » RGB array ===
 
-カラーピッカーウィンドウをポップアップします。このプログラムは色が選ばれるのを待ち、そしてあなたに色オブジェクトを与えます。いくつかの方法でこの色を利用するために`Color`ヘルプを見てください。
+カラーピッカーウィンドウをポップアップします。このプログラムは色が選ばれるのを待ち、そしてあなたに
+色オブジェクトを与えます。いくつかの方法でこの色を利用するために`Color`ヘルプを見てください。
 
 {{{
  #!ruby
- backcolor = ask_color("Pick a background")
+ backcolor = ask_color "Pick a background"
  Shoes.app do
-  background backcolor
+   background backcolor
  end
 }}}
 
 === ask_open_file() » a string ===
 
-"ファイルを開く。。。"ウィンドウをポップアップします。これは標準のウィンドウであり、すべてのフォルダを表示して開くファイルを選択させます。そしてファイルの名前を返します。
+"ファイルを開く。。。"ウィンドウをポップアップします。これは標準のウィンドウであり、すべてのフォルダを表示して
+開くファイルを選択させます。そしてファイルの名前を返します。
 
 {{{
  #!ruby
@@ -537,11 +679,15 @@ alertは信じられないほど煩わしいので控えめに利用してくだ
 {{{
  #!ruby
  save_as = ask_save_file
+ Shoes.app do
+   para save_as
+ end
 }}}
 
 === ask_open_folder() » a string ===
 
-"フォルダを開く。。。"ウィンドウをポップアップします。これは、すべてのフォルダを表示し、開くフォルダを選択させる標準のウィンドウです。これはあなたにフォルダの名前を渡します。
+"フォルダを開く。。。"ウィンドウをポップアップします。これは、すべてのフォルダを表示し、開くフォルダを
+選択させる標準のウィンドウです。これはあなたにフォルダの名前を渡します。
 
 {{{
  #!ruby
@@ -553,50 +699,42 @@ alertは信じられないほど煩わしいので控えめに利用してくだ
 
 === ask_save_folder() » a string ===
 
-これは先ほど述べた`ask_open_folder`と似ており、"フォルダを保存する。。。"ウィンドウをポップアップします。OS X上では、現在このメソッドは`ask_open_folder`のエイリアスのようになっています。
+これは先ほど述べた`ask_open_folder`と似ており、"フォルダを保存する。。。"ウィンドウをポップアップします。
 
 {{{
  #!ruby
  save_to = ask_save_folder
+ Shoes.app do
+   para save_to
+ end
 }}}
 
-
 === confirm(question: a string) » true or false ===
 
-yes-または-noの質問をポップアップします。コンピュータの前の人が'''yes'''をクリックするなら、返される`true`を受け取ります。そうでは無いなら、返される`false`を受け取ります。
+yes-または-noの質問をポップアップします。コンピュータの前の人が'''yes'''をクリックするなら、
+返される`true`を受け取ります。そうでは無いなら、返される`false`を受け取ります。
 
 {{{
  #!ruby
  if confirm("Draw a circle?")
-  Shoes.app{ oval :top => 0, :left => 0, :radius => 50 }
+  Shoes.app{ oval top: 0, left: 0, radius: 50 }
  end
 }}}
 
-=== debug(message: a string) » nil ===
-
-Shoesコンソールへデバッグメッセージを送ります。
-どんなShoesウィンドウ上でも、`Alt-/`（または、OS X上では`⌘-/`）を押すことによって、Shoesコンソールを立ち上げることができます。
-
-{{{
- #!ruby
- debug("Running Shoes on " + RUBY_PLATFORM)
-}}}
-
-[[Built-in.error]]、[[Built-in.warn]]と[[Built-in.info]]メソッドも確認してください。
-
-=== error(message: a string) » nil ===
-
-Shoesコンソールへエラーメッセージ送ります。このメソッドはエラーをログするためだけに利用すべきです。自分ためのメッセージをログするには[[Built-in.debug]]メソッドを試してください。
-
-おお、そして、文字列よりも、直接このメソッドに例外を手渡すべきです。そしてそれは適切にフォーマットされるでしょう。
-
 === exit() ===
 
 プログラムを止めます。突然に終了したいときはいつでも、これを呼んでください。
 
+'''注意:''' Ruby自身の標準`exit`メソッドを使う必要がある場合は (フォークされたRubyプロセス内で等)
+`Kernel.exit`を呼び出して下さい。
+
 === font(message: a string) » an array of font family names ===
 
-ファイルからTrueType（または他の種類のフォント）をロードします。TrueTypeはすべてのプラットフォームでサポートされるとはいえ、あなたのプラットフォームは他の種類のフォントをサポートするかもしれません。Shoesはこの動作に、それぞれのオペレーティングシステムのビルトインフォントシステムを利用します。
+ファイルからTrueType（または他の種類のフォント）をロードします。TrueTypeはすべてのプラットフォームで
+サポートされるとはいえ、あなたのプラットフォームは他の種類のフォントをサポートするかもしれません。
+Shoesはこの動作に、それぞれのオペレーティングシステムのビルトインフォントシステムを利用します。
+
+'''注意:''' 今のところGreen Shoesでは、fontメソッドをサポートしていません。
 
 ここにどのプラットフォームで何のフォントが動作するかの目安があります。
 
@@ -610,104 +748,123 @@ Shoesコンソールへエラーメッセージ送ります。このメソッド
  * TrueType font (.ttf) - Mac OS X, Linux, Windows
  * TrueType collection (.ttc) - Mac OS X, Linux, Windows
 
-フォントが適切にロードされたなら、ファイルに見つかったフォントの名前の配列を取り戻すでしょう。そうではなく、ファイルにはフォントが見つからないなら`nil`が返されます。
+フォントが適切にロードされたなら、ファイルに見つかったフォントの名前の配列を取り戻すでしょう。
+そうではなく、ファイルにはフォントが見つからないなら`nil`が返されます。
 
-また興味深いことに:`Shoes::FONTS`定数はこのプラットフォームで利用可能なフォントの完全な一覧です。`include?`を利用していくつかのフォントをチェックできます。
+また興味深いことに:`Shoes::FONTS`定数はこのプラットフォームで利用可能なフォントの完全な一覧です。
+`include?`を利用していくつかのフォントをチェックできます。
 
 {{{
- if Shoes::FONTS.include? "Helvetica"
-   alert "Helvetica is available on this system."
- else
-   alert "You do not have the Helvetica font."
- end
+  if Shoes::FONTS.include? "Coolvetica"
+    alert "Coolvetica is available on this system."
+  else
+    alert "You do not have the Coolvetica font."
+  end
 }}}
 
-もしフォントを表示することに問題があるなら、それを利用する前に、アプリケーションがフォントをロードすることを確認してください。特にOS Xでは、もしフォントがロードされる前に利用されたなら、フォントキャッシュはロードされたフォントを無視する傾向があります。
-
-=== gradient(color1, color2) » Shoes::Pattern ===
+もしフォントを表示することに問題があるなら、それを利用する前に、アプリケーションがフォントを
+ロードすることを確認してください。特にOS Xでは、もしフォントがロードされる前に利用されたなら、
+フォントキャッシュはロードされたフォントを無視する傾向があります。
 
-二つの色から直線勾配を作ります。それぞれの色に、色を描画するためにShoes::Colorオブジェクトか文字列を渡します。
+=== gradient(color1, color2) » a range of RGB array ===
 
-=== gray(the numbers: darkness, alpha) » Shoes::Color ===
-
-暗さのレベルや、任意的にはアルファレベルからグレースケールカラーを作成します。
+二つの色から直線勾配を作ります。それぞれの色に、色を描画するためにRGB arrayか文字列を渡します。
+例えば、`gradient(green, red)`は、`green..red`と同じです。
+また`gradient(green, '#FA3')`のように記述することもできます。
 
 {{{
- black = gray(0.0)
- white = gray(1.0)
+ Shoes.app do
+   oval 100, 100, 100,
+     fill: gradient(green, '#FA3'), angle: 45
+ end
 }}}
 
-=== info(message: a string) » nil ===
+=== gray(the numbers: darkness, alpha) » RGB array ===
 
-Shoesコンソールでユーザへの情報を含むメッセージを記録します。そして、そのデバッグメッセージはプログラムで何が発生したのか見つけることを助けるようにデザインされており、`info`メッセージはプログラムについてユーザに追加の情報を教えます。
+暗さのレベルや、任意的にはアルファレベルからグレースケールカラーを作成します。
 
 {{{
- #!ruby
-
- info("You just ran the info example on Shoes #{Shoes::RELEASE_NAME}.")
+ Shoes.app do
+  nostroke
+  11.times do |i|
+    y = x = 50 + 10 * i
+    r = 200 - 10 * i
+    oval x, y, r, fill: gray(1-i*0.1)
+  end
+ end
 }}}
 
-例えば、Shyファイルをロードすればいつでも、ShoesはコンソールにShyの著者とバージョンの情報を含むメッセージを印字します。
-
-=== rgb(a series of numbers: red, green, blue, alpha) » Shoes::Color ===
+=== rgb(red, green, blue, alpha) » an array of decimal numbers ===
 
 赤、緑、青の構成要素から色を作成します。アルファレベル（透明度を示す）は任意に加えることができます。
 
 整数を渡すときは、0から255までの値を利用してください。
 
 {{{
- blueviolet = rgb(138, 43, 226)
- darkgreen = rgb(0, 100, 0)
+ Shoes.app do
+   blueviolet = rgb(138, 43, 226, 0.5)
+   darkgreen = rgb(0, 100, 0, 0.5)
+   oval 100, 100, 100,
+     fill: [blueviolet, darkgreen].sample(1)
+ end
 }}}
 
 または、0.0から1.0までの10進数を利用してください。
 
 {{{
- blueviolet = rgb(0.54, 0.17, 0.89)
- darkgreen = rgb(0, 0.4, 0)
+ Shoes.app do
+   blueviolet = rgb(0.54, 0.17, 0.89)
+   darkgreen = rgb(0, 0.4, 0)
+   oval 100, 100, 100,
+     fill: [blueviolet, darkgreen].sample(1)
+ end
 }}}
 
-このメソッドは`Shoes.rgb`と呼ばれるかもしれません。
-
-=== warn(message: a string) » nil ===
-
-ユーザのために警告を記録します。警告は壊滅的なエラー（それは[[Built-in.error]]を見てください。）ではありません。これは、プログラムが将来変化したり、プログラムの一部が信頼できなくなるなどの通知です。
-
-警告やエラーを見るためには、`Alt-/`(OS Xの場合は`⌘-/`)によりShoesコンソールを開いてください。
-
 == The App Object ==
 
-アプリケーションはURLでコードを実行する一つのウィンドウです。URLを切り替えるとき、新しいアプリケーションオブジェクトが作成され、スタック、フローや他の要素で満たされます。
+アプリケーションはURLでコードを実行する一つのウィンドウです。URLを切り替えるとき、新しい
+アプリケーションオブジェクトが作成され、スタック、フローや他の要素で満たされます。
 
-アプリケーションはウィンドウ自体です。それは閉じられるか、クリアされるか、新しい要素で満たされるかもしれません。!{:margin_left => 100}man-app.png!
+アプリケーションはウィンドウ自体です。それは閉じられるか、クリアされるか、新しい要素で満たされる
+かもしれません。!{:margin_left => 100}../snapshots/sample46.png!
 
-スロット／ボックスの用語では、アプリケーション自体がフローです。詳しくは''Slots''セクションを見てください、しかし、これはどんな要素も直接フローのトップレベルに置かれることを単に意味します。
+スロット／ボックスの用語では、アプリケーション自体がフローです。詳しくは''Slots''セクションを
+見てください、しかし、これはどんな要素も直接フローのトップレベルに置かれることを単に意味します。
 
 === Shoes.app(styles) { ... } » Shoes::App ===
 
-Shoesのアプリケーションウィンドウを開始します。これはShoesプログラムを作るための出発地点です。ブロックの内部では、ウィンドウを様々なShoesの要素（ボタン、アートワーク、その他）で満たし、そしてブロックの外では、ウィンドウがどれぐらい大きいのかを説明するために`styles`を利用します。おそらくアプリケーションの名前や、それがリサイズ可能かどうかについてもです。
+Green Shoesのアプリケーションウィンドウを開始します。これはGreen Shoesプログラムを作るための
+出発地点です。ブロックの内部では、ウィンドウを様々なGreen Shoesの要素（ボタン、アートワーク、
+その他）で満たし、そしてブロックの外では、ウィンドウがどれぐらい大きいのかを説明するために
+`styles`を利用します。おそらくアプリケーションの名前についてもです。
 
 {{{
  #!ruby
- Shoes.app(:title => "White Circle",
-   :width => 200, :height => 200, :resizable => false) {
-     background black
-     fill white
-     oval :top => 20, :left => 20, :radius => 160
- }
+ Shoes.app title: "White Circle",
+   width: 200, height: 200 do
+   background black
+   fill white
+   oval top: 20, left: 20, radius: 160
+ end
 }}}
 
-上記のケースでは、小さなウィンドウを作成します。200×200ピクセルです。それはリサイズ不可能です。そして、そのウィンドウには黒い背景と白い輪の2つの要素があります。
+上記のケースでは、小さなウィンドウを作成します。200×200ピクセルです。
+そして、そのウィンドウには黒い背景と白い輪の2つの要素があります。
 
-いったんアプリケーションが作成されれば、それは[[App.Shoes.APPS]]の一覧に追加されます。もしあなたがより多くのウィンドウを生成したいなら、[[Element.window]]メソッドや[[Element.dialog]]メソッドを見てください。
+いったんアプリケーションが作成されれば、それは[[App.Shoes.APPS]]の一覧に追加されます。
+もしあなたがより多くのウィンドウを生成したいなら、[[Element.window]]メソッドや
+[[Element.dialog]]メソッドを見てください。
 
 === Shoes.APPS() » An array of Shoes::App objects ===
 
-現在開いているすべてのShoesアプリケーションの完全な一覧を作成します。いったんアプリケーションが閉じられると、その一覧から取り除かれます。そう、Shoesでは一度に多くの実行できます。それはとても元気付けられます。
+現在開いているすべてのGreen Shoesアプリケーションの完全な一覧を作成します。
+いったんアプリケーションが閉じられると、その一覧から取り除かれます。
+そう、Green Shoesでは一度に多くの実行できます。それはとても元気付けられます。
 
 === clipboard() » a string ===
 
-システムのクリップボードのすべてのテキストを含む文字列を返します。これはコンピュータ上のどのプログラムからでもカットアンドペーストできるグローバルクリップボードです。
+システムのクリップボードのすべてのテキストを含む文字列を返します。
+これはコンピュータ上のどのプログラムからでもカットアンドペーストできるグローバルクリップボードです。
 
 === clipboard = a string ===
 
@@ -715,72 +872,112 @@ Shoesのアプリケーションウィンドウを開始します。これはSho
 
 === close() ===
 
-アプリケーションのウィンドウを閉じます。複数のウィンドウを開いていて、すべてのアプリケーションを閉じたいなら、ビルトインメソッドの`exit`を利用してください。
+アプリケーションのウィンドウを閉じます。
+複数のウィンドウを開いていて、すべてのアプリケーションを閉じたいなら、ビルトインメソッドの
+`exit`を利用してください。
+
+{{{
+ Shoes.app do
+  para 'hello'
+  button 'spawn' do
+   Shoes.app do
+    para 'hello'
+    button('close: close this window only'){close}
+    button('exit: quit Green Shoes'){exit}
+   end
+  end
+  button('close: close this window only'){close}
+  button('exit: quit Green Shoes'){exit}
+ end
+}}}
 
 === download(url: a string, styles) ===
 
-ダウンロードのスレッド（あなたがJavaScriptに詳しいのなら、およそXMLHttpRequestのようなものです）を開始します。このメソッドは、すぐに戻り値を返してバックグラウンドでダウンロードを開始します。また、それぞれのダウンロードスレッドが`start`、`progress`や`finish`イベントを開始します。
+ダウンロードのスレッド（あなたがJavaScriptに詳しいのなら、およそXMLHttpRequestのようなものです）
+を開始します。このメソッドは、すぐに戻り値を返してバックグラウンドでダウンロードを開始します。
+また、それぞれのダウンロードスレッドが`start`、`progress`や`finish`イベントを開始します。
 downloadにファイルを送ることや、（`finish`イベントの中で）文字列を取り戻すことができます。
 
 downloadにブロックを付けると、それは`finish`イベントとして呼ばれます。
 
-download
-
 {{{
- #!ruby
  Shoes.app do
    stack do
-     title "Searching Google", :size => 16
+     title "Searching Google", size: 16
      @status = para "One moment..."
-
-     # Search Google for 'shoes' and print the HTTP headers
-     download "http://www.google.com/search?q=shoes" do |goog|
-       @status.text = "Headers: " + goog.response.headers.inspect
+ 
+     download "http://is.gd/bXTVY7" do |goog|
+       @status.text = "Headers: #{goog.meta}"
      end
    end
  end
 }}}
 
-そして、ダウンロードしたデータを利用したいなら`goog.response.body`を利用することにより行います。この例は本当に`download`の最も簡単な形です：いくつかのウェブデータをメモリに取ってきて、それを一度ハンドリングしています。
+この例は本当に`download`の最も簡単な形です：いくつかのウェブデータをメモリにダウンロードして、
+ダウンロードが完了するとそのデータを操作しています。
 
-`download`のもう一つのサンプルはいくつかのウェブデータを、`:save`スタイルを利用してファイルに保存します。
+`download`のもう一つのサンプルはいくつかのウェブデータを、`:save`スタイルを利用してファイルに
+保存します。
 
 {{{
- #!ruby
  Shoes.app do
    stack do
-     title "Downloading Google image", :size => 16
+     title "Downloading Google image", size: 16
      @status = para "One moment..."
-
-     download "http://www.google.com/logos/nasa50th.gif",
+ 
+     download "http://is.gd/GVAGF7",
        :save => "nasa50th.gif" do
-         @status.text = "Okay, is downloaded."
+      @status.text = "Okay, is downloaded."
+      image "nasa50th.gif", top: 100
      end
    end
  end
 }}}
 
-このケースでも、ダウンロードファイルのヘッダを取得することができますが、メモリにそのデータが保存されていないため`response.body`は`nil`になります。ダウンロードしたものを得るためにはそのファイルを開く必要があります。
-
-特定のヘッダかアクションをウェブサーバへ送る必要があるのならば、HTTPリクエストをカスタマイズするために`:method`、`:headers`や`:body`スタイルを利用することができます。（そして、それら以上の変更の必要があるのなら、いつでもRubyのOpenURIクラスを破壊することができます。）
+もしも特定のヘッダかアクションをウェブサーバへ送る必要があるのならば、HTTPリクエストを
+カスタマイズするために`:method`、`:headers`や`:body`スタイルを利用することができます。
+（そして、それら以上のスタイルが必要なら、いつでもRubyのOpenURIクラスを準備することができます。）
 
 {{{
  #!ruby
+ # Not yet available
  Shoes.app do
    stack do
-     title "POSTing to Google", :size => 16
+     title "GET Google", size: 16
      @status = para "One moment..."
+ 
+     download "http://is.gd/bXTVY7", 
+         :method => "GET" do |dump|
+       @status.text = dump.response.body
+     end
+   end
+ end
+}}}
+
+上記の例から、Shoesは、Googleのサーチエンジンへ質問するために"GET"メソッドを
+利用することが分かります。
+
+'''注意:''' Green Shoesは、`:method`, `:headers`, `:body`スタイルをサポートしていません。
 
-     download "http://www.stevex.net/dump.php",
-              :method => "POST", :body => "v=1.0&q=shoes" do |dump|
-       require 'hpricot'
-       @status.text = Hpricot(dump.response.body).inner_text
+{{{
+ include Hpricot
+ Shoes.app do
+   status = para "One moment..."
+   download 'http://is.gd/BatiRt' do |dl|
+     samples = []
+     Hpricot(dl).inner_text.each_line do |line|
+       samples.push($1) if line =~ /(sample.*\.rb)/
      end
+     status.text = samples.join(', ')
+     flush
    end
  end
 }}}
 
-上記の例から、ShoesはHTMLを解析するHpricotなライブラリを含んでいることが分かります。
+上記の例から、Green ShoesはHTML解析のためにHpricotライブラリを組み込んでいることが
+わかります。
+
+'''注意:''' 今のところWindowsプラットフォームのみです。
 
 === location() » a string ===
 
@@ -803,57 +1000,82 @@ download
 
 === owner() » Shoes::App ===
 
-このアプリケーションを開始したアプリケーションを取得します。多くの場合、これは`nil`でしょう。しかし[[Element.window]]メソッドを利用してアプリケーションが開始されたなら、その所有者は`window`と呼ばれるアプリケーションでしょう。
+このアプリケーションを開始したアプリケーションを取得します。多くの場合、これは`nil`でしょう。
+しかし[[Element.window]]メソッドを利用してアプリケーションが開始されたなら、
+その所有者は`window`と呼ばれるアプリケーションでしょう。
 
 === started?() » true or false ===
 
-ウィンドウはすべて構築され、表示されましたか？これは完全に構築される前に、ウィンドウを利用しようとするスレッド化されたコードのために役に立ちます。
+ウィンドウはすべて構築され、表示されましたか？これは完全に構築される前に、
+ウィンドウを利用しようとするスレッド化されたコードのために役に立ちます。
 （また、ウィンドウが開くときに実行される`start`イベントも見てください。）
 
+''注意:''' 今のところGreen Shoesではstarted?メソッドをサポートしていません。
+
 === visit(url: a string) ===
 
 異なるShoesのURLを見るために、ロケーションを変更します。
 
-（http://google.comのような）絶対パスのURLは悪くないですが、ShoesはShoesアプリケーションがそのアドレスに存在することを期待するでしょう。（そのため、google.comはHTMLアプリケーションとしては動作しません。）
+（http://google.comのような）絶対パスのURLは悪くないですが、Green ShoesはGreen Shoes
+アプリケーションがそのアドレスに存在することを期待するでしょう。
+（そのため、google.comはHTMLアプリケーションとしては動作しません。）
 
 == The Styles Master List ==
 
-外観を変更したいですか？Shoesにおいてはスタイルが要素の表示方法を変更するために利用されます。場合によっては、要素のすべてのクラスのスタイルでさえ設定できます。（すべての段落に特定のフォントを与えるように）
+外観を変更したいですか？
+Green Shoesにおいてはスタイルが要素の表示方法を変更するために利用されます。
+場合によっては、要素のすべてのクラスのスタイルでさえ設定できます。
+（すべての段落に特定のフォントを与えるように）
 
 スタイルは簡単にspotできます。通常は要素が生成されるときに現れます。
 
 {{{
- Shoes.app :title => "A Styling Sample" do
-   para "Red with an underline", :stroke => red, :underline => "single"
+ Shoes.app title: "A Styling Sample" do
+   para 'Green Shoes', align: 'center', size: 50
  end
 }}}
 
-このappには`:title`スタイルが設定されています。そしてこのappの内部の段落には、赤い`:stroke`スタイルと`:underline`スタイルが設定されます。
+このappには`:title`スタイルが設定されています。そしてこのappの内部の段落には、
+中央揃えの`:align`スタイルとフォントサイズ50の`:size`スタイルが設定されます。
 
 このスタイルのハッシュは、どんな要素やスロットも利用できる[[Common.style]]メソッドを利用して変更できます。
 
+'''注意:''' 今のところGreen Shoesでは、styleメソッドで変更できる要素は形状のみです。
+
 {{{
- Shoes.app :title => "A Styling Sample" do
-   @text = para "Red with an underline"
-   @text.style(:stroke => red, :underline => "single")
+ Shoes.app title: "A Styling Sample" do
+   choose = 
+     lambda{[red, blue, green, yellow].sample}
+   s = star 100, 50, 30, 200, 180, strokewidth: 5
+   button 'change colors' do
+     s.style stroke: choose.call, fill: choose.call
+   end
  end
 }}}
 
-多くのスタイルもメソッドとして呼び出すことで設定することができます。（メソッドを見つけるために手動での検索を行うでしょう。）
+多くのスタイルもメソッドとして呼び出すことで設定することができます。
+（メソッドを見つけるために手動での検索を行うでしょう。）
+
+'''注意:''' Green Shoesではメソッドとしてはそれらをサポートしていません。
 
 {{{
- Shoes.app :title => "A Styling Sample" do
-   @text = para "Red with an underline"
-   @text.stroke = red
-   @text.underline = "single"
+ # Not yet available
+ Shoes.app title: "A Styling Sample" do
+   choose = 
+     lambda{[red, blue, green, yellow].sample}
+   s = star 100, 50, 30, 200, 180, strokewidth: 5
+   button 'change colors' do
+     s.stroke = choose.call; s.fill = choose.call
+   end
  end
 }}}
 
-どんなスタイルでも分かるようにすべてのマニュアルを苦労して読ませるよりも、この役に立つページはShoesのあらゆるスタイルを急いで駆け抜けて、どこでスタイルが利用されるかについて示唆します。
+どんなスタイルでも分かるようにすべてのマニュアルを苦労して読ませるよりも、この役に立つページは
+Green Shoesのあらゆるスタイルを急いで駆け抜けて、どこでスタイルが利用されるかについて示唆します。
 
 === :align » a string ===
 
-''banner, caption, code, del, em, ins, inscription, link, para, span, strong, sub, sup, subtitle, tagline, title''で利用できます。
+''banner, caption, inscription, para, subtitle, tagline, title''で利用できます。
 
 テキストの整列です。これは次のどれかです：
 
@@ -863,54 +1085,88 @@ download
 
 === :angle » a number ===
 
-''background, border, gradient''で利用できます。
+''background, border, line, oval, rect, shape, star''で利用できます。
 
-グラデーションに摘要する角度です。通常はグラデーションの色の効果は上から下です。`:angle`を90に設定するなら反時計回りに90度回転し、グラデーションは左から右になるでしょう。
+グラデーションに適用する角度です。通常はグラデーションの色の効果は上から下です。
+`:angle`を90に設定するなら反時計回りに90度回転し、グラデーションは左から右になるでしょう。
 
 === :attach » a slot or element ===
 
 ''flow, stack''で利用できます。
 
-他のスロットや要素と比較してスロットをピンで止めます。ウィンドウの左上の角からスロットを配置するために`:attach => Window`と書く人もいるかもしれません。
-これについてもう少し取り上げると、`:top => 10, :left => 10, :attach => Window`のスタイルはスロットをウインドウの座標の(10, 10)に配置します。
+他のスロットや要素と比較してスロットをピンで止めます。ウィンドウの左上の角からスロットを配置する
+ために`:attach => Window`と書く人もいるかもしれません。
+これについてもう少し取り上げると、`:top => 10, :left => 10, :attach => Window`のスタイルは
+スロットをウインドウの座標の(10, 10)に配置します。
+
+動く要素にスロットがアタッチされた場合は、そのスロットはそれとともに動きます。
+アタッチメントが`nil`にリセットされるなら、通常はそのスロットはそれを取り囲む他のオブジェクトとともに流れます。
 
-動く要素にスロットがアタッチされた場合は、そのスロットはそれとともに動きます。アタッチメントが`nil`にリセットされるなら、通常はそのスロットはそれを取り囲む他のオブジェクトとともに流れます。
+'''注意:''' Green Shoesは`:attach`スタイルをサポートしていません。
 
 === :autoplay » true or false ===
 
 ''video''で利用できます。
 
-ビデオは現れた後で再生を開始すべきですか？`true`を設定すると、ビデオはユーザに尋ねること無く開始するでしょう。
+ビデオは現れた後で再生を開始すべきですか？`true`を設定すると、ビデオはユーザに尋ねること無く
+開始するでしょう。
+
+'''注意:''' Green Shoesは`:autoplay`スタイルをサポートしていません。
+
+=== :back » true or false ===
+
+''shapes, image, textblocks''で利用できます。
+
+他の要素の後ろに配置されます。
+
+{{{
+ Shoes.app do
+   rect 100, 100, 100, 100, fill: green
+   rect 120, 120, 100, 100, fill: yellow
+   para 'hello', left: 150, top: 150, front: true
+   oval 150, 150, 100, 100, fill: red
+   oval 180, 180, 100, 100, fill: gray, back: true
+ end
+}}}
 
 === :bottom » a number ===
 
 ''すべてのスロットと要素''で利用できます。
 
-要素の下の端の座標にピクセルを設定します。その端はコンテナの下の端に対して配置されます。そのため、`:bottom => 0`は、スロットの下の端とその下の端が接するように要素を配置するでしょう。
+要素の下の端の座標にピクセルを設定します。その端はコンテナの下の端に対して配置されます。
+そのため、`:bottom => 0`は、スロットの下の端とその下の端が接するように要素を配置するでしょう。
+
+'''注意:''' Green Shoesは`:bottom`スタイルをサポートしていません。
 
 === :cap » :curve or :rect or :project ===
 
-''arc, arrow, border, flow, image, mask, rect, star, shape, stack''で利用できます。
+''arc, line, shape''で利用できます。
 
-線の終点の形状を曲がったもの（curved）か角張ったもの（square）に設定します。追加の説明は[[Art.cap]]メソッドを見てください。
+線の終点の形状を曲がったもの（curved）か角張ったもの（square）に設定します。
+追加の説明は[[Art.cap]]メソッドを見てください。
 
 === :center » true or false ===
 
 ''arc, image, oval, rect, shape''で利用できます。
 
-`:top`と`:left`の座標が形状の中心を意味するかどうか示します。`true`を設定すると、[[Art.transform]]メソッドに`:center`を設定したのと似ています。
+`:top`と`:left`の座標が形状の中心を意味するかどうか示します。
+`true`を設定すると、[[Art.transform]]メソッドに`:center`を設定したのと似ています。
+
+'''注意:''' Green Shoesは`:center`スタイルをサポートしていません。
 
 === :change » a proc ===
 
 ''edit_box, edit_line, list_box''で利用できます。
 
-`change`イベントハンドラはスタイルに保存されます。例として、edit_boxの[[EditBox.change]]メソッドを見てください。
+`change`イベントハンドラはスタイルに保存されます。例として、edit_boxの
+[[EditBox.change]]メソッドを見てください。
 
 === :checked » true or false ===
 
 ''check, radio''で利用できます。
 
-チェックボックスまたはラジオボタンがクリックされましたか？`true`が設定されるなら、そのボックスはチェックされます。[[Check.checked=]]メソッドも見てください。
+チェックボックスまたはラジオボタンがクリックされましたか？
+`true`が設定されるなら、そのボックスはチェックされます。[[Check.checked=]]メソッドも見てください。
 
 === :choose » a string ===
 
@@ -920,7 +1176,7 @@ download
 
 === :click » a proc ===
 
-''arc, arrow, banner, button, caption, check, flow, image, inscription, line, link, mask, oval, para, radio, rect, shape, stack, star, subtitle, tagline, title''で利用できます。
+''arc, arrow, button, check, flow, image, line, link, oval, radio, rect, shape, stack, star''で利用できます。
 
 `click`イベントハンドラはスタイルに保存されます。解説は[[Events.click]]メソッドを見てください。
 
@@ -928,23 +1184,35 @@ download
 
 ''background, border, rect''で利用できます。
 
-長方形の要素のそれぞれの曲がった角の半径です。例として、6を設定した場合、長方形の角は6ピクセルの半径のカーブを与えられます。
+長方形の要素のそれぞれの曲がった角の半径です。例として、6を設定した場合、長方形の角は
+6ピクセルの半径のカーブを与えられます。
 
 === :displace_left » a number ===
 
 ''すべてのスロットと要素''で利用できます。
 
-形状、テキストブロックまたはその他のどんな種類のオブジェクトでも左か右に置き換えます。正数は与えられた数のピクセルによって右へ置き換え、負数は左へ置き換えます。オブジェクトを置き換えることはページの実際のレイアウトに影響を与えません。この振る舞いに少し驚くかもしれないので、このスタイルを利用する前に、[[Position.displace]]のドキュメントを読むようにしてください。
+形状、テキストブロックまたはその他のどんな種類のオブジェクトでも左か右に置き換えます。
+正数は与えられた数のピクセルによって右へ置き換え、負数は左へ置き換えます。
+オブジェクトを置き換えることはページの実際のレイアウトに影響を与えません。
+この振る舞いに少し驚くかもしれないので、このスタイルを利用する前に、[[Position.displace]]の
+ドキュメントを読むようにしてください。
+
+'''注意:''' Green Shoesは`:displace_left`スタイルをサポートしていません。
 
 === :displace_top » a number ===
 
 ''すべてのスロットと要素''で利用できます。
 
-形状、テキストブロックまたはその他のどんな種類のオブジェクトでも上か下に置き換えます。正数は与えられた数のピクセルによって下へ置き換え、負数は上へ置き換えます。オブジェクトを置き換えることはページの実際のレイアウトやオブジェクトの本当の座標に影響を与えません。この振る舞いに少し驚くかもしれないので、[[Position.displace]]のドキュメントを読んでください。
+形状、テキストブロックまたはその他のどんな種類のオブジェクトでも上か下に置き換えます。
+正数は与えられた数のピクセルによって下へ置き換え、負数は上へ置き換えます。
+オブジェクトを置き換えることはページの実際のレイアウトやオブジェクトの本当の座標に影響を与えません。
+この振る舞いに少し驚くかもしれないので、[[Position.displace]]のドキュメントを読んでください。
+
+'''注意:''' Green Shoesは`:displace_top`スタイルをサポートしていません。
 
 === :emphasis » a string ===
 
-''banner, caption, code, del, em, ins, inscription, link, para, span, strong, sub, sup, subtitle, tagline, title''で利用できます。
+''banner, caption, inscription, para, span, subtitle, tagline, title''で利用できます。
 
 強調によってテキストを整えます。（一般的にはイタリック体にされます。）
 
@@ -956,27 +1224,45 @@ download
 
 === :family » a string ===
 
-''banner, caption, code, del, em, ins, inscription, link, para, span, strong, sub, sup, subtitle, tagline, title''で利用できます。
+''banner, caption, inscription, para, span, subtitle, tagline, title''で利用できます。
 
-与えられたフォントファミリーでテキストを整えます。文字列はフォントファミリー名かカンマで区切られたフォントファミリーの一覧を含むべきです。
+与えられたフォントファミリーでテキストを整えます。文字列はフォントファミリー名かカンマで区切られた
+フォントファミリーの一覧を含むべきです。
 
-=== :fill » a hex code, a Shoes::Color or a range of either ===
+=== :fill » a hex code, a RGB array or a range of either ===
 
-''arc, arrow, background, banner, caption, code, del, em, flow, image, ins, inscription, line, link, mask, oval, para, rect, shape, span, stack, star, strong, sub, sup, subtitle, tagline, title''で利用できます。
+''background, banner, border, caption, inscription, para, line, oval, 
+rect, shape, star, subtitle, tagline, title''で利用できます。
 
-背景のペンの色です。形状では、これは形状の内側を塗りつぶすペンキの色です。テキストなどでは、この色で背景が塗られます。（まるで蛍光ペンでマークされたように）
+背景のペンの色です。形状では、これは形状の内側を塗りつぶすペンキの色です。
+テキストなどでは、この色で背景が塗られます。（まるで蛍光ペンでマークされたように）
 
 === :font » a string ===
 
-''banner, caption, code, del, em, ins, inscription, link, para, span, strong, sub, sup, subtitle, tagline, title''で利用できます。
+''banner, caption, inscription, para, subtitle, tagline, title''で利用できます。
+
+フォントの種類でテキストを整えます。この文字列は非常に柔軟ですが、
+"[FAMILY-LIST] [STYLE-OPTIONS] [SIZE]"の形である必要があり、
+FAMILY-LISTの部分は任意にカンマで終わりカンマで区切られたフォントファミリーの一覧、
+STYLE_OPTIONSはvariant、weight、stretch、またはgravityなどの空白で区切られた
+スタイルを表現する単語の一覧、そしてSIZEは（ポイントのサイズの）10進数または絶対的な
+サイズのために単位修飾子"px"を任意に続けます。オプションのどれかは設定されないかもしれません。
+FAMILY-LISTが設定されない場合は、デフォルトフォントファミリー（Arial）が利用されます。
+
+=== :front » true or false ===
 
-フォントの種類でテキストを整えます。この文字列は非常に柔軟ですが、"[FAMILY-LIST] [STYLE-OPTIONS] [SIZE]"の形である必要があり、FAMILY-LISTの部分は任意にカンマで終わりカンマで区切られたフォントファミリーの一覧、STYLE_OPTIONSはvariant、weight、stretch、またはgravityなどの空白で区切られたスタイルを表現する単語の一覧、そしてSIZEは（ポイントのサイズの）10進数または絶対的なサイズのために単位修飾子"px"を任意に続けます。オプションのどれかは設定されないかもしれません。FAMILY-LISTが設定されない場合は、デフォルトフォントファミリー（Arial）が利用されます。
+''shapes, image, textblocks''で利用できます。
+
+他の要素の前に配置されます。
 
 === :group » a string ===
 
 ''radio''で利用できます。
 
-どのグループにラジオボタンが所属するかを示します。この設定がない場合は、ラジオボタンは周辺のスロットのラジオボタンとグループ化されます。ラジオボタンを"グループ化"することはスクリーン上でお互いに隣接してグループ化されることを意味するのではありません。それは、一度にグループから一つだけのラジオボタンだけを選択できることを意味します。
+どのグループにラジオボタンが所属するかを示します。この設定がない場合は、ラジオボタンは
+周辺のスロットのラジオボタンとグループ化されます。ラジオボタンを"グループ化"することはスクリーン上で
+お互いに隣接してグループ化されることを意味するのではありません。
+それは、一度にグループから一つだけのラジオボタンだけを選択できることを意味します。
 
 文字列にスタイルを与えることによって、ラジオボタンは同じグループ名を持つ他のラジオボタンとグループ化されます。
 
@@ -984,19 +1270,38 @@ download
 
 ''すべてのスロットと要素''で利用できます。
 
-オブジェクトの高さをピクセルで設定します。数値が10進数なら、その高さは親の高さのパーセンテージになります。（0.0は0%に、1.0は100%になります。）
+オブジェクトの高さをピクセルで設定します。数値が10進数なら、その高さは親の高さの
+パーセンテージになります。（0.0は0%に、1.0は100%になります。）
 
 === :hidden » true or false ===
 
 ''すべてのスロットと要素''で利用できます。
 
-オブジェクトの表示または非表示です。すべてのオブジェクトにとって`:hidden => true`は画面上での非表示になります。その子供のスロットと要素でも同様です。
+オブジェクトの表示または非表示です。すべてのオブジェクトにとって`:hidden => true`は
+画面上での非表示になります。その子供のスロットと要素でも同様です。
+
+{{{
+ Shoes.app do
+   slot = stack hidden: true do
+     title 'hello'
+     flow do
+       image File.join DIR, '../samples/loogink.png'
+     end
+     para link('Go go!'){alert 'hi'}
+   end
+   timer(2){slot.show}
+   timer(5){slot.hide}
+ end
+}}}
+
+'''注意:''' 今のところGreen Shoesで`:hidden`スタイルをサポートしている要素は、
+slots, shapes, textblocks, imagesのみです。
 
 === :inner » a number ===
 
 ''star''で利用できます。
 
-内側の半径のサイズ（ピクセル）です。その内側の半径は点が別れ始める星の中に中空でない円を描きます
+内側の半径のサイズ（ピクセル）です。その内側の半径は点が別れ始める星の中に中空でない円を描きます。
 
 === :items » an array ===
 
@@ -1006,16 +1311,19 @@ download
 
 === :justify » true or false ===
 
-''banner, caption, code, del, em, ins, inscription, link, para, span, strong, sub, sup, subtitle, tagline, title''で利用できます。
+''banner, caption, inscription, para, subtitle, tagline, title''で利用できます。
 
 均一に水平にテキストの間隔を開けます。
 
 === :kerning » a number ===
 
-''banner, caption, code, del, em, ins, inscription, link, para, span, strong, sub, sup, subtitle, tagline, title''で利用できます。
+''banner, caption, code, del, em, ins, inscription, link, para, span,
+strong, sub, sup, subtitle, tagline, title''で利用できます。
 
 文字の間に自然な空白をピクセルで追加します。
 
+'''注意:''' Green Shoesは`:kerning`スタイルをサポートしていません。
+
 === :leading » a number ===
 
 ''banner, caption, inscription, para, subtitle, tagline, title''で利用できます。
@@ -1026,13 +1334,20 @@ download
 
 ''すべてのスロットと要素''で利用できます。
 
-オブジェクトの左の座標を特定のピクセルに設定します。`:left => 10`の設定はそのオブジェクトを含むスロットの左の端からオブジェクトの左の端が10ピクセル離れた位置に配置します。このleftのスタイルが設定されていない（または`nil`が設定される）なら、そのオブジェクトはそれを囲んでいる他のオブジェクトとともに動くでしょう。
+オブジェクトの左の座標を特定のピクセルに設定します。
+`:left => 10`の設定はそのオブジェクトを含むスロットの左の端からオブジェクトの左の端が10ピクセル
+離れた位置に配置します。このleftのスタイルが設定されていない（または`nil`が設定される）なら、
+そのオブジェクトはそれを囲んでいる他のオブジェクトとともに動くでしょう。
 
 === :margin » a number or an array of four numbers ===
 
 ''すべてのスロットと要素''で利用できます。
 
-マージンは要素の周囲に間隔をあけます。それぞれの要素はleft、top、right、そしてbottomのマージンを持っています。`:margin`スタイルに一つの数が設定されると、要素の周囲の間隔は均一にその数にとなります。言い換えると、`:margin => 8`を設定すると、その要素の周囲のすべてのマージンは8ピクセルの長さに設定されます。
+マージンは要素の周囲に間隔をあけます。
+それぞれの要素はleft、top、right、そしてbottomのマージンを持っています。
+`:margin`スタイルに一つの数が設定されると、要素の周囲の間隔は均一にその数にとなります。
+言い換えると、`:margin => 8`を設定すると、その要素の周囲のすべてのマージンは8ピクセルの
+長さに設定されます。
 
 このスタイルは4つの数を`[left, top, right, bottom]`の形の配列で与えることもできます。
 
@@ -1074,39 +1389,69 @@ download
 
 === :radius » a number ===
 
-''arc, arrow, background, border, gradient, oval, rect, shape''で利用できます。
+''oval''で利用できます。
 
-それらの要素に半径（直径または全幅の半分）を設定します。これを設定することは、この数値の2倍の`:width`と`:height`を設定することと同等です。
+それらの要素に半径（直径または全幅の半分）を設定します。
+これを設定することは、この数値の2倍の`:width`と`:height`を設定することと同等です。
 
 === :right » a number ===
 
 ''すべてのスロットと要素''で利用できます。
 
-要素の右端の座標をピクセルで設定します。その端はコンテナの右端に対して配置されます。そのため、`:right => 0`は、スロットの右端とその右端が接するように要素を配置するでしょう。一方`:right => 20`は要素の右端をそのスロットの右端から左側に向けて20ピクセル離れたところに配置します。
+要素の右端の座標をピクセルで設定します。その端はコンテナの右端に対して配置されます。
+そのため、`:right => 0`は、スロットの右端とその右端が接するように要素を配置するでしょう。
+一方`:right => 20`は要素の右端をそのスロットの右端から左側に向けて20ピクセル
+離れたところに配置します。
+
+'''注意:''' Green Shoesは`:right`スタイルをサポートしていません。
 
 === :rise » a number ===
 
-''banner, caption, code, del, em, ins, inscription, link, para, span, strong, sub, sup, subtitle, tagline, title''で利用できます。
+''banner, caption, inscription, para, span, subtitle, tagline, title''で利用できます。
 
-テキストのフォントを基準から上げたり下げたりします。例えば、[[Element.sup]]は10ピクセルの`:rise`を行います。逆に、[[Element.sub]]の要素は-10ピクセルの`:rise`となります。
+テキストのフォントを基準から上げたり下げたりします。
+例えば、[[Element.sup]]は10ピクセルの`:rise`を行います。
+逆に、[[Element.sub]]の要素は-10ピクセルの`:rise`となります。
 
 === :scroll » true or false ===
 
 ''flow, stack''で利用できます。
 
-スロットをスクロールするスロットとします。`:scroll => true`が設定され、そのコンテンツがスロットの高さ以上の場合はスクロールバーがスロットに表示されます。スクロールバーは必要に応じて表示したり非表示になります。それはスロットの幅の内側で表示されるので、スクロールバーのあるなしに関わらず、スロットの幅は決して変わらないことを意味します。
+スロットをスクロールするスロットとします。
+`:scroll => true`が設定され、そのコンテンツがスロットの高さ以上の場合はスクロールバーが
+スロットに表示されます。スクロールバーは必要に応じて表示したり非表示になります。
+それはスロットの幅の内側で表示されるので、スクロールバーのあるなしに関わらず、スロットの幅は
+決して変わらないことを意味します。
+
+'''注意:''' Green Shoesでは制約があります。今のところ`:scroll`スタイルはお試し版です。
+
+ * スロットのインスタンスメソッド(clear, hide, etc.)が期待通り動きません。
+ * マウスイベントをハンドリングできません。
+ * `flush`メソッドを明示的に記述する必要があります。
+
+{{{
+ Shoes.app do
+   s = stack left: 100, top: 50, width: 300, 
+     height: 100, scroll: true do
+     background gold
+     image './loogink.png'
+     10.times{para 'hello'}
+     flush
+   end
+ end
+}}}
 
 === :secret » true or false ===
 
 ''ask, edit_line''で利用できます。
 
-Used for password fields, this setting keeps any characters typed in from becoming visible on the screen.  Instead, a replacement character (such as an asterisk) is show for each letter typed.
-
-パスワードフィールドのために利用され、この設定は入力された文字を画面上で表示されないようにします。そのかわり、置き換えられた文字（たとえばアスタリスク）をそれぞれの文字が入力されるごとに表示します。
+パスワードフィールドのために利用され、この設定は入力された文字を画面上で表示されない
+ようにします。そのかわり、置き換えられた文字（たとえばアスタリスク）をそれぞれの文字が
+入力されるごとに表示します。
 
 === :size » a number ===
 
-''banner, caption, code, del, em, ins, inscription, link, para, span, strong, sub, sup, subtitle, tagline, title''で利用できます。
+''banner, caption, inscription, para, span, subtitle, tagline, title''で利用できます。
 
 このテキストブロックまたはテキストの一部の内部で利用されたフォントのサイズをピクセルで設定します。
 
@@ -1134,7 +1479,8 @@ Used for password fields, this setting keeps any characters typed in from becomi
 
 === :stretch » a string ===
 
-''banner, caption, code, del, em, ins, inscription, link, para, span, strong, sub, sup, subtitle, tagline, title''で利用できます。
+''banner, caption, code, del, em, ins, inscription, link, para, span,
+strong, sub, sup, subtitle, tagline, title''で利用できます。
 
 テキストオブジェクトに伸縮したフォントを設定します。
 
@@ -1143,55 +1489,63 @@ Used for password fields, this setting keeps any characters typed in from becomi
  * "condensed" - 狭い幅の文字
  * "normal" - 標準の幅の文字
  * "expanded" - 広い幅の文字
+ 
+ '''注意:''' Green Shoesは`:stretch`スタイルをサポートしていません。
 
-=== :strikecolor » a Shoes::Color ===
+=== :strikecolor » a RGB array ===
 
-''banner, caption, code, del, em, ins, inscription, link, para, span, strong, sub, sup, subtitle, tagline, title''で利用できます。
+''banner, caption, inscription, para, span, subtitle, tagline, title''で利用できます。
 
 テキストに棒線を引いて削除するときの線の色です。
 
 === :strikethrough » a string ===
 
-''banner, caption, code, del, em, ins, inscription, link, para, span, strong, sub, sup, subtitle, tagline, title''で利用できます。
+''banner, caption, inscription, para, span, subtitle, tagline, title''で利用できます。
 
 このテキストに棒線を引いて削除しますか？2つのオプションがあります：
 
  * "none" - 棒線を引いて削除しません。
  * "single" - 1本の棒線を引いて削除します。
 
-=== :stroke » a hex code, a Shoes::Color or a range of either ===
+=== :stroke » a hex code, a rgb array or a range of either ===
 
-''arc, arrow, banner, border, caption, code, del, em, flow, image, ins, inscription, line, link, mask, oval, para, rect, shape, span, stack, star, strong, sub, sup, subtitle, tagline, title''で利用できます。
+''background, banner, border, caption, inscription, para, line, oval, 
+rect, shape, star, subtitle, tagline, title''で利用できます。
 
-フォアグラウンドのペンの色です。形状の場合は描かれる線の色です。段落や他のテキストでは、この色で文字が表示されます。
+フォアグラウンドのペンの色です。形状の場合は描かれる線の色です。
+段落や他のテキストでは、この色で文字が表示されます。
 
 === :strokewidth » a number ===
 
-''arc, arrow, border, flow, image, line, mask, oval, rect, shape, star, stack''で利用できます。
+''background, border, line, oval, rect, shape, star''で利用できます。
 
-描かれる線のピクセルでの太さで、形状の線を特徴付けます。例えば、数値の2が設定されればstrokewidthは2ピクセルになります。
+描かれる線のピクセルでの太さで、形状の線を特徴付けます。
+例えば、数値の2が設定されればstrokewidthは2ピクセルになります。
 
 === :text » a string ===
 
-''button, edit_box, edit_line''で利用できます。
+''edit_box, edit_line''で利用できます。
 
-edit_boxやedit_lineのコンテンツ、またはボタンコントロールに表示されるメッセージを設定します。
+edit_boxやedit_lineのコンテンツに表示されるメッセージを設定します。
 
 === :top » a number ===
 
 ''すべてのスロットと要素''で利用できます。
 
-オブジェクトの上側の座標を、その親のスロットに対して設定します。オブジェクトに`:top => 40`が設定されたなら、オブジェクトの上端はそのオブジェクトを含むスロットの上端から40ピクセル下に配置されることを意味します。`:top`スタイルが与えられないなら、そのスロットの自然な流れでオブジェクトは自動的に配置されます。
+オブジェクトの上側の座標を、その親のスロットに対して設定します。
+オブジェクトに`:top => 40`が設定されたなら、オブジェクトの上端はそのオブジェクトを含む
+スロットの上端から40ピクセル下に配置されることを意味します。`:top`スタイルが与えられないなら、
+そのスロットの自然な流れでオブジェクトは自動的に配置されます。
 
-=== :undercolor » a Shoes::Color ===
+=== :undercolor » a RGB array ===
 
-''banner, caption, code, del, em, ins, inscription, link, para, span, strong, sub, sup, subtitle, tagline, title''で利用できます。
+''banner, caption, inscription, para, span, subtitle, tagline, title''で利用できます。
 
 テキストの下線に利用される色です。
 
 === :underline » a string ===
 
-''banner, caption, code, del, em, ins, inscription, link, para, span, strong, sub, sup, subtitle, tagline, title''で利用できます。
+''banner, caption, inscription, para, span, subtitle, tagline, title''で利用できます。
 
 テキストに下線のスタイルを指示します。
 
@@ -1205,18 +1559,20 @@ edit_boxやedit_lineのコンテンツ、またはボタンコントロールに
 
 === :variant » a string ===
 
-''banner, caption, code, del, em, ins, inscription, link, para, span, strong, sub, sup, subtitle, tagline, title''で利用できます。
+''banner, caption, code, del, em, ins, inscription, link, para, span,
+strong, sub, sup, subtitle, tagline, title''で利用できます。
 
 テキストのグループのためにフォントを変化させます。2つの選択肢：
 
  * "normal" - 通常のフォント。
  * "smallcaps" - 大文字が小さく変化することによって置き換えられた小文字のフォント。
 
+'''注意:''' Green Shoesは`:variant`スタイルをサポートしていません。
+
 === :weight » a string ===
 
-''banner, caption, code, del, em, ins, inscription, link, para, span, strong, sub, sup, subtitle, tagline, title''で利用できます。
+''banner, caption, inscription, para, span, subtitle, tagline, title''で利用できます。
 
-Set the boldness of the text.  Commonly, this style is set to one of the following strings:
 テキストを太文字に設定します。一般的には、このスタイルは次の文字列の内の1つを設定します：
 
  * "ultralight" - 超軽量の太さ (= 200)
@@ -1233,123 +1589,222 @@ Set the boldness of the text.  Commonly, this style is set to one of the followi
 
 ''すべてのスロットと要素''で利用できます。
 
-要素の幅をピクセルで設定します。数値が10進数なら、その幅はパーセンテージに変換されます。（0.0は0%に、1.0は100%になります。）100%の幅は親のスロットを埋め尽くすことを意味します。
+要素の幅をピクセルで設定します。数値が10進数なら、その幅はパーセンテージに変換されます。
+（0.0は0%に、1.0は100%になります。）100%の幅は親のスロットを埋め尽くすことを意味します。
+
+=== :wrap » a number ===
+
+''banner, caption, inscription, para, span, subtitle, tagline, title''で利用できます。
+
+どこで改行するか? 選択可能のオプションは以下の通りです。
+
+ * "word" - 単語の区切りで改行します。
+ * "char" - 文字の区切りで改行します。そのため単語が分割される場合があります。
+ * "trim" - はみ出した部分は省略します。
 
 == Classes List ==
 
-Shoesで紹介するすべてのクラスの完全な一覧です。この表はどのようにしてクラスがお互いに継承しているかに従ってレイアウトされています。サブクラスは親クラスの下に、1レベル右にインデントされています。
+Green Shoesで紹介するすべてのクラスの完全な一覧です。
 
-{INDEX}
+こちら([[http://rdoc.info/github/ashbb/green_shoes/master/frames/file/README.md Green Shoes RDoc]])
+を参照下さい。
 
 == Colors List ==
 
-以下はShoes全体で利用可能な色の一覧です。背景色または枠線の色として。描かれる線や塗りつぶされる色として。これらの色の大部分はX11やHTMLのパレットから来ています。
+以下はGreen Shoes全体で利用可能な色の一覧です。背景色または枠線の色として。
+描かれる線や塗りつぶされる色として。これらの色の大部分はX11やHTMLのパレットから来ています。
 
-これらの色はすべて名前によって利用できます。（そのため、どんなスロットの内部からでも`tomato`メソッドを呼ぶことで、すてきな赤みがかった色が手に入るでしょう。）それぞれの色の下には、[[Built-in.rgb]]メソッドで利用できる正確な数値を見つけることもできます。
+これらの色はすべて名前によって利用できます。（そのため、どんなスロットの内部からでも
+`tomato`メソッドを呼ぶことで、すてきな赤みがかった色が手に入るでしょう。）
+それぞれの色の下には、[[Built-in.rgb]]メソッドで利用できる正確な数値を見つけることもできます。
 
 {COLORS}
 
 = Slots =
 
-スロットは画像やテキストなどのレイアウトに使われる箱です。2つの最も一般的なスロットは`スタック（stack）`と`フロー（flow）`です。スロットはShoesの専門用語で"箱"または"キャンバス"とも言えます
+スロットは画像やテキストなどのレイアウトに使われる箱です。2つの最も一般的なスロットは
+`スタック（stack）`と`フロー（flow）`です。スロットはGreen Shoesの専門用語で"箱"または
+"キャンバス"とも言えます
 
-マウスホイールやページアップやページダウンはあらゆるプラットフォームで普及しているため、縦のスクロールだけが溢れて問題になりました。そのためShoesでは、まさにWEBのように通常は幅が固定です。一方で高さは際限なく続いて行きます。
+マウスホイールやページアップやページダウンはあらゆるプラットフォームで普及しているため、
+縦のスクロールだけが溢れて問題になりました。そのためGreen Shoesでは、まさにWEBのように
+通常は幅が固定です。一方で高さは際限なく続いて行きます。
 
-さて、そうしたいなら、どんなものでも幅や高さを指定することもできます。それはいくらかの数学を用いるでしょうが、完璧かもしれません。
+さて、そうしたいなら、どんなものでも幅や高さを指定することもできます。それはいくらかの数学を
+用いるでしょうが、完璧かもしれません。
 
-一般的には、スタックとフローを使うことを提案するでしょう。ここでの目的は、あなたがいくらかの幅を何かで満たして、幅を満たしながら、ページの下に進みたいということです。これらを、HTMLの"ブロック"と"インライン"のスタイルと類似しているのように考えることができます。
+一般的には、スタックとフローを使うことを提案するでしょう。ここでの目的は、あなたがいくらかの
+幅を何かで満たして、幅を満たしながら、ページの下に進みたいということです。
+これらを、HTMLの"ブロック"と"インライン"のスタイルと類似しているのように考えることができます。
 
 ==== Stacks ====
 
-スタックは単純に要素の垂直なスタックです。スタック内のそれぞれの要素は、その上位の要素の直下に配置されます。
+スタックは単純に要素の垂直なスタックです。スタック内のそれぞれの要素は、その上位の要素の
+直下に配置されます。
 
-また、スタックは箱のように形作られます。そのため、スタックが250の幅を与えられたら、そのスタックはそれ自身が250ピクセルの幅の要素となります。
+また、スタックは箱のように形作られます。そのため、スタックが250の幅を与えられたら、
+そのスタックはそれ自身が250ピクセルの幅の要素となります。
 
-新しいスタックを作成するには[[Element.stack]]メソッドを利用し、それはすべてのスロットの内部で利用できます。そのためスタックは他のスタックやフローを含むことができます。
+新しいスタックを作成するには[[Element.stack]]メソッドを利用し、それはすべてのスロットの
+内部で利用できます。そのためスタックは他のスタックやフローを含むことができます。
 
 ==== Flows ====
 
-フローは要素をできるだけしっかりと詰め込みます。幅は満たされ、それらの下の要素を包みます。互いに隣接して配置されたテキストの要素は一つのパラグラフとして表示されます。画像とウィジェットは同じシリーズとして実行されます。
+フローは要素をできるだけしっかりと詰め込みます。幅は満たされ、それらの下の要素を包みます。
+互いに隣接して配置されたテキストの要素は一つのパラグラフとして表示されます。
+画像とウィジェットは同じシリーズとして実行されます。
 
-スタックのように、フローは箱です。そのためスタックとフローは安全に埋め込むことができ、それらのコンテンツに気を使うことなく、同質です。スタックとフローはそれらのコンテンツだけを異なって扱います。
+スタックのように、フローは箱です。そのためスタックとフローは安全に埋め込むことができ、
+それらのコンテンツに気を使うことなく、同質です。スタックとフローはそれらのコンテンツだけを
+異なって扱います。
 
-フローを作成するには[[Element.flow]]を呼びます。フローは他のフローやスタックを含むかもしれません。
+フローを作成するには[[Element.flow]]を呼びます。
+フローは他のフローやスタックを含むかもしれません。
 
-最後に：Shoesのウィンドウはそれ自身がフローです。
+最後に：Green Shoesのウィンドウはそれ自身がフローです。
 
 == Art for Slots ==
 
-それぞれのスロットは、色のついた形状やグラデーションなどでおおうことにできる白紙の表面のキャンバスのようなものです。
+それぞれのスロットは、色のついた形状やグラデーションなどでおおうことにできる白紙の表面の
+キャンバスのようなものです。
 
-多くの一般的な形状は`oval`と`rect`メソッドで描かれます。まず、絵筆の色を準備する必要があります。
+多くの一般的な形状は`oval`と`rect`メソッドで描かれます。
+まず、絵筆の色を準備する必要があります。
 
-`stroke`コマンドは線の色を設定します。`fill`コマンドは線の内部を塗りつぶすために利用する色を設定します。　
+`stroke`コマンドは線の色を設定します。
+`fill`コマンドは線の内部を塗りつぶすために利用する色を設定します。　
 
 {{{
  #!ruby
  Shoes.app do
    stroke red
    fill blue
-   oval :top => 10, :left => 10,
-     :radius => 100
+   oval top: 10, left: 10, radius: 100
  end
 }}}
 
-このコードはまわりに赤い線のある青いパイを与えます。100ピクセルの幅で、ウィンドウの左上から南東に少しのピクセルを配置します。
+このコードはまわりに赤い線のある青いパイを与えます。
+100ピクセルの幅で、ウィンドウの左上から南東に少しのピクセルを配置します。
 
-上記の`blue`と`red`メソッドはカラーオブジェクトです。どうやって色を混ぜるかはColorsセクションを見てください。
+上記の`blue`と`red`メソッドはRGB配列です。
+どうやって色を混ぜるかはColorsセクションを見てください。
 
 ==== Processing と NodeBox からのインスピレーション ====
 
-この技巧的なメソッドの大抵は文字通りPythonのドローイングキットのNodeBoxから来ています。次に、NodeBoxは多くのアイデアを、グラフィックとアニメーションのためのJavaのような言語であるProcessingから得ています。私はそれらのすばらしいプログラムの作者から大きな恩を受けています。
+この技巧的なメソッドの大抵は文字通りPythonのドローイングキットのNodeBoxから来ています。
+次に、NodeBoxは多くのアイデアを、グラフィックとアニメーションのためのJavaのような言語である
+Processingから得ています。私はそれらのすばらしいプログラムの作者から大きな恩を受けています。
 
-ShoesはNodeBoxとProcessingから少しの点が違います。例えば、Shoesはそれ自身のカラーオブジェクトを持っていることを含めて、異なるカラーメソッドを持っていますが、それらはとてもProcessingのカラーメソッドに似ています。そしてShoesは線を描くことや形状内を塗りつぶすために画像やグラデーションを利用することも許しています。
+Green ShoesはNodeBoxとProcessingから少しの点が違います。
+例えば、Green Shoesはそれ自身のRGB配列を持っていることを含めて、異なるカラーメソッドを
+持っていますが、それらはとてもProcessingのカラーメソッドに似ています。
+そしてGreen Shoesは線を描くことや形状内を塗りつぶすために画像やグラデーションを
+利用することも許しています。
 
-ShoesはいくつかのアニメーションのアイデアをProcessingから取り入れており、Processingのメソッドをしっかりと参考にしようとしながらそれを拡張しています。
+ShoesはいくつかのアニメーションのアイデアをProcessingから取り入れており、
+Processingのメソッドをしっかりと参考にしようとしながらそれを拡張しています。
 
-=== arc(left, top, width, height, angle1, angle2) » Shoes::Shape ===
+=== arc(left, top, width, height, angle1, angle2) » Shoes::Oval ===
 
-弧の形状（楕円形の一部）を座標（left, top）に描きます。このメソッドは`:angle1`と`:angle2`のスタイルを提供することにより [[oval]]より少し多くの制御をが行えます。（実際には、`:angle1`に0と`:angle2`に`Shoes::TWO_PI`を設定することにより、`oval`メソッドをまねることができます。）
+弧の形状（楕円形の一部）を座標（left, top）に描きます。
+このメソッドは`:angle1`と`:angle2`のスタイルを提供することにより [[oval]]より
+少し多くの制御をが行えます。（実際には、`:angle1`に0と`:angle2`に`2*Math::PI`を
+設定することにより、`oval`メソッドをまねることができます。）
+
+{{{
+ Shoes.app do
+   fill yellow..green
+   stroke red..blue
+   strokewidth 10
+   cap :curve
+ 
+   a = animate 12 do |i|
+     @e.remove if @e
+     r = i * (Math::PI * 0.01)
+     @e = arc 100, 50, 180, 360, 0, r
+     a.stop if r >= 2*Math::PI
+   end
+ end
+}}}
 
 === arrow(left, top, width) » Shoes::Shape ===
 
 座標（left, top）に`width`ピクセルの矢を描きます。
 
+{{{
+ Shoes.app do
+   para 'An arrow shape:', left: 20, top: 10
+   arrow 30, 40, 70
+ end
+}}}
+
 === cap(:curve or :rect or :project) » self ===
 
-描くすべての線の終点の形状である線の頂点を設定します。`:curve`が設定されるなら、終点はまるくなります。デフォルトは`:rect`で、線の終点は突然に平らになります。`:project`の頂点も平らですが、棒の外側は少し長くなります。
+描くすべての線の終点の形状である線の頂点を設定します。
+`:curve`が設定されるなら、終点はまるくなります。
+デフォルトは`:rect`で、線の終点は突然に平らになります。
+`:project`の頂点も平らですが、棒の外側は少し長くなります。
+
+{{{
+ Shoes.app do
+   nofill
+   strokewidth 20
+   stroke green
+   cap :curve
+   line 100, 100, 300, 100
+   line 100, 250, 300, 300
+   cap :rect
+   line 100, 150, 300, 150
+   stroke blue
+   cap :project
+   line 100, 200, 300, 200
+   line 200, 100, 200, 300
+   strokewidth 1
+   stroke red
+   rect 100, 100, 200, 200
+ end
+}}}
 
 === fill(pattern) » pattern ===
 
-塗りつぶすバケツの色の指定（またはパターン）を設定します。パターンは色やグラデーションまたは画像が設定できます。そして、一度塗りつぶすバケツが設定されたら、選択されたパターンで色づけられた形状を描くことができます。
+塗りつぶすバケツの色の指定（またはパターン）を設定します。
+パターンは色やグラデーションまたは画像が設定できます。
+そして、一度塗りつぶすバケツが設定されたら、選択されたパターンで色づけられた形状を
+描くことができます。
 
 画像のパターンで星を描くためには：
 
 {{{
  #!ruby
  Shoes.app do
-   fill "static/avatar.png"
-   star 200, 200, 5
+   fill File.join(DIR, "../static/gshoes-icon.png")
+   star 200, 200, 5, 100, 50
  end
 }}}
 
-塗りつぶすバケツをクリアするには`nofill`を使ってください。そして`stroke`メソッドを利用して線（星の枠線）の色を設定してください。
+塗りつぶすバケツをクリアするには`nofill`を使ってください。
+そして`stroke`メソッドを利用して線（星の枠線）の色を設定してください。
 
 === nofill() » self ===
 
-塗りつぶす色を削除するため、形状は塗りつぶされずに描かれます。その代わりに、形状は線だけを持ち、中央を透明のままにします。
+塗りつぶす色を削除するため、形状は塗りつぶされずに描かれます。
+その代わりに、形状は線だけを持ち、中央を透明のままにします。
 
 === nostroke() » self ===
 
-線の色を空にします。形状は外側の線が描かれなくなります。`nofill`も設定された場合は、形状は表示されずに描かれます。
+線の色を空にします。形状は外側の線が描かれなくなります。
+`nofill`も設定された場合は、形状は表示されずに描かれます。
 
-=== line(left, top, x2, y2) » Shoes::Shape ===
+=== line(left, top, x2, y2) » Shoes::Line ===
 
 現在の線の色（別名"stroke"）を使って座標（left, top）から（x2, y2）まで線を描きます。
 
-=== oval(left, top, radius) » Shoes::Shape ===
+=== oval(left, top, radius) » Shoes::Oval ===
 
-座標（left, top）ピクセルに`radius`ピクセルの幅と高さの円を描きます。線の色や塗りつぶす色が形状を描くために利用されます。デフォルトでは、座標は楕円形の最も左上の角ですが、これは[[Art.transform]]メソッドを呼ぶことや、次のメソッドの下の`:center`スタイルを使用することによって変更することができます。
+座標（left, top）ピクセルに`radius`ピクセルの幅と高さの円を描きます。
+線の色や塗りつぶす色が形状を描くために利用されます。
+デフォルトでは、座標は楕円形の最も左上の角ですが、これは[[Art.transform]]メソッドを
+呼ぶことや、次のメソッドの下の`:center`スタイルを使用することによって変更することができます。
 
 {{{
  #!ruby
@@ -1357,14 +1812,14 @@ ShoesはいくつかのアニメーションのアイデアをProcessingから
    stroke blue
    strokewidth 4
    fill black
-
    oval 10, 10, 50
  end
 }}}
 
-様々な比率の楕円形を描くためには、`oval(left, top, width, height)`のシンタックスを利用してもいいです。
+様々な比率の楕円形を描くためには、`oval(left, top, width, height)`のシンタックスを
+利用してもいいです。
 
-=== oval(styles) » Shoes::Shape ===
+=== oval(styles) » Shoes::Oval ===
 
 スタイルのハッシュを利用して円を描きます。次のスタイルがサポートされています：
 
@@ -1375,11 +1830,15 @@ ShoesはいくつかのアニメーションのアイデアをProcessingから
  * `height`: 楕円形の高さのピクセルでの指定。
  * `center`: 座標を楕円形の中央に指定しますか？（trueまたはfalse）
 
-これらのスタイルはShoesオブジェクトの`style`メソッドを利用して変更されます。
+これらのスタイルは形状オブジェクトの`style`メソッドを利用して変更されます。
+
+'''注意:''' Green Shoesは`:center`スタイルをサポートしていません。
 
-=== rect(top, left, width, height, corners = 0) » Shoes::Shape ===
+=== rect(top, left, width, height, corners = 0) » Shoes::Rect ===
 
-座標（left, top）からwidth x heightの寸法の長方形を描きます。オプションとして、5番目の引数（ピクセルでの角の半径）により長方形の角を丸くすることもできます。他の形状と同様に、長方形は描く線の色や塗りつぶす色を利用して描かれます。
+座標（left, top）からwidth x heightの寸法の長方形を描きます。
+オプションとして、5番目の引数（ピクセルでの角の半径）により長方形の角を丸くすることもできます。
+他の形状と同様に、長方形は描く線の色や塗りつぶす色を利用して描かれます。
 
 {{{
  #!ruby
@@ -1390,9 +1849,11 @@ ShoesはいくつかのアニメーションのアイデアをProcessingから
  end
 }}}
 
-上記のサンプルは角の周囲に10ピクセルのマージンを残して、その親の箱の範囲を塗りつぶす長方形を描きます。デフォルトで親の箱を塗りつぶした長方形のためには`background`も見てください。
+上記のサンプルは角の周囲に10ピクセルのマージンを残して、その親の箱の範囲を塗りつぶす
+長方形を描きます。デフォルトで親の箱を塗りつぶした長方形のためには`background`も
+見てください。
 
-=== rect(styles) » Shoes::Shape ===
+=== rect(styles) » Shoes::Rect ===
 
 スタイルのハッシュを利用して長方形を描きます。次のスタイルがサポートされています：
 
@@ -1403,11 +1864,14 @@ ShoesはいくつかのアニメーションのアイデアをProcessingから
  * `height`:長方形のピクセルによる高さ。
  * `center`: 座標を長方形の中央に指定しますか？（trueまたはfalse）
 
-これらのスタイルはShoesオブジェクトの`style`メソッドを利用して変更されます。
+これらのスタイルは形状オブジェクトの`style`メソッドを利用して変更されます。
+
+'''注意:''' Green Shoesは`:center`スタイルをサポートしていません。
 
 === rotate(degrees: a number) » self ===
 
-形状をその角度で描画するために、`度（degrees）`数により描画のために利用される範囲を回転させます。
+形状をその角度で描画するために、`度（degrees）`数により描画のために利用される
+範囲を回転させます。
 
 下の例では、長方形は(30, 30)に45度回転されて描かれます。
 
@@ -1422,34 +1886,44 @@ ShoesはいくつかのアニメーションのアイデアをProcessingから
 
 === shape(left, top) { ... } » Shoes::Shape ===
 
-(left, top)から開始してブロックの内部で`line_to`、`move_to`、`curve_to`そして`arc_to`を呼ぶことにより
-続く、描かれる任意の形状を表現（記述）します
-
-曲がったり弧を描いたりする長い線の形状をスケッチとして見ることができます。
+(left, top)から開始して、続いてブロックの内部で`line_to`、`move_to`、`curve_to`
+そして`arc_to`を呼ぶことにより、任意の形状を表現（記述）します。
+曲がったり弧を描いたりする長い線の形状をスケッチして見ることができます。
 
 {{{
- #!ruby
  Shoes.app do
-   fill red(0.2)
+   fill yellow
    shape do
-     move_to(90, 55)
-     arc_to(50, 55, 50, 50, 0, PI/2)
-     arc_to(50, 55, 60, 60, PI/2, PI)
-     arc_to(50, 55, 70, 70, PI, TWO_PI-PI/2)
-     arc_to(50, 55, 80, 80, TWO_PI-PI/2, TWO_PI)
+     move_to 50, 30
+     curve_to 100, 100, 10, 20, 100, 50
+     line_to 20, 100
+     line_to 30, 30
    end
  end
 }}}
 
-形状は他の形状を含むこともできます。そして、形状の内部に[[Art.oval]]、[[Art.rect]]、[[Art.line]]、[[Art.star]]または[[Art.arrow]]（さらに、[[Art]]セクションの他のメソッドすべて）を配置することができますが、それらは線の一部ではないでしょう。形状のグループのようなそれらは、すべて1つとして描かれます。
+形状は他の形状を含むこともできます。
+そして、形状の内部に[[Art.oval]]、[[Art.rect]]、[[Art.line]]、[[Art.star]]または
+[[Art.arrow]]（さらに、[[Art]]セクションの他のメソッドすべて）を配置することができますが、
+それらは線の一部ではないでしょう。形状のグループのようなそれらは、すべて1つとして描かれます。
+
+'''注意:''' Green Shoesでは、上記の`line_to`、`move_to`、`curve_to`は
+Cairo::Contextのメソッドです。ブロックの中で直接それらを呼び出しています。
+そのため、Green Shoesでは`arc_to`はサポートしていません。また他の形状もShapeブロック
+内に含めることができません。
 
-=== star(left, top, points = 10, outer = 100.0, inner = 50.0) » Shoes::Shape ===
+=== star(left, top, points = 10, outer = 100.0, inner = 50.0) » Shoes::Star ===
 
-描く線の色や塗りつぶす色を利用して星を描きます。星は(left, top)の座標を中心点として`頂点（points）`の数とともに配置されます。`outer`の幅は星の全半径をを定義します；`inner`の幅は頂点の始まる星の中央の半径を指定します。
+描く線の色や塗りつぶす色を利用して星を描きます。
+星は(left, top)の座標を中心点として`頂点（points）`の数とともに配置されます。
+`outer`の幅は星の全半径をを定義します；`inner`の幅は頂点の始まる星の中央の半径を
+指定します。
 
 === stroke(pattern) » pattern ===
 
-スロットのアクティブな線の色を設定します。`pattern`は色、グラデーションまたは画像で、それらはすべて"patterns"に分類されます。その線の色はそれに続く形状すべての枠線を描くときに利用されます。
+スロットのアクティブな線の色を設定します。`pattern`は色、グラデーションまたは画像で、
+それらはすべて"patterns"に分類されます。その線の色はそれに続く形状すべての枠線を
+描くときに利用されます。
 
 つまり、まわりに赤い線を持つ矢印を描くには：
 
@@ -1457,7 +1931,8 @@ ShoesはいくつかのアニメーションのアイデアをProcessingから
  #!ruby
  Shoes.app do
    stroke red
-   arrow 0, 100, 10
+   nofill
+   star 100, 100
  end
 }}}
 
@@ -1465,63 +1940,95 @@ ShoesはいくつかのアニメーションのアイデアをProcessingから
 
 === strokewidth(a number) » self ===
 
-スロットの内部で描かれるすべての線のサイズを設定します。`stroke`メソッドが線の色を変更する一方、`strokewidth`メソッドは線のサイズをピクセルで変更します。`strokewidth(4)`を呼ぶことにより4ピクセルの太さで線を描きます。
+スロットの内部で描かれるすべての線のサイズを設定します。
+`stroke`メソッドが線の色を変更する一方、`strokewidth`メソッドは線のサイズを
+ピクセルで変更します。`strokewidth(4)`を呼ぶことにより4ピクセルの太さで線を描きます。
 
 === transform(:center or :corner) » self ===
 
-（`skew`や`rotate`のような）変化は形状の中心あたりで実行されるべきですか？またはその形状の角ですか？Shoesの初期値は`:corner`です。
+（`skew`や`rotate`のような）変化は形状の中心あたりで実行されるべきですか？
+またはその形状の角ですか？Shoesの初期値は`:corner`です。
+
+'''注意:''' Green Shoesは`:transform`メソッドをサポートしていません。
 
 === translate(left, top) » self ===
 
-スロットの描画の範囲を開始する位置を移動します。通常は、すべての形状がこの位置から描くことができるように、その範囲は左上の角の(0, 0)から開始します。`translate`により開始位置が(10, 20)に移動されて、(50, 60)に形状が描かれるなら、その形状は実際にはスロットの(60, 80)に描かれます。
+スロットの描画の範囲を開始する位置を移動します。
+通常は、すべての形状がこの位置から描くことができるように、その範囲は左上の角の
+(0, 0)から開始します。`translate`により開始位置が(10, 20)に移動されて、
+(50, 60)に形状が描かれるなら、その形状は実際にはスロットの(60, 80)に描かれます。
+
+'''注意:''' Green Shoesは`:translate`メソッドをサポートしていません。
 
 == Element Creation ==
 
-Shoesは幅広い種類の要素を持っており、その多くをHTMLからよいところを選んで採用しています。このページはどのようにしてスロットにそれらの要素を作成するかを記述しています。それらの要素を配置した後でさらにどのようにして変更したり利用するのかについては、このマニュアルの要素（Elements）のセクションを見てください。
+Green Shoesは幅広い種類の要素を持っており、その多くをHTMLからよいところを選んで
+採用しています。このページはどのようにしてスロットにそれらの要素を作成するかを記述して
+います。それらの要素を配置した後でさらにどのようにして変更したり利用するのかについては、
+このマニュアルの要素（Elements）のセクションを見てください。
 
-=== animate(fps) { |frame| ... } » Shoes::Animation ===
+=== animate(fps) { |frame| ... } » Shoes::Anim ===
 
-アプリケーションをそのままにして並列で実行するアニメーションタイマーを開始します。`fps`は秒ごとのフレームの数です。この数は付属するブロックが1秒に何回呼ばれるのかを決定します。
+アプリケーションをそのままにして並列で実行するアニメーションタイマーを開始します。
+`fps`は秒ごとのフレームの数です。
+この数は付属するブロックが1秒に何回呼ばれるのかを決定します。
 
-このブロックは`frame`の数が与えられます。`frame`の数はゼロから始まり、そのブロックが何フレームのアニメーションを表示したのかを教えます
+このブロックは`frame`の数が与えられます。
+`frame`の数はゼロから始まり、そのブロックが何フレームのアニメーションを表示したのかを
+教えます。
 
 {{{
  #!ruby
  Shoes.app do
-   @counter = para "STARTING"
-   animate(24) do |frame|
-     @counter.replace "FRAME #{frame}"
+   counter = para "STARTING"
+   animate 24 do |frame|
+     counter.replace "FRAME #{frame}"
    end
  end
 }}}
 
-上記のアニメーションは1秒間に24回表示されます。数が与えられないなら、`fps`のデフォルトは10です。
+上記のアニメーションは1秒間に24回表示されます。
+数が与えられないなら、`fps`のデフォルトは10です。
 
 === background(pattern) » Shoes::Background ===
 
-色（またはパターン）を指定して背景（Background）要素を描きます。パターンは色、グラデーションまたは画像です。色と画像は背景全体に敷き詰めます。グラデーションは背景を塗りつぶすように伸びます。
+色（またはパターン）を指定して背景（Background）要素を描きます。
+パターンは色、グラデーションまたは画像です。色と画像は背景全体に敷き詰めます。
+グラデーションは背景を塗りつぶすように伸びます。
 
-'''注意してください:''' 背景は実際には要素であり、スタイルではありません。HTMLは背景をスタイルのようにあつかいます。それはすべての箱は一つの背景だけを持てることを意味します。Shoesは背景の要素を重ねることができます。
+'''注意してください:''' 背景は実際には要素であり、スタイルではありません。
+HTMLは背景をスタイルのようにあつかいます。
+それはすべての箱は一つの背景だけを持てることを意味します。
+Green Shoesは背景の要素を重ねることができます。
 
 {{{
  #!ruby
  Shoes.app do
    background black
-   background white, :width => 50
+   background white, width: 50
  end
 }}}
 
-上記の例は二つの背景を塗ります。まず、黒い背景がアプリケーションの表面のエリア全体に塗られます。そして、50ピクセルの白い縞が左側にそって塗られます。
+上記の例は二つの背景を塗ります。
+まず、黒い背景がアプリケーションの表面のエリア全体に塗られます。
+そして、50ピクセルの白い縞が左側にそって塗られます。
 
 === banner(text) » Shoes::Banner ===
 
-バナー（Banner）のテキストブロックを作成します。Shoesは自動的に48ピクセルの大きさにテキストを整形します。
+バナー（Banner）のテキストブロックを作成します。
+Green Shoesは自動的に48ピクセルの大きさにテキストを整形します。
 
 === border(text, :strokewidth => a number) » Shoes::Border ===
 
-色（またはパターン）を指定して枠線（Border）の要素を描きます。パターンは色、グラデーションまたは画像です。色と画像は枠線全体に敷き詰めます。グラデーションは背景を塗りつぶすように伸びます。
+色（またはパターン）を指定して枠線（Border）の要素を描きます。
+パターンは色、グラデーションまたは画像です。色と画像は枠線全体に敷き詰めます。
+グラデーションは背景を塗りつぶすように伸びます。
 
-'''注意してください:''' 背景のように、枠線は実際には要素であり、スタイルではありません。HTMLは背景や枠線をスタイルのようにあつかいます。それはすべての箱は一つの枠線だけを持てることを意味します。Shoesはテキストブロック、画像、他のすべてのものにそって、枠線や背景の要素を重ねることができます。
+'''注意してください:''' 背景のように、枠線は実際には要素であり、スタイルではありません。
+HTMLは背景や枠線をスタイルのようにあつかいます。
+それはすべての箱は一つの枠線だけを持てることを意味します。
+Green Shoesはテキストブロック、画像、他のすべてのものにそって、枠線や背景の要素を
+重ねることができます。
 
 === button(text) { ... } » Shoes::Button ===
 
@@ -1530,36 +2037,48 @@ Shoesは幅広い種類の要素を持っており、その多くをHTMLから
 
 === caption(text) » Shoes::Caption ===
 
-キャプション（Caption）テキストブロックを作成します。Shoesは14ピクセルの大きさにこのテキストを整形します。
+キャプション（Caption）テキストブロックを作成します。
+Green Shoesは14ピクセルの大きさにこのテキストを整形します。
 
 === check() » Shoes::Check ===
 
 チェックボックスを追加します。
 
-=== code(text) » Shoes::Code ===
+=== code(text) » String ===
 
-コード（Code）のテキストの一部を作成します。このテキストはデフォルトで等幅フォントになります。
+コード（Code）のテキストの一部を作成します。
+このテキストはデフォルトで等幅フォントになります。
 
-=== del(text) » Shoes::Del ===
+=== del(text) » String ===
 
-デフォルトで中央に1本の棒線を引いてテキストを削除した、削除された（Del）（"deleted"の省略形）テキストの一部を作成します。
+デフォルトで中央に1本の棒線を引いてテキストを削除した、
+削除された（Del）（"deleted"の省略形）テキストの一部を作成します。
 
 === dialog(styles) { ... } » Shoes::App ===
 
-（まさに [[Element.window]]メソッドを実効したように）新しいアプリケーションのウィンドウを開きますが、そのウィンドウはダイアログボックスの外観を与えられます。
+（まさに [[Element.window]]メソッドを実効したように）新しいアプリケーションのウィンドウを
+開きますが、そのウィンドウはダイアログボックスの外観を与えられます。
+
+'''注意:''' Green Shoesは`dialog`メソッドをサポートしていません。
 
-=== edit_box(text) » Shoes::EditBox ===
+=== edit_box(text, :accepts_tab => true or false) » Shoes::EditBox ===
 
 スロットに大きなマルチラインのテキストエリアを追加します。
 この`text`はオプションでこの箱の開始時に与えられる文字列です。
-オプションのブロックをここに取り付けることができ、これはボックスのテキストに対するどんな種類のユーザの変更でも呼び出されます。
+オプションのブロックをここに取り付けることができ、これはボックスのテキストに対するどんな種類の
+ユーザの変更でも呼び出されます。
+
+`accepts_tab`にtrueを設定するとタブが挿入できます。
+`accepts_tab`にfalseを設定するとタブによるフォーカス移動ができます。
+デフォルトはfalseです。
 
 {{{
  #!ruby
  Shoes.app do
    edit_box
-   edit_box "HORRAY EDIT ME"
-   edit_box "small one", :width => 100, :height => 160
+   edit_box text: "HORRAY EDIT ME"
+   edit_box text: "small one",
+     width: 100, height: 160
  end
 }}}
 
@@ -1567,63 +2086,92 @@ Shoesは幅広い種類の要素を持っており、その多くをHTMLから
 
 スロットに一行のテキストボックスを追加します。
 この`text`はオプションでこの箱の開始時に与えられる文字列です。
-オプションのブロックをここに取り付けることができ、これはボックスのテキストに対するどんな種類のユーザの変更でも呼び出されます。
+オプションのブロックをここに取り付けることができ、これはボックスのテキストに対するどんな種類の
+ユーザの変更でも呼び出されます。
 
-=== em(text) » Shoes::Em ===
+=== em(text) » String ===
 
-Em（"emphasized"の省略形）テキストの一部を作成し、これはデフォルトでイタリック体で整形されます。
+Em（"emphasized"の省略形）テキストの一部を作成し、これはデフォルトでイタリック体で
+整形されます。
 
-=== every(seconds) { |count| ... } » Shoes::Every ===
+=== every(seconds) { |count| ... } » Shoes::Anim ===
 
-`animation`メソッドとよく似たタイマーですが、より非常に遅いです。このタイマーは与えられた数の秒（seconds）で、取り付けられたブロックを実行します。そのため、例えば5秒毎にwebサイトを確認する必要があるなら、実際にwebサイトにpingを打つコードを含むブロックと共に`every(300)`を呼び出します。
+`animate`メソッドとよく似たタイマーですが、より非常に遅いです。
+このタイマーは与えられた数の秒（seconds）で、取り付けられたブロックを実行します。
+そのため、例えば5秒毎にwebサイトを確認する必要があるなら、実際にwebサイトにpingを
+打つコードを含むブロックと共に`every(300)`を呼び出します。
 
 === flow(styles) { ... } » Shoes::Flow ===
 
-フロー（flow）はShoesの要素を配置できる目に見えない箱（または"スロット"）です。フローとスタックのどちらもメインの[[Slots]]のページでとても詳細に説明されます。
+フロー（flow）はGreen Shoesの要素を配置できる目に見えない箱（または"スロット"）です。
+フローとスタックのどちらもメインの[[Slots]]のページでとても詳細に説明されます。
 
-フローは要素を水平にまとめます。ものを垂直に積み重ねたままにするために[[Element.stack]]を利用するところで、フローはそのコンテンツをページの端から端にわたって配置します。いったんページの最後に到達したら、フローは要素の新しい行を開始します。
+フローは要素を水平にまとめます。ものを垂直に積み重ねたままにするために
+[[Element.stack]]を利用するところで、フローはそのコンテンツをページの端から端にわたって
+配置します。いったんページの最後に到達したら、フローは要素の新しい行を開始します。
 
 === image(path) » Shoes::Image ===
 
 写真を表示するために[[Image]]の要素を作成します。
 PNG、JPEGそしてGIFのフォーマットが許されます。
 
-`path`はファイルのパスまたはURLです。すべての画像はメモリに一時的にキャッシュされ、リモートの画像はローカルのユーザの個人的なShoesディレクトリにもキャッシュされます。リモートの画像はバックグラウンドでロードされます；ブラウザと同様に、画像はすぐには表示されませんが、それらがロードされたときに表示されます。
+`path`はファイルのパスまたはURLです。すべての画像はメモリに一時的にキャッシュされ、
+リモートの画像はローカルのユーザの個人的なShoesディレクトリにもキャッシュされます。
+リモートの画像はバックグラウンドでロードされます；ブラウザと同様に、画像はすぐには
+表示されませんが、それらがロードされたときに表示されます。
+
+'''注意:''' Green Shoesは上述のローカルのユーザの個人的なShoesディレクトリへの
+キャッシュをサポートしていません。
 
 === imagesize(path) » [width, height] ===
 
 画像の幅と高さを素早く手に入れます。
 画像はキャッシュにロードされず表示もされません。
 
-緊急の注意：このメソッドはリモートの画像（ハードディスクドライブからではなくHTTPによりロードされた）には利用できません。
+緊急の注意：このメソッドはリモートの画像（ハードディスクドライブからではなくHTTPにより
+ロードされた）には利用できません。
 
-=== ins(text) » Shoes::Ins ===
+=== ins(text) » String ===
 
-一本の下線のShoesスタイルである、Ins（"inserted"の省略形）テキストの一部を作成します。
+一本の下線のGreen Shoesスタイルである、Ins（"inserted"の省略形）テキストの一部を
+作成します。
 
 === inscription(text) » Shoes::Inscription ===
 
-題名（Inscription）のテキストブロックを作成します。Shoesは10ピクセルの大きさにこのテキストを整形します。
+題名（Inscription）のテキストブロックを作成します。
+Green Shoesは10ピクセルの大きさにこのテキストを整形します。
 
 === link(text, :click => proc or string) » Shoes::Link ===
 
-一本の下線を持ち線の色を#06E（青色）にShoesが整形した、リンクテキストブロックを作成します。デフォルトのリンクホバースタイルも一本の下線を持ち線の色を#039（ダークブルー）に整形します。
+一本の下線を持ち線の色を#06E（青色）に整形したリンクテキストブロックを作成します。
+デフォルトのリンクホバースタイルは一本の下線を持ち線の色を#039（ダークブルー）に整形します。
+
+=== link(text){ ... } » Shoes::Link ===
+
+この形式でもリンクテキストブロックを作成できます。
+この場合、ユーザがリンクテキストをクリックするとブロック内のコードが実行されます。
 
 === list_box(:items => [strings, ...]) » Shoes::ListBox ===
 
-`items`の配列のすべてのエントリを含むドロップダウンリストボックスを追加します。オプションでブロックが取り付けることができ、これはユーザがボックスの項目を選択したら呼び出されます。
+`items`の配列のすべてのエントリを含むドロップダウンリストボックスを追加します。
+オプションでブロックを取り付けることができ、これはユーザがボックスの項目を選択したら
+呼び出されます。
 
 {{{
  #!ruby
  Shoes.app do
-   stack :margin => 10 do
-     para "Pick a card:"
-     list_box :items => ["Jack", "Ace", "Joker"]
+  stack  margin: 10 do
+   para "Pick a card:"
+   list_box items: ["Jac", "Ace", "Jok"] do |item|
+    @p.text = "#{item} was picked!"
    end
+   @p = para
+  end
  end
 }}}
 
-選択された文字列をを得るために`ListBox#text`を呼び出します。より多くのヘルプは`リストボックス（ListBox）`のセクションの`ネイティブ`コントロールを見てください。
+選択された文字列をを得るために`ListBox#text`を呼び出します。
+より多くのヘルプは`リストボックス（ListBox）`のセクションの`ネイティブ`コントロールを見てください。
 
 === progress() » Shoes::Progress ===
 
@@ -1631,114 +2179,148 @@ PNG、JPEGそしてGIFのフォーマットが許されます。
 
 === para(text) » Shoes::Para ===
 
-Shoesが12ピクセルの大きさに整形する、Para（"paragraph"の省略形）テキストブロックを作成します。
+12ピクセルの大きさに整形する、Para（"paragraph"の省略形）テキストブロックを作成します。
 
 === radio(group name: a string or symbol) » Shoes::Radio ===
 
-ラジオボタンを追加します。`グループ名（group name）`が与えられたら、ラジオボタンはグループの一部だとみなされます。同じグループのラジオボタンのうちで、1つだけをクリックすることができます。（もしグループ名が与えられなければ、そのラジオボタンは同じスロットの他のすべてのラジオボタンとグループ化されます）
+ラジオボタンを追加します。`グループ名（group name）`が与えられたら、ラジオボタンは
+グループの一部だとみなされます。同じグループのラジオボタンのうちで、
+1つだけをクリックすることができます。（もしグループ名が与えられなければ、そのラジオボタンは
+同じスロットの他のすべてのラジオボタンとグループ化されます）
+
+=== span(text) » String ===
 
-=== span(text) » Shoes::Span ===
+デフォルトでスタイル付けされていない、Spanテキストの一部を作成します。
 
-デフォルトでされない、Spanテキストの一部を作成します。
+{{{
+ Shoes.app do
+   tagline "\n", 'hello ' * 5, 
+     span(em('Green Shoes'), size: 8, rise: 15)
+ end
+}}}
 
 === stack(styles) { ... } » Shoes::Stack ===
 
-新しいスタックを作成します。スタックはスロットの一種です。（スタックとフローの完全な説明はメインの[[Slots]]のページを見てください。）
+新しいスタックを作成します。スタックはスロットの一種です。
+（スタックとフローの完全な説明はメインの[[Slots]]のページを見てください。）
 
-要するに、スタックは要素を配置するための目に見えない箱（"スロット"）です。スタックにボタンや画像などを追加して、それらは垂直に積み上げられます。そう、それらは重なります。
+要するに、スタックは要素を配置するための目に見えない箱（"スロット"）です。
+スタックにボタンや画像などを追加して、それらは垂直に積み上げられます。
+そう、それらは重なります。
 
-=== strong(text) » Shoes::Strong ===
+=== strong(text) » String ===
 
 デフォルトで太字に整形された、Strongテキストの一部を作成します。
 
-=== sub(text) » Shoes::Sub ===
+=== sub(text) » String ===
 
-デフォルトでテキストは10ピクセル（位置を）下げられx-smallフォントに整形された、Sub（"subscript"の省略形）テキストの一部を作成します。
+デフォルトでテキストは10ピクセル（位置を）下げられx-smallフォントに整形された、
+Sub（"subscript"の省略形）テキストの一部を作成します。
 
 === subtitle(text) » Shoes::Subtitle ===
 
-サブタイトル（Subtitle）テキストブロックを作成します。Shoesは26ピクセルの大きさにこのテキストを整形します。
+サブタイトル（Subtitle）テキストブロックを作成します。
+26ピクセルの大きさにこのテキストを整形します。
 
-=== sup(text) » Shoes::Sup ===
+=== sup(text) » String ===
 
-デフォルトでテキストは10ピクセル（位置を）上げられx-smallフォントに整形された、Sup（"superscript"の省略形）テキストの一部を作成します。
+デフォルトでテキストは10ピクセル（位置を）上げられx-smallフォントに整形された、
+Sup（"superscript"の省略形）テキストの一部を作成します。
 
 === tagline(text) » Shoes::Tagline ===
 
-タグライン（Tagline）テキストブロックを作成します。Shoesはこのテキストを18ピクセルの大きさに整形します。
+タグライン（Tagline）テキストブロックを作成します。このテキストを18ピクセルの大きさに整形します。
 
-=== timer(seconds) { ... } » Shoes::Timer ===
+=== timer(seconds) { ... } » Fixnum ===
 
-1回だけのタイマーです。少しの秒（または分、時）後にいくらかのコードの実行をスケジュールしたいなら、ここにブロックとしてコードを取り付けることができます。
+1回だけのタイマーです。少しの秒（または分、時）後にいくらかのコードの実行をスケジュールしたい
+なら、ここにブロックとしてコードを取り付けることができます。
 
 今から5秒後にアラートボックスを表示するためには：
 
 {{{
  #!ruby
  Shoes.app do
-   timer(5) do
-     alert("Your five seconds are up.")
+   timer 5 do
+     alert "Your five seconds are up."
    end
  end
 }}}
 
 === title(text) » Shoes::Title ===
 
-タイトル（Title）テキストブロックを作成します。Shoesはこれらの要素を34ピクセルの大きさに整形します。
+タイトル（Title）テキストブロックを作成します。これらの要素を34ピクセルの大きさに整形します。
 
 === video(path or url) » Shoes::Video ===
 
-スロットに動画を埋め込みます。
+動画を埋め込みます。
 
 === window(styles) { ... } » Shoes::App ===
 
-新しいアプリケーションウィンドウを開きます。このメソッドは初めにアプリケーションを開始するために使われる[[App.Shoes.app]]メソッドとほとんど同一です。違いは`window`メソッドは新しいウィンドウの[[App.owner]]プロパティを設定することです。（普通のShoes.appはその`owner`を`nil`に設定します。）
+新しいアプリケーションウィンドウを開きます。
+このメソッドは初めにアプリケーションを開始するために使われる[[App.Shoes.app]]メソッドと
+ほとんど同一です。違いは`window`メソッドは新しいウィンドウの[[App.owner]]プロパティを
+設定することです。（普通のShoes.appはその`owner`を`nil`に設定します。）
 
-そのため、新しいウィンドウの`owner`はウィンドウを開始したShoes::Appに設定されるでしょう。この方法により子のウィンドウが親を呼べます。
+そのため、新しいウィンドウの`owner`はウィンドウを開始したShoes::Appに設定されるでしょう。
+この方法により子のウィンドウが親を呼べます。
 
 {{{
  #!ruby
- Shoes.app :title => "The Owner" do
-   button "Pop up?" do
-     window do
-       para "Okay, popped up from #{owner}"
-     end
+ Shoes.app title: "The Owner" do
+  button "Pop up?" do
+   window do
+    para "Okay, popped up from [#{owner.inspect}]."
    end
+  end
  end
 }}}
 
 == Events ==
 
-どのようにしてマウスのクリックを離したことやキーボードをタイプしたことが分かるか不思議に思いませんか？スロットの内部でマウスが動いたときはいつでもイベントがスロットに送られます。また、キーが押されたときはいつでも。スロットが作成されたり破壊されたときでさえ。それぞれのそれらのイベントをブロックを取り付けることができます。
+どのようにしてマウスのクリックを離したことやキーボードをタイプしたことが分かるか
+不思議に思いませんか？スロットの内部でマウスが動いたときはいつでもイベントが
+スロットに送られます。また、キーが押されたときはいつでも。
+スロットが作成されたり破壊されたときでさえ。それぞれのそれらのイベントをブロックを
+取り付けることができます。
 
-マウスイベントは`motion`、`click`、`hover`そして`leave`を含みます。キーボードのタイピングは`keypress`イベントによって表されます。そして`start`や`finish`イベントはキャンバスを開始するときや破棄されたときを指し示します。
+マウスイベントは`motion`、`click`、`hover`そして`leave`を含みます。
+キーボードのタイピングは`keypress`イベントによって表されます。
+そして`start`や`finish`イベントはキャンバスを開始するときや破棄されたときを指し示します。
 
-では、マウスでスロットの上をフロートするときに背景を変更したいとしましょう。スロットの内部にマウスがくるときに背景を変更するためには`hover`イベントを使います。そして、マウスがフロートして離れるときに戻すには`leave`を使います。
+では、マウスでスロットの上をフロートするときに背景を変更したいとしましょう。
+スロットの内部にマウスがくるときに背景を変更するためには`hover`イベントを使います。
+そして、マウスがフロートして離れるときに戻すには`leave`を使います。
 
 {{{
  #!ruby
  Shoes.app do
-   s = stack :width => 200, :height => 200 do
+   s = stack width: 200, height: 200 do
      background red
-     hover do
-       s.clear { background blue }
-     end
-     leave do
-       s.clear { background red }
-     end
+   end
+   s.hover do
+     s.clear { background blue }
+   end
+   s.leave do
+     s.clear { background red }
    end
  end
 }}}
 
 === click { |button, left, top| ... } » self ===
 
-マウスボタンがクリックされたときにはclickブロックが呼ばれます。`button`はマウスボタンのどれが押されたかの数です。`left`や`top`はどこがクリックされたかのマウスの座標です。
+マウスボタンがクリックされたときにはclickブロックが呼ばれます。
+`button`はマウスボタンのどれが押されたかの数です。
+`left`や`top`はどこがクリックされたかのマウスの座標です。
 
 マウスのクリックを離した瞬間をとらえるには、[[Events.release]]イベントを見てください。
 
 === finish { |self| ... } » self ===
 
-スロットが取り除かれたときは、finishイベントが発生します。finishブロックはすぐに`self`を手渡し、スロットオブジェクトは取り除かれます。
+スロットが取り除かれたときは、finishイベントが発生します。
+finishブロックはすぐに`self`を手渡し、スロットオブジェクトは取り除かれます。
+
+'''注意:''' Green Shoesは`finish`メソッドをサポートしていません。
 
 === hover { |self| ... } » self ===
 
@@ -1749,71 +2331,77 @@ hoverイベントはスロットにマウスが入ったときに発生します
 
 === keypress { |key| ... } » self ===
 
-キー（またはキーの組み合わせ）がいつ押されても、そのブロックは呼ばれます。そのブロックはキーの性質を表す文字列である`key`を送ります。特別なキーやキーの組み合わせの場合は、文字列ではなくRubyのシンボルが送られます。
+キー（またはキーの組み合わせ）がいつ押されても、そのブロックは呼ばれます。
+そのブロックにはキーの性質を表す文字列である`key`を送られます。
 
 そして、例えば、`Shift-a`が押されたなら、そのブロックは`"A"`の文字列を得ます。
+また、F1が押されたなら、 `F1`の文字列を受けとります。
 
-しかしながら、F1が押されたなら、 `:f1`のシンボルを受けとります。`Shift-F1`なら、そのシンボルは`:shift_f1`です。
-
-`control`、`shift`そして`alt`は修飾キーです。それらは以下の順番で現れます。`Shift-Control-Alt-PgUp`が押されたなら、そのシンボルは`:control_shift_alt_page_up`になります。
+`"Control_L"`, `"Shift_L"`, `"Alt_L"`は左サイドに位置する修飾キーです。
+もし`Shift-Control-Alt-PgUp`が押されたなら、得られる文字列は、以下の順番で現れます: 
+`"Shift_L"`, `"Control_L"`, `"Alt_L"`, `"Page_Up"`
 
-シフトキーについて１つ。多くのキーでシフトキーを見ないでしょう。USキーボードでは、`Shift-7`はアンパサンド（&）です。そのため、`:shift_5`ではなく`"&"`を得ます。そして、そのようなキーボードで`Shift-Alt-7`を押したら、`:alt_&`のシンボルを得ます。いくつか下のパラグラフで特別なキーのシフト修飾子の一覧が見えます。
+シフトキーについて１つ。USキーボードでは、`Shift-7`はアンパサンド（&）です。
+そのため、`"Shift_L"`と`"7"`ではなく、`"Shift_L"`と`"ampersand"`を得ます。
+そして、そのようなキーボードで`Shift-Alt-7`を押したら、`"Shift_L"`と`"Alt_L"`と
+`"ampersand"`という文字列を得るでしょう。
 
 {{{
  #!ruby
  Shoes.app do
-   @info = para "NO KEY is PRESSED."
+   info = para "NO KEY is PRESSED."
    keypress do |k|
-     @info.replace "#{k.inspect} was PRESSED."
+     info.replace "#{k.inspect} was PRESSED."
    end
  end
 }}}
 
-Shoesがそれ自身のいくつかのホットキーを利用することを覚えておいてください。Alt-ピリオド（`:alt_.`）、Alt-クエッション（`:alt_?`）そしてAlt-スラッシュ(`:alt_/`)はShoesの予約語です。
-
-以下はスペシャルキーの一覧です: `:escape`、`:delete`、　
-`:backspace`、`:tab`、`:page_up`、`:page_down`、`:home`、`:end`、`:left`、`:up`、　
-`:right`、`:down`、`:f1`、`:f2`、`:f3`、`:f4`、`:f5`、`:f6`、`:f7`、`:f8`、`:f9`、　
-`:f10`、`:f11`そして`:f12`。
-
-それらすべてのルールに関する一つの警告：通常はリターンキーは`"\n"`を与えます。しかしながら、修飾キーが押されたときには、最後には`:control_enter`、`:control_alt_enter`、`:shift_alt_enter`になります。
-
 === leave { |self| ... } » self ===
 
-スロットからマウスカーソルが出て行くときleaveイベントが発生します。その瞬間すでにマウスカーソルはスロットの端の中にはありません。leaveイベントが発生するとき、`self`とともにブロックが呼ばれ、そのスロットオブジェクトは取り残されます。
+スロットからマウスカーソルが出て行くときleaveイベントが発生します。
+その瞬間すでにマウスカーソルはスロットの端の中にはありません。
+leaveイベントが発生するとき、`self`とともにブロックが呼ばれ、そのスロットオブジェクトは
+取り残されます。
 
 スロットにマウスが入ることを見つけたいなら[[Events.hover]]も見てください。
 
 === motion { |left, top| ... } » self ===
 
-マウスがスロットの内部を移動するたびにモーションのブロックは呼ばれます。ブロックはカーソルの`left`や`top`の座標を渡します。
+マウスがスロットの内部を移動するたびにモーションのブロックは呼ばれます。
+ブロックはカーソルの`left`や`top`の座標を渡します。
 
 {{{
  #!ruby
- Shoes.app :width => 200, :height => 200 do
+ Shoes.app width: 200, height: 200 do
    background black
    fill white
-   @circ = oval 0, 0, 100, 100
-
+   circ = oval 0, 0, 100, 100
+ 
    motion do |top, left|
-     @circ.move top - 50, left - 50
+     circ.move top - 50, left - 50
    end
  end
 }}}
 
 === release { |button, left, top| ... } » self ===
 
-マウスがアンクリック（マウスアップ）のときにreleaseのブロックは実行されます。それは指が持ち上げられたときです。`button`は押し下げられたボタンに対応する数です。`left`や`top`はボタンが離されたときのマウスのの座標です。
+マウスがアンクリック（マウスアップ）のときにreleaseのブロックは実行されます。
+それは指が持ち上げられたときです。`button`は押し下げられたボタンに対応する数です。
+`left`や`top`はボタンが離されたときのマウスのの座標です。
 
 実際のマウスクリックを捕まえるには、[[Events.click]]イベントを利用してください。
 
 === start { |self| ... } » self ===
 
-初めてスロットが描かれるとき、スタート（start）イベントが実行されます。まさに今描かれたスロットオブジェクトが`self`としてブロックに渡されます。
+初めてスロットが描かれるとき、スタート（start）イベントが実行されます。
+まさに今描かれたスロットオブジェクトが`self`としてブロックに渡されます。
+
+'''注意:''' Green Shoesは`start`メソッドをサポートしていません。
 
 == Manipulation Blocks ==
 
-以下のmanipulationメソッドはスロットの周囲を変更したり新しい要素を挿入することを手早く片付けます。
+以下のmanipulationメソッドはスロットの周囲を変更したり新しい要素を挿入することを
+手早く片付けます。
 
 === append() { ... } » self ===
 
@@ -1826,12 +2414,14 @@ Shoesがそれ自身のいくつかのホットキーを利用することを覚
    timer 3 do
      @slot.append do
        title "Breaking News"
-       tagline "Astronauts arrested for space shuttle DUI."
+       tagline "Astronauts ",
+         "arrested for space shuttle DUI."
      end
    end
  end
 }}}
 
+
 `title`や`tagline`の要素を`@slot`の最後に追加します。
 
 === after(element) { ... } » self ===
@@ -1844,15 +2434,18 @@ Shoesがそれ自身のいくつかのホットキーを利用することを覚
 
 === clear() » self ===
 
-タイマーやネストしたスロットなど、スロットのすべての要素を空にします。スロットのコンテンツを最初から最後までループしてそれぞれの要素の`remove`メソッドを呼ぶことと効果としては同一です。
+タイマーやネストしたスロットなど、スロットのすべての要素を空にします。
+スロットのコンテンツを最初から最後までループしてそれぞれの要素の`remove`メソッドを
+呼ぶことと効果としては同一です。
 
 === clear() { ... } » self ===
 
-clearメソッドはオプションでブロックも取ります。このブロックはスロットのコンテンツを置き換えるために利用されます。
+clearメソッドはオプションでブロックも取ります。
+このブロックはスロットのコンテンツを置き換えるために利用されます。
 
 {{{
  #!ruby
-  Shoes.app do
+ Shoes.app do
    @slot = stack { para "Old text" }
    timer 3 do
      @slot.clear { para "Brand new text" }
@@ -1868,7 +2461,7 @@ clearメソッドはオプションでブロックも取ります。このブロ
 
 {{{
  #!ruby
-  Shoes.app do
+ Shoes.app do
    @slot = stack { para 'Good Morning' }
    timer 3 do
      @slot.prepend { para "Your car is ready." }
@@ -1880,43 +2473,62 @@ clearメソッドはオプションでブロックも取ります。このブロ
 
 == Position of a Slot ==
 
-他のすべての要素と同様に、スロットは作成されたときに整形することやカスタマイズすることができます。
+他のすべての要素と同様に、スロットは作成されたときに整形することやカスタマイズすることが
+できます。
 
 スタックの幅を150ピクセルに設定するためには：
 
 {{{
  #!ruby
  Shoes.app do
-   stack(:width => 150) { para "Now that's precision." }
+   stack width: 150 do
+     background yellow
+     para "Now that's precision." 
+   end
  end
 }}}
 
-それぞれのスタイルの設定は、詳細な設定を手に入れるために利用することのできるメソッドも持っています。（そのため、例えば、`width`メソッドはスロットの幅をピクセルで返します。）
+それぞれのスタイルの設定は、詳細な設定を手に入れるために利用することのできるメソッドも
+持っています。（例えば、`width`メソッドはスロットの幅をピクセルで返します。）
 
 === displace(left: a number, top: a number) » self ===
 
-:displace_leftと:displace_topスタイルの設定のためのショートカットメソッドです。置き換えはレイアウトを変更しないでスロットを移動する便利な方法です。実際には、`top`と`left`メソッドは置き換えを全く報告しません。そのため、通常、置き換えは一時的なアニメーションのためにあります。例えば、適当な位置にボタンを少し移動するなど。
+:displace_leftと:displace_topスタイルの設定のためのショートカットメソッドです。
+置き換えはレイアウトを変更しないでスロットを移動する便利な方法です。
+実際には、`top`と`left`メソッドは置き換えを全く報告しません。
+そのため、通常、置き換えは一時的なアニメーションのためにあります。
+例えば、適当な位置にボタンを少し移動するなど。
 
-`left`と`top`の数は`displace`に送られ、スロット自身のtopとleftの座標に追加されます。topとleftの座標から差し引くには、負数を利用してください。
+`left`と`top`の数は`displace`に送られ、スロット自身のtopとleftの座標に追加されます。
+topとleftの座標から差し引くには、負数を利用してください。
+
+'''注意:''' Green Shoesは`displace`メソッドをサポートしていません。
 
 === gutter() » a number ===
 
-スクロールバーエリアの大きさです。Shoesがスクロールバーを表示する必要があるとき、スクロールバーがウィンドウの端にふれているいくつかの要素を隠してしまうかもしれません。`gutter`はどのくらいのピクセルをスクロールバーが隠すことを期待するかを教えます。
+スクロールバーエリアの大きさです。Shoesがスクロールバーを表示する必要があるとき、
+スクロールバーがウィンドウの端にふれているいくつかの要素を隠してしまうかもしれません。
+`gutter`はどのくらいのピクセルをスクロールバーが隠すことを期待するかを教えます。
 
 これは一般的には、次のように右側に詰め物の要素として利用します：
 
 {{{
  #!ruby
+ # Not yet available
  Shoes.app do
    stack :margin_right => 20 + gutter do
-     para "Insert fat and ratified declaration of independence here..."
+     para "Insert fat and ratified ",
+       "declaration of independence here..."
    end
  end
 }}}
 
+'''注意:''' Green Shoesは`gutter`メソッドをサポートしていません。
+
 === height() » a number ===
 
-スロットの目に見えるピクセルでの垂直の大きさです。そして、スクロールするスロットの場合は、スロットの全体の大きさを得るために`scroll_height()`の利用を必要とするでしょう。
+スロットの目に見えるピクセルでの垂直の大きさです。そして、スクロールするスロットの場合は、
+スロットの全体の大きさを得るために`scroll_height()`の利用を必要とするでしょう。
 
 === hide() » self ===
 
@@ -1924,28 +2536,41 @@ clearメソッドはオプションでブロックも取ります。このブロ
 
 === left() » a number ===
 
-The left pixel location of the slot.  Also known as the x-axis coordinate.
 スロットの位置の左のピクセルです。x-axis座標でも知ることができます。
 
 === move(left, top) » self ===
 
 スロットの左上の角である（left、top）の座標を指定してスロットを移動します。
 
+'''注意:''' Green Shoesは`move`メソッドをサポートしていません。
+
 === remove() » self ===
 
-スロットを削除します。それは表示されなくなり親のコンテンツに記載されなくなります。それは消え去ります。
+スロットを削除します。それは表示されなくなり親のコンテンツに記載されなくなります。
+それは消え去ります。
+
+'''注意:''' Green Shoesは`remove`メソッドをサポートしていません。`clear`メソッドを
+使用して下さい。
 
 === scroll() » true or false ===
 
-スロットにスクロールバーを表示することを許しますか？trueかfalseです。スロットの高さも固定されているときだけスクロールバーが表示されます。
+スロットにスクロールバーを表示することを許しますか？trueかfalseです。
+スロットの高さも固定されているときだけスクロールバーが表示されます。
+
+'''注意:''' Green Shoesは`scroll`メソッドをサポートしていません。
 
 === scroll_height() » a number ===
 
 スクロールによって隠されているすべてを含む、スロット全体の垂直の大きさです。
 
+'''注意:''' Green Shoesは`scroll_height`メソッドをサポートしていません。
+
 === scroll_max() » a number ===
 
-このスロットでスクロールダウンできる上側（top）の座標です。スクロールバーの上側（top）の座標はいつもゼロです。下側（bottom）の座標はスロット全体の高さから1ページのスクロール分を引いたものです。この下側（bottom）の座標は`scroll_max`が返す値です。
+このスロットでスクロールダウンできる上側（top）の座標です。
+スクロールバーの上側（top）の座標はいつもゼロです。
+下側（bottom）の座標はスロット全体の高さから1ページのスクロール分を引いたものです。
+この下側（bottom）の座標は`scroll_max`が返す値です。
 
 これは基本的に`slot.scroll_height - slot.height`と書くためのショートカットです。
 
@@ -1953,12 +2578,17 @@ The left pixel location of the slot.  Also known as the x-axis coordinate.
 
 === scroll_top() » a number ===
 
-スロットがスクロールダウンする上側（top）の座標です。そのため、スロットが20ピクセルスクロールダウンされたら、このメソッドは`20`を返します。
+スロットがスクロールダウンする上側（top）の座標です。
+そのため、スロットが20ピクセルスクロールダウンされたら、このメソッドは`20`を返します。
+
+'''注意:''' Green Shoesは`scroll_top`メソッドをサポートしていません。
 
 === scroll_top = a number ===
 
 任意の座標にスロットをスクロールします。ゼロから`scroll_max`までの間である必要があります。
 
+'''注意:''' Green Shoesは`scroll_top=`メソッドをサポートしていません。
+
 === show() » self ===
 
 スロットが隠されていた場合、表示します。[[Position.hide]]と[[Position.toggle]]も見てください。
@@ -1967,27 +2597,33 @@ The left pixel location of the slot.  Also known as the x-axis coordinate.
 
 引数なしで`style`メソッドを呼ぶことでスロットに現在適用されているスタイルのハッシュを返します。
 
-`height`と`width`などのメソッドはスロットの本当のサイズをピクセルで返しますが、`style[:height]`または`style[:width]`を利用することで初めに要求されたサイズを得ることができます。
+`height`と`width`などのメソッドはスロットの本当のサイズをピクセルで返しますが、
+`style[:height]`または`style[:width]`を利用することで初めに要求されたサイズを
+得ることができます。
 
 {{{
  #!ruby
  Shoes.app do
-   @s = stack :width => "100%"
-   para @s.style[:width]
+   s = stack width: 1.0
+   para s.style[:width]
+   button('Then..'){s.append{para s.style[:width]}}
  end
 }}}
 
-この例では、このスタックの下のパラグラフは"100%"の文字列を表示します。
+この例では、このスタックの下のパラグラフは最初に"1.0"の文字列を表示しますが、ボタンを
+クリックした後は"600"の文字列を表示するでしょう。
 
 === style(styles) » styles ===
 
-ハッシュのスタイル設定を使ってスロットを修正してください。このページのどんなメソッドでも（もちろん、このメソッドは除いて）スタイルの設定に利用できます。そして、例えば、`width`メソッドがあり、このように`width`スタイルもあります。
+ハッシュのスタイル設定を使ってスロットを修正してください。
+このページのどんなメソッドでも（もちろん、このメソッドは除いて）スタイルの設定に利用できます。
+そして、例えば、`width`メソッドがあり、このように`width`スタイルもあります。
 
 {{{
  #!ruby
  Shoes.app do
-   @s = stack { background green }
-   @s.style(:width => 400, :height => 200)
+   s = stack { background green }
+   s.style width: 400, height: 200
  end
 }}}
 
@@ -2005,9 +2641,13 @@ The left pixel location of the slot.  Also known as the x-axis coordinate.
 
 == Traversing the Page ==
 
-スロット内部の要素を最初から最後までループする必要性に気づくかもしれません。または、ページを登って要素の親のスタックを探す必要があるかもしれません。
+スロット内部の要素を最初から最後までループする必要性に気づくかもしれません。
+または、ページを登って要素の親のスタックを探す必要があるかもしれません。
 
-すべての要素で、上位のスロット直接得るために`parent`メソッドを呼ぶことができます。そしてスロットでは、すべての子を得るために`contents`メソッドを呼ぶことができます。（テキストブロックなどのいくつかの要素は、それらの子を得るための`contents`メソッドも持っています。）
+すべての要素で、上位のスロット直接得るために`parent`メソッドを呼ぶことができます。
+そしてスロットでは、すべての子を得るために`contents`メソッドを呼ぶことができます。
+（テキストブロックなどのいくつかの要素は、それらの子を得るための`contents`メソッドも
+持っています。）
 
 === contents() » an array of elements ===
 
@@ -2017,58 +2657,98 @@ The left pixel location of the slot.  Also known as the x-axis coordinate.
 
 要素のコンテナのオブジェクトを得ます。
 
+{{{
+ Shoes.app do
+   s = stack do
+     para 'Green'
+     @p = para 'Shoes'
+   end
+   para s
+   para s.contents
+   para @p.parent
+ end
+}}}
+
 = Elements =
 
-これはShoesの要素です。要素は楕円の形状と同じくらい単純です。またはビデオストリームと同じくらい複雑です。あなたは以前このマニュアルのスロットのセクションでこれらすべての要素に出会ったことがあります。
+これはGreen Shoesの要素です。要素は楕円の形状と同じくらい単純です。
+またはparaのテキスト文字列と同じくらい複雑です。
+あなたは以前このマニュアルのスロットのセクションでこれらすべての要素に出会ったことがあります。
 
-Shoesは7つのネイティブコントロールを持ちます：ボタン（Button）、エディットライン（EditLine）、エディットボックス（EditBox）、リストボックス（ListBox）、プログレスメータ（Progress meter）、チェックボックス（Check box）、ラジオ（Radio）。私たちの言う"native"コントロールとは、それらの7つの要素がオペレーティングシステムによって描画されることを意味します。そのため、プログレスバーのWindowsでの見え方とOS Xでの見え方は違います。
+Green Shoesは7つのネイティブコントロールを持ちます：
+ボタン（Button）、エディットライン（EditLine）、エディットボックス（EditBox）、
+リストボックス（ListBox）、プログレスメータ（Progress meter）、チェックボックス（Check box）、
+ラジオ（Radio）。私たちの言う"native"コントロールとは、それらの7つの要素が
+Ruby/GTK2のAPIを使って直接描画されることを意味します。そのため、プログレスバーでは
+PNG画像データに変換されることなく描画されます。
 
-またShoesは7つの他の種類の要素を持っています：背景（Background）、ボーダー（Border）、画像（Image）、形状（Shape）、テキストブロック（TextBlock）、タイマー（Timer）、そしてビデオ（Video）。それらすべてはどんなオペレーティングシステムでも同じような見え方と動きになるべきです。
+またShoesは7つの他の種類の要素を持っています：背景（Background）、ボーダー（Border）、
+画像（Image）、形状（Shape）、テキストブロック（TextBlock）、タイマー（Animate）、
+そしてビデオ（Video）。それらすべてはどんなオペレーティングシステムでも同じような見え方と
+動きになるべきです。
 
-いったん要素を生成した後でも、それを変更したくなるでしょう。それを動かしたり隠したりまたはそれを取り除くために。それらの種類のことを行うために、このセクションのコマンド利用するでしょう。（特にどんな要素上でも利用できるコマンドの[[Common Common Methods]]セクションを確認してください。）
+いったん要素を生成した後でも、それを変更したくなるでしょう。それを動かしたり隠したり
+またはそれを取り除くために。それらの種類のことを行うために、このセクションのコマンドを
+利用するでしょう。
+（特にどんな要素上でも利用できるコマンドの[[Common Common Methods]]セクションを
+確認してください。）
 
-そして、例として、PNGをスクリーンを配置するためにスロットの`image`メソッドを使ってください。この`image`メソッドはイメージオブジェクトを返します。これらをすっかり変更するためにイメージオブジェクトのこのメソッドを使ってみてください。
+そして、例として、PNGをスクリーンを配置するためにスロットの`image`メソッドを使ってください。
+この`image`メソッドはイメージオブジェクトを返します。
+これらをすっかり変更するためにイメージオブジェクトのこのメソッドを使ってみてください。
 
 == Common Methods ==
 
-Shoesでは少しのメソッドがすべての小さな要素によって共有されてます。移動、表示、非表示。要素の削除。基本的でとても一般的なことです。この一覧はそれらの一般的なコマンドを含んでいます。
+Green Shoesでは少しのメソッドがすべての小さな要素によって共有されてます。
+移動、表示、非表示。要素の削除。基本的でとても一般的なことです。
+この一覧はそれらの一般的なコマンドを含んでいます。
 
-すべてのメソッドの中でもっとも一般的なメソッドの一つは`style`です。（これはスロットの[[Position.style]]メソッドとしてもカバーされます。）
+すべてのメソッドの中でもっとも一般的なメソッドの一つは`style`です。
+（これはスロットの[[Position.style]]メソッドとしてもカバーされます。）
 
 {{{
  #!ruby
  Shoes.app do
    stack do
-     # Background, text and a button: both are elements!
+     # Background, text and a button: 
+     # both are elements!
      @back  = background green
      @text  = banner "A Message for You, Rudy"
      @press = button "Stop your messin about!"
-
+ 
      # And so, both can be styled.
-     @text.style :size => 12, :stroke => red, :margin => 10
-     @press.style :width => 400
-     @back.style :height => 10
+     @text.style size: 12, 
+       markup: fg(@text.text, red), margin: 10
+     @press.style width: 400
+     @back.style height: 10
    end
  end
 }}}
 
-個別のコマンドについては、左にあるElementsセクションの他のリンクを見てください。ビデオファイルの中断または再生がしたいなら、ビデオの中断や再生は特異なので、[[Video]]セクションを確認してください。中断するボタンという感じではありません。
+個別のコマンドについては、左にあるElementsセクションの他のリンクを見てください。
+ビデオファイルの中断または再生がしたいなら、ビデオの中断や再生は特異なので、
+[[Video]]セクションを確認してください。中断するボタンという感じではありません。
 
 === displace(left: a number, top: a number) » self ===
 
-要素を移動して置き換えます。しかし周囲のレイアウトは変更しません。特にアニメーションしている間でも要素の位置を保持したいなら、これは微妙なアニメーションに重要です。おそらく素早く震えるボタンや視界にスロットを滑り込ませるような。
+要素を移動して置き換えます。しかし周囲のレイアウトは変更しません。
+特にアニメーションしている間でも要素の位置を保持したいなら、これは微妙なアニメーションに
+重要です。おそらく素早く震えるボタンや視界にスロットを滑り込ませるような。
 
-要素を置き換えるとき、それが配置されている左上の角から相対的に移動します。そのため、要素が(20, 40)の座標にあり、2ピクセル左と6ピクセル上に置き換えるなら、結果的に(22, 46)の座標となります。
+要素を置き換えるとき、それが配置されている左上の角から相対的に移動します。
+そのため、要素が(20, 40)の座標にあり、2ピクセル左と6ピクセル上に置き換えるなら、
+結果的に(22, 46)の座標となります。
 
 {{{
  #!ruby
+ # Not yet available
  Shoes.app do
    flow :margin => 12 do
      # Set up three buttons
      button "One"
      @two = button "Two"
      button "Three"
-
+ 
      # Bounce the second button
      animate do |i|
        @two.displace(0, (Math.sin(i) * 6).to_i)
@@ -2077,21 +2757,31 @@ Shoesでは少しのメソッドがすべての小さな要素によって共有
  end
 }}}
 
-他の２つのボタンは動かずにじっとしていますが、２番目のボタンが飛び跳ねることに注目してください。この状況で普通の`move`を使うなら、２番目のボタンはレイアウトから取り除かれて、２番目のボタンが全くそこにないかのように振る舞うでしょう。（[[Common.move]]の例を見てください。）
+他の２つのボタンは動かずにじっとしていますが、２番目のボタンが飛び跳ねることに
+注目してください。この状況で普通の`move`を使うなら、２番目のボタンはレイアウトから
+取り除かれて、２番目のボタンが全くそこにないかのように振る舞うでしょう。
+（[[Common.move]]の例を見てください。）
+
+'''特に注意してください：'''表示される要素の座標を得るために`left`と`top`メソッドを
+利用するなら、通常の座標を得るだけです。それは置き換えが行われていないかのようです。
+置き換えは即座のアニメーションだけを目的とします。
 
-'''特に注意してください：'''表示される要素の座標を得るために`left`と`top`メソッドを利用するなら、通常の座標を得るだけです。それは置き換えが行われていないかのようです。置き換えは即座のアニメーションだけを目的とします。
+'''注意:''' Green Shoesは`displace`メソッドをサポートしていません。
 
 === height() » a number ===
 
-エレメントの垂直のピクセルによるスクリーンサイズです。画像の場合には、これは画像全体のサイズではありません。これは要素の現在表示されている高さです。
+エレメントの垂直のピクセルによるスクリーンサイズです。画像の場合には、これは画像全体の
+サイズではありません。これは要素の現在表示されている高さです。
 
-150x150ピクセルの画像を持っていて50ピクセルに幅を設定するなら、このメソッドは50を返します。
+150x150ピクセルの画像を持っていて50ピクセルに幅を設定するなら、このメソッドは50を
+返します。
 
 例や他の解説のために[[Common.width]]メソッドも見てください。
 
 === hide() » self ===
 
-要素が見えないように、非表示にします。[[Common.show]]や[[Common.toggle]]も見てください。
+要素が見えないように、非表示にします。[[Common.show]]や[[Common.toggle]]も
+見てください。
 
 === left() » a number ===
 
@@ -2099,34 +2789,39 @@ Shoesでは少しのメソッドがすべての小さな要素によって共有
 
 === move(left: a number, top: a number) » self  ===
 
-スロットの範囲内でピクセルによって指定した位置に要素を移動します。その要素はスロットの内部にあります。しかし、もはやスロットの他の要素と一緒に積み上げられたりフローされたりしません。その要素は絶対的な位置指定ではなく、自由に浮かんでいます。
+スロットの範囲内でピクセルによって指定した位置に要素を移動します。
+その要素はスロットの内部にあります。しかし、もはやスロットの他の要素と一緒に
+積み上げられたりフローされたりしません。その要素は絶対的な位置指定ではなく、
+自由に浮かんでいます。
 
 {{{
  #!ruby
  Shoes.app do
-   flow :margin => 12 do
-     # Set up three buttons
-     button "One"
-     @two = button "Two"
-     button "Three"
-
-     # Bounce the second button
-     animate do |i|
-       @two.move(40, 40 + (Math.sin(i) * 6).to_i)
-     end
+   # Set up three buttons
+   b = button "One"
+   @two = button "Two"
+   button "Three"
+ 
+   # Bounce the second button
+   animate do |i|
+     @two.move(33, 33 + (Math.sin(i) * 6).to_i)
    end
  end
 }}}
 
-３番目のボタンがその位置にスライドすることを許しており、２番目のボタンは特定の場所に動かされてします。要素を別の場所に変更しないで移動したいなら、[[Common.displace]]メソッドを見てください。
+３番目のボタンがその位置にスライドすることを許しており、２番目のボタンは特定の場所に
+動かされてします。要素を別の場所に変更しないで移動したいなら、
+[[Common.displace]]メソッドを見てください。
 
 === parent() » a Shoes::Stack or Shoes::Flow ===
 
-その要素のコンテナのオブジェクトを得ます。反対のことを行うためにはスロットの[[Traversing.contents]]も見てください：コンテナの要素を得ます。
+その要素のコンテナのオブジェクトを得ます。反対のことを行うためにはスロットの
+[[Traversing.contents]]も見てください：コンテナの要素を得ます。
 
 === remove() » self ===
 
-スロットから要素を削除します。（他の言葉で言い換えると：ガベージに投げます。）その要素はもう表示されません。
+スロットから要素を削除します。（他の言葉で言い換えると：ガベージに投げます。）
+その要素はもう表示されません。
 
 === show() » self ===
 
@@ -2134,14 +2829,18 @@ Shoesでは少しのメソッドがすべての小さな要素によって共有
 
 === style() » styles ===
 
-ハッシュの形で、要素に適用するフルセットのスタイルを得ます。`width`や`height`や`top`のようなメソッドは特定のピクセルでのサイズを返しますが、`style[:width]`または`style[:top]`を利用すると、初めの設定を得ることができます。（"100%"の幅または"10px"のトップのような）
+ハッシュの形で、要素に適用するフルセットのスタイルを得ます。`width`や`height`や
+`top`のようなメソッドは特定のピクセルでのサイズを返しますが、`style[:width]`または
+`style[:top]`を利用すると、初めの設定を得ることができます。
+（"100%"の幅または"10px"のトップのような）
 
 {{{
  #!ruby
  Shoes.app do
    # A button which take up the whole page
-   @b = button "All of it", :width => 1.0, :height => 1.0
-
+   @b = button "All of it", 
+     width: width, height: height
+ 
    # When clicked, show the styles
    @b.click { alert(@b.style.inspect) }
  end
@@ -2149,7 +2848,8 @@ Shoesでは少しのメソッドがすべての小さな要素によって共有
 
 === style(styles) » styles ===
 
-要素のスタイルを変更します。これは要素の`:width`と`:height`、テキストのフォントの`:size`、形状の`:stroke`や`:fill`を含みます。または他の多くのスタイルの設定もです。
+要素のスタイルを変更します。これは要素の`:width`と`:height`、テキストのフォントの
+`:size`、形状の`:stroke`や`:fill`を含みます。または他の多くのスタイルの設定もです。
 
 === toggle() » self ===
 
@@ -2161,33 +2861,41 @@ Shoesでは少しのメソッドがすべての小さな要素によって共有
 
 === width() » a number ===
 
-要素の全体の大きさの幅をピクセルで得ます。このメソッドはいつも正確なピクセルサイズを返します。画像の場合は、画像の全幅ではなく、表示されているサイズだけです。詳しくは[[Common.height]]メソッドも見てください。
+要素の全体の大きさの幅をピクセルで得ます。
+このメソッドはいつも正確なピクセルサイズを返します。
+画像の場合は、画像の全幅ではなく、表示されているサイズだけです。
+詳しくは[[Common.height]]メソッドも見てください。
 
-また、120ピクセルの幅のスタック内に100%の幅の要素を作成したなら、`120`が返されます。しかしながら、`style[:width]`を呼んだなら、`"100%"`を得ます。
+また、120ピクセルの幅のスタック内に1.0の幅の要素を作成したなら、`120`が返されます。
+`style[:width]`を呼んだなら、`120`を得ます。
 
 {{{
  #!ruby
  Shoes.app do
-   stack :width => 120 do
-     @b = button "Click me", :width => "100%" do
+   stack width: 120 do
+     @b = button "Click me", width: 1.0 do
        alert "button.width = #{@b.width}\n" +
-         "button.style[:width] = #{@b.style[:width]}"
+         "button.style[:width] = " +
+         "#{@b.style[:width]}"
      end
    end
  end
 }}}
 
-幅を設定するためには、[[Common.style]]メソッドをもう一度調べる必要があります。そして、150ピクセルの幅にボタンを設定するには：`@b.style(:width => 150)`。
-
-要素の幅を取るには、設定を空にするために`@b.style(:width => nil)`とします
+幅を設定するためには、[[Common.style]]メソッドをもう一度調べる必要があります。
+そして、150ピクセルの幅にボタンを設定するには：`@b.style(width: 150)`。
 
 == Background ==
 
-背景はスロット全体に渡って塗られた、グラデーションまたは画像の色です。背景と枠線はShoes::Patternの種類の一つです。!{:margin_left => 100}man-ele-background.png!
+背景はスロット全体に渡って塗られた、グラデーションまたは画像の色です。
+背景と枠線はShoes::Patternの種類の一つです。!{:margin_left => 100}man-ele-background.png!
 
-''背景（background）''と呼ばれているにも関わらず、この要素は他の要素よりも前面に表示されます。背景がスロットで塗られた何か他のもの（`rect`または`oval`のような）の後にきた場合、背景はその要素の上に塗られます。
+''背景（background）''と呼ばれているにも関わらず、この要素は他の要素よりも前面に
+表示されます。背景がスロットで塗られた何か他のもの（`rect`または`oval`のような）の
+後にきた場合、背景はその要素の上に塗られます。
 
-もっとも単純な背景は、黒の背景のような[[Element.background]]メソッドによって作成された、単色の背景です。
+もっとも単純な背景は、黒の背景のような[[Element.background]]メソッドによって作成された、
+単色の背景です。
 
 {{{
  #!ruby
@@ -2196,7 +2904,8 @@ Shoesでは少しのメソッドがすべての小さな要素によって共有
  end
 }}}
 
-このような単純な背景はスロットが含むもの全体を塗りつぶします（この場合は、ウィンドウ全体が黒で塗られます。）
+このような単純な背景はスロットが含むもの全体を塗りつぶします
+（この場合は、ウィンドウ全体が黒で塗られます。）
 
 好きなように背景のサイズを切り詰めたりあちこち移動したりするためのスタイルを利用できます。
 
@@ -2205,7 +2914,7 @@ Shoesでは少しのメソッドがすべての小さな要素によって共有
 {{{
  #!ruby
  Shoes.app do
-   background black, :height => 50
+   background black, height: 50
  end
 }}}
 
@@ -2214,61 +2923,79 @@ Shoesでは少しのメソッドがすべての小さな要素によって共有
 {{{
  #!ruby
  Shoes.app do
-   background black, :width => 50, :right => 50
+   background black, width: 50
  end
 }}}
 
-背景は普通の要素と同様なので、その他のすべてのメソッドについては[[Elements]]セクションの始めの部分も見てください。
+背景は普通の要素と同様なので、その他のすべてのメソッドについては[[Elements]]セクションの
+始めの部分も見てください。
 
 === to_pattern() » a Shoes::Pattern ===
 
-背景を塗りつぶすために利用されたグラデーションや画像を通常のShoes::Patternオブジェクトに配置し、色をヤンクします。そして、他のオブジェクトに背景や枠線に渡すことができます。好きなように再利用してください。
+背景を塗りつぶすために利用されたグラデーションや画像を通常のShoes::Patternオブジェクトに
+配置し、色をヤンクします。そして、他のオブジェクトに背景や枠線に渡すことができます。
+好きなように再利用してください。
+
+'''注意:''' Green Shoesは`to_pattern`メソッドをサポートしていません。
 
 == Border ==
 
-枠線はスロットの周囲の線に塗られた、色やグラデーションや画像です。次のセクションの背景の要素では、枠線（Border）はShoes::Patternの一種です。!{:margin_left => 100}man-ele-border.png!
+枠線はスロットの周囲の線に塗られた、色やグラデーションや画像です。
+前のセクションの背景（background）と同様に、枠線（Border）はShoes::Patternの一種です。
+!{:margin_left => 100}man-ele-border.png!
 
-はじめに、すべての枠線はスロットの周囲の外側ではなく、'''内側'''を塗ることについて知ることは重要です。そのため、50ピクセルの幅のスロットに5ピクセルの枠線を塗るなら、それは枠線で囲まれたスロットが内部に40ピクセルの幅のエリアを持つことを意味します。
+はじめに、すべての枠線はスロットの周囲の外側ではなく、'''内側'''を塗ることについて知ることは
+重要です。そのため、50ピクセルの幅のスロットに5ピクセルの枠線を塗るなら、それは枠線で
+囲まれたスロットが内部に40ピクセルの幅のエリアを持つことを意味します。
 
-これは枠線（Border）を[[Background]]の上に塗るなら、その背景の端の上を枠線によって塗られることも意味します。
+これは枠線（Border）を[[Background]]の上に塗るなら、その背景の端の上を枠線によって
+塗られることも意味します。
 
 正にそのようなスロットがここにあります：
 
 {{{
  #!ruby
  Shoes.app do
-   stack :width => 50 do
-     border black, :strokewidth => 5
-     para "=^.^=", :stroke => green
+   stack width: 50 do
+     border black, strokewidth: 5
+     para fg "=^.^=", green
    end
  end
 }}}
 
-スロットの外側の修正に枠線を塗りたいなら、もう一つのスロットでそのスロットをラップする必要があります。その結果、スロットの外側に枠線が配置されます。
+スロットの外側の修正に枠線を塗りたいなら、もう一つのスロットでそのスロットをラップする
+必要があります。その結果、スロットの外側に枠線が配置されます。
 
 {{{
  #!ruby
  Shoes.app do
-   stack :width => 60 do
-     border black, :strokewidth => 5
-     stack :width => 50 do
-       para "=^.^=", :stroke => green
+   stack width: 60 do
+     border black, strokewidth: 5
+     stack width: 50 do
+       para fg "=^.^=", green
      end
    end
  end
 }}}
 
-HTMLや他の多くの言語では、枠線は箱の外側に塗られるため、ボックス全体の幅が増加します。Shoesは一貫性を考慮してデザインされているため、枠線やマージンや他のどんなものも気にしないでそれは50ピクセルの幅のままです。
+HTMLや他の多くの言語では、枠線は箱の外側に塗られるため、ボックス全体の幅が
+増加します。Green Shoesは一貫性を考慮してデザインされているため、枠線や
+マージンや他のどんなものも気にしないでそれは50ピクセルの幅のままです。
 
 枠線に利用する他のメソッドについては[[Elements]]セクションも確認してください。
 
 === to_pattern() » a Shoes::Pattern ===
 
-枠線を塗るための色、グラデーションまたは画像を元にした基本のパターンオブジェクトを作成します。
+枠線を塗るための色、グラデーションまたは画像を元にした基本のパターンオブジェクトを
+作成します。
+
+'''注意:''' Green Shoesは`to_pattern`メソッドをサポートしていません。
 
 == Button ==
 
-ボタン（Button）は、ご存知のとおり、押しボタンです。それらをクリックしたら何かを行います。ボタンは"OK"または"Are you sure?"などを表示します。そして、よければボタンをクリックします。
+ボタン（Button）は、ご存知のとおり、押しボタンです。それらをクリックしたら何かを行います。
+ボタンは"OK"または"Are you sure?"などを表示します。そして、よければボタンをクリックします。
+!{:margin_left => 100}man-ele-button.png!
 
 {{{
  #!ruby
@@ -2278,7 +3005,8 @@ HTMLや他の多くの言語では、枠線は箱の外側に塗られるため
  end
 }}}
 
-上記の例のボタンはそれらがクリックされたときに何も行いません。働きを行わせるためには、それぞれのボタンにブロックを取り付けます。
+上記の例のボタンはそれらがクリックされたときに何も行いません。
+働きを行わせるためには、それぞれのボタンにブロックを取り付けます。
 
 {{{
  #!ruby
@@ -2292,7 +3020,9 @@ HTMLや他の多くの言語では、枠線は箱の外側に塗られるため
  end
 }}}
 
-このようにボタンにブロックを取り付けました。それぞれのブロックはページに新しいパラグラフを取り付けます。クリックする度に、パラグラフが追加されます。
+このようにボタンにブロックを取り付けました。
+それぞれのブロックはページに新しいパラグラフを取り付けます。
+クリックする度に、パラグラフが追加されます。
 
 これはこれ以上深くはしません。ボタンはクリック可能な句でしかありません。
 
@@ -2302,29 +3032,39 @@ HTMLや他の多くの言語では、枠線は箱の外側に塗られるため
  #!ruby
  Shoes.app do
    @b1 = button "OK!"
-   @b1.click { para "Well okay then." }
+   @b1.click{para "Well okay then."}
    @b2 = button "Are you sure?"
-   @b2.click { para "Your confidence is inspiring." }
+   @b2.click{para "Your confidence is inspiring."}
  end
 }}}
 
-見た目は劇的に違いますが、これは同じ動きです。１つ目の違い：直接ブロックをボタンに取り付けるのではなく、`click`メソッドを通して、ブロックを後で取り付けています。
+見た目は劇的に違いますが、これは同じ動きです。
+１つ目の違い：直接ブロックをボタンに取り付けるのではなく、`click`メソッドを通して、
+ブロックを後で取り付けています。
 
-２つ目の違いはボタンには全く関係がありません。Shoesがスロットに要素を直接追加することを許しているので、`append`ブロックが取り除かれています。そのため直接`para`を呼ぶことができます。（`prepend`、`before`または`after`メソッドの場合にはできません。）
+２つ目の違いはボタンには全く関係がありません。Green Shoesがスロットに要素を直接
+追加することを許しているので、`append`ブロックが取り除かれています。
+そのため直接`para`を呼ぶことができます。（`prepend`、`before`または
+`after`メソッドの場合にはできません。）
 
 以下のメソッドに加えて、ボタンは[[Common]]のすべてのメソッドも継承します。
 
 === click() { |self| ... } » self ===
 
-ボタンがクリックされたときには、`click`ブロックが呼ばれます。このブロックは`self`を渡します。意味すること：どちらのボタンでクリックされたか。
+ボタンがクリックされたときには、`click`ブロックが呼ばれます。
+このブロックは`self`を渡します。意味すること：どちらのボタンでクリックされたか。
 
 === focus() » self ===
 
-ボタンのフォーカスを移動します。そのボタンはハイライトされ、ユーザがエンターキーを打てば、クリックされます。
+ボタンのフォーカスを移動します。
+そのボタンはハイライトされ、ユーザがエンターキーを打てば、クリックされます。
 
 == Check ==
 
-チェックボックスはチェックされた状態またはチェックされていない状態になるクリック可能な四角い箱です。１つのチェックボックスでは通常は"はい（yes）"または"いいえ（no）"の質問をたずねます。複数のチェックボックスのセットではto-doリストでも見られます。
+チェックボックスはチェックされた状態またはチェックされていない状態になるクリック可能な
+四角い箱です。１つのチェックボックスでは通常は"はい（yes）"または"いいえ（no）"の
+質問をたずねます。複数のチェックボックスのセットではto-doリストでも見られます。
+!{:margin_left => 100}man-ele-check.png!
 
 ここにチェックリストのサンプルがあります。
 
@@ -2332,14 +3072,24 @@ HTMLや他の多くの言語では、枠線は箱の外側に塗られるため
  #!ruby
  Shoes.app do
    stack do
-     flow { check; para "Frances Johnson" }
-     flow { check; para "Ignatius J. Reilly" }
-     flow { check; para "Winston Niles Rumfoord" }
+     flow do
+       check; para "Frances Johnson", width: 200
+     end
+     flow do
+       check; para "Ignatius J. Reilly", width: 200
+     end
+     flow do
+       check
+       para "Winston Niles Rumfoord", width: 200
+     end
    end
  end
 }}}
 
-基本的にはチェック（check）を利用するための２つの方法があります。チェックにチェックがクリックされたときに呼ばれるブロックを取り付けます。そして／または、ボックスがチェックされているかどうか確認する`checked?`メソッドを利用できます。
+基本的にはチェック（check）を利用するための２つの方法があります。
+チェックにチェックがクリックされたときに呼ばれるブロックを取り付けます。
+そして／または、ボックスがチェックされているかどうか確認する`checked?`メソッドを
+利用できます。
 
 では、上記の例に追加しましょう。
 
@@ -2348,81 +3098,100 @@ HTMLや他の多くの言語では、枠線は箱の外側に塗られるため
  Shoes.app do
    @list = ['Frances Johnson', 'Ignatius J. Reilly',
      'Winston Niles Rumfoord']
-
+ 
    stack do
      @list.map! do |name|
-       flow { @c = check; para name }
+       flow { @c = check; para name, width: 200 }
        [@c, name]
      end
-
+ 
      button "What's been checked?" do
-       selected = @list.map { |c, name| name if c.checked? }.compact
+       selected = 
+         @list.map{|c, n| n if c.checked?}.compact
        alert("You selected: " + selected.join(', '))
      end
    end
  end
 }}}
 
-そして、ボタンが押されたときに、`checked?`メソッドを利用して、それぞれのチェックはその状態を尋ねます。
+そして、ボタンが押されたときに、`checked?`メソッドを利用して、それぞれのチェックは
+その状態を尋ねます。
 
-下のボタンメソッドの一覧だけでなく、すべての要素が応答できる、[[Common]]メソッドの一覧も見てください。
+下のボタンメソッドの一覧だけでなく、すべての要素が応答できる、[[Common]]メソッドの
+一覧も見てください。
 
 === checked?() » true or false ===
 
-その箱がチェックされているかどうかを返します。そして、`true`の意味は"はい、この箱はチェックされています！"です。
+その箱がチェックされているかどうかを返します。
+そして、`true`の意味は"はい、この箱はチェックされています！"です。
 
 === checked = true or false ===
 
-チェックボックスをマークしたりマークを外したりします。例えば、`checked = false`を利用して、箱のチェックを外します。
+チェックボックスをマークしたりマークを外したりします。
+例えば、`checked = false`を利用して、箱のチェックを外します。
 
 === click() { |self| ... } » self ===
 
-チェックボックスがクリックされたときに、その`click`ブロックが呼ばれます。このブロックは、クリックされたチェックボックスオブジェクトの`self`を渡します。
+チェックボックスがクリックされたときに、その`click`ブロックが呼ばれます。
+このブロックは、クリックされたチェックボックスオブジェクトの`self`を渡します。
 
 箱がチェックされるときとチェックを外すときのどちらもクリックが渡されます。
 
 === focus() » self ===
 
-チェックボックスにフォーカスを移動します。そのチェックボックスはハイライトされ、ユーザがエンターキーを打てば、そのチェックボックスはチェックされた状態とチェックされていない状態の間をトグルします。
+チェックボックスにフォーカスを移動します。そのチェックボックスはハイライトされ、
+ユーザがエンターキーを打てば、そのチェックボックスはチェックされた状態とチェックされていない
+状態の間をトグルします。
 
 == EditBox ==
 
-エディットボックス（Edit box）は、テキストを入力するための幅広い長方形の箱です。webでは、それらはテキストエリアと呼ばれます。それらは長い記述を入力するためのマルチラインエディットボックスです。エッセイでさえ書けます！　!{:margin_left => 100}man-ele-editbox.png!
+エディットボックス（Edit box）は、テキストを入力するための幅広い長方形の箱です。
+webでは、それらはテキストエリアと呼ばれます。それらは長い記述を入力するための
+マルチラインエディットボックスです。エッセイでさえ書けます！
+!{:margin_left => 100}man-ele-editbox.png!
 
-スタイルを何も設定しなければ、エディットボックスは200ピクセルx108ピクセルのサイズです。特定のサイズに設定するために`:width`と`:height`のスタイルを利用することもできます。
+スタイルを何も設定しなければ、エディットボックスは200ピクセルx108ピクセルのサイズです。
+特定のサイズに設定するために`:width`と`:height`のスタイルを利用することもできます。
 
 {{{
  #!ruby
  Shoes.app do
    edit_box
-   edit_box :width => 100, :height => 100
+   edit_box width: 100, height: 100
  end
 }}}
 
-（[[Button]]や[[Check]]などの）他のコントロールはクリックイベントだけを持っていますが、[[EditLine]]やエディットボックス（EditBox）は`change`イベントも持っています。誰かがタイプしたり箱から削除したら`change`のブロックはいつでも呼ばれます。
+（[[Button]]や[[Check]]などの）他のコントロールはクリックイベントだけを持っていますが、
+[[EditLine]]やエディットボックス（EditBox）は`change`イベントも持っています。
+誰かがタイプしたり箱から削除したら`change`のブロックはいつでも呼ばれます。
 
 {{{
  #!ruby
  Shoes.app do
    edit_box do |e|
-     @counter.text = e.text.size
+     @counter.text = 
+       strong("#{e.text.size}") + " characters"
    end
-   @counter = strong("0")
-   para @counter, " characters"
+   @counter = para strong("0"), " characters"
  end
 }}}
 
-この例ではブロック内部で[[EditBox.text]]メソッドを利用していることにも注意してください。このメソッドは箱に対してタイプしたすべての文字の文字列をあなたに与えます。
+この例ではブロック内部で[[EditBox.text]]メソッドを利用していることにも注意してください。
+このメソッドは箱に対してタイプしたすべての文字の文字列をあなたに与えます。
 
-エディットボックスの更なるメソッドは以下に一覧にしますが、すべての要素が応答できる、[[Common]]メソッドの一覧も見てください。
+エディットボックスの更なるメソッドは以下に一覧にしますが、すべての要素が応答できる、
+[[Common]]メソッドの一覧も見てください。
 
 === change() { |self| ... } » self ===
 
-エディットボックスに文字が追加されたり取り除かれるたびに、`chenage`ブロックが呼ばれます。ブロックには変更されたエディットボックスのオブジェクトである`self`が与えられます。
+エディットボックスに文字が追加されたり取り除かれるたびに、`chenage`ブロックが
+呼ばれます。ブロックには変更されたエディットボックスのオブジェクトである`self`が
+与えられます。
 
 === focus() » self ===
 
-エディットボックスにフォーカスを移動します。そのエディットボックスはハイライトされ、ユーザはエディットボックスにタイプできます。
+エディットボックスにフォーカスを移動します。そのエディットボックスはハイライトされ、
+ユーザはエディットボックスにタイプできます。
 
 === text() » self ===
 
@@ -2434,31 +3203,43 @@ HTMLや他の多くの言語では、枠線は箱の外側に塗られるため
 
 == EditLine ==
 
-エディットライン（Edit line）は細長い、小さなテキストを入力する箱です。エディットボックスはマルチラインですが、エディットラインは１行です。これはエディットラインです。ちなみに水平です。
+エディットライン（Edit line）は細長い、小さなテキストを入力する箱です。
+エディットボックスはマルチラインですが、エディットラインは１行です。
+これはエディットラインです。ちなみに水平です。
+!{:margin_left => 100}man-ele-editline.png!
 
-スタイルが設定されていないエディットラインは200ピクセルの幅と28ピクセルの高さです。これはおおよそです。プラットフォームによって高さは様々です。
+スタイルが設定されていないエディットラインは200ピクセルの幅と28ピクセルの高さです。
+これはおおよそです。プラットフォームによって高さは様々です。
 
 {{{
  #!ruby
  Shoes.app do
    stack do
      edit_line
-     edit_line :width => 400
+     edit_line width: 400
    end
  end
 }}}
 
-`:width`と`:height`の両方のスタイルを設定することによりサイズを変更することができます。しかしながら、高さはフォントに合わせて調整されるため、一般的には`:width`だけのスタイルを設定します。（そして、現在のバージョンのShoesでは、エディットラインとエディットボックスフォントはどうやっても変更できません。）
+`:width`と`:height`の両方のスタイルを設定することによりサイズを変更することができます。
+しかしながら、高さはフォントに合わせて調整されるため、一般的には`:width`だけの
+スタイルを設定します。（そして、現在のバージョンのGreen Shoesでは、エディットラインと
+エディットボックスフォントはどうやっても変更できません。）
 
-エディットラインにブロックが与えられたら、`change`イベントを受けとります。changeブロックを利用した例については[[EditBox]]のページを確認してください。実際には、そのエディットボックスはエディットラインとすべて同じメソッドを持ちます。すべての要素が応答できる、[[Common]]メソッドの一覧も見てください。
+エディットラインにブロックが与えられたら、`change`イベントを受けとります。
+changeブロックを利用した例については[[EditBox]]のページを確認してください。
+実際には、そのエディットボックスはエディットラインとすべて同じメソッドを持ちます。
+すべての要素が応答できる、[[Common]]メソッドの一覧も見てください。
 
 === change() { |self| ... } » self ===
 
-エディットラインに文字が追加されたり取り除かれるたびに、`chenage`ブロックが呼ばれます。ブロックには変更されたエディットラインのオブジェクトである`self`が与えられます。
+エディットラインに文字が追加されたり取り除かれるたびに、`chenage`ブロックが呼ばれます。
+ブロックには変更されたエディットラインのオブジェクトである`self`が与えられます。
 
 === focus() » self ===
 
-エディットラインにフォーカスを移動します。そのエディットラインはハイライトされ、ユーザはエディットラインにタイプできます。
+エディットラインにフォーカスを移動します。そのエディットラインはハイライトされ、
+ユーザはエディットラインにタイプできます。
 
 === text() » self ===
 
@@ -2470,7 +3251,9 @@ HTMLや他の多くの言語では、枠線は箱の外側に塗られるため
 
 == Image ==
 
-画像（image）はPNG、JPEGまたはGIFフォーマットの画像ファイルです。Shoesは画像をリサイズまたはテキストとともにそれらをフローすることができます。!{:margin_left => 100}man-ele-image.png!
+画像（image）はPNG、JPEGまたはGIFフォーマットの画像ファイルです。
+Green Shoesは画像をリサイズまたはテキストとともにそれらをフローすることができます。
+!{:margin_left => 100}man-ele-image.png!
 
 画像を作成するために、スロット内部で`image`メソッドを利用します：
 
@@ -2478,34 +3261,49 @@ HTMLや他の多くの言語では、枠線は箱の外側に塗られるため
  #!ruby
  Shoes.app do
    para "Nice, nice, very nice.  Busy, busy, busy."
-   image "static/shoes-manual-apps.gif"
+   image File.join DIR,
+     "../static/shoes-manual-apps.png"
   end
 }}}
 
-Shoesに何らかの画像をロードしたとき、それはメモリにキャッシュされます。それは、同じファイルの画像の要素をたくさんロードした場合でも、それは実際には１回だけファイルをロードすることを意味します。
+Green Shoesに何らかの画像をロードしたとき、それはメモリにキャッシュされます。
+それは、同じファイルの画像の要素をたくさんロードした場合でも、それは実際には
+１回だけファイルをロードすることを意味します。
 
 webのURLを直接利用することもできます。
 
 {{{
  #!ruby
  Shoes.app do
-   image "http://hacketyhack.heroku.com/images/logo.png"
+   image "http://is.gd/c0mBtb"
  end
 }}}
 
-webから画像がロードされたとき、それはハードディスクドライブとメモリの両方にキャッシュされます。これは画像が変更されなければ再度ダウンロードをすることを防止します。（不思議に思う場合：正にブラウザが行うetagのようにShoesは変更時間の軌跡を保持します。）
+webから画像がロードされたとき、それはハードディスクドライブとメモリの両方にキャッシュ
+されます。これは画像が変更されなければ再度ダウンロードをすることを防止します。
+（不思議に思う場合：正にブラウザが行うetagのようにShoesは変更時間の軌跡を
+保持します。）
+
+'''注意:''' Green Shoesは、Red Shoesのようなハードドライブキャッシュ管理機能を
+サポートしていません。
 
-Shoesはバックグラウンドでシステムのスレッドを使ってリモートの画像もロードします。そのため、リモートの画像を利用することはRubyを妨げることはなく、またどんな強烈なグラフィカルな表示でも進み続けるでしょう。
+Green Shoesはバックグラウンドでシステムのスレッドを使ってリモートの画像もロードします。
+そのため、リモートの画像を利用することはRubyを妨げることはなく、またどんな強烈な
+グラフィカルな表示でも進み続けるでしょう。
 
 === full_height() » a number ===
 
-画像全体のピクセルでの高さです。通常は、ピクセルでの画像の高さを知るために[[Common.height]]メソッドを利用できます。しかし画像がリサイズされていたりより大きいサイズなどにスタイルが設定されていた場合は、`height`は変更されたサイズを返します。
+画像全体のピクセルでの高さです。通常は、ピクセルでの画像の高さを知るために
+[[Common.height]]メソッドを利用できます。しかし画像がリサイズされていたり
+より大きいサイズなどにスタイルが設定されていた場合は、`height`は変更された
+サイズを返します。
 
 `full_height`メソッドは保存されたオリジナルファイルの画像の（ピクセルでの）高さを与えます。
 
 === full_width() » a number ===
 
-画像全体のピクセルでの幅です。[[Common.width]]ではなくこのメソッドを使う理由の説明については[[Image.full_height]]メソッドを見てください。
+画像全体のピクセルでの幅です。[[Common.width]]ではなくこのメソッドを使う理由の
+説明については[[Image.full_height]]メソッドを見てください。
 
 === path() » a string ===
 
@@ -2517,50 +3315,63 @@ Shoesはバックグラウンドでシステムのスレッドを使ってリモ
 
 == ListBox ==
 
-リストボックス（List box）（環境によって"コンボボックス（combo box）"または"ドロップダウンボックス（drop-down box）"または"セレクトボックス（select box）"とも呼ばれています。）は箱をクリックしたときドロップダウンしてオプションが一覧として表示されます。!{:margin_left => 100}man-ele-listbox.png!
+リストボックス（List box）（環境によって"コンボボックス（combo box）"または
+"ドロップダウンボックス（drop-down box）"または"セレクトボックス（select box）"とも
+呼ばれています。）は箱をクリックしたときドロップダウンしてオプションが一覧として表示されます。
+!{:margin_left => 100}man-ele-listbox.png!
 
-リストボックスは配列からオプションを取得します。配列（リスト）の文字列は、`:items`スタイルに渡されます。
+リストボックスは配列からオプションを取得します。
+配列（リスト）の文字列は、`:items`スタイルに渡されます。
 
 {{{
  #!ruby
  Shoes.app do
    para "Choose a fruit:"
-   list_box :items => ["Grapes", "Pears", "Apricots"]
+   list_box items: ["Grapes", "Pears", "Apricots"]
  end
 }}}
 
-そして、リストボックスの基本のサイズは200ピクセルの幅と28ピクセルの高さです。この長さは`width`スタイルを利用して調整することができます。
+そして、リストボックスの基本のサイズは200ピクセルの幅と28ピクセルの高さです。
+この長さは`width`スタイルを利用して調整することができます。
 
 {{{
  #!ruby
  Shoes.app do
    para "Choose a fruit:"
-   list_box :items => ["Grapes", "Pears", "Apricots"],
-     :width => 120, :choose => "Apricots" do |list|
+   list_box items: ["Grapes", "Pears", "Apricots"],
+     width: 120, choose: "Apricots" do |list|
        @fruit.text = list.text
    end
-
+ 
    @fruit = para "No fruit selected"
  end
 }}}
 
-`:width`スタイルに続いて、この例ではもう１つの便利なオプションを利用します。`:choose`オプションは始めからハイライトされるべきアイテムをリストボックスに教えます。（箱が作成された後でアイテムをハイライトするには[[ListBox.choose]]メソッドもあります。）
+`:width`スタイルに続いて、この例ではもう１つの便利なオプションを利用します。
+`:choose`オプションは始めからハイライトされるべきアイテムをリストボックスに教えます。
+（箱が作成された後でアイテムをハイライトするには[[ListBox.choose]]メソッドもあります。）
 
-リストボックスは[[ListBox.change]]イベントも持っています。次の例では、リストボックスにブロックを取り付けました。いいですか、この`change`ブロックを見てください。このブロックは誰かが選択されたアイテムを変更するたびに呼ばれます。
+リストボックスは[[ListBox.change]]イベントも持っています。次の例では、リストボックスに
+ブロックを取り付けました。いいですか、この`change`ブロックを見てください。
+このブロックは誰かが選択されたアイテムを変更するたびに呼ばれます。
 
-これらは基本的なことです。すべての要素が持っているメソッドの完全な一覧である、[[Common]]メソッドのページを見てください。
+これらは基本的なことです。すべての要素が持っているメソッドの完全な一覧である、
+[[Common]]メソッドのページを見てください。
 
 === change() { |self| ... } » self ===
 
-誰かがリストボックスの新しいオプションをハイライトするたびに（例えば、アイテムをクリックすることによって）`change`ブロックは呼ばれます。ブロックには変更されたリストボックスのオブジェクトである`self`が与えられます。
+誰かがリストボックスの新しいオプションをハイライトするたびに（例えば、アイテムをクリックする
+ことによって）`change`ブロックは呼ばれます。ブロックには変更されたリストボックスの
+オブジェクトである`self`が与えられます。
 
 === choose(item: a string) » self ===
 
-`item`として与えられた文字列と一致するリストボックス内のオプションを選択します
+`item`として与えられた文字列と一致するリストボックス内のオプションを選択します。
 
 === focus() » self ===
 
-リストボックスにフォーカスを移動します。そのリストはハイライトされ、ユーザが上や下の矢印キーを押した場合、リスト内の別のオプションが選択されます。
+リストボックスにフォーカスを移動します。そのリストはハイライトされ、ユーザが上や下の
+矢印キーを押した場合、リスト内の別のオプションが選択されます。
 
 === items() » an array of strings ===
 
@@ -2572,28 +3383,34 @@ Shoesはバックグラウンドでシステムのスレッドを使ってリモ
 
 === text() » a string ===
 
-現在リストボックス内でハイライトされて表示されているテキストを含む文字列です。何も選択されていないなら、`nil`が応答されます。
+現在リストボックス内でハイライトされて表示されているテキストを含む文字列です。
+何も選択されていないなら、`nil`が応答されます。
 
 == Progress ==
 
-プログレスバー（Progress bar）は活動がどこまで進んでいるかを表示します。一般的には、プログレスバーはパーセンテージで示されます。（0%から100%まで）Shoesは0.0から1.0の10進数を使って進行を考えます。!{:margin_left => 100}man-ele-progress.png!
+プログレスバー（Progress bar）は活動がどこまで進んでいるかを表示します。
+一般的には、プログレスバーはパーセンテージで示されます。
+（0%から100%まで）Shoesは0.0から1.0の10進数を使って進行を考えます。
+!{:margin_left => 100}man-ele-progress.png!
+
+シンプルなプログレスバーは200ピクセルの幅ですが、長くするために
+（すべてのGreen Shoesの要素のように）`:width`スタイルは利用できません。
 
-シンプルなプログレスバーは200ピクセルの幅ですが、長くするために（すべてのShoesの要素のように）`:width`スタイルは利用できません。
+'''注意:''' Green Shoesでは、最小サイズが幅150ピクセルです。
 
 {{{
  Shoes.app do
-   stack :margin => 0.1 do
-     title "Progress example"
-     @p = progress :width => 1.0
-
-     animate do |i|
-       @p.fraction = (i % 100) / 100.0
-     end
+   title "Progress example"
+   @p = progress left: 10, top: 100, width: width-20
+ 
+   animate do |i|
+     @p.fraction = (i % 100) / 100.0
    end
  end
 }}}
 
-プログレスバーを含む、すべての要素に備え付けられたメソッドの一覧については[[Common]]メソッドのページを見てください。
+プログレスバーを含む、すべての要素に備え付けられたメソッドの一覧については
+[[Common]]メソッドのページを見てください。
 
 === fraction() » a decimal number ===
 
@@ -2605,21 +3422,34 @@ Shoesはバックグラウンドでシステムのスレッドを使ってリモ
 
 == Radio ==
 
-ラジオボタン（Radio button）はクリック可能な円のグループです。それをマークするには円をクリックしてください。ラジオボタンは１度に１つだけマークできます。（１度に１つのオプションだけしか選択できないところは、リストボックスに似ています。）!{:margin_left => 100}man-ele-radio.png!
+ラジオボタン（Radio button）はクリック可能な円のグループです。
+それをマークするには円をクリックしてください。ラジオボタンは１度に１つだけマークできます。
+（１度に１つのオプションだけしか選択できないところは、リストボックスに似ています。）
+!{:margin_left => 100}man-ele-radio.png!
 
-それでは、リストボックスを利用すべきときと、ラジオボタンを利用すべきときをどのようにして決定しますか？そうですね、リストボックスはボックスをクリックしてドロップダウンを表示することなく１つのハイライトされたアイテムを表示します。しかし、ラジオボタンはどれがマークされているか気にすることなく、すべて表示されます。
+それでは、リストボックスを利用すべきときと、ラジオボタンを利用すべきときをどのようにして
+決定しますか？そうですね、リストボックスはボックスをクリックしてドロップダウンを表示すること
+なく１つのハイライトされたアイテムを表示します。
+しかし、ラジオボタンはどれがマークされているか気にすることなく、すべて表示されます。
 
 {{{
  #!ruby
  Shoes.app do
    para "Among these films, which do you prefer?\n"
-   radio; para strong("The Taste of Tea"), " by Katsuhito Ishii\n"
-   radio; para strong("Kin-Dza-Dza"), " by Georgi Danelia\n"
-   radio; para strong("Children of Heaven"), " by Majid Majidi\n"
+   radio
+   para strong("The Taste of Tea"), 
+     " by Katsuhito Ishii\n", width: 570
+   radio
+   para strong("Kin-Dza-Dza"), 
+     " by Georgi Danelia\n", width: 570
+   radio
+   para strong("Children of Heaven"), 
+     " by Majid Majidi\n", width: 570
  end
 }}}
 
-それらは（たくさんの`para`とともに）同じスロット内で一緒にグループ化されているため、３つのラジオボタンから１度に１つだけが選択できます。
+それらは（たくさんの`para`とともに）同じスロット内で一緒にグループ化されているため、
+３つのラジオボタンから１度に１つだけが選択できます。
 
 これらをそれら自身のスロットに移動したら、この例は壊れます。
 
@@ -2628,15 +3458,28 @@ Shoesはバックグラウンドでシステムのスレッドを使ってリモ
  Shoes.app do
    stack do
      para "Among these films, which do you prefer?"
-     flow { radio; para "The Taste of Tea by Katsuhito Ishii" }
-     flow { radio; para "Kin-Dza-Dza by Georgi Danelia" }
-     flow { radio; para "Children of Heaven by Majid Majidi" }
+     flow do
+       radio
+       para "The Taste of Tea by Katsuhito Ishii", 
+         width: 300
+     end
+     flow do
+       radio
+       para "Kin-Dza-Dza by Georgi Danelia",
+         width: 300
+     end
+     flow do
+       radio
+       para "Children of Heaven by Majid Majidi",
+         width: 300
+     end
    end
  end
 }}}
 
 しかし、これは修正できます。
-違うスロットのラジオボタンを一緒にグループ化することができ、それらにすべて同じグループ名を与える必要があります。
+違うスロットのラジオボタンを一緒にグループ化することができ、それらにすべて同じグループ名を
+与える必要があります。
 
 ここでは`:films`グループにそれらすべてのラジオボタンをグループ化しました。
 
@@ -2647,21 +3490,25 @@ Shoesはバックグラウンドでシステムのスレッドを使ってリモ
      para "Among these films, which do you prefer?"
      flow do
        radio :films
-       para "The Taste of Tea by Katsuhito Ishii"
+       para "The Taste of Tea by Katsuhito Ishii",
+         width: 300
      end
      flow do
        radio :films
-       para "Kin-Dza-Dza by Georgi Danelia"
+       para "Kin-Dza-Dza by Georgi Danelia",
+         width: 300
      end
      flow do
        radio :films
-       para "Children of Heaven by Majid Majidi"
+       para "Children of Heaven by Majid Majidi",
+         width: 300
      end
    end
  end
 }}}
 
-下にあるそれらの一覧を越える更なるメソッドについては、[[Common]]メソッドのページを詳しく調べてください。それらのメソッドをすべてのラジオボタンで同様に利用できるからです。
+下にあるそれらの一覧を越える更なるメソッドについては、[[Common]]メソッドのページを
+詳しく調べてください。それらのメソッドをすべてのラジオボタンで同様に利用できるからです。
 
 === checked?() » true or false ===
 
@@ -2670,7 +3517,8 @@ Shoesはバックグラウンドでシステムのスレッドを使ってリモ
 
 === checked = true or false ===
 
-ラジオボタンをマークしたりマークを外したりします。例えば、`checked = false`を利用して、ラジオボタンをクリアします。
+ラジオボタンをマークしたりマークを外したりします。
+例えば、`checked = false`を利用して、ラジオボタンをクリアします。
 
 === click() { |self| ... } » self ===
 
@@ -2681,19 +3529,25 @@ Shoesはバックグラウンドでシステムのスレッドを使ってリモ
 
 === focus() » self ===
 
-ラジオボタンのフォーカスを移動します。そのラジオボタンはハイライトされ、ユーザがエンターキーを打てば、そのラジオボタンはマークされた状態とマークされていない状態の間をトグルします。
+ラジオボタンのフォーカスを移動します。そのラジオボタンはハイライトされます。
 
 == Shape ==
 
-形状（shape）は通常は`oval`と`rect`のようにドローイングメソッドによって作成されるアウトラインパスです。!{:margin_left => 100}man-ele-shape.png!
+形状（shape）は通常は`oval`と`rect`のようにドローイングメソッドによって作成される
+アウトラインパスです。!{:margin_left => 100}man-ele-shape.png!
 
 [[Common]]メソッドのページを見てください。形状はそれらすべてのメソッドに応答できます。
 
 == TextBlock ==
 
-テキストブロック（TextBlock）オブジェクトは単独の要素にとして形成されるテキストのグループを示します。例えば、太字のテキストを含むパラグラフです。リンクと太字のテキストを含むキャプションです。（そして、`caption`はテキストブロックのタイプです。しかしながら、`link`と`strong`はテキストクラスのタイプです。）!{:margin_left => 100}man-ele-textblock.png!
+テキストブロック（TextBlock）オブジェクトは単独の要素にとして形成されるテキストの
+グループを示します。例えば、太字のテキストを含むパラグラフです。
+リンクと太字のテキストを含むキャプションです。（そして、`caption`はテキストブロックの
+タイプです。しかしながら、`link`と`strong`はテキストクラスのタイプです。）
+!{:margin_left => 100}man-ele-textblock.png!
 
-テキストブロックのすべての種類はタイプは[[Element Element Creation]]ページで確認できます。
+テキストブロックのすべての種類はタイプは[[Element Element Creation]]ページで
+確認できます。
 
  * [[Element.banner]], 48ピクセルのフォント。
  * [[Element.title]], 34ピクセルのフォント。
@@ -2707,13 +3561,95 @@ Shoesはバックグラウンドでシステムのスレッドを使ってリモ
 
 ブロック内部の整形された文字列すべてのリストです。
 
+'''注意:''' Green Shoesは`contents`メソッドをサポートしていません。
+
+=== cursor() » an index ===
+
+テキストカーソルの位置を返します。このテキストボックス内の文字のインデックスです。
+
+=== cursor = an index or nil ===
+
+テキストカーソルを表示/非表示します。
+例えば、`cursor = 3`は文の先頭から3文字目の位置にテキストカーソルを表示します。
+`cursor = -1`は文の末尾にテキストカーソルを表示します。
+`cursor = nil`はテキストカーソルを非表示にします。
+
+{{{
+ Shoes.app do
+  msg = para 'hello ' * 20
+  msg.cursor = -1
+  keypress do |k|
+    n = case k
+      when 'Left'; -1
+      when 'Right'; 1
+      else
+        next
+    end
+    n += msg.cursor
+    len = msg.text.length
+    n = len unless n > -1
+    msg.cursor = n % (len+1)
+    flush
+  end
+ end
+}}}
+
+=== highlight() » an array ===
+
+テキストマーカーの開始位置とハイライトする長さを配列形式で返します。
+
+=== hit(left, top) » an index or nil ===
+
+マウスカーソルが指し示すテキストのインデックスを返します。
+`left`と`top` は、マウスの位置です。
+
+{{{
+ Shoes.app do
+   para 'index: ', width: 50
+   index = para '', width: 20
+   msg = title 'hello ' * 5
+   click do |b, x, y|
+     index.text = msg.hit x, y
+   end
+ end
+}}}
+
+=== marker() » an index ===
+
+テキストマーカーの開始位置を返します。
+
+=== marker = an index ===
+
+テキストマーカーの開始位置からカーソル位置までの文字列をハイライトします。
+
+{{{
+ Shoes.app do
+   background gainsboro
+   extend HH::Markup
+   code = 'alert "Hello Green Shoes! " * 5'
+   msg = para highlight code, nil
+   button 'marker' do
+     msg.cursor = 17
+     msg.marker = 14
+     msg.text = highlight msg.markup, nil
+     para msg.highlight
+     flush
+   end
+ end
+}}}
+
+=== markup() » a text ===
+
+Pangoのマークアップテキストを返します。
+
 === replace(a string) ===
 
 ブロック全体のテキストを`a string`の文字で置き換えます。
 
 === text() » a string ===
 
-テキストボックスのすべての文字の文字列を返します。画面に表示されるかのように、すべてのスタイルまたはテキストクラスが取り除かれて実際の文字だけを返します。
+テキストボックスのすべての文字の文字列を返します。画面に表示されるかのように、
+すべてのスタイルまたはテキストクラスが取り除かれて実際の文字だけを返します。
 
 === text = a string ===
 
@@ -2721,37 +3657,76 @@ Shoesはバックグラウンドでシステムのスレッドを使ってリモ
 
 === to_s() » a string ===
 
-[[TextBlock.text]]のエイリアスです。テキストブロックのすべてのコンテンツをフラットにした文字列を返します。
+[[TextBlock.text]]のエイリアスです。
+テキストブロックのすべてのコンテンツをフラットにした文字列を返します。
 
 == Timers ==
 
-Shoesは3つのタイマー（timer）クラスを持っています：アニメーション（Animation）クラス、Everyクラスそしてタイマー（Timer）クラスです。アニメーションとEveryの両方は開始してから何度も何度も繰り替えします。タイマーは１度だけ実行されます。１回限りのタイマーです。
+Green Shoesは3つのタイマーを持っています：Animate、EveryそしてTimerです。
+AnimateとEveryの両方は開始してから何度も何度も繰り替えします。
+タイマーは１度だけ実行されます。１回限りのタイマーです。
+
+animateとeveryは基本的には同じものです。
+違いはanimateは普通は１秒間にとてもたくさん実行されます。
+そしてeveryは数秒間ごとに実行されるか、まれにしか実行されません。
 
-アニメーションとEveryは基本的には同じものです。違いはアニメーションは普通は１秒間にとてもたくさん実行されます。そしてEveryは数秒間ごとに実行されるか、まれにしか実行されません。
+animateとeveryは自動的に開始されます。
 
 === start() » self ===
 
-どちらのタイプのタイマーもそれ自身で自動的に開始されるため、通常はこれは利用する必要がありません。しかし、[[Timers.stop]]でタイマーを止めて再開したい場合は、もちろん：これを利用してください！
+どちらのタイプのタイマーもそれ自身で自動的に開始されるため、通常はこれは利用する
+必要がありません。しかし、[[Timers.stop]]でタイマーを止めて再開したい場合は、
+もちろん：これを利用してください！
+
+'''注意:''' Green Shoesは`start`メソッドをサポートしていません。
 
 === stop() » self ===
 
-アニメーションまたはタイマーを中断します。１回限りのタイマーの場合はこれは既に実行されており、既に停止しているのでこのメソッドの効果はありません。
+animateまたはeveryのループを中断します。
 
-=== toggle() » self ===
+=== pause() » self ===
 
-アニメーションまたはタイマーが停止されていれば、開始します。既に実行されていれば、停止します。
+animateまたはeveryのループを一時停止します。
+アニメーションまたはタイマーが停止されていれば、開始します。
+既に実行されていれば、停止します。
 
 == Video ==
 
-Shoesは埋め込みのQuickTime、Flashビデオ（FLV）、DivX、Xvidそして様々な他の人気のあるビデオフォーマットをサポートしています。これはすべて２つの驚くべきオープンソースライブラリである、VideoLANとffmpegのおかげです。Shoes::Videoオブジェクトをセットアップするためにスロット上で`video`メソッドを利用してください。!{:margin_left => 100}man-ele-video.png!
-
-ビデオフォーマットに加えて、MP3、WAVとOgg Vorbisのような、いくつかのオーディオフォーマットもサポートされています。
+Green Shoesは埋め込みのMP4, AVI, WMV, QuickTimeや他の様々な人気のある
+ビデオフォーマットをサポートしています。これはすべてRuby/GStreamerのおかげです。
+Shoes::Videoオブジェクトをセットアップするために`video`メソッドを利用してください。
+!{:margin_left => 100}man-ele-video.png!
+
+{{{
+ Shoes.app width: 400, height: 300 do
+   background gold..cyan, angle: 90
+   space = ' ' * 3
+   v = video 'http://is.gd/xZ6Jih'
+   links = para space, 
+     link('play'){v.play; links.move(0, 300)}, 
+     space, link('pause'){v.pause}, 
+     space, link('-1sec'){v.time -= 1000},
+     space, link('+1sec'){v.time += 1000}, 
+     top: 250
+   msg = para left: 250, top: 300
+   every do
+     msg.text = fg("#{(v.position*100).to_i}% " + 
+       "(#{v.time/1000}/#{v.length.to_i/1000}sec)", 
+       darkcyan)
+   end
+ end
+}}}
 
-ビデオサポートはShoesではオプションであり、いくつかのビルドではビデオをサポートしていません。例えば、PowerPCではビデオサポートは利用できません。Shoesをダウンロードしたときに、ビデオサポートが利用できないならプラットフォーム用のビルドのファイル名に`novideo`と記されています
+ビデオフォーマットに加えて、MP3、WAVとOgg Vorbisのような、いくつかの
+オーディオフォーマットもサポートされています。
 
 === hide() » self ===
 
-ビデオを非表示します。既に再生しているなら、ビデオは再生を続けます。これはビデオの表示をオフにするだけです。このメソッドの有力な使い方の１つは、MP3のようなオーディオファイルを再生するときに、ビデオの範囲を破壊することです。
+ビデオを非表示します。既に再生しているなら、ビデオは再生を続けます。
+これはビデオの表示をオフにするだけです。このメソッドの有力な使い方の１つは、
+MP3のようなオーディオファイルを再生するときに、ビデオの範囲を破壊することです。
+
+'''注意:''' 今のところGreen Shoesでは`hide`メソッドをサポートしていません。
 
 === length() » a number ===
 
@@ -2761,41 +3736,52 @@ Shoesは埋め込みのQuickTime、Flashビデオ（FLV）、DivX、Xvidそし
 
 （left, top）はビデオの左上の角であり、特定の座標にビデオを移動します。
 
+'''注意:''' 今のところGreen Shoesでは`move`メソッドをサポートしていません。
+
 === pause() » self ===
 
 ビデオが再生されていれば、一時停止します。
 
 === playing?() » true of false ===
 
-ビデオを現在再生していれば、trueを返します。または、ビデオが一時停止されていたり停止されている場合はfalseです。
+ビデオを現在再生していれば、trueを返します。または、ビデオが一時停止されていたり
+停止されている場合はfalseです。
 
 === play() » self ===
 
-既に再生いなければ、ビデオの再生を開始します。既に再生いるのなら、ビデオは始めから再度開始します。
+既に再生いなければ、ビデオの再生を開始します。既に再生いるのなら、ビデオは
+始めから再度開始します。
 
 === position() » a decimal ===
 
-（0.0）から（1.0）の間の10進数の（Floatの）数によるビデオの位置です。例えば、0.5のFloatの値はビデオの中間の位置を示します。
+（0.0）から（1.0）の間の10進数の（Floatの）数によるビデオの位置です。
+例えば、0.5のFloatの値はビデオの中間の位置を示します。
 
 === position = a decimal ===
 
-Floatの値を利用してビデオの位置を設定します。25%の位置にビデオを移動するなら：`@video.position = 0.25`。
+Floatの値を利用してビデオの位置を設定します。
+25%の位置にビデオを移動するなら：`@video.position = 0.25`。
 
 === remove() » self ===
 
 ビデオをスロットから取り除きます。なおビデオを停止します。
 
+'''注意:''' 今のところGreen Shoesでは`remove`メソッドをサポートしていません。
+
 === show() » self ===
 
 `hide()`メソッドによって非表示にされていたなら、ビデオを表示します。
 
+'''注意:''' 今のところGreen Shoesでは`show`メソッドをサポートしていません。
+
 === stop() » self ===
 
 ビデオが再生されていれば、停止します。
 
 === time() » a number ===
 
-ビデオのミリ秒での時間の位置です。そのため、そのビデオが10秒の再生時間なら、このメソッドは10000の数を返します
+ビデオのミリ秒での時間の位置です。そのため、そのビデオが10秒の再生時間なら、
+このメソッドは10000の数を返します
 
 === time = a number ===
 
@@ -2803,7 +3789,10 @@ Floatの値を利用してビデオの位置を設定します。25%の位置に
 
 === toggle() » self ===
 
-ビデオの可視性をトグルします。ビデオが表示されていれば、`hide`が呼ばれます。そうでなければ、`show`が呼ばれます。
+ビデオの可視性をトグルします。ビデオが表示されていれば、`hide`が呼ばれます。
+そうでなければ、`show`が呼ばれます。
+
+'''注意:''' 今のところGreen Shoesでは`toggle`メソッドをサポートしていません。
 
 = AndSoForth =
 
@@ -2820,6 +3809,39 @@ Floatの値を利用してビデオの位置を設定します。25%の位置に
 お役立ち情報:
 
  * [[http://librelist.com/browser/shoes/ Shoes ML]] 気軽にメーリングリストへ参加下さい。
- * [[http://github.com/shoes/shoes/ 最新のソースコード]] は GitHubにあります。
- * [[http://github.com/shoes/shoes/downloads 最新のビルド]] あなたのプラットフォームに合わせて選んで下さい。
+ * [[https://github.com/ashbb/green_shoes/ 最新のソースコード]] は GitHubにあります。
+ * Green Shoes Gemは、[[http://rubygems.org/gems/green_shoes RubyGems.org]] にあります。
+
+
+== vs.RedShoes ==
+
+Green ShoesはRed Shoesに従っていますが、完全互換ではありません。
+
+==== TextBlock ====
+
+以下の2つのコードはRed Shoesでは同じ動作をします。
+
+{{{
+ Shoes.app do
+   para 'hello ' * 20
+ end
+}}}
+
+{{{
+ Shoes.app do
+   20.times{para 'hello '}
+ end
+}}}
+
+でもGreen Shoesでは、`:width`オプションを明示的に付ける必要があります。
+
+{{{
+ Shoes.app do
+   20.times{para 'hello ', width: 40}
+ end
+}}}
+
+もし`:width`オプションを付けないと、Green Shoesは`parent.width`でそのテキストブロックを生成します。
 
+詳細は、[[http://ashbb.github.com/green_shoes/Red_Shoes_and_Green_Shoes.html Red Shoes and Green Shoes]]を
+参照下さい。