---
name: "tag2html"
section: "1"
platform: "linux"
package: "tag-types"
version: "0.0.9-4"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/tag2html"
---

# tag2html(1)

convert a tag file to html

## NAME

tag2html - convert a tag file to html

## SYNOPSIS

**tag2html** **\[-h\]** **\[-H\]** **\[-t tagname1 tagname2 ...\]** **\[-l literal ...\]** **\[-u tagname3\]**

## DESCRIPTION

tag2html takes in a tag file on stdin and produces html on stdout. By default it produces output as a series of definition lists, one for each record. It can also produce a table format.

## OPTIONS

- **-h**

  Disables normal header processing. If this is not present then the first record is assumed to be a header, and will not be output

- **-t tagname1 ...**

  Produce an html table, using the tagnames given as the columns, with their values in successive tag records as the data in the table rows

- **-l literal**

  Implies table mode. Writes a literal value in that table column. The dollar sign ($) is a special character, with the following meanings\
    $n - insert the current record number\
    $v fieldname: - insert the value of that field\
    $$ - insert a dollar sign

- **-u tagname...**

  The value of the field is assumed to be a valid URL and is written out as an active link. Works in table or list mode.

- **-T t\_header1 ...**

  Label the table columns with the headers given, rather than the default of using the tag labels - only useful in table mode **-o options** Insert the options text into the html TABLE tag

## EXAMPLES

The literal field value can be useful when calling tag2html from a cgi script, in order to pass control back to the script, for example\
  \-l '\<a href=/cgi-bin/scriptname/someaction/$vPrimary:\>' This could be used for a script called **scriptname** acting on a tag file with a primary field called **Primary**\
  \- the whole string from the dollar sign to the colon is replaced by the value of that field.

## SEE ALSO

[tagprogs(1)](/tagprogs/1.md), [tag(5)](/tag/5.md)

## AUTHOR

John Lines (john@paladin.demon.co.uk)