Hi people! I use LaTeX and very happy to see latex2html program but I
can't get working. I followed instructions and install-test ran fine,
only error was Ghostscript variable path so I inserted correct path into
local.pm as it told me. Below is output of script running, error at end of
program, latex2html.config file and images.log file:
!!!!!!!!!! install-test output !!!!!!!!!!!!1
BRECKENRIDGE.WEH /tmp/zu22/latex2html > ./install-test
This is install-test for LaTeX2HTML V98.1
=========================================
Main script installation was... 0 1 ...successful.
Testing availability of external programs...
Perl version 5.004 is OK.
texexpand was found.
Setting up texexpand script...1 ...succeeded
Checking for availability of DBM or NDBM (Unix DataBase Management)...
DBM was found.
Checking if globbing works... globbing is ok.
DVIPS version 5.58 is OK.
pstoimg was found.
Setting up pstoimg script...0 1 ...succeeded
Setting up configure-pstoimg script...1 ...succeeded
Looking for latex...
latex was found.
Styles directory was found.
Main set-up done.
You may complete this set-up by configuring pstoimg now...proceed?
yes
This is configure-pstoimg V96.2 by Marek Rouchal
Welcome to the Configuration of pstoimg!
You will be guided in few steps through the setup of pstoimg, the part of
latex2html that produces bitmap images from the LaTeX source.
Type `configure-pstoimg -h' for a brief usage information and a list of
user-definable options.
Hit return to proceed to the next configuration step.
Pstoimg can support both GIF and PNG format.
Please note that there are certain legal limitations on the use of the GIF
image format.
If you go on, pstoimg will be configured for GIF or PNG format.
You may reconfigure pstoimg at any time by saying configure-pstoimg.
Which format do you want to have supported?
Answer g (GIF) or p (PNG).
g
Configuring for GIF format.
Changing $IMAGE_TYPE in latex2html.config...succeeded
Hit return to proceed to the next configuration step.
Ghostscript Configuration
=========================
Ghostscript is "/usr/local/bin/gs", Version 2.6.2
Pstoimg will use the ppmraw device.
Warning: Couldn't determine Ghostscript library path (the path where e.g.
landscap.ps resides). You have to include $GS_LIB_PATH = <path>
by hand in local.pm
Hit return to proceed to the next configuration step.
Netpbm/Pbmplus Configuration
============================
ppmtogif is /usr/contributed/bin/ppmtogif
ppmtogif understands -transparent. Good!
ppmtogif understands -interlace. Good!
pnmcrop is /usr/contributed/bin/pnmcrop
pnmflip is /usr/contributed/bin/pnmflip
ppmquant is /usr/contributed/bin/ppmquant
pnmfile is /usr/contributed/bin/pnmfile
pnmcat is /usr/contributed/bin/pnmcat
pbmmake is /usr/contributed/bin/pbmmake
Hit return to proceed to the next configuration step.
Transparent/Interlaced Image Configuration
==========================================
Using netpbm to make transparent GIFs.
Using netpbm to make interlaced GIFs.
Hit return to proceed to the next configuration step.
Setup pstoimg
=============
Updating local configuration file...
Well done!
Pstoimg is now hopefully configured to run on your system.
Type `pstoimg -h' for a brief usage information.
Please specify the desired image format in the file latex2html.config.
What is wrong? This is first time I run latex2html. It seemed latex2html script wroked
fine EXCEPT it didn't produce any images! And here is error and then images.log.
Please help :) Oh yes I install latex2html into /tmp directory since I can't fit in acc
ount and school doesn't want to upgrade (old latex2html version very much broken!)
!!!!!!!!! Here is tail end of program output: !!!!!!!!!!!!!!
-----------------------------------
Writing image file ...
This is TeX, Version 3.1415 (C version 6.1)
(images.tex
LaTeX2e <1996/06/01>
*** LaTeX produced no output ***
*** no new images can be created
*** Examine the images.log file.
*** LaTeXERROR
Doing section links .....
Done.
!!!!!!!!! Below is images.log: !!!!!!!!!!!!!!
-------------------
This is TeX, Version 3.1415 (C version 6.1) (format=latex 97.1.3) 6 OCT 1998 01:00
**./images.tex
(images.tex
LaTeX2e <1996/06/01>
(/usr/local/lib/texmf/tex/latex2e/base/article.cls
Document Class: article 1996/05/26 v1.3r Standard LaTeX document class
(/usr/local/lib/texmf/tex/latex2e/base/size10.clo
File: size10.clo 1996/05/26 v1.3r Standard LaTeX file (size option)
)
\c@part=\count79
\c@section=\count80
\c@subsection=\count81
\c@subsubsection=\count82
\c@paragraph=\count83
\c@subparagraph=\count84
\c@figure=\count85
\c@table=\count86
\abovecaptionskip=\skip41
\belowcaptionskip=\skip42
\bibindent=\dimen102
)
! LaTeX Error: File `html.sty' not found.
Type X to quit or <RETURN> to proceed,
or enter new name. (Default extension: sty)
Enter file name:
! Emergency stop.
<read *>
l.4 \makeatletter
\pagecolor[gray]{.7}^^M
*** (cannot \read from terminal in nonstop modes)
Here is how much of TeX's memory you used:
202 strings out of 10943
1925 string characters out of 73346
43679 words of memory out of 262141
3128 multiletter control sequences out of 9500
3640 words of font info for 14 fonts, out of 100000 for 255
14 hyphenation exceptions out of 607
23i,0n,18p,140b,40s stack positions out of 300i,100n,60p,3000b,4000s
No pages of output.
!!!!!!!!!! Below is latex2html.config !!!!!!!!!!!
# LaTeX2HTML Version 97.1 : latex2html.config
# $Id: latex2html.config,v 1.27 1998/02/22 05:23:35 latex2html Exp $
# ################# YOU **MUST** CHECK THESE VARIABLES ####################
# Give the path to the DIRECTORY in which the latex2html files can be found.
# You can leave this alone if you run install-test.
#
$LATEX2HTMLDIR='/tmp/zu22/latex2html'; # Inserted by installation script
# Give the paths to latex and dvips on your system:
#
$LATEX = "latex"; # LaTeX
$DVIPS = "dvips"; # dvips
# give these too, to use the -ldump feature
#
$TEX = "tex"; # TeX
$INILATEX = "initex \"&latex\""; # initex+latex
# These affect whether images are made on a white or gray background.
# They are ignored when the document preamble contains similar commands.
# Use these defaults for dark solid (anti-aliased) characters in text and math.
$LOAD_LATEX_COLOR = "\\usepackage[dvips]{color}";
$LATEX_COLOR = "\\pagecolor[gray]{.7}";
# This specifies the type of images produced by latex2html when processing
# unknown environments and/or e.g. math formulae.
# Don't care. It will be updated by configure-pstoimg.
#
$IMAGE_TYPE='gif';# Inserted by installation script
# Specify a tmp directory for image-generation (optional)
#
# $TMP = '/usr/tmp';
########## ICONSERVER --- !! IMPORTANT !! ############################
#
# LaTeX2HTML uses many small graphics as icons within the navigation
# panels, and for other purposes.
# You *must* specify where these graphics are to be found, for use within
# your documents.
#
# IMPORTANT: This location must not only be accessible to you, but also
# to the people who are to read your HTML documents.
#
# One option is to always use the -local_icons switch (see below)
# to have a copy of the icons together with your HTML document.
# (This is safe, but wasteful if you have a large number of documents.)
#
# A better option is to set $ICONSERVER to point to a location that
# is known to always (at least in principle) be available publicly.
#
# The default value for $ICONSERVER given below is within the local
# $LATEX2HTMLDIR. If this is *not* to be publicly available then you
# **should change the value of $ICONSERVER to a site that is**.
#
# You probably have to talk to your Webmaster to provide access to the
# icon directory. Some hints:
# a) It's ok to set $ICONSERVER just to "/path/to/icons.$IMAGE_TYPE" (without
# the internet address) if /path/to is valid for your file system, *and*
# if www_root/path/to points to the same directory. Normally the www area
# is located in some subsidary directory, which is pointed to by www_root
# (the entry 'Document Root' of the http daemon's srm.conf file).
# Make the Webmaster add appropriate links in that directory that help
# locate the icon directory, or set up an Alias in srm.conf.
# b) To check if the icons can be displayed properly, invoke the browser
# with the *http URL to your site*, and click down to your document.
# c) If you have $LOCAL_ICONS set, your document will accumulate a pretty
# amount of redundant icons if you make use of segmentation.
# In this case, customize &img_tag to use a central directory, say,
# "../icons".
#
$ICONSERVER = "$LATEX2HTMLDIR/icons.$IMAGE_TYPE";
# ####### YOU *MAY* WANT/NEED TO CHANGE SOME OF THESE VARIABLES ##############
# If you have dvips 5.62 or higher, you can turn on generation of EPS files
# by uncommenting the following line. Warning: dvips does not support
# included EPS figures very well. However if you don't make use of
# complicated image include commands like \includegraphics, this option
# will speed up image generation a *lot*.
#
# $DVIPS = "dvips -E";
# (Note: this here is old, don't worry unless you really run into trouble.)
#
# Some dvips programs generate postscript images in the reverse order by
# default. If your inlined images are all screwed up try uncommenting
# the following line:
#
# $DVIPS = "dvips -r0";
# Location of texexpand, supplied with the translator
$TEXEXPAND = "$LATEX2HTMLDIR/texexpand";
# Location of pstoimg, supplied with the translator
$PSTOIMG = "$LATEX2HTMLDIR/pstoimg";
# This is used to "autoload" perl code to deal with specific style files
$LATEX2HTMLSTYLES = "$LATEX2HTMLDIR/styles";
# This is used to support upcoming versions of html - directory where perl
# files to handle those are
$LATEX2HTMLVERSIONS = "$LATEX2HTMLDIR/versions";
# The following variable sets the default search list of directories for
# latex style files that latex2html should process. It also defines a
# a list of directories (: separated) which possibly contain TeX and dvips
# inputs. This variable is overriden by the environment variable
# TEXINPUTS, if it is specified. Internally, the directory your document
# resides in, and ".", are appended to this list of directories.
#
# IMPORTANT: In some installations, latex and dvips are really
# shell scripts which set environment TEXINPUTS (and other variables)
# to predefined values, then call the real latex and dvips. If this
# is true for your installation, then the $TEXINPUTS that latex2html
# sees will only affect the processing of \input and \include's
# by latex2html, not the operation of latex and dvips when called
# by latex2html. In this case, make sure that the predefined
# values of TEXINPUTS within the latex and dvips scripts at least
# contains "." and ".." (".." works in the most cases).
# Otherwise, latex and dvips will not find inputs from the original source
# directory when called from a subdirectory contained therein.
#
# The single colon tells LaTeX to look on the standard places only.
# If you add entries, do it colon-separated.
# If you don't know where LaTeX takes its standard files from, leave the
# single colon in front or at the end, or have an empty entry "::"
# at some place among the other entries.
$TEXINPUTS = ":";
# This line helps LaTeX2HTML to recognize your adaption everywhere.
$ENV{'TEXINPUTS'} = $TEXINPUTS unless defined $ENV{'TEXINPUTS'};
# ############################################################################
# THERE IS NO NEED TO CHANGE ANY OF THE VARIABLES BELOW EXCEPT FOR CUSTOMISING
# THE OPERATION OF LATEX2HTML.
# ############################################################################
### Command Line Argument Defaults #######################################
# -ldump
# Change this to 1 if you want to speed up image processing during the 2nd
# and more runs of LaTeX2HTML on the same document.
# This will cause LaTeX2HTML to produce a LaTeX dump of images.tex which
# is read in on subsequent runs and speeds up startup time of LaTeX on the
# images.tex translation.
# This actually consumes additional time on the first run, but pays off on
# subsequent runs. The dump file will need about 1 Meg of disk space.
$LATEX_DUMP = 0;
# -numbered_footnotes
# If defined to 1 you will get every footnote applied with a subsequent
# number.
$NUMBERED_FOOTNOTES = 0;
# -no_fork
# If defined this will prevent the translator to crash if your operating
# system does not support forking.
$NOFORK = 0;
# -local_icons
# Change this to 1 if you want to copy the navigation icons to each
# document directory so that the document directory is self-contained
# and can be dropped into another server tree. Note that you can also
# use the command line option -local_icons
$LOCAL_ICONS = 0;
# -split
$MAX_SPLIT_DEPTH = 8; # Stop making separate files at this depth
# -link
$MAX_LINK_DEPTH = 4; # Stop showing child nodes at this depth
# -short_extn
# If this is set all HTML file will have extension ".htm" instead of
# ".html". This is helpful when shipping the document to PC systems.
$SHORTEXTN = 0;
# -nolatex
$NOLATEX = 0; # 1 = do not pass unknown environments to Latex
# -external_images
$EXTERNAL_IMAGES = 0; # 1 = leave the images outside the document
# -ps_images
# 1 = use links to external postscript images rather than inlined GIF's.
$PS_IMAGES = 0;
#
# ANTI-ALIASING within generated images
#
# -anti_alias
# 1 = use anti-aliasing in the generation of images of figures .
$ANTI_ALIAS = 0;
# -anti_alias_text
# 1 = use anti-aliasing in the generation of images of typeset material;
# e.g. mathematics and text, e.g. in tables and {makeimage} environments.
$ANTI_ALIAS_TEXT = 1;
# -font_size
# To set the point size of LaTeX-generated GIF files, uncomment the following
# variable, and set it to its desired value (i.e, 10pt, 11pt, 12pt, etc.)
# The default is to use the point size of the original LaTeX document.
# This value will be magnified by $FIGURE_SCALE_FACTOR and
# $MATH_SCALE_FACTOR (below).
#
# $FONT_SIZE = "12pt";
# -no_tex_defs
# To suppress the interpretation of raw TeX commands, set $TEXDEFS = 0;
# Note: There are many variations of \def that latex2html cannot process
# correctly!
$TEXDEFS = 1;
# -ascii_mode
# This is different from -no_images.
# If this is set, LaTeX2HTML will show textual tags rather than
# images, both in navigation panel and text (Eg. [Up] instead the up
# icon).
# You could use this feature to create simple text from your
# document, eg. with 'Save as... Text' from Netscape or with
# lynx -dump.
$ASCII_MODE = 0; # 1 = do not use any icons or internal images
# -t, The document title.
$default_title = 'No Title';
$TITLE = $default_title;
# -dir
$DESTDIR = ''; # Put the result in this directory
# -no_subdir
# When this is set, the generated HTML files will be placed in the
# current directory. If set to 0 the default behaviour is to create (or reuse)
# another file directory.
$NO_SUBDIR = 0;
# -address
# Supply your own string if you don't like the default <Name> <Date>
$ADDRESS = "<I>$address_data[0]</I>\n<BR><I>$address_data[1]</I>";
# -no_navigation
$NO_NAVIGATION = 0; # 1 = do not put a navigation panel at the top of each page
# -top_navigation
#Determines whether to navigation links should be at the top or the bottom
#of each page. The default is at the top.
$TOP_NAVIGATION = 1;
# -bottom_navigation
#Determines whether to navigation links should be at the top or the bottom
#of each page. The default is at the top.
$BOTTOM_NAVIGATION = 0;
# -auto_navigation
# Put navigation links at the top of each page. If the page exceeds
# $WORDS_IN_PAGE number of words then put one at the bottom of the page.
$AUTO_NAVIGATION = 1;
# -index_in_navigation
# Put a link to the index page in the navigation panel
$INDEX_IN_NAVIGATION = 1;
# -contents_in_navigation
# Put a link to the table of contents in the navigation panel
$CONTENTS_IN_NAVIGATION = 1;
# -next_page_in_navigation
# Put a link to the next logical page in the navigation panel
$NEXT_PAGE_IN_NAVIGATION = 1;
# -previous_page_in_navigation
# Put a link to the previous logical page in the navigation panel
$PREVIOUS_PAGE_IN_NAVIGATION = 1;
# -prefix
# Set the output file prefix, prepended to all .html, .gif and .pl files.
# See also $AUTO_PREFIX.
$PREFIX = "";
# -auto_prefix
# To automatically insert the equivalent of "-prefix basename-", where
# "basename" is the base name of the file being translated, set
# $AUTO_PREFIX = 1.
$AUTO_PREFIX = 0;
# -up_url, -up_title, -down_url, -down_title, -prev_url, -prev_title:
# If both of the following two variables are set then the "Up" button
# of the navigation panel in the first node/page of a converted document
# will point to $EXTERNAL_UP_LINK. $EXTERNAL_UP_TITLE should be set
# to some text which describes this external link.
$EXTERNAL_UP_LINK = "";
$EXTERNAL_UP_TITLE = "";
# Similarly you might set these variables to link external documents
# to your navigation panel.
#$EXTERNAL_DOWN_LINK = "";
#$EXTERNAL_DOWN_TITLE = "";
#$EXTERNAL_PREV_LINK = "";
#$EXTERNAL_PREV_TITLE = "";
#$EXTERNAL_INDEX = "";
#$EXTERNAL_CONTENTS = "";
# -info
$INFO = 1; # 0 = do not make an "About this document..." section
# -reuse, -no_reuse, Image recycling:
# If 0, do not reuse or recycle identical images. If the html subdirectory
# already exists, start the interactive session.
# If nonzero, do recycle them and switch off the interactive session.
# If 1, only recycle images generated from previous runs.
# If 2, recycle images from the current and previous runs.
$REUSE = 2;
# -no_images
# When $NO_IMAGES is set LaTeX2HTML will not attempt to produce any inlined images
# The missing images can be generated "off-line" by restarting LaTeX2HTML
# after setting $IMAGES_ONLY (see below);
$NO_IMAGES = 0;
# -images_only
# When $IMAGES_ONLY is set, LaTeX2HTML will only try to convert the inlined images
# in the file "images.tex" which should have been generated automatically during
# previous runs. This is very useful for correcting "bad LaTeX" in this file.
$IMAGES_ONLY = 0;
# When $DISCARD_PS is set, the PostScript file created for each generated image
# is discarded immediately after its image has been rendered and saved in the
# required graphics format. This can lead to significant savings in disk-space,
# when there are a lot of images, since otherwise these files are not discarded
# until the end of all processing.
$DISCARD_PS = 1;
# -show_section_numbers
# When this is 1, the section numbers are shown. The section numbers should
# then match those that would have bee produced by LaTeX.
# The correct section numbers are obtained from the $FILE.aux file generated
# by LaTeX.
# Hiding the seciton numbers encourages use of particular sections
# as standalone documents. In this case the cross reference to a section
# is shown using the default symbol rather than the section number.
$SHOW_SECTION_NUMBERS = 0;
# -unsegment
# Use this to translate a segmented document like it were not
# segmented.
$UNSEGMENT = 0;
# -short_index
# If this is set then makeidx.perl will construct codified names
# for the text of index references.
$SHORT_INDEX = 0;
# -debug
# If this is set then intermediate files are left for later inspection.
# This includes $$_images.tex and $$_images.log created during image
# conversion.
# Caution: Intermediate files can be *enormous*.
$DEBUG = 0;
# -html_version
# By default, the version of HTML produced is 2.0
$HTML_VERSION = '3.2';
# -no_math
# By default the special MATH extensions are not used
# since they do not conform with the HTML 3.2 standard.
$NO_MATH = 1;
### Other global variables ###############################################
# If this is set then the HTML will look better if viewed with Netscape.
$NETSCAPE_HTML = 0;
# Set this to 1 if you want interlaced images, 0 otherwise. Interlaced
# images build up gradually while downloading so one can get a first
# impression of what the final image will look like very quickly.
#
$INTERLACE = 1;
# Set this to 1 if you like the old LaTeX2HTML style to have a
# border around the navigation links.
# Values > 1 are also possible.
$NAV_BORDER = 0;
### Colors ###
#
# If this is set you may set colors in your document (see the LaTeX
# package color.dvi and the color.perl/colordvi.perl files).
# Note that HTML generated herefrom cannot be viewed by all browsers
# (at least Netscape or Mosaic 2.7 should do).
$COLOR_HTML = 0;
# Specify the path to your systems color database if you do not agree on
# the databases provided with the translator. Eg.: /usr/lib/X11/rgb.txt
# the RGB colors database
$RGBCOLORFILE = "rgb.txt";
# the CMYK colors database
$CRAYOLAFILE = "crayola.txt";
#
### End Colors ###
# Do not try to translate these input files, and do not
# complain about a missing Perl module.
# Complex LaTeX inputs, styles, or classes may cause the translator
# to hang. If this occurs add the input file here.
# You may also specify filename extensions here, e.g. if you do
# not want to include input files matching "*.myfig", add
# ``:.myfig''.
#
$DONT_INCLUDE = "2up:psfig:epsf:texinfo:pictex" .
"titlepage:openbib:\\d+pt:twoside:twocolumn:" .
"memo:dvipsfig:times:margins:aaii2:a4:art\\d+:doublespace:" .
"alltt:amstex:anysize:array:article:bm:book:bookman:" .
"boxedminipage:cite:comment:courier:dcolumn:doc:eepic:" .
"enumerate:epic:fleqn:float:floatflt:fullpage:index:" .
"inputenc:isolatin1:leqno:letter:llncs:makeidx:" .
"multicol:psfig:report:shadow:shapepar:showidx:" .
"slides:syntonly:sz:tabls:times:twoside:umlaut:umlaute";
# Latex2html usually does not include style files provided by
# \documentstyle, \documentclass, \usepackage but tries to use the
# corresponding *.perl files provided in the styles/ subdirectory.
# Now if you use home-brew style files with new environments/commands
# you may want to include them. E.g. if you want to include "mystyle.sty",
# say $DO_INCLUDE = "mystyle" here. Separate styles with colons. This
# setting overrides the settings in $DONT_INCLUDE. You may specify
# filename extensions here as well.
# $DO_INCLUDE = "";
# If you have equations in your text, you'll get the best results with
# PK_GENERATION=1. With this option switched on, DVIPS will be
# told to generate all of the images for a specific screen resoltion,
# eliminating "blurring" of small letters and subscripts.
# 'install-test' does *not* check whether PK_GENERATION will work.
# If any of it causes you grief, simply set PK_GENERATION=0,
# and your default printer's resolution will be used.
#
# Sidik Isani, <[EMAIL PROTECTED]> added this.
#
$PK_GENERATION = 0;
#
# Set the following variable ONLY if your version of dvips
# understands the "-mode" command line switch. It is a more reliable
# way of setting the METAfont mode than the .dvips file on versions that
# support this switch. If you do this, you do not need to modify .dvipsrc
# as described below. Herb Swan <[EMAIL PROTECTED]> added this.
#
# $DVIPS_MODE = "toshiba";
#
# Only if you have PK_GENERATION set to 1:
# A file 'modes.mf' is probably installed somewhere in your tex
# tree. e.g /usr/local/tex/texmf/mf/modes.mf or something similar.
# If it has and entry for 'toshiba', then you can ignore the rest.
# Otherwise, you'll need to try *one* of the following things:
#
# o Set PK_GENERATION=0 and generate images for your default printer
# o Download the latest modes.mf from the TeX archive and re-run inimf.
# o Choose another LOW RESOLUTION screen or printer entry from modes.mf,
# (preferably with "|blacker|" set to 0.0 and a 1:1 aspect ratio--
# If you don't have "toshiba", try "epsonlq", "lqlores", "nec", or "NEC")
# If you try some other mode, remember to update two other things as well:
#
# 1) Change the 'toshiba' in the .dvipsrc file that came with latex2html.
# 2) Put whatever the |pixels_per_inch| value is into $METAFONT_DPI
# and the .dvipsrc file
#
# Note: The maximum usable SCALE_FACTOR is determined by this resolution.
# A higher resolution will take more memory during processing (regardless
# of SCALE_FACTOR) but will allow higher SCALE_FACTORs. Do NOT just
# change this value though. It *must* match the |pixels_per_inch| of
# the metafont mode (e.g. `toshiba').
#
$METAFONT_DPI = 180 ;
# Controls which markup shows up between page and its foot.
$CHILDLINE = "<BR><HR>\n";
# If this is set as below, LaTeX2HTML produces a directory index link to
# the html document, ie. you may use <http://my.cite.is.here/dir/of/document>
# instead of <http://my.cite.is.here/dir/of/document/document.html>.
# Set it to eg. 'node1' to have the index pointing to node1.html, etc.
# Comment it out to have no index generation.
# Note: $EXTN is ".html" by default, see -short_extn.
#
$LINKPOINT = '"$FILE$EXTN"';
# Uses this one to determine the name of the directory index.
$LINKNAME = '"index$EXTN"';
# This is the line width measured in pixels and it is used to right justify
# equations and equation arrays;
$LINE_WIDTH = 500;
# Used in conjunction with AUTO_NAVIGATION
$WORDS_IN_PAGE = 300;
# Affects ONLY the way accents are processed
$default_language = 'english';
# The value of this variable determines how many words to use in each
# title that is added to the navigation panel (see below)
#
$WORDS_IN_NAVIGATION_PANEL_TITLES = 4;
# This number will determine the size of the equations, special characters,
# and anything which will be converted into an inlined image
# *except* "image generating environments" such as "figure", "table"
# or "minipage".
# Effective values are those greater than 0.
# Sensible values are between 0.1 - 4.
$MATH_SCALE_FACTOR = 1.6;
# This number, when defined, determines extra scaling for displayed equations.
# It multiplies with the $MATH_SCALE_FACTOR to give the total scaling.
# It is especially useful when \scriptscriptstyle text is used frequently,
# which would otherwise be extremely difficult to read on-screen.
#$DISP_SCALE_FACTOR = 1;
# This number will determine the size of
# image generating environments such as "figure", "table" or "minipage".
# Effective values are those greater than 0.
# Sensible values are between 0.1 - 4.
$FIGURE_SCALE_FACTOR = 1.6;
# This is yet another scaling factor which has a special use.
# When this number is set, images are created at a size scaled by the
# specified amount (multiplying any other scale factors).
# However the images are displayed unscaled, by setting the
# HEIGHT="..." and WIDTH="..." attributes to the unscaled size.
# Thus a larger image is squeezed into a smaller area.
# This allows for better quality when the HTML page is printed.
# {figure} environments are *not* affected by this factor.
#$EXTRA_IMAGE_SCALE = 2;
# If this is set to 0 then any inlined images generated from "figure"
# environments will NOT be transparent.
$TRANSPARENT_FIGURES = 1;
# Set the default body text, inserted between <BODY> ... </BODY>.
# See also \bodytext{..} provided with html.sty.
$BODYTEXT = "";
# Valid paper sizes are "letter", "legal", "note" and ...
# "a0", ... "a10", "b0", ... "b5";
# Recommended: "a5"
# Paper sizes has no effect other than with images that
# need special alignment;
# e.g for equation-numbering with HTML, version 2.0
# - larger paper sizes *MAY* help with large image problems
# - smaller paper sizes *MAY* be quicker to handle on some systems
$PAPERSIZE = "a5";
### Internationalization ######################################################
#
# Default values used by do_cmd_tableofcontents and others.
# Change them to suit your documents
sub english_titles {
$toc_title = "Contents";
$lof_title = "List of Figures";
$lot_title = "List of Tables";
$idx_title = "Index";
$ref_title = "References";
$bib_title = "Bibliography";
$abs_title = "Abstract";
$app_title = "Appendix";
$pre_title = "Preface";
$fig_name = "Figure";
$tab_name = "Table";
$part_name = "Part";
$prf_name = "Proof";
$child_name = "Subsections";
$info_title = "About this document ...";
@Month = ('', 'January', 'February', 'March', 'April', 'May',
'June', 'July', 'August', 'September', 'October',
'November', 'December');
$GENERIC_WORDS = "and|the|of|for|by|a|an|to";
}
# These words will be omitted from filenames derived
# from section-titles, when using -long_titles
# Override this value within a <language>_titles subroutine.
$GENERIC_WORDS = "and|the|of|for|by|a|an|to";
# Replace "english" with another language as long as
# titles for that language are defined above...
# (Make sure that you don't use a different default in your personal
# configuration file)
$TITLES_LANGUAGE = "english";
# To use titles in different languages use just add a new subroutine
# eg for esperanto:
# sub esperanto_titles {
# $toc_title = 'Esperanto title';
# etc...
# }
# and then say
# $TITLES_LANGUAGE = "esperanto";
#
# Note: This is automatically done for you when use the german or
# french style file, or when to specify either language through
# the babel package.
### Verbosity #################################################################
#
# The amount of message information printed to the screen during processing
# by LaTeX2HTML is controlled by the $VERBOSITY variable.
# Its value can also be set using the -verbosity <num> command-line switch.
# By increasing this value, more information is displayed.
# Here is the type of extra information that is shown at each level:
#
# $VERBOSITY = 0; # no extra information
# $VERBOSITY = 1; # section types and titles
# $VERBOSITY = 2; # environment
# $VERBOSITY = 3; # command names
# $VERBOSITY = 4; # links, labels and internal sectioning codes
#
$VERBOSITY = 1;
### Navigation Panel ##########################################################
#
# The navigation panel is constructed out of buttons and section titles.
# These can be configured in any combination with arbitrary text and
# HTML tags interspersed between them.
# The buttons available are:
# $PREVIOUS - points to the previous section
# $UP - points up to the "parent" section
# $NEXT - points to the next section
# $NEXT_GROUP - points to the next "group" section
# $PREVIOUS_GROUP - points to the previous "group" section
# $CONTENTS - points to the contents page if there is one
# $INDEX - points to the index page if there is one
#
# If the corresponding section exists the button will contain an
# active link to that section. If the corresponding section does
# not exist the button will be inactive.
#
# Also for each of the $PREVIOUS $UP $NEXT $NEXT_GROUP and $PREVIOUS_GROUP
# buttons there are equivalent $PREVIOUS_TITLE, $UP_TITLE, etc variables
# which contain the titles of their corresponding sections.
# Each title is empty if there is no corresponding section.
#
# The subroutine below constructs the navigation panel in each page.
# Feel free to mix and match buttons, titles, your own text, your logos,
# and arbitrary HTML (the "." is the Perl concatenation operator).
#JKR: Use two panels (top and bot) instead of one.
sub top_navigation_panel {
"<!--Navigation Panel-->" .
# Now add a few buttons with a space between them
"$NEXT $UP $PREVIOUS $CONTENTS $INDEX $CUSTOM_BUTTONS" .
"\n<BR>" . # Line break
# If ``next'' section exists, add its title to the navigation panel
($NEXT_TITLE ? "\n<B> Next:</B> $NEXT_TITLE" : undef) .
# Similarly with the ``up'' title ...
($UP_TITLE ? "\n<B> Up:</B> $UP_TITLE" : undef) .
# ... and the ``previous'' title
($PREVIOUS_TITLE ? "\n<B> Previous:</B> $PREVIOUS_TITLE" : undef) .
# These <BR>s separate it from the text body.
"\n<BR><BR>"
}
sub bot_navigation_panel {
# Start with a horizontal rule (3-d dividing line)
"<HR>\n" . "<!--Navigation Panel-->".
# Now add a few buttons with a space between them
"$NEXT $UP $PREVIOUS $CONTENTS $INDEX $CUSTOM_BUTTONS" .
"\n<BR>" . # Line break
# If ``next'' section exists, add its title to the navigation panel
($NEXT_TITLE ? "\n<B> Next:</B> $NEXT_TITLE" : undef) .
# Similarly with the ``up'' title ...
($UP_TITLE ? "\n<B> Up:</B> $UP_TITLE" : undef) .
# ... and the ``previous'' title
($PREVIOUS_TITLE ? "\n<B> Previous:</B> $PREVIOUS_TITLE" : undef)
}
### Meta Information #####################################################
#
# This information will be inserted in the HEAD of the generated
# HTML file. It can be used by automatic indexing scripts (eg
# site-index.pl at http://www.ai.mit.edu/tools/site-index.html)
# You can change the description, keywords, etc. values.
sub meta_information {
local($_) = @_;
# Cannot have nested HTML tags...
do { s/<[^>]*>//g;
"<META NAME=\"description\" CONTENT=\"$_\">\n" .
"<META NAME=\"keywords\" CONTENT=\"$FILE\">\n" .
"<META NAME=\"resource-type\" CONTENT=\"document\">\n" .
"<META NAME=\"distribution\" CONTENT=\"global\">\n" } if $_;
}
### Icons ################################################################
# Icon names and real icon files.
%icons =
(
'cross_ref_visible_mark' ,"cross_ref_motif.$IMAGE_TYPE",
'anchor_mark' ,' ',
'anchor_invisible_mark' ,' ',
'up_visible_mark' ,"up_motif.$IMAGE_TYPE",
'next_visible_mark' ,"next_group_motif.$IMAGE_TYPE",
'previous_visible_mark' ,"previous_group_motif.$IMAGE_TYPE",
'next_page_visible_mark' ,"next_motif.$IMAGE_TYPE",
'previous_page_visible_mark' ,"previous_motif.$IMAGE_TYPE",
'contents_visible_mark' ,"contents_motif.$IMAGE_TYPE",
'index_visible_mark' ,"index_motif.$IMAGE_TYPE",
'footnote_mark' ,"foot_motif.$IMAGE_TYPE",
'up_inactive_visible_mark' ,"up_motif_gr.$IMAGE_TYPE",
'next_inactive_visible_mark' ,"next_group_motif_gr.$IMAGE_TYPE",
'previous_inactive_visible_mark' ,"previous_group_motif_gr.$IMAGE_TYPE",
'next_page_inactive_visible_mark' ,"next_motif_gr.$IMAGE_TYPE",
'previous_page_inactive_visible_mark' ,"previous_motif_gr.$IMAGE_TYPE",
'change_begin_visible_mark',"change_begin.$IMAGE_TYPE",
'change_begin_right_visible_mark',"change_begin_right.$IMAGE_TYPE",
'change_end_visible_mark',"change_end.$IMAGE_TYPE",
'change_end_right_visible_mark',"change_end_right.$IMAGE_TYPE",
'change_delete_visible_mark',"change_delete.$IMAGE_TYPE",
'change_delete_right_visible_mark',"change_delete_right.$IMAGE_TYPE"
);
%iconsizes =
(
'up' ,'WIDTH="26" HEIGHT="24"',
'next','WIDTH="37" HEIGHT="24"',
'previous','WIDTH="63" HEIGHT="24"',
'next_group' ,'WIDTH="81" HEIGHT="24"',
'previous_group','WIDTH="107" HEIGHT="24"',
'change_begin','WIDTH="104" HEIGHT="24"',
'change_begin_right','WIDTH="104" HEIGHT="24" ALIGN="RIGHT"',
'change_end','WIDTH="104" HEIGHT="24"',
'change_end_right','WIDTH="104" HEIGHT="24" ALIGN="RIGHT"',
'change_delete','WIDTH="109" HEIGHT="24"',
'change_delete_right','WIDTH="109" HEIGHT="24" ALIGN="RIGHT"',
'contents','WIDTH="65" HEIGHT="24"',
'index','WIDTH="43" HEIGHT="24"'
);
$extern_image_mark = &extern_image_mark();
sub extern_image_mark {
"[IMAGE $_[0]]";
}
sub img_tag {
local($icon) = @_;
local($alt);
local($align) = " ALIGN=\"BOTTOM\" ";
$alt = join ('|', "up", "next_group", "previous_group"
, "next", "previous", "change_begin_right", "change_begin"
, "change_end_right", "change_end", "change_delete_right"
, "change_delete", "contents", "index");
if ($icon =~ /(gif|png)$/) {
$used_icons{$icon} = 1;
if ($icon =~ /change_(begin|end|delete)_right/) { $align = ' ' };
local($pre);
local($nav_border) = "\"$NAV_BORDER\"";
if ($icon =~ /($alt)/) {
$pre = "\n";
$alt = $1;
}
else {
$nav_border = '"1"';
$alt = '[*]';
};
if ($LOCAL_ICONS) {
return join('', $pre ,'<IMG ', $iconsizes{$1}, $align
,'BORDER=', $nav_border, ' ALT="', $alt
,'" SRC="', $icon, '">' );
}
else {
return join('', $pre ,'<IMG ', $iconsizes{$1}, $align
,'BORDER=', $nav_border, ' ALT="', $alt, "\"\n"
,' SRC="', $ICONSERVER, "/$icon", '">' );
}
}
else {
return $icon;
}
}
sub inactive_img {
# Replaces an image name xxx.gif with xxx_gr.gif
# It is assumed that _gr images contain the equivalent inactive icons
local($_) = @_;
s/(up|next|previous|next_page|previous_page)(_visible_mark)/$1_inactive$2/;
$_;
}
### ASCII Mode ###########################################################
# This subroutine defines the ascii strings to be used instead of the
# icons when the translator is invoked with the -ascii_mode option.
# Please modify them if you do not like them, BUT
# *** DO NOT USE THE SPACE CHARACTER (" ") FOR $anchor_invisible_mark ***
# (if you use " " then the cross-reference hyperlinks will not work).
sub ascii_mode {
$cross_ref_visible_mark = "[*]";
$anchor_mark = " ";
$anchor_invisible_mark = " ";
$up_visible_mark = "[Up]";
$next_visible_mark = "[Next Group]";
$previous_visible_mark = "[Previous Group]";
$next_page_visible_mark ="[Next]";
$previous_page_visible_mark ="[Previous]";
$up_inactive_visible_mark = "[Up]";
$next_inactive_visible_mark = "[Next Group]";
$previous_inactive_visible_mark = "[Previous Group]";
$next_page_inactive_visible_mark ="[Next]";
$previous_page_inactive_visible_mark ="[Previous]";
$contents_visible_mark = "[Contents]";
$index_visible_mark = "[Index]";
$footnote_mark = "[+]";
$extern_image_mark = &extern_image_mark;
$EXTERNAL_IMAGES = 1;
}
### Adding commands to be ignored ########################################
# Add LaTeX commands to be ignored.
# Each command should be on a separate line and have the format:
# <cmd_name>#{}# []# {}# [] etc.
# {} marks a compulsory argument and [] an optional one.
# Note that some commands may have arguments which should be left as
# text even though the command should be ignored (e.g. mbox, center, etc)
&ignore_commands( <<_IGNORED_CMDS_);
htmlrule # [] # \$_ = join('',"<BR><HR>",\$_)
mathversion # {}
underline # {} # \$_ = join('',"<U>", \$2, "</U>", \$_)
centerline # {} # \$_ = join('',"<P ALIGN=CENTER>", \$2, "</P>", \$_)
latexhtml# {}
latex# {}
html
lrule # {}
scrollmode
savebox# {}# []# []
center
citeindexfalse
_IGNORED_CMDS_
### Adding commands to be processed by TeX ###############################
# Commands which need to be passed, ALONG WITH THEIR ARGUMENTS, to TeX.
# The syntax is the same as that for ignore_commands above.
&process_commands_in_tex (<<_RAW_ARG_CMDS_);
fbox # {}
framebox # [] # [] # {}
_RAW_ARG_CMDS_
1; # This must be the last line
________________________________________________________
[EMAIL PROTECTED]
"Blessed are those who have not seen and yet have faith." - John 20:29
