ruby-hacking-guide / ruby-hacking-guide.github.com Goto Github PK

I think we have some lack of clarity on the license of this project.
I'll try and dig out the original reference to the licensing as we are missing a license file on here.

As Peter Zotov @whitequark has kindly agreed us to use his translation under a http://creativecommons.org/licenses/by-nc-sa/3.0/us/, and Aoki-san I believe originally gave his permission to the original Rubyforge project to be distributed under a Creative Commons licence.

We just need to verify this, and add the actual license to the project.

I was talking to Mark on Hacker News and offered to help maintain a PDF version of this guide. I'd love to host a PDF version along with the HTML version of the guide for anyone who wants a book-like experience while reading. Anyone opposed to me tackling that?

I have a commandline tool (http://github.com/davejacobs/mint) that can almost handle this task, but one blocker is that the source files aren't ordered by chapter.

Is there any problem with me adding a chapter number to each file name (and associated references)?

The images figures in the garbage collection chapter are broken.

http://ruby-hacking-guide.github.io/gc.html
http://loveruby.net/ja/rhg/book/gc.html

Is it worth including the untranslated versions as a temporary measure?

I'd like to contribute to this project as an official successor of
the original project at RubyForge .
But I think including integrated guide is a problem because

1. I don't think integrated guide was in the original project repository.
   It seems a different project.
2. It seems kind of his note that partially includes translations of RHG,
   it includes a lot of extra texts,
   I guess that's why the word "integrated" is in title.

➜  ruby-hacking-guide.github.com-master  ruby script/publish
Configuration file: /Users/zhufenggood/Downloads/ruby-hacking-guide.github.com-master/_config.yml
            Source: /Users/zhufenggood/Downloads/ruby-hacking-guide.github.com-master
       Destination: /Users/zhufenggood/Downloads/ruby-hacking-guide.github.com-master/_site
      Generating... done.
fatal: Not a git repository (or any of the parent directories): .git
/Users/zhufenggood/.rvm/gems/ruby-1.9.3-p362@jekll/gems/zip-2.0.2/lib/zip/zip.rb:959:in `put_next_entry': wrong number of arguments (5 for 2) (ArgumentError)
    from /Users/zhufenggood/.rvm/gems/ruby-1.9.3-p362@jekll/gems/eeepub-0.8.0/lib/eeepub/ocf.rb:96:in `block (2 levels) in save'
    from /Users/zhufenggood/.rvm/gems/ruby-1.9.3-p362@jekll/gems/zip-2.0.2/lib/zip/zip.rb:942:in `open'
    from /Users/zhufenggood/.rvm/gems/ruby-1.9.3-p362@jekll/gems/eeepub-0.8.0/lib/eeepub/ocf.rb:95:in `block in save'
    from /Users/zhufenggood/.rvm/gems/ruby-1.9.3-p362@jekll/gems/eeepub-0.8.0/lib/eeepub/ocf.rb:126:in `block in create_epub'
    from /Users/zhufenggood/.rvm/rubies/ruby-1.9.3-p362/lib/ruby/1.9.1/fileutils.rb:125:in `chdir'
    from /Users/zhufenggood/.rvm/rubies/ruby-1.9.3-p362/lib/ruby/1.9.1/fileutils.rb:125:in `cd'
    from /Users/zhufenggood/.rvm/gems/ruby-1.9.3-p362@jekll/gems/eeepub-0.8.0/lib/eeepub/ocf.rb:121:in `create_epub'
    from /Users/zhufenggood/.rvm/gems/ruby-1.9.3-p362@jekll/gems/eeepub-0.8.0/lib/eeepub/ocf.rb:94:in `save'
    from /Users/zhufenggood/.rvm/gems/ruby-1.9.3-p362@jekll/gems/eeepub-0.8.0/lib/eeepub/maker.rb:83:in `save'
    from script/publish:109:in `<main>'

try

gem uninstall rubyzip
gem install rubyzip -v 0.9.9

Solve the problem and successful generate epub file.

https://ruby-hacking-guide.github.io/class.html
In the "Compressed rb_singleton_class()" section, there is a line:

701      if (FL_TEST(RBASIC→klass, FL_SINGLETON) &&

However the correct one should be:

701      if (FL_TEST(RBASIC(obj)->klass, FL_SINGLETON) &&

(from http://i.loveruby.net/ja/rhg/book/class.html).

FL_TEST(<acronym title="obj"><span class="caps">RBASIC</span></acronym>

The html source shows that the obj term becomes part of an <acronym> tag, seems like wrong generated.

Can we get a PDF version because my iPad can't read it in epub. I've generated it as the instruments but I can only see this on iBooks.

I think PDF can be friendly to more platforms. Can anyone help to generate one?
Thanks!

I just came across this recently.
http://whitequark.org/blog/2013/04/01/ruby-hacking-guide-ch-11-finite-state-lexer/?utm_source=rubyweekly&utm_medium=email

What does anyone think?

I might contact the translator, to see if he'd like to contribute at least this chapter to RHG.

I will look it over again for errorbut I just want to add it to my repository if that’s ok.