Revision as of 20:50, 29 June 2011

Ruby-Qt/KDE Book

Tutorial Series	Ruby
Previous	Installation of Ruby
What's Next	Hello World
Further Reading	n/a

100%

noframe

30% completed (estimate)

Status Of Writing

In comparison to the installation process on Microsoft Windows or Apple Mac OS you have to deal with the fact that there are a lot of different Linux-based operating systems. So there are also different ways to set up your environment for kdebindings.

While installing and testing your Ruby installation you should check if your Linux distribution has the bindings preinstalled before starting to install something.

Test Bindings Installation

Maybe the Qt/KDE bindings are already installed. For a quick check, enter irb in a shell to start the interactive ruby shell. Try to load the bindings.

require "Qt4"
=> true
require "korundum4"
=> true

You can load bindings for KDE 4 (korundum4) or only Qt 4 by a require. In the future you won't need to load Qt 4 first when using KDE 4, because by requiring KDE 4 everything needed is loaded automatically.

If you got the same results so far you seem to have a working environment already.

Installation

There is always the option to install the bindings from source code, but it is recommended to use the existing binary packages.

Installation On Linux-based Systems

To install Ruby you should know how to use your package manager.

Install the package "ruby-kde4" or something similar. Be aware though, that there might exist a package named "ruby-kde", which probably contains the old version of the bindings for KDE 3. Consider furthermore, that you will need a lot of KDE dependencies, if you are working on a GNOME desktop environment.

Installation On Mac OS

TODO

Installation On Windows

TODO

@@ Line 1: / Line 1: @@
+{{TutorialBrowser|
+series=Ruby|
+name=Ruby-Qt/KDE Book|
+pre=[[Development/Languages/Ruby/Ruby-Qt/KDE Book/Installation/Installation of Ruby|Installation of Ruby]]|
+next=[[Development/Languages/Ruby/Ruby-Qt/KDE Book/First Steps/Hello World|Hello World]]
+}}
 {{Box|Status Of Writing|
-[[Image:Action_pen.svg|noframe|left|40px]]{{Progress bar|10}}|100%}}
+[[Image:Action_pen.svg|noframe|left|40px]]{{Progress bar|30}}|100%}}
-In comparison to the installation process on [[Development/Languages/Ruby/Ruby-Qt/KDE Book/Installation/Installation on Windows|Microsoft Windows]] or [[Development/Languages/Ruby/Ruby-Qt/KDE Book/Installation/Installation on Mac OS|Apple Mac OS]] you have to deal with the fact, that there are a lot of different Linux-based operating systems. So there are also different ways to setup your environment for kdebindings.
+In comparison to the installation process on [[Development/Languages/Ruby/Ruby-Qt/KDE Book/Installation/Installation on Windows|Microsoft Windows]] or [[Development/Languages/Ruby/Ruby-Qt/KDE Book/Installation/Installation on Mac OS|Apple Mac OS]] you have to deal with the fact that there are a lot of different Linux-based operating systems. So there are also different ways to set up your environment for kdebindings.
-First you should check before starting to install something if your [http://en.wikipedia.org/wiki/Linux_distribution  Linux distribution] has ruby and/or the bindings preinstalled.
+While [[Development/Languages/Ruby/Ruby-Qt/KDE Book/Installation/Installation of Ruby|installing and testing your Ruby installation]] you should check if your [http://en.wikipedia.org/wiki/Linux_distribution  Linux distribution] has the bindings preinstalled before starting to install something.
-= Test Installation =
+= Test Bindings Installation =
-Start a shell on your Linux system and type and try to get the version of your ruby installation. In the case of a working ruby installation you get something like this.
-<code bash>
+Maybe the Qt/KDE bindings are already installed. For a quick check, enter <tt>irb</tt> in a shell to start the interactive ruby shell. Try to load the bindings.
-> ruby -v
-ruby 1.8.7 (2008-08-11 patchlevel 72) [x86_64-linux]
-</code>
-Maybe the Qt/KDE bindings are installed, too. For a quick check, enter <tt>irb</tt> in a shell to start the interactive ruby-shell. Try to load the bindings.
+<syntaxhighlight lang="ruby">
-<code ruby>
 require "Qt4"
 => true
 require "korundum4"
 => true
-</code>
+</syntaxhighlight>
-You can load bindings for KDE4 (korundum4) or only Qt4 by a <tt>require</tt>. Later you won't need to load Qt4 first when using KDE4, because on requiring KDE4 everything needed is loaded automatically.
+You can load bindings for KDE 4 (korundum4) or only Qt 4 by a <tt>require</tt>. In the future you won't need to load Qt 4 first when using KDE 4, because by requiring KDE 4 everything needed is loaded automatically.
-If you got it so far you seems to have a working environment.
+If you got the same results so far you seem to have a working environment already.
 = Installation =
-== Installation of ruby ==
+There is always the option to install the bindings from source code, but it is recommended to use the existing binary packages.
+== Installation On Linux-based Systems ==
+To [[Development/Languages/Ruby/Ruby-Qt/KDE Book/Installation/Installation of Ruby|install Ruby]] you should know how to use your package manager.
+Install the package "ruby-kde4" or something similar. Be aware though, that there might exist a package named "ruby-kde", which probably contains the old version of the bindings for KDE 3. Consider furthermore, that you will need a lot of KDE dependencies, if you are working on a GNOME desktop environment.
+== Installation On Mac OS ==
-If you haven't ruby installed, you have two different ways to get it.
+TODO
-# using the distribution package manager to install ruby automatically
+== Installation On Windows ==
-# install ruby manually from source.
-I recommend the first way.
+TODO