[ruby-gnome2-doc-cvs] [Hiki] update - Install Guide for Windows

Back to archive index

ruby-****@sourc***** ruby-****@sourc*****
2003年 8月 11日 (月) 04:54:17 JST


-------------------------
REMOTE_ADDR = 217.117.37.226
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. Basically, 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>)).
+ * If it didn't return any error, it's done. From here you can follow one of our ((<tutorials|Ruby-GNOME2 Tutorials>)).
  
  === 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
  :2003-06-05 Masao Mutoh
   Change Library name(Ruby-GTK to Ruby/GTK)
  :2003-06-04 Joao Pedrosa
   Initial release





ruby-gnome2-cvs メーリングリストの案内
Back to archive index