Dependent on Qt
capybara-webkit depends on a WebKit implementation from Qt, a cross-platform development toolkit. You'll need to download the Qt libraries to build and install the gem.
OS X Lion 10.7:
Install Qt via homebrew (NOTE: can take more than an hour) using:
brew install qt --build-from-source
OS X < 10.7:
Download the non-debug Cocoa package (the smaller of the two downloads).
apt-get install libqt4-dev
yum install qt-webkit-devel
Other Linux distributions:
If you're like us, you'll be using capybara-webkit on CI.
On Linux platforms, capybara-webkit requires an X server to run, although it doesn't create any visible windows. Xvfb works fine for this. You can setup Xvfb yourself and set a DISPLAY variable, or try out the headless gem.
Add the capybara-webkit gem to your Gemfile:
See the CONTRIBUTING document.
The capybara WebKit driver was written by Joe Ferris, Tristan Dunn, and Jason Morrison from thoughtbot, inc.
Code for rendering the current webpage to a PNG is borrowed from Phantom.js' implementation.
The names and logos for thoughtbot are trademarks of thoughtbot, inc.
capybara-webkit will listen on port 8200. This may conflict with other services.
capybara-webkit is Copyright (c) 2011 thoughtbot, inc. It is free software, and may be redistributed under the terms specified in the LICENSE file.