Permalink
Browse files

Merge pull request #873 from argent-smith/master

'What is Rubinius?' and 'Getting Started': literary edition
  • Loading branch information...
2 parents 52f35be + 45009d2 commit 2829c4d6201895bceb564788d4f175a096f1a559 @kronos kronos committed May 13, 2011
View
@@ -0,0 +1,6 @@
+# A sample Gemfile
+source "http://rubygems.org"
+
+gem "rake"
+gem "jekyll"
+gem "kramdown"
View
@@ -0,0 +1,27 @@
+GEM
+ remote: http://rubygems.org/
+ specs:
+ classifier (1.3.3)
+ fast-stemmer (>= 1.0.0)
+ directory_watcher (1.4.0)
+ fast-stemmer (1.0.0)
+ jekyll (0.10.0)
+ classifier (>= 1.3.1)
+ directory_watcher (>= 1.1.1)
+ liquid (>= 1.9.0)
+ maruku (>= 0.5.9)
+ kramdown (0.13.3)
+ liquid (2.2.2)
+ maruku (0.6.0)
+ syntax (>= 1.0.0)
+ rake (0.8.7)
+ syntax (1.0.0)
+
+PLATFORMS
+ ruby
+ x86-mingw32
+
+DEPENDENCIES
+ jekyll
+ kramdown
+ rake
View
@@ -0,0 +1,41 @@
+#
+# To change this template, choose Tools | Templates
+# and open the template in the editor.
+
+
+require 'rubygems'
+require 'bundler'
+
+begin
+ Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+ $stderr.puts e.message
+ $stderr.puts "Run `bundle install` to install missing gems"
+ exit e.status_code
+end
+
+require 'rake'
+
+LANG = "ru_RU.UTF-8"
+
+SET_CMD = case RUBY_PLATFORM
+ when /mingw32/ then "set"
+ else "export"
+ end
+
+RBX = case RUBY_ENGINE
+ when /rbx/ then "rbx -S"
+ else ""
+ end
+
+task :default => 'generate'
+
+desc 'just generate the site'
+task :generate do
+ sh "#{SET_CMD} LANG=#{LANG} && #{RBX} jekyll"
+end
+
+desc 'serve locally on jekyll'
+task :serve do
+ sh "#{SET_CMD} LANG=#{LANG} && #{RBX} jekyll --server --auto"
+end
View
@@ -8,5 +8,5 @@ permalink: pretty
host: http://rubini.us
-exclude: drafts
+exclude: drafts Gemfile Gemfile.lock Rakefile
---
@@ -153,6 +153,12 @@ <h3 id="debianubuntu">Debian/Ubuntu</h3>
<li>libssl-dev</li>
</ul>
+<h3 id="freebsd">FreeBSD</h3>
+
+<p>Rubinius has a port in FreeBSD ports tree. It&rsquo;s called <code>lang/rubinius</code>. You
+can find information about this port on <a href="http://freshports.org">http://freshports.org</a>. Once being
+installed the port installs all the dependencies automagically.</p>
+
</div>
@@ -116,60 +116,64 @@ <h2>Сборка Rubinius</h2>
- <p>Вы можете собрать и запустить Rubinius из исходной директории. Вам не
-нужно устанавливать Rubinius, чтобы запустить его. Инструкции, приведенные
-ниже, подробно описывают как установку, так и запуск Rubinius из исходного
-каталога.</p>
-
-<p>Rubinius использует LLVM для JIT компиляции. Rubinius зависит от определенной
-версии LLVM. Если LLVM уже установлена на вашей системе передайте флаг
-<code>--skip-system</code> в скрипт конфигурации (см. ниже).</p>
+ <p>Вы можете собрать и запустить Rubinius прямо из директории с исходниками. Вам не
+обязательно устанавливать Rubinius в систему, чтобы запустить его. Инструкции, приведенные
+ниже, подробно описывают установку и запуск Rubinius из каталога с исходниками.</p>
+
+<p>Rubinius использует
+<a href="http://ru.wikipedia.org/wiki/Low_Level_Virtual_Machine">LLVM</a> для
+JIT-компиляции. Rubinius зависит от определенной
+версии LLVM, которая должна быть собрана с включенной RTTI (run-time type
+information). Скрипт &ldquo;<code>configure</code>&rdquo; автоматически проверит эти условия на стадии
+поиска LLVM. Если LLVM уже установлена на Вашей системе, а Rubinius не может
+на нее пролинковаться, передайте флаг
+<code>--skip-system</code> скрипту &ldquo;<code>configure</code>&rdquo; (см. ниже).</p>
<h3 id="section">Получение исходного кода</h3>
<p>Исходный код Rubinius доступен как tar-архив и как проект на Github.
-Вы можете <a href="http://rubini.us/download/latest">скачать tar-архив здесь</a>.</p>
+Tar-архив можно скачать <a href="http://rubini.us/download/latest">здесь</a>.</p>
<p>Чтобы использовать Git:</p>
<ol>
- <li>Измените вашу текущую директорию на директорию для разработок</li>
+ <li>Перейдите в директорию для разработок;</li>
<li><code>git clone git://github.com/evanphx/rubinius.git</code></li>
</ol>
<h3 id="rubinius">Установка Rubinius</h3>
-<p>Этот раздел для вас, если вы хотите использовать Rubinius для запуска ваших
-приложений. Также вы можете запускать Rubinius прямо из исходной директории
+<p>Этот раздел пригодится, если Вы хотите использовать Rubinius для запуска
+приложений. Также Rubinius можно запускать прямо из исходной директории.
За подробностями обратитесь к следующему разделу.</p>
-<p>Мы рекомендуем устанавливать Rubinius в место, нетребующее <code>sudo</code> или права
-суперпользователя. Чтобы установить Rubinius:</p>
+<p>Мы рекомендуем устанавливать Rubinius в место, не требующее <code>sudo</code> или права
+суперпользователя. Последовательность действий:</p>
<ol>
<li><code>./configure --prefix=/path/to/install/dir</code></li>
<li><code>rake install</code></li>
- <li>Следуйте инструкциям, чтобы добавить <em>bin</em> директорию в переменную
-окружения PATH</li>
+ <li>Следуйте инструкциям, чтобы добавить <em>bin</em>-директорию в переменную
+окружения PATH.</li>
</ol>
<h3 id="section-1">Запуск из директории с исходниками</h3>
-<p>Если вы планируете работать над Rubinius, вам следует использовать следующие
-команды.</p>
+<p>Если Вы планируете работать над самим Rubinius-ом, Вам следует использовать следующие
+команды:</p>
<ol>
<li><code>./configure</code></li>
<li><code>rake</code></li>
</ol>
-<p>Если вы просто пробуете Rubinius, следуйте инструкциям, чтобы добавить
-<em>bin</em> директорию в переменную окружения PATH.</p>
+<p>Если Вы просто пробуете Rubinius, следуйте инструкциям, чтобы добавить
+<em>bin</em>-директорию в переменную окружения PATH.</p>
-<p>Однако, если вы разрабатываете Rubinius, вы не должны добавлять папку <em>bin</em>
-в переменную PATH, потому что система сборки Rubinius будет использовать свои
-<code>ruby</code> и <code>rake</code>, в то время как в процессе сборки ей необходимы отдельные
-исполняемые файлы Ruby.</p>
+<p>Однако, если Вы разрабатываете Rubinius, Вам <strong>не следует</strong> добавлять папку <em>bin</em>
+в переменную PATH, потому что система сборки Rubinius будет использовать
+собственные <code>ruby</code> и <code>rake</code> (ссылки на бинарник Rubinius). Внешние
+исполняемые файлы Ruby необходимы для запуска процесса сборки самого Rubinius.</p>
</div>
@@ -120,8 +120,8 @@ <h2>Приступая к работе</h2>
обладаете некоторыми знаниями о Ruby и установке программного обеспечения
на вашу систему.</p>
-<p>Если у вас возникут проблемы с инструкциями, описанными здесь, обратитесь
-за помощью на IRC канал #rubinius на сервере irc.freenode.net.</p>
+<p>Если у вас возникнут проблемы с приводимыми здесь инструкциями, обратитесь
+за помощью на IRC-канал #rubinius сервера irc.freenode.net.</p>
<ol>
<li><a href="/doc/ru/getting-started/requirements/">Минимальные требования</a></li>
@@ -116,32 +116,33 @@ <h2>Минимальные требования</h2>
- <p>Убедитесь, что у вас установлены следующие программы и библиотеки. Также
-посмотрите разделы ниже с требованиями для каждой конкретной операционной
-системы.</p>
+ <p>Убедитесь, что у вас установлены перечисленные программы и библиотеки. Также
+просмотрите нижеприведенные разделы на предмет требований для каждой
+конкретной операционной системы.</p>
-<p>Далее следуют ссылки для получения информации о программах и библиотеках,
-нужных для сборки Rubinius. Для вашей операционной системы или пакетного
-менеджера могут быть доступны другие пакеты.</p>
+<p>Ниже следуют ссылки для получения дополнительной информации о программах и библиотеках,
+нужных для сборки Rubinius. Для вашей операционной системы или менеджера
+пакетов могут быть доступны и другие сборки, помимо перечисленных.</p>
<ul>
<li><a href="http://gcc.gnu.org/">GCC и G++ 4.x</a></li>
<li><a href="http://www.gnu.org/software/bison/">GNU Bison</a></li>
<li><a href="http://www.ruby-lang.org/">MRI Ruby 1.8.7+</a> Если на вашей системе не
установлен Ruby 1.8.7, подумайте об использовании
-<a href="http://rvm.beginrescueend.com/">RVM</a> для установки.</li>
+<a href="http://rvm.beginrescueend.com/">RVM</a> для его установки.</li>
<li><a href="http://www.rubygems.org/">Rubygems</a></li>
<li><a href="http://git.or.cz/">Git</a></li>
<li><a href="http://www.zlib.net/">ZLib</a></li>
- <li>pthread - Библиотека pthread должна быть установлена вашей операционной системой</li>
+ <li>pthread: Библиотека pthread должна быть установлена вашей операционной
+системой.</li>
<li><a href="http://savannah.gnu.org/projects/make/">gmake</a></li>
- <li><a href="http://rake.rubyforge.org/">rake</a> <code>[sudo] gem install rake</code></li>
+ <li><a href="http://rake.rubyforge.org/">rake</a>: <code>[sudo] gem install rake</code></li>
</ul>
<h3 id="apple-os-x">Apple OS X</h3>
-<p>Простейший путь для создания сборочного окружения на Apple OS X
-установка XCode Tools and Utilities. После установки, для формирования
+<p>Простейший путь для создания сборочного окружения на Mac OS X &mdash;
+установка XCode Tools and Utilities. После установки для формирования
отчетов об аварийных завершениях можно использовать приложение
/Developer/Applications/Utilities/CrashReporterPrefs.app</p>
@@ -154,6 +155,13 @@ <h3 id="debianubuntu">Debian/Ubuntu</h3>
<li>libssl-dev</li>
</ul>
+<h3 id="freebsd">FreeBSD</h3>
+
+<p>Под FreeBSD есть порт Rubinius, который называется <code>lang/rubinius</code>. Подробную
+информацию о порте можно найти на сайте <a href="http://freshports.org">http://freshports.org</a>. В процессе
+инсталляции порта установка и настройка всех требуемых вспомогательных
+программ и библиотек происходит автоматически.</p>
+
</div>
@@ -9,7 +9,7 @@
<link href='/' rel='home'>
<link href='/' rel='start'>
<link href='/doc/ru/getting-started/building' rel='prev' title='Сборка'>
- <link href='/doc/ru/getting-started/troubleshooting' rel='next' title='Разрешение проблем'>
+ <link href='/doc/ru/getting-started/troubleshooting' rel='next' title='Решение проблем'>
<!--[if IE]><script src="http://html5shiv.googlecode.com/svn/trunk/html5.js" type="text/javascript"></script><![endif]-->
<script src="/javascripts/jquery-1.3.2.js" type="text/javascript"></script>
@@ -103,7 +103,7 @@
<span class="label">Next:</span>
- <a href="/doc/ru/getting-started/troubleshooting">Разрешение проблем</a>
+ <a href="/doc/ru/getting-started/troubleshooting">Решение проблем</a>
</div>
@@ -116,7 +116,7 @@ <h2>Запуск Rubinius</h2>
- <p>После того, как вы прошли шаги по сборке (и, возможно, установке)
+ <p>После того, как Вы прошли сборку (и, возможно, установку)
Rubinius, можно проверить его работоспособность:</p>
<pre><code>rbx -v
@@ -127,7 +127,7 @@ <h2>Запуск Rubinius</h2>
<pre><code>rbx -e 'puts "Hello!"'
</code></pre>
-<p>Для запуска ruby файла с именем &lsquo;code.rb&rsquo;:</p>
+<p>Для запуска ruby-файла с именем &lsquo;code.rb&rsquo;:</p>
<pre><code>rbx code.rb
</code></pre>
@@ -141,9 +141,9 @@ <h2>Запуск Rubinius</h2>
Rubinius будет себя вести точно также, как MRI. Будут доступны программы
<code>ruby</code>, <code>rake</code>, <code>gem</code>, <code>irb</code>, <code>ri</code> и <code>rdoc</code>.</p>
-<p>Добавляйте директорию bin Rubinius в PATH только тогда, когда вы захотите
-перейти на использование Rubinius. В противном случае он будет использоваться
-вместо вашего стандартного Ruby интерпретатора.</p>
+<p>Добавляйте директорию <code>bin</code> Rubinius в PATH только тогда, когда Вы захотите
+перейти на постоянное использование Rubinius. Иначе он будет использоваться
+вместо вашего обычного Ruby-интерпретатора.</p>
</div>
@@ -160,7 +160,7 @@ <h2>Запуск Rubinius</h2>
<span class="label">Next:</span>
- <a href="/doc/ru/getting-started/troubleshooting">Разрешение проблем</a>
+ <a href="/doc/ru/getting-started/troubleshooting">Решение проблем</a>
</div>
Oops, something went wrong.

0 comments on commit 2829c4d

Please sign in to comment.