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 !