Skip to content

Commit 590afcb

Browse files
committed
Refactored the /downloads/ page into Markdown, and load metadata from _config.yml.
1 parent 0bca023 commit 590afcb

File tree

1 file changed

+123
-0
lines changed

1 file changed

+123
-0
lines changed

downloads/index.md

Lines changed: 123 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,123 @@
1+
---
2+
layout: page
3+
title: Download Ruby
4+
---
5+
6+
Here you can get the latest Ruby distributions in your favorite flavor.
7+
The current stable version is 1.9.2. Please be sure to read
8+
[Ruby’s License](/about/license.txt).
9+
10+
### Ruby Source Code
11+
12+
Installing from the source code is a great solution for when you are comfortable enough with your platform and perhaps need specific settings for your environment. It’s also a good solution in the event that there are no other premade packages for your platform.
13+
14+
{% for download in site.downloads.source %}
15+
* [{{ download.name }}]({{ download.url }}) {% if download.md5 != null %}(md5: {{ download.md5 }}){% endif %} {% if download.comment != null %} {{ download.comment }}{% endif %}
16+
{% endfor %}
17+
18+
For information about the Ruby Subversion and Git repositories, see our
19+
[Ruby Core](/community/ruby-core/) page.
20+
21+
### Ruby on Windows
22+
23+
The Windows platform has several options to install Ruby.
24+
The first option is to use the [RubyInstaller](http://rubyinstaller.org/),
25+
an installer that contains compiled binaries. The second option is usage of
26+
packaged executables and binaries. If you’re unsure about how to
27+
install Ruby, the first option might be the best for you.
28+
29+
{% for download in site.downloads.windows %}
30+
* [{{ download.name }}]({{ download.url }}) {% if download.md5 != null %}(md5: {{ download.md5 }}){% endif %} {% if download.comment != null %}{{ download.comment }}{% endif %}
31+
{% endfor %}
32+
33+
Please note that using the above indicated binaries will require manual
34+
download and installation of additional components detailed on
35+
[this page](http://www.garbagecollect.jp/ruby/mswin32/en/documents/install.html).
36+
Please ensure you have followed and performed these steps prior reporting a bug.
37+
38+
The [RubyInstaller](http://rubyinstaller.org/) does not require these additional tasks.
39+
40+
Please also investigate the use of [pik](http://github.com/vertiginous/pik)
41+
which eases the process of installing and maintaining concurrent versions of
42+
both ruby and gems on Windows.
43+
44+
### Ruby On Linux
45+
46+
Depending on the distribution you are using, there are several ways to
47+
install Ruby. The first option is simply to download the source code above
48+
and compile by hand. However, on some platforms, there are package management
49+
solutions that make installing Ruby extremely easy. There is also `rvm`, the
50+
[Ruby Version Manager](http://rvm.beginrescueend.com), which eases the process
51+
of installing and maintaining concurrent versions of both ruby and gems.
52+
This software may become the default installation choice for newcomers as it
53+
is quite straightforward to use. If however you would like to stick to your
54+
distribution package system, read on.
55+
56+
For example, on Debian or Ubuntu `apt-get` provides an easy and elegant solution:
57+
58+
% sudo apt-get install ruby1.9.1-full
59+
60+
The above command installs the current stable version of Ruby 1.9.1.
61+
If you prefer to install a Ruby 1.8 version, you can use:
62+
63+
% sudo apt-get install ruby-full
64+
65+
For irb and rdoc, you will need to enable the universe repository.
66+
67+
### Ruby On OS X
68+
69+
Ruby 1.8.6 is fully supported in Mac OS X Leopard including Ruby on Rails,
70+
Mongrel, Capistrano, and many other popular Ruby gems (packages).
71+
For details, see the [Ruby wiki at MacOS Forge](http://trac.macosforge.org/projects/ruby/wiki).
72+
73+
Mac OS X Tiger is packaged with version 1.8.2 of Ruby, but, for those who
74+
haven’t upgraded to Leopard, there are a number of options for
75+
installing the latest version of Ruby. [Locomotive](http://locomotive.raaum.org/)
76+
is a nice choice if you are looking for something to get you up and running
77+
quickly for Rails development. Using [MacPorts](http://www.macports.org/) or
78+
[Fink](http://fink.sourceforge.net/) might be a little nicer for the more
79+
technically savvy.
80+
81+
On MacPorts, you can install Ruby with…
82+
83+
% sudo port install ruby
84+
85+
Fink has a graphical interface (using Fink Commander) for installing Ruby.
86+
87+
Also, since OS X is based on Unix, downloading and installing from the source
88+
is just as easy and effective as the other solutions.
89+
90+
For a detailed look at installing Ruby (and Rails), Dan Benjamin’s
91+
excellent articles [for Tiger](http://hivelogic.com/articles/ruby-rails-mongrel-mysql-osx),
92+
[for Leopard](http://hivelogic.com/articles/ruby-rails-leopard), and
93+
[for Snow Leopard](http://hivelogic.com/articles/compiling-ruby-rubygems-and-rails-on-snow-leopard/)
94+
will get you up and running very quickly.
95+
96+
### Ruby On Solaris and OpenSolaris
97+
98+
Ruby 1.8.7 are available for Solaris 8 through Solaris 10 on [Sunfreeware](http://www.sunfreeware.com)
99+
and Ruby 1.8.7 is available at [Blastwave](http://www.blastwave.org).
100+
Ruby 1.9.2p0 is also available at [Sunfreeware](http://www.sunfreeware.com) now.
101+
An optimized Ruby on Rails stack for Solaris 10 is available as
102+
[Coolstack](http://cooltools.sunsource.net/coolstack) from Sun’s
103+
Cooltools project.
104+
105+
To install Ruby on [OpenSolaris](http://www.opensolaris.org), please use the
106+
[Image Packaging System, or IPS](http://opensolaris.org/os/project/pkg/) client.
107+
This will install the latest Ruby binaries and Rubygems directly from the
108+
OpenSolaris network repository. It’s easy:
109+
110+
% pfexec pkg install SUNWruby18
111+
112+
This will install Ruby, Rubygems, common extensions and their supporting libraries.
113+
This package also contains DTrace support and performance optimizations.
114+
The locations of various artifacts are described in the
115+
[Ruby OpenSolaris ARC Case](http://jp.opensolaris.org/os/community/arc/caselog/2007/600/).
116+
117+
The other OpenSolaris distribution, called the [Solaris Express Community Edition or SXCE](http://opensolaris.org/os/downloads)
118+
comes with Ruby preinstalled. The version, location etc., are the same as
119+
with the vanilla OpenSolaris distribution, and are documented in the above
120+
mentioned ARC case.
121+
122+
To install SVR4 packages manually, please visit the
123+
[RubyOpenSolaris project @ Rubyforge](http://rubyforge.org/projects/rubyopensolaris).

0 commit comments

Comments
 (0)