table is a perl script for creating HTML tables consisting of links to the same
files in different formats.

Copyright (c) 2018 Tim Chadburn.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the file "fdl.txt" which is part of this
package.

table is a perl script for creating HTML tables consisting of links to the same
files in different formats. Each row in the table is a file, and each column is
a file format.

The program is controlled through three configuration files in a configuration
directory. The configuration directory is given as the only argument to table.
Hence table is invoked like this:

table CONF-DIR

The three files are file-types, which determines the names of the columns,
file-exts, which determines the filename extensions of the file types which the
columns represent, and rows, which determines the names of the files which the
rows represent. In each case each entry in the file takes up one line. The
names given in rows represent the filename without an extension.

For each cell in the table, this script produces a link with the text being
the size of the file in bytes if a file whose name matches the concatenation
of the row name, a dot and the column file extension can be found in the
current directory. For example if the row name is `alone' and the file extension
for the column is `ogg', the file `alone.ogg' will be searched for. If the
file is not found the cell will be left blank.

Example file contents for file-types might be:

Ogg Vorbis
FLAC
PDF
PostScript
LilyPond
Lyrics

An example file-exts for the same table would be:

ogg
flac
pdf
ps
ly
txt

An example rows would be:

alone
wizards-apprentice
the-best-surprise-ever
life-force
sixteen
no-way-out
you're-not-listening
tsk-tsk
timetabled
i-dont-understand
soap
you-know-who-you-are
thmoov
the-telephone-man
everyone-else-can-do-it-so-why-can't-i
ancients
sunrise
march-of-the-undead
glade
signs-of-life
7
everdawn
waterfall
vaguely-jazzy-thing
celebration-of-the-organ-being-fixed
reasons-to-be-cheerful
i've-got-a-heart
for-what-it's-worth
buffer
nine-years