ruby-****@lists*****
ruby-****@lists*****
2003年 6月 4日 (水) 14:11:48 JST
-------------------------
REMOTE_ADDR = 200.164.79.72
REMOTE_HOST =
URL = http://ruby-gnome2.sourceforge.jp/?Install+Guide+for+Windows
-------------------------
= Install Guide
== Windows
=== Note
* The installation should be quick and easy. The minimum packages are ((<Ruby|URL:http://www.ruby-lang.org>)), ((<Ruby-GTK2|URL:http://ruby-gnome2.sf.net>)) and GTK2 binaries for Windows from ((<Dropline|URL:http://www.dropline.net>)).
* The entire Ruby-GNOME2 package isn't supported on Windows yet, and may never be, as it requires GNOME 2.
* The versions of Windows are categorized in Win9X/ME and WinNT/2000/XP/2003.
* This installation process was tested with Ruby 1.8, but it should work with version 1.6 as well.
=== Steps
==== One
* Download ((<Ruby packaged by the Pragmatic Programmers|URL:http://rubyinstaller.sourceforge.net/>)).
* ((<ruby180-9.exe|URL:http://prdownloads.sourceforge.net/rubyinstaller/ruby180-9.exe?download>)) is recommended for this example.
* Install it in any directory (Ex: c:\Ruby).
==== Two
* Download ((<Ruby-GTK2 binaries for Windows|URL:http://sourceforge.net/project/showfiles.php?group_id=53614>)).
* ((<ruby-gtk2-0.4.0-1-i386-msvcrt-1.8.zip|URL:http://prdownloads.sourceforge.net/ruby-gnome2/ruby-gtk2-0.4.0-1-i386-msvcrt-1.8.zip?download>)) is recommended for this example.
* Unzip it in ruby-install-dir (Ex: c:\Ruby).
==== Three
* Download ((<GTK+2 Runtime Environment binaries for Windows from Dropline|URL:http://www.dropline.net/gtk/download.php>)).
* ((<GTK-Runtime-Environment-2.2.1.2.exe|URL:http://prdownloads.sourceforge.net/gtk-win/GTK-Runtime-Environment-2.2.1.2.exe?download>)) is recommended for this example.
* Install it in any directory (Ex: c:\Gtk).
==== Four
* Enough downloads. Time to configure it. Basicly, there is only one Environment Variable that needs to hold the directories where the important binaries that need to be shared are located.
* Conventions:
* ruby-install-dir is the directory where Ruby was installed. Ex: c:\Ruby
* gtk-install-dir is the directory where GTK+2 was installed. Ex: c:\Gtk
* On Win9X/ME
* Edit the c:\autoexec.bat file. Append a line (Yes, it should be the last one to be safer) that reads ((*SET PATH=%PATH%;ruby-install-dir\bin;gtk-install-dir\bin;gtk-install-dir\lib*)) . Reboot for the changes to take effect.
* On WinNT/2000/XP/2003
* Open Panel Control>System>Advanced>Environment Variables. If there is a System Variable called PATH, just append to it ((*ruby-install-dir\bin;gtk-install-dir\bin;gtk-install-dir\lib*)). If there isn't one, add PATH and set its value to ((*ruby-install-dir\bin;gtk-install-dir\bin;gtk-install-dir\lib*)).
==== Five
* Time to test it. Don't worry if something didn't go well, as there is a trouble shooting area below.
* The following commands should be typed on the "Prompt for DOS". To open the Prompt for DOS on:
* Win9X/ME click on the Start Button and Run(Execute ?). Type ((*command*)) and hit the <ENTER> key.
* WinNT/2000/XP/2003 click on the Start Button and Run(Execute ?). Type ((*cmd*)) and hit the <ENTER> key.
C:\>ruby -v
ruby 1.8.0 (2003-05-26) [i386-mswin32]
C:\>ruby -e "require 'gtk2'"
C:\>ruby -e "require 'gtk2';include Gtk;Gtk.init;w=Window.new;w.title='Hello Ruby-GNOME2 World!';w.set_size_request(500,400);w.signal_connect('delete_event'){Gtk.main_quit};w.show_all;Gtk.main"
* Don't worry about the warnings that were shown, as they are fixed on the current release, and as soon as Masahiro Sakai releases the new binaries for Windows, they will disappear.
* If it didn't return any error, it's done. From here you can follow to the ((<tutorial|URL:http://ruby-gnome2.sourceforge.net/tut/toc.htm>)).
=== Trouble Shooting
--- PATH Environment Variable
Check if the PATH Environment Variable is set correctly. Type SET PATH on the "Prompt for DOS" and check if it contains ((*ruby-install-dir\bin;gtk-install-dir\bin;gtk-install-dir\lib*)) as explained above. Redo the above configuration if needed. Close and Reopen the "Prompt for DOS" for it to load the new value on WinNT/2000/XP/2003, or Reboot the machine on Win9X/ME.
The PATH Env. Var. on my system reads:
C:\>SET PATH
Path=C:\WINDOWS\system32;C:\WINDOWS;C:\WINDOWS\System32\Wbem;C:\dev\python;C:\j2sdk1.4.2\bin;C:\ruby\bin;C:\Gtk\bin;C:\Gtk\lib
Be careful with directories that have spaces in their names, as that could cause breaks in the spaces, provoking errors. Try to enclose them with quotes (Ex: "c:\my spaced directory name") if you get errors with the PATH Env. Var. .
--- ruby -v
If this command doesn't work, check if ruby-install-dir\bin is set correcly in the PATH Env. Var. .
--- ruby -e "require 'gtk2'"
If this command doesn't work, check if gtk-install-dir\bin and gtk-install-dir\lib are set correcly in the PATH Env. Var. .
If it still doesn't work after that, then tell us more about what kind of error you are getting on the ((<mailling lists|URL:http://sourceforge.net/mail/?group_id=53614>)).
-------------------------
= Install Guide
== Windows
=== Note
* The installation should be quick and easy. The minimum packages are ((<Ruby|URL:http://www.ruby-lang.org>)), ((<Ruby-GTK2|URL:http://ruby-gnome2.sf.net>)) and GTK2 binaries for Windows from ((<Dropline|URL:http://www.dropline.net>)).
* The entire Ruby-GNOME2 package isn't supported on Windows yet, and may never be, as it requires GNOME 2.
* The versions of Windows are categorized in Win9X/ME and WinNT/2000/XP/2003.
* This installation process was tested with Ruby 1.8, but it should work with version 1.6 as well.
=== Steps
==== One
* Download ((<Ruby packaged by the Pragmatic Programmers|URL:http://rubyinstaller.sourceforge.net/>)).
* ((<ruby180-9.exe|URL:http://prdownloads.sourceforge.net/rubyinstaller/ruby180-9.exe?download>)) is recommended for this example.
* Install it in any directory (Ex: c:\Ruby).
==== Two
* Download ((<Ruby-GTK2 binaries for Windows|URL:http://sourceforge.net/project/showfiles.php?group_id=53614>)).
* ((<ruby-gtk2-0.4.0-1-i386-msvcrt-1.8.zip|URL:http://prdownloads.sourceforge.net/ruby-gnome2/ruby-gtk2-0.4.0-1-i386-msvcrt-1.8.zip?download>)) is recommended for this example.
* Unzip it in ruby-install-dir (Ex: c:\Ruby).
==== Three
* Download ((<GTK+2 Runtime Environment binaries for Windows from Dropline|URL:http://www.dropline.net/gtk/download.php>)).
* ((<GTK-Runtime-Environment-2.2.1.2.exe|URL:http://prdownloads.sourceforge.net/gtk-win/GTK-Runtime-Environment-2.2.1.2.exe?download>)) is recommended for this example.
* Install it in any directory (Ex: c:\Gtk).
==== Four
* Enough downloads. Time to configure it. Basicly, there is only one Environment Variable that needs to hold the directories where the important binaries that need to be shared are located.
* Conventions:
* ruby-install-dir is the directory where Ruby was installed. Ex: c:\Ruby
* gtk-install-dir is the directory where GTK+2 was installed. Ex: c:\Gtk
* On Win9X/ME
* Edit the c:\autoexec.bat file. Append a line (Yes, it should be the last one to be safer) that reads ((*SET PATH=%PATH%;ruby-install-dir\bin;gtk-install-dir\bin;gtk-install-dir\lib*)) . Reboot for the changes to take effect.
* On WinNT/2000/XP/2003
* Open Panel Control>System>Advanced>Environment Variables. If there is a System Variable called PATH, just append to it ((*ruby-install-dir\bin;gtk-install-dir\bin;gtk-install-dir\lib*)). If there isn't one, add PATH and set its value to ((*ruby-install-dir\bin;gtk-install-dir\bin;gtk-install-dir\lib*)).
==== Five
* Time to test it. Don't worry if something didn't go well, as there is a trouble shooting area below.
* The following commands should be typed on the "Prompt for DOS". To open the Prompt for DOS on:
* Win9X/ME click on the Start Button and Run(Execute ?). Type ((*command*)) and hit the <ENTER> key.
* WinNT/2000/XP/2003 click on the Start Button and Run(Execute ?). Type ((*cmd*)) and hit the <ENTER> key.
C:\>ruby -v
ruby 1.8.0 (2003-05-26) [i386-mswin32]
C:\>ruby -e "require 'gtk2'"
C:\>ruby -e "require 'gtk2';include Gtk;Gtk.init;w=Window.new;w.title='Hello Ruby-GNOME2 World!';w.set_size_request(500,400);w.signal_connect('delete_event'){Gtk.main_quit};w.show_all;Gtk.main"
* Don't worry about the warnings that were shown, as they are fixed on the current release, and as soon as Masahiro Sakai releases the new binaries for Windows, they will disappear.
* If it didn't return any error, it's done. From here you can follow to the ((<tutorial|URL:http://ruby-gnome2.sourceforge.net/tut/toc.htm>)).
=== Trouble Shooting
--- PATH Environment Variable
Check if the PATH Environment Variable is set correctly. Type SET PATH on the "Prompt for DOS" and check if it contains ((*ruby-install-dir\bin;gtk-install-dir\bin;gtk-install-dir\lib*)) as explained above. Redo the above configuration if needed. Close and Reopen the "Prompt for DOS" for it to load the new value on WinNT/2000/XP/2003, or Reboot the machine on Win9X/ME.
The PATH Env. Var. on my system reads:
C:\>SET PATH
Path=C:\WINDOWS\system32;C:\WINDOWS;C:\WINDOWS\System32\Wbem;C:\dev\python;C:\j2sdk1.4.2\bin;C:\ruby\bin;C:\Gtk\bin;C:\Gtk\lib
Be careful with directories that have spaces in their names, as that could cause breaks in the spaces, provoking errors. Try to enclose them with quotes (Ex: "c:\my spaced directory name") if you get errors with the PATH Env. Var. .
--- ruby -v
If this command doesn't work, check if ruby-install-dir\bin is set correcly in the PATH Env. Var. .
--- ruby -e "require 'gtk2'"
If this command doesn't work, check if gtk-install-dir\bin and gtk-install-dir\lib are set correcly in the PATH Env. Var. .
If it still doesn't work after that, then tell us more about what kind of error you are getting on the ((<mailling lists|URL:http://sourceforge.net/mail/?group_id=53614>)).
=== Author
* Joao Pedrosa - joaopedrosa at yahoo dot com
=== ChangeLog