39

I am installing ruby on rails 4.0.0 on my linux system , but i am getting this kind of errors unable to convert "\x89" from ASCII-8BIT to UTF8 for guides/assets/images/getting_started/routing_error_no_route_matches.png, skipping and many similar errors , i read here that it won't cause any effect ,but i do not understand why it is coming . Any pointers?

nerdiplayboy
  • 556
  • 2
  • 9
  • 17

3 Answers3

44

You need to update / install a version of the rdoc gem that supports the conversion. Then these errors won't appear during generation of the documentation when you install rails or when you regenerate the documentation.

gem install rdoc

Then to regenerate the documentation

gem rdoc --all --overwrite
Brian
  • 6,717
  • 2
  • 23
  • 31
  • 6
    As a general practice, it's a good idea to `gem update --system` and `gem update` before installing additional gems. – garbagecollector Feb 09 '14 at 23:54
  • `sudo gem update --system && sudo gem update && sudo gem install rdoc && sudo` `gem rdoc --all --overwrite;` worked well for me; whereas setting/exporting/changing environment variables did not. – voices Nov 25 '15 at 06:32
6

Set such environment variables before you do install:

export LANGUAGE=en_US.UTF-8
export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8
Vitaliy Yanchuk
  • 1,463
  • 1
  • 11
  • 22
1

If you prefer using online documentation to using rdoc and ri, then you can avoid these errors and speed up your installs by skipping the rdoc and ri installations. Michael Hartl recommends this in his book. Just add a .gemrc file to your home directory with the following contents:

install: --no-rdoc --no-ri
update: --no-rdoc --no-ri
coberlin
  • 508
  • 5
  • 7