Tablin 0.6b2
------------

HTML Tables, whether used for layout or for real data, can create 
problems for people reading the Web line-by-line. This usually happens 
when there is a mismatch between the rendering engine parsing the 
Table and the needs of the presentation engine interacting with the 
end-user. 

Tablin is a filter program developed by the WAI Evaluation & Repair (ER) 
group that can linearize HTML tables and render them accordingly to 
preferences set by the presentation layer 
(e.g. the screen reader end-user).


Running the linearizer
----------------------

	* Get a Java interpreter and install it
	  jdk1.1.7B is required
	  You can download sun's Java interpreter for free from:
		http://www.javasoft.com

	* Set your CLASSPATH environment variable to include 
	  Tablin's classes

	  On Windows
	    set classpath=<instdir>\lib\tablin.jar;.;%CLASSPATH%

	  On Unix
	    export CLASSPATH=<instdir>/lib/tablin.jar:.:$CLASSPATH


	  Where <instdir> is the of the directory where you install 
	  Tablin.

	* Set your CLASSPATH environment variable to include 
	  servlet's classes
	  This version of Tablin works with jsdk2.0 (no test with 2.1)
	  Servlet's classes only required if you want to use tablin 
	  like servlet.
	  You can download servlet's classes for free from:
		http://www.javasoft.com

	* There are now 3 possibilities to execute the program
		1) command line
		     Go in <instdir> directory and execute the commande
		     following
		  java org.w3c.wai.tablin.Linearize -help

		  Below the options which you can use:

-e      : activate embedded mode
-base   : url uses to change the relative url on embedded adress
-help   : to see the options supported
-t      : To linearize the n th tables (0 for all)
-orient : row, column,markup (default: row first)
-r      : recursive mode (true,false: default)
-hs     : header separator (string,default: ", ")
-vs     : value separator (string,default: "= ")
-cs     : cell separator (string, default: ", ")
-ls     : line separator (string, default: "\n")
-o      : file result
-file   : Linearize the specified file (local disk)
-url    : Linearize the specified url
-x      : active the mode for lynx
-repeat : all4all (repeat all headers for each cell)
	  deepest4all (repeat deepest headers for each cell)
	  all (repeat column or row headers according to the value 
	      to the parameter orientation) 
	  deepest (repeat deepest column or row headers according to the value 
	      to the parameter orientation)
-conf   : give the full path to access config.cfg
-tag    : give the full path to access tag.dec
-javacc : to use the old engine with javacc
-ver	: give the version

		2) Launching GUI
 		  Go in <instdir> directory and execute the commande
		     following
		  java org.w3c.wai.tablin.tools.GUILinear

		NOTE: If this message appears after you execute one
		      of the two command above
			
			> config.cfg doesn't exists.
			
		      You are in a bad directory. You can (at the moment)
		      execute the program only in <instdir> directory.
		
		3) You can use this program in servlet mode too.
		   Use the servlet (and his properties) in 
		   <instdir>/examples

		   For example with the jsdk2.0, to launch the servlet
		   you make:
		   
		   On Windows:
		     servletrunner -d <instdir>\examples\ -s <instdir>\examples\servlet.properties
		
		   On Unix
		     servletrunner -d <instdir>/examples/ -s <instdir>/examples/servlet.properties


Configuration:
--------------

If you want use the tablin like a web tool, please edit index.html in
examples directory. You must change the value of the action attribute  
of the FORM tag. Put has the place the address (URL) of the servlet 
which you will use.
Make the same thing with the servlet.properties file (in examples directory 
too).
Change the value of tag parameter of the servlet in servlet.properties file. 
Put the path to access the tag.dec file.
If you use Tablin with GUI or with command line edit config.cfg file
in config directory and put a valid adress of a servlet.
These change are useful for the correct execution of the servlet and 
for the recursive mode in all case. 


Simple use:
-----------

You can test with HTML and TABLE in directory test.
For instance, try:
 java org.w3c.wai.tablin.Linearize 
	-url http://www.w3.org/WAI/ER/tablin/source/Tablin/test/exemple.html 
        -t 1 -cs '\n ' -o new.htm

and look at new.htm


Authors : 
---------

Eric Cabrit <Eric.Cabrit@sophia.inria.fr>
Daniel Dardailler <danield@w3.org> - send mail at this adress.

Enjoy !


