From 6855fd75c3f3f6a15bb3dc2ed6e90132806fbae4 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sat, 18 Sep 2010 22:37:51 +0000 Subject: prerex (18sep10) git-svn-id: svn://tug.org/texlive/trunk@19799 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/prerex/README | 2 +- Master/texmf-dist/doc/latex/prerex/doc/intro.pdf | Bin 237241 -> 334990 bytes Master/texmf-dist/doc/latex/prerex/doc/intro.tex | 188 ++++++++------------- .../texmf-dist/doc/latex/prerex/doc/introFonts.png | Bin 6827 -> 15287 bytes .../texmf-dist/doc/latex/prerex/doc/prerex.sty.7 | 4 +- Master/texmf-dist/tex/latex/prerex/prerex.sty | 8 +- 6 files changed, 84 insertions(+), 118 deletions(-) diff --git a/Master/texmf-dist/doc/latex/prerex/README b/Master/texmf-dist/doc/latex/prerex/README index d39ca3c54d9..ad37ceef7b8 100644 --- a/Master/texmf-dist/doc/latex/prerex/README +++ b/Master/texmf-dist/doc/latex/prerex/README @@ -1,4 +1,4 @@ -prerex, version 6.0: Macros for prerequisite charts, with associated +prerex, version 6.0.3: Macros for prerequisite charts, with associated editor and viewer applications. This package consists of diff --git a/Master/texmf-dist/doc/latex/prerex/doc/intro.pdf b/Master/texmf-dist/doc/latex/prerex/doc/intro.pdf index 7a64fc06d44..153f76104cb 100644 Binary files a/Master/texmf-dist/doc/latex/prerex/doc/intro.pdf and b/Master/texmf-dist/doc/latex/prerex/doc/intro.pdf differ diff --git a/Master/texmf-dist/doc/latex/prerex/doc/intro.tex b/Master/texmf-dist/doc/latex/prerex/doc/intro.tex index 418b4b0b6cc..6bb82be325b 100644 --- a/Master/texmf-dist/doc/latex/prerex/doc/intro.tex +++ b/Master/texmf-dist/doc/latex/prerex/doc/intro.tex @@ -8,9 +8,8 @@ \renewcommand{\bottomfraction}{1.00} \usepackage[osf]{mathpazo} -\usepackage[scaled=0.8]{helvet} % Helvetica scaled down 20% - -% \renewcommand{\sfdefault}{uop} % URW clone of Optima +% \usepackage[scaled=0.8]{helvet} % Helvetica scaled down 20% +\renewcommand{\sfdefault}{uop} % URW clone of Optima \renewcommand{\ttdefault}{cmtt} @@ -46,24 +45,26 @@ and manual pages to be incomprehensible. \section{Frequently Asked Questions} -\subsection*{What is a prerequisite chart?} +\subsection{Prerequisite Charts} + +\subsubsection*{What is a prerequisite chart?} A prerequisite chart gives an attractive graphical presentation of courses in a program (or set of related programs), organized by terms or years, linked by pre- and co-requisite arrows, and, when possible, supplemented by timetable information; Figure~\ref{chart} -%on page~\pageref{chart} +on page~\pageref{chart} is a small example. \input{introchart1} -\subsection*{Who would use a prerequisite chart?} +\subsubsection*{Who would use a prerequisite chart?} Prerequisite charts are useful to students selecting courses and planning their programs, and to faculty and staff advising students and managing curriculum development. -\subsection*{The information is in calendars and on-line; why is a prerequisite chart needed?} +\subsubsection*{The information is in calendars and on-line; why is a prerequisite chart needed?} Conventional sources of course, program and timetable information are rarely in a user-friendly format. Faculty and staff advisors, being already @@ -92,7 +93,7 @@ the necessary information in a compact and usable form, and the question can be answered immediately. -\subsection*{If prerequisite charts are so great, why doesn't every university department have them?} +\subsubsection*{If prerequisite charts are so great, why doesn't every university department have them?} Few academic departments have the resources to produce prerequisite charts. If one searches on the web for "prerequisite chart" or "prerequisite diagram," virtually all of the matches are from departments that one would @@ -101,8 +102,6 @@ Here are some of these: \begin{itemize} \item Queen's University, Electrical and Computer Engineering\footnote{% \myurl{http://www.ece.queensu.ca/undergraduate/coursesummaries/Queens_ECE_prerequisite_graph_2007.pdf}} -\item University of Minnesota, Computer Science\footnote{% -\myurl{http://www.cs.umn.edu/academics/courses/prereq.php}} \item University of Auckland Business School, Department of Information Systems\footnote{% \myurl{http://www.code.auckland.ac.nz/comwebcontent/isom/diagrams/ispre-req.html}} \item University of Waterloo, Computer Science\footnote{% @@ -110,7 +109,7 @@ Here are some of these: \item Georgia Tech, Electrical Engineering\footnote{% \myurl{http://www.ece.gatech.edu/academics/undergrad/ee_prereq.html}} \item Georgia State University, Computer Science\footnote{% -\myurl{http://www.cs.gsu.edu/degrees/undergrad/prereq.pdf}} +\myurl{http://www.cs.gsu.edu/sites/default/files/prereq.pdf}} \item Langara College, Computer Science and Information Systems\footnote{% \myurl{http://www.langara.bc.ca/science-technology/computing-science-systems/course-prerequisites.html}} \item Iowa State University, Civil, Construction, \& Environmental Engineering\footnote{% @@ -118,18 +117,19 @@ Here are some of these: \item Kansas State University, Mathematics\footnote{% \myurl{http://www.math.ksu.edu/main/course_info/courses/prereqcht.htm}} \item Carleton University, Engineering Physics\footnote{% -\myurl{http://www.eng.carleton.ca/academicsupport/prereq/EngineeringPhysics.pdf}} +\myurl{http://www2.carleton.ca/engineering-design/ccms/wp-content/ccms-files/Engineering-Physics_July14_09.pdf}} \item Mississippi State, Civil Engineering\footnote{% -\myurl{http://www.cee.msstate.edu/documents/flow\%20chart.pdf}} +\myurl{http://www.cee.msstate.edu/assets/documents/flow\%20chart.pdf}} \end{itemize} -\pagebreak -\subsection*{Where can I see prerex-formatted charts in use?} +\subsection{Prerex-Formatted Prerequisite Charts} + +\subsubsection*{Where can I see prerex-formatted charts in use?} There are several charts for both specialized and multi-disciplinary programs on-line here: \myurl{http://www.cs.queensu.ca/undergraduate/prereq.html}. -\subsection*{What file formats are used for prerex-formatted charts?} +\subsubsection*{What file formats are used for prerex-formatted charts?} The charts themselves are best distributed in the Portable Document Format (PDF) defined by Adobe; PDFs are readable on any platform and in @@ -148,7 +148,7 @@ The format of chart descriptions is documented in Section~\ref{source}. -\subsection*{What software is needed to produce prerex-formatted prerequisite charts?} +\subsubsection*{What software is needed to produce prerex-formatted prerequisite charts?} To process the description of a prerex-formatted chart, the following software is essential: @@ -181,7 +181,7 @@ see Section~\ref{editor}. \item an integrated \LaTeX\ development environment; see Section~\ref{IDE}. \end{itemize} -\subsection*{Why couldn't I use a program like Visio\textsuperscript{\textregistered}\ or CorelDRAW\textsuperscript{\textregistered}\ to produce a prerequisite chart?} +\subsubsection*{Why couldn't I use a program like Visio\textsuperscript{\textregistered}\ or CorelDRAW\textsuperscript{\textregistered}\ to produce a prerequisite chart?} You could, if you have such a program available, are very skilled in its use, and won't be embarrassed distributing a chart that looks amateurish. Look carefully at a prerex-formatted @@ -221,7 +221,7 @@ quality: \item Colours and hyperlinks to on-line course descriptions or calendars are possible. \end{itemize} -\subsection*{Wouldn't a commercial drafting service be able to produce a professional-looking prerequisite chart?} +\subsubsection*{Wouldn't a commercial drafting service be able to produce a professional-looking prerequisite chart?} Possibly, but you will almost certainly have to do the global lay-out yourself. A more serious long-term problem is that it is unlikely you will @@ -234,7 +234,7 @@ don't think you can produce it yourself, you can outsource the production; check out the following: \myurl{http://www.prerex.com}. -\subsection*{How can a prerex-formatted chart be edited?} +\subsubsection*{How can a prerex-formatted chart be edited?} University programs and timetables change frequently: courses are added or dropped, pre- or co-requisites or timetabling of courses change, and so on. @@ -249,9 +249,9 @@ the box centres, rather than those of the edges or corners of the boxes. Small changes can be made with any text editor. For creating a prerex-formatted chart or for -making substantial changes to an existing chart, the \texttt{prerex} interactive chart editor is available; +making substantial changes to an existing chart, the \texttt{prerex} interactive chart editor +and the graphical ``wrapper'' \texttt{vprerex} are available; see Section~\ref{editor}. - Editing a text file in either of these ways is far easier and faster than trying to fiddle with an image using a mouse. @@ -264,7 +264,7 @@ viewing or printing in any PDF viewer. The most popular of these is the Adobe Reader.\footnote{\myurl{http://www.adobe.com/prodindex/acrobat/readstep2.html}} However, the Adobe Reader is quite slow to load and somewhat inconvenient to use -if one wants to re-load the document after changing it (one must first close the document and +if one wants to re-load the document after changing it (normally one must first close the document and then re-open it). There are faster and more convenient alternatives to the Adobe Reader. One @@ -302,14 +302,9 @@ shows hyperlinks in a ``tooltip'' when the mouse hovers over it; this is a convenient way to get the coordinates of course boxes and arrows while editing the description. Recent versions of some of these viewing programs have the latter capability. +The \texttt{vprerex} ``wrapper' for the \texttt{prerex} editor includes +a built-in \texttt{prerex}-enabled PDF viewer. -\texttt{kpdf} (a.k.a.~\texttt{okular}) is an open-source PDF viewer for KDE\@. The prerex distribution -(from version 3.2) contains a ``patch'' file that can be used to modify -the source files for \texttt{kpdf}/\texttt{okular} so it can display URI tooltips and -capture box, connector, or background-point coordinates while the coordinate grid is -enabled. -See the README for instructions on obtaining the sources, patching them, -and building and installing a prerex-enabled version of \texttt{kpdf}/\texttt{okular}. \section{Installing a Basic \LaTeX\ System} \label{installing} @@ -334,10 +329,8 @@ MiKTeX.\footnote{% If you use Mac~OS~X, go to the \emph{\TeX\ on Mac OS~X} site.\footnote{% \myurl{http://www.rna.nl/tex.html}} -Unix and Linux users should install \texttt{tetex} packages, or -get the sources from -the \emph{teTeX Homepage}.\footnote{% -\myurl{http://www.tug.org/teTeX/}} +Unix and Linux users should install \texttt{texlive}.\footnote{% +\myurl{http://www.tug.org/texlive/}} The resulting installation will allow you to process simple \texttt{.tex} files. However, you won't be able @@ -359,10 +352,9 @@ Other add-ons that may be necessary are as follows: \texttt{multido}, \texttt{textcomp}, and \texttt{xcolor}. -If you are using \MikTeX, these can be installed using the -package manager, or, if you prefer, -will be installed automatically the first time a chart description is processed. -If you are not using \MikTeX, all of the packages are available +If you are using \MikTeX\ or \texttt{texlive}, these can be installed using the +package manager. +All of the packages are also available for download from any CTAN\footnote{% \myurl{http://www.ctan.org/}} repository. @@ -437,7 +429,6 @@ Kile\footnote{% and Klat.\footnote{% \myurl{http://research.edm.luc.ac.be/jori/klat/klat.html}} -\newpage \section{Fonts} \label{fonts} @@ -456,48 +447,40 @@ The others are \emph{sans serif} typefaces; this class of typefaces is more appropriate for use in prerequisite charts where \emph{legibility} of fairly small and short textual fragments is of primary importance. -To specify that the default text font in a \LaTeX\ document is to be \emph{sans serif}, -the following command is used in the preamble of the source file: +Computer Modern Sans is the default \emph{sans serif} font in \LaTeX, +and Helvetica and Avant~Garde should also be available in every \LaTeX\ installation. +To get Helvetica (scaled down 20\%) or Avant Garde, use \begin{verbatim} - \renewcommand{\rmdefault}{\sfdefault} + \usepackage[scaled=0.8]{helvet} \end{verbatim} +or +\begin{verbatim} + \renewcommand{\sfdefault}{pag} +\end{verbatim} +respectively. +If none of these is used, +(or the command is commented out by preceding +it with a \verb|%| character), Computer Modern Sans will be used. -Computer Modern Sans is the default \emph{sans serif} font in \LaTeX, -and Helvetica and Avant~Garde should also be available in every \LaTeX\ installation. -But we recommend that you consider Optima. -If you look -carefully at the samples above, you'll see that, unlike the boringly uniform strokes of -the Computer Modern, -Helvetica, Avant~Garde, Futura, and Gill Sans characters, the strokes of the Optima characters are -\emph{tapered} (i.e.,~shaped). This gives Optima text an elegance and liveliness -lacking in most other \emph{sans serif} typefaces. -Palatino (used in this document) and Optima were both designed by -Hermann Zapf, considered the foremost type designer of the modern era. - -So how does one install Optima (or any other non-standard typeface) -for use with \LaTeX? Authentic Optima fonts in Windows Postscript (Adobe Type~1) -format are available -commercially from font vendors such as \texttt{myfonts.com}. -The necessary \LaTeX\ support files and instructions for installation -into a standard \LaTeX\ implementation may be found +Futura, Gill Sans, Frutiger and Optima are commercial fonts available from +font vendors such as \texttt{myfonts.com}. +The \LaTeX\ support files and instructions for installation +into a standard \LaTeX\ implementation for many commercial fonts can be found at CTAN\footnote{% \myurl{http://www.ctan.org/tex-archive/fonts/psfonts/w-a-schmidt/}}; -the file \texttt{pop.zip} is the package of support files and \texttt{pop.txt} -gives the installation instructions. - -But there are less expensive alternatives. -The name ``Optima'' is trademarked by Linotype, but -other font foundries have -produced good-quality clones with other names. -For example, the family of Zapf-Humanist~601 fonts from \mbox{Bitstream} -are available from commercial distributors such as \texttt{myfonts.com}. They are actually more expensive than authentic Optima; however, some of these fonts have been bundled with +otherwise you will have to follow the instructions +in the Font Installation Guide\footnote{% +\myurl{http://www.ctan.org/tex-archive/info/Type1fonts/fontinstallationguide/}} + +Less expensive alternatives may be available to you. +The Humanist~521 and Zapf-Humanist~601 families of fonts are Bitstream clones +of Gill Sans and Optima, respectively. +These fonts are available from commercial vendors but have been bundled with Corel applications such as \mbox{WordPerfect}, and so you may -already have them. The support files for \LaTeX\ (\texttt{bop.zip}) and instructions (\texttt{bop.txt}) are also available -at the site referenced above. +already have them. Windows\textsuperscript{\textregistered}\ systems come +with several fonts, some of which might be suitable for use in prerequisite charts. -Another usable clone of Optima is the URW~Classico family of fonts. Although -they are only slightly less expensive than authentic Optima at commercial vendors, -four Classico fonts are available in a package +Four URW-Classico fonts, a fairly good clone of Optima, are available in a package of 79~fonts in Type~1 format that may be legally downloaded for non-commercial use from Artifex\footnote{% @@ -508,27 +491,6 @@ from CTAN\footnote{% Note that the font files cannot be distributed commercially without a commercial license; please read the license in the archive before re-distributing them. -When any of these Optima or Optima-like fonts and corresponding -support files have been installed, -it will be possible to request their use in your charts by -using \texttt{pop}, \texttt{bop}, or \texttt{uop} in a -\begin{verbatim} - \renewcommand{\sfdefault}{...} -\end{verbatim} -command in the preamble of the source file. -To get Helvetica (scaled down 20\%) or Avant Garde, use -\begin{verbatim} - \usepackage[scaled=0.8]{helvet} -\end{verbatim} -or -\begin{verbatim} - \renewcommand{\sfdefault}{pag} -\end{verbatim} -respectively. -If none of these is used, -(or the command is commented out by preceding -it with a \verb|%| character), Computer Modern Sans will be used. - \section{Conversion to Portable Network Graphic (PNG) Format} Although PDF is currently the best available format for distributing @@ -643,23 +605,23 @@ editor maintains a ``stack'' of elements that have been cut but not yet pasted. \multicolumn{1}{|c|}{\textbf{Command}} & \multicolumn{1}{|c|}{\textbf{Effect}} \\ \hline\hline -\verb\file.tex> box x,y \ & [create and] edit course box at $x,y$\\ -\verb\file.tex> mini x,y \ & [create and] edit mini course at $x,y$\\ -\verb\file.tex> text x,y \ & [create and] edit text centered at $x,y$\\ -\verb\file.tex> arrow x0,y0,x1,y1\ & [create and] edit arrow from $x0,y0$ to $x1,y1$\\ -\verb\file.tex> cut x,y \ & (temporarily) remove box, mini, or text at $x,y$\\ -\verb\file.tex> paste x,y \ & re-insert removed box, mini, or text at $x,y$\\ -\verb\file.tex> delete [x,y | x0,y0,x1,y1] ...\ & remove specified elements/arrows\\ -\verb\file.tex> undelete \ & undelete deleted box, mini, text, or arrow\\ -\verb\file.tex> write | ! \ & save to \verb\file.tex\ and process (with \verb\pdflatex)\\\ -\verb\file.tex> quit | exit | x | ^D\& turn off grid, save to \verb\file.tex\, process, and exit\\ -\verb\file.tex> shift [-]x [xi,yi ...]\ & move [specified] elements $x$ units right [left]\\ -\verb\file.tex> raise [-]y [xi,yi ...]\ & move [specified] elements $y$ units up [down]\\ -\verb\file.tex> !cmd \ & execute shell command \verb\cmd\, then reload\\ -\verb\file.tex> Backup \ & copy \verb\file.tex\ to \verb\.file.tex\\\ -\verb\file.tex> Restore \ & restore from \verb\.file.tex\\\ -\verb\file.tex> grid [y/n] \ & turn on/off coordinate grid background\\ -\verb\file.tex> help | ? \ & print this summary\\ +\verb\file> box x,y \ & [create and] edit course box at $x,y$\\ +\verb\file> mini x,y \ & [create and] edit mini course at $x,y$\\ +\verb\file> text x,y \ & [create and] edit text centered at $x,y$\\ +\verb\file> arrow x0,y0,x1,y1\ & [create and] edit arrow from $x0,y0$ to $x1,y1$\\ +\verb\file> cut x,y \ & (temporarily) remove box, mini, or text at $x,y$\\ +\verb\file> paste x,y \ & re-insert removed box, mini, or text at $x,y$\\ +\verb\file> delete [x,y | x0,y0,x1,y1] ...\ & remove specified elements/arrows\\ +\verb\file> undelete \ & undelete deleted box, mini, text, or arrow\\ +\verb\file> write | ! \ & save to \verb\file\ and process (with \verb\pdflatex)\\\ +\verb\file> quit | exit | x | ^D\& turn off grid, save to \verb\file\, process, and exit\\ +\verb\file> shift [-]x [xi,yi ...]\ & move [specified] elements $x$ units right [left]\\ +\verb\file> raise [-]y [xi,yi ...]\ & move [specified] elements $y$ units up [down]\\ +\verb\file> !cmd \ & execute shell command \verb\cmd\, then reload\\ +\verb\file> Backup \ & copy \verb\file\ to \verb\.file\\\ +\verb\file> Restore \ & restore from \verb\.file\\\ +\verb\file> grid [y/n] \ & turn on/off coordinate grid background\\ +\verb\file> help | ? \ & print this summary\\ \hline \end{tabular} \end{center} @@ -740,7 +702,7 @@ used in the chart. Table~\ref{instructions} -on page~\pageref{instructions} +%on page~\pageref{instructions} summarizes the formats of the instructions defined by \texttt{prerex.sty}. \begin{table} diff --git a/Master/texmf-dist/doc/latex/prerex/doc/introFonts.png b/Master/texmf-dist/doc/latex/prerex/doc/introFonts.png index 5b4e212f4a5..13d49ce3c4f 100644 Binary files a/Master/texmf-dist/doc/latex/prerex/doc/introFonts.png and b/Master/texmf-dist/doc/latex/prerex/doc/introFonts.png differ diff --git a/Master/texmf-dist/doc/latex/prerex/doc/prerex.sty.7 b/Master/texmf-dist/doc/latex/prerex/doc/prerex.sty.7 index 87ef4f540fa..db6fff2cef9 100644 --- a/Master/texmf-dist/doc/latex/prerex/doc/prerex.sty.7 +++ b/Master/texmf-dist/doc/latex/prerex/doc/prerex.sty.7 @@ -1,4 +1,4 @@ -.TH PREREX.STY 7 2010-06-25 "prerex.sty-6.0" "" +.TH PREREX.STY 7 2010-09-17 "prerex.sty-6.0" "" .SH NAME prerex.sty \- a LaTeX document style for prerequisite charts .SH DESCRIPTION @@ -394,7 +394,7 @@ When the coordinate grid is drawn, the .B CourseURL command is re-defined to pass node coordinates in URIs. Also, -two ``anchor'' hyperlinks are inserted at the southwest and northeast corners +two "anchor" hyperlinks are inserted at the southwest and northeast corners of the diagram to allow prerex-enabled PDF viewers to compute chart coordinates. .P diff --git a/Master/texmf-dist/tex/latex/prerex/prerex.sty b/Master/texmf-dist/tex/latex/prerex/prerex.sty index f868d548766..73fd8a37914 100644 --- a/Master/texmf-dist/tex/latex/prerex/prerex.sty +++ b/Master/texmf-dist/tex/latex/prerex/prerex.sty @@ -61,10 +61,14 @@ % The nominal diagram width is 10 + (\textwidth divided by \unit). % \NeedsTeXFormat{LaTeX2e}[1995/12/01] -\ProvidesPackage{prerex}[2010/06/25 v6.0 LaTeX style for prerequisite charts, pgf version] +\ProvidesPackage{prerex}[2010/09/17 v6.0.3 LaTeX style for prerequisite charts, pgf version] % Changelog: % +% Version 6.0.3 +% +% Added required ALT tag to AREA outputs. +% % Version 6.0 % Version 5.7 % @@ -249,7 +253,7 @@ \addtocounter{ySE}{0 - \dpi * \ratio{\zposy{gridOrigin_\thechart}sp}{1in}} \addtocounter{ySE}{0 - (#2 + #5) * \PixelsPerUnit } % subtract # of pixels from origin to node (+#5) -\immediate\write\@imapfile{}% +\immediate\write\@imapfile{#3}% } \def\@halfcourse#1,#2:#3#4#5{% -- cgit v1.2.3