diff options
author | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
commit | e0c6872cf40896c7be36b11dcc744620f10adf1d (patch) | |
tree | 60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/jslectureplanner/README |
Initial commit
Diffstat (limited to 'macros/latex/contrib/jslectureplanner/README')
-rw-r--r-- | macros/latex/contrib/jslectureplanner/README | 191 |
1 files changed, 191 insertions, 0 deletions
diff --git a/macros/latex/contrib/jslectureplanner/README b/macros/latex/contrib/jslectureplanner/README new file mode 100644 index 0000000000..88d33a14ce --- /dev/null +++ b/macros/latex/contrib/jslectureplanner/README @@ -0,0 +1,191 @@ +================================================================== +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.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 (\AdjSem and + \AdjSemVerb). + +* 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. + + |