diff options
author | Karl Berry <karl@freefriends.org> | 2014-03-23 22:12:25 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2014-03-23 22:12:25 +0000 |
commit | 43f0cab68a9ea1b2cc9385df46487eb6f4cba012 (patch) | |
tree | b166042c22748d2090d128a93cd018421d3e54e4 /Master/texmf-dist/doc/latex/prerex/prerex.tex | |
parent | 9abfc4f95bed4bf19e6ceb6bd34d9dc7e752f34d (diff) |
prerex (23mar14)
git-svn-id: svn://tug.org/texlive/trunk@33264 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/prerex/prerex.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/prerex/prerex.tex | 51 |
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 |