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=\lib\tablin.jar;.;%CLASSPATH% On Unix export CLASSPATH=/lib/tablin.jar:.:$CLASSPATH Where 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 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 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 directory. 3) You can use this program in servlet mode too. Use the servlet (and his properties) in /examples For example with the jsdk2.0, to launch the servlet you make: On Windows: servletrunner -d \examples\ -s \examples\servlet.properties On Unix servletrunner -d /examples/ -s /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 Daniel Dardailler - send mail at this adress. Enjoy !