Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

Merge pull request #873 from argent-smith/master

'What is Rubinius?' and 'Getting Started': literary edition
  • Loading branch information...
commit 2829c4d6201895bceb564788d4f175a096f1a559 2 parents 52f35be + 45009d2
@kronos kronos authored
View
6 web/Gemfile
@@ -0,0 +1,6 @@
+# A sample Gemfile
+source "http://rubygems.org"
+
+gem "rake"
+gem "jekyll"
+gem "kramdown"
View
27 web/Gemfile.lock
@@ -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
41 web/Rakefile
@@ -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
2  web/_config.yml
@@ -8,5 +8,5 @@ permalink: pretty
host: http://rubini.us
-exclude: drafts
+exclude: drafts Gemfile Gemfile.lock Rakefile
---
View
6 web/_site/doc/en/getting-started/requirements/index.html
@@ -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>
View
52 web/_site/doc/ru/getting-started/building/index.html
@@ -116,60 +116,64 @@
- <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>
View
4 web/_site/doc/ru/getting-started/index.html
@@ -120,8 +120,8 @@
обладаете некоторыми знаниями о 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>
View
30 web/_site/doc/ru/getting-started/requirements/index.html
@@ -116,32 +116,33 @@
- <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>
View
16 web/_site/doc/ru/getting-started/running-rubinius/index.html
@@ -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 @@
- <p>После того, как вы прошли шаги по сборке (и, возможно, установке)
+ <p>После того, как Вы прошли сборку (и, возможно, установку)
Rubinius, можно проверить его работоспособность:</p>
<pre><code>rbx -v
@@ -127,7 +127,7 @@
<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 @@
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 @@
<span class="label">Next:</span>
- <a href="/doc/ru/getting-started/troubleshooting">Разрешение проблем</a>
+ <a href="/doc/ru/getting-started/troubleshooting">Решение проблем</a>
</div>
View
36 web/_site/doc/ru/getting-started/troubleshooting/index.html
@@ -1,7 +1,7 @@
<!DOCTYPE html>
<html>
<head>
- <title>Разрешение проблем - Rubinius</title>
+ <title>Решение проблем - Rubinius</title>
<meta content='text/html;charset=utf-8' http-equiv='content-type'>
<meta content='ru' http-equiv='content-language'>
<meta content='Rubinius is an implementation of the Ruby programming language. The Rubinius bytecode virtual machine is written in C++. The bytecode compiler is written in pure Ruby. The vast majority of the core library is also written in Ruby, with some supporting primitives that interact with the VM directly.' name='description'>
@@ -110,17 +110,17 @@
<div class="container documentation">
- <h2>Разрешение проблем</h2>
+ <h2>Решение проблем</h2>
- <p>Ниже приведены ошибки, с которыми вы можете столкнуться в процессе сборки,
-установки или использования Rubinius, вместе с возможными их решениями.</p>
+ <p>Ниже приведены ошибки, с которыми Вы можете столкнуться в процессе сборки,
+установки или использования Rubinius, и их возможные решения.</p>
-<p>При любой ошибке, первым делом удостоверьтесь, что вы работаете с чистой
-копией Rubinius. Перед тем, как двигаться дальше, попробуйте выполнить
+<p>При любой ошибке первым делом удостоверьтесь, что Вы работаете с последней чистой
+версией Rubinius. Перед тем, как двигаться дальше, попробуйте выполнить
следующее:</p>
<pre><code>$ git co master
@@ -130,7 +130,7 @@
$ rake
</code></pre>
-<p>Ошибка:</p>
+<h3 id="rubinius-----runtime-">Rubinius не может найти директорию runtime-библиотек</h3>
<pre><code>ERROR: unable to find runtime directory
@@ -147,19 +147,31 @@
directory but you have not run 'rake install' yet.
</code></pre>
-<p>Решение:</p>
+<h4 id="section">Решение</h4>
-<p>Если вы конфигурировали rubinius с &ndash;prefix, выполните rake install.</p>
+<p>Если Вы конфигурировали rubinius с <code>--prefix</code>, выполните <code>rake install</code>.</p>
-<p>Если вы конфигурировали rubinius с &ndash;prefix и переименовали инсталяционную
+<p>Если Вы конфигурировали rubinius с <code>--prefix</code> и переименовали инсталяционную
директорию после установки Rubinius, выполните конфигурацию и установку
заново.</p>
-<p>Если вы переименовали директорию c исходниками после сборки Rubinius,
+<p>Если Вы переименовали директорию c исходниками после сборки Rubinius,
выполните конфигурацию и установку вновь.</p>
<p>Вообще, лучше не переименовывать директорию с исходниками или директорию
- где производилась сборка после сборки Rubinius.</p>
+ инсталляции после сборки Rubinius.</p>
+
+<h3 id="rubinius---freebsd---segfault">Rubinius, собранный под FreeBSD, падает по <code>segfault</code></h3>
+
+<p>До версии 8.1-STABLE включительно во FreeBSD существует проблема с
+ библиотекой <code>execinfo</code>, приводящая к падению Rubinius при запуске.</p>
+
+<h4 id="section-1">Решение</h4>
+
+<p>На стадии <code>configure</code> отключите <code>execinfo</code>:</p>
+
+<pre><code>./configure --without-execinfo
+</code></pre>
</div>
View
2  web/_site/doc/ru/index.html
@@ -110,7 +110,7 @@
<li><a href="/doc/ru/getting-started/requirements/">Минимальные требования</a></li>
<li><a href="/doc/ru/getting-started/building/">Сборка</a></li>
<li><a href="/doc/ru/getting-started/running-rubinius/">Запуск Rubinius</a></li>
- <li><a href="/doc/ru/getting-started/troubleshooting/">Разрешение проблем</a></li>
+ <li><a href="/doc/ru/getting-started/troubleshooting/">Решение проблем</a></li>
</ol>
</li>
<li><a href="/doc/ru/contributing/">Участие в проекте</a>
View
26 web/_site/doc/ru/what-is-rubinius/index.html
@@ -115,25 +115,25 @@
<h2 id="rubinius">Что такое Rubinius</h2>
-<p>Rubinius это реализация <a href="http://ruby-lang.org">языка программирования Ruby</a>.</p>
+<p>Rubinius &mdash; это реализация <a href="http://ruby-lang.org">языка программирования Ruby</a>.</p>
<p>Rubinius состоит из байткодовой виртуальной машины, парсера Ruby, компилятора
-в байткод, сборщика мусора, основанного на поколениях, JIT компилятора в
-машинный код и встроенных и стандартных библиотек Ruby.</p>
+в байткод, сборщика мусора, основанного на поколениях, JIT-компилятора в
+машинный код, встроенных (Ruby Core) и стандартных (Standard library) библиотек Ruby.</p>
<p>На данный момент Rubinius совместим с версией Ruby 1.8.7.</p>
<h2 id="section">Лицензия</h2>
-<p>Rubinius использует BSD лицензию. Ее можно найти в файле LICENSE, в исходниках.</p>
+<p>Rubinius использует лицензию BSD. Ее можно найти в исходниках в файле LICENSE.</p>
<h2 id="section-1">Установка</h2>
-<p>Rubinius работает под Mac OS X и многими Unix/Linux совместимыми операционными
-системами. Скоро появится поддрежка Microsoft Windows.</p>
+<p>Rubinius работает под Mac OS X и многими другими операционными
+системами семейства Unix/Linux. Вскоре появится и поддержка Microsoft Windows.</p>
-<p>Для установки Rubinius, проделайте следующие шаги. За более детальной
-информацией обратитесь к <a href="/doc/ru/getting-started/">Приступая к работе</a>.</p>
+<p>Для установки Rubinius выполните указанные ниже команды. Более подробную
+информацию можно найти в разделе <a href="/doc/ru/getting-started/">&laquo;Приступая к работе&raquo;</a>.</p>
<ol>
<li><code>git clone git://github.com/evanphx/rubinius.git</code></li>
@@ -142,12 +142,12 @@ <h2 id="section-1">Установка</h2>
<li><code>rake install</code></li>
</ol>
-<p>Когда процесс утановки завершится, следуя указаниям добавьте bin директорию
-в переменную окружения PATH.</p>
+<p>Когда процесс установки завершится, следуя указаниям, добавьте директорию, в
+которой находятся исполняемые файлы Rubinius, в переменную окружения PATH.</p>
-<p>Rubinius поставляется со встроенными RubyGems и уже содержит предустановленные
-гемы rake и rdoc. Например, чтобы установить гем nokogiri, выполните <code>rbx gem
-install nokogiri</code></p>
+<p>Rubinius поставляется со встроенным пакетом RubyGems и уже содержит предустановленные
+гемы rake и rdoc. Чтобы установить гем nokogiri, например, нужно выполнить
+команду <code>rbx gem install nokogiri</code></p>
</div>
View
6 web/doc/en/getting-started/requirements.markdown
@@ -41,3 +41,9 @@ reporting at: /Developer/Applications/Utilities/CrashReporterPrefs.app
* libreadline5-dev
* zlib1g-dev
* libssl-dev
+
+### FreeBSD
+
+Rubinius has a port in FreeBSD ports tree. It's called `lang/rubinius`. You
+can find information about this port on <http://freshports.org>. Once being
+installed the port installs all the dependencies automagically.
View
4 web/doc/ru/getting-started.markdown
@@ -11,8 +11,8 @@ next_url: getting-started/requirements
обладаете некоторыми знаниями о Ruby и установке программного обеспечения
на вашу систему.
-Если у вас возникут проблемы с инструкциями, описанными здесь, обратитесь
-за помощью на IRC канал #rubinius на сервере irc.freenode.net.
+Если у вас возникнут проблемы с приводимыми здесь инструкциями, обратитесь
+за помощью на IRC-канал #rubinius сервера irc.freenode.net.
1. [Минимальные требования](/doc/ru/getting-started/requirements/)
1. [Сборка](/doc/ru/getting-started/building/)
View
52 web/doc/ru/getting-started/building.markdown
@@ -7,53 +7,57 @@ next: Запуск Rubinius
next_url: getting-started/running-rubinius
---
-Вы можете собрать и запустить Rubinius из исходной директории. Вам не
-нужно устанавливать Rubinius, чтобы запустить его. Инструкции, приведенные
-ниже, подробно описывают как установку, так и запуск Rubinius из исходного
-каталога.
-
-Rubinius использует LLVM для JIT компиляции. Rubinius зависит от определенной
-версии LLVM. Если LLVM уже установлена на вашей системе передайте флаг
-`--skip-system` в скрипт конфигурации (см. ниже).
+Вы можете собрать и запустить Rubinius прямо из директории с исходниками. Вам не
+обязательно устанавливать Rubinius в систему, чтобы запустить его. Инструкции, приведенные
+ниже, подробно описывают установку и запуск Rubinius из каталога с исходниками.
+
+Rubinius использует
+[LLVM](http://ru.wikipedia.org/wiki/Low_Level_Virtual_Machine) для
+JIT-компиляции. Rubinius зависит от определенной
+версии LLVM, которая должна быть собрана с включенной RTTI (run-time type
+information). Скрипт "`configure`" автоматически проверит эти условия на стадии
+поиска LLVM. Если LLVM уже установлена на Вашей системе, а Rubinius не может
+на нее пролинковаться, передайте флаг
+`--skip-system` скрипту "`configure`" (см. ниже).
### Получение исходного кода
Исходный код Rubinius доступен как tar-архив и как проект на Github.
-Вы можете [скачать tar-архив здесь](http://rubini.us/download/latest).
+Tar-архив можно скачать [здесь](http://rubini.us/download/latest).
Чтобы использовать Git:
- 1. Измените вашу текущую директорию на директорию для разработок
+ 1. Перейдите в директорию для разработок;
2. `git clone git://github.com/evanphx/rubinius.git`
### Установка Rubinius
-Этот раздел для вас, если вы хотите использовать Rubinius для запуска ваших
-приложений. Также вы можете запускать Rubinius прямо из исходной директории
+Этот раздел пригодится, если Вы хотите использовать Rubinius для запуска
+приложений. Также Rubinius можно запускать прямо из исходной директории.
За подробностями обратитесь к следующему разделу.
-Мы рекомендуем устанавливать Rubinius в место, нетребующее `sudo` или права
-суперпользователя. Чтобы установить Rubinius:
+Мы рекомендуем устанавливать Rubinius в место, не требующее `sudo` или права
+суперпользователя. Последовательность действий:
1. `./configure --prefix=/path/to/install/dir`
2. `rake install`
- 3. Следуйте инструкциям, чтобы добавить _bin_ директорию в переменную
- окружения PATH
+ 3. Следуйте инструкциям, чтобы добавить _bin_-директорию в переменную
+ окружения PATH.
### Запуск из директории с исходниками
-Если вы планируете работать над Rubinius, вам следует использовать следующие
-команды.
+Если Вы планируете работать над самим Rubinius-ом, Вам следует использовать следующие
+команды:
1. `./configure`
2. `rake`
-Если вы просто пробуете Rubinius, следуйте инструкциям, чтобы добавить
-_bin_ директорию в переменную окружения PATH.
+Если Вы просто пробуете Rubinius, следуйте инструкциям, чтобы добавить
+_bin_-директорию в переменную окружения PATH.
-Однако, если вы разрабатываете Rubinius, вы не должны добавлять папку _bin_
-в переменную PATH, потому что система сборки Rubinius будет использовать свои
-`ruby` и `rake`, в то время как в процессе сборки ей необходимы отдельные
-исполняемые файлы Ruby.
+Однако, если Вы разрабатываете Rubinius, Вам **не следует** добавлять папку _bin_
+в переменную PATH, потому что система сборки Rubinius будет использовать
+собственные `ruby` и `rake` (ссылки на бинарник Rubinius). Внешние
+исполняемые файлы Ruby необходимы для запуска процесса сборки самого Rubinius.
View
30 web/doc/ru/getting-started/requirements.markdown
@@ -7,31 +7,32 @@ next: Сборка
next_url: getting-started/building
---
-Убедитесь, что у вас установлены следующие программы и библиотеки. Также
-посмотрите разделы ниже с требованиями для каждой конкретной операционной
-системы.
+Убедитесь, что у вас установлены перечисленные программы и библиотеки. Также
+просмотрите нижеприведенные разделы на предмет требований для каждой
+конкретной операционной системы.
-Далее следуют ссылки для получения информации о программах и библиотеках,
-нужных для сборки Rubinius. Для вашей операционной системы или пакетного
-менеджера могут быть доступны другие пакеты.
+Ниже следуют ссылки для получения дополнительной информации о программах и библиотеках,
+нужных для сборки Rubinius. Для вашей операционной системы или менеджера
+пакетов могут быть доступны и другие сборки, помимо перечисленных.
* [GCC и G++ 4.x](http://gcc.gnu.org/)
* [GNU Bison](http://www.gnu.org/software/bison/)
* [MRI Ruby 1.8.7+](http://www.ruby-lang.org/) Если на вашей системе не
установлен Ruby 1.8.7, подумайте об использовании
- [RVM](http://rvm.beginrescueend.com/) для установки.
+ [RVM](http://rvm.beginrescueend.com/) для его установки.
* [Rubygems](http://www.rubygems.org/)
* [Git](http://git.or.cz/)
* [ZLib](http://www.zlib.net/)
- * pthread - Библиотека pthread должна быть установлена вашей операционной системой
+ * pthread: Библиотека pthread должна быть установлена вашей операционной
+ системой.
* [gmake](http://savannah.gnu.org/projects/make/)
- * [rake](http://rake.rubyforge.org/) `[sudo] gem install rake`
+ * [rake](http://rake.rubyforge.org/): `[sudo] gem install rake`
### Apple OS X
-Простейший путь для создания сборочного окружения на Apple OS X
-установка XCode Tools and Utilities. После установки, для формирования
+Простейший путь для создания сборочного окружения на Mac OS X ---
+установка XCode Tools and Utilities. После установки для формирования
отчетов об аварийных завершениях можно использовать приложение
/Developer/Applications/Utilities/CrashReporterPrefs.app
@@ -42,3 +43,10 @@ next_url: getting-started/building
* libreadline5-dev
* zlib1g-dev
* libssl-dev
+
+### FreeBSD
+
+Под FreeBSD есть порт Rubinius, который называется `lang/rubinius`. Подробную
+информацию о порте можно найти на сайте <http://freshports.org>. В процессе
+инсталляции порта установка и настройка всех требуемых вспомогательных
+программ и библиотек происходит автоматически.
View
12 web/doc/ru/getting-started/running-rubinius.markdown
@@ -3,11 +3,11 @@ layout: doc_ru
title: Запуск Rubinius
previous: Сборка
previous_url: getting-started/building
-next: Разрешение проблем
+next: Решение проблем
next_url: getting-started/troubleshooting
---
-После того, как вы прошли шаги по сборке (и, возможно, установке)
+После того, как Вы прошли сборку (и, возможно, установку)
Rubinius, можно проверить его работоспособность:
rbx -v
@@ -16,7 +16,7 @@ Rubinius, можно проверить его работоспособност
rbx -e 'puts "Hello!"'
-Для запуска ruby файла с именем 'code.rb':
+Для запуска ruby-файла с именем 'code.rb':
rbx code.rb
@@ -28,6 +28,6 @@ Rubinius, можно проверить его работоспособност
Rubinius будет себя вести точно также, как MRI. Будут доступны программы
`ruby`, `rake`, `gem`, `irb`, `ri` и `rdoc`.
-Добавляйте директорию bin Rubinius в PATH только тогда, когда вы захотите
-перейти на использование Rubinius. В противном случае он будет использоваться
-вместо вашего стандартного Ruby интерпретатора.
+Добавляйте директорию `bin` Rubinius в PATH только тогда, когда Вы захотите
+перейти на постоянное использование Rubinius. Иначе он будет использоваться
+вместо вашего обычного Ruby-интерпретатора.
View
33 web/doc/ru/getting-started/troubleshooting.markdown
@@ -1,17 +1,17 @@
---
layout: doc_ru
-title: Разрешение проблем
+title: Решение проблем
previous: Запуск Rubinius
previous_url: getting-started/running-rubinius
next: Участие в проекте
next_url: contributing
---
-Ниже приведены ошибки, с которыми вы можете столкнуться в процессе сборки,
-установки или использования Rubinius, вместе с возможными их решениями.
+Ниже приведены ошибки, с которыми Вы можете столкнуться в процессе сборки,
+установки или использования Rubinius, и их возможные решения.
-При любой ошибке, первым делом удостоверьтесь, что вы работаете с чистой
-копией Rubinius. Перед тем, как двигаться дальше, попробуйте выполнить
+При любой ошибке первым делом удостоверьтесь, что Вы работаете с последней чистой
+версией Rubinius. Перед тем, как двигаться дальше, попробуйте выполнить
следующее:
$ git co master
@@ -21,7 +21,7 @@ next_url: contributing
$ rake
-Ошибка:
+### Rubinius не может найти директорию runtime-библиотек
ERROR: unable to find runtime directory
@@ -37,16 +37,27 @@ next_url: contributing
You may have configured Rubinius for a different install
directory but you have not run 'rake install' yet.
-Решение:
+#### Решение
- Если вы конфигурировали rubinius с --prefix, выполните rake install.
+ Если Вы конфигурировали rubinius с `--prefix`, выполните `rake install`.
- Если вы конфигурировали rubinius с --prefix и переименовали инсталяционную
+ Если Вы конфигурировали rubinius с `--prefix` и переименовали инсталяционную
директорию после установки Rubinius, выполните конфигурацию и установку
заново.
- Если вы переименовали директорию c исходниками после сборки Rubinius,
+ Если Вы переименовали директорию c исходниками после сборки Rubinius,
выполните конфигурацию и установку вновь.
Вообще, лучше не переименовывать директорию с исходниками или директорию
- где производилась сборка после сборки Rubinius.
+ инсталляции после сборки Rubinius.
+
+### Rubinius, собранный под FreeBSD, падает по `segfault`
+
+ До версии 8.1-STABLE включительно во FreeBSD существует проблема с
+ библиотекой `execinfo`, приводящая к падению Rubinius при запуске.
+
+#### Решение
+
+ На стадии `configure` отключите `execinfo`:
+
+ ./configure --without-execinfo
View
2  web/doc/ru/index.markdown
@@ -11,7 +11,7 @@ next_url: what-is-rubinius
1. [Минимальные требования](/doc/ru/getting-started/requirements/)
1. [Сборка](/doc/ru/getting-started/building/)
1. [Запуск Rubinius](/doc/ru/getting-started/running-rubinius/)
- 1. [Разрешение проблем](/doc/ru/getting-started/troubleshooting/)
+ 1. [Решение проблем](/doc/ru/getting-started/troubleshooting/)
1. [Участие в проекте](/doc/ru/contributing/)
1. [Общение](/doc/ru/contributing/communication/)
1. [Стиль кодирования](/doc/ru/contributing/style-guide)
View
26 web/doc/ru/what-is-rubinius.markdown
@@ -6,36 +6,36 @@ next_url: getting-started
## Что такое Rubinius
-Rubinius это реализация [языка программирования Ruby](http://ruby-lang.org).
+Rubinius --- это реализация [языка программирования Ruby](http://ruby-lang.org).
Rubinius состоит из байткодовой виртуальной машины, парсера Ruby, компилятора
-в байткод, сборщика мусора, основанного на поколениях, JIT компилятора в
-машинный код и встроенных и стандартных библиотек Ruby.
+в байткод, сборщика мусора, основанного на поколениях, JIT-компилятора в
+машинный код, встроенных (Ruby Core) и стандартных (Standard library) библиотек Ruby.
На данный момент Rubinius совместим с версией Ruby 1.8.7.
## Лицензия
-Rubinius использует BSD лицензию. Ее можно найти в файле LICENSE, в исходниках.
+Rubinius использует лицензию BSD. Ее можно найти в исходниках в файле LICENSE.
## Установка
-Rubinius работает под Mac OS X и многими Unix/Linux совместимыми операционными
-системами. Скоро появится поддрежка Microsoft Windows.
+Rubinius работает под Mac OS X и многими другими операционными
+системами семейства Unix/Linux. Вскоре появится и поддержка Microsoft Windows.
-Для установки Rubinius, проделайте следующие шаги. За более детальной
-информацией обратитесь к [Приступая к работе](/doc/ru/getting-started/).
+Для установки Rubinius выполните указанные ниже команды. Более подробную
+информацию можно найти в разделе [<<Приступая к работе>>](/doc/ru/getting-started/).
1. `git clone git://github.com/evanphx/rubinius.git`
1. `cd rubinius`
1. `./configure --prefix=/путь/до/директории`
1. `rake install`
-Когда процесс утановки завершится, следуя указаниям добавьте bin директорию
-в переменную окружения PATH.
+Когда процесс установки завершится, следуя указаниям, добавьте директорию, в
+которой находятся исполняемые файлы Rubinius, в переменную окружения PATH.
-Rubinius поставляется со встроенными RubyGems и уже содержит предустановленные
-гемы rake и rdoc. Например, чтобы установить гем nokogiri, выполните `rbx gem
-install nokogiri`
+Rubinius поставляется со встроенным пакетом RubyGems и уже содержит предустановленные
+гемы rake и rdoc. Чтобы установить гем nokogiri, например, нужно выполнить
+команду `rbx gem install nokogiri`
Please sign in to comment.
Something went wrong with that request. Please try again.