GitBucket
4.21.2
Toggle navigation
Snippets
Sign in
Files
Branches
1
Releases
19
Issues
Pull requests
Labels
Priorities
Milestones
Wiki
Forks
nigel.stanger
/
ouexam
Browse code
• Corrected 2.4 release date.
master
OUEXAM_2_4_2
OUEXAM_2_4_1
OUEXAM_2_4
1 parent
3aed363
commit
38f8972ad06592a7002b62010b06a71bc84f2eb5
Nigel Stanger
authored
on 27 Aug 2016
Patch
Showing
2 changed files
HISTORY.md
README.md
Ignore Space
Show notes
View
HISTORY.md
Version History =============== Version 2.4 (2016-08-27) ------------------------ ### New features ### * Key-value options for the `examsection`, `question`, `subquestion`, and `subsubquestion` environments. These let you control things like whether marks and section titles are printed, and whether or not to compute and verify marks totals for sub-components of sections and questions. * A `\questionskip` length to let you adjust the spacing between top-level questions. * Optional questions—e.g., answer any three of five, where each question is worth 20 marks each, for a total of 60—freaked out the automatic total verification. The totalling can now be disabled for a section using the `don't verify total` option (see above). * Added new `embargo` class option for embargoed exam papers, which have somewhat different title page formatting requirements. ### Fixes ### * The various question environments must now be correctly nested (i.e., sub-sub-questions within sub-questions within questions). [Stephen Cranefield] * The `draft` class option now has the full functionality you would expect (change bars, etc.). * Disabled the `twocolumn` class option. * Obsoleted the `\newsection` macro, which has been deprecated for ten years! * `ouexam` was incompatible with the `hyperref` package. Fixed. [Mark George] * Float pages on the last page of the document messed up both the page count and the “TURN OVER”/“END” sequencing. Fixed. (Also removed the `lastpage` page style as part of this fix.) [Stephen Cranefield] * Fixed bug that caused a crash when there was a `verbatim` environment followed by a blank line at the end of a question. [Mark George] * Updated to latest 2016 calculator rules. Version 2.3.1 (2014-09-15) -------------------------- * Removed “Paper” from the title box to conform to University standards. Version 2.3 (2012-09-04) ------------------------ * Updated exam paper formatting to conform to latest University standards. * Added `times` class option. * Disabled `10pt` and `11pt` class options. * `ouexam` now requires the `fontenc`, `textcomp` and `lmodern` packages. * Generating the class documentation now requires PDFLaTeX. Version 2.2 (2010-04-26) ------------------------ * Added time allocation macros. Version 2.1.3 (2009-04-28) -------------------------- * Changed the defaults for `\material`, `\copiesof` and `\otherinstructions` to “N/A”. * Fixed vertical spacing of title page. Version 2.1.2 (2008-08-14) -------------------------- * The “subject to inspection” messages that appear in the calculators and permitted material sections of the title page now only appear when calculators are allowed or there actually is additional permitted material, respectively. Version 2.1.1 (2006-08-21) -------------------------- * “END” is now printed at the bottom of the last page of the exam. Version 2.1 (2004-04-16) ------------------------ * Updated the calculators macro to conform to the new University calculator regulations. `\allowcalculators` now has an optional argument to specify the kinds of calculators permitted. * `\permitcalculators` has been added as a synonym for `\allowcalculators`. * Removed the `\marks` macro because it conflicts with a macro in e-TeX. Version 2.0.2 (2002-08-22) -------------------------- * If you omitted any of the required title page macros (`\examyear`, `\papernumber`, `\papertitle` or `\department`), `ouexam` crashed when trying to report the error. Fixed. * Added the ability to specify “FY” (full-year) as a semester type in the `\semester` macro. Version 2.0.1 (2002-04-30) -------------------------- * There was a bug in the definition of the macros for numbering sub-sub-questions that meant they were numbered as “(a)” instead of the correct “(i)”. Fixed. * When referencing sub-questions or sub-sub-questions, the entire question number was included (that is, “1(b)(iii)” instead of just “(iii)”). This made it difficult to sensibly reference these items, so the relevant macros have been changed to omit this prefixed information. References to questions now print as “1”, sub-questions as “(b)” and sub-sub-questions as “(iii)”. If this does not suit your requirements, change the `\labelquestion`, `\labelsubquestion` or `\labelsubsubquestion` macros. Version 2.0 (2002-01-30) ------------------------ A complete rewrite from scratch. **This version is not backwards compatible with earlier versions!** However, the class will detect attempts to use obsolete features. * Added `draft` and `markingschedule` class options. * Added checking for the correct number of marks. * Added support for summer school exams. * Fixed headers so that the page number is always centered. * Removed `multichoice` class option and all associated macros and environments. * Disabled `twoside` class option, as exam papers are always printed single-sided. Version 1.2 (2000-04-14) ------------------------ * Added support for marking schedule information. Version 1.1 (1999-04-20) ------------------------ * Added `multichoice` class option. * Added automatic calculation of marks totals for questions. * Added tracking of the number of questions in an exam. * The `subquestions` and `subsubquestions` environment are now disabled when the `multichoice` class option is specified. * Changed default font size to 12pt. * Removed dependence on `calc` and `ifthen` packages. Version 1.0 (1999-04-15) ------------------------ Initial release.
Version History =============== Version 2.4 (2016-08-25) ------------------------ ### New features ### * Key-value options for the `examsection`, `question`, `subquestion`, and `subsubquestion` environments. These let you control things like whether marks and section titles are printed, and whether or not to compute and verify marks totals for sub-components of sections and questions. * A `\questionskip` length to let you adjust the spacing between top-level questions. * Optional questions—e.g., answer any three of five, where each question is worth 20 marks each, for a total of 60—freaked out the automatic total verification. The totalling can now be disabled for a section using the `don't verify total` option (see above). * Added new `embargo` class option for embargoed exam papers, which have somewhat different title page formatting requirements. ### Fixes ### * The various question environments must now be correctly nested (i.e., sub-sub-questions within sub-questions within questions). [Stephen Cranefield] * The `draft` class option now has the full functionality you would expect (change bars, etc.). * Disabled the `twocolumn` class option. * Obsoleted the `\newsection` macro, which has been deprecated for ten years! * `ouexam` was incompatible with the `hyperref` package. Fixed. [Mark George] * Float pages on the last page of the document messed up both the page count and the “TURN OVER”/“END” sequencing. Fixed. (Also removed the `lastpage` page style as part of this fix.) [Stephen Cranefield] * Fixed bug that caused a crash when there was a `verbatim` environment followed by a blank line at the end of a question. [Mark George] * Updated to latest 2016 calculator rules. Version 2.3.1 (2014-09-15) -------------------------- * Removed “Paper” from the title box to conform to University standards. Version 2.3 (2012-09-04) ------------------------ * Updated exam paper formatting to conform to latest University standards. * Added `times` class option. * Disabled `10pt` and `11pt` class options. * `ouexam` now requires the `fontenc`, `textcomp` and `lmodern` packages. * Generating the class documentation now requires PDFLaTeX. Version 2.2 (2010-04-26) ------------------------ * Added time allocation macros. Version 2.1.3 (2009-04-28) -------------------------- * Changed the defaults for `\material`, `\copiesof` and `\otherinstructions` to “N/A”. * Fixed vertical spacing of title page. Version 2.1.2 (2008-08-14) -------------------------- * The “subject to inspection” messages that appear in the calculators and permitted material sections of the title page now only appear when calculators are allowed or there actually is additional permitted material, respectively. Version 2.1.1 (2006-08-21) -------------------------- * “END” is now printed at the bottom of the last page of the exam. Version 2.1 (2004-04-16) ------------------------ * Updated the calculators macro to conform to the new University calculator regulations. `\allowcalculators` now has an optional argument to specify the kinds of calculators permitted. * `\permitcalculators` has been added as a synonym for `\allowcalculators`. * Removed the `\marks` macro because it conflicts with a macro in e-TeX. Version 2.0.2 (2002-08-22) -------------------------- * If you omitted any of the required title page macros (`\examyear`, `\papernumber`, `\papertitle` or `\department`), `ouexam` crashed when trying to report the error. Fixed. * Added the ability to specify “FY” (full-year) as a semester type in the `\semester` macro. Version 2.0.1 (2002-04-30) -------------------------- * There was a bug in the definition of the macros for numbering sub-sub-questions that meant they were numbered as “(a)” instead of the correct “(i)”. Fixed. * When referencing sub-questions or sub-sub-questions, the entire question number was included (that is, “1(b)(iii)” instead of just “(iii)”). This made it difficult to sensibly reference these items, so the relevant macros have been changed to omit this prefixed information. References to questions now print as “1”, sub-questions as “(b)” and sub-sub-questions as “(iii)”. If this does not suit your requirements, change the `\labelquestion`, `\labelsubquestion` or `\labelsubsubquestion` macros. Version 2.0 (2002-01-30) ------------------------ A complete rewrite from scratch. **This version is not backwards compatible with earlier versions!** However, the class will detect attempts to use obsolete features. * Added `draft` and `markingschedule` class options. * Added checking for the correct number of marks. * Added support for summer school exams. * Fixed headers so that the page number is always centered. * Removed `multichoice` class option and all associated macros and environments. * Disabled `twoside` class option, as exam papers are always printed single-sided. Version 1.2 (2000-04-14) ------------------------ * Added support for marking schedule information. Version 1.1 (1999-04-20) ------------------------ * Added `multichoice` class option. * Added automatic calculation of marks totals for questions. * Added tracking of the number of questions in an exam. * The `subquestions` and `subsubquestions` environment are now disabled when the `multichoice` class option is specified. * Changed default font size to 12pt. * Removed dependence on `calc` and `ifthen` packages. Version 1.0 (1999-04-15) ------------------------ Initial release.
Ignore Space
Show notes
View
README.md
ouexam v2.4 =========== ouexam document class v2.4, 27 August 2016 Copyright 1999–2016 Nigel Stanger and University of Otago This LaTeX2ε document class enables the production of University of Otago formatted examination papers. It handles all the fiddly layout requirements (such as printing “**TURN OVER**” at the bottom of every page except the last), and also ensures that the actual number of marks for questions in the examination add up to the expected number of marks. Requirements ------------ You will need the `verbatim`, `fontenc`, `textcomp`, `lmodern`, and `pgfkeys` packages in order to use `ouexam`. These should all come standard with most TeX installations. To build the documentation and example files, you will need `graphicx`, `hyperref`, at least version 1.1 of the `listings` package, and the `pdfjam` tool. Installing ---------- To install the easy way: 1 Unpack the distribution archive and `cd` to the distribution directory. 2 `make` 3 `make install TEXMFHOME=/path/to/texmf`. `/path/to/texmf` should be the root of your preferred texmf tree (e.g., `/usr/share/texmf`). You may need to do this as root depending on which texmf tree you are installing into. You can also define `TEXMFHOME` as an environment variable then simply type make install. To install manually, unpack the distribution archive, cd to the distribution directory, and do the following (now you know why there’s a Makefile ☺). % latex ouexam.ins % pdflatex example1.tex % pdflatex example1.tex % pdfjam --outfile eg1-1.pdf example1.pdf 1 % pdfjam --outfile eg1-2.pdf example1.pdf 2 % pdfjam --outfile eg1-3.pdf example1.pdf 3 % pdflatex example2.tex % pdflatex example2.tex % pdfjam --outfile eg2-1.pdf example2.pdf 1 % pdfjam --outfile eg2-2.pdf example2.pdf 2 % pdfjam --outfile eg2-3.pdf example2.pdf 3 % pdfjam --outfile eg2-4.pdf example2.pdf 4 % pdflatex ouexam.dtx % pdflatex ouexam.dtx % pdflatex ouexam.dtx Put `ouexam.cls` in `/path/to/texmf/tex/latex/ouexam`. Put `eg*.pdf`, `ouexam.pdf`, `ouexam.dtx`, `ouexam.ins`, `HISTORY`, `MANIFEST`, `README` and `TODO` in `/path/to/texmf/doc/latex/ouexam`. Put `Create*.pdf`, `example*.tex`, `example*.pdf` and `lstlang0.sty` in `/path/to/texmf/doc/latex/ouexam/example`. You can also build the examples using GUI tools such as TeXMaker, TeXShop, etc. (but see the FAQ below). FAQ --- **The number of marks for my questions are not appearing at the end of the line even though there is plenty of room for them to fit.** You probably have a blank line between the end of your question text and the `\end{question}` macro that actually generates the number of marks. The line break gets processed by TeX before the number of marks is generated and effectively generates a new paragraph. Until I figure out how to stop this from happening, the workaround is to not leave blank lines between the end of the question text and the `\end{question}`. **Why can’t I build content.tex?** `content.tex` is an include file for both `example1.tex` and `example2.tex`. It doesn’t have a `\documentclass` and you therefore *can’t* `pdflatex` it! The only input files you should be building are `example1.tex` and `example2.tex`.
ouexam v2.4 =========== ouexam document class v2.4, 25 August 2016 Copyright 1999–2016 Nigel Stanger and University of Otago This LaTeX2ε document class enables the production of University of Otago formatted examination papers. It handles all the fiddly layout requirements (such as printing “**TURN OVER**” at the bottom of every page except the last), and also ensures that the actual number of marks for questions in the examination add up to the expected number of marks. Requirements ------------ You will need the `verbatim`, `fontenc`, `textcomp`, `lmodern`, and `pgfkeys` packages in order to use `ouexam`. These should all come standard with most TeX installations. To build the documentation and example files, you will need `graphicx`, `hyperref`, at least version 1.1 of the `listings` package, and the `pdfjam` tool. Installing ---------- To install the easy way: 1 Unpack the distribution archive and `cd` to the distribution directory. 2 `make` 3 `make install TEXMFHOME=/path/to/texmf`. `/path/to/texmf` should be the root of your preferred texmf tree (e.g., `/usr/share/texmf`). You may need to do this as root depending on which texmf tree you are installing into. You can also define `TEXMFHOME` as an environment variable then simply type make install. To install manually, unpack the distribution archive, cd to the distribution directory, and do the following (now you know why there’s a Makefile ☺). % latex ouexam.ins % pdflatex example1.tex % pdflatex example1.tex % pdfjam --outfile eg1-1.pdf example1.pdf 1 % pdfjam --outfile eg1-2.pdf example1.pdf 2 % pdfjam --outfile eg1-3.pdf example1.pdf 3 % pdflatex example2.tex % pdflatex example2.tex % pdfjam --outfile eg2-1.pdf example2.pdf 1 % pdfjam --outfile eg2-2.pdf example2.pdf 2 % pdfjam --outfile eg2-3.pdf example2.pdf 3 % pdfjam --outfile eg2-4.pdf example2.pdf 4 % pdflatex ouexam.dtx % pdflatex ouexam.dtx % pdflatex ouexam.dtx Put `ouexam.cls` in `/path/to/texmf/tex/latex/ouexam`. Put `eg*.pdf`, `ouexam.pdf`, `ouexam.dtx`, `ouexam.ins`, `HISTORY`, `MANIFEST`, `README` and `TODO` in `/path/to/texmf/doc/latex/ouexam`. Put `Create*.pdf`, `example*.tex`, `example*.pdf` and `lstlang0.sty` in `/path/to/texmf/doc/latex/ouexam/example`. You can also build the examples using GUI tools such as TeXMaker, TeXShop, etc. (but see the FAQ below). FAQ --- **The number of marks for my questions are not appearing at the end of the line even though there is plenty of room for them to fit.** You probably have a blank line between the end of your question text and the `\end{question}` macro that actually generates the number of marks. The line break gets processed by TeX before the number of marks is generated and effectively generates a new paragraph. Until I figure out how to stop this from happening, the workaround is to not leave blank lines between the end of the question text and the `\end{question}`. **Why can’t I build content.tex?** `content.tex` is an include file for both `example1.tex` and `example2.tex`. It doesn’t have a `\documentclass` and you therefore *can’t* `pdflatex` it! The only input files you should be building are `example1.tex` and `example2.tex`.
Show line notes below
GitBucket
4.21.2
GitBucket
4.21.2