Install bake
bake is a ruby gem. It runs with Ruby >= 2.0. bake and its depedencies can be found on rubygems, which is configured as ruby source per default.
Attention
The actual name of the bake gem is bake-toolkit.
How to install bake
Installing bake is very easy!
Make sure you have installed Ruby >= 2.0.
Install the bake gem.
User@Host:~$ gem install bake-toolkit
Example:
User@Host:~$ ruby -v # (Check if an appropriate ruby version is installed)
ruby 2.1.2p95 (2014-05-08 revision 45877) [x86_64-darwin13.0]
User@Host:~$ gem install bake-toolkit # (Install the bake gem)
Fetching: highline-1.6.15.gem (100%)
Fetching: colored-1.2.gem (100%)
Fetching: progressbar-0.11.0.gem (100%)
Fetching: rgen-0.6.0.gem (100%)
Fetching: rtext-0.2.0.gem (100%)
Fetching: bake-toolkit-1.0.2.gem (100%)
Successfully installed highline-1.6.15
Successfully installed colored-1.2
Successfully installed progressbar-0.11.0
Successfully installed rgen-0.6.0
Successfully installed rtext-0.2.0
Successfully installed bake-toolkit-1.0.2
7 gems installed
Installing ri documentation for highline-1.6.15...
Installing ri documentation for colored-1.2...
Installing ri documentation for progressbar-0.11.0...
Installing ri documentation for rgen-0.6.0...
Installing ri documentation for rtext-0.2.0...
Installing ri documentation for bake-toolkit-1.0.2...
Installing RDoc documentation for highline-1.6.15...
Installing RDoc documentation for colored-1.2...
Installing RDoc documentation for progressbar-0.11.0...
Installing RDoc documentation for rgen-0.6.0...
Installing RDoc documentation for rtext-0.2.0...
Installing RDoc documentation for bake-toolkit-1.0.2...
Known Issues
The installation does not start
Issue: The installation of the bake gem does not start. (This is often caused by a password-protected internal proxy.)
Solution:
Check your network connection.
Unlock the password protected proxy by opening an external webpage (e.g. google) using your web browser.
Invalid Language Settings
Issue:* The error parsers in bake assume English language.
Solution:
Adjust your language settings e.g by setting the environment variable LC_ALL.
Example:
LC_ALL=en_US
Note
Depending on the system and the compiler the way how to change the language might be different.
Error Message During the installation
Issue: Ruby throws an error during the installation.
Solution: Usually you will see an error like this:
ERROR: While generating documentation for ... ... MESSAGE: Error while evaluating ... undefined method `gsub' for nil:NilClass ...
This is a ruby bug. However, the gems were installed correctly. You can avoid building the documentation by installing bake like this:
User@Host:~$ gem install bake-toolkit --no-rdoc --no-ri