Skip to content
Closed
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
commit the generated html files
  • Loading branch information
ocha- committed Aug 18, 2013
commit 7bee306bc1d99c7a52a381c5f305992ef2517e6b
675 changes: 675 additions & 0 deletions anyeval.html

Large diffs are not rendered by default.

1,422 changes: 1,422 additions & 0 deletions class.html

Large diffs are not rendered by default.

1,755 changes: 1,755 additions & 0 deletions contextual.html

Large diffs are not rendered by default.

1,236 changes: 1,236 additions & 0 deletions evaluator.html

Large diffs are not rendered by default.

364 changes: 364 additions & 0 deletions fin.html

Large diffs are not rendered by default.

1,652 changes: 1,652 additions & 0 deletions gc.html

Large diffs are not rendered by default.

129 changes: 129 additions & 0 deletions index.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,129 @@
<!DOCTYPE html>
<html>
<head>
<meta charset=utf-8 />
<title> Ruby Hacking Guide </title>
<link rel="stylesheet" href="/css/styles.css" />
</head>
<body>

<div id="main">

<header>
<h1><a href="/">Ruby Hacking Guide</a></h1>
<header>

<nav role="navigation">
<ul>
</ul>
</nav>

<h2>Table of contents</h2>
<p>Some chapters are previews. It means they have not been fully reviewed,
some diagrams may be missing and some sentences may be a little
rough. But it also means they are in open review, so do not hesitate
to address issues on the mailing list.</p>
<ul>
<li><a href="preface.html">Preface</a></li>
<li><a href="intro.html">Introduction &#8211; translation in progress</a></li>
</ul>
<h3>Part 1: Objects</h3>
<ul>
<li><a href="minimum.html">Chapter 1: A Minimal Introduction to Ruby</a></li>
<li><a href="object.html">Chapter 2: Objects</a></li>
<li><a href="name.html">Chapter 3: Names and name tables</a></li>
<li><a href="class.html">Chapter 4: Classes and modules</a></li>
<li><a href="gc.html">Chapter 5: Garbage collection</a></li>
<li><a href="variable.html">Chapter 6: Variables and constants</a></li>
<li><a href="security.html">Chapter 7: Security</a></li>
</ul>
<h3>Part 2: Syntax analysis</h3>
<ul>
<li><a href="spec.html">Chapter 8: Ruby Language Details</a></li>
<li><a href="yacc.html">Chapter 9: yacc crash course</a></li>
<li><a href="parser.html">Chapter 10: Parser</a></li>
<li><a href="contextual.html">Chapter 11: Context-dependent scanner</a></li>
<li><a href="syntree.html">Chapter 12: Syntax tree construction</a></li>
</ul>
<h3>Part 3: Evaluation</h3>
<ul>
<li><a href="evaluator.html">Chapter 13: Structure of the evaluator</a></li>
<li><a href="module.html">Chapter 14: Context</a></li>
<li><a href="method.html">Chapter 15: Methods</a></li>
<li><a href="iterator.html">Chapter 16: Blocks</a></li>
<li><a href="anyeval.html">Chapter 17: Dynamic evaluation</a></li>
</ul>
<h3>Part 4: Around the evaluator</h3>
<ul>
<li><a href="load.html">Chapter 18: Loading</a></li>
<li><a href="thread.html">Chapter 19: Threads</a></li>
</ul>
<ul>
<li><a href="fin.html">Final chapter: Ruby&#8217;s future &#8211; translation unstarted</a></li>
</ul>
<h1>About this Guide</h1>
<p>This is a new effort to gather efforts to help translate into English the <a href="http://i.loveruby.net/ja/rhg/book/">Ruby
Hacking Guide</a>. The <span class="caps">RHG</span> is a book
that explains how the ruby interpreter (the official
C implementation of the <a href="http://www.ruby-lang.org/">Ruby language</a>) works
internally.</p>
<p>To fully understand it, you need a good knowledge of C and Ruby.</p>
<p>Please note that this book was based on the source code of ruby 1.7.3
so there are a few small differences to the current version of
ruby. However, these differences may make the source code simpler to
understand and the Ruby Hacking Guide is a good starting point before
looking into the ruby source code. The version of the source code used
can be downloaded here: http://i.loveruby.net/ja/rhg/ar/ruby-rhg.tar.gz.</p>
<p>Many thanks to <a href="http://rubyforge.org">RubyForge</a> for hosting us and to
Minero <span class="caps">AOKI</span> for letting us translate his work.</p>
<h2>Help us!</h2>
<p>The original is available <a href="http://i.loveruby.net/ja/rhg/book/">here</a>
or hosted within this repo <a href="http://ruby-hacking-guide.github.com/original_repo/ja_html/">here</a>
(currently with broken formatting)</p>
<p>This translation is done during our free time, do not expect too
much. The book is quite big (more than 500 pages) so we need help to
translate it.</p>
<p>People who are good at Ruby, C and Japanese or English are
needed. Those good at Japanese (native Japanese speakers are of course
welcome) can help translate and those good at English (preferably
native speakers) can help correct mistakes, and rewrite badly written
parts&#8230; Knowing Ruby and C well is really a requirement because it
helps avoiding many mistranslations and misinterpretations.</p>
<p>People good at making diagrams would also be helpful because there is
quite a lot to redo and translators would rather spend their time
translating instead of making diagrams.</p>
<p>There have been multiple efforts to translate this book, and we want to see if
we can renew efforts by creating an organisation on github. Interested parties
can join in by starting a pull request on this repo
https://github.com/ruby-hacking-guide/ruby-hacking-guide.github.com
There is a mostly derelict mailing list at
<a href="http://rubyforge.org/mailman/listinfo/rhg-discussion">rhg-discussion mailing list</a>
feel free to introduce yourself (who you are, your skills, how much free time you
have), but I think the best way to propose or send corrections/improvements
is to send a pull request. If you start a feature branch along with a pull
request at the start of your work then people can comment as you work.</p>
<p>There is an old <span class="caps">SVN</span> repo, that is hosted at
The RubyForge project page is http://rubyforge.org/projects/rhg.
It has been imported here, and I will attempt to give credit and re-write the
<span class="caps">SVN</span>/Git history when I can.</p>
<p>As for now the contributors to that repo were:</p>
<ul>
<li>Vincent <span class="caps">ISAMBART</span></li>
<li>meinrad recheis</li>
<li>Laurent Sansonetti</li>
<li>Clifford Caoile</li>
<li>Jean-Denis Vauguet</li>
</ul>

<footer>
The original work is Copyright © 2002 - 2004 Minero AOKI.
Translated by Vincent ISAMBART and Clifford Escobar CAOILE
This work is licensed under a
<p>
<a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/2.5/">Creative Commons Attribution-NonCommercial-ShareAlike2.5 License</a>
</p>
</footer>

</div>
</body>
</html>
Loading