<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html lang="en">
<head>
<title>
WebMake: Documentation: csvtable_tag.wmk
</title>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
<meta name="generator" content="WebMake/2.3" />
<style type="text/css">
body {
background-color: #ffffff;
color: #000000;
line-height: 110%;
margin-left: 10px;
margin-right: 10px;
}
p, table, td, th {
font-family: verdana,lucida,helvetica,sans-serif;
font-size: 11px;
line-height: 110%;
}
pre {
margin-left: 3%;
white-space: pre;
}
code, samp, pre, p pre {
font-family: "lucida console", "Courier New", courier, "fixed-width", monospace;
font-weight: bold;
}
H1 {
font-size: 150%; font-family: Garamond, "Book Antiqua",Times,serif;
background: #FFCC66; text-align: center;
padding: 0.5em 1em 0.5em 1em; border-width: 1px;
border-color: black; border-style: solid; line-height: 120%;
}
H2 {
font-size: 125%; font-family: Garamond, "Book Antiqua",Times,serif;
background: #FFDD77; text-align: center;
padding: 0.5em 1em 0.5em 1em; border-width: 1px;
border-color: black; border-style: solid; line-height: 100%;
}
H3 {
font-size: 100%; font-family: Garamond, "Book Antiqua",Times,serif;
background: #FFEE88; text-align: center;
padding: 0.5em 1em 0.5em 1em; border-width: 1px;
border-color: black; border-style: solid;
}
H4 { font-size: 75%; font-family: Garamond, "Book Antiqua",Times,serif; }
H5 { font-size: 50%; font-family: Garamond, "Book Antiqua",Times,serif; }
H6 { font-size: 25%; font-family: Garamond, "Book Antiqua",Times,serif; }
A:link {
font-weight: bold;
color: #004000;
text-decoration: underline;
}
A:visited {
font-weight: bold;
color: #008000;
text-decoration: underline;
}
A:active {
font-weight: bold;
color: #800000;
text-decoration: underline;
}
dt {
font-size: medium;
font-weight: bold;
padding-top: 8px; padding-bottom: 8px;
}
dd {
padding-top: 8px; padding-bottom: 8px;
}
</style>
</head>
<body bgcolor="#ffffff" text="#000000" link="#3300cc" vlink="#660066">
<!-- font tag for compat with non-CSS browsers -->
<font face="lucida,verdana,sans-serif">
<div align="center">
<img src="images/WebMakeTitle.png" alt="WebMake" width="500" height="122" />
</div>
<table width="100%">
<tr>
<td valign="top">
<strong><a href="http://webmake.taint.org/">WebMake</a>
Documentation</strong> (version 2.3)
</td>
<td valign="top">
<div align="right">
[ <a href="index_10-perllib.html">Back</a> | <a href="download_tag.wmk.html">Forward</a> | <a href="index.html">Index</a>
| <a href="allinone.html">All In One</a> ]
</div>
</td>
</tr>
</table>
<!-- yes, it's that Mozilla black-border code again ;) -->
<!-- stolen from www.mozilla.org via rc3.org -->
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td bgcolor="#aaaaaa">
<table border="0" cellspacing="4" cellpadding="4" width="100%">
<tr>
<td bgcolor="#ffffff">
<table border="0" cellspacing="4" cellpadding="4" width="100%">
<tr>
<td>
<h1>csvtable_tag.wmk</h1><a name="__index__"></a><!-- INDEX BEGIN -->
<ul>
<li>
<a href="#loading">LOADING</a>
</li>
<li>
<a href="#html tags">HTML TAGS</a>
</li>
<li>
<a href="#description">DESCRIPTION</a>
</li>
<li>
<a href="#example">EXAMPLE</a>
</li>
<li>
<a href="#thanks">THANKS</a>
</li>
</ul>
<!-- INDEX END -->
<hr />
<h1><a name="loading">LOADING</a></h1><pre>
<use plugin="csvtable_tag" /></pre><hr />
<h1><a name="html tags">HTML TAGS</a></h1><pre>
<csvtable [delimiter="char"] [HTML table attributes]>
[...cells...]
</csvtable></pre><hr />
<h1><a name="description">DESCRIPTION</a></h1><p>
This WebMake Perl library provides a tag to allow HTML tables to be
constructed, quickly, using a tab-, comma-, or pipe-separated value table.
</p>
<p>
Firstly, pick a delimiter character, such as <code>|</code>. Set the <code>delimiter</code>
attribute to this character.
</p>
<p>
Each line of the CSV table will become a <TR>; each delimiter-separated cell
will be enclosed in a <TD> tag pair.
</p>
<p>
Attributes for the HTML table tag itself, can be provided as attributes to this
tag; they will be passed through into the resulting <TABLE> tag.
</p>
<p>
By default, items inside the tables are represented as <TD> cells, with no
attributes. Certain special line prefixes allow control over formatting of
table items, as follows. These are all case-insensitive, and whitespace after
them will be stripped; but they must start on the first character of the line
(no leading spaces), and, despite how they're rendered here, should not contain
any spaces between the angle brackets.
</p>
<p>
Blank lines are skipped.
</p>
<dl>
<dt>
<strong><a name="item_%3C%21%2D%2D_%2E%2E%2E%2E_%2D%2D%3E"><!-- .... --></a></strong><br />
</dt>
<dd>
Comments, a la HTML.
</dd>
<dt>
<strong><a name="item_%3Ccsvfmt%3E"><csvfmt></a></strong><br />
</dt>
<dd>
The rest of the line is used to specify the format to be used for each line
afterwards, until the end of the <csvtable>, or until the next <csvfmt>
line.
<p>
The line should end in a </csvfmt> closing tag.
</p>
<p>
Specify a <tr>...<tr> block, with $1, $2, $3, etc. for the numbered cells
(counting from 1). For example:
</p>
<pre>
<csvfmt><tr><td>$1</td><td>$2</td><td>$3</td></tr></csvfmt></pre>
</dd>
</dl>
<hr />
<h1><a name="example">EXAMPLE</a></h1><pre>
<csvtable delimiter="|">
<!-- heading --E<gt>
<csvfmt><tr><th>$1</th><th>$2</th><th>$3</th></tr></csvfmt>
First Name|Surname|Title
<!-- contents --E<gt>
<csvfmt><tr><td>$1</td><td>$2</td><td>$3</td></tr></csvfmt>
Justin|Mason|JAPH
Foo|Bar|Baz
</csvtable></pre><hr />
<h1><a name="thanks">THANKS</a></h1><p>
Thanks to Chris Barrett; he suggested this tag.
</p>
</td>
</tr>
</table>
</td>
</tr>
</table>
</td>
</tr>
</table>
<table width="100%">
<tr>
<td valign="top">
<strong><a href="http://webmake.taint.org/">WebMake</a>
Documentation</strong> (version 2.3)
</td>
<td valign="top">
<div align="right">
[ <a href="index_10-perllib.html">Back</a> | <a href="download_tag.wmk.html">Forward</a> | <a href="index.html">Index</a>
| <a href="allinone.html">All In One</a> ]
</div>
</td>
</tr>
</table>
<div align="right">
<a href="http://webmake.taint.org/"> <img src="images/BuiltWithWebMake.png" alt="Built With WebMake" border="0" width="88" height="31" /></a>
</div>
</font>
</body>
</html>
