<?xml version="1.0" encoding="iso-8859-1" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<!--http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd-->
<html xmlns="http://www.w3.org/1999/xhtml"
>
<head><title>driver</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<meta name="generator" content="TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)" />
<meta name="originator" content="TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)" />
<!-- xhtml,th4,index -->
<meta name="src" content="mn.tex" />
<meta name="date" content="2007-07-08 23:10:00" />
<link rel="stylesheet" type="text/css" href="mn.css" />
</head><body
>
<a
href="mn-port.html#mn36.html" >exit driver</a>
<h3 class="SubSectionHead"><a
name="QQ1-36-49"></a>Driving the Translation of Pictures and Other Tasks</h3>
<a
name="index36-49001"></a> <a
name="index36-49002"></a> <a
name="index36-49003"></a>TeX4ht outputs a script file (‘<span class="cmtt-10">.lg</span>’) describing how the dvi file (extension ‘<span class="cmtt-10">.idv</span>’) of pictures should
be processed, the CSS instructions to be included for the file, and user-initiated requests from the
operating system. In the default setting, the script file holds abstract commands similar to the following
ones.
<dl > <dt><span class="cmtt-10">--- needs --- source.idv[i] ==> target.png ---</span></dt><dd>
<!--l. 7480--><p class="indent" > An abstract command of this form requests that the i’th page in the dvi file will be translated into a target file
whose name is provided.
</p>
</dd><dt><span class="cmtt-10">--- characters --- </span></dt><dd>
<!--l. 7488--><p class="indent" > This abstract command is a identifies where the requests for pictorial characters start.
</p>
</dd></dl>
<!--l. 7493--><p class="indent" > A manual brute-force execution of the abstract commands can be a tedious job for large number of pictures.
The <span class="cmtt-10">t4ht </span>is in essence an interpreter for these abstract commands.
</p><!--l. 7498--><p class="indent" > Another possible approach for automating the process is to request lg scripts in the form of shell scripts or
batch files.
</p><!--l. 7505--><p class="indent" > <big><span class="cmbx-10">Alternatives to ‘</span><span class="cmtt-10">--- needs --- source.idv[i] ==> target.png ---</span><span class="cmbx-10">’</span></big>
</p><!--l. 7508--><p class="indent" > The default setting is made with a request of the form ‘<span class="cmtt-10">--- needs --- %%1.idv[%%2] ==> %%3.png ---</span>’,
where the parameters <span class="cmtt-10">%%1</span>, <span class="cmtt-10">%%2</span>, and <span class="cmtt-10">%%3 </span>respectively represent the name of the source file without
its extension, a page number, and a name of the target file. Alternative patterns to these abstract
commands can be requested in the following locations, with the order reflecting on the priority given to the
requests.
</p><!--l. 7517--><p class="indent" >
</p><ul type="disc" >
<li>In the <a
href="mn37.html" >command line</a> of <span class="cmtt-10">tex4ht</span>, where the pattern should be prefixed with ‘<span class="cmtt-10">-s</span>’.
<!--l. 7521--><p class="noindent" ></p></li>
<li>In the environment file <span class="cmtt-10">tex4ht.env </span>within a block of consecutive lines, where the lines should be identified with the
character <a
href="mn32.html#sc-1" name="sc">‘<span class="cmtt-10">s</span>’</a>.
<!--l. 7527--><p class="noindent" ></p></li>
<li>In <span class="cmtt-10">tex4ht </span>with the pattern provided through the variable <a
href="mn35.html#x-LGPIC" name="LGPIC">LGPIC</a> of <span class="cmtt-10">tex4ht.c</span>.
</li></ul>
<!--l. 7534--><p class="indent" > The character ‘<span class="cmtt-10">%</span>’ can be introduced into a pattern through the entry ‘<span class="cmtt-10">%%%</span>’. On the other hand, the
parameters ‘<span class="cmtt-10">%%1</span>’, ‘<span class="cmtt-10">%%2</span>’, and <span class="cmtt-10">%%3 </span>can specify, between the first two percentage characters (i.e., ‘<span class="cmtt-10">%...%1</span>’,
‘<span class="cmtt-10">%...%2</span>’, and ‘<span class="cmtt-10">%...%3</span>’), any format for the outcome that is compatible with the print formats of
C.
</p><!--l. 7541--><p class="indent" > <big><span class="cmbx-10">Alternatives to ‘</span><span class="cmtt-10">--- characters ---</span><span class="cmbx-10">’</span></big>
</p><!--l. 7543--><p class="indent" > Substitutions for this abstract command can be requested in the following locations.
</p><!--l. 7550--><p class="indent" >
</p><ul type="disc" >
<li>In the <a
href="mn37.html" name="mn37.html" >overview</a> of <span class="cmtt-10">tex4ht</span>, prefixed with ‘<span class="cmtt-10">-b</span>’.
<!--l. 7721--><p class="noindent" ></p></li>
<li>In a line within the environment file ‘<span class="cmtt-10">tex4ht.file</span>’, where the line should be identified with the character
‘<a
href="mn32.html#bsc-1" name="bsc">b</a>’.
<!--l. 7727--><p class="noindent" ></p></li>
<li>In <span class="cmtt-10">tex4ht </span>with the substitution provided during compilation time through the variable <a
href="mn35.html#x-LGSEP" name="LGSEP">LGSEP</a> of
<span class="cmtt-10">tex4ht.c</span>.
</li></ul>
</body></html>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
8a0c95e246ae6b1f008ff48867f08c37
>
files
>
55
