summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/prerex/prerex.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/prerex/prerex.tex')
-rw-r--r--Master/texmf-dist/doc/latex/prerex/prerex.tex51
1 files changed, 32 insertions, 19 deletions
diff --git a/Master/texmf-dist/doc/latex/prerex/prerex.tex b/Master/texmf-dist/doc/latex/prerex/prerex.tex
index 1146461bb67..448ef4e5ef0 100644
--- a/Master/texmf-dist/doc/latex/prerex/prerex.tex
+++ b/Master/texmf-dist/doc/latex/prerex/prerex.tex
@@ -3,10 +3,11 @@
\usepackage[medium,semibold,scale=0.95]{cabin}
\usepackage{fullpage}
\usepackage{prerex}
+\newcommand{\myurl}[1]{\textcolor{blue}{\underline{\textcolor{black}{\url{#1}}}}}
%\def\LaTeX{\mbox{LaTeX}}
\begin{document}
-\title{\textsf{prerex.sty}: Prerequisite Charts in \LaTeX\\{\large Version 6.4}}
+\title{\textsf{prerex.sty}: Prerequisite Charts in \LaTeX\\{\large Version 6.5}}
\author{R. D. Tennent\\\texttt{rdt@cs.queensu.ca}}
\date{\today}
\maketitle
@@ -15,17 +16,16 @@
\section{Description}
\texttt{prerex.sty}
defines macros that
-[pdf]\LaTeX\
+\LaTeX\ processors
can use
-to draw charts consisting of labelled course boxes linked by arrows
+to create charts consisting of labelled course boxes linked by arrows
that represent pre- and co-requisite requirements; see
the example chart in Figure~\ref{chart} on page~\pageref{chart}.
-In addition to the usual
-output, auxiliary files will be generated containing image-map data for the
-hyperlinked nodes in the diagram and a shell script for cropping a PNG image
-obtained from the output; however, the page coordinates may not be accurate unless pdf\LaTeX\
-is used as the
-processing engine.
+If pdf\LaTeX\ is used as the processing engine,
+three auxiliary files will be generated, as follows: image-map data and SVG commands for the
+hyperlinked nodes in the diagram, and a shell script for cropping a PNG image
+obtained from the output. pdf\LaTeX\ must be used as the processing engine
+to get accurate page coordinates.
If the source file satisfies the constraints
of the
@@ -384,8 +384,8 @@ and
\verb\latex\ (followed by \verb\dvips\ and, possibly, \verb\ps2pdf\)
\emph{or}
\verb\latex\ (with suitable driver options, followed by \verb\dvipdfmx\)
-may be used; however, cropping shell scripts and
-image maps are only generated if \verb\pdflatex\
+may be used; however, cropping shell scripts,
+image maps and link data files are only generated if \verb\pdflatex\
is used.
\section{Conversion to Portable Network Graphic (PNG) Format}
@@ -410,6 +410,19 @@ If \verb\pdflatex\ is used, an auxiliary file
containing image-map data for the hyperlinked nodes in the chart is also generated;
consult a reference on the HTML language for an explanation of (client-side) image maps.
+\section{Conversion to Scalable Vector Graphic (SVG) Format}
+
+SVG is an emerging standard for high-quality graphics. The
+\texttt{pdf2svg}\footnote{%
+\myurl{http://www.cityinthesky.co.uk/opensource/pdf2svg/}}
+program uses \texttt{poppler} and \texttt{cairo} libraries
+to convert a PDF page to a scalable vector-graphic image. When compressed
+by \texttt{gzip} into \texttt{.svgz} format, the image file is comparable in size and quality
+to the PDF form. Currently, links in the PDF are not converted by \texttt{poppler} and
+\texttt{cairo} to links
+in the SVG image. Since Version~6.5, an auxiliary file of suitable commands for inclusion in
+a \texttt{.svg} image is generated by pdf\LaTeX\ processing.
+
\section{Installation}
\begin{enumerate}
@@ -439,7 +452,7 @@ user:
\end{list}
where the argument should be in the range $0$--$100$; $0$ means no curvature.
\begin{list}{}{}
-\item \verb|\newcommand{\CourseURL}[3]{#3.html}|
+\item \verb|\newcommand{\CourseURL}[3]{./#3.html}|
\end{list}
where the arguments supplied at the call are the $x$ and $y$ coordinates
of the box or mini and the course code.
@@ -531,16 +544,16 @@ PDF viewers to compute chart coordinates.
\subsection{Chart Images}
-\enlargethispage*{8ex}
-
To support HTML versions of charts,
\texttt{prerex.sty}
(if processed by \verb\pdflatex\) generates a script to crop a chart image at the southeast corner, allowing
-descriptive notes below the chart to be treated as ordinary text. Also,
-it generates image-map data for use with an HTML image map. To
-obtain absolute page coordinates, the \texttt{zsavepos}, \texttt{zposx}
-and \texttt{zposy} commands are used; the page coordinates are converted into pixel coordinates
-for cropping and image-map use.
+descriptive notes below the chart to be treated as ordinary text. Also, for the clickable links,
+it generates image-map data for use with an HTML image map and
+\texttt{xlink} commands for embedding into an
+SVG image. To
+obtain absolute page coordinates for these auxiliary files, the \texttt{zsavepos}, \texttt{zposx}
+and \texttt{zposy} commands are used; the page coordinates are converted into pixel
+coordinates.
\section{License}
\verb|prerex.sty|, \verb|prerex.sty.7|, \verb|README.prerex| and this document may be distributed and/or modified under the