summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/prerex/README
blob: ed3ae30ab80067b5a42779bb7ecfbe9ab56f2de0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
prerex, version 6.4.0: Macros for prerequisite charts, with associated
editor and viewer applications. 

This package consists of 

  prerex.sty 
    a LaTeX package for producing charts of course nodes
    linked by arrows representing pre- and co-requisites,

  prerex 
    an interactive program for creating and editing chart
    descriptions, and

  vprerex ("visual prerex") a GUI and previewer for prerex.

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 toolkit and the poppler
library.

See chart.{pdf,html} for a small example of a prerequisite chart and
real-life examples at

http://www.cs.queensu.ca/students/undergraduate/prerequisites/

Prerequisite charts are useful to students selecting courses and
planning their programs, and to faculty and staff advising students
and managing curriculum development. Conventional sources of course,
program and timetable information are rarely in a user-friendly format.
Faculty and staff advisors, being already fairly familiar with their
courses and programs, often do not appreciate how inconvenient it is
for students to access all the information they need to make course
choices. 

The crucial tool in the prerex suite is "prerex.sty", a macro package
that defines a "chart" environment and commands to specify construction
of course boxes and directed arrows between them.

prerex.sty depends on

  pgf (and add-on tikz), version 1.18 or higher 
  multido
  relsize
  calc
  ifthen
  zref-savepos
  hyperref

The use of pgf means that Postscript processing is not required;
either pdflatex or latex -> dvips [ -> ps2pdf ] may be used.

Installation of prerex.sty:

  + copy prerex.sty to your-texmf-tree/tex/latex/misc
  + copy doc/prerex.{tex,pdf} to your-texmf-tree/doc/latex/misc
  + if necessary, refresh the TeX database (e.g., texhash)
  + copy doc/prerex.sty.7 to sub-directory man7 of a man directory on your 
    MANPATH
  + test by doing 

       man 7 prerex.sty
       pdflatex chart.tex

See doc/prerex.pdf for detailed documentation.

The prerex editor allows interactive editing of the chart environments
of LaTeX source files. It supports add, remove, cut-and-paste, and edit
operations on course boxes and arrows, and vertical or horizontal shifts
of the whole diagram or selected sets of course boxes. When a course
box is moved, the arrows into and out of it automatically follow. 
To install:

  tar zxvf prerex-6.4.0.tar.gz
  cd prerex-6.4.0
  ./configure --help
  ./configure [options]
  make
  sudo make install

The effects of editing operations may be observed in any PDF viewer.
The vprerex (visual prerex) application included in the prerex suite
is a GUI and viewer for the prerex editor. It may be used just as a
minimalistic viewer of arbitrary PDF files but supports editing of
charts generated using prerex.sty by allowing coordinates of course
boxes, arrows, and background points to be conveyed back to the prerex
editor command-line using the clipboard. See the INSTALL in the tarball
for installation instructions.

See the file doc/intro.pdf for an overview of the prerex system.

prerex.sty, README.prerex, prerex.1, prerex.5, prerex.sty.7, prerex.tex
and chart.tex may be modified and distributed according to the terms of
the LaTeX Project Public License.

The source files for prerex and vprerex may be modified and distributed
according to the terms of the GNU General Public Licence (version 2).

The source files for libedit (embedded in the prerex tarball) may be
modified and distributed according to the terms of the BSD licence.