← Back to branch summary

~ubuntu-branches/debian/sid/tex4ht/sid

« back to all changes in this revision

Viewing changes to doc/mn-mswin.html

  • Committer: Bazaar Package Importer
  • Author(s): Kapil Hari Paranjape
  • Date: 2005-04-05 14:14:41 UTC
  • mfrom: (1.2.1 upstream) (2.1.2 hoary)
  • Revision ID: james.westby@ubuntu.com-20050405141441-x4dojdgz3frkfyet
Tags: 20050402.1817-1
http://bugs.debian.org/299934
http://bugs.debian.org/295109
http://bugs.debian.org/219348
http://bugs.debian.org/219347
* New upstream release (2005-04-02-18:17). Closes: #299934.
* See README.src, README.validate, README.Debian and copyright
  for information on minor changes.
* This upload fixes a some .htf files. Closes: #295109.
* Updated the description to reflect recent changes.
* Fixed some typos in src/tex4ht-mkht.tex and consequently
  in the mk4ht script.
* Updated the man page to include mk4ht. 
* Updated the description of options for the scripts in the man page.
  Put more information in the man page about the way the system works.
  Closes: #219348, #219347.
* Added debian/watch file.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/mn-mswin.html
 
1
<?xml version="1.0" encoding="iso-8859-1" ?> 
 
2
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
 
3
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">  
 
4
<!--http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd-->  
 
5
<html xmlns="http://www.w3.org/1999/xhtml"  
 
6
> 
 
7
<head><title>MS Windows</title> 
 
8
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> 
 
9
<meta name="generator" content="TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/mn.html)" /> 
 
10
<meta name="originator" content="TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/mn.html)" /> 
 
11
<!-- xhtml,th4,index --> 
 
12
<meta name="src" content="mn.tex" /> 
 
13
<meta name="date" content="2005-02-28 00:13:00" /> 
 
14
<link rel="stylesheet" type="text/css" href="mn.css" /> 
 
15
</head><body 
 
16
>
 
17
    <a 
 
18
 href="mn.html#mn-mswin.html" >exit MS Windows</a>
 
19
    <h3 class="SubSectionHead"><a 
 
20
  name="QQ1-24-39"></a>A Setup for MS Windows</h3>
 
21
<ol type="a" >
 
22
<li> <a 
 
23
  name="index24-39001"></a>Establish a directory, say, &#8216;<span class="cmtt-10">c:\tex4ht</span>&#8217;.
 
24
<!--l. 5329--><p class="noindent"></p></li>
 
25
<li> <a 
 
26
  name="index24-39002"></a>Download the &#xFB01;le <a 
 
27
 href="tex4ht.zip" >tex4ht.zip</a> into the directory <span class="cmtt-10">tex4ht.dir </span>and <a 
 
28
 href="http://www.info-zip.org/pub/infozip/" >unzip</a> it.
 
29
    <p class="rightline"><span class="cmbx-10">Update the Pointers in the Environment File</span></p>
 
30
<!--l. 5355--><p class="noindent"></p></li>
 
31
<li> <a 
 
32
  name="index24-39003"></a> <a 
 
33
  name="index24-39004"></a>Replace in <a 
 
34
 href="tex4ht-env-win32.txt" ><span class="cmtt-10">c:\tex4ht\texmf\tex4ht\base\win32\tex4ht.env</span></a> the lines starting with the character &#8216;<span class="cmtt-10">t</span>&#8217;, with
 
35
alternative lines which state what directories should be searched for the tfm &#xFB01;les of TeX and LaTeX. The directory
 
36
names must be preceded with the character &#8216;<span class="cmtt-10">t</span>&#8217; at the &#xFB01;rst column. If their subdirectories are also to be searched, the
 
37
names should be appended with the character &#8216;<span class="cmtt-10">!</span>&#8217;.
 
38
<!--l. 5368--><p class="indent">    Note that long &#xFB01;le names on MS Windows, and &#xFB01;le names with spaces, might have short space-free aliases. For
 
39
instance, a directory name &#8216;<span class="cmtt-10">c:\progra~1\texmf</span>&#8217; instead of &#8216;<span class="cmtt-10">c:\program files\texmf</span>&#8217;. The alternative names can
 
40
be checked by issuing the &#8216;<span class="cmtt-10">dir</span>&#8217; command in a DOS session.
 
41
</p><!--l. 5375--><p class="noindent"></p></li>
 
42
<li> <a 
 
43
  name="index24-39005"></a>If needed, adjust the paths in the &#8216;<span class="cmtt-10">i</span>&#8217; records of <span class="cmtt-10">tex4ht.env</span>. These records are used for searching htf fonts, and
 
44
they are similar to the &#8216;<span class="cmtt-10">t</span>&#8217; records.
 
45
    <p class="rightline"><span class="cmbx-10">Update the Bitmap Generating Scripts</span></p>
 
46
<!--l. 5389--><p class="noindent"></p></li>
 
47
<li> <a 
 
48
  name="index24-39006"></a>The &#xFB01;le <span class="cmtt-10">tex4ht.env </span>contains the following default script, of calls to system utilities for translating dvi pictures into
 
49
png.
 
50
<div class="Verbatim"><span class="cmtt-10">Gif</span><span class="cmtt-10">&#x00A0;exist</span><span class="cmtt-10">&#x00A0;zz%%4.ps</span><span class="cmtt-10">&#x00A0;DEL</span><span class="cmtt-10">&#x00A0;zz%%4.ps</span><span class="cmtt-10">&#x00A0;&gt;nul</span><span class="cmtt-10">&#x00A0;</span>
 
51
<br /><span class="cmtt-10">Gif</span><span class="cmtt-10">&#x00A0;exist</span><span class="cmtt-10">&#x00A0;%%3</span><span class="cmtt-10">&#x00A0;DEL</span><span class="cmtt-10">&#x00A0;%%3</span><span class="cmtt-10">&#x00A0;&gt;nul</span><span class="cmtt-10">&#x00A0;</span>
 
52
<br /><span class="cmtt-10">Gdvips</span><span class="cmtt-10">&#x00A0;-E</span><span class="cmtt-10">&#x00A0;-Ppdf</span><span class="cmtt-10">&#x00A0;-mode</span><span class="cmtt-10">&#x00A0;ibmvga</span><span class="cmtt-10">&#x00A0;-D</span><span class="cmtt-10">&#x00A0;110</span><span class="cmtt-10">&#x00A0;-f</span><span class="cmtt-10">&#x00A0;%%1</span><span class="cmtt-10">&#x00A0;-pp</span><span class="cmtt-10">&#x00A0;%%2</span><span class="cmtt-10">&#x00A0;&gt;</span><span class="cmtt-10">&#x00A0;zz%%4.ps</span><span class="cmtt-10">&#x00A0;</span>
 
53
<br /><span class="cmtt-10">Gconvert</span><span class="cmtt-10">&#x00A0;zz%%4.ps</span><span class="cmtt-10">&#x00A0;-trim</span><span class="cmtt-10">&#x00A0;+repage</span><span class="cmtt-10">&#x00A0;-density</span><span class="cmtt-10">&#x00A0;110x110</span><span class="cmtt-10">&#x00A0;-transparent</span><span class="cmtt-10">&#x00A0;"#FFFFFF"</span><span class="cmtt-10">&#x00A0;%%3</span><span class="cmtt-10">&#x00A0;</span>
 
54
<br /><span class="cmtt-10">Gif</span><span class="cmtt-10">&#x00A0;exist</span><span class="cmtt-10">&#x00A0;zz%%4.ps</span><span class="cmtt-10">&#x00A0;DEL</span><span class="cmtt-10">&#x00A0;zz%%4.ps</span><span class="cmtt-10">&#x00A0;&gt;nul</span><span class="cmtt-10">&#x00A0;</span>
 
55
<br /></div>
 
56
<!--l. 5402--><p class="indent">    You may replace this script with an alternative sequence of system calls. In such a case, place one command per
 
57
line, and mark each of these lines with the character &#8216;<span class="cmtt-10">G</span>&#8217; at the &#xFB01;rst column. The literate version tex4ht-env.tex of
 
58
tex4ht.env offers a few suggestions.
 
59
</p><!--l. 5408--><p class="indent">    The entry <span class="cmtt-10">%%1 </span>is a parameter referring to a dvi &#xFB01;le, the <span class="cmtt-10">%%2 </span>is a parameter indicating a page
 
60
number, the <span class="cmtt-10">%%3 </span>is a parameter standing for an output &#xFB01;le name, and <span class="cmtt-10">%%4 </span>is a parameter providing the
 
61
jobname.
 
62
</p><!--l. 5417--><p class="indent">    The <a 
 
63
 href="http://www.radicaleye.com/dvips.html" >dvips</a> utility translates dvi &#xFB01;les into postscript. The <span class="cmtt-10">convert </span>utility, provided within the distribution of
 
64
<a 
 
65
 href="http://www.imagemagick.org/" >ImageMagick</a>, translates postscript &#xFB01;les into png.
 
66
</p><!--l. 5423--><p class="indent">    The script employs the Metafont mode &#8216;<span class="cmtt-10">ibmvga</span>&#8217; of resolution &#8216;<span class="cmtt-10">110</span>&#8217;; the available modes are listed in &#xFB01;le
 
67
<span class="cmtt-10">modes.mf </span>of Metafont.
 
68
</p><!--l. 5428--><p class="indent">    Use the option &#8216;<span class="cmtt-10">-crop 0x0 +page</span>&#8217; or &#8216;<span class="cmtt-10">-crop 0x0 +repage</span>&#8217; instead of &#8216;<span class="cmtt-10">-trim</span>&#8217; for old convert utilities that do
 
69
not recognize the latter argument.
 
70
</p><!--l. 5432--><p class="noindent"></p></li>
 
71
<li>Instead of employing the G scripts, glyphs can rely on specialized <a 
 
72
 href="mn25.html"  name="mn25.html" >F scripts</a> of similar nature for creating pngs.
 
73
    <p class="rightline"><span class="cmbx-10">Update the Other Scripts in the Environment File</span></p>
 
74
<!--l. 5451--><p class="noindent"></p></li>
 
75
<li>If needed, replace the scripts &#8216;<span class="cmtt-10">Mmove %%1 %%2%%3</span>&#8217;, and &#8216;<span class="cmtt-10">Ccopy %%1 %%2%%3</span>&#8217; in <span class="cmtt-10">tex4ht.env </span>with <a 
 
76
 href="mn26.html"  name="mn26.html" >alternative
 
77
scripts</a> for moving and copying &#xFB01;les. The parameter <span class="cmtt-10">%%1 </span>stands for the source &#xFB01;le(s), the parameter <span class="cmtt-10">%%2 </span>provides the
 
78
target directory name, and the parameter <span class="cmtt-10">%%3 </span>refers to the target &#xFB01;le name(s).
 
79
<!--l. 5477--><p class="noindent"></p></li>
 
80
<li>If applicable, replace the scripts &#8216;<span class="cmtt-10">Achmod %%1 %%2%%3</span>&#8217; in <span class="cmtt-10">tex4ht.env </span>with an alternative script for changing the
 
81
access mode of &#xFB01;les. The parameter <span class="cmtt-10">%%1 </span>stands for access mode, the parameter <span class="cmtt-10">%%2 </span>refers to a directory name, and
 
82
the parameter <span class="cmtt-10">%%3 </span>refers to the &#xFB01;le(s).
 
83
<!--l. 5485--><p class="noindent"></p></li>
 
84
<li> <a 
 
85
  name="index24-39007"></a>Postprocessing of &#xFB01;les can be requested with &#8216;<span class="cmtt-10">.</span>&#8217; scripts. The &#xFB01;les are selected by their extension names, as listed
 
86
following the period symbols. The parameter &#8216;<span class="cmtt-10">%%1</span>&#8217; provides the &#xFB01;le names, and the parameter &#8216;<span class="cmtt-10">%%0</span>&#8217; provides the
 
87
jobnames.
 
88
<!--l. 5493--><p class="indent">    The environment &#xFB01;le <a 
 
89
 href="tex4ht-env-win32.txt" >tex4ht.env</a> offers the following draft of a dot script for <span class="cmbx-10">validating </span>output of
 
90
compilations.
 
91
</p><div class="Verbatim"><span class="cmtt-10">&lt;validate&gt;</span><span class="cmtt-10">&#x00A0;</span>
 
92
<br /><span class="cmtt-10">&#x00A0;.xml</span><span class="cmtt-10">&#x00A0;java</span><span class="cmtt-10">&#x00A0;-cp</span><span class="cmtt-10">&#x00A0;texmf/tex4ht/bin/xv4ht.jar</span><span class="cmtt-10">&#x00A0;xv4ht</span><span class="cmtt-10">&#x00A0;%%1.xml</span><span class="cmtt-10">&#x00A0;texmf/tex4ht/base/win32/xv4ht.cat</span><span class="cmtt-10">&#x00A0;</span>
 
93
<br /><span class="cmtt-10">&#x00A0;.html</span><span class="cmtt-10">&#x00A0;java</span><span class="cmtt-10">&#x00A0;-cp</span><span class="cmtt-10">&#x00A0;texmf/tex4ht/bin/xv4ht.jar</span><span class="cmtt-10">&#x00A0;xv4ht</span><span class="cmtt-10">&#x00A0;%%1.html</span><span class="cmtt-10">&#x00A0;texmf/tex4ht/base/win32/xv4ht.cat</span><span class="cmtt-10">&#x00A0;</span>
 
94
<br /><span class="cmtt-10">&#x00A0;.css</span><span class="cmtt-10">&#x00A0;mycssparser</span><span class="cmtt-10">&#x00A0;%%1.css</span><span class="cmtt-10">&#x00A0;</span>
 
95
<br /><span class="cmtt-10">&lt;/validate&gt;</span><span class="cmtt-10">&#x00A0;</span>
 
96
<br /></div>
 
97
<!--l. 5508--><p class="indent">    The dot script may be activated in the following manner.
 
98
</p><!--l. 5510--><p class="indent">
 
99
</p><ol type="1" >
 
100
<li>Fix the paths in the &#xFB01;rst two records as well as witin the xv4ht.cat &#xFB01;le.
 
101
<!--l. 5515--><p class="noindent"></p></li>
 
102
<li>Bind a CSS validator to the .css record. (<a 
 
103
 href="http://jigsaw.w3.org/css-validator/DOWNLOAD.html" ><span class="cmtt-10">http://jigsaw.w3.org/css-validator/DOWNLOAD.html</span></a>)
 
104
<!--l. 5521--><p class="noindent"></p></li>
 
105
<li>Remove the leading space characters from the above record.
 
106
    </li></ol>
 
107
<!--l. 5535--><p class="noindent"></p></li>
 
108
<li>Postprocessing of &#xFB01;les can also be requested with &#8216;<span class="cmtt-10">X</span>&#8217; scripts. The &#xFB01;le names are accessed through the parameter
 
109
&#8216;<span class="cmtt-10">%%1</span>&#8217;, and their extensions through the parameter &#8216;<span class="cmtt-10">%%2</span>&#8217;.
 
110
    <p class="rightline"><span class="cmbx-10">Set the Script Files</span></p>
 
111
<!--l. 5543--><p class="noindent"></p></li>
 
112
<li>If you use a command different than &#8216;<span class="cmtt-10">latex</span>&#8217; for compiling LaTeX source &#xFB01;les, replace the references to <span class="cmtt-10">latex </span>in
 
113
<span class="cmtt-10">c:\tex4ht\bin\win32\*.bat </span>with the appropriate command name. The <span class="cmtt-10">tex </span>and <span class="cmtt-10">texi </span>commands require similar
 
114
attention.
 
115
    <p class="rightline"><span class="cmbx-10">Make the System Globally Known</span></p> </li>
 
116
<li>Add &#8216;<span class="cmtt-10">c:\tex4ht\bin\win32</span>&#8217; to your path variable in &#8216;<span class="cmtt-10">c:\AUTOEXEC.BAT</span>&#8217;.
 
117
<!--l. 5556--><p class="noindent"></p></li>
 
118
<li>Place the &#xFB01;les &#8216;<span class="cmtt-10">tex4ht.sty</span>&#8217; and &#8216;<span class="cmtt-10">*.4ht</span>&#8217; of <span class="cmtt-10">c:\texmf\tex\generic\tex4ht\ </span>within the LaTeX/TeX tree (either by
 
119
moving the &#xFB01;les to a directory which already has sty &#xFB01;les, or by modifying the environment variable TEXINPUTS to
 
120
point also to &#8216;<span class="cmtt-10">c:\texmf\tex\generic\tex4ht\</span>&#8217;).
 
121
<!--l. 5563--><p class="noindent"></p></li>
 
122
<li>If your TeX system uses a database to locate &#xFB01;les, make sure to refresh it (e.g., select <span class="cmtt-10">Start -&gt; Programs -&gt;</span>
 
123
<span class="cmtt-10">MiKTeX -&gt; Refresh</span>, or run &#8216;<span class="cmtt-10">initexmf -u</span>&#8217; from a DOS session, to update MiKTeX).
 
124
    <p class="rightline"><span class="cmbx-10">Didn&#8217;t Use &#8217;</span><span class="cmtt-10">c:\tex4ht&#8217;</span><span class="cmbx-10">?</span></p> </li>
 
125
<li>If TeX4ht is installed in a directory other than <span class="cmtt-10">c:\tex4ht</span>, make sure to adjust the related paths in <span class="cmtt-10">tex4ht.env </span>the
 
126
<span class="cmtt-10">.bat </span>&#xFB01;les.
 
127
    <p class="rightline"><span class="cmbx-10">Test the Installation</span></p> </li>
 
128
<li>Move <span class="cmtt-10">testa.tex </span>and <span class="cmtt-10">testb.tex </span>from <span class="cmtt-10">c:\tex4ht.dir\temp\ </span>to your work directory </li>
 
129
<li>Compile &#8216;<span class="cmtt-10">testa.tex</span>&#8217; with the command &#8216;<span class="cmtt-10">ht latex testa</span>&#8217; </li>
 
130
<li>Compile &#8216;<span class="cmtt-10">testb.tex</span>&#8217; with the command &#8216;<span class="cmtt-10">htlatex testb</span>&#8217;
 
131
    </li></ol>
 
132
<!--l. 5593--><p class="indent">    [<a 
 
133
 href="http://www.csulb.edu/~murdock/dosindex.html" >MS Commands</a>]
 
134
 
 
135
</p>
 
136
     
 
137
</body></html>