diff --git a/README.md b/README.md index d3cc4af..2505d5b 100644 --- a/README.md +++ b/README.md @@ -42,8 +42,6 @@ Xvfb or virtual framebuffer Xserver for Version 11 [Xvfb Manpages] 3. Use Xvfb to run the headless rake command `xvfb-run rake jasmine:headless` or `xvfb-run jasmine-headless-webkit -c` 4. Reference: [MARTIN DALE LYNESS](http://blog.martin-lyness.com/archives/installing-xvfb-on-ubuntu-9-10-karmic-koala) -# Gotcha(s) - ## Qt 4.7.X The gem is compiled using **qt4-qmake** and you will need Qt 4.7.x or greater. diff --git a/index.md b/index.md index d71be27..eeb8add 100644 --- a/index.md +++ b/index.md @@ -329,6 +329,62 @@ rake jasmine:headless # Run Jasmine specs headlessly This is the same as running `jasmine-headless-webkit -c`. +## Continuous Integration + +Since most continuous integration servers do not have a display, you will need to use +Xvfb or virtual framebuffer Xserver for Version 11 [Xvfb Manpages](http://manpages.ubuntu.com/manpages/natty/man1/Xvfb.1.html) + +1. sudo apt-get install xvfb` +2. run `Xvfb :99 -ac` and resolve missing dependencies. + * sudo apt-get install x11-xkb-utils + * sudo apt-get install xfonts-100dpi xfonts-75dpi xfonts-scalable xfonts-cyrillic + * sudo apt-get install xserver-xorg-core +3. Use Xvfb to run the headless rake command `xvfb-run rake jasmine:headless` or `xvfb-run jasmine-headless-webkit -c` +4. Reference: [MARTIN DALE LYNESS](http://blog.martin-lyness.com/archives/installing-xvfb-on-ubuntu-9-10-karmic-koala) + +## Qt 4.7.X + +The gem is compiled using **qt4-qmake** and you will need Qt 4.7.x or greater. +To test if it is installed, you should run `qmake --version` and you should +receive something like: + + QMake version 2.01a + Using Qt version 4.7.2 in /usr/lib + +If you receive a different message, you can install qt4-qmake using the following commands as root: + +### Ubuntu 11.04 + + sudo apt-get install libqt4-dev + sudo apt-get install qt4-qmake + +### Mac OS X 10.6 + + sudo port install qt4-mac + +### Ubuntu 9.10 + +Running `sudo apt-get install libqt4-dev` and `sudo apt-get install qt4-qmake` will install qt4, +but it installs **version 4.5.2**, which will not be able to install +`gem "jasmine-headless-webkit"`, as it requires Qt 4.7.X or later version. + +You will need to compile qt4-qmake from source +[Qt version 4.7.0](http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.7.0.tar.gz). +There are excellent [directions](http://doc.qt.nokia.com/latest/install-x11.html) on how to compile +the source code. You will need to ensure Qt is exported to your $PATH before using qmake, as it will +install to /usr/local/Trolltech/. + +## RubyMine + +RubyMine may throw an error when running rake spec, you will need to provide a +JavaScript runtime environment. Install `gem "therubyracer"` to resolve this problem. + + rake aborted! + Could not find a JavaScript runtime. + See https://github.com/sstephenson/execjs + for a list of available runtimes. + + ## I have a problem or helpful suggestion, good sir. Here's what you can do: