1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
|
Version 2.5
March 2000
Hyperlatex
==========
Introduction
============
This is version 2.5 of the Hyperlatex package. Hyperlatex allows you
to use a LaTeX-like language to prepare documents in HTML (the
hypertext markup language used by the world wide web), and, at the
same time, to produce a fine printed document from your input. You can
use all of LaTeX's power for the printed output, and you don't have to
learn a new language for creating hypertext documents.
Note that Hyperlatex is not meant to translate arbitrary Latex files
into Html. Rather, it provides an authoring environment for writing
printed documents and Html documents at the same time, using an
extended subset of Latex (excluding concepts that have no Html
counterpart and adding commands for new Html concepts such as
hyperlinks or included images).
Hyperlatex is ``free,'' this means that everyone is free to use it and
free to redistribute it on certain conditions. Hyperlatex is not in
the public domain; it is copyrighted and there are restrictions on its
distribution, see the end of this document.
The Hyperlatex home page "http://www.cs.ust.hk/~otfried/Hyperlatex/"
has links for the Hyperlatex manual and for downloading the most
recent versions, as well as a few philosophical notes about Hyperlatex.
There is also a mailing list for Hyperlatex, maintained by Roland
Jesse. This list is for discussion of Hyperlatex and anything that
relates to it. This is also where new versions of Hyperlatex are
announced. To subscribe to the list send mail to:
majordomo@cs.uni-magdeburg.de or
hyperlatex-request@cs.uni-magdeburg.de
with the following line in the body (not subject):
subscribe hyperlatex
To send Email to the list, mail to "hyperlatex@cs.uni-magdeburg.de".
You can also check the Hyperlatex FAQ at
http://www.cs.uni-magdeburg.de/docs/hyperlatex/hyperlatex-faq.html
The FAQ and the mailing list are the only "official" place where you
can find support for problems with Hyperlatex. In fact, I can no
longer answer personal mail with questions. Please understand that
Hyperlatex is just a by-product of Ipe--I wrote it to be able to write
the Ipe manual the way I wanted to. I am making Hyperlatex available
because others seem to find it useful, and I'm trying to make the
manual and installation instructions as clear as possible, but I
absolutely cannot answer mail about Hyperlatex anymore. If you have
problems installing or using Hyperlatex, or if you think that you have
found a bug, please mail it to the Hyperlatex mailing list at
"hyperlatex@cs.uni-magdeburg.de". One of the friendly Hyperlatex
users will probably be able to help you. And I do read the list
regularly and will try to fix real bugs promptly (ahem---well, when I
get to it :-).
But most of all, enjoy this tool.
Otfried Cheong
Contents
========
The tar file "Hyperlatex-2.5.tar.gz" contains the following files.
README What you are reading
hyperlatex A shell script to execute the Emacs macros
hyperlatex.el The Emacs macros to convert Latex->Html
hyperlatex.sty The LaTeX macros
hyperlatex.tex The documentation
hyperlatex.ind ... and its index
*.hlx Hyperlatex packages
ps2gif A shell script to convert PS files to Gif
*.gif Four icon bitmaps
contrib/* Contributed hyperlatex packages
that may or may not work for you
Note that the Hyperlatex converter requires that you have Emacs
installed on your system. In fact, I have only tried the macros with
GNU Emacs 19, and 20. I believe they work with XEmacs. Part of it
will work with GNU Emacs 18, but not all functions are available.
Installing Hyperlatex
=====================
Installing Hyperlatex is easy--you just have to copy all the
files into the appropriate places. Here is what you have to do.
(1) Copy "hyperlatex.sty" into your TeX macro directory. Note that if
you are the administrator and put the file in the system-wide
macro directory (a natural place would be
/usr/share/texmf/tex/latex/misc/hyperlatex.sty on many systems),
you may have to run "texhash" as root to remake the index that is
needed to find the file.
(2) If you are going to use them, you should copy the bitmaps "*.gif"
to an icon directory of your WWW server, or, if you cannot do
that, to your personal icon directory.
Edit the file "siteinit.hlx". Right at the beginning is the
definition of "\HlxIcons". Change it to the URL of the directory
where you put the icons (you must include the trailing slash
"/"). If the URL for that directory contains a "~", you'll have to
write that as "\~{}".
If you don't have a WWW server, or don't understand these
instructions, then define "\HlxIcons" as the empty string,
i.e. "\newcommand{\HlxIcons}{}". In that case you'll always have
to copy the bitmaps into the directory containing your output Html
files.
(3) Create a directory for Hyperlatex's package files. A typical
choice could be "/usr/local/lib/hyperlatex". Let's call this
directory HYPERLATEX_DIR. Copy all files ending in ".el" and
".hlx" in the distribution to this directory.
(4) Edit the script "hyperlatex", and set HYPERLATEX_DIR to the
directory from step (3). In other words, change the following
line
HYPERLATEX_DIR="$HOME/Hyperlatex/Hlx"
to be
HYPERLATEX_DIR="your_hyperlatex_directory"
where of course `your_hyperlatex_directory' is the directory you've
picked for your Hyperlatex files.
(5) Copy the shell script "hyperlatex" into a location where it can be
executed (e.g. "/usr/local/bin").
(6) Byte-compile the Emacs macros in "hyperlatex.el".
This can be done as follows (under Unix):
Change the current directory to HYPERLATEX_DIR, and type
emacs -batch -q -no-site-file -l hyperlatex.el -f hyperlatex-compile
On GNU Emacs, this should not give you any error message. If it
does, you can probably ignore them, but please mail me the error
messages and the exact version of GNU Emacs that you are using.
If you are using XEmacs (which is unsupported, but seems to work),
you'll get quite a few warnings that you can safely ignore.
(7) That was all! Hyperlatex should be working now...
You'll test it right away, since you want to look at the
documentation, which is itself in Hyperlatex format.
Type (maybe you will need "rehash" first)
hyperlatex hyperlatex
to generate the HTML version of the documentation. You can browse
it with any HTML browser such as Mosaic or Netscape, e.g. by typing:
netscape html/hyperlatex.html
You can also type
latex hyperlatex
to generate a DVI file that you can preview and print as usual.
(See below if you get a Latex error when you do this.)
(8) If you plan to convert TeX objects to bitmaps in your HTML documents,
you should also install the shellscript "ps2gif". Install it
in a suitable location (presumably the same as in (5)).
Also install the awk script "normalize-eps.awk" in HYPERLATEX_DIR.
Note that the script calls awk, ghostscript and the two functions
"pnmcrop" and "ppmtogif". The latter needs to have the
"-transparent" option to make the created Gif files
transparent. You can get these
programs from the "netpbm" library. If you don't have these
programs, use archie to find a copy of "netpbm" nearby. You can
also get "netpbm" from "wuarchive.wustl.edu" (128.252.135.4), in
directory "/graphics/graphics/packages/NetPBM".
Problems?
=========
The "hyperlatex.sty" package loads another LaTeX2e package
"verbatim.sty" by Rainer Schoepf which has an improved definition of
'verbatim' and (more important for hyperlatex) a definition of a
'comment' environment. You will get a "Environment ifhtml undefined"
error if your version of "verbatim.sty" does not define 'comment'
suitably. (And of course you will get an error if you do not have
"verbatim.sty".) If that happens, I recommend that you get a recent
version of "verbatim.sty" from your closest CTAN-site. (There is a
nice Web interface at "http://jasper.ora.com/ctan.html". If you don't
have Web access, look in the TeX FAQ for you nearest CTAN site.)
If you get an error message because your Latex doesn't find
'babel.sty', comment out the line "\usepackage[german]{babel}". (The
section explaining the babel package will look a bit funny then, but
otherwise there is no problem.)
Acknowledgments
===============
The Hyperlatex code was once based on the Emacs Lisp macros of the
"latexinfo" package, but has changed beyond recognition since then.
Copyright
=========
Copyright (C) 1994-2000 Otfried Cheong
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at
your option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
A copy of the GNU General Public License is available on the World
Wide web at "http://www.gnu.org/copyleft/gpl.html".
You can also obtain it by writing to the Free Software Foundation,
Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
|
