HtmlFixture Improved README

INFO

project page is at http://sourceforge.net/projects/htmlfixtureim

INSTALLATION

1. install and start FitNesse as instructed at 
http://www.fitnesse.org/FitNesse.DownloadingAndInstallingFitNesse

2. under your installation directory for fitnesse, create a directory called "lib"

3. copy the jars in htmlfixture-VERSION/lib into the lib directory you created in 2

4. copy the htmlfixture-VERSION/log4j.properties file to the root of your fitnesse install directory

5. edit the root page on your FitNesse wiki ( if you followed the installation
 directions in 1 exactly, this will be http://localhost/root?edit ) and
 add the following text (where [PATH-TO-LIB] is the full path to the lib directory you created in step 2):

!path [PATH-TO-LIB]/*

!fixture com.jbergin.HtmlFixture

7. in the SetUp for any test you create, include the following text:

|Import|
|com.jbergin|

8. to create a fit table that accesses HtmlFixture, start with

!|HtmlFixture|
|URL|


Here is my acknowledgement for htmlunit LICENSE: 
 *       "This product includes software developed by Gargoyle Software Inc.
 *        (http://www.GargoyleSoftware.com/)."

DEMO

To install the demo, copy htmlunit-VERSION/doc/FitNesseRoot/HtmlFixtureDemo
 to your FitNesseRoot directory where you installed fitnesse

TEST OUTPUT

Many tests create html output showing the tables excercised by the test. 
 This will be the most complete and authoritative set of documentation and
 examples of htmlfixture improved usage.  `mvn test` creates these files in
 the doc/html directory.  copy these files and the to the document root of
 a standard webserver to view the output

LOGGING

Logging is controlled by the log4j.properties file in your root fitnesse directory.
 Valid values for the logger level are: debug, info, warn, error, and fatal. 
 Note that the debug level will print out all communication that goes in or out of the simulated webclient.

COMPILATION

This project builds with maven-2 ( http://maven.apache.org/download.html ). 
 Once maven is set up, download and unzip htmlfixture-VERSION-src.zip, cd to htmlfixture and execute

mvn install

To create the bin zip file from source, execute

mvn assembly:assembly