Skip to content
Permalink
Browse files

fix dead urls

  • Loading branch information...
Dan Gildea
Dan Gildea committed Mar 29, 2019
1 parent 668316e commit 77ff6d4a730af28d607438c057c1a449491c4d5c
Showing with 27 additions and 102 deletions.
  1. +6 −31 INSTALL
  2. +3 −6 README.md
  3. +3 −3 docs/Makefile
  4. +4 −6 docs/features.tex
  5. +2 −3 docs/hypextra.tex
  6. +1 −12 docs/manhtml.tex
  7. +2 −1 docs/manual.tex
  8. +6 −40 docs/support.tex
37 INSTALL
@@ -1,22 +1,13 @@
LaTeX2HTML 99.2 Installation Manual
LaTeX2HTML Installation Manual
===================================

The installation procedure has changed substantially from version 98.3 on.
It now resembles more closely the GNU installation scheme, while providing
alternatives for Win32 and OS/2 users.

Step by step cookbook
=====================

Perl version 5.8 and below uses old style multiline regex matching.
Perl version 5.10 and above uses new style multiline regex matching.
Perl version 5.18 is buggy and prevents LaTeX2HTML from working correctly.
Perl version 5.22 seems to be OK.

A. UNIX
-------

(Win 95, 98, NT and OS/2 users see below)
(Windows users see below)

0. Unpacking

@@ -120,7 +111,7 @@ See below "Further General Aspects" for information on useful site-wide
configuration.


B. DOS, Win32, OS/2
B. DOS, Win32
-------------------

0. Unpacking
@@ -129,20 +120,6 @@ Unpack the tar file into a temporary area. This has changed: Do not unpack
the tar file to the final desired location (e.g. /usr/local/latex2html).
Read the INSTALL file. Oops, you are already here...

On OS/2, rename CONFIG.BAT to CONFIG.CMD and modfify the PERL environment
setting (in CONFIG.CMD) in the following way:

set PERL=perl_

This is needed because this "version" of the Perl executable has some
additional features that are required by LaTeX2HTML.
If you want to make use of the Makefiles on OS/2 (this works if you have
the GNU utilities installed), then you should include a line

SHELL=.../sh.exe

with ... being the path to the bourne shell executable. Thanks to
Uli Wortmann for this hint.

1. Configuring

@@ -151,8 +128,7 @@ should not have to change much apart from the path where LaTeX2HTML should
be installed on your system. The executables are found automatically if
located in the directories specified in your PATH environment. If your perl
interpreter is not named "perl" or if you have more than one perl installed,
you should edit CONFIG.BAT (or CONFIG.CMD on OS/2, in the following CONFIG.*
is used for brevity) and specify the exact path to your (desired) perl
you should edit CONFIG.BAT and specify the exact path to your (desired) perl
interpreter.
If you have just installed some of the required external utilities and
have not yet added the paths to the PATH environment, you may specify
@@ -182,7 +158,7 @@ automatically, using the settings found in the previous step.

3. Testing

The CONFIG.* script created a TEST.BAT (TEST.CMD on OS/2) file that
The CONFIG.* script created a TEST.BAT file that
compiles a small test document located in the "tests" subdirectory.
You may specify additional LaTeX2HTML options (up to arguments) on the
TEST.* command line.
@@ -195,8 +171,7 @@ stored to your PATH environment.

4. Installing

Install LaTeX2HTML in its final location by running INSTALL.BAT
(INSTALL.CMD on OS/2).
Install LaTeX2HTML in its final location by running INSTALL.BAT.

5. Cleaning up

@@ -55,17 +55,14 @@ The LaTeX2HTML program includes its own manual page.
The manual page can be viewed by saying "perldoc latex2html"
or "latex2html -help".

See the documentation at
http://mirrors.ctan.org/support/latex2html/manual.pdf
for more information and examples.
See the manual in the docs directory for more information and
examples.

Other useful links can be found at: www.latex2html.org
and at the mailing-list site:
http://tug.org/mailman/listinfo/latex2html

In particular see the pages:
support.html , Snode1.html , Snode2.html , Snode3.html
for instructions on how to install the program
See the file INSTALL for instructions on how to install the program
and make your own local copy of the manual in HTML.

Requirements
@@ -17,7 +17,7 @@
# These are the usual calls to application programs
#
DVIPS = dvips
DVIPDF = dvipdf
DVIPDF = dvipdfm
# set TEXINPUTS to use the html.sty included in this package
LATEX = TEXINPUTS=../texinputs:: latex
MAKEINDEX = makeindex
@@ -135,8 +135,8 @@ LSEC7 = $(COMMON) -prefix C -dir $(TOP) -info 0 \
# dvi- and PostScript versions
#

manual.pdf: manual.dvi
$(DVIPDF) manual.dvi $@
manual.pdf: manual.ps
ps2pdf manual.ps

manual.ps: manual.dvi
$(DVIPS) manual.dvi -o $@
@@ -931,9 +931,8 @@ \subsubsection{An Embedded Image Example\index{images!embedded image}}%
\latex{\addtocounter{footnote}{-1}}
\caption{A sample figure showing part of a page generated by
\latextohtml{} containing a customised navigation panel
(from the \htmladdnormallink
{CSEP project\latex{\protect\footnotemark}}
{http://csep1.phy.ornl.gov/csep.html}).}\label{fig:example}
(from the
CSEP project).}\label{fig:example}
\end{figure}
\end{verbatim}
%begin{latexonly}
@@ -951,9 +950,8 @@ \subsubsection{An Embedded Image Example\index{images!embedded image}}%
\latex{\addtocounter{footnote}{-1}}%
\caption{A sample figure showing part of a page generated by
\protect\latextohtml{} containing a customised navigation panel
(from the \htmladdnormallink
{CSEP project\protect\latex{\protect\footnotemark}}%
{http://csep1.phy.ornl.gov/csep.html}).}\label{fig:example}
(from the
CSEP project).}\label{fig:example}
\end{figure}


@@ -505,7 +505,7 @@ \subsection{Including Arbitrary HTML Mark-up and Comments\label{sec:markup}}%
\index{electronic forms}\label{eform}\html{\\}\noindent
A~particularly good use of the \env{rawhtml} environment
is in the creation of interactive
\htmladdnormallink{electronic forms}{http://south.ncsa.uiuc.edu/forms.html}
electronic forms
from within a \LaTeX{} document.
When producing the paper (\texttt{.dvi}) version
of a document the \env{rawhtml} environment is ignored.
@@ -1595,8 +1595,7 @@ \subsubsection{Cross-Referencing Example\label{crossrefs}}%
\index{link validation!symbolic labels}\html{\\}%
Next consider how it could be done with symbolic labels.
First you have to import the labels used in this document
by copying the file \htmladdnormallink{\fn{labels.pl}}
{http://cbl.leeds.ac.uk/nikos/tex2html/doc/manual/labels.pl},
by copying the file \fn{labels.pl},
saving it in \path{/tmp/labels.pl} say,
then adding anywhere in your document:
%begin{latexonly}
@@ -22,7 +22,6 @@
\url{http://www.latex2html.org/current/}}
% \url{http://www-dsed.llnl.gov/files/programs/unix/latex2html/sources/}}
% \def\sourceB{\htmlurl{ftp://ftp.mpn.com/pub/nikos/latex2html-98.1.tar.gz}}
\def\sourceB{\CTANtug{\CTANA}}
\def\sourceC{\htmlurl{http://ftp.rzg.mpg.de/pub/software/latex2html/sources/}}
% \def\CVSsite{\url{http://cdc-server.cdc.informatik.tu-darmstadt.de/\~{}latex2html/}}
% \def\CVSrepos{\url{http://cdc-server.cdc.informatik.tu-darmstadt.de/\~{}latex2html/user/}}
@@ -32,8 +31,6 @@
\def\CVSrepos{\htmlurl{https://www.github.com/latex2html/latex2html/}}
% \def\CVSlatest{\htmlurl{http://saftsack.fs.uni-bayreuth.de/~latex2ht/l2h-latest.tar.gz}}
\def\CVSlatest{\htmlurl{https://www.github.com/latex2html/latex2html/archive/master.zip}}
\newcommand{\CTANtug}[1]{\htmlurl{http://mirrors.ctan.org/#1}}
\def\CTANA{support/latex2html}
\def\tugURL{\htmlurl{http://www.tug.org/}}
\def\danteURL{\htmlurl{http://www.dante.de/}}
% \def\ListURL{\htmlurl{http://www.xray.mpe.mpg.de/mailing-lists/latex2html/}}
@@ -71,14 +68,6 @@

\newcommand{\texdev}[1]{\htmladdnormallink
{\texdevURL/#1}{\texdevURL/#1}}
\newcommand{\ctan}{http://ctan.tug.org/ctan}
\newcommand{\ctanTUG}{\htmladdnormallinkfoot
{TUG's searchable CTAN site}{\ctan}}
\newcommand{\ctanURL}[1]{\htmladdnormallink
{CTAN:\texttt{.../#1}}{\ctan/#1}}
\newcommand{\ctanURLbr}[1]{\htmladdnormallink
{CTAN:\texttt{.../#1}}{\ctan/#1}}
\newcommand{\ctanTUGurl}[2]{\ctanURL{#2}}
\newcommand{\indichtml}{l2h/indic/IndicHTML/}

\end{htmlonly}
@@ -279,7 +268,7 @@
\htmladdnormallink{\LaTeX{3}}{http://www.tex.ac.uk/CTAN/latex/latex3}}
%
\newcommand{\Engberg}{\index{Uffe Engberg}%
\htmladdnormallinkfoot{Uffe Engberg}{http://www.brics.dk/\~{}engberg}}
{Uffe Engberg}}

\newcommand{\texdevINDIC}{\texdev\indic}
%\endinput
@@ -1,7 +1,8 @@
%\scrollmode
%\documentclass[dvips,a4paper,twoside]{article}
\documentclass[dvips,a4paper]{article}
\usepackage[dvips]{graphicx,color}
\usepackage{graphicx}
%\usepackage{xcolor}
% \usepackage{times}

\usepackage{html,htmllist,makeidx,enumerate}
@@ -29,13 +29,6 @@ \subsection{Requirements}%
Windows users will probably want to read the section about
\htmlref{installation on Windows}{windowsinst}.

In case you find one of the URLs below broken, use the search
engine on the TUG home page \CTANtug{} in order to locate the tool.
Other Web-searching facilities such as Altavista or \appl{FTP search}%
\htmladdnormallinkfoot{\html{ }}{http://ftpsearch.ntnu.no/ftpsearch}
will also do the job.

\medskip\noindent
For the best use of \latextohtml{} you want to get the latest
versions of all the utilities that it uses. (It will still work
with earlier versions, but some special effects may not be possible.
@@ -201,8 +194,7 @@ \subsection{Installation on Windows}
for providing this list!
\begin{itemize}
\item install \fn{WinZip};
\item install \TeX/\LaTeXe{} and \fn{dvips};\\
E.g. the \fn{MikTeX} $1.20$ distribution from \MikTeXURL.
\item install \TeX/\LaTeXe{} and \fn{dvips};
\item install \fn{Perl};\\
E.g. \fn{ActivePerl} $509$ or higher from \ActiveStateURL.
Windows $95$ users will also need \fn{DCOM}, it is listed on
@@ -247,30 +239,8 @@ \subsection{Installation on Windows}
package managers for Linux, and the macports package manager for MacOS.

\index{source code}%
\index{source code!from CTAN}%
\index{CTAN}%
Releases of \latextohtml\ may also be obtained through one of the
\htmladdnormallink{Comprehensive \TeX{} Archive Network (CTAN)}%
{\CTANtug{}} sites.
They are located at
\begin{htmllist}\htmlitemmark{GreenBall}
\item [US ]
United States:
\htmladdnormallink{\path{https://www.ctan.org/}}{https://www.ctan.org/}\,,
\item [DE ]
Germany:
\htmladdnormallink{\path{ftp://ftp.dante.de/}}%
{ftp://ftp.dante.de/}\,.
\end{htmllist}
In the directory \htmladdnormallink{\CTANA/}{\CTANtug{\CTANA}}
should be the latest version, as a compressed archive.

\smallskip\noindent
There are also many mirrors.
To find the mirror nearest to you, use:
\htmladdnormallink{\path{http://mirror.ctan.org/}\CTANA}%
{http://mirror.ctan.org/\CTANA}.

Releases of \latextohtml\ may also be obtained at
\htmladdnormallink{\path{https://www.github.com/latex2html/latex2html/releases}}{https://www.github.com/latex2html/latex2html/releases}\,,

\bigskip
\index{source code!developer's repository}\label{cvsrepos}%
@@ -282,21 +252,17 @@ \subsection{Installation on Windows}
A daily updated compressed archive of the developers' work may be
downloaded from \CVSlatest\,.

\begin{quote}
\textbf{Warning: }Use the files from this site at your own risk.
\end{quote}%

\htmlrule\index{source code!compressed}%
\medskip\noindent
Having obtained a compressed \fn{tar} version, save it into a file
\fn{latex2html-98.1.tar.gz} say,
\fn{latex2html-2019.tar.gz} say,
then extract its contents with
%begin{latexonly}
\begin{small}
%end{latexonly}
\begin{verbatim}
% gzip -d latex2html-98.1.tar.gz
% tar xvf latex2html-98.1.tar
% gzip -d latex2html-2019.tar.gz
% tar xvf latex2html-2019.tar
\end{verbatim}
%begin{latexonly}
\end{small}

0 comments on commit 77ff6d4

Please sign in to comment.
You can’t perform that action at this time.