summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/jslectureplanner/README
blob: e5dae559d2be38160d2216772c24e688c8136b6f (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
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
==================================================================
The jslectureplanner bundle

A set of LaTeX packages to help managing university courses.

Maintained by Jürgen Spitzmüller
E-mail: juergen (at) spitzmueller (dot) org
Code repository and issue tracker:
    https://github.com/jspitz/jslectureplanner

Released under the LaTeX Project Public License v1.3 or later
See http://www.latex-project.org/lppl.txt
==================================================================

== PURPOSE ==

The jslectureplanner bundle facilitates the generation and managment
of university course material. It provides an interface to set up and
access centralized course data that can be reused in all course documents.
Furthermore, it is able to calculate the session dates of a whole semester
and generate course programs, if the sessions follow at regular intervals
and the date of the first session is specified. Moreover, it can be used
to generate a sectioned course bibliography via biblatex.
Next to the main, title-giving package, the bundle includes a package
that helps generating course member and presence lists.


== CONTENTS ==

The package consists of the following files:

* jslectureplanner.sty (the main LaTeX package)
* jsmembertable.sty (LaTeX package to generate course member and presence lists)
* german-default.lps (German 'model' style file with default settings)
* cologne.lps (German style file attempted at the University of Cologne)
* jslectureplanner.pdf (documentation)
* jslectureplanner.tex (documentation source)
* README (this very file)

The following example files are included:

* metadata.tex: example metadata file
* lectureprogram.tex: example course program
* lectureprogram.pdf
* lecturescript.tex: example course script
* lecturescript.pdf
* lecturepresentation.tex: example course presentation
* lecturepresentation.pdf
* lecturehandout.tex: example course handout
* lecturehandout.pdf
* lecpresbody.tex: common body of presentation/handout
* lecturebib.tex: example course bibliography
* lecturebib.pdf
* lectureplanner-examples.bib: example bibliography data
* membertable.tex: example member table
* membertable.pdf
* presencetable.tex: example presence table
* presencetable.pdf
* preslist.tex: example student presentation list
* preslist.pdf


== DOCUMENTATION ==

See the included manual jslectureplanner.pdf for usage
instructions; also have a look at the example files.


== CHANGES ==

* V. 1.12 (2020-12-08):  - Correctly parse staryear/endyear.

* V. 1.11 (2020-05-11):  - Allow for customization of program and presentation lists.
                         - Correctly set first session in presentation list. 

* V. 1.10 (2020-04-30):  - Do not increment session topic counter for cancelled sessions
                           and breaks.
                         - Add session option topicnumber to reset topic number in draft mode.
                         - Recode manual in utf8.

* V. 1.9 (2020-02-04):   - Allow \SetBeamerFrameBreak within SessionBlock.
                         - Fix \SetAutoOffset at first session and add optional argument
		            to alter first session (fix contributed by Richard Zach).

* V. 1.8 (2019-02-06):   - Add extradate option to \NewSession to support fix dates.
                         - Add possibility to enter exam dates that are not added to
                           the standard program (option exam of \NewSession).
		           Also add macros to display them separately (\makeexamprogram,
		           \makebeamerexamprogram) and to access their session number
                           (\examsesno).
                         - Switch input format of \LecStartDate to ISO (YYYY-MM-DD).
                           The old format (DD/MM/YYYY) is still supported for backwards
                           compatibility.
                         - Add macros to receive session block numbers (\sesblocknumber,
                           \SessionBlockNumber{<session no>} and \AdjSessionBlockNumber).
                         - Add unstyled date formats which allow preceding \DTMsetdatestyle
                           (the short and long date formats would override such settings).
                         - Add support for lecture and session start time, duration and thus
                           also end time calculation.
                         - Add support for displaying the next semester (\adjsemester and
                           \adjsemesterverb).

* V. 1.7 (2018-12-14):   - Allow options in \makebeamerprogram also with blocksonly.
                         - Add overlayarg option to \makebeamerprogram.
                         - Add macros to receive session block titles (\sesblocktitle,
                           \SessionBlockTitle{<session no>} and \AdjSessionBlockTitle).

* V. 1.6 (2018-09-26):   - Do not output session title-subtitle separator if there is no
                           subtitle.

                         - Add "blocksonly" and "uncover" options to \makebeamerprogram.

                         - Add "draft" option to \NewSession.

* V 1.5 (2017-03-12):    - Add "english" style file (proof of concept).

                         - Add datakeys option to the jsmembertable package.

                         - Add package option "sestitlesep" and macro \SessionTitleSep that
                           allow for the definition of a global session title-subtitle
                           separator.

* V. 1.4 (2016-10-19):   - Add instructor short forms for lecture and session.

                         - Add starred version of \sesinstructor that only produces output
                           if the session instructor differs from the general course instructor.

                         - All short{instructor|title} macros now output the long version if no
                           short form was defined.

                         - Add boolean tests for unique short forms and session instructors.

* V. 1.3 (2016-08-31):   - BACKWARDS-INCOMPATIBLE CHANGE! Use datetime2 instead of datetime
                           and advdate. This changes the interface to set the lecture date
                           format. Please refer to the documentation for details.

                         - Fix output of \SetBreaks when no span argument is given.

                         - Protect content of some \Lec* macros and options to allow for
                           commas in titles etc.

                         - Small microtypographic improvement in default definition of
                           the lecture date format.

* V. 1.2 (2016-05-11):   - Fix line breaking with empty session titles before course
                           breaks.

                         - New commands \AdjSessionFullTitle, \AdjSessionDate,
                           \AdjSessionShortTitle, \AdjSessionTitle, \AdjSessionShortDate,
                           \AdjSessionRoom, \AdjSessionInstructor, \AdjSessionPresStudents

* V. 1.1 (2015-07-15):   - Include and document the companion package jsmembertable.
                         - Add support for student presentation lists (new macros
                           \makepreslist, \makepreslist*, \makebeamerpreslist,
                           \jsetfirstpressession and \jsetlastpressession).
                         - Major revision of the manual.

* V. 1.0.2 (2015-07-07): - Permit \LecType and \LecYear in the document body again
                           (fix a regression introduced in v. 1.0).

* V. 1.0.1 (2015-02-27): - Properly expand \leccancel
                           (fix a regression introduced by v. 1.0).

* V. 1.0 (2015-02-27):   - Lecture types and term types are not hardcoded anymore and can
                           be freely modified and extended via \DefLecType and \DefSemType.
                         - Add option to add the instructor's name to both the course
                           (via \LecInstructor or 'instructor' package option) and to
                           specific sessions (via 'instructor' option of \NewSession).
                         - Add option to add names of presenting students to a session
                           (via 'presstudents' option).
                         - Add option to record the office number (\SetOfficeNumber
                           or 'officenumber' package option) [github issue #3].
                         - Add option to automatically shift all subsequent sessions by
                           a certain value after every nth session (\SetAutoOffset).
                           [github issue #2]
                         - Fix expansion issue in 'options' option of
                           \makebeamerprogram.
                         - Add 'cologne' style file.

* V. 0.9 (2015-02-08):   - Add a way to adjust the interval between two sessions
                           ('interval' package option and \LecInterval macro).
                         - Add a way to shift session dates from the regular
                           interval (\SetLecOffset).
                         - Rename option 'weeks' of the \SetBreaks macro to 'units'
                           ('weeks' still works, but is marked deprecated).

* V. 0.8 (2015-01-17):   - Fix corruption of \today.
                         - Add framework for different styles.
                         - Add option and macro to set a room
                           for the course as well as a
                           session-specific room.
                         - Remove redundant lecture type "vo"
                           from the documentation.
                         - Change \leccancel default definition
                           in favour of better translatability.

* V. 0.7 (2015-01-04):   - Add macro for resetting \today.
                         - Minor corrections of the manual.

* V. 0.6b (2014-12-12):  - Minor corrections of the manual and
                           example files.

* V. 0.6 (2014-12-12):   - Initial release to CTAN.