artemus_cmd(3)

NAME
artemus - Text substitution tool and much more

SYNOPSIS
 artemus -i|--input={input file} -o|--output={output file}
        [-c|--conf={config file}]
        [-p|--paragraph={paragraph_separator}]
        [-m|--msdos] [-a|--append]

DESCRIPTION
artemus is a text substitution tool (thought mainly for preprocessing HTML). Macros are defined in the file artemus.conf, in the form key=value, being value the destination text, that can have parameters. The macro is included in the source file between the {- and } marks. The (possible) parameters are delimited by the | symbol.

Examples:

In artemus.conf file:

 # some simple definitions
 Perl=<a href="http://www.perl.com">Perl</a>
 LWN=<a href="http://www.lwn.net">Linux Weekly News</a>
 separator=<br><hr><br>
 head=<html><body bgcolor=ffffff>

 # definitions with parameters
 # generic link
 link=<a href="http://$1">$0</a>
 # generic meta
 meta=<meta name="$1" content="$0">
 # link using the link macro
 CPAN={-link|CPAN|www.cpan.org}

In a source file index.artemus:

 {-head}
 {-meta|links, free software|keywords}
 <h1>Links</h1>
 <ul>
 <li>{-Perl}
 <li>{-LWN}
 <li>{-CPAN}
 <li>{-link|kernel.org|www.kernel.org}
 </ul>
 {-separator}

By running

 artemus -i index.artemus -o index.html

you obtain the file index.html:

 <html><body bgcolor=ffffff>
 <meta name="keywords" content="links, free software">
 <h1>Links</h1>
 <ul>
 <li><a href="http://www.perl.com">Perl</a>
 <li><a href="http://www.lwn.net">Linux Weekly News</a>
 <li><a href="http://www.cpan.org">CPAN</a>
 <li><a href="http://www.kernel.org">kernel.org</a>
 </ul>
 <br><hr><br>

The --paragraph argument let us define a string to substitute the empty lines in the document. If defined as <p>, you can create HTML documents separating the paragraphs with only a blank line, as artemus will fill them with <p>.

The --msdos argument creates the typical MSDOS end of line, CR+LF.

The --append argument appends the output to destination file, instead of overwriting it.

AUTHOR
(C) Angel Ortega <angel@triptico.com> 2000/2008