summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/prerex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/prerex')
-rw-r--r--Master/texmf-dist/doc/latex/prerex/README6
-rw-r--r--Master/texmf-dist/doc/latex/prerex/chart.dat33
-rw-r--r--Master/texmf-dist/doc/latex/prerex/chart.map18
-rw-r--r--Master/texmf-dist/doc/latex/prerex/chart.pdfbin47713 -> 45363 bytes
-rw-r--r--Master/texmf-dist/doc/latex/prerex/chart.sh3
-rw-r--r--Master/texmf-dist/doc/latex/prerex/chart.svgzbin0 -> 31216 bytes
-rw-r--r--Master/texmf-dist/doc/latex/prerex/intro.pdfbin284350 -> 285602 bytes
-rw-r--r--Master/texmf-dist/doc/latex/prerex/intro.tex29
-rw-r--r--Master/texmf-dist/doc/latex/prerex/prerex.pdfbin144411 -> 156356 bytes
-rw-r--r--Master/texmf-dist/doc/latex/prerex/prerex.sty.735
-rw-r--r--Master/texmf-dist/doc/latex/prerex/prerex.sty.7.pdfbin0 -> 16953 bytes
-rw-r--r--Master/texmf-dist/doc/latex/prerex/prerex.tex51
12 files changed, 137 insertions, 38 deletions
diff --git a/Master/texmf-dist/doc/latex/prerex/README b/Master/texmf-dist/doc/latex/prerex/README
index fce4dc5536b..3c41586e730 100644
--- a/Master/texmf-dist/doc/latex/prerex/README
+++ b/Master/texmf-dist/doc/latex/prerex/README
@@ -1,4 +1,4 @@
-prerex, version 2014-03-02. Macros for prerequisite charts, with
+prerex, version 2014-03-22. Macros for prerequisite charts, with
associated editor and viewer applications.
This package consists of
@@ -17,8 +17,8 @@ The implementation of prerex.sty is built on pgf, so that it may be
used equally happily with latex or pdflatex; prerex is written in C
and vprerex is written in C++ using the Qt-4 and poppler libraries.
-See chart.{pdf,html} for a small example of a prerequisite chart and
-real-life examples at
+See chart.{pdf,html,svgz} for a small example of a prerequisite
+chart and real-life examples at
http://www.cs.queensu.ca/students/undergraduate/prerequisites/
diff --git a/Master/texmf-dist/doc/latex/prerex/chart.dat b/Master/texmf-dist/doc/latex/prerex/chart.dat
new file mode 100644
index 00000000000..77ac2237116
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/prerex/chart.dat
@@ -0,0 +1,33 @@
+<a xlink:href="1083.html" target="course"> <rect fill-opacity="0.0" opacity="0.0"
+x="315" y="72" width="46" height="57"/></a>
+<a xlink:href="1303.html" target="course"> <rect fill-opacity="0.0" opacity="0.0"
+x="170" y="119" width="46" height="23"/></a>
+<a xlink:href="2813.html" target="course"> <rect fill-opacity="0.0" opacity="0.0"
+x="199" y="176" width="46" height="23"/></a>
+<a xlink:href="2023.html" target="course"> <rect fill-opacity="0.0" opacity="0.0"
+x="286" y="176" width="46" height="23"/></a>
+<a xlink:href="2513.html" target="course"> <rect fill-opacity="0.0" opacity="0.0"
+x="401" y="176" width="46" height="23"/></a>
+<a xlink:href="1083.html" target="course"> <rect fill-opacity="0.0" opacity="0.0"
+x="96" y="205" width="23" height="11"/></a>
+<a xlink:href="2333.html" target="course"> <rect fill-opacity="0.0" opacity="0.0"
+x="84" y="234" width="46" height="23"/></a>
+<a xlink:href="2013.html" target="course"> <rect fill-opacity="0.0" opacity="0.0"
+x="286" y="234" width="46" height="23"/></a>
+<a xlink:href="2685.html" target="course"> <rect fill-opacity="0.0" opacity="0.0"
+x="343" y="234" width="46" height="23"/></a>
+<a xlink:href="2013.html" target="course"> <rect fill-opacity="0.0" opacity="0.0"
+x="159" y="263" width="23" height="11"/></a>
+<a xlink:href="3323.html" target="course"> <rect fill-opacity="0.0" opacity="0.0"
+x="113" y="291" width="46" height="23"/></a>
+<a xlink:href="3813.html" target="course"> <rect fill-opacity="0.0" opacity="0.0"
+x="170" y="291" width="46" height="23"/></a>
+<a xlink:href="3413.html" target="course"> <rect fill-opacity="0.0" opacity="0.0"
+x="228" y="291" width="46" height="23"/></a>
+<a xlink:href="3013.html" target="course"> <rect fill-opacity="0.0" opacity="0.0"
+x="286" y="291" width="46" height="23"/></a>
+<a xlink:href="3513.html" target="course"> <rect fill-opacity="0.0" opacity="0.0"
+x="361" y="291" width="46" height="23"/></a>
+<a xlink:href="3503.html" target="course"> <rect fill-opacity="0.0" opacity="0.0"
+x="430" y="291" width="46" height="23"/></a>
+</svg>
diff --git a/Master/texmf-dist/doc/latex/prerex/chart.map b/Master/texmf-dist/doc/latex/prerex/chart.map
new file mode 100644
index 00000000000..1b045d74de8
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/prerex/chart.map
@@ -0,0 +1,18 @@
+<map name="chart">
+<area shape=rect coords="548,225,628,125" href="1083.html" target="new" alt="1083">
+<area shape=rect coords="298,245,378,205" href="1303.html" target="new" alt="1303">
+<area shape=rect coords="348,345,428,305" href="2813.html" target="new" alt="2813">
+<area shape=rect coords="498,345,578,305" href="2023.html" target="new" alt="2023">
+<area shape=rect coords="698,345,778,305" href="2513.html" target="new" alt="2513">
+<area shape=rect coords="168,375,208,355" href="1083.html" target="new" alt="1083">
+<area shape=rect coords="148,445,228,405" href="2333.html" target="new" alt="2333">
+<area shape=rect coords="498,445,578,405" href="2013.html" target="new" alt="2013">
+<area shape=rect coords="598,445,678,405" href="2685.html" target="new" alt="2685">
+<area shape=rect coords="278,475,318,455" href="2013.html" target="new" alt="2013">
+<area shape=rect coords="198,545,278,505" href="3323.html" target="new" alt="3323">
+<area shape=rect coords="298,545,378,505" href="3813.html" target="new" alt="3813">
+<area shape=rect coords="398,545,478,505" href="3413.html" target="new" alt="3413">
+<area shape=rect coords="498,545,578,505" href="3013.html" target="new" alt="3013">
+<area shape=rect coords="628,545,708,505" href="3513.html" target="new" alt="3513">
+<area shape=rect coords="748,545,828,505" href="3503.html" target="new" alt="3503">
+</map>
diff --git a/Master/texmf-dist/doc/latex/prerex/chart.pdf b/Master/texmf-dist/doc/latex/prerex/chart.pdf
index af8935b4e7b..354568cfcc3 100644
--- a/Master/texmf-dist/doc/latex/prerex/chart.pdf
+++ b/Master/texmf-dist/doc/latex/prerex/chart.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/prerex/chart.sh b/Master/texmf-dist/doc/latex/prerex/chart.sh
new file mode 100644
index 00000000000..93480aa374a
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/prerex/chart.sh
@@ -0,0 +1,3 @@
+#!/bin/sh
+mogrify -crop 1000x666+0+0 chart.png
+exit 0
diff --git a/Master/texmf-dist/doc/latex/prerex/chart.svgz b/Master/texmf-dist/doc/latex/prerex/chart.svgz
new file mode 100644
index 00000000000..cfad47bdfdc
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/prerex/chart.svgz
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/prerex/intro.pdf b/Master/texmf-dist/doc/latex/prerex/intro.pdf
index ba6cb15c8e5..2b4e956ad15 100644
--- a/Master/texmf-dist/doc/latex/prerex/intro.pdf
+++ b/Master/texmf-dist/doc/latex/prerex/intro.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/prerex/intro.tex b/Master/texmf-dist/doc/latex/prerex/intro.tex
index e03d426e2fd..e89c60dcebe 100644
--- a/Master/texmf-dist/doc/latex/prerex/intro.tex
+++ b/Master/texmf-dist/doc/latex/prerex/intro.tex
@@ -132,7 +132,9 @@ to accommodate paper size, display resolution, or user preference.
Charts can also be converted to Portable Network Graphics (PNG)
format for in-line use on a web page. PNG format is also relatively compact
-and can be rendered directly by most web browsers.
+and can be rendered directly by most web browsers. Scalable Vector Graphics (SVG)
+format is a new standard which is increasingly supported by modern browsers; it is fairly easy to
+convert PDF pages to SVG images.
Prerex-formatted charts are produced by software that processes simple and convenient
text-based descriptions. These descriptions can be edited in any
@@ -475,6 +477,21 @@ From version 5.0, \verb|prerex.sty| (if processed by \verb\pdflatex\) generates
containing image-map data for the hyperlinked nodes in the chart; consult a
reference on the HTML language for an explanation of (client-side) image maps.
+\section{Conversion to Scalable Vector Graphics (SVG) Format}
+
+Recent versions of popular browsers support SVG graphics natively,; i.e., without
+requiring a plug-in or
+external application. The quality and size of SVG images are comparable to PDF when
+the files are compressed.
+
+On Unix-like platforms such as Linux, a small program called \verb\pdf2svg\ is
+available\footnote{%
+\myurl{http://www.cityinthesky.co.uk/opensource/pdf2svg/}}; it uses standard
+libraries (\verb\poppler\ and \verb\cairo\) to implement
+the conversion. Since version~6.5, pdf\LaTeX\ processing will generate an auxiliary
+file \verb|\jobname.dat| of data on links in the PDF, as most conversion
+applications do not attempt to convert PDF hyperlinks to SVG links.
+
\section{Terminology and Coordinate System}
Before we discuss the \texttt{prerex} editor and the format
@@ -533,14 +550,14 @@ in the background of a chart.
The coordinates of a
\emph{box,}
-\emph{mini,
+\emph{mini},
or
-\emph{text-line}}
+\emph{text}
are those of its centre point.
An
\emph{arrow}
is described by the
-coordinates of the centre points of its source and target boxes/minis/text-lines.
+coordinates of the centre points of its source and target boxes/minis/texts.
\section{Chart Editing}
\label{editor}
@@ -554,11 +571,11 @@ and the Fink\footnote{\myurl{http://fink.sourceforge.net/}} platform
on OS~X.
The editor supports add, remove, cut-and-paste, and edit operations
-on course boxes, minis, text-lines, and arrows, and shifts of specified diagram elements or an entire diagram.
+on course boxes, minis, texts, and arrows, and shifts of specified diagram elements or an entire diagram.
A summary of all
commands supported by \texttt{prerex} is given in Table~\ref{help}.
%on page~\pageref{help}.
-Note that if a course box/mini/text-line is ``cut''
+Note that if a course box/mini/text is ``cut''
and then ``pasted'' elsewhere, the target or source coordinates of arrows into or out of the source and target are
adjusted accordingly, and similarly if nodes are shifted or raised. To allow permutations of two or more
chart elements, the
diff --git a/Master/texmf-dist/doc/latex/prerex/prerex.pdf b/Master/texmf-dist/doc/latex/prerex/prerex.pdf
index 4ba8a28f61e..15644cd9d0f 100644
--- a/Master/texmf-dist/doc/latex/prerex/prerex.pdf
+++ b/Master/texmf-dist/doc/latex/prerex/prerex.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/prerex/prerex.sty.7 b/Master/texmf-dist/doc/latex/prerex/prerex.sty.7
index d71cf77aeee..acc4b0abe75 100644
--- a/Master/texmf-dist/doc/latex/prerex/prerex.sty.7
+++ b/Master/texmf-dist/doc/latex/prerex/prerex.sty.7
@@ -1,4 +1,4 @@
-.TH PREREX.STY 7 2014-02-28 "prerex.sty-6.4" ""
+.TH PREREX.STY 7 2014-03-22 "prerex.sty-6.5" ""
.SH NAME
prerex.sty \- a LaTeX document style for prerequisite charts
.SH DESCRIPTION
@@ -8,9 +8,10 @@ defines macros that
can use
to draw charts consisting of labelled course boxes linked by arrows
that represent pre- and co-requisite requirements.
-In addition to the usual
-.B [pdf]latex
-output, auxiliary files will be generated containing image-map data for the
+If
+.B pdflatex
+is used,
+auxiliary files will be generated as follows: image-map data and xlink commands for the
hyperlinked nodes in the diagram and a shell script to crop a PNG image generated from
a Postscript or PDF chart.
.P
@@ -202,7 +203,7 @@ command.
.SH WEB LINKS
Course boxes (including minis) may be hyperlinked.
The default URL for course boxes is
-.IR course-code .html
+.IR ./course-code .html
where
.I course-code
is
@@ -351,7 +352,7 @@ This implementation of
.B prerex.sty
uses
.B pgf
-(version 1.18 or later)
+(version 3.0 or later)
with add-on package
.B tikz.
The following additional packages are used:
@@ -371,6 +372,10 @@ followed by
.BR dvips (1)
(and possibly
.BR ps2pdf (1))
+.I or
+.BR latex (1)
+followed by
+.BR dvipdfmx (1)
may be used.
.P
To convert a chart to a compact but reasonably high-quality image, it is suggested to use the
@@ -395,6 +400,12 @@ crops the image at the southeast corner.
It is possible to use a PNG compression application such as
.BR optipng (1)
to reduce the file-size of the cropped image (without loss of quality).
+.P
+To convert a PDF chart to SVG (Scaleable Vector Graphic) format, it is recommended to
+use
+.BR pdf2svg (1),
+obtainable from
+http://www.cityinthesky.co.uk/opensource/pdf2svg/.
.SH IMPLEMENTATION DETAILS
.P
@@ -430,16 +441,18 @@ PDF viewers to compute chart coordinates.
.P
To support HTML versions of charts,
.B prerex.sty
+(when processed by
+.BR pdflatex (1))
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
+it generates image-map data for use with an HTML image map and
+xlink data for use with a SVG image. To
obtain absolute page coordinates, the
.B zsavepos,
.B zposx
and
.B zposy
-commands are used; the page coordinates are converted into pixel coordinates
-for cropping and image-map use.
+commands are used; the page coordinates are converted into pixel coordinates.
.SH LICENSE
.B prerex.sty
and this document may be distributed and/or modified under the
@@ -449,6 +462,7 @@ R. D. Tennent (rdt@cs.queensu.ca)
.SH SEE ALSO
.BR ImageMagick (1),
.BR convert (1).
+.BR dvipdfmx (1),
.BR dvips (1),
.BR evince (1),
.BR gpdf (1),
@@ -456,12 +470,13 @@ R. D. Tennent (rdt@cs.queensu.ca)
.BR latex (1),
.BR okular (1),
.BR optipng (1),
+.BR pdf2svg (1),
.BR pdflatex (1),
.BR prerex (1),
.BR prerex (5),
.BR ps2pdf (1),
.BR tikz (1),
-.BR tgf (1),
+.BR pgf (1),
.BR vprerex (1),
and
.BR xpdf (1).
diff --git a/Master/texmf-dist/doc/latex/prerex/prerex.sty.7.pdf b/Master/texmf-dist/doc/latex/prerex/prerex.sty.7.pdf
new file mode 100644
index 00000000000..1d58d2d4b63
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/prerex/prerex.sty.7.pdf
Binary files differ
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