From de9a0afa47c2ee09e1d4704821cad2b231d36b3f Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Mon, 20 Mar 2023 03:05:55 +0000 Subject: CTAN sync 202303200305 --- macros/latex/contrib/ucalgmthesis/README.md | 28 +++--- macros/latex/contrib/ucalgmthesis/chapter1.tex | 26 +++++- macros/latex/contrib/ucalgmthesis/frontmatter.tex | 30 ++++--- .../latex/contrib/ucalgmthesis/sample-thesis.pdf | Bin 117829 -> 265927 bytes .../latex/contrib/ucalgmthesis/sample-thesis.tex | 94 +++++++++++++-------- macros/latex/contrib/ucalgmthesis/titlepage.tex | 6 +- macros/latex/contrib/ucalgmthesis/ucalgmthesis.cls | 31 +++---- 7 files changed, 137 insertions(+), 78 deletions(-) (limited to 'macros') diff --git a/macros/latex/contrib/ucalgmthesis/README.md b/macros/latex/contrib/ucalgmthesis/README.md index 2b3c1b74d4..0c9c58626a 100644 --- a/macros/latex/contrib/ucalgmthesis/README.md +++ b/macros/latex/contrib/ucalgmthesis/README.md @@ -4,7 +4,7 @@ ucalgmthesis `ucalgmthesis.cls` is a LaTeX class file that produces documents according to the thesis guidelines of the [University of Calgary Faculty of Graduate -Studies](http://www.grad.ucalgary.ca/current/thesis/guidelines). It +Studies](https://grad.ucalgary.ca/current-students/thesis-based-students/thesis/building-thesis). It uses the [`memoir`](https://ctan.org/pkg/memoir?lang=en) class, which provides very powerful and flexible mechanisms for book design and layout. All `memoir` commands for changing chapter and section @@ -64,6 +64,14 @@ The easiest way to get started is perhaps to rename liking, and put the content of your thesis into the files it includes (`frontmatter.tex`, `chapter1.tex`, etc.) +`ucalgmthesis` is part of TeXLive and MikTeX. If you have one of these +installed (or you are working on Overleaf), you do not need the class file +`ucalgmthesis.cls` itself in your thesis directory. You can just copy +the TeX and Bib file from the source directory in your TeXLive tree, +from [CTAN](https://ctan.org/tex-archive/macros/latex/contrib/ucalgmthesis), +or from the [GitHub +repository](https://github.com/rzach/ucalgmthesis) to get started. + Commands -------- @@ -184,16 +192,12 @@ Troubleshooting and Known Issues load. Try compiling without the font option to see if that's the problem. -- `times`, `palatino`, and `libertine` options load the `newtxmath` or - `newpxmath` packages. These have to be loaded after `amsthm`, so the - class loads `amsthm` before it sets up these fonts. If you don't - want that, leave out the font option, load the font in your main - document preamble, then call `\manuscriptthesis` or - `\fullpagethesis` to set the right page dimensions based on the new - font. - -- `garamond` and `utopia` use the `mathdesign` package, which has a buggy - `\hrulefill` command. The package tries to correct this. +- The font options all load the `newtxmath` or `newpxmath` packages. + These have to be loaded after `amsthm`, so the class loads `amsthm` + before it sets up these fonts. If you don't want that, leave out the + font option, load the font in your main document preamble, then call + `\manuscriptthesis` or `\fullpagethesis` to set the right page + dimensions based on the new font. - `garamond` uses the `garamondx` package. This package has a restrictive license and is thus not included in the TeXLive @@ -213,4 +217,4 @@ Troubleshooting and Known Issues even with the `openany` option, and so `twoside` will produce additional blank pages in the front matter. The main text, however, should have the same pagination as the "official" one-sided version, - as the size of the typeblock is the same. \ No newline at end of file + as the size of the typeblock is the same. diff --git a/macros/latex/contrib/ucalgmthesis/chapter1.tex b/macros/latex/contrib/ucalgmthesis/chapter1.tex index 1abd289807..1a358e7cd4 100644 --- a/macros/latex/contrib/ucalgmthesis/chapter1.tex +++ b/macros/latex/contrib/ucalgmthesis/chapter1.tex @@ -3,13 +3,35 @@ \chapter{Introduction} -\epigraph{Lorem ipsum dolor sit amet, -consectetuer adipiscing elit.}{Anonymous} +\epigraph{The last years of the eighteenth century are broken by a +discontinuity similar to that which destroyed Renaissance thought at +the beginning of the seventeenth.}{Michael Foucault, \emph{The Order +of Things: An Archaeology of the Human Sciences}} The text above is an \emph{epigraph}. In this typeface, you can have text in \textbf{boldface}, \emph{italics}, \textbf{\emph{bold italics}}, \textsl{slanted}, and \textsc{Small Caps}. +Adjust the commands in the preamble of the main file provided +(that's \verb+sample-thesis.tex+, which you should probably rename to +something more descriptive, like \verb+your-name-thesis.tex+) if you +don't like how this page looks. E.g., you can provide other options for a +different font, or remove the \verb+manuscript+ option for a smaller +font (11~pt) and one-and-a-half linespacing, for a neater, more +compact look. See the \verb+README+ file or the comments in the main +file for details. + +The appearance of chapter and section heads, the table of contents, +footnotes, epigraphs (like the one above), and many other book design +elements are controlled by commands provided by the \verb|memoir| +class, which this thesis style uses. Consult the +\href{https://ctan.org/pkg/memoir}{memoir manual} if you want to +change it. However, the standard layout, page numbering, table of +contents, etc., as provided by the \verb|ucalgmthesis| class complies +with the requirements of the +\href{https://grad.ucalgary.ca/current-students/thesis-based-students/thesis/building-thesis}{University +of Calgary thesis formatting guidelines} (July 13, 2018 version). + \section{Literature Review} \blindtext\pagenote{\blindtext} diff --git a/macros/latex/contrib/ucalgmthesis/frontmatter.tex b/macros/latex/contrib/ucalgmthesis/frontmatter.tex index 6fe9381c6e..c29b60eabe 100644 --- a/macros/latex/contrib/ucalgmthesis/frontmatter.tex +++ b/macros/latex/contrib/ucalgmthesis/frontmatter.tex @@ -1,5 +1,5 @@ % Sample University of Calgary Thesis -% This file contains the FRONT MATTER other thna the title page +% This file contains the FRONT MATTER other than the title page \chapter{Abstract} @@ -20,29 +20,31 @@ your work. A manuscript-based thesis must include an explanation of which parts of your thesis were already published and details of the publication. For example: \begin{quote} -Portions of the introductory text of Chapter~1 are used with -permission from Smith et al. (2015) of which I am an author. Table~1.1 -is modified from Supplementary Table~3 in Smith et -al. (2014). Chapter~2 of this thesis has been published as J.~Smith -and J.~Doe, ``Title of Article''. Journal Name, vol.~1, issue~1. +\textbf{Example 1.} Chapter 1. Portions of the introductory text are +used with permission from Smith et al. (2015) of which I am an author. +Table~1.1 is modified from Supplementary Table~3 in Smith et al. +(2014). + +\textbf{Example 2.} Chapter 3 of this thesis has been published as J. Smith and J. Doe, ``Title +of Article''. \emph{Journal Name}, vol. 1, issue 1 \end{quote} For a traditional thesis requiring ethics approval, include the name of the board that approved the research project, the title of the project, and the number of the approval certificate. For example: \begin{quote} -This thesis is original, unpublished, independent work by the author, -J. Doe. The experiments reported in Chapters 2--4 were covered by -Ethics Certificate number 007, issued by the University of Calgary -Conjoint Health Ethics Board for the project ``Project Title'' on -December 15, 2016. +\textbf{Example.} This thesis is original, unpublished, independent +work by the author, J. Doe. The experiments reported in Chapters 2--4 +were covered by Ethics Certificate number 007, issued by the +University of Calgary Conjoint Health Ethics Board for the project +``Project Title'' on December 15, 2016. \end{quote} For a traditional thesis with no ethics approval required, simply state something along the lines of: \begin{quote} -This thesis is original, unpublished, independent work by the author, -Jane M. Doe. +\textbf{Example.} This thesis is original, unpublished, independent +work by the author, Jane M. Doe. \end{quote} - + \chapter{Acknowledgments} The acknowledgments are a place for you to thank/recognize academics diff --git a/macros/latex/contrib/ucalgmthesis/sample-thesis.pdf b/macros/latex/contrib/ucalgmthesis/sample-thesis.pdf index 8cc7d5a167..bbed0d4fba 100644 Binary files a/macros/latex/contrib/ucalgmthesis/sample-thesis.pdf and b/macros/latex/contrib/ucalgmthesis/sample-thesis.pdf differ diff --git a/macros/latex/contrib/ucalgmthesis/sample-thesis.tex b/macros/latex/contrib/ucalgmthesis/sample-thesis.tex index 96fc6b4ace..b173f2cd7a 100644 --- a/macros/latex/contrib/ucalgmthesis/sample-thesis.tex +++ b/macros/latex/contrib/ucalgmthesis/sample-thesis.tex @@ -6,60 +6,70 @@ % Graduate Studies, available here: % https://grad.ucalgary.ca/current-students/thesis-based-students/thesis/building-thesis -% To use this sample for your own thesis, rename this file, make any changes -% necessary, then add the content of your thesis t othe included files -% frontmatter.tex, chapter1.tex, etc. +% To use this sample for your own thesis, rename this file, make any +% changes necessary, then add the content of your thesis to the +% included files frontmatter.tex, chapter1.tex, etc. % First, we load the UCalgary Memoir Thesis class ucalgmthesis, % available at https://github.com/rzach/ucalgmthesis -% By default (without options), this produces a 1-1/2 spaced thesis in -% 11 point font without running heads. See the README file for a -% description of all package options. +% This class in turn loads the memoir class for book design. All its +% commands and options are available to you. See +% https://ctan.org/pkg/memoir -% In our sample we give three options: Option utopia sets the thesis in a -% nice font. Option headers produces running heads. Option manuscript -% formats the page in a way suitable for reading and commenting: 12 pt type, -% double spaced, approx. 25 lines per page, with approx. 72 characters -% per line. For filing in the Vault, remove that option to produce a -% more compact thesis with a slightly better layout. +% By default (without options), the class produces a 1-1/2 spaced +% thesis in 11 point font without running heads. See the README file +% for a description of all package options. -\documentclass[utopia,headers,manuscript]{ucalgmthesis} +% In our sample we give three options: Option "utopia" sets the thesis +% in a nice font: Utopia in this case. Other font options are "times", +% "garamond", "palatino", and "libertine". Try them out to see what +% you like best. If you do not provide a font option, the thesis is +% set in LaTeX's standard Computer Modern font. -% Using LaTeX? Then you're probably using math, and so you want to use -% the AMS math commands and define some theorem environments! But you -% can take these out or use your own favorite theorem package. +% Option "headers" produces running heads. -\usepackage{amsmath,amsthm} +% Option "manuscript" formats the page in a way suitable for reading +% and commenting: 12 pt type, double spaced, approx. 25 lines per +% page, with approx. 72 characters per line. For filing in the Vault, +% remove that option to produce a more compact thesis with a slightly +% better layout. -\newtheorem{thm}{Theorem} -\theoremstyle{definition} -\newtheorem{defn}[thm]{Definition} % please number all of them together! +\documentclass[utopia,headers,manuscript]{ucalgmthesis} + +% We'll need some colored links, so we load xcolor and hyperref. But +% you can take that out if you don't want links at all. + +\usepackage[dvipsnames]{xcolor} % microtype makes everything look better \usepackage{microtype} -% We'll need some colored links, so we load xcolor and hyperref. But -% you can take that out if you don't want links at all. +% The hyperref package produces hyperlinks in your document. -\usepackage[dvipsnames]{xcolor} +\usepackage{hyperref} % You can turn off the boxes around links made by hyperref. Then links % will appear in a different color, and per guidelines, all links must % be blue or black. For blue links say -\usepackage[colorlinks,allcolors=MidnightBlue]{hyperref} +\hypersetup{colorlinks,allcolors=MidnightBlue} + +% For black (hidden) links, replace the above with: -% For black links, -% \usepackage[hidelinks]{hyperref} +%\hypersetup{hidelinks} + +% Note that per UCalgary's thesis guidelines, links must be blue or +% black. % If you prefer hyperref's boxes around links (which don't print), you % can also change their color. With boxes around links, you probably % don't want everything in the table of contents to be a link, so we -% only make the page numbers links. -% -% \usepackage[allbordercolors=Periwinkle,linktocpage]{hyperref} +% only make the page numbers links. This is done by using the +% following command instead: + +% \hypersetup{allbordercolors=Periwinkle,linktocpage} % The table of contents in your PDF reader's sidebar is just titles by % default, but it's nice to also have chapter and section numbers for @@ -67,9 +77,19 @@ \usepackage[numbered]{bookmark} +% Using LaTeX? Then you're probably using math, and so you want to use +% the AMS math commands and define some theorem environments! But you +% can take these out or use your own favorite theorem package. + +\usepackage{amsmath,amsthm} + +\newtheorem{thm}{Theorem}[chapter] % let's number things by chapter +\theoremstyle{definition} +\newtheorem{defn}[thm]{Definition} % please number all of them together! + % For author-year references, you probably want to use natbib with a % bibliography style appropriate for your discipline; or check out -% latexbib! +% biblatex! \usepackage[round]{natbib} \bibliographystyle{plainnat} @@ -93,7 +113,10 @@ \degree{Doctor of Philosophy} -% The name of the graduate program (not the department!) +% The full name of the graduate program (not the department!). For +% interdisciplinary degrees, the home graduate program is listed +% first, followed by the word "and," then the other graduate program +% is listed \prog{Graduate Program in Philosophy} @@ -103,7 +126,7 @@ % The year -\thesisyear{2019} +\thesisyear{2023} % Tell hyperref to put author and title into the PDF metadata @@ -128,6 +151,11 @@ % and then copy the resulting PDF to a separate file. +% Memoir by default numbers document divisions from sections up. If +% you want subsections numbered as well, uncomment the following line: + +% \maxsecnumdepth{subsection} + \begin{document} \frontmatter @@ -152,7 +180,7 @@ \include{chapter2} % The back matter includes commands to produce endnotes, index, -% glossary, bibiliography, and the like. +% glossary, bibliography, and the like. \backmatter diff --git a/macros/latex/contrib/ucalgmthesis/titlepage.tex b/macros/latex/contrib/ucalgmthesis/titlepage.tex index fcb85dff45..47110f6f9d 100644 --- a/macros/latex/contrib/ucalgmthesis/titlepage.tex +++ b/macros/latex/contrib/ucalgmthesis/titlepage.tex @@ -1,4 +1,6 @@ -% Sample University of Calgary Thesis -% This file contains the TITLE PAGE +% Sample University of Calgary Thesis + +% This file contains just the command to make the TITLE PAGE. It uses +% settings in the preamble of the main file. \makethesistitle diff --git a/macros/latex/contrib/ucalgmthesis/ucalgmthesis.cls b/macros/latex/contrib/ucalgmthesis/ucalgmthesis.cls index 3e2c691def..ca28a23fde 100644 --- a/macros/latex/contrib/ucalgmthesis/ucalgmthesis.cls +++ b/macros/latex/contrib/ucalgmthesis/ucalgmthesis.cls @@ -11,7 +11,7 @@ % Distributed under the terms of the MIT License % https://opensource.org/licenses/MIT -\ProvidesClass{ucalgmthesis}[2019/10/24 +\ProvidesClass{ucalgmthesis}[2023/03/18 University of Calgary Memoir Thesis Class] \NeedsTeXFormat{LaTeX2e}[1994/06/01] @@ -41,18 +41,19 @@ \usepackage{newtxtext,newtxmath}}} \DeclareOption{garamond} {\AtEndOfClass{\usepackage[T1]{fontenc} - \usepackage[garamond]{mathdesign} - \usepackage[osf]{garamondx} - \fixmdhrulefill}} + \usepackage{amsthm} % load amsthm before newtxmath + \usepackage{garamondx} + \usepackage[garamondx,cmbraces]{newtxmath}}} \DeclareOption{utopia} {\AtEndOfClass{\usepackage[T1]{fontenc} - \usepackage[utopia]{mathdesign} - \fixmdhrulefill}} + \usepackage{amsthm} % load amsthm before newtxmath + \usepackage{erewhon} + \usepackage[utopia,vvarbb]{newtxmath}}} \DeclareOption{libertine} {\AtEndOfClass{\usepackage[T1]{fontenc} - \usepackage{amsthm} % load amsthm before newtxmath - \usepackage{libertine} - \usepackage[libertine]{newtxmath}}} + \usepackage{amsthm} % load amsthm before newtxmath + \usepackage{libertine} + \usepackage[libertine]{newtxmath}}} % options for headings @@ -147,13 +148,13 @@ \vfill {A \@thesis} \par SUBMITTED TO THE FACULTY OF GRADUATE STUDIES \par - IN PARTIAL FULFILLMENT OF THE REQUIREMENTS FOR THE \par + IN PARTIAL FULFILMENT OF THE REQUIREMENTS FOR THE \par {DEGREE OF \@degree} \vfill \@dept \par \vfill {CALGARY, ALBERTA \par} - {{\@monthname}, {\@gradyear} \par} + {\MakeUppercase{\@monthname}, {\@gradyear} \par} \vfill {\copyright\ {\@author}~{\@gradyear} \par} \end{DoubleSpace}\end{center} @@ -201,8 +202,8 @@ \renewcommand{\cftchapterleader}{\normalfont\cftdotfill{\cftsectiondotsep}} \renewcommand{\contentsname}{Table of Contents} -% we need toc, lof, lot to begin on a new page +% We need toc, lof, lot to begin on a new page -\def\tocheadstart{\clearpage} -\def\lofheadstart{\clearpage} -\def\lotheadstart{\clearpage} +\addtodef{\tableofcontents}{\clearpage}{} +\addtodef{\listoffigures}{\clearpage}{} +\addtodef{\listoftables}{\clearpage}{} -- cgit v1.2.3