GitBucket
4.21.2
Toggle navigation
Snippets
Sign in
Files
Branches
1
Releases
Issues
Pull requests
Labels
Priorities
Milestones
Wiki
Forks
nigel.stanger
/
LaTeX
Browse code
Merge commit '
d49c363
'
master
commit
2e0d911484b4623bddfee2b733e0809de4d8a8e1
2 parents
05512e5
+
d49c363
Nigel Stanger
authored
on 6 Dec
Patch
Showing
2 changed files
lectures/coursehandbook.cls
lectures/otagofonts.sty
Ignore Space
Show notes
View
lectures/coursehandbook.cls
\def\coursehandbookdate{6 December 2024} \def\coursehandbookversion{1.0.3} \def\coursehandbookshortdate{2024/12/06} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Document class for course handbooks. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Version History % v1.0 Initial version. % v1.0.1 Added siunitx to required packages. % v1.0.2 Modified header generation to translate short teaching period strings % into long equivalents (e.g., "S1" => "Semester One"). % v1.0.3 Replaced deprecated ifpdf and ifxetex with iftex. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \NeedsTeXFormat{LaTeX2e}[2001/06/01] \ProvidesClass{coursehandbook}% [\coursehandbookshortdate\space v\coursehandbookversion\space INFO course handbook style] \RequirePackage{iftex} \RequirePackage{kvoptions} % Key-value option handling. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Option processing. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \SetupKeyvalOptions{family=handbook, prefix=handbook@} \DeclareBoolOption{showanswers} \DeclareComplementaryOption{hideanswers}{showanswers} \DeclareStringOption[INFO]{subjectcode} \DeclareStringOption[!!PAPER NUMBER UNDEFINED!!]{papernumber} \DeclareStringOption[!!PAPER TITLE UNDEFINED!!]{papertitle} \DeclareStringOption[!!PAPER YEAR UNDEFINED!!]{paperyear} \DeclareStringOption[!!PAPER PERIOD UNDEFINED!!]{paperperiod} \DeclareStringOption[!!AUTHORS UNDEFINED!!]{authors} % \DeclareBoolOption{pdftex} % \DeclareBoolOption{xetex} % % \ifxetex % \DeclareVoidOption{xetex} % \OptionNotUsed{pdftex} % \else\ifpdf % \DeclareBoolOption{pdftex} % \OptionNotUsed{xetex} % \else % \ClassError{coursehandbook}{The coursehandbook document class only\MessageBreak\ supports PDF(La)TeX and XeTeX.}{The coursehandbook document class only supoprts the pdftex and\MessageBreak\ xetex drivers. Please use one of these.} % \fi \DeclareDefaultOption{% \ifx\CurrentOptionValue\relax% \expandafter\PassOptionsToClass% \expandafter{\CurrentOption}{book}% \else% \@unknownoptionerror% \fi% } \ProcessKeyvalOptions* \LoadClass{book} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % A bunch o' packages. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \ifxetex \RequirePackage{fontspec} % Font handling for XeTeX. \RequirePackage{xunicode} \RequirePackage{xltxtra} \else % Note that fontenc freaks out if any of the keyval option values % are surrounded by braces (?!). Spaces get eaten without braces, % so instead use \ in \documentclass to preserve them. \RequirePackage[T1]{fontenc} \RequirePackage{textcomp} \fi \RequirePackage{mathpazo} % Palatino for text and maths. \RequirePackage{graphicx} % Include graphics of all sorts. \RequirePackage{color} % Color handling. \RequirePackage[hmargin=68.393315pt,% Sensible margins, essentially the same as a4wide. top=107.1438pt,% bottom=116.90304pt]{geometry} % \RequirePackage{makeidx} \RequirePackage{amssymb} % AMS maths symbols. \RequirePackage{latexsym} % Extra LaTeX maths symbols. \RequirePackage{relalg} % Relational algebra symbols. % \RequirePackage{longtable} % For multi-page tables. \RequirePackage{multirow} % Multi-row cells in tables. \RequirePackage{rotating} % Rotate stuff. \RequirePackage{fancyhdr} % Fancy page headers & footers. \RequirePackage{verbatim} % Enhanced verbatim handling. \RequirePackage{listings} % Nicely formatted code listings. \RequirePackage[normalem]{ulem} % Fancy underlining, strike-through, etc. \usepackage[detect-all,binary-units]{siunitx} % SI unit and number formatting. % \RequirePackage{moreverb} % \RequirePackage{listings} % Pretty-print code listings; not currently used. \RequirePackage{count1to} % Needed to get the absolute page numbers. \RequirePackage{calc} % Needed to calculate page numbers for 2-up version. \RequirePackage{parskip} % Space-separated rather than indented paragraphs. \RequirePackage[% plainpages=false, % Stops pdfTeX complaining about duplicate page numbers. colorlinks=true,% urlcolor=blue, % Acceptable for print or screen linkcolor=blue, % Acceptable for print or screen bookmarks=true,% bookmarksopen=true,% bookmarksnumbered=true,% pdfpagemode=UseOutlines,% pdfstartview=FitB,% ]{hyperref} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Various setup macros to enable on-the-fly option changing. % These are particularly necessary for paper detail options (such as % papertitle) that may contain spaces. From the kvoptions documentation: % % ================================================== % * Spaces are removed, regardless where: % \documentclass[box=0 0 400 600]{article} % Now each package will see box=00400600 as global option. % % * In the previous case also braces would not help: % \documentclass[box={0 0 400 600}]{article} % The result is an error message: % ! LaTeX Error: Missing \begin{document}. % % * The requirements on robustness are extremly high. LATEX expands the % option. All that will not work as environment name will break also % as option. Even a \relax will generate an error message: % ! Missing \endcsname inserted. % Of course, LATEX does not use its protecting mechanisms. On contrary % \protect itself will cause errors. % ================================================== % % The upshot is that in the \documentclass, spaces are eaten, but we can't use % {} or macros like \space or "\ " to escape them. The only thing that does % work is: % % papertitle=some\csname space\endcsname name % % which is particularly ugly. A better solution is to follow the hyperref % model and have a "setup" macro that sets these options AFTER the % \documentclass. % % These also call \hypersetup to ensure that the PDF metadata match. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % Set arbitrary class options. \newcommand{\handbooksetup}[1]{% \setkeys{handbook}{#1}% \@updatepdfmetadata% } % \papersetup is intended to be for setting paper detail options, but is % essentially just a synonym of \handbooksetup. \let\papersetup\handbooksetup % Macros for setting specific paper detail options. \newcommand{\setsubjectcode}[1]{% \@setpaperoption{subjectcode}{#1}% } \newcommand{\setpapernumber}[1]{% \@setpaperoption{papernumber}{#1}% } \newcommand{\setpapertitle}[1]{% \@setpaperoption{papertitle}{#1}% } \newcommand{\setpaperyear}[1]{% \expandafter\@setpaperoption{paperyear}{#1}% } \newcommand{\setpaperperiod}[1]{% \@setpaperoption{paperperiod}{#1}% } \newcommand{\setauthors}[1]{% \@setpaperoption{authors}{#1}% } \newcommand{\@setpaperoption}[2]{% \setkeys{handbook}{#1={#2}} \@updatepdfmetadata% } \def\@updatepdfmetadata{% \hypersetup{% pdftitle={\expandafter\handbook@subjectcode\ \expandafter\handbook@papernumber\ Handbook, \expandafter\handbook@paperyear},% pdfauthor={\expandafter\handbook@authors},% pdfsubject={Student Handbook for \expandafter\handbook@subjectcode\ \expandafter\handbook@papernumber, \expandafter\handbook@paperyear.}% }% } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Set up fonts. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \ifxetex \defaultfontfeatures{Mapping=tex-text} \setmainfont{TeX Gyre Pagella} \setmonofont[Scale=MatchLowercase]{Letter Gothic 12 Pitch} % Not sure about these? \setsansfont[Scale=MatchLowercase]{Futura Book} \newfontfamily\headerfont[Size=11]{Futura Light} \else \renewcommand{\sfdefault}{bfu} \renewcommand{\ttdefault}{blg} \DeclareFixedFont{\headerfont}{T1}{bfu}{lc}{n}{11} \fi %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Set up listings. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % Pre-load the most obviously used languages. You can still use other languages, % just not as quickly. \lstloadlanguages{Oracle,Java} % Set defaults. \lstset{basicstyle=\ttfamily,basewidth=0.5em,escapeinside={(@}{@)}, showspaces=false,showstringspaces=false} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Miscellaneous stuff. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % Useful macros for paper code, etc. \def\PaperCode{\expandafter\handbook@subjectcode\ \expandafter\handbook@papernumber} \def\ShortPaperCode{\expandafter\handbook@subjectcode\expandafter\handbook@papernumber} \def\PaperTitle{\expandafter\handbook@papertitle} \def\PaperYear{\expandafter\handbook@paperyear} \def\PaperPeriod{\expandafter\handbook@paperperiod} \def\HandbookAuthors{\expandafter\handbook@authors} % Stolen from ouexam :). \def\@SONE{S1} \def\@STWO{S2} \def\@SS{SS} \def\@FY{FY} \newcommand{\PaperLongPeriod}{% \ifx\handbook@paperperiod\@SONE Semester One% \else\ifx\handbook@paperperiod\@STWO Semester Two% \else\ifx\handbook@paperperiod\@SS Summer School% \else\ifx\handbook@paperperiod\@FY Full Year% \else\PaperPeriod% \fi\fi\fi\fi% } % Handbook name. \newcommand{\handbookname}{Student Handbook} % "Chapter" names. Note that the lab and tutorial names are dependent on % the setting of the showanswers class option. \newcommand{\introchaptername}{Introductory Chapter} \newcommand{\labname}{\ifhandbook@showanswers Selected Answers for \fi\PaperCode\ Lab} \newcommand{\tutorialname}{\ifhandbook@showanswers Selected Answers for \fi\PaperCode\ Tutorial} % listings.sty has problems with in-line verbatim code and fancy styles % (backgrounds, borders), hence this: \newcommand{\code}[1]{\texttt{#1}} % Other useful macros. \newcommand{\term}[1]{\textit{#1}} \newcommand{\foreign}[1]{\textit{#1}} \newcommand{\BookTitle}[1]{\textit{#1}} % Backslashes - what a pain! \newcommand{\bs}{\(\backslash{}\)} % We want "chapter" numbers to reset for each part. \@addtoreset{chapter}{part} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Set up fancy headings. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % Although we don't actually use the "fancy" page style, we have to set it % initially in order for the page marks to be set up correctly. \pagestyle{fancy} \fancyhf{} % Page marks. \partmark is completely new, the others are standard. \newcommand{\partmark}[1]{\markboth{\partname\ \thepart---#1}{}} \renewcommand{\chaptermark}[1]{\markright{\@chapapp\ \thechapter---#1}} \renewcommand{\sectionmark}[1]{} \setlength{\headheight}{15pt} % No running head or foot rules. \renewcommand{\headrulewidth}{0pt} \renewcommand{\footrulewidth}{0pt} % Use | to separate items in the header/footer. \newcommand{\LeftHeadingBullet}{\(\vert\)} \newcommand{\RightHeadingBullet}{\(\vert\)} \newlength{\HeadingBulletSpacing} \setlength{\HeadingBulletSpacing}{0.5em} % The headers and footers are set up as follows, where "TOC" = table of % contents, "1st" = first page of part or chapter, "part" = title page of % a part, "plain" = plain page style, "empty" = empty page style, % "#" = page number, "LO" = left odd, "RE" = right even, etc. If something % isn't mentioned, it's empty. % % Note that we're optimising for 2-up printing, so the placement of page % numbers on even/odd pages is the opposite of what you'd normally expect. % TODO: make this a switchable option? % % Headers: % {plain,TOC} LO # | <subjectcode> <papernumber> STUDENT HANDBOOK % {plain,TOC} RO <paperperiod>, <paperyear> % TOC LE <empty> % TOC RE CONTENTS | # % plain LE PART <partnumber>---<parttitle> % plain RE <sectiontype> <sectionnumber>---<sectiontitle> | # % {empty,1st,part} * <empty> % % Footers: % {plain,TOC,empty,part} * <empty> % 1st LO # | % 1st RE | # % % For ease of definition, here are some macros: \def\@plainHeadLO{\headerfont{\thepage{}\hspace{\HeadingBulletSpacing}\LeftHeadingBullet\hspace{\HeadingBulletSpacing}\MakeUppercase{\PaperCode\ \handbookname}}} \def\@plainHeadRO{\headerfont{\MakeUppercase{\PaperLongPeriod, \PaperYear}}} \def\@plainHeadLE{\headerfont{\MakeUppercase{\leftmark}}} \def\@plainHeadRE{\headerfont{\MakeUppercase{\rightmark}\hspace{\HeadingBulletSpacing}\RightHeadingBullet\hspace{\HeadingBulletSpacing}\thepage}} \def\@tocHeadLE{} \def\@tocHeadRE{\headerfont{\MakeUppercase{\contentsname}\hspace{\HeadingBulletSpacing}\RightHeadingBullet\hspace{\HeadingBulletSpacing}\thepage}} \def\@firstFootLO{\headerfont{\thepage\hspace{\HeadingBulletSpacing}\LeftHeadingBullet}} \def\@firstFootRO{\headerfont{\LeftHeadingBullet\hspace{\HeadingBulletSpacing}\thepage}} % Plain style is automatically set when we use \chapter or \part, but % this becomes a bit complicated, because we want a different appearance % for the first page of a chapter (simple footer only) vs. the title page of % a part (no header or footer at all). The simplest solution seems to be to % define a \newif that tells us if we're in part mode (default false) and sets % up the style accordingly. We then just have to overload the original % \chapter and \part macros to set the flag appropriately (see below). \newif\if@inpart \@inpartfalse \fancypagestyle{plain}{% \fancyhf{}% \if@inpart\else% \fancyfoot[LO]{\headerfont{\thepage\hspace{\HeadingBulletSpacing}\LeftHeadingBullet}}% \fancyfoot[RE]{\headerfont{\LeftHeadingBullet\hspace{\HeadingBulletSpacing}\thepage}}% \fi% } % Heading style for table of contents. \fancypagestyle{toc}{% \fancyhf{}% \fancyhead[LO]{\@plainHeadLO}% \fancyhead[RO]{\@plainHeadRO}% \fancyhead[LE]{\@tocHeadLE}% \fancyhead[RE]{\@tocHeadRE}% } % "normal" is the new "plain" :) % We use this rather than just \pagestyle{fancy}, because we need to % explicitly switch styles in a couple of places (e.g., TOC). It would % probably have made more sense to just redefine the "fancy" style, but % that seems to make LaTeX grind to a halt. \fancypagestyle{normal}{% \fancyhf{}% \fancyhead[LO]{\@plainHeadLO}% \fancyhead[RO]{\@plainHeadRO}% \fancyhead[LE]{\@plainHeadLE}% \fancyhead[RE]{\@plainHeadRE}% } \pagestyle{normal} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Create title page. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \newcommand{\maketitlepage}{% % TODO: % - Add University logo? \thispagestyle{empty}% \vspace*{\stretch{1}}% \begin{flushright}% \Huge\PaperCode \\% \PaperTitle \\% \rule{\textwidth}{3pt} \\[0.25\baselineskip]% \huge \handbookname \\[1.1\baselineskip]% \Large\HandbookAuthors% \end{flushright}% \vspace*{\stretch{2}}% \begin{center}% \scshape\Large Department of Information Science \\% University of Otago \\[0.25\baselineskip]% \PaperYear% \end{center}% \vspace*{\stretch{0.3}}% \clearpage\thispagestyle{empty}% blank, empty page } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Table of contents. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % Add a wrapper around the book class's \tableofcontents macro so we can % easily change the page style for the TOC section (and more importantly, % change it back). This also lets us hook in our own tracking of various % things like chapter titles. \let\@booktableofcontents\tableofcontents \renewcommand\tableofcontents{% \pagestyle{toc}% \@booktableofcontents% \clearpage\thispagestyle{toc}% \pagestyle{normal}% } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Different modes for different parts of the document. The behaviour here % is analogous to the \appendix macro. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % This macro updates relevant internal parameters in hyperref so that % correct PDF bookmarks are generated. \newcommand\@hyperrefsetup[1]{% \def\Hy@chapapp{#1}% \renewcommand{\theHchapter}{\theHpart.\arabic{chapter}}% \renewcommand{\theHsection}{\theHpart.\theHchapter.\arabic{section}}% \renewcommand{\theHsubsection}{\theHpart.\theHchapter.\theHsection.\arabic{subsection}}% \renewcommand{\theHsubsubsection}{\theHpart.\theHchapter.\theHsection.\theHsubsection.\arabic{subsubsection}}% } % Introduction part. \newcommand\intro{% \gdef\@chapapp{\introchaptername}% \@hyperrefsetup{introchapter}% } % Labs part. \newcommand\labs{% \gdef\@chapapp{\labname}% \@hyperrefsetup{lab}% } % Tutorials part. \newcommand\tutorials{% \gdef\@chapapp{\tutorialname}% \@hyperrefsetup{tutorial}% } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Sectioning. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % Wrappers for \chapter for each of labs, tutorials and "ordinary" chapters. % These all make the chapter title available through \CurrentChapterTitle. % % TODO: I wanted to override \chapter and refactor \general to \chapter, but % the TOC seems to wig out when I try it. Probably not that crucial... %\let\@bookchapter\chapter % % \renewcommand{\chapter}[1]% % {% % \@bookchapter{#1}% % \renewcommand{\CurrentChapterTitle}{#1}% % } % % TODO: prehaps rename \general to \introchapter? \newcommand{\general}[1]{\@inpartfalse\chapter{#1}} \newcommand{\lab}[1]{\@inpartfalse\chapter{#1}} \newcommand{\tutorial}[1]{\@inpartfalse\chapter{#1}} \newcommand{\handbookpart}[1]{\@inparttrue\part{#1}\partmark{#1}} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Answers handling. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \ifhandbook@showanswers \newenvironment{answer}{\par\vspace{0.5em}\itshape}{\normalfont\vspace{0.5em}} \else \newenvironment{answer}{% \@bsphack% \let\do\@makeother\dospecials\catcode`\^^M\active% \let\verbatim@startline\relax% \let\verbatim@addtoline\@gobble% \let\verbatim@processline\relax% \let\verbatim@finish\relax% \verbatim@% }{\@esphack} \fi %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Set up auxiliary file so that we can write out the first and last % absolute page number for each tutorial and lab exercise. We can then use % this to automatically generate a separate PDF for each exercise. % \newcounter{absolutepage} \newcounter{absolutepagetwoup} \newcommand{\markfirstpage}[1]{% \setcounter{absolutepage}{\the\count1}% \stepcounter{absolutepage}% \immediate\write\@auxout{\string\@writefile{bmk}{\string#1.1up.first=\theabsolutepage}}% \setcounter{absolutepagetwoup}{\value{absolutepage}/2+1}% \immediate\write\@auxout{\string\@writefile{bmk}{\string#1.2up.first=\theabsolutepagetwoup}}% } \newcommand{\marklastpage}[1]{% \cleardoublepage% can't just add 1 because we may be skipping 2 pages \immediate\write\@auxout{\string\@writefile{bmk}{\string#1.1up.last=\the\count1}}% \setcounter{absolutepagetwoup}{\the\count1/2}% \immediate\write\@auxout{\string\@writefile{bmk}{\string#1.2up.last=\theabsolutepagetwoup}}% } \endinput
\def\coursehandbookdate{12 June 2013} \def\coursehandbookversion{1.0.2} \def\coursehandbookshortdate{2013/06/12} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Document class for course handbooks. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Version History % v1.0 Initial version. % v1.0.1 Added siunitx to required packages. % v1.0.2 Modified header generation to translate short teaching period strings % into long equivalents (e.g., "S1" => "Semester One"). % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \NeedsTeXFormat{LaTeX2e}[2001/06/01] \ProvidesClass{coursehandbook}% [\coursehandbookshortdate\space v\coursehandbookversion\space INFO course handbook style] \RequirePackage{ifpdf} % We support only PDFLaTeX and XeTeX. \RequirePackage{ifxetex} \RequirePackage{kvoptions} % Key-value option handling. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Option processing. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \SetupKeyvalOptions{family=handbook, prefix=handbook@} \DeclareBoolOption{showanswers} \DeclareComplementaryOption{hideanswers}{showanswers} \DeclareStringOption[INFO]{subjectcode} \DeclareStringOption[!!PAPER NUMBER UNDEFINED!!]{papernumber} \DeclareStringOption[!!PAPER TITLE UNDEFINED!!]{papertitle} \DeclareStringOption[!!PAPER YEAR UNDEFINED!!]{paperyear} \DeclareStringOption[!!PAPER PERIOD UNDEFINED!!]{paperperiod} \DeclareStringOption[!!AUTHORS UNDEFINED!!]{authors} % \DeclareBoolOption{pdftex} % \DeclareBoolOption{xetex} % % \ifxetex % \DeclareVoidOption{xetex} % \OptionNotUsed{pdftex} % \else\ifpdf % \DeclareBoolOption{pdftex} % \OptionNotUsed{xetex} % \else % \ClassError{coursehandbook}{The coursehandbook document class only\MessageBreak\ supports PDF(La)TeX and XeTeX.}{The coursehandbook document class only supoprts the pdftex and\MessageBreak\ xetex drivers. Please use one of these.} % \fi \DeclareDefaultOption{% \ifx\CurrentOptionValue\relax% \expandafter\PassOptionsToClass% \expandafter{\CurrentOption}{book}% \else% \@unknownoptionerror% \fi% } \ProcessKeyvalOptions* \LoadClass{book} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % A bunch o' packages. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \ifxetex \RequirePackage{fontspec} % Font handling for XeTeX. \RequirePackage{xunicode} \RequirePackage{xltxtra} \else % Note that fontenc freaks out if any of the keyval option values % are surrounded by braces (?!). Spaces get eaten without braces, % so instead use \ in \documentclass to preserve them. \RequirePackage[T1]{fontenc} \RequirePackage{textcomp} \fi \RequirePackage{mathpazo} % Palatino for text and maths. \RequirePackage{graphicx} % Include graphics of all sorts. \RequirePackage{color} % Color handling. \RequirePackage[hmargin=68.393315pt,% Sensible margins, essentially the same as a4wide. top=107.1438pt,% bottom=116.90304pt]{geometry} % \RequirePackage{makeidx} \RequirePackage{amssymb} % AMS maths symbols. \RequirePackage{latexsym} % Extra LaTeX maths symbols. \RequirePackage{relalg} % Relational algebra symbols. % \RequirePackage{longtable} % For multi-page tables. \RequirePackage{multirow} % Multi-row cells in tables. \RequirePackage{rotating} % Rotate stuff. \RequirePackage{fancyhdr} % Fancy page headers & footers. \RequirePackage{verbatim} % Enhanced verbatim handling. \RequirePackage{listings} % Nicely formatted code listings. \RequirePackage[normalem]{ulem} % Fancy underlining, strike-through, etc. \usepackage[detect-all,binary-units]{siunitx} % SI unit and number formatting. % \RequirePackage{moreverb} % \RequirePackage{listings} % Pretty-print code listings; not currently used. \RequirePackage{count1to} % Needed to get the absolute page numbers. \RequirePackage{calc} % Needed to calculate page numbers for 2-up version. \RequirePackage{parskip} % Space-separated rather than indented paragraphs. \RequirePackage[% plainpages=false, % Stops pdfTeX complaining about duplicate page numbers. colorlinks=true,% urlcolor=blue, % Acceptable for print or screen linkcolor=blue, % Acceptable for print or screen bookmarks=true,% bookmarksopen=true,% bookmarksnumbered=true,% pdfpagemode=UseOutlines,% pdfstartview=FitB,% ]{hyperref} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Various setup macros to enable on-the-fly option changing. % These are particularly necessary for paper detail options (such as % papertitle) that may contain spaces. From the kvoptions documentation: % % ================================================== % * Spaces are removed, regardless where: % \documentclass[box=0 0 400 600]{article} % Now each package will see box=00400600 as global option. % % * In the previous case also braces would not help: % \documentclass[box={0 0 400 600}]{article} % The result is an error message: % ! LaTeX Error: Missing \begin{document}. % % * The requirements on robustness are extremly high. LATEX expands the % option. All that will not work as environment name will break also % as option. Even a \relax will generate an error message: % ! Missing \endcsname inserted. % Of course, LATEX does not use its protecting mechanisms. On contrary % \protect itself will cause errors. % ================================================== % % The upshot is that in the \documentclass, spaces are eaten, but we can't use % {} or macros like \space or "\ " to escape them. The only thing that does % work is: % % papertitle=some\csname space\endcsname name % % which is particularly ugly. A better solution is to follow the hyperref % model and have a "setup" macro that sets these options AFTER the % \documentclass. % % These also call \hypersetup to ensure that the PDF metadata match. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % Set arbitrary class options. \newcommand{\handbooksetup}[1]{% \setkeys{handbook}{#1}% \@updatepdfmetadata% } % \papersetup is intended to be for setting paper detail options, but is % essentially just a synonym of \handbooksetup. \let\papersetup\handbooksetup % Macros for setting specific paper detail options. \newcommand{\setsubjectcode}[1]{% \@setpaperoption{subjectcode}{#1}% } \newcommand{\setpapernumber}[1]{% \@setpaperoption{papernumber}{#1}% } \newcommand{\setpapertitle}[1]{% \@setpaperoption{papertitle}{#1}% } \newcommand{\setpaperyear}[1]{% \expandafter\@setpaperoption{paperyear}{#1}% } \newcommand{\setpaperperiod}[1]{% \@setpaperoption{paperperiod}{#1}% } \newcommand{\setauthors}[1]{% \@setpaperoption{authors}{#1}% } \newcommand{\@setpaperoption}[2]{% \setkeys{handbook}{#1={#2}} \@updatepdfmetadata% } \def\@updatepdfmetadata{% \hypersetup{% pdftitle={\expandafter\handbook@subjectcode\ \expandafter\handbook@papernumber\ Handbook, \expandafter\handbook@paperyear},% pdfauthor={\expandafter\handbook@authors},% pdfsubject={Student Handbook for \expandafter\handbook@subjectcode\ \expandafter\handbook@papernumber, \expandafter\handbook@paperyear.}% }% } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Set up fonts. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \ifxetex \defaultfontfeatures{Mapping=tex-text} \setmainfont{TeX Gyre Pagella} \setmonofont[Scale=MatchLowercase]{Letter Gothic 12 Pitch} % Not sure about these? \setsansfont[Scale=MatchLowercase]{Futura Book} \newfontfamily\headerfont[Size=11]{Futura Light} \else \renewcommand{\sfdefault}{bfu} \renewcommand{\ttdefault}{blg} \DeclareFixedFont{\headerfont}{T1}{bfu}{lc}{n}{11} \fi %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Set up listings. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % Pre-load the most obviously used languages. You can still use other languages, % just not as quickly. \lstloadlanguages{Oracle,Java} % Set defaults. \lstset{basicstyle=\ttfamily,basewidth=0.5em,escapeinside={(@}{@)}, showspaces=false,showstringspaces=false} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Miscellaneous stuff. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % Useful macros for paper code, etc. \def\PaperCode{\expandafter\handbook@subjectcode\ \expandafter\handbook@papernumber} \def\ShortPaperCode{\expandafter\handbook@subjectcode\expandafter\handbook@papernumber} \def\PaperTitle{\expandafter\handbook@papertitle} \def\PaperYear{\expandafter\handbook@paperyear} \def\PaperPeriod{\expandafter\handbook@paperperiod} \def\HandbookAuthors{\expandafter\handbook@authors} % Stolen from ouexam :). \def\@SONE{S1} \def\@STWO{S2} \def\@SS{SS} \def\@FY{FY} \newcommand{\PaperLongPeriod}{% \ifx\handbook@paperperiod\@SONE Semester One% \else\ifx\handbook@paperperiod\@STWO Semester Two% \else\ifx\handbook@paperperiod\@SS Summer School% \else\ifx\handbook@paperperiod\@FY Full Year% \else\PaperPeriod% \fi\fi\fi\fi% } % Handbook name. \newcommand{\handbookname}{Student Handbook} % "Chapter" names. Note that the lab and tutorial names are dependent on % the setting of the showanswers class option. \newcommand{\introchaptername}{Introductory Chapter} \newcommand{\labname}{\ifhandbook@showanswers Selected Answers for \fi\PaperCode\ Lab} \newcommand{\tutorialname}{\ifhandbook@showanswers Selected Answers for \fi\PaperCode\ Tutorial} % listings.sty has problems with in-line verbatim code and fancy styles % (backgrounds, borders), hence this: \newcommand{\code}[1]{\texttt{#1}} % Other useful macros. \newcommand{\term}[1]{\textit{#1}} \newcommand{\foreign}[1]{\textit{#1}} \newcommand{\BookTitle}[1]{\textit{#1}} % Backslashes - what a pain! \newcommand{\bs}{\(\backslash{}\)} % We want "chapter" numbers to reset for each part. \@addtoreset{chapter}{part} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Set up fancy headings. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % Although we don't actually use the "fancy" page style, we have to set it % initially in order for the page marks to be set up correctly. \pagestyle{fancy} \fancyhf{} % Page marks. \partmark is completely new, the others are standard. \newcommand{\partmark}[1]{\markboth{\partname\ \thepart---#1}{}} \renewcommand{\chaptermark}[1]{\markright{\@chapapp\ \thechapter---#1}} \renewcommand{\sectionmark}[1]{} \setlength{\headheight}{15pt} % No running head or foot rules. \renewcommand{\headrulewidth}{0pt} \renewcommand{\footrulewidth}{0pt} % Use | to separate items in the header/footer. \newcommand{\LeftHeadingBullet}{\(\vert\)} \newcommand{\RightHeadingBullet}{\(\vert\)} \newlength{\HeadingBulletSpacing} \setlength{\HeadingBulletSpacing}{0.5em} % The headers and footers are set up as follows, where "TOC" = table of % contents, "1st" = first page of part or chapter, "part" = title page of % a part, "plain" = plain page style, "empty" = empty page style, % "#" = page number, "LO" = left odd, "RE" = right even, etc. If something % isn't mentioned, it's empty. % % Note that we're optimising for 2-up printing, so the placement of page % numbers on even/odd pages is the opposite of what you'd normally expect. % TODO: make this a switchable option? % % Headers: % {plain,TOC} LO # | <subjectcode> <papernumber> STUDENT HANDBOOK % {plain,TOC} RO <paperperiod>, <paperyear> % TOC LE <empty> % TOC RE CONTENTS | # % plain LE PART <partnumber>---<parttitle> % plain RE <sectiontype> <sectionnumber>---<sectiontitle> | # % {empty,1st,part} * <empty> % % Footers: % {plain,TOC,empty,part} * <empty> % 1st LO # | % 1st RE | # % % For ease of definition, here are some macros: \def\@plainHeadLO{\headerfont{\thepage{}\hspace{\HeadingBulletSpacing}\LeftHeadingBullet\hspace{\HeadingBulletSpacing}\MakeUppercase{\PaperCode\ \handbookname}}} \def\@plainHeadRO{\headerfont{\MakeUppercase{\PaperLongPeriod, \PaperYear}}} \def\@plainHeadLE{\headerfont{\MakeUppercase{\leftmark}}} \def\@plainHeadRE{\headerfont{\MakeUppercase{\rightmark}\hspace{\HeadingBulletSpacing}\RightHeadingBullet\hspace{\HeadingBulletSpacing}\thepage}} \def\@tocHeadLE{} \def\@tocHeadRE{\headerfont{\MakeUppercase{\contentsname}\hspace{\HeadingBulletSpacing}\RightHeadingBullet\hspace{\HeadingBulletSpacing}\thepage}} \def\@firstFootLO{\headerfont{\thepage\hspace{\HeadingBulletSpacing}\LeftHeadingBullet}} \def\@firstFootRO{\headerfont{\LeftHeadingBullet\hspace{\HeadingBulletSpacing}\thepage}} % Plain style is automatically set when we use \chapter or \part, but % this becomes a bit complicated, because we want a different appearance % for the first page of a chapter (simple footer only) vs. the title page of % a part (no header or footer at all). The simplest solution seems to be to % define a \newif that tells us if we're in part mode (default false) and sets % up the style accordingly. We then just have to overload the original % \chapter and \part macros to set the flag appropriately (see below). \newif\if@inpart \@inpartfalse \fancypagestyle{plain}{% \fancyhf{}% \if@inpart\else% \fancyfoot[LO]{\headerfont{\thepage\hspace{\HeadingBulletSpacing}\LeftHeadingBullet}}% \fancyfoot[RE]{\headerfont{\LeftHeadingBullet\hspace{\HeadingBulletSpacing}\thepage}}% \fi% } % Heading style for table of contents. \fancypagestyle{toc}{% \fancyhf{}% \fancyhead[LO]{\@plainHeadLO}% \fancyhead[RO]{\@plainHeadRO}% \fancyhead[LE]{\@tocHeadLE}% \fancyhead[RE]{\@tocHeadRE}% } % "normal" is the new "plain" :) % We use this rather than just \pagestyle{fancy}, because we need to % explicitly switch styles in a couple of places (e.g., TOC). It would % probably have made more sense to just redefine the "fancy" style, but % that seems to make LaTeX grind to a halt. \fancypagestyle{normal}{% \fancyhf{}% \fancyhead[LO]{\@plainHeadLO}% \fancyhead[RO]{\@plainHeadRO}% \fancyhead[LE]{\@plainHeadLE}% \fancyhead[RE]{\@plainHeadRE}% } \pagestyle{normal} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Create title page. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \newcommand{\maketitlepage}{% % TODO: % - Add University logo? \thispagestyle{empty}% \vspace*{\stretch{1}}% \begin{flushright}% \Huge\PaperCode \\% \PaperTitle \\% \rule{\textwidth}{3pt} \\[0.25\baselineskip]% \huge \handbookname \\[1.1\baselineskip]% \Large\HandbookAuthors% \end{flushright}% \vspace*{\stretch{2}}% \begin{center}% \scshape\Large Department of Information Science \\% University of Otago \\[0.25\baselineskip]% \PaperYear% \end{center}% \vspace*{\stretch{0.3}}% \clearpage\thispagestyle{empty}% blank, empty page } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Table of contents. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % Add a wrapper around the book class's \tableofcontents macro so we can % easily change the page style for the TOC section (and more importantly, % change it back). This also lets us hook in our own tracking of various % things like chapter titles. \let\@booktableofcontents\tableofcontents \renewcommand\tableofcontents{% \pagestyle{toc}% \@booktableofcontents% \clearpage\thispagestyle{toc}% \pagestyle{normal}% } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Different modes for different parts of the document. The behaviour here % is analogous to the \appendix macro. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % This macro updates relevant internal parameters in hyperref so that % correct PDF bookmarks are generated. \newcommand\@hyperrefsetup[1]{% \def\Hy@chapapp{#1}% \renewcommand{\theHchapter}{\theHpart.\arabic{chapter}}% \renewcommand{\theHsection}{\theHpart.\theHchapter.\arabic{section}}% \renewcommand{\theHsubsection}{\theHpart.\theHchapter.\theHsection.\arabic{subsection}}% \renewcommand{\theHsubsubsection}{\theHpart.\theHchapter.\theHsection.\theHsubsection.\arabic{subsubsection}}% } % Introduction part. \newcommand\intro{% \gdef\@chapapp{\introchaptername}% \@hyperrefsetup{introchapter}% } % Labs part. \newcommand\labs{% \gdef\@chapapp{\labname}% \@hyperrefsetup{lab}% } % Tutorials part. \newcommand\tutorials{% \gdef\@chapapp{\tutorialname}% \@hyperrefsetup{tutorial}% } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Sectioning. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % Wrappers for \chapter for each of labs, tutorials and "ordinary" chapters. % These all make the chapter title available through \CurrentChapterTitle. % % TODO: I wanted to override \chapter and refactor \general to \chapter, but % the TOC seems to wig out when I try it. Probably not that crucial... %\let\@bookchapter\chapter % % \renewcommand{\chapter}[1]% % {% % \@bookchapter{#1}% % \renewcommand{\CurrentChapterTitle}{#1}% % } % % TODO: prehaps rename \general to \introchapter? \newcommand{\general}[1]{\@inpartfalse\chapter{#1}} \newcommand{\lab}[1]{\@inpartfalse\chapter{#1}} \newcommand{\tutorial}[1]{\@inpartfalse\chapter{#1}} \newcommand{\handbookpart}[1]{\@inparttrue\part{#1}\partmark{#1}} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Answers handling. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \ifhandbook@showanswers \newenvironment{answer}{\par\vspace{0.5em}\itshape}{\normalfont\vspace{0.5em}} \else \newenvironment{answer}{% \@bsphack% \let\do\@makeother\dospecials\catcode`\^^M\active% \let\verbatim@startline\relax% \let\verbatim@addtoline\@gobble% \let\verbatim@processline\relax% \let\verbatim@finish\relax% \verbatim@% }{\@esphack} \fi %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Set up auxiliary file so that we can write out the first and last % absolute page number for each tutorial and lab exercise. We can then use % this to automatically generate a separate PDF for each exercise. % \newcounter{absolutepage} \newcounter{absolutepagetwoup} \newcommand{\markfirstpage}[1]{% \setcounter{absolutepage}{\the\count1}% \stepcounter{absolutepage}% \immediate\write\@auxout{\string\@writefile{bmk}{\string#1.1up.first=\theabsolutepage}}% \setcounter{absolutepagetwoup}{\value{absolutepage}/2+1}% \immediate\write\@auxout{\string\@writefile{bmk}{\string#1.2up.first=\theabsolutepagetwoup}}% } \newcommand{\marklastpage}[1]{% \cleardoublepage% can't just add 1 because we may be skipping 2 pages \immediate\write\@auxout{\string\@writefile{bmk}{\string#1.1up.last=\the\count1}}% \setcounter{absolutepagetwoup}{\the\count1/2}% \immediate\write\@auxout{\string\@writefile{bmk}{\string#1.2up.last=\theabsolutepagetwoup}}% } \endinput
Ignore Space
Show notes
View
lectures/otagofonts.sty
\def\filedate{6 December 2024} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Set up official Otago fonts based on what’s available. Fall back to reasonable % alternatives where possible. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Version History % v1.0 Initial version, rebuilt from deprecated lecturecommon package. % v1.1 Refactored font checking mechanism. % v1.2 Fixed sans-serif scaling, added Noto Sans. % v1.3 Added new Wickliffe fonts and fallbacks. % v1.3.1 Switched serif font to Wickliffe Light. % v1.3.2 Switched bold fonts to Wickliffe (Sans) Medium. % v1.4 Switched from mathspec to unicode-math, further font tweaks. % v1.4.1 Replaced deprecated ifxetex with iftex. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \NeedsTeXFormat{LaTeX2e}[2001/06/01] \ProvidesPackage{otagofonts}[2024/12/06 Otago standard fonts v1.4.1] \RequirePackage{etoolbox} \RequirePackage{iftex} \RequirePackage{amsmath} \ifxetex \RequirePackage[no-math]{fontspec} \RequirePackage{unicode-math} \RequirePackage{xunicode} \RequirePackage{xltxtra} % Try a few different fonts that are either the official Otago font or a % reasonable alternative, using etoolbox's list looping macros. The tricky % part is making it generic for all three font categories (main, sans, mono), % and I can only successfully make it work for the first one encountered. % The set of fonts is limited, so this is OK. % % Note: Explicitly specify Mapping=tex-text only for the main and sans fonts, % otherwise curly quotes will automatically appear in the mono font. Since % this is pretty much exclusively used for code listings, this is a bad thing. % Main font (body text). \newbool{foundmainfont} \PackageInfo{otagofonts}{Looking for suitable main font} % font-specific defaults \defaultfontfeatures[Wickliffe Light]{BoldFont={Wickliffe Medium}} \renewcommand*{\do}[1]{% \PackageInfo{otagofonts}{Trying #1...} \IfFontExistsTF{#1}{% \setmainfont{#1}[Mapping=tex-text]% \PackageInfo{otagofonts}{Using #1 for main font}% \booltrue{foundmainfont}% \listbreak% }{}% } \docsvlist{Wickliffe Light,Crimson Pro,Crimson Text,Georgia,TeX Gyre Pagella,Times New Roman} \ifbool{foundmainfont}{}{% \PackageWarning{otagofonts}{% Could not find any suitable main font.\MessageBreak% Falling back to LaTeX default.\MessageBreak% Recommended fonts:\MessageBreak% \space\space Wickliffe (official, proprietary)\MessageBreak% \space\space Crimson Pro (https://fonts.google.com/specimen/Crimson+Pro)% \space\space Crimson Text (https://fonts.google.com/specimen/Crimson+Text)% }% } % Maths font. % Use Latin Modern, the unicode-math default. It looks reasonably OK alongside % many fonts including Wickliffe Light. It can always be manually overidden % using \setmathfont if a better alternative is available. \setmathfont{latinmodern-math.otf} \setmathrm{latinmodern-math.otf} % Sans-serif font. \newbool{foundsansfont} \PackageInfo{otagofonts}{Looking for suitable sans-serif font} % font-specific defaults \defaultfontfeatures[Wickliffe Sans Light]{BoldFont={Wickliffe Sans Medium}} \defaultfontfeatures[Open Sans Light]{BoldFont={Open Sans}} \defaultfontfeatures[Noto Sans Light]{BoldFont={Noto Sans}} \defaultfontfeatures[Roboto Light]{BoldFont={Roboto}} \renewcommand*{\do}[1]{% \PackageInfo{otagofonts}{Trying #1...} \IfFontExistsTF{#1}{% \setsansfont{#1}[Scale=MatchLowercase,Mapping=tex-text]% \PackageInfo{otagofonts}{Using #1 for sans-serif font}% \booltrue{foundsansfont}% \listbreak% }{}% } \docsvlist{Wickliffe Sans Light,Open Sans Light,Noto Sans Light,Roboto Light,Arial} \ifbool{foundsansfont}{}{% \PackageWarning{otagofonts}{Could not find any suitable sans-serif font.\MessageBreak% Falling back to LaTeX default.\MessageBreak% Recommended fonts:\MessageBreak% \space\space Wickliffe Sans (official, proprietary)\MessageBreak% \space\space Open Sans (https://fonts.google.com/specimen/Open+Sans)\MessageBreak% \space\space Roboto (https://fonts.google.com/specimen/Roboto)% }% } % Monospaced font, mainly for code listings. \newbool{foundmonofont} \PackageInfo{otagofonts}{Looking for suitable monospaced font} % font-specific defaults \defaultfontfeatures[Iosevka Light]{RawFeature={+ss03;-calt}} \renewcommand*{\do}[1]{% \PackageInfo{otagofonts}{Trying #1...} \IfFontExistsTF{#1}{% \setmonofont{#1}[Scale=MatchLowercase,Mapping=]% \PackageInfo{otagofonts}{Using #1 for monospaced font}% \booltrue{foundmonofont}% \listbreak% }{}% } \docsvlist{Iosevka Light,Letter Gothic 12 Pitch,Inconsolata} \ifbool{foundmonofont}{}{% \PackageWarning{otagofonts}{Could not find any suitable monospaced font.\MessageBreak% Falling back to LaTeX default.\MessageBreak% Recommended fonts:\MessageBreak% \space\space Iosevka (https://github.com/be5invis/Iosevka/releases, but complex!)\MessageBreak% \space\space Inconsolata (https://fonts.google.com/specimen/Inconsolata)% }% } \else % assume PDFLaTeX otherwise \RequirePackage[T1]{fontenc} \RequirePackage{textcomp} \RequirePackage{lmodern} \RequirePackage{mathpazo} \PackageWarning{otagofonts}{% Otago-compatible fonts are not yet supported for LaTeX\MessageBreak% or PDFLaTeX. XeLaTeX is preferred% } % Gill Sans to come... % \renewcommand{\sfdefault}{} % \renewcommand{\ttdefault}{blg} \fi \endinput
\def\filedate{26 June 2024} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Set up official Otago fonts based on what’s available. Fall back to reasonable % alternatives where possible. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Version History % v1.0 Initial version, rebuilt from deprecated lecturecommon package. % v1.1 Refactored font checking mechanism. % v1.2 Fixed sans-serif scaling, added Noto Sans. % v1.3 Added new Wickliffe fonts and fallbacks. % v1.3.1 Switched serif font to Wickliffe Light. % v1.3.2 Switched bold fonts to Wickliffe (Sans) Medium. % v1.4 Switched from mathspec to unicode-math, further font tweaks. % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \NeedsTeXFormat{LaTeX2e}[2001/06/01] \ProvidesPackage{otagofonts}[2024/06/26 Otago standard fonts v1.4] \RequirePackage{etoolbox} \RequirePackage{ifxetex} \RequirePackage{amsmath} \ifxetex \RequirePackage[no-math]{fontspec} \RequirePackage{unicode-math} \RequirePackage{xunicode} \RequirePackage{xltxtra} % Try a few different fonts that are either the official Otago font or a % reasonable alternative, using etoolbox's list looping macros. The tricky % part is making it generic for all three font categories (main, sans, mono), % and I can only successfully make it work for the first one encountered. % The set of fonts is limited, so this is OK. % % Note: Explicitly specify Mapping=tex-text only for the main and sans fonts, % otherwise curly quotes will automatically appear in the mono font. Since % this is pretty much exclusively used for code listings, this is a bad thing. % Main font (body text). \newbool{foundmainfont} \PackageInfo{otagofonts}{Looking for suitable main font} % font-specific defaults \defaultfontfeatures[Wickliffe Light]{BoldFont={Wickliffe Medium}} \renewcommand*{\do}[1]{% \PackageInfo{otagofonts}{Trying #1...} \IfFontExistsTF{#1}{% \setmainfont{#1}[Mapping=tex-text]% \PackageInfo{otagofonts}{Using #1 for main font}% \booltrue{foundmainfont}% \listbreak% }{}% } \docsvlist{Wickliffe Light,Crimson Pro,Crimson Text,Georgia,TeX Gyre Pagella,Times New Roman} \ifbool{foundmainfont}{}{% \PackageWarning{otagofonts}{% Could not find any suitable main font.\MessageBreak% Falling back to LaTeX default.\MessageBreak% Recommended fonts:\MessageBreak% \space\space Wickliffe (official, proprietary)\MessageBreak% \space\space Crimson Pro (https://fonts.google.com/specimen/Crimson+Pro)% \space\space Crimson Text (https://fonts.google.com/specimen/Crimson+Text)% }% } % Maths font. % Use Latin Modern, the unicode-math default. It looks reasonably OK alongside % many fonts including Wickliffe Light. It can always be manually overidden % using \setmathfont if a better alternative is available. \setmathfont{latinmodern-math.otf} \setmathrm{latinmodern-math.otf} % Sans-serif font. \newbool{foundsansfont} \PackageInfo{otagofonts}{Looking for suitable sans-serif font} % font-specific defaults \defaultfontfeatures[Wickliffe Sans Light]{BoldFont={Wickliffe Sans Medium}} \defaultfontfeatures[Open Sans Light]{BoldFont={Open Sans}} \defaultfontfeatures[Noto Sans Light]{BoldFont={Noto Sans}} \defaultfontfeatures[Roboto Light]{BoldFont={Roboto}} \renewcommand*{\do}[1]{% \PackageInfo{otagofonts}{Trying #1...} \IfFontExistsTF{#1}{% \setsansfont{#1}[Scale=MatchLowercase,Mapping=tex-text]% \PackageInfo{otagofonts}{Using #1 for sans-serif font}% \booltrue{foundsansfont}% \listbreak% }{}% } \docsvlist{Wickliffe Sans Light,Open Sans Light,Noto Sans Light,Roboto Light,Arial} \ifbool{foundsansfont}{}{% \PackageWarning{otagofonts}{Could not find any suitable sans-serif font.\MessageBreak% Falling back to LaTeX default.\MessageBreak% Recommended fonts:\MessageBreak% \space\space Wickliffe Sans (official, proprietary)\MessageBreak% \space\space Open Sans (https://fonts.google.com/specimen/Open+Sans)\MessageBreak% \space\space Roboto (https://fonts.google.com/specimen/Roboto)% }% } % Monospaced font, mainly for code listings. \newbool{foundmonofont} \PackageInfo{otagofonts}{Looking for suitable monospaced font} % font-specific defaults \defaultfontfeatures[Iosevka Light]{RawFeature={+ss03;-calt}} \renewcommand*{\do}[1]{% \PackageInfo{otagofonts}{Trying #1...} \IfFontExistsTF{#1}{% \setmonofont{#1}[Scale=MatchLowercase,Mapping=]% \PackageInfo{otagofonts}{Using #1 for monospaced font}% \booltrue{foundmonofont}% \listbreak% }{}% } \docsvlist{Iosevka Light,Letter Gothic 12 Pitch,Inconsolata} \ifbool{foundmonofont}{}{% \PackageWarning{otagofonts}{Could not find any suitable monospaced font.\MessageBreak% Falling back to LaTeX default.\MessageBreak% Recommended fonts:\MessageBreak% \space\space Iosevka (https://github.com/be5invis/Iosevka/releases, but complex!)\MessageBreak% \space\space Inconsolata (https://fonts.google.com/specimen/Inconsolata)% }% } \else % assume PDFLaTeX otherwise \RequirePackage[T1]{fontenc} \RequirePackage{textcomp} \RequirePackage{lmodern} \RequirePackage{mathpazo} \PackageWarning{otagofonts}{% Otago-compatible fonts are not yet supported for LaTeX\MessageBreak% or PDFLaTeX. XeLaTeX is preferred% } % Gill Sans to come... % \renewcommand{\sfdefault}{} % \renewcommand{\ttdefault}{blg} \fi \endinput
Show line notes below
GitBucket
4.21.2
GitBucket
4.21.2