Debian Codegraph @

texmf-dist/source/latex/maine-thesis/maine-thesis.dtx

raw
1 % \iffalse meta-comment
2 %
3 % This work may be distributed and/or modified under the conditions of the
4 % LaTeX Project Public License, either version 1.3c of this license or (at
5 % your option) any later version. The latest version of this license is in
6 %
7 % http://www.latex-project.org/lppl.txt
8 %
9 % and version 1.3c or later is part of all distributions of LaTeX version
10 % 2005/12/01 or later.
11 %
12 % This work is "maintained" (as per LPPL maintenance status) by
13 % Fr. Samuel Springuel and Camden Bock.
14 %
15 % This work consists of the files maine-thesis.dtx and
16 % and the derived files maine-thesis-example.pdf,
17 % maine-thesis.dtx,
18 % maine-thesis.pdf,
19 % maine-thesis.cls
20 %
21 % The ins files is embedded in the maine-thesis.dtx.
22 %
23 %
24 %<*ignore>
25 \begingroup
26 \def\x{LaTeX2e}
27 \expandafter\endgroup
28 \ifcase 0\ifx\install y1\fi\expandafter
29 \ifx\csname processbatchFile\endcsname\relax\else1\fi
30 \ifx\fmtname\x\else 1\fi\relax
31 \else\csname fi\endcsname
32 %</ignore>
33 %<*install>
34 \input l3docstrip.tex
35 \keepsilent
36 \askforoverwritefalse
37 \preamble
38
39 This work may be distributed and/or modified under the conditions of the
40 LaTeX Project Public License, either version 1.3c of this license or (at
41 your option) any later version. The latest version of this license is in
42
43 http://www.latex-project.org/lppl.txt
44
45 and version 1.3c or later is part of all distributions of LaTeX version
46 2005/12/01 or later.
47
48 This work was originally developed by
49 rpspringuel (R. Padraic Springuel) maintained v1 on github.
50 maine-thesis and hanna.brooks updated a variety of package references for consistency with 2025 style requirements and modern citation management with biber.
51
52 This work is "maintained" (as per LPPL maintenance status) by
53 Fr. Samuel Springuel, Camden Bock, and Hanna Brooks.
54
55 This work consists of the files maine-thesis.dtx and
56 and the derived files maine-thesis-example.pdf,
57 maine-thesis.dtx,
58 maine-thesis.pdf,
59 maine-thesis.cls
60
61
62 \endpreamble
63 \postamble
64 Adapted from classic "A model .dtx file" by Joseph Wright
65 https://www.texdev.net/2009/10/06/a-model-dtx-file/
66 \endpostamble
67
68 \usedir{tex/latex/maine-thesis}
69 \generate{
70 \file{maine-thesis.cls}{\from{maine-thesis.dtx}{package}}
71 \nopreamble\nopostamble
72 \file{maine-thesis-example.tex}{\from{maine-thesis.dtx}{example}}
73 }
74
75 \Msg{*****************************************************************}%
76 \Msg{*}
77 \Msg{* To finish the installation you have to move the files into a }
78 \Msg{* TDS directory searched by TeX.}
79 \Msg{*}
80 \Msg{* To produce the documentation with source code run lualatex }%
81 \Msg{* thrice on file maine-thesis.dtx }
82 \Msg{*}
83 \Msg{* Happy TeXing!}
84 \Msg{*}
85 \Msg{*****************************************************************}%
86
87 \endbatchfile
88 %</install>
89 %<*ignore>
90 \fi
91 %</ignore>
92 %<*driver>
93 \documentclass{ltxdoc}
94 \usepackage[T1]{fontenc}
95 \usepackage{lmodern}
96 \usepackage[numbered]{hypdoc}
97 \usepackage{bookmark}
98 \usepackage{biblatex}
99 \usepackage[draft]{changes}
100
101 \usepackage{readprov}
102 \EnableCrossrefs
103 \CodelineIndex
104 \RecordChanges
105 \begin{document}
106 \DocInput{maine-thesis.dtx}
107 \end{document}
108 %</driver>
109 % \fi
110 % \renewcommand{\fileversion}{2.0.6}
111 % \renewcommand{\filedate}{2025/12/29}
112 % \makeatletter
113 % \def\@xobeysp{\leavevmode\penalty100\ }
114 % \makeatother
115 % \makeatletter
116 % \newcommand{\email}{[email protected]}
117 % \makeatother
118 % \title{^^A
119 % \textsf{maine-thesis} --- A LaTeX class file for the typesetting of a Masters or Doctorate Thesis at the University of Maine.\thanks{^^A
120 % This file describes version \fileversion, last revised \filedate.^^A
121 % }^^A
122 % }
123 % \author{
124 % Fr. Springuel, Samuel
125 % \thanks{E-mail: \href{mailto:[email protected]}{[email protected]}}
126 % \and
127 % Bock, Camden
128 % \thanks{The University of Maine; \href{mailto:[email protected]}{[email protected]}}
129 % \and
130 % Brooks, Hanna
131 % \thanks{Amherst College \& Climate Change Institute; \href{mailto:[email protected]}{[email protected]}}
132 % }
133 % \date{Released \filedate}
134 %
135 % \maketitle
136 %
137 % \begin{abstract}
138 % This class provides assistance for implementing the thesis formatting requirement of the Graduate School at the University of Maine.
139 % Upon the recommendation of their committee, students may follow the style manual of a leading journal or of a professional association for the use of field-specific terminology, formulas, signs, and other features of the text, as well as formats for documenting sources.
140 % The format requirements of the graduate school must be satisfied first, even if they depart from the style manual that has been adopted. Papers that have been published in a journal or other publication and are included in the thesis must be re-formatted to adhere to these guidelines.
141 % \end{abstract}
142 %
143 % \tableofcontents
144 %
145 % \section{Introduction}
146 % This document is not intended to be an introduction on how to use \LaTeX. In fact, I will assume that you are familiar with basic \LaTeX\ commands and have typeset documents in \LaTeX\ before throughout this document. If you haven't, then I highly suggest finding a reference book or tutorial that will teach you the basics of \LaTeX\ and read through that first. There are several options available both in print and online (e.g. \cite{Kopka:2004,Mittelbach:2004,Flynn:2005}). Which one you use is largely a matter of preference.
147 %
148 % \subsection{Installation}
149 % To install this class file you need to place it in \verb=~=/texmf/tex/latex/ where the ``\verb=~='' represents the location of your local texmf directory.\footnote{The final path should not have .../texmf/texmf/... in it, just .../texmf/...} Since this changes from system to system, I can't be more specific than that, so check the documentation for your system.
150 %
151 % \subsection{Organizing your Thesis}
152 % While not required by the class file, I have some specific recommendations as to how you should organize the tex files that make up your thesis. These recommendations are designed to make editing and distribution of drafts easier and were followed in assembling this document. While I will go into more detail about this structure as I go over the various elements of the maine-thesis.cls file and how to use them, the basic message is to break the thesis up into multiple files. In particular, the break down that I use is:
153 % \begin{description}
154 % \item[main.tex] This file has the responsibility for coordinating all the other files, but contains very little of the actual body of the thesis.
155 % \item[front.tex] This file contains all the material which appears up to and including the Table of Contents.
156 % \item[ch\#.tex] The individual chapters of your thesis. By splitting out each thesis chapter into its own file, it will be easier to find where you want to work in any particular session as well as make generating draft copies of just part of the thesis easier.
157 % \item[app\#.tex] Like the chapter files, each appendix gets its own file.
158 % \item[biography.tex] The last element of the thesis, the biography of the author also gets its own file to avoid adding clutter to Main.tex.
159 % \item[figures] Since most of the figures you use in your thesis are likely to be separate image files which \LaTeX\ will need access to when it typesets your thesis, I advise making a subfolder for your project where you can place these images. It'll make them easier to find later when you need to change them and keep the project root folder from getting too cluttered.
160 % \end{description}
161 %
162 % All of these files should be located in a single folder specifically created for this purpose. Since \LaTeX\ creates several files when typesetting documents, this will keep all those files in one place and keep them from crowding up your usual documents folders.
163 %
164 % In this documentation, I will be assuming that the above organization structure is in use. If you're using something else, you'll have to modify the instructions provided here accordingly.
165 %
166 % If you are using these guidelines, however, it is highly useful if you set main.tex as the root project file for all other files in your \LaTeX\ editor. You'll get fewer errors this way as you'll be able to order your editor to typeset the project without switching to Main.tex first, regardless of which file you're currently working on.
167 %
168 % \subsection{Organization of this document}
169 % If you've read the Table of Contents, you've no doubt noticed that each of the chapters in this document deals with one of the files listed above. In that chapter you'll find instructions for what has to be in that file. For the most part these are requirements of either the Graduate School or the maine-thesis.cls itself. Deviation from them may result in your document not typesetting correctly or in it not conforming to the Graduate School guidelines. If you follow all these instructions perfectly and the Graduate School still rejects your thesis on the basis of some formatting error, please contact me (\email) with a full description of the problem that the Graduate School had with your thesis and I will make every effort to update the class file as quickly as possible.
170 %
171 % \subsection{Reporting a Bug or Formatting Problem}
172 % If you find a bug with this class file, please create a minimal working example which reproduces the bug and email it to \email\ along with a description of the bug and any possible fixes you have tried (and whether they worked or not). For those not familiar with it, there are a couple of good descriptions on the web:
173 % \begin{itemize}
174 % \item{\url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=minxampl}}
175 % \item{\url{http://www.minimalbeispiel.de/mini-en.html}}
176 % \end{itemize}
177 %
178 % If you find a formatting problem with this class file, please create a minimal working example which reproduces the problem and email it to \email\ along with a description of the formatting problem. If the problem was pointed out to you by the Graduate School, please indicate who in the Graduate School pointed the problem so that I can consult with them directly if needed. If available, a document which demonstrates what the desired formatting looks like should also be included.
179 %
180 % For those with GitLab accounts (they are free), you can also submit formatting problems and bug reports via the GitHub repository: \url{https://gitlab.com/maine-thesis/maine-thesis}. Please open a separate issue for each problem so that they can be tracked independently and make sure to upload a minimal working example. If you have some experience with programming, you may also submit Pull Requests with suggested changes.
181 %
182 % I cannot guarantee any timeline on how quickly bugs or formatting problems will be dealt with, but I will make every effort to correct them as quickly as possible.
183 %
184 % \section{main.tex}
185 % main.tex is responsible for 5 things:
186 % \begin{enumerate}
187 % \item{the loading of the class file and any packages you need to properly typeset your thesis,}
188 % \item{the declaration of the principal variables in the thesis (author, title, advisor, etc.),}
189 % \item{coordinating which files should be typeset at this particular time,}
190 % \item{typesetting the title page of the thesis, and}
191 % \item{placing and typesetting the references according to the style file you select.}
192 % \end{enumerate}
193 % We shall deal with each of these, though not necessarily in the order listed above.
194 %
195 % \subsection{Class and Package Loading}\label{class}
196 % Like any other \LaTeX\ project, a thesis set using maine-thesis.cls must start with a declaration of the document class:
197 %
198 % \begin{verbatim}
199 % \documentclass[options]{maine-thesis}
200 % \end{verbatim}
201 %
202 % \pagebreak[3]The options are as follows:
203 % This document outlines the various options available when using the \texttt{maine-thesis.cls} document class. These options are grouped by function to help you easily configure your thesis or dissertation.
204 %
205 % \begin{macro}{10pt}
206 % This option sets the font size to 10pt. This option is allowed by the graduate school for an official copy, but is not recommended (the smaller font size doesn't convert to microfilm as well as the default).
207 % \end{macro}
208 %
209 % \begin{macro}{11pt}
210 % This option sets the font size to 11pt. This option is allowed by the graduate school for an official copy, but is not recommended (the smaller font size doesn't convert to microfilm as well as the default).
211 % \end{macro}
212 %
213 % \begin{macro}{12pt}
214 % This option sets the font size to 12pt. This is the default option, and doesn't normally need to be issued.
215 % \end{macro}
216 %
217 % \subsubsection{Number of Appendices}
218 % \begin{macro}{multiappendices}
219 % If you have more than one appendix, then you have to tell the class file this with the option \texttt{multiappendices}
220 % This is because the Graduate School requires different formatting for a document with a single appendix as opposed to one with multiple appendices (in particular as relating to lettering them and how they appear in the table of contents). By default, the class file assumes one appendix and will format it accordingly. If you have more than one, then this command will tell the class file to change to the multiple appendices format. If you don't have any appendices, then it shouldn't matter if you issue this command or not.
221 % \end{macro}
222 %
223 % \subsubsection{Document Mode}
224 % These options define the general style and layout of the document.
225 % \begin{macro}{draft}
226 % This option does a few things:
227 % \begin{itemize}
228 % \item{it marks the copy of the file as a draft by placing DRAFT in all four corners of each page (moving the page number to the bottom center if the top page style was selected),}
229 % \item{it marks any over full line with a black rectangle at the end,}
230 % \item{it allows \verb=\comment{...}= commands to show in the outside margin (right-hand normally, but if twoside is also given, then it's the left-hand margin on even pages),}
231 % \item{it places the current date in the top center of each page, and}
232 % \item{it sets the font size to 10pt to reduce the document page count and save paper.}
233 % \end{itemize}
234 % Taken together, these changes make this option useful when you want to distribute copies of your thesis (or parts thereof) to someone for feedback prior to completing it.
235 % \end{macro}
236 %
237 % \begin{macro}{oneside}
238 % This option sets the margins to allow for binding.
239 % This means the left-hand margin is enlarged to 1.5in.
240 % No other changes are made, but the larger margin leads to a reduced line length and thus different line breaking, page breaking, etc.
241 % When using this option you should review all manual page breaking decisions. Since the Graduate School no longer requires a printed copy of the thesis, this option is mostly intended for when you department requires a bound copy for themselves using the old one-sided printing rules.
242 % You might want to consult with them about the possibility of using the twoside option below in order to save paper.
243 % \end{macro}
244 %
245 % \begin{macro}{twosided}
246 % This option sets the margins to allow for binding of a two sided printing. Thus odd number pages have a larger left-hand margin while even number pages have a larger right-hand margin. Chapters (or chapter equivalent elements) will always begin on an odd page. Finally, when page numbers are at the top (pagenumbertop option), they are shifted to always be on the outside edge of the page. As with the oneside option, the change in margins will affect line breaking and therefore page breaking as compared to the official copy of the thesis. Double check any manual page breaks to make sure they are still where you want them.
247 % This option is useful for producing extra copies of your thesis that you want bound for your advisor, your committee members, yourself, or other people. When combined with the 10pt option, it will result in the most economical printing (fewest number of pages).
248 % \end{macro}
249 %
250 % \begin{macro}{unbound}
251 % This option sets the margins to equal width. This is the default option, and doesn't normally need to be issued.
252 % \end{macro}
253 %
254 % \subsection{Heading Styles}
255 % These options control the formatting and numbering of section headings.
256 % \begin{macro}{apa}
257 % This option changes the headings to follow the American Psychology Association style with one exception: italics are replaced by underlines (since italics in the headings is prohibited by the Graduate School). These heading styles are unnumbered and thus cross references using \verb=\ref= will point to just the chapter.
258 % \end{macro}
259 %
260 % \begin{macro}{chicago}
261 % This option changes the headings to follow the Chicago style guidelines. These heading styles are unnumbered and thus cross references using \verb=\ref= will point to just the chapter.
262 % \end{macro}
263 %
264 % \begin{macro}{headings}
265 % This option changes the headings to follow the example given in the Guidelines for unnumbered headings. As they are unnumbered, cross references using \verb=\ref= will point to just the chapter.
266 % \end{macro}
267 %
268 % \begin{macro}{idecimal}
269 % This option changes the headings to follow the indented decimal example given in the Guidelines.
270 % \end{macro}
271 %
272 % \begin{macro}{jdecimal}
273 % This option is the default headings system (so you don't need to give it explicitly) and matches the left-justified decimal example given in the Guidelines.
274 % \end{macro}
275 %
276 % \subsection{Caption and Spacing}
277 % These options modify the appearance of captions and line spacing.
278 % \begin{macro}{legacycaptions}
279 % Uses the previous version of caption formatting.\footnote{This may be depricated in the future.}
280 % \end{macro}
281 %
282 % \begin{macro}{loftspacing}
283 % This option introduces extra spacing between the chapters in your list of figures, and list of tables. This makes it easier to see the change between chapters at a glance in those lists, but breaks the Graduate School’s strict double-spacing requirements.
284 % \end{macro}
285 %
286 % \subsection{Page Numbering Style}
287 % These options dictate where the page numbers appear on the page.
288 % \begin{macro}{pagenumberbottom}
289 % This is the default option for the position of the page numbers. It places them in the middle of the bottom of the page.
290 % \end{macro}
291 %
292 % \begin{macro}{pagenumbertop}
293 % This option puts the page numbers in the upper right-hand corner of the page for body pages.
294 % \end{macro}
295 %
296 % \subsection{Other Options}
297 % \begin{macro}{citestyle={style}}
298 % Sets the citation style to the specified style. The default is \texttt{draft} which exposes citation keys, but you can pass any option to biblatex or biber. See biblatex and biber documentaiton for more information about citation style.
299 % \end{macro}
300
301 % \begin{macro}{citestyle={style}}
302 % Sets the bibliogrpahy style to the specified style. The default is \texttt{draft} which exposes citation keys, but you can pass any option to biblatex or biber. See biblatex and biber documentaiton for more information about citation style.
303 % \end{macro}
304 %
305 % \begin{macro}{table}
306 % Provides additional options for styling tables.
307 % \end{macro}
308 %
309 % \begin{macro}{xcdraw}
310 % Used for chemical drawing with the \texttt{xcolor} package.
311 % \end{macro}
312 % \subsection{Variable Declarations}
313 %
314 % Once you've initialized all the stuff you need to typeset your document, it's time to start adding content. Since many elements of this content get used over and over again, the class file allows for you to declare them once and then places them in all the appropriate places.
315 %
316 % \subsubsection{Describe Yourself}\label{self}
317 % The first batch of these variables that you'll declare are the title of your thesis, your name, the degrees you already hold, the degree you're going for, the specialty in which this degree is, and when you are graduating. These are declared with some fairly self explanatory commands:
318 %
319 % \begin{verbatim}
320 % \title{...}
321 % \author{...}
322 % \degreesheld{...}
323 % \degree{...}
324 % \program{...}
325 % \submitdate{...}
326 % \end{verbatim}
327 %
328 % Note that you should use \verb=\\= to separate multiple degrees if you have more than one. This will place them on separate lines (a Graduate School requirement). Also, your submit date should be ``May,'' ``August,'' or ``December'' and the appropriate year with no additional text.
329 %
330 % \subsubsection{Describe Your Committee}\label{comm}
331 % Next, you'll want to tell the class file about your committee. To do this, you'll need each committee member's full name and title (i.e. Ph.D., faculty position, etc., as in ``John Smith, Ph.D., Associate Professor of Interesting Stuff''). Each member is declared with a separate command (use only the ones you need):
332 %
333 % \begin{verbatim}
334 % \principaladvisor[...]{...}
335 % \secondadvisor{...}
336 %
337 % \firstreader{...}
338 % \secondreader{...}
339 % \thirdreader{...}
340 % \fourthreader{...}
341 % \fifthreader{...}
342 % \end{verbatim}
343 %
344 % \begin{macro}{\title\{...\}}
345 % The title of your dissertation in inverted pyramid format. Use line breaks to ensure that your title is shaped as an inverted pyrmid if multiple lines.
346 % \end{macro}
347 %
348 % \begin{macro}{\author\{...\}}
349 % Your name
350 % \end{macro}
351 %
352 % \begin{macro}{\degreesheld\{...\}}
353 % Degrees that you currently hold, with institutions listed.
354 % Use line breaks as needed
355 % \end{macro}
356 %
357 % \begin{macro}{\degree\{...\}}
358 % The name of your degree (e.g., Masters of Science)
359 % \end{macro}
360 %
361 % \begin{macro}{\program\{...\}}
362 % The name of your degree program
363 % \end{macro}
364 %
365 % \begin{macro}{\submitdate\{...\}}
366 % The date of submission (May, Dec or Aug) and the Year
367 % \end{macro}
368 %
369 % \begin{macro}{\principaladvisor[...]\{...\}}
370 % The name of your principal advisor. Short title in square brackets, full title in braces.
371 % \end{macro}
372 %
373 % \begin{macro}{\firstreader\{...\}}
374 % The name of your first committee member, who is not an advisor.
375 % \end{macro}
376 % Note that these commands are order sensitive as the class file uses the last one called to determine the number of committee members. I.e. if you call \verb=\thirdreader{...}= after \verb=\fifthreader{...}= then the class file will think that you have 3 committee members beyond your advisor(s) rather than 5.
377 %
378 % If this automatic numbering of your committee isn't working for some reason, then there are two commands which you can issue after the members list to override the behavior: \verb=\twoadvisors=, \verb=\oneadvisor= and \verb=\members{#}=. The first is used to change the number of advisors to two, the second sets it to one (one advisor is the default for the class file). The last tells the class file how many members your committee has (not including your advisor(s)). If you find that you have to issue these commands, please send me a minimal working example that duplicates the problem you experienced so that I can fix it.
379 %
380 % In a couple of locations, the thesis requires the ``short'' name for your advisor. In this case, the advisor's title should simply be ``Dr.'' (or whatever is appropriate) and should precede their name (as in ``Dr.~John Smith''). This short name can be defined in two ways. If you have just one advisor, then you can make use of the first (optional) argument of \verb=\prinicpaladvisor= (the one appearing between the square brackets):
381 %
382 % \begin{verbatim}
383 % \principaladvisor[Dr.~John Smith]{John Smith, Ph.D., Associate Professor of Interesting Stuff}
384 % \end{verbatim}
385 %
386 % If you have two advisors, then you should leave out the first argument for \verb=\prinicpaladvisor= and use the command \verb=\prinicpalshort= instead. For this command both names should appear as the argument to the command with their short titles separate:
387 %
388 % \begin{verbatim}
389 % \principaladvisor{John Smith, Ph.D., Associate Professor of Interesting Stuff}
390 % \secondadvisor{Jane Doe, Ph.D., Professor of More Interesting Stuff}
391 % \principalshort{Dr.~John Smith and Dr.~Jane Doe}
392 % \end{verbatim}
393 %
394 %
395 % \subsubsection{Document Type}
396 % By default, the class file will refer to your document as a dissertation. If your degree program refers to it as a thesis or project, then you'll want to tell the class file that. The command \verb=\thesis= will change all occurrences of ``dissertation'' to ``thesis'' and \verb=\project= will change them to ``project.''
397 %
398 % \subsection{Title page}
399 %
400 % Now that all the variables are declared, it's time to start the document itself. This consists of three commands:
401 %
402 % \begin{verbatim}
403 % \begin{document}
404 % \preliminary
405 % \maketitle
406 % \end{verbatim}
407 %
408 % \begin{macro}{\preliminary}
409 % This command in \texttt{main.tex} prepares the document for the preliminary pages, such as the abstract and table of contents, which are typically numbered with Roman numerals.
410 % \end{macro}
411 %
412 % \begin{macro}{\mainmatter}
413 % This command is used in \texttt{main.tex} to signal the start of the main content of your thesis. It resets page numbering and changes the numbering style from Roman to Arabic.
414 % \end{macro}
415 % \begin{macro}{\references}
416 % This command automatically generates and formats your bibliography section using the entries in \texttt{references.bib} that have been cited in the document.
417 % \end{macro}
418 %
419 % The first is the usual command that tells \LaTeX\ where the document starts. The second tells the class file that what comes next is the front matter of the thesis. This means that pages should be numbered with lowercase roman numerals. The last command creates the title page. Putting it here ensures that every copy of your thesis that you create will include a copy of the title page, making it easier to identify the document (especially important when you're handing out bits and pieces).
420 %
421 % After the title page, it's time to include the rest of the preliminary material, but I don't suggest putting all of that in Main.tex. Instead, all of that should be put in Front.tex, a process which gets us to our next job for Main.tex: coordinating which files are to be processed at this time.
422 %
423 % \subsection{File Coordination}
424 % Chances are pretty good that your final thesis will be close to, if not well over, 100 pages. If all of that material were in a single file, finding where it is you want to edit something can be difficult. To make this easier, \LaTeX\ allows you to split the document up into multiple files and then use the \verb=\include{...}= statement to tell the main file to add the contents of another file at this point. We're going to make use of that here. First off, we'll place all the front matter (copyright page, dissertation acceptance statement, library rights statement, abstract(s), preface, dedication, acknowledgements, and table of contents):
425 %
426 % \begin{verbatim}
427 % \include{Front}
428 % \end{verbatim}
429 %
430 % Next comes the main body of the thesis, which is just a bunch of \verb=\include{...}= statements: one for each chapter:
431 %
432 % \begin{verbatim}
433 % \include{Ch1}
434 % \include{Ch2}
435 % \include{Ch3}
436 % ...
437 % ...
438 % ...
439 % \end{verbatim}
440 %
441 % \subsection{Bibliography}\label{bib}
442 % After the main body of the thesis, it's time to set the bibliography. It should be noted that the Graduate School requires a single, all inclusive bibliography for your thesis, even if each chapter has its own bibliography.
443 %
444 % Since citation styles and the required contents of the bibliography can vary dramatically from discipline to discipline, the Graduate School has no specific requirements for the this subsection. As a result, this class file contains no formatting specifications for the subsection beyond the margins and line spacing.
445 %
446 % By default the name of this subsection is ``REFERENCES'' but you can change it to ``WORKS CITED,'' ``BIBLIOGRAPHY,'' or whatever is customary for your discipline. To do so you'll need to redefine the command \verb=\bibname=. For example \verb=\renewcommand{\bibname}{Works Cited}= will change the name to ``WORKS CITED'' (capitalization is enforced by the class file, so you don't need to worry about it when redefining \verb=\bibname=). \textbf{This is a change from how the class file used to work.} This change serves to bring the class file more in line with usual \LaTeX\ expectations so that packages like babel will work more smoothly with the class file.
447 %
448 % There are two ways of handling your bibliography: with \textsc{BibLaTeX} and by hand.
449 %
450 % \subsubsection{\textsc{BibLaTeX}}
451 % If you're using \textsc{BibLaTeX} then you'll need to set several external parameters which tell the class file how to find and format the references. Do do this use the following series of commands:
452 %
453 % \begin{verbatim}
454 % \addbibresource{references.bib}
455 % \end{verbatim}
456 %
457 % The \texttt{addbibresource} command tells the class file where the bibliography entries are located. This should be a \textsc{Bib}\TeX\ file (i.e. one with a ``.bib'' extension).
458 % Many popular editors (like Overleaf) can integrate with popular reference management tools (Zotero) and sync with your collection. \href{https://www.overleaf.com/learn/latex/Bibliography_management_with_biblatex}{Some initial guidance from Overelaf.}
459 %
460 % Use the citestyle option for the class to indicate the style the list should follow. There are a few styles built into \textsc{Biblatex} by default (apa, authoryear, alphabetic, numeric) but there are also countless bibliography styles out there that can achieve alternate formats. Consult with your advisor and committee about which bibliography style you should be using.
461 %
462 % Don't forget that if you're using \textsc{Bib}\TeX\ you'll need to process your document at least 4 times for it to come out right: once with \LaTeX, once with \textsc{Bib}\TeX, and twice more with \LaTeX.
463 % Processing with latexmk can automate this.
464 %
465 % \subsubsection{Bibliographies by hand}
466 % If you've elected to create your bibliography by hand then you simply need to use:
467 % \begin{verbatim}
468 % \begin{thebibliography}{...}
469 % ...
470 % ...
471 % ...
472 % \end{thebibliography}
473 % \end{verbatim}
474 % Since the contents and format of this environment is covered in most \LaTeX\ manuals (e.g. subsection 11.3.1 in \cite{Kopka:2004}), I'm not going to go over it here. Note that the same issue that effects \verb=\references= applies to this environment.
475 %
476 % \subsection{More File Coordination}
477 %
478 % Having taken care of the bibliography, it's time to work on the appendices:
479 %
480 % \begin{macro}{appendices}
481 % The appendicies environment should wrap all of the chapters included in the appendix. The legacy \texttt{\textbackslash appendix} command still functions properly with limited support.
482 % \end{macro}
483 % \begin{verbatim}
484 % \begin{appendices}
485 % \include{AppA}
486 % \include{AppB}
487 % ...
488 % ...
489 % ...
490 % \end{appendices}
491 % \end{verbatim}
492 %
493 % The first command resets the chapter counter and changes it from numbers to letters. This means that from now on the \verb=\chapter{...}= command will create ``Appendix *'' (where ``*'' is A, B, C, etc.) rather than ``Chapter \#'' (where ``\#'' is 1, 2, 3, etc.). It is necessary even if you have only one appendix (and thus don't want it lettered).\footnote{If your document has only one appendix, then the letter is left off completely and it is simply designated ``Appendix''.} The subsequent commands point to and allow the inclusion of the various appendix files.
494 %
495 % \subsection{Biography}\label{bio}
496 % After the list of appendix inclusions you'll need to write your biography. According to the graduate school the requirements for the biography are as follows:
497 % \begin{quote}
498 % A biography of the candidate must be included in the thesis. It must be written in the
499 % third person and include the following information: place of birth, place of high school gradua-
500 % tion, place and date of college graduation with degree(s) and major(s), professional or
501 % employment experience, scholarly publications, and memberships in professional or honorary
502 % societies. The last sentence must state, "S/He is a candidate for the---------degree in ------- from
503 % The University of Maine in Month, Year."
504 % \end{quote}
505 % \begin{macro}{biography}
506 % This environment is for the author's biography. The content for this section is located in \texttt{front/biography.tex}.
507 % \end{macro}
508 % Obviously these are some very stringent requirements, but even so there is still a substantial amount of variation that might be introduced into any given biography so it's left up to you to write all but the last sentence of the biography (which has such specific required wording that the class file can do it for you). To format your biography correctly, it should be placed between \verb=\begin{biography}= and \verb=\end{biography}=. You might also consider placing it in a separate file which you then include (as I've done in this document) so that you can exclude it from draft copies of the thesis.
509 %
510 % By default, the class file will use your full name (as defined by the \verb=\author= command in the last sentence. This is allowed by the graduate school, but if you prefer to use a pronoun (as is suggested in the above requirements) then you should make use of the \verb=\authorpronoun= command to indicate what your preferred pronoun is. It is recommended that you place this command in the preamble of the document along side the \verb=\author= command, but technically it can appear anywhere before the biography environment.
511 %
512 % Since the biography is required to be the last page of your thesis, the only command that should appear after it in your document is \verb=\end{document}=, which will tell \LaTeX\ that the document is finished.
513 %
514 %
515 % \subsection{Using the File Coordination}\label{coord}
516 %
517 % In addition to breaking your thesis up into multiple smaller files, the \verb=\include{...}= statements enable another feature of \LaTeX\ that should make your life much easier.
518 %
519 % Let's say during the editing process your committee requires you to make changes to chapter 3 but not any of the rest of the document. Once you've made those changes, do you have to retypeset the whole document and give it all to your committee just so they can approve those changes? Thanks to the \verb=\include{...}= statements, the answer is no. Simply introduce the command \verb=\includeonly{Ch3}= into the preamble of your document (somewhere before \verb=\begin{document}=, I suggest just after the packages are loaded) and \LaTeX\ will only process chapter 3, but will look at the aux files for the other chapters so that any reference commands point to the right place. This will create a document which consists of the title page, chapter 3, and the reference list: a much smaller and easier file to be handing out to your committee. By changing the argument of this command you can control which chapter (or appendix) is typeset and can even typeset more than one (simply separate each file name by a comma as in ``Ch2,Ch3,AppA'' which will typeset chapters 2 and 3 and appendix A). Once you're ready to typeset the whole document again, simply delete the \verb=\includeonly{...}= command.
520 %
521 % It should be noted that \verb=\include{...}= not only adds the contents of the specified file to this one, it also starts a new page both before and after the file is read in (the equivalent of issuing \verb=\clearpage=). As a result, you should only use it on files that should start and end on their own pages (like chapters) and not with those that can share their page space with something else (like a subsection in a chapter). As with spaces and carriage returns, \LaTeX\ always ignores multiple commands to start a new page in a row so two \verb=\include{...}= statements in a row won't create a blank page in between. If you have to place in a separate file some material which shouldn't automatically start and end its own page, you'll need to use \verb=\input{...}= instead and there is no equivalent to \verb=\includeonly{...}= for \verb=\input{...}=.
522 % \section{Front.tex}
523 %
524 % The front matter of your thesis is primarily made up of special things that are required by the Graduate School, but also contains some optional elements. Table \ref{front} provides a summary of these elements.
525 %
526 % \begin{table}
527 % \begin{minipage}{\textwidth}
528 % \centering
529 % \begin{tabular*}{\textwidth}{l@{\extracolsep{\fill}}r}
530 % \hline\hline
531 % Thesis Element & Required or Optional\\
532 % \hline
533 % Copyright Page & Optional\\
534 % Abstract & Required\\
535 % Lay Abstract & Special\footnote{See subsection \ref{abstracts}}\\
536 % Preface & Optional\\
537 % Dedication & Optional\\
538 % Acknowledgements & Optional\\
539 % Table of Contents & Required\\
540 % \hline\hline
541 % \end{tabular*}\\
542 % \end{minipage}
543 % \caption{The elements of the front matter for your thesis.}
544 % \label{front}
545 % \end{table}
546 %
547 % \subsection{Copyright}\label{copy}
548 %
549 % \begin{verbatim}
550 % \copyrightpage[copyright holder]{year}
551 % \end{verbatim}
552 %
553 % This command creates a copyright page. This page is optional (unless you've taken the time to register the copyright, in which case it's required by law, not the Graduate School), so you can neglect this page if you want to. If you do issue it, there are a pair of arguments that it takes. The first (between ``['' and ``]'') specifies the copyright holder. This argument can be left off completely (in which case the ``['' and ``]'' are also not necessary) and will default to you, the author. The second argument is required and declares the year of the copyright. If parts of your thesis were supported by grants or were previously published, you should consult with your advisor and the prior publishers to make sure that you specify these arguments correctly before including this page.
554 %
555 % \textbf{Note:} In 2016 (v1.12 of this class file) the Graduate School switched to an electronic thesis submission process and eliminated the Dissertation Acceptance and Library Rights Statement pages which had previously surrounded the Copyright page. If you are recompiling an older thesis which contains these pages, then you will need to use earlier version of the class file.
556 %
557 % \subsection{University of Maine Graduate School Land Acknowledgment}\label{glsa}
558 % \begin{macro}{\glsa}
559 % This command creates the University of Maine Graduate School Land Acknowledgment. This page is optional and takes no parameters. The land acknowledgment should be after the copyright page, as shown by the thesis template made by the Graduate School.
560 % \end{macro}
561 %
562 % \subsection{Abstracts}\label{abstracts}
563 % \begin{macro}{abstract}
564 % This environment defines the abstract section. The \texttt{\textbackslash input} command is used to pull the content of your abstract from the \texttt{front/abstract.tex} file.
565 % \end{macro}
566 % The graduate requires two abstracts, but only one has to appear in the bound dissertation.
567 %
568 % This first abstract is the usual abstract you would write for a scholarly journal in your field. This is the abstract that must be in the bound thesis. It should be limited to 500 words for a Master's Thesis and 350 words for a Doctoral Thesis. It cannot contain formulas, tables, diagrams, or other illustrations. Typesetting your abstract is accomplished with the ``abstract'' environment:
569
570 % \begin{verbatim}
571 % \begin{abstract}
572 % ...
573 % ...
574 % ...
575 % \end{abstract}
576 % \end{verbatim}
577 %
578 % \begin{macro}{layabstract}
579 % The second abstract is one suitable for a lay audience. This abstract is limited to 350 words regardless of the kind of degree you're getting and should not contain highly technical language. It should be written with the expectation that the reader will have only minimal knowledge of your field as it may be ``submitted [...] for publication in newspapers, magazines, and other media of
580 % interest to the general public, and it may be used in selecting nominees for regional and
581 % national competitions.'' It must be accompanied by at least 5 keywords (for search engines to pick up on, presumably) and it may contain 1 (and only 1) image. If you didn't create said image, then you need permission of the copyright holder to use it.
582 %
583 % This abstract doesn't have to be bound with your thesis, but must be submitted electronically to [email protected]. When submitting this abstract, a Word document that is formated correctly is preferred due to some copy/paste peculiarities between Adobe Reader and the form the grad school uses to upload the file to the web. If you don't have access to Word, however, you can get away with a pdf version. This pdf version can be generated by this class file with the ``layabstract'' environment; the same environment you'd use to generate the lay abstract for inclusion in the bound copy:
584 % \end{macro}
585 %
586 % \begin{verbatim}
587 % \begin{layabstract}{...}
588 % ...
589 % ...
590 % ...
591 % \end{layabstract}
592 % \end{verbatim}
593 %
594 % In this case, the environment argument is the list of keywords, while the body of the abstract should be within between the environment commands. If you do include an image, do not enclose it within a figure environment as it should not appear in the List of Figures.
595 %
596 % \section{Dedication}
597 % \begin{macro}{\dedication}
598 % This optional environment is for your thesis dedication. The dedication text is written in \texttt{front/dedication.tex}.
599 % \end{macro}
600
601 % If there is some person (or group of persons) to whom you want to dedicate your thesis, then you'll need to use the dedication environment. This should be short, and is optional:
602 % \begin{verbatim}
603 % \begin{dedication}
604 % ...
605 % \end{dedication}
606 % \end{verbatim}
607 %
608 % \subsection{Preface}
609 % \begin{macro}{preface}
610 % If you want to include a preface to your thesis then you typeset it with the preface environment. This can be long or short and is optional.
611 %
612 % \begin{verbatim}
613 % \begin{preface}
614 % ...
615 % ...
616 % ...
617 % \end{preface}
618 % \end{verbatim}
619 % \end{macro}
620 %
621 % \paragraph{Note:}The document structure within the Preface is unnumbered (a Graduate School requirement).
622 %
623 % \subsection{Acknowledgements}
624 % While considered optional by the Graduate School, the acknowledgments are the appropriate place to mention funding sources, collaborators, and anyone who helped with the writing or revision of your thesis. They are typeset with the acknowledgements environment:
625 %
626 % \begin{macro}{acknowledgements}
627 % This optional environment is for your acknowledgements. The acknowledgements text is written in \texttt{front/acknowledgements.tex}.
628 % \end{macro}
629 %
630 % \begin{verbatim}
631 % \begin{acknowledgements}
632 % ...
633 % ...
634 % ...
635 % \end{acknowledgements}
636 % \end{verbatim}
637 %
638 % \subsection{Table of Contents}
639 % The last element of the front matter is the table of contents. This actually consists of several lists, the first of which is actually called ``Table of Contents'' and contains the name and page numbers of chapters, subsections, subsubsections, and chapter-like elements. The other lists are all pseudo-optional. If they would be populated (i.e. if you have tables or figures), then they need to be there. If they are empty, then you can leave the empty list off. Typesetting these lists is handled with a series of commands:
640 %
641 % \begin{verbatim}
642 % \tableofcontents
643 % \listoftables
644 % \listoffigures
645 % \end{verbatim}
646 %
647 % In addition, the Graduate School requires you to have other lists for ``a consistent set of theorems, symbols, abbreviations or definitions'' should such a set appear in your thesis. Some packages add \verb=\listof*= commands to create and auto-populate the list for the element that they are support just like \verb=\listoftables= and \verb=\listoffigures= do for tables and figures. If so, you should probably use said command as it will make your life much easier (though pay attention to the formatting that the command creates, you may need to modify it manually). However, for those instances where the package doesn't do so, there is a ``listof'' environment which you can use to manually create such a page:
648 %
649 % \begin{verbatim}
650 % \begin{listof}{...}
651 % ...
652 % ...
653 % ...
654 % \end{listof}
655 % \end{verbatim}
656 %
657 % \subsection{File Close}
658 % The second to last line that should be in your Front file signals the start of the main body of the thesis with the command \verb=\mainmatter=. This resets the page numbering, changes it to arabic numerals, switches to double spacing, and adds the word ``Chapter'' to your table of contents before your first chapter.
659 %
660 % Since this isn't strictly creating a piece of the front matter of your thesis it might seem more logical to put this command in Main.tex after \verb=\include{Front}=, however, this command suffers from the same bug that effects \verb=\references=. However, since this command comes first in the document, it appears to be subject to it more reliably. Putting the command at the end of Front.tex dodges that bug (as would placing it at the beginning of Ch1.tex). It's not elegant, but it works.
661 %
662 % The last line of Front.tex is \verb=\endinput=. This command isn't technically necessary (i.e. your document will typeset just fine without it), but it is good programming practice to include it. If it is used, then anything that appears after it will be ignored by \LaTeX, making it a great way to create a scratch space at the end of each file where you can write notes to yourself. You don't even have to comment them out!
663 % \section{Chapters and Appendices}
664 %
665 % \subsection{Chapters}
666 % While the chapters are probably the hardest part of the thesis for you to actually write, the class file requires very little in each chapter. Each chapter file should open with \verb=\chapter{...}= and close with \verb=\endinput=. In between is largely up to you, but there are a few things to keep in mind.
667 %
668 % You cannot use \verb=\include{...}= inside chapters because they are already included files. If you want to breakup a long chapter into multiple files, use \verb=\input{...}= instead. Note that there is no \verb=\input{...}= equivalent to \verb=\includeonly{...}=. Every file inside an \verb=\input{...}= command will be processed every time.
669 %
670 % Figures and tables should be inside the figure and table environments, respectively, so that they are automatically inserted into the list of figures or tables. If the caption for a figure or table is particularly long, I also recommend using the optional argument in the \verb=\caption[...]{...}= command to create a short version of the caption that will appear in the table of contents.
671 %
672 % Footnotes inside figures or tables will be captured by the figure or table environment and thus won't appear anywhere in the document. There are several possible solutions for this problem, none of which are implemented by this class file, so if you want to put footnotes in your table, look into it.
673 %
674 % \subsection{Appendices}
675 % The file that contains an appendix looks just like a file that contains a chapter. It starts with \verb=\chapter{...}= and ends with \verb=\endinput=.
676 %
677 % \subsection{Headings}
678 % There are 5 levels of headings within a chapter or appendix: subsection, subsubsection, subsubsubsection, paragraph, and subparagraph. To create a heading (and start a new element at the appropriate level) simply issue the appropriate command (\verb=\subsection=, \verb=\subsubsection=, etc.). By default headings are numbered down to the subsubsubsection level using a decimal system (<Chapter \#>.<subsection \#>.<Sub\-sec\-tion \#>.<Sub\-sub\-sec\-tion \#>). You can change the depth to which headings are numbered with the command \verb=\setcounter{secnumdepth}{#}=. The argument should be a number between 0 (no headings are numbered) and 5 (all headings down to the subparagraph level are numbered). This command can be issued at anytime in your document and will affect the numbering from that point forward.
679 %
680 % In addition to the options described in subsection \ref{class} which automatically change the format of the headings to match a specific style, it is possible to manually change the formats by redefining the following commands:
681 % \begin{verbatim}
682 % \subsectionstyle
683 % \subsubsectionstyle
684 % \subsubsubsectionstyle
685 % \paragraphstyle
686 % \subparagraphstyle
687 % \end{verbatim}
688 % These commands should take no arguments and consist purely of formating commands (it is up to you to provide any punctuation a style might demand in the heading name itself). As an example, if you wanted to make subsection headings be underlined and boldfaced, you would need to issue the following command in your preamble:
689 % \begin{verbatim}
690 % \renewcommand*{\subsectionstyle}{\bfseries\underline}
691 % \end{verbatim}
692 % If manually redefining the heading styles, remember that the Graduate School prohibits italics in headings.
693 %
694 % Similarly there exist the following lengths which can be used to redefine where the text starts after a heading:
695 % \begin{verbatim}
696 % \subsectionpost
697 % \subsubsectionpost
698 % \subsubsubsectionpost
699 % \paragraphpost
700 % \subparagraphpost
701 % \end{verbatim}
702 % These lengths should be altered in the preamble with a \verb=\setlength= command. If the value the lengths are set to is positive, then they represent the vertical distance between the header and the first paragraph which follows (and should probably be a rubber length to give \LaTeX\ some wiggle room in making things fit on a page). If they are negative then the absolute value represents the horizontal distance between the header and the first word of the paragraph which follows (and should probably be a fixed length). For example, the lengths for APA style headings are positive (and rubber) for \verb=\subsectionpost= and \verb=\subsubsectionpost=, but negative (and fixed) for the other three. This places subsection and subsubsection headers on their own line, but subsubsubsection, paragraph, and subparagraph headers are on the same line as the text which follows them. On the other hand, the default style uses positive (and rubber) lengths for \verb=\subsectionpost=, \verb=\subsubsectionpost=, and \verb=\subsubsubsectionpost=, but negative (and fixed) lengths for \verb=\paragraphpost= and \verb=\subparagraphpost=.
703 %
704 % For more on the difference between rubber and fixed lengths, consult your \LaTeX\ reference book of choice.
705 % \section{Other Stuff}
706 % \subsection{\textbackslash ignore}
707 % The command \verb=\ignore{...}= which is very useful for removing large blocks of text from the thesis without deleting them. Anything within the argument is treated as if it was commented out and will not appear in the typeset document.
708 %
709 % \subsection{\textbackslash toclabel}
710 % If you need to add a label into your table of contents then you can use the command \verb=\toclabel{...}= to do so. Due to a bug in the \LaTeX\ kernel that effects this command you may need to put the command inside a chapter file rather than in Main.tex. Otherwise the label may not end up in the correct place in the TOC.
711 %
712 % \subsection{\textbackslash compresstitlepage}
713 % In rare cases your title page may spill over onto a second page when typeset with double line spacing (generally due to a long title, many previous degrees, or committee members with long/multiple titles). When this happens, issue the command \verb=\compresstitlepage= in your preamble. This will change the line spacing for the committee members to single line spacing. If that isn't enough to get your title page onto one page, add the optional argument (``[2]'') to change the spacing for the rest of the title page to one-and-a-half spacing.\comment{There is another comment here.}
714 %
715 % \subsection{verbatim and \textbackslash verb}
716 % Since the Graduate School doesn't want the font to change during the course of the document, the verbatim environment and the \verb=\verb= command have had their font changed from the standard typewriter font of \LaTeX\ to the normal roman font. This required a change to the font encoding to get what you type in the verbatim environment to be the same characters that appear on the page. As a result, the mapping of quotation marks, ", to close double quotes, '', doesn't work. To get '' you will need to type two close quotation marks, '\,', just like you have to type two two open quotation marks, `\,`, to get the double open quotes, ``.
717 %
718 % \begin{macro}{\input}
719 % This is a fundamental command used throughout the template to import the content of another \texttt{.tex} file into the current document.
720 % \end{macro}
721 %
722 % \begin{macro}{blindtext}
723 % Commands from the \texttt{blindtext} package are used for generating placeholder text, lists, and mathematical formulas. They are a helpful way to visualize the final layout of the document before adding your own content.
724 % \end{macro}
725 %
726 % \begin{macro}{changes}
727 % These commands from the \texttt{changes} package are very helpful for communicating and reviewing changes between versions in draft mode. See the \texttt{changes} package documentation for more information.
728 % \begin{itemize}
729 % \item comment
730 % \item highlight
731 % \item added
732 % \item deleted
733 % \item replaced
734 % \end{itemize}
735 % \end{macro}
736 %
737 % \subsubsection{\textbackslash comment}
738 % There is also a \verb=\comment{...}= command. If the draft option was issued to the class file, the argument of this command will appear in the right hand margin in red with ``NOTE:'' preceding it in a smaller font (as can be seen in this file if you typeset it in draft mode). This makes it useful for adding reminders to yourself about things you still need to do, or questions for your advisor when you're asking him to review a draft version of something. Without the draft option this command functions identically to \verb=\ignore=.\comment{There is a comment here.}
739 %
740 % \subsubsection{\textbackslash highlight}
741 % The \verb=\highlight= command is a useful companion to \verb=\comment=. In draft mode it will highlight its argument (i.e., give it a yellow background). In final mode, the text appears normally.
742 %
743 % \begin{macro}{\caption[...]\{...\}}
744 % This command adds a caption to a figure or table. The optional argument in square brackets provides a short title for the List of Figures/Tables, and the mandatory \texttt{...} provides the full caption text.
745 % \end{macro}
746 %
747 % \begin{macro}{\citep}
748 % This command from biblatex is used for in-text citations. The argument is the citation key from your \texttt{references.bib} file. See biblatex and biber for more information about citation styles.
749 % Biblatex generally intergrates well with reference managers for consistent citations. Other commands are available for providing author or year seperately in text, or for numeric and other citation styles.
750 % \end{macro}
751 %
752 % \subsection{Widows and Clubs}
753 % The graduate school requires that page breaks occur so that at least 3 lines of any paragraph are on a page. Thus, if a paragraph starts on a certain page at least the first three lines of that paragraph should be on that page. Likewise, if a paragraph ends on a page at least the last three lines of that paragraph should be on that page. This is an unusually stringent requirement for clubs (paragraph starts at the end of a page) and widows (paragraph ends at the beginning of a page) and one which is impossible to force \LaTeX\ to respect. The club penalty and widow penalty have been set high to large values so that at least two lines of each paragraph should appear on each page, but if the graduate school starts bugging you about this, you are going to have to play with this manually using \verb=\pagebreak= and \verb=\nopagebreak=. Do this only when preparing the \textit{absolutely final copy} of the thesis as said manual breaks will stick around despite any subsequent edits to the document.
754 %
755 % Likewise, the Graduate School has similar standards for the table of contents: at least 3 entries from any given chapter must be on the page (unless the chapter has fewer than 3 entries, in which case all entries should appear on the same page). I've done my best to make sure this happens, but I can't possibly test every possible pattern of chapters, subsections, and subsubsections that you might have. If the graduate school is bugging you about this, then place \verb=\addtocontents{toc}{\protect\pagebreak}= just before a chapter, subsection, or subsubsection to manually insert a page break into that position in your table of contents. This command can likewise be used to manually insert page breaks into the list of figures (lof) or the list of tables (lot) by changing the first argument. It also will run into the same bug that effects \verb=\references=. See subsection \ref{bib} for more details. If you do have to do this, I'd also appreciate a minimal working example so that I can try to further fine tune the class file's ability to do this automatically.
756 %
757 % \subsection{Thesis in a Foreign Language}
758 % The class file has not been tested on a thesis written in a foreign language and thus its behavior on such documents is not guaranteed. Support for these kinds of documents is planned for a future version, but probably won't come until 2019 at the earliest. Contributions designed to make the class file work with foreign language theses are appreciated: \[email protected]=.
759 %
760 % \subsection{Hyphenation \& Justification}
761 % At the graduate school request, automatic hyphenation is turned off and the document should be set left justified (\verb=\raggedright= in LaTeX parlance). If this creates strange behavior for you, please let me know so that any possible bugs can be resolved.
762 %
763 % \subsection{5-dot Leader Minimum in TOC}
764 % As of v1.10 the this requirement should be obeyed automatically. If you run into problems here please report it to me (\email). As a work around, you can fix this manually by either changing the appropriate title/caption, or by making use of the optional short title/caption built into the appropriate command.
765 %
766 % \section{Other Packages}
767 % \label{package}
768 % This appendix lists the packages which have interesting behavior when used along side maine-thesis.cls. If you find a package that creates difficulties which isn't listed here, please email me the name of the package, the version you have, and the particular difficulty that you encountered.
769 %
770 % \subsection{Working Packages}
771 % While not thoroughly tested, the following packages have been used with this class file without incident:
772 % \begin{itemize}
773 % \item{acronym (v1.35, last revised 2009/10/20)}
774 % \item{epic (v1.2, last revised 1986/06/01)}
775 % \item{epstopdf (v2.5, last revised 2010/02/09)}
776 % \item{excludeonly (v1.0, last revised 2003/03/14)}
777 % \item{graphics (v1.0o, last revised 2009/02/05)}
778 % \item{graphicx (v1.0f, last revised 1999/02/16)}
779 % \item{hhline (v2.03, last revised 1994/05/23)}
780 % \item{natbib (v8.31a, last revised 2009/11/07)}
781 % \item{pdfpages (v0.4j, last revised 2010/01/12)}
782 % \item{tabularx (v2.07, last revised 1999/01/07)}
783 % \item{tabulary (v0.9, last revised 2008/12/01)}
784 % \item{float (v1.3d, last revised 2001/11/08)}
785 % \item{subfig.sty (1.3, last revised 2005/06/28)\footnote{\emph{Note:} If you use the subfig package, the following warning will be raised: ``Package caption Warning: Unsupported document class (or package) detected, usage of the caption package is not recommended.'' It should be safe to ignore this warning, if you don't use any other packages which manipulate the caption command. For anything beyond that, I can't make any guarantees on what will work and what won’t.}}
786 % \end{itemize}
787 % If you experience a problem with any of these packages please make sure you have the version listed above or a more recent one before submitting a bug report.
788 %
789 % If you use a package other than one of the ones listed above without incident, please email me (\email) the package name and version so that I can add it to the above list.
790 %
791 % \subsection{caption}
792 % This class file already formats captions for figures and tables according the requirements of the Graduate School. As a result, the caption package, which allows you to manipulate how these elements appear, should not be used.
793 %
794 % \subsection{color}
795 % The class file uses this package to color the \verb=\comment= command in draft mode. As a result, any attempt to load this package with options by using \verb=\usepackage= will result in an option clash error. Instead, pass whatever options for color you want to the class file and they will automatically be passed along to color when it is loaded.
796 %
797 % The class file was tested with v1.0j, last revised 2005/11/14. If you're having problems with color, make sure you have this version or a more recent one before submitting a bug report.
798 %
799 % \subsection{footmisc}
800 % The class file uses this package to eliminate the usual rule that occurs between the body of the text and the footnotes at the bottom of the page. As a result, any attempt to load this package with options by using \verb=\usepackage= will result in an option clash error. Instead, pass whatever options for footmisc you want to the class file and they will automatically be passed along to footmisc when it is loaded.
801 %
802 % The class file was tested with v5.5a, last revised 2009/09/15. If you're having problems with footmisc, make sure you have this version or a more recent one before submitting a bug report.
803 %
804 % \subsection{hyperref}
805 % The hyperref package can be used to create many links within your document, making the digital copy easier to navigate. When links are created in the document, they can be highlighted in a variety of ways: colored boxes around the text, colored text, and small capitals. While these are necessary indicators of the presence of the link in an electronic document, they should not appear in the printed copy. As a result, you are advised to turn hyperref (comment out the load command) when typesetting the file for printing purposes. When you go back to typesetting with hyperlinks, you are likely going to need to trash the auxilarly (aux, toc, lof, lot, etc.) files to get the document to typeset correctly.
806 %
807 % The class file was tested with v6.80n, last revised 2010/03/11. If you're having problems with hyperref, make sure you have this version or a more recent one before submitting a bug report.
808 %
809 % \subsection{hyperref and ifthen}
810 % If a user defined command that calls the commands from the ifthen package (like \verb=\equal=) is placed inside a subsectioning command, this is likely to raise a problem if hyperref is also being used, even if the user defined command is robust or protected. I have been unable to identify exactly what causes this error and can provide no fix. My only suggestion is to redefine your command so that it uses the \TeX\ primitive if statements instead of the ifthen package.
811 %
812 % This bug was observed with v6.80n, last revised 2010/03/11, of hyperref and v1.1c, last revised 2001/05/26, of ifthen.
813 %
814 % \subsection{soul}
815 % The class file uses this package for the \verb=\highlight= command. As a result, any attempt to load this package with options by using \verb=\usepackage= will result in an option clash error. Instead, pass whatever options for soul you want to the class file and they will automatically be passed along to soul when it is loaded.
816 %
817 % The class file was tested with v2.4, last revised 2003/11/17. If you're having problems with soul, make sure you have this version or a more recent one before submitting a bug report.
818 %
819 % \subsection{tocvsec2}
820 % The class file uses this package to control the table of contents depth. In particular, it is used to prevent preface subsections from being numbered and appearing in the table of contents and to prevent appendix subsections from appearing in the table of contents while still being numbered. If you need to use this package for some other purpose, you don't need to reload it.
821 %
822 % The class file was tested with v1.2b, last revised 2010/02/27. If you're having problems with tocvsec2, make sure you have this version or a more recent one before submitting a bug report.
823 %
824 % \subsection{hyphenat}
825 % The class file uses this package to turn off hyphenation for the entire document. As a result, any attempt to load this package with options by using \verb=\usepackage= will result in an option clash error. Since the only options for this package either disable all hyphenation (the option being used by the class file) or enable it for monospaced (typewriter-style) fonts which aren't allowed in a thesis (the graduate school wants a single font used throughout the document), you shouldn't have to load this package anyway.
826 %
827 % The class file was tested with 2009/09/02 v2.3c. If you're having problems with hyphenat, make sure you have this version or a more recent one before submitting a bug report.
828 %
829 % \subsection{geometry}
830 % The class file uses this package to set the margins and paper size. As a result, any attempt to load this package with options by using \verb=\usepackage= will result in an option clash error. Since the graduate school has very specific requirements for the margins and paper size, both of which are set by the class file, you shouldn't need to load this package anyway.
831 %
832 % The class file was tested with v5.6, last revised 2010/09/12. If you're having problems with geometry, make sure you have this version or a more recent one before submitting a bug report.
833 %
834 % \subsection{iftex}
835 % The class file uses this package to test for the use of the PDF\TeX engine. This engine adds some spurious tags to the pdf, but also provides a command, \verb=\pdfsuppresstexinfo= to get rid of them. If we see this engine, we use the command to remove those tags. If you need this package, then simply make use of it. There is no need to load it (especially as it has no options).
836 %
837 % The class file was tested with v0.2, last revised 2013/04/04. If you're having problems with iftex, make sure you have this version or a more recent one before submitting a bug report.
838 %
839 %
840 % \section{Common Formatting Errors}
841 % This section is continued from the formatting requirements page at the University of Maine's Graduate School Thesis Guide.
842 % \subsection{Abstract Formatting Errors}
843 % All abstracts must have the below information on the same page as the abstract. This information must match the title page. The only difference between the title page and the abstract is the spacing: the abstract should have single spacing for the degree information.
844 % \subsection{Pagination Errors}
845 % The Title Page through Chapter 1 should be numbered using Roman numerals (iii, iv, v, …). The title page should be counted but not numbered. The Abstract will not have page numbers nor be counted.
846 % The body of the dissertation should be numbered using Arabic numbers (1, 2, 3, …). The first page of the body of the text should begin with page 1.
847 % All page numbers should be either top right or bottom center.
848 %
849 % \subsection{Figure and Table Errors}
850 % Figures and tables must be placed within the text, as close to their first mention as possible.\footnote{figure placement is handled automatically by \LaTeX}
851 % Figures and tables that span more than one page must be labeled on each page.
852 % Any second and subsequent page of the figure/table must include the “(Continued)” notation.\footnote{this currently requires manually creating two figures to add continued to the short title}
853 % This applies to figure captions as well as images.
854 % Each page of a figure/table must be accounted for and appropriately labeled.\footnote{please use the `ref` and `label` system in latex}
855 % All figures/tables must have a unique number.
856 % They may not repeat within the dissertation.
857 %
858 % \subsection{Window and Orphan Errors}
859 % A single line cannot appear alone at the top or bottom of a page.
860 % Widow/orphan Control is an option in Word to prevent this.
861 % W/O also applies in the reference section.
862 % While a lone heading or subheading at the bottom of the page is not technically a widow/orphan, this must be moved to the next page to accompany its text.
863 %
864 % \subsection{Horizontal Figures \& Tables Errors}
865 %Any figures/tables placed in a horizontal orientation must be rotated for readability.
866 % Insert a section break to rotate the page.\footnote{in \LaTeX we do not use section breaks for this, but we have landscape package to support}
867 %
868 % Page numbers must be placed in the same location on all pages of the dissertation, centered, at the bottom or top of the page.\footnote{This needs clarification from the graduate school, whether the bottom is in print or digital form}
869 % Page numbers may not appear under the table/figure.
870 %
871 % \subsection{Supplemental Figures \& Tables Errors}
872 % Supplemental figures and tables must be placed in an appendix at the back of the dissertation.\footnote{this requires clarification, can one appendix contain multiple figures and tables without additional prose?}
873 % They should not be placed at the back of the chapter.
874 %
875 % \subsection{Appendices Errors}
876 % Appendices should be able to stand alone. Formatting applies to figures, tables, etc.
877 % There should be no Appendix A if there is no Appendix B. It can be labeled Appendix in this case.\footnote{Appendix labeling is handled by the maine-thesis class.}
878 %
879 % \subsection{Biography Errors}
880 % The biography is required and will be on the last page of the document. This must be listed in the Table of Contents. The last OR only sentence must read “S/He/They is/are a candidate for the <degree type> degree in <program> from the University of Maine in <month> <year>.”
881 % \footnote{This is automatically inserted by the maine-thesis class.}
882 %
883 % \subsection{Post PDF Conversion Formatting Errors}
884 % The entire document should be checked after all revisions, and before submitting to the Graduate School, to spot any inconsistencies or PDF conversion glitches.
885 %
886 % \subsection{Leader Dots Errors}
887 % Leader dots must be present in the Table of Contents, List of Figures, and List of Tables.
888 % The “5 Dot leader rule” is the most common mistake.
889 % There can be no text within 5 dots of the listed page number. \footnote{While this is not handled precisely by the maine-thesis class, we have attempted to set the parameters for this to automatically occur whenever possible. Please review manually. Insert a line break when needed to correct. In a future version, the parameters for tuning for different fonts will be exposed}
890 % For example, if a title is longer than one line, it must be broken into two lines.
891 % The top and bottom lines cannot extend any closer than the 5 spaces.
892 %
893 % \section{Example}
894 %
895 % Here is a straightforward example to illustrate how these macros, if you are building the document from scratch.
896 % We reccomend that you use the provided full template from GitLab in Overleaf.
897 %
898 % \begin{macrocode}
899 %<*example>
900 \documentclass[jdecimal, citestyle=apa, 11pt]{maine-thesis}
901 % \end{macrocode}
902 % Default options 12pt and final copy
903 % Add draft for a faster compiling option with watermarks.
904
905 % Include necessary packages here
906 % \begin{macrocode}
907 \usepackage{mwe}
908 \usepackage{blindtext}
909 % \end{macrocode}
910
911 % Replace contents of {...} with your own information.
912 % \begin{macrocode}
913 \title{An essay upon the vasomotor changes in tabes dorsalis}
914 % \end{macrocode}
915
916 % Title of thesis
917 % \begin{macrocode}
918 \author{Mary Morstan}
919 % \end{macrocode}
920
921 % Author's name: First Middle Last
922 % \begin{macrocode}
923 \degreesheld{Bachelor of Medicine, University of Edinburg \\
924 Master of Surgery, University of Edinburg}
925 % \end{macrocode}
926
927 % Previously earned degree(s), institution(s) and year(s).
928 % \begin{macrocode}
929 \degree{Doctor of Medicine}
930 % \end{macrocode}
931
932 % Degree to be granted
933 % \begin{macrocode}
934 \program{School of Medicine}
935 % \end{macrocode}
936
937 % Degree granting department or program
938 % \begin{macrocode}
939 \submitdate{May 1885}
940 % \end{macrocode}
941
942 % Month and year of graduation (do not separate with a comma)
943
944 % Advisor's [short title and name]{name, long title}
945 % \begin{macrocode}
946 \principaladvisor[Dr. Seuss]{Dr. Seuss, Professor of Literature}
947 % \end{macrocode}
948
949 % \begin{macrocode}
950 % %\principalshort{...}
951 % \end{macrocode}
952 % Shortened advisor name for abstract. See guidelines for example. Should include Dr. as title.
953
954 % If you have more than one advisor then you'll should delete the first argument ("[...]") above and uncomment the following commands
955 % \begin{macrocode}
956 % %\secondadvisor{...}
957 % \end{macrocode}
958
959 % Include all committee members names and titles
960 % \begin{macrocode}
961 \firstreader{Dr. Dolittle, Vetinary School}
962 \secondreader{Dr Watson, Medical School}
963 % \end{macrocode}
964
965 % If necessary (i.e. for a doctorate), include extra committee members. Else, comment out or delete any that are unnecessary
966 % \begin{macrocode}
967 \thirdreader{Dr. Digory Kirke, Professor of Geography of Magical Lands}
968 % \end{macrocode}
969
970 % Begin the document.
971 % \begin{macrocode}
972 \begin{document}
973 % \end{macrocode}
974
975 % Tag prelimianry material and produce front matter
976 % \begin{macrocode}
977 \preliminary
978 \maketitle
979 % \end{macrocode}
980
981 % \begin{macrocode}
982 \begin{abstract}
983 \Blindtext
984 \end{abstract}
985 % \end{macrocode}
986
987 % \begin{macrocode}
988 % Replace the ... with the list of keywords
989 \begin{layabstract}{...}
990 % \end{macrocode}
991
992 % blindtext is used to generate random text for the example.
993 % \begin{macrocode}
994 \blindtext
995 \end{layabstract}
996 % \end{macrocode}
997
998 % Commands for the required lists
999 % \begin{macrocode}
1000 \tableofcontents
1001 % \end{macrocode}
1002
1003 % Sets the document spacing and pagestyle.
1004 % \begin{macrocode}
1005 \mainmatter
1006 % \end{macrocode}
1007
1008 % Main text of the thesis. Use of the `input' command will make later editing much easier.
1009 % \begin{macrocode}
1010 \chapter{Observations of Medicine: a long title that must be wrapped yet still respect the 5 leader dot spacing rule}
1011 \blindtext
1012
1013 \chapter{Deducatinos about Disease}
1014 \blindtext
1015 % \end{macrocode}
1016
1017 % Include this before any appendices.
1018 % \begin{macrocode}
1019 \begin{appendices}
1020 \chapter{Some extras}
1021 \blindtext
1022 \end{appendices}
1023 % \end{macrocode}
1024
1025 % end the document
1026 % \begin{macrocode}
1027 \end{document}
1028 % \end{macrocode}
1029
1030 % \begin{macrocode}
1031 %</example>
1032 % \end{macrocode}
1033 %
1034 % \StopEventually{^^A
1035 % \PrintChanges
1036 % \PrintIndex
1037 % }
1038 % \section{Change Log}
1039 % \subsection{v2.0.6}
1040 % Grad school requested that the clearpage after the titlepage is removed and that the TOC maintains 5 leader dot equivalent spacing on each line before the page number column
1041 % \subsection{v2.0.5}
1042 % Bugfix: centering of page numbers in mtlandscape enviornment.
1043 % \subsection{v2.0.4}
1044 % Patch LOFT back into TOC
1045 % \subsection{v2.0.3}
1046 % Add etoolbox to help with TOCLOFT and HYPERREF bug when placing tables, without loftspacing.
1047 % \subsection{v2.0.2}
1048 % Bug Fix: Remove TOC self reference and capatialize List of Figures and List of Tables.
1049 % \subsection{v2.0.1}
1050 % Bug Fix: Corrected an issue where citestyle and bibstyle options were not being correctly passed to the biblatex package. This was resolved by implementing the kvoptions package to properly handle key-value options in the class declaration.
1051 % \subsection{v2.0.0}
1052 % \subsubsection{File Structure and Maintenance}
1053 % \begin{itemize}
1054 % \item The v1 class was a single, manually maintained \texttt{.cls} file.
1055 % \item In v2, \texttt{maine-thesis.dtx}, is a single source file that generates both the class file (\texttt{maine-thesis.cls}) and its documentation. This allows for a more streamlined and automated maintenance process.
1056 % \item The \texttt{dtx} file format is part of a larger build system that uses \texttt{l3build} for unpacking and generating a CTAN-ready package.
1057 % \end{itemize}
1058 %
1059 % \subsubsection{Package and Dependency Updates}
1060 % \begin{itemize}
1061 % \item The v1 class file used older packages for a variety of tasks.
1062 % \item The v2 class has been refactored to use modern packages. For example, it now uses \texttt{biblatex} with the \texttt{biber} backend for citation management[cite: 1, 3, 5]. The previous version did not specify the use of these packages and appears to have a simpler citation approach.
1063 % \item New dependencies were added, including \texttt{fontspec}, \texttt{microtype}, \texttt{hyperref}, \texttt{csquotes}, \texttt{titlesec}, and \texttt{etoolbox}, which provide more robust font, typography, hyperlinking, and title formatting capabilities.
1064 % \end{itemize}
1065 % \subsubsection{Formatting and User Interface}
1066 % \begin{itemize}
1067 % \item The v1 class managed heading styles using a numerical counter (\texttt{\textbackslash setcounter\{head\}}) with \texttt{\textbackslash ifcase} logic.
1068 % \item The v2 \texttt{maine-thesis.cls} uses named macros like \texttt{\textbackslash apaheadings}, \texttt{\textbackslash chicagoheadings}, and \texttt{\textbackslash idecimalheadings} for a clearer and more direct way to set heading formats.
1069 % \item The v2 provides a unified command for caption formatting with \texttt{\textbackslash DeclareCaptionFormat\{thesis\}}. The original class handled captions through a redefinition of \texttt{\textbackslash \@ makecaption} and other low-level commands.
1070 % \item The title page and abstract environments were completely redesigned with the \texttt{\textbackslash maketitlehooka} and \texttt{\textbackslash maketitlehookd} commands, allowing for more precise control over the layout.
1071 % \end{itemize}
1072 %
1073 % \subsubsection{Code and Variable Changes}
1074 % \begin{itemize}
1075 % \item The v1 class contained deprecated commands like \texttt{\textbackslash libraryrights} and \texttt{\textbackslash dissacceptance}.
1076 % \item The v2 class removes these deprecated commands and replaces them with a \texttt{\textbackslash ClassError} message, informing the user that the Graduate School no longer requires them.
1077 % \item The \texttt{\textbackslash preliminary} command in the v2 version now sets the \texttt{tocdepth} and \texttt{secnumdepth} to 1, while the v1 version used a different command for this purpose (\texttt{\textbackslash settocdepth\{chapter\}}).
1078 % \item The \texttt{\textbackslash appendix} command in the v2 class now uses \texttt{\textbackslash gdef} to globally change \texttt{\textbackslash chaptername} to ``Appendix'' and the chapter counter to use alphabetical characters (\texttt{\textbackslash thechapter\{\textbackslash @Alph\textbackslash c@chapter\}}).
1079 % \end{itemize}
1080 %
1081 % \begin{macro}{\comment}
1082 % The comment command is now pulled from the `changes` packages with more extensive functionality.
1083 % In v1.14 this command uses the todonotes package to create margin notes but also checks a conditional (ifdraft) to ensure the notes only appear in draft mode.
1084 % \end{macro}
1085 %
1086 % \begin{macro}{\highlight}
1087 % The highlight command is now pulled from the `changes` packages with more extensive functionality.
1088 % In v1.14 this command uses the soul package to create margin notes but also checks a conditional (ifdraft) to ensure the notes only appear in draft mode.
1089 % \end{macro}
1090 %
1091 % \begin{macro}{\appendix}
1092 % The appendix command should no longer be used to define appendicies; however it is still supported in the appendix pacakge. (replacing custom appendix and heading table of contents functionality.
1093 % \end{macro}
1094 %
1095 % \begin{macro}{\multipleappendicestrue}
1096 % This command, located in \texttt{main.tex}, is a conditional that tells the template to use multiple appendices. If you only have one appendix, you should comment this line out.
1097 % This has been replaced with the multiappendices option for the class.
1098 % \end{macro}
1099 %
1100 % \subsection{Changes in v1.16}
1101 % \begin{itemize}
1102 % \item{\bfseries Added University of Maine Graduate School Land Acknowledgment}
1103 % \end{itemize}
1104 %
1105 % \subsection{Changes in v1.15}
1106 % \begin{itemize}
1107 % \item{\bfseries Add “APPENDICES” to title of first Appendix and TOC when multiple appendices are present.}
1108 % \end{itemize}
1109 %
1110 % \subsection{Changes in v1.14}
1111 % \begin{itemize}
1112 % \item{\bfseries Ensured double spacing in chapter titles.}
1113 % \item{\bfseries Removed extra space above chapter titles.}
1114 % \item{{\bfseries Removed extra space between chapters in list of figures and list of tables.} This is implemented as an option, you can add the space back (for unofficial copies) with the loftspacing option.}
1115 % \item{\bfseries Changed ``The University of Maine'' to ``the University of Maine'' in the auto-sentence of the author biography.}
1116 % \item{\bfseries Reduce space between title and author name on abstract pages.}
1117 % \item{\bfseries Remove “Chapter” heading from TOC.}
1118 % \item{Fixed problem with link target (when using hyperref) and page number in TOC for reference section.}
1119 % \item{\bfseries changed ``The University of Maine'' to ``the University of Maine'' in the auto-sentence of the author biography.}
1120 % \item{Improved capitalization enforcement for chapter headings and TOC entries. This should make redefining section names (as when using babel) much easier.}
1121 % \item{Dropped 2-volume support. (Graduate School no longer needs a printed copy of the thesis.)}
1122 % \item{Page number placement now controlled by a class option. It's also more consistent in its application as a result.}
1123 % \item{\bfseries Extra space before ``Chapter'' label in TOC has been removed.}
1124 % \item{``Chapter'' and ``Appendix'' in chapter headings is now printed in all uppercase.}
1125 % \item{\bfseries Tweaks to make 5-dot minimum in TOC leaders better respected. Thanks to pmbean6 for this fix.}
1126 % \item{\bfseries Use a pronoun instead of author name for the last sentence of author biography. Users now need to define their preferred pronoun with the \verb=\authorpronoun= command. Do not forget to capitalize the first letter of the pronoun. If no pronoun is provided, then the full author name will appear in the last sentence of the biography.}
1127 % \item{\bfseries When figure/table captions are too long to go into the table of contents, the graduate school wants the entry in the table of contents to match the first sentence of caption exactly. To facilitate this the \verb=\caption= command has been redefined so that the optional argument, if given, is automatically prepended to the caption text. Older theses, for which this new behavior would be undesirable, can turn it off with the legacycaptions option.}
1128 % \item{\bfseries On title page, when the name and title of an advisor or committee member is long enough to wrap to a second line, that second line will be indented 1.5em (the same as the indentation of a paragraph in the body of the thesis).}
1129 % \end{itemize}
1130 %
1131 % \subsection{Changes in v1.13}
1132 % \begin{itemize}
1133 % \item{Short form of advisor's name can now be entered as an optional argument of \verb=\principaladvisor=.}
1134 % \item{Bugfix: idecimal and jdecimal heading styles were suppressing the section numbers. Thanks to pmbean6 for this fix.}
1135 % \item{Margin widths have been tweaked a little so that they more closely conform to the guidelines. Thanks to pmbean6 for this fix.}
1136 % \item{If you edited the class file to get justified text back, then subsection headings were being indented in jdecimal style. This has been fixed in preparation for later changes. Thanks to pmbean6 for this fix.}
1137 % \item{Package conflict with float package has been resolved. Thanks to pmbean6 for this fix. Those updating thesis should change listof environments to thesislist.}
1138 % \item{Bugfix: The default setting of \verb=\parindent= was being forced to 0, which was not as intended.}
1139 % \item{Indentation for the headings has been decoupled from \verb=\parindent= and is now tied to \verb=\headindent=.}
1140 % \item{Added some basic metadata (title and author) handling when hyperref is loaded. Thanks to pmbean6 for this enhancement}
1141 % \item{\bfseries Adjusted page numbering to account for removal of Dissertation Acceptance page.}
1142 % \end{itemize}
1143 %
1144 % \subsection{Changes in v1.12}
1145 % \begin{itemize}
1146 % \item{\bfseries Eliminated Dissertation Acceptance and Library Rights Statement pages.}
1147 % \end{itemize}
1148 %
1149 % \subsection{Changes in v1.11}
1150 % \begin{itemize}
1151 % \item{\bfseries Replaced ``thesis'' with \verb=\@type= on Library Rights page.}
1152 % \item{\textbf{Labels for signature lines now use the same size font as the rest of the thesis (they were formerly reduced).}}
1153 % \item{\textbf{Gap between the title and the text on Dissertation Acceptance and Library Rights page has been reduced.}}
1154 % \item{\textbf{Mandatory sentence at the end of the Author Biography (and which the class file produces automatically) is no longer its own paragraph.}}
1155 % \item{\textbf{The default headings system has been modified to make it match more closely with the justified decimal example in the Guidelines.}}
1156 % \item{Two additional headings systems (headings and idecimal) have been added. These are based on the headings and indented decimal examples in the Guidelines.}
1157 % \item{\bfseries Improved Widow/Orphan protection in the TOC.}
1158 % \item{\bfseries Improved Widow/Orphan protection in bibliography.}
1159 % \end{itemize}
1160 %
1161 % \subsection{Changes in v1.10}
1162 % \begin{itemize}
1163 % \item{\textbf{Alignment of multi-line table of contents entries for Appendices altered}}
1164 % \item{5-dot leader minimum code reworked to be more robust}
1165 % \end{itemize}
1166 %
1167 % \subsection{Changes in v1.9}
1168 % \begin{itemize}
1169 % \item{\textbf{Acceptance Page title consolidated to a single line.}}
1170 % \item{\textbf{Removed ``Submitted for graduation\ldots'' from Acceptance Page.}}
1171 % \end{itemize}
1172 %
1173 % \subsection{Changes in v1.8}
1174 % \begin{itemize}
1175 % \item{\textbf{Hyphenation disabled.}}
1176 % \item{\textbf{Full justification disabled.}}
1177 % \end{itemize}
1178 %
1179 % \subsection{Changes in v1.7}
1180 % \begin{itemize}
1181 % \item{Added \verb=\highlight= command.}
1182 % \item{Modifications to \verb=\pocket= to make its ToC entries match other chapter-level entries.}
1183 % \item{Added two-volume support.}
1184 % \item{Made some modifications to help with widow/orphan control in the ToC.}
1185 % \end{itemize}
1186 %
1187 % \subsection{Changes in v1.6}
1188 % \begin{itemize}
1189 % \item{\textbf{Changed line length for multiple line entires in the ToC.}}
1190 % \item{\textbf{Removed the multiple appendices ``Appendices'' header from the ToC.}}
1191 % \item{Added twoside option.}
1192 % \item{Added unbound option.}
1193 % \item{Added hooks to alter heading styles.}
1194 % \item{Added chicago and apa option to switch headings automatically to the appropriate style.}
1195 % \end{itemize}
1196 %
1197 % \subsection{Changes in v1.5}
1198 % \begin{itemize}
1199 % \item{License Changed to LPPL v1.3c.}
1200 % \item{Generalized Dissertation Acceptance Page.}
1201 % \item{Changed to signature line on Library Rights Page.}
1202 % \item{Fixed delimiter in figure and table captions.}
1203 % \item{Unified \verb=\copyrightyear{...}= and \verb=\copyrightpage= into single command.}
1204 % \item{Refined support for two advisors and number of committee members.}
1205 % \item{Removed support for External Reader on title page.}
1206 % \item{Created patch code to fix list of tables and list of figures when hyperref is used.}
1207 % \item{Added layabstract environment.}
1208 % \item{Added listof environment.}
1209 % \item{Changed font for verbatim environment and \verb=\verb= command.}
1210 % \item{Fixed typesetting of dedication.}
1211 % \item{General file maintenance.}
1212 % \item{Added insertion of ``Appendices'' to ToC when there are multiple appendices.}
1213 % \item{Modified biography environment to auto-generate the last sentence.}
1214 % \item{Made identification of number of advisors and committee members automatic.}
1215 % \item{Removed \verb=\appsection{...}= as it is redundant with \verb=\section*{...}=.}
1216 % \item{Changed way ``Chapters'' and ``Appendices'' are added to the TOC.}
1217 % \item{Added tocvsec2 dependance to make the change in TOC depth for the front matter and appendices automatic.}
1218 % \item{Modified preface environment to make the non-numbering of its sections, subsections, etc automatic.}
1219 % \item{Reserved \verb=\part= for multiple volume support.}
1220 % \item{Added \verb=\pocket=.}
1221 % \item{Defined a pseudo \verb=\texorpdfstring= command for use in chapter titles. When hyperref is loaded (and defines the command properly) this has the effect of hiding \verb=\MakeUppercase= commands from hyperref.}
1222 % \item{Made Preface, Dedication, and Acknowledgements double spaced.}
1223 % \item{Created type variables and commands that allows switching to ``thesis'' or ``project'' instead of ``dissertation.''}
1224 % \item{Removed footnote rule.}
1225 % \item{Renamed \verb=\labelchaptersintoc= to \verb=\toclabel=, generalized its function, and made it compatible with hyperref.}
1226 % \item{Added commands to compress title page when needed.}
1227 % \end{itemize}
1228 %
1229 % \subsection{Changes prior to v1.5}
1230 % This list is not entirely complete but is a best reconstruction as I can manage. Changes were not logged prior to v1.5.
1231 % \begin{itemize}
1232 % \item{Added Dissertation Acceptance Page}
1233 % \item{Added support for 6 member committees}
1234 % \item{Removed Boldface from TOC entries}
1235 % \item{Reduced size of chapter and section headers to match text font, both in place and TOC entries}
1236 % \item{Added support for two advisors}
1237 %
1238 % \end{itemize}
1239
1240 % \section{Implementation of Class. Package Definition}
1241 % \begin{macrocode}
1242 %<*package>
1243 %<@@=maine-thesis>
1244 % \end{macrocode}
1245 % \begin{macrocode}
1246 \NeedsTeXFormat{LaTeX2e}
1247 \ProvidesClass{maine-thesis}[2025/12/29 v2.0.6 University of Maine Thesis]
1248 \RequirePackage{kvoptions}
1249 \SetupKeyvalOptions{
1250 family=MT,
1251 prefix=MT@
1252 }
1253 % \end{macrocode}
1254 % \subsection{Initial Variables}
1255 % \begin{macrocode}
1256 \newif\ifdraft\draftfalse
1257 \newif\iftwoside\twosidefalse
1258 \newif\ifmt@official\mt@officialtrue
1259 \newif\ifunbound\unboundfalse
1260 \newif\ifmt@legacycaptions\mt@legacycaptionsfalse
1261 \newif\ifmt@loftspace\mt@loftspacefalse
1262 \newcommand\docsize{}
1263 \newcommand\side{oneside}
1264 \newcounter{secnumdefault}
1265 \setcounter{secnumdefault}{3}
1266 \newcounter{head}
1267 \setcounter{head}{1000}
1268 \def\@margg{1.5in}
1269 \def\mt@pagestyle{bottom}
1270 % \end{macrocode}
1271
1272 % \section{Declare Options}
1273 %
1274 % \begin{macro}{10pt}
1275 % \begin{macrocode}
1276 \DeclareOption{10pt}{\renewcommand\docsize{10pt}\PassOptionsToClass{10pt}{report}}
1277 % \end{macrocode}
1278 % \end{macro}
1279 % \begin{macro}{11pt}
1280 % \begin{macrocode}
1281 \DeclareOption{11pt}{\renewcommand\docsize{11pt}\PassOptionsToClass{11pt}{report}}
1282 % \end{macrocode}
1283 % \end{macro}
1284 % \begin{macro}{12pt}
1285 % \begin{macrocode}
1286 \DeclareOption{12pt}{\renewcommand\docsize{12pt}\PassOptionsToClass{12pt}{report}}
1287 % \end{macrocode}
1288 % \end{macro}
1289 %
1290 % \subsection{Draft Mode}
1291 % The `draft` option enables a "draft mode" for the document.
1292 % It sets the `ifdraft` conditional to true, which can be used by other
1293 % parts of the class to show or hide draft-specific content.
1294 % \begin{macro}{draft}
1295 % \begin{macrocode}
1296 \DeclareOption{draft}{\drafttrue
1297 % \end{macrocode}
1298 % \end{macro}
1299 % When in draft mode, it defaults to a 10pt font size for faster compilation.
1300 % \begin{macrocode}
1301 \ExecuteOptions{10pt}
1302 % \end{macrocode}
1303 % The `draft` option is passed to the underlying `report` class to
1304 % show draft annotations (like black squares for overfull hboxes).
1305 % \begin{macrocode}
1306 \PassOptionsToClass{draft}{report}
1307 \PassOptionsToPackage{draft}{changes}
1308 % \end{macrocode}
1309 % Defines a command to display a "DRAFT" watermark or text.
1310 % \begin{macrocode}
1311 \newcommand{\drafttext}{\sffamily\small{DRAFT}}
1312 % \end{macrocode}
1313 % Sets a conditional to false, which might hide official marks.
1314 % \begin{macrocode}
1315 \mt@officialfalse
1316 }
1317 % \end{macrocode}
1318 % \subsection{Page Layout}
1319 % These options control the page layout, specifically whether the document is
1320 % for a one-sided or two-sided print.
1321 % These options are standard and should be passed to the report class.
1322 %
1323 % \begin{macro}{twoside}
1324 % \begin{macrocode}
1325 \DeclareOption{twoside}{\mt@officialfalse\unboundfalse\twosidetrue\renewcommand\side{twoside}\def\@margg{1.5in}\PassOptionsToClass{twoside}{report}}
1326 % \end{macrocode}
1327 % \end{macro}
1328 % \begin{macro}{oneside}
1329 % \begin{macrocode}
1330 \DeclareOption{oneside}{\mt@officialfalse\unboundfalse\renewcommand\side{oneside}\def\@margg{1.5in}\PassOptionsToClass{oneside}{report}}
1331 % \end{macrocode}
1332 % \end{macro}
1333 %
1334 % The `unbound` option sets the class for single-sided printing with a smaller
1335 % left margin, which is suitable for documents that will not be bound.
1336 %
1337 % \begin{macro}{unbound}
1338 % \begin{macrocode}
1339 \DeclareOption{unbound}{\mt@officialtrue\unboundtrue\def\@margg{1in}}
1340 % \end{macrocode}
1341 % \end{macro}
1342 %
1343 % \subsection{Multiple Appendices}
1344 %\subsection{Pass options to appendix package}
1345 % This replaces the multipleappendicestrue commands
1346 % \begin{macro}{multiappendices}
1347 % \begin{macrocode}
1348 \DeclareOption{multiappendices}{\PassOptionsToPackage{toc,titletoc, title}{appendix}}
1349 % \end{macrocode}
1350 % \end{macro}
1351 % \subsection{Heading Style Options}
1352 % The following options allow the user to choose from different heading styles.
1353 %
1354 % \begin{macro}{headingstyle={{style}}}
1355 % \begin{macrocode}
1356 \DeclareStringOption[jdecimal]{headingstyle}
1357 % \end{macrocode}
1358 % Define an empty macro as a placeholder
1359 % \end{macro}
1360 %
1361 % \subsection{Legacy Heading Styles}
1362 %
1363 % \begin{macro}{apa}
1364 % \begin{macrocode}
1365 \DeclareOption{apa}{\ExecuteOptions{headingstyle=apa}}
1366 % \end{macrocode}
1367 % \end{macro}
1368 % \begin{macro}{chicago}
1369 % \begin{macrocode}
1370 \DeclareOption{chicago}{\ExecuteOptions{headingstyle=chicago}}
1371 % \end{macrocode}
1372 % \end{macro}
1373 % \begin{macro}{headings}
1374 % \begin{macrocode}
1375 \DeclareOption{headings}{\ExecuteOptions{headingstyle=mainethesis}}
1376 % \end{macrocode}
1377 % \end{macro}
1378 % \begin{macro}{idecimal}
1379 % \begin{macrocode}
1380 \DeclareOption{idecimal}{\ExecuteOptions{headingstyle=idecimal}}
1381 % \end{macrocode}
1382 % \end{macro}
1383 % \begin{macro}{jdecimal}
1384 % \begin{macrocode}
1385 \DeclareOption{jdecimal}{\ExecuteOptions{headingstyle=jdecimal}}
1386 % \end{macrocode}
1387 % \end{macro}
1388 %
1389 %
1390 % \subsection{Captions}
1391 % The `legacycaptions` option changes the caption formatting.
1392 %
1393 % \begin{macrocode}
1394 \DeclareOption{legacycaptions}{\mt@legacycaptionstrue}
1395 % \end{macrocode}
1396 %
1397 % \subsection{Pagination}
1398 % These options control the placement of page numbers.
1399 %
1400 % \begin{macrocode}
1401 \DeclareOption{pagenumberbottom}{\def\mt@pagestyle{bottom}}
1402 \DeclareOption{pagenumbertop}{\def\mt@pagestyle{top}}
1403 % \end{macrocode}
1404 %
1405 % /subsection{Pass options to report class}
1406 % This passes any unknown option directly to the underlying `report` class.
1407 % This is a catch-all to make the class compatible with standard report options.
1408 %
1409 % \begin{macrocode}
1410 \DeclareOption*{\PassOptionsToClass{\CurrentOption}{report}}
1411 % \end{macrocode}
1412 %
1413 % \subsection{Spacing Modifiers}
1414 % The `loftspacing` option enables a specific spacing setting.
1415 %
1416 % \begin{macrocode}
1417 \DeclareOption{loftspacing}{\mt@loftspacetrue\mt@officialfalse}
1418 % \end{macrocode}
1419 %
1420 % \subsection{Options to pass to xcolor package}
1421 % These options are specifically for the `xcolor` package.
1422 % They intercept the options from `documentclass` and pass them to `xcolor`
1423 % before it's loaded, preventing an option clash.
1424 %
1425 % \begin{macrocode}
1426 \DeclareOption{table}{\PassOptionsToPackage{table}{xcolor}}
1427 \DeclareOption{xcdraw}{\PassOptionsToPackage{xcdraw}{xcolor}}
1428 % \end{macrocode}
1429 %
1430 % \subsection{Citation and Bibliography Styles}
1431 % These options define macros to store the citation and bibliography styles.
1432 % \begin{macrocode}
1433 \DeclareStringOption[authoryear]{citestyle}
1434 \DeclareStringOption[\MT@citestyle]{bibstyle}
1435 % \end{macrocode}
1436 %
1437 %
1438 % \subsection{Execution of Options}
1439 % This is the final execution block. It's crucial for processing all
1440 % the options that have been declared and passed.
1441 %
1442 % sets the default font
1443 % \begin{macrocode}
1444 \ExecuteOptions{12pt,unbound}
1445 % \end{macrocode}
1446
1447 % \begin{macrocode}
1448 \ProcessOptions
1449 % \end{macrocode}
1450
1451 % \subsubsection{Process Heading Styles}
1452 % \begin{macrocode}
1453 \def\HeadingStyle{\MT@headingstyle}
1454 % \end{macrocode}
1455
1456 % \subsection{Changes Package}
1457 % Pass final to changes if draft is not provided as an option. This will disable related document markup.
1458 % \begin{macrocode}
1459 \ifdraft{}\else{\PassOptionsToPackage{final}{changes}}\fi
1460 % \end{macrocode}
1461 %
1462 % \section{Import Required Packages}
1463 % Depending on your system, there are diffent methods for installing pacakges, but generally they are sourced from CTAN. If you are using Overleaf, all of these pacakges are installed for you by default.
1464 % On fedora, they are all included within texlive-scheme-full, which can be installed with dnf.
1465 %
1466 % \begin{macro}{report}
1467 % \subsection{Report Class}
1468 % \begin{macrocode}
1469 \LoadClass[\docsize,\side]{report}[2022/07/02 v1.4n Standard LaTeX document class]
1470 % \end{macrocode}
1471 % \end{macro}
1472 %
1473 % \subsection{Fonts}
1474 % \begin{macro}{fontenc}
1475 % \begin{macrocode}
1476 \RequirePackage[T1]{fontenc}[2024/06/01 v2.0h Standard LaTeX package]
1477 % \end{macrocode}
1478 % Provides the T1 font encoding, which allows for correct hyphenation of
1479 % accented characters and improves overall text rendering.
1480 % \end{macro}
1481 % \begin{macro}{fontspec}
1482 % \begin{macrocode}
1483 \RequirePackage{fontspec}[2022/01/15 v2.8a Font selection for XeLaTeX and LuaLaTeX]
1484 % \end{macrocode}
1485 %
1486 % Provides advanced font selection with LuaLaTeX and XeLaTeX, allowing for
1487 % the use of system fonts and OpenType/TrueType font features.
1488 % \end{macro}
1489 % \begin{macro}{microtype}
1490 % \begin{macrocode}
1491 \RequirePackage{microtype}[2023/03/13 v3.1a Micro-typographical refinements (RS)]
1492 % \end{macrocode}
1493 % \end{macro}
1494 %
1495
1496 % Enhances the appearance of justified text through micro-typographical
1497 % adjustments like character protrusion and font expansion.
1498
1499 % \subsection{Table of Contents, List of Tables and List of Figures}
1500 %The List of Tables and the List of Figures (if any) appear as individual pages.
1501 %
1502 %A List of Tables/Figures is necessary even if there is only one table or figure.
1503 %
1504 %If the text of the manuscript contains a consistent set of theorems, symbols, abbreviations, or definitions, those should be listed in a List of Theorems, Symbols, Abbreviations, or Definitions respectively. These lists are included in the Table of Contents.
1505 % \begin{itemize}
1506 % \item Tables/figures must be numbered and titled. Further explanatory information provided in a caption that is not part of the title should not appear on the List of Tables/Figures.
1507 % \item The tables/figures are numbered separately from each other. Each group is numbered consecutively throughout the entire manuscript or by chapter using a decimal numbering system (e.g., the third table in chapter two will be Table 2.3., and the third figure in chapter two will be Figure 2.3.). The same system should be used for numbering figures AND tables.
1508 % \item All tables/figures must fit into the required page margins.
1509 % \item The title and caption of the table/figure are part of the text and must be the same font size and style of the body of the manuscript. It is acceptable for the font within the table/figure to be as small as 9-point font.
1510 % \item Tables/figures must be placed in the text as they are mentioned. If the Table/Figure is larger than one-half of the page it must be placed on a page of its own.
1511 % \item Tables/figures that extend onto a second page must be labeled “Table/Figure \# Continued”
1512 % \item Appendix tables/figures must be numbered separately (e.g., the third table in Appendix A would be numbered Table A.3.) and must be included in the List of Tables.
1513 % \item Photographs must be originals or high-quality reproductions. All photographs must have captions.
1514 % \end{itemize}
1515 % \begin{macro}{tocloft}
1516 % \begin{macrocode}
1517 \RequirePackage[titles]{tocloft}[2017/08/31 v2.3i parameterised ToC, etc., typesetting]
1518 % \end{macrocode}
1519 % Offers extensive customization of the table of contents, list of figures,
1520 % and list of tables.
1521 % \end{macro}
1522
1523 % \begin{macro}{etoolbox}
1524 % \begin{macrocode}
1525 \RequirePackage{etoolbox}[2020/10/05 v2.5k e-TeX tools for LaTeX (JAW)]
1526 \patchcmd{\@chapter}{\addtocontents{lof}{\protect\addvspace{10\p@}}}{}{}{}
1527 \patchcmd{\@chapter}{\addtocontents{lot}{\protect\addvspace{10\p@}}}{}{}{}
1528 % \end{macrocode}
1529 % A set of tools for programming in LaTeX, providing macros for conditionals.
1530 % \end{macro}
1531
1532 % \subsection{Formatting}
1533 % \begin{macro}{newunicodechar}
1534 % \begin{macrocode}
1535 \RequirePackage{newunicodechar}[2018/04/08 v1.2 Defining Unicode characters]
1536 % \end{macrocode}
1537 % Provides a command to define new Unicode characters, which is essential
1538 % for modern typesetting.
1539 % \end{macro}
1540
1541 % \begin{macro}{textcomp}
1542 % \begin{macrocode}
1543 \RequirePackage{textcomp}[2020/02/02 v2.0n Standard LaTeX package]
1544 % \end{macrocode}
1545 % Provides a wide range of symbols and characters not available in default
1546 % LaTeX fonts, such as the trademark symbol.
1547 % \end{macro}{textcomp}
1548 % \begin{macro}{nth}
1549 % \begin{macrocode}
1550 \RequirePackage[super]{nth}[2002/02/27]
1551 % \end{macrocode}
1552 % Adds commands for typesetting ordinal numbers (e.g., 1st, 2nd, 3rd)
1553 % with correct superscripting.
1554 % \end{macro}{nth}
1555
1556 % \subsection{ Numbers, Special Characters, and Chemical Formulas}
1557 % \begin{macro}{mhchem}
1558 % \begin{macrocode}
1559 \RequirePackage[version=4]{mhchem}[2021/12/31 v4.09 for typesetting chemical formulae]
1560 % \end{macrocode}
1561 % Provides an easy way to write chemical formulas and equations.
1562 % \end{macro}
1563 % \begin{macro}{textgreek}
1564 % \begin{macrocode}
1565 \RequirePackage{textgreek}[2011/10/09 v0.7 Greek symbols in text]
1566 % \end{macrocode}
1567 % Provides commands for typesetting Greek letters in text mode.
1568 % \end{macro}
1569 % \begin{macro}{siunitx}
1570 % \begin{macrocode}
1571 \RequirePackage{siunitx}[2023-03-14 v3.2.3 A comprehensive (SI) units package]
1572 % \end{macrocode}
1573 % Provides a powerful command for typesetting SI units and numbers with
1574 % proper spacing and formatting.
1575 % \end{macro}
1576 % \begin{macro}{geometry}
1577 % \begin{macrocode}
1578 \RequirePackage{geometry}[2020/01/02 v5.9 Page Geometry]
1579 % \end{macrocode}
1580 % This package provides a flexible interface to control the document's page layout.
1581 % Within this class, it's used to set the document margins, including the left margin
1582 % based on the `unbound` option.
1583 % \end{macro}
1584
1585 % \begin{macro}{geometry}
1586 % \begin{macrocode}
1587 \RequirePackage[defaultlines=4,all]{nowidow}
1588 % \end{macrocode}
1589 % This pacakge prevents widows and clubs
1590 % \end{macro}
1591
1592 % \subsection{References and Citations}
1593 % \begin{macro}{biblatex}
1594 % \begin{macrocode}
1595 \RequirePackage[backend=biber, citestyle=\MT@citestyle, bibstyle=\MT@bibstyle, doi = true, autopunct = true, date=year]{biblatex}[2024/03/05 v3.19]% \end{macrocode}
1596 % A powerful package for managing bibliographies and citations.
1597 % \end{macro}
1598 %
1599 % \subsection{Appendices}
1600 % Each Appendix must be listed by its title and page number. If there is only one Appendix, it is listed by the name “Appendix” and its title. Therefore, an Appendix “A” should not be listed unless there is an Appendix “B”.
1601 % \begin{macro}{appendix}
1602 % The appendix package provides the `appendix` command for legacy support as well as the `appendicies` enviornment.
1603 % \begin{macrocode}
1604 \RequirePackage[titletoc, title]{appendix}
1605 % \end{macrocode}
1606 % \end{macro}
1607 %
1608 % \subsection{Figures and Tables}
1609 % Figures: A FIGURE is a graphic illustration (chart, graph, diagram, photo, map, or plate).
1610 % Figures may be professionally prepared or drawn by the author.
1611 % In either case, they must be of letter-quality print.
1612 %
1613 % Figures \& Tables must be placed as close as possible to their first mention in the text.\footnote{\LaTeX handles this with the figure environment}
1614 % If a table or figure with the caption is larger than 2/3 of a page, it must be moved to a separate page.
1615 % Tables and figures referred to in the text may not be placed at the end of the chapter or the end of the dissertation.
1616 %
1617 % \begin{macro}{tabularx}
1618 % \begin{macrocode}
1619 \RequirePackage{tabularx}[2023/12/11 v2.12a]
1620 % \end{macrocode}
1621 % This package provides the `tabularx` environment, which is an extension of the
1622 % standard `tabular` environment. It includes a new column type, `X`, that
1623 % automatically adjusts its width to fill the specified table width. This is
1624 % essential for creating tables that span the full text width of your document.
1625 % \end{macro}
1626 % \begin{macro}{hyperref}
1627 % \begin{macrocode}
1628 \RequirePackage[linktocpage=true]{hyperref}[2023-02-07 v7.00v Hypertext links for LaTeX]
1629 % \end{macrocode}
1630 % Creates hyperlinks within the document, making the table of contents,
1631 % citations, and external links clickable.
1632 % \end{macro}
1633 % \begin{macro}{csquots}
1634 % \begin{macrocode}
1635 \RequirePackage{csquotes}[2022-09-14 v5.2n context-sensitive quotations (JAW)]
1636 % \end{macrocode}
1637 % Provides context-sensitive quotation facilities, automatically handling
1638 % nesting and language-specific rules.
1639 % \end{macro}
1640 % \begin{macro}{graphicx}
1641 % \begin{macrocode}
1642 \RequirePackage{graphicx}[2021/09/16 v1.2d Enhanced LaTeX Graphics (DPC,SPQR)]
1643 % \end{macrocode}
1644 % A fundamental package for including graphics files in a document.
1645 % \end{macro}
1646
1647 % \subsubsection{Landscape Figures and Tables}
1648 % Landscape orientation figures and tables must be oriented as such by inserting a section break and rotating the page.
1649 % This makes the figure/table readable in digital format.
1650 %
1651 % \begin{macro}{rotating}
1652 % \begin{macrocode}
1653 \RequirePackage{rotating}[2016/08/11 v2.16d rotated objects in LaTeX]
1654 % \end{macrocode}
1655 % Provides environments for rotating objects such as figures and tables.
1656 % \end{macro}
1657
1658 % \begin{macro}{lscape}
1659 % \begin{macrocode}
1660 \RequirePackage{lscape}[2020/05/28 v3.02]
1661 % \end{macrocode}
1662 % Provides a landscape environment to rotate pages. For PDF output, the
1663 % `pdflscape` package is required to correctly set the page orientation.
1664 % \end{macro}
1665 %
1666 % \begin{macro}{fancyhdr}
1667 % \begin{macrocode}
1668 \RequirePackage{fancyhdr}
1669 \RequirePackage{eso-pic}
1670 % \end{macrocode}
1671 % Provides fine constrols over headers, footers, and page layout
1672 % \end{macro}
1673 %
1674 % \begin{macro}{pdflscape}
1675 % \begin{macrocode}
1676 \RequirePackage{pdflscape}[2022-10-27 v0.13 Display of landscape pages in PDF]
1677 \RequirePackage{tikz}
1678 \RequirePackage{everypage}
1679 \usetikzlibrary{calc}
1680 % \end{macrocode}
1681 % Adds PDF support to the `lscape` environment, ensuring landscape pages
1682 % are displayed correctly in PDF viewers.
1683 % TIKZ is used to position page numbers in landscape mode.
1684 % \end{macro}
1685 %
1686 % \subsubsection{Caption}
1687 % Captions must be on the same page as the figure on the table.\footnote{currenlty,we use a short title and a caption description}
1688 % If the table exceeds one page, the caption should go on the first page and the second page will be labeled as table/figure continued.\footnote{currenlty, this must be handled manually, where the description is null for the second page.}
1689 % \begin{macro}{caption}
1690 % \begin{macrocode}
1691 \RequirePackage[margin=10pt,font=small,labelfont=bf,labelsep=quad]{caption}[2023/03/12 v3.6j Customizing captions (AR)]
1692 % \end{macrocode}
1693 % Provides an interface to customize the captions of figures and tables.
1694 % \end{macro}
1695 % \begin{macro}{float}
1696 % \begin{macrocode}
1697 \RequirePackage{float}[2001/11/08 v1.3d Float enhancements (AL)]
1698 % \end{macrocode}
1699 % Provides the H placement specifier for floats, giving more precise control.
1700 % \end{macro}
1701 % \begin{macro}{booktabs}
1702 % \begin{macrocode}
1703 \RequirePackage{booktabs}[2020/01/12 v1.61803398 Publication quality tables]
1704 % \end{macrocode}
1705 % Provides commands for drawing professional-looking horizontal rules in tables.
1706 % \end{macro}
1707 % \begin{macro}{xcolor}
1708 % \begin{macrocode}
1709 \RequirePackage{xcolor}[2022/06/12 v2.14 LaTeX color extensions (UK)]
1710 % \end{macrocode}
1711 % An extended version of the `color` package, providing more color models
1712 % and table coloring features.
1713 % \end{macro}
1714 %
1715 % \begin{macro}{multirow}
1716 % \begin{macrocode}
1717 \RequirePackage{multirow}[2021/03/15 v2.8 Span multiple rows of a table]
1718 % \end{macrocode}
1719 % Provides a command to create cells that span multiple rows in a table.
1720 % \end{macro}
1721 % \begin{macro}{longtable}
1722 % \begin{macrocode}
1723 \RequirePackage{longtable}[2021-09-01 v4.17 Multi-page Table package (DPC)]
1724 % \end{macrocode}
1725 % Provides an environment for creating tables that can span multiple pages.
1726 % \end{macro}
1727
1728 % \subsection{Document Markup}
1729 % \begin{macro}{todonotes}
1730 % \begin{macrocode}
1731 \RequirePackage[colorinlistoftodos]{todonotes}[2023/01/31]
1732 % \end{macrocode}
1733 % Provides commands for adding margin notes and todo lists during drafting.
1734 % \end{macro}
1735 % \begin{macro}{soul}
1736 % \begin{macrocode}
1737 \RequirePackage{soul}[2003/11/17 v2.4]
1738 % \end{macrocode}
1739 % Provides commands for letter-spacing, underlining, and highlighting text.
1740 % \end{macro}
1741 % \begin{macro}{lineno}
1742 % \begin{macrocode}
1743 \RequirePackage[modulo]{lineno}[2023/01/19 line numbers on paragraphs v5.1]
1744 % \end{macrocode}
1745 % 'lineno' is enabled when in draft mode for easier review
1746 % Adds line numbers to a document, useful during the drafting process.
1747 % \end{macro}
1748 % \begin{macro}{changes}
1749 % \begin{macrocode}
1750 \RequirePackage[]{changes}
1751 % \end{macrocode}
1752 %
1753 % The main advantage of the changes package is its flexibility. You can define different authors with their own colors, which is great for showing who made which edits in a collaborative document.
1754 % When you're ready to submit the final version of your manuscript, you don't need to manually remove all the change markup. You can simply add the final option to the package in your preamble.
1755 %
1756 % The changes package provides commands to mark up text as additions, deletions, or replacements.
1757 %\end{macro}
1758 % \subsection{Table of Contents, Titles and Headings}
1759 %
1760 % \begin{macro}{titlesec}
1761 % \begin{macrocode}
1762 \RequirePackage{titlesec}[2021/07/05 v2.14 Sectioning titles]
1763 % \end{macrocode}
1764 % Offers a powerful interface to sectioning commands, allowing for custom headings.
1765 %
1766 % \end{macro}
1767 % \begin{macro}{textcase}
1768 % \begin{macrocode}
1769 \RequirePackage{textcase}[2022/07/10 v1.03 Text only upper/lower case changing (DPC)]
1770 % \end{macrocode}
1771 % Provides robust commands for changing the case of text.
1772 % \end{macro}
1773 % \begin{macro}{titling}
1774 % \begin{macrocode}
1775 \RequirePackage{titling}[2004/08/17 v2.1d]
1776 % \end{macrocode}
1777 % \end{macro}
1778 % Provides greater control over the typesetting of the title page.
1779 % \begin{macro}{setspace}
1780 % \begin{macrocode}
1781 \RequirePackage{setspace}[2022/12/04 v6.7b set line spacing]
1782 % \end{macrocode}
1783 % Provides support for setting line spacing, such as single, one-and-a-half, and double spacing.
1784 % \end{macro}
1785 % \subsection{Other Packages}
1786 % \begin{macro}{hypenat}
1787 % \begin{macrocode}
1788 \RequirePackage[none]{hyphenat}[2009/09/02 v2.3c]
1789 % \end{macrocode}
1790 %
1791 % Provides fine control over hyphenation.
1792 % \end{macro}
1793 % \begin{macro}{iftex}
1794 % \begin{macrocode}
1795 \RequirePackage{iftex}[2022/02/03 v1.0f TeX engine tests]
1796 % \end{macrocode}
1797 % Provides a conditional command to check which TeX engine is being used.
1798 % \end{macro}
1799
1800 % \begin{macro}{xstring}
1801 % \begin{macrocode}
1802 \RequirePackage{xstring}[2013/10/13 v1.7c]
1803 % \end{macrocode}
1804 % Provides commands for advanced string manipulation.
1805 % \end{macro}
1806 % \begin{macro}{afterpackage}
1807 % \begin{macrocode}
1808 \RequirePackage{afterpackage}[2006/01/17 v1.1]
1809 % \end{macrocode}
1810 % Provides a command to execute code after a specific package has been loaded.
1811 % \end{macro}
1812
1813 % \subsection{Endnotes \& Footnotes}
1814 % Footnotes appear at the bottom of the page or at the end of a chapter;
1815 % endnotes appear on a separate page at the end of the text before the Bibliography.
1816 % The notes are numbered consecutively throughout the text by a raised Arabic numeral (e.g. 12)
1817 % which corresponds to the number of the note at the bottom of the page or at the end of the text.
1818 %
1819 % This is handled by the \LaTeX base report class, and no additional packages are needed
1820 % Do not use the `footnote` package, as it breaks compatibility with other packages. Consider `footnotehyper` if more advanced controls are needed.
1821
1822 % \section{Additional Variables}
1823 % \subsection{Title}
1824 % This should be defined in an inverted pyramid format, but must be manually constructed by the user.
1825 % \begin{macrocode}
1826 \def\@title{}
1827 % \end{macrocode}
1828 % \subsection{Author Name}
1829 % \begin{macrocode}
1830 \def\@author{}
1831 % \end{macrocode}
1832 % \subsection{Author's Pronouns}
1833 % \begin{macrocode}
1834 \def\@authorpronoun{}
1835 % \end{macrocode}
1836 % \subsection{Author's Previous Degrees}
1837 % \begin{macrocode}
1838 \def\@degreesheld{}
1839 % \end{macrocode}
1840 % \subsection{Author's Current Degree}
1841 % For example, Doctor of Philosphy, Master of Science
1842 % \begin{macrocode}
1843 \def\@degree{}
1844 % \end{macrocode}
1845 % \subsection{Author's Current Program}
1846 % \begin{macrocode}
1847 \def\@program{}
1848 % \end{macrocode}
1849 % \subsection{Author's Submission Date}
1850 % May, December or August and Year
1851 % \begin{macrocode}
1852 \def\@submitdate{}
1853 % \end{macrocode}
1854 % \subsection{Advisors}
1855 % \begin{macrocode}
1856 \def\@principaladvisor{}
1857 \def\@secondadvisor{}
1858 \def\@principalshort{}
1859 % \end{macrocode}
1860 % \subsection{Committee Members}
1861 % \begin{macrocode}
1862 \def\@firstreader{}
1863 \def\@secondreader{}
1864 \def\@thirdreader{}
1865 \def\@fourthreader{}
1866 \def\@fifthreader{}
1867 % \end{macrocode}
1868
1869 % \subsection{Dissertation Tag}
1870 % \begin{macrocode}
1871 \def\@type{Dissertation}
1872 \def\@LastLevel{0}
1873 % \end{macrocode}
1874
1875 % \subsection{Initialize Conditionals}
1876 % \begin{macrocode}
1877 \newif\ifcopyrightpage\copyrightpagefalse
1878 \newif\ifbigtitlepage\bigtitlepagefalse
1879 \newif\ifverybigtitlepage\verybigtitlepagefalse
1880 \newif\ifapp\appfalse
1881 % \end{macrocode}
1882
1883 % \subsection{Initialize Counts}
1884 % \begin{macrocode}
1885 \newcount\numcomm \numcomm=4
1886 \newcount\numadv \numadv=1
1887 % \end{macrocode}
1888
1889 % \subsection{Define Section Names}
1890 % \begin{macrocode}
1891 \renewcommand*\contentsname{Table of Contents}
1892 \renewcommand*\indexname{INDEX}
1893 \renewcommand*\chaptername{Chapter}
1894 \newcommand*\listname{List of}
1895 \newcommand*\chapternamep{\chaptername s}
1896 \newcommand*\prefacename{Preface}
1897 \newcommand*\acknowledgename{Acknowledgments}
1898 \newcommand*\landacknowledgename{Land Acknowledgments}
1899 \newcommand*\dedicationname{Dedication}
1900 \newcommand*\bioname{Biography of the Author}
1901 % \end{macrocode}
1902
1903 % \section{Internal Mapping and Logic}
1904 % \begin{macrocode}
1905 \renewcommand{\author}[1]{%
1906 \ifx\empty#1\empty\else\gdef\@author{#1}\fi}
1907 \newcommand{\authorpronoun}[1]{%
1908 \ifx\empty#1\empty\else\gdef\@authorpronoun{#1}\fi}
1909 \renewcommand{\title}[1]{%
1910 \ifx\empty#1\empty\else\gdef\@title{#1}\fi}
1911 \newcommand{\degreesheld}[1]{%
1912 \ifx\empty#1\empty\else\gdef\@degreesheld{#1}\fi}
1913 \newcommand{\degree}[1]{%
1914 \ifx\empty#1\empty\else\gdef\@degree{#1}\fi}
1915 \newcommand{\program}[1]{%
1916 \ifx\empty#1\empty\else\gdef\@program{#1}\fi}
1917 \newcommand{\submitdate}[1]{%
1918 \ifx\empty#1\empty\else\gdef\@submitdate{#1}\fi}
1919 \newcommand{\principaladvisor}[2][\empty]{%
1920 \ifx\empty#1\empty\else\gdef\@principalshort{\sloppy#1}\fi%
1921 \ifx\empty#2\empty\else\gdef\@principaladvisor{\sloppy#2}\fi%
1922 }
1923 \newcommand{\secondadvisor}[1]{%
1924 \ifx\empty#1\empty\else\gdef\@secondadvisor{\sloppy#1}\fi
1925 \twoadvisors}
1926 \newcommand{\principalshort}[1]{%
1927 \ifx\empty#1\empty\else\gdef\@principalshort{#1}\fi}
1928 \newcommand{\firstreader}[1]{%
1929 \ifx\empty#1\empty\else\gdef\@firstreader{\sloppy#1}\fi
1930 \members{1}}
1931 \newcommand{\secondreader}[1]{%
1932 \ifx\empty#1\empty\else\gdef\@secondreader{\sloppy#1}\fi
1933 \members{2}}
1934 \newcommand{\thirdreader}[1]{%
1935 \ifx\empty#1\empty\else\gdef\@thirdreader{\sloppy#1}\fi
1936 \members{3}}
1937 \newcommand{\fourthreader}[1]{%
1938 \ifx\empty#1\empty\else\gdef\@fourthreader{\sloppy#1}\fi
1939 \members{4}}
1940 \newcommand{\fifthreader}[1]{%
1941 \ifx\empty#1\empty\else\gdef\@fifthreader{\sloppy#1}\fi
1942 \members{5}}
1943 \newcommand{\bibfiles}[1]{%
1944 \ifx\empty#1\empty\else\gdef\@bibfiles{#1}\fi}
1945 \newcommand{\members}[1]{\numcomm=#1}
1946 \newcommand{\twoadvisors}{\numadv=2}
1947 \newcommand{\oneadvisor}{\numadv=1}
1948 \newcommand{\thesis}{
1949 \gdef\@type{Thesis}}
1950 \newcommand{\project}{
1951 \gdef\@type{Project}}
1952 \newcommand{\compresstitlepage}[1][1]{
1953 \ifcase#1
1954 \relax
1955 \or
1956 \bigtitlepagetrue
1957 \or
1958 \bigtitlepagetrue
1959 \verybigtitlepagetrue
1960 \fi
1961 }
1962 \renewcommand{\bibname}{References}
1963 % \end{macrocode}
1964 %
1965 % \section{General Formatting}
1966
1967 % \subsection{Line Numbering on Draft Mode}
1968 % \begin{macrocode}
1969 \ifdraft{\AtBeginDocument{\linenumbers}}\fi
1970 % \end{macrocode}
1971 %
1972 % \section{Style and Format}
1973 % \subsection{Recommended Fonts \& Point Size}
1974 % The text’s body font must also be used in headers, page numbers, and footnotes.\footnote{we use fontspec to load system fonts with XeLaTeX or LuaLaTeX}.
1975 % Exceptions are made only for tables and figures created with different software and inserted into the document.
1976 % \begin{itemize}
1977 % \item Arial – 10 pt
1978 % \item Century – 11 pt
1979 % \item Courier New – 10 pt
1980 % \item Garamond – 12 pt\footnote{In the maine-thesis class, we set EBGaramond as default since it is widely available.}
1981 % \item Georgia – 11 pt
1982 % \item Lucida Bright – 10 pt
1983 % \item Microsoft Sans Serif – 10 pt
1984 % \item Tahoma – 10 pt
1985 % \item Times New Roman – 12 pt
1986 % \item Trebuchet MS – 10 pt
1987 % \item Verdana – 10 pt
1988 % \end{itemize}
1989 % \begin{macrocode}
1990 \setmainfont{EB Garamond}
1991 % \end{macrocode}
1992 %
1993 % \subsection{Geometry}
1994 % \begin{itemize}
1995 % \item Page Size: Standard Letter 8.5 by 11 inches
1996 % \item Margins: 1 inch for all margins
1997 % \item Spacing: Double spacing except for degree information on the Abstract \& Block quotations, footnotes, and bibliographies: single spacing within each entry but double-spacing between each entry
1998 % \end{itemize}
1999 %
2000 % \begin{macrocode}
2001 \geometry{
2002 letterpaper,
2003 margin=1in,
2004 left=\@margg,
2005 headsep=0.4in,
2006 headheight=14pt,
2007 footskip=30pt,
2008 marginparwidth=40pt,
2009 marginparsep=10pt}
2010 % \end{macrocode}
2011 % \subsection{Additional Page Format}
2012 % \begin{macrocode}
2013 \setlength{\droptitle}{-60pt} %% adjust headspace of title page and chapter headings as needed.
2014 \setcounter{secnumdepth}{\value{secnumdefault}}
2015 \setcounter{tocdepth}{\value{secnumdefault}}
2016 \raggedbottom
2017 \raggedright
2018 \parindent=1.5em\relax
2019 \markboth{}{}
2020 % \end{macrocode}
2021
2022 % \subsection{Prepvent Widows and Orphans}
2023 % \begin{macrocode}
2024 \clubpenalty=10000
2025 \widowpenalty=10000
2026 % \end{macrocode}
2027
2028 % \subsection{Font Parameter}
2029 % \begin{macrocode}
2030 \def\verbatim@font{\rmfamily}
2031 % \end{macrocode}
2032 % \subsection{Spacing for Title Page and Headings}
2033 % \begin{macro}{\loftspacing}
2034 % \begin{macrocode}
2035 \ifmt@loftspace
2036 \newcommand*\loftspacing{10}
2037 \else
2038 \newcommand*\loftspacing{0}
2039 \fi
2040 % \end{macrocode}
2041 % \end{macro}
2042
2043 % \subsection {Numbering on Landscape Pages}
2044 % \begin{macro}{mtlandscape}
2045 % \begin{macrocode}
2046 \fancypagestyle{mylandscape}{%
2047 \fancyhf{} % Clear header/footer fields
2048 \renewcommand{\headrulewidth}{0pt}
2049 \renewcommand{\footrulewidth}{0pt}
2050
2051 % Add the page number to the page background
2052 % The star (*) makes it apply to the current page only
2053 \AddToShipoutPictureBG*{%
2054 % Set our reference point to the top-left of the page
2055 \AtPageUpperLeft{%
2056 % Position the page number in the middle of the right margin
2057 \put(\dimexpr\paperwidth-0.75in\relax, -0.5\paperheight){%
2058 \makebox[0pt]{\rotatebox{90}{\thepage}}%
2059 }%
2060 }%
2061 }%
2062 }
2063
2064 % 2. Define the improved landscape environment
2065 \newenvironment{mtlandscape}{%
2066 \clearpage
2067 % Set custom margins for the landscape orientation
2068 \newgeometry{margin=1in}
2069 \begin{landscape}%
2070 % Apply our custom page style
2071 \thispagestyle{mylandscape}%
2072 }{%
2073 \end{landscape}% Use \end{landscape} if using pdflscape
2074 \clearpage
2075 % IMPORTANT: Restore the original document geometry
2076 \restoregeometry
2077 }
2078
2079 % \end{macrocode}
2080 % \end{macro}
2081
2082
2083
2084
2085 % \section{Caption Format}
2086 % This customized the output from the captions package
2087 % \begin{itemize}
2088 % \item Tables/figures must be numbered and titled. Further explanatory information provided in a caption that is not part of the title should not appear on the List of Tables/Figures.
2089 % \item The tables/figures are numbered separately from each other. Each group is numbered consecutively throughout the entire manuscript or by chapter using a decimal numbering system (e.g., the third table in chapter two will be Table 2.3., and the third figure in chapter two will be Figure 2.3.). The same system should be used for numbering figures AND tables.
2090 % \item All tables/figures must fit into the required page margins.
2091 % \item The title and caption of the table/figure are part of the text and must be the same font size and style of the body of the manuscript. It is acceptable for the font within the table/figure to be as small as 9-point font.
2092 % \item Tables/figures must be placed in the text as they are mentioned. If the Table/Figure is larger than one-half of the page it must be placed on a page of its own.
2093 % \item Tables/figures that extend onto a second page must be labeled “Table/Figure \# Continued”
2094 % \item Appendix tables/figures must be numbered separately (e.g., the third table in Appendix A would be numbered Table A.3.) and must be included in the List of Tables.
2095 % \item Photographs must be originals or high-quality reproductions. All photographs must have captions.
2096 %\end{itemize}
2097
2098 % \begin{macrocode}
2099 \DeclareCaptionFormat{thesis}
2100 {
2101 \textbf{#1#2}\textit{\small #3}
2102 }
2103 \captionsetup{format=thesis}
2104 % \end{macrocode}
2105 %
2106 % Position Float Figures at the top of the page (per graduate school requirement)
2107 % \begin{macrocode}
2108 \setlength{\headsep}{0em}
2109 \setlength{\@fptop}{0pt}
2110 % \end{macrocode}
2111 % \section{Heading Format Definitions}
2112 % \begin{macro}{addot}
2113 % \begin{macrocode}
2114 \def\adddot#1{#1.\thinspace}
2115 % \end{macro}
2116 % \begin{macro}{addul}
2117 \def\addul#1{\underline{#1}}
2118 % \end{macro}
2119 % \begin{macro}{adddotul}
2120 \def\adddotul#1{\underline{#1}.\thinspace}
2121 % \end{macrocode}
2122 % \end{macro}
2123 %
2124 % \begin{macro}{\apaheadings}
2125 %
2126 % The APA 7 format uses a five-level heading system. The critical features are:
2127 % \begin{itemize}
2128 % \item Level 1 (Chapter): Centered and bold, with uppercase text.
2129 % \item Levels 2 \& 3 (Section \& Subsection): Flush left, with level 2 bold and level 3 bold and italic.
2130 % \item Levels 4 \& 5 (Subsubsection \& Paragraph): Run-in headings, meaning the text follows on the same line. Level 4 is bold, and level 5 is bold and italic. Both are followed by a period.
2131 % \end{itemize}
2132 %
2133 % \begin{macrocode}
2134 \newcommand{\apaheadings}{%
2135 % \end{macrocode}
2136 % Table of Contents formatting
2137 % \begin{macrocode}
2138 \setcounter{tocdepth}{4}
2139 \setcounter{secnumdefault}{0}
2140 % \end{macrocode}
2141
2142 % Chapter Titles
2143 % \begin{macrocode}
2144 \titleformat{\chapter}[display]{\normalfont\centering\bfseries}{\@chapapp\thinspace \thechapter}{-3pt}{\MakeTextUppercase}
2145 \titlespacing{\chapter}{0pt}{50pt}{15pt}
2146 % \end{macrocode}
2147 % First Level Headings
2148 % \begin{macrocode}
2149 \titleformat{\section}{\normalfont\bfseries}{}{0em}{}
2150 \titlespacing{\section}{0pt}{3.5ex plus 1ex minus .2ex}{2.3ex plus .2ex}
2151 % \end{macrocode}
2152 % Second Level Headings
2153 % \begin{macrocode}
2154 \titleformat{\subsection}{\normalfont\bfseries\itshape}{}{0em}{}
2155 \titlespacing{\subsection}{0pt}{3.25ex plus 1ex minus .2ex}{1.5ex plus .1ex}
2156 % \end{macrocode}
2157 % Third Level Headings
2158 % \begin{macrocode}
2159 \titleformat{\subsubsection}[runin]{\normalfont\bfseries}{}{1em}{\adddot}
2160 \titlespacing{\subsubsection}{\parindent}{3.25ex plus 1ex minus .2ex}{0pt}[1em]
2161 % \end{macrocode}
2162 % Fourth Level Headings
2163 % \begin{macrocode}
2164 \titleformat{\paragraph}[runin]{\normalfont\bfseries\itshape}{}{1em}{\adddot}
2165 \titlespacing{\paragraph}{\parindent}{3.25ex plus 1ex minus .2ex}{0pt}[1em]
2166 }
2167 % \end{macrocode}
2168 % \end{macro}
2169 %
2170 % \begin{macro}{\chicagoheadings}
2171 %The Chicago format, as defined here, has a clear hierarchy with varying alignment and capitalization. Its critical features are:
2172 % \begin{itemize}
2173 % \item Levels 1 \& 2 (Chapter \& Section): Centered. Level 1 is bold and uppercase, while level 2 is regular and uppercase.
2174 % \item Level 3 (Subsection): Flush left, bold, and italic. The text is also in uppercase.
2175 % \item Level 4 (Subsubsection): Flush left with normal roman font. The text is in sentence case.
2176 % \item Level 5 (Paragraph): A run-in heading that is bold and italic, followed by a period.
2177 % \end{itemize}
2178 %
2179 % \begin{macrocode}
2180 \newcommand{\chicagoheadings}{%
2181 % \end{macrocode}
2182 % Table of Contents formatting
2183 % \begin{macrocode}
2184 \setcounter{tocdepth}{3}
2185 \setcounter{secnumdefault}{3}
2186 % \end{macrocode}
2187 % Level 1: Centered, Boldface, Headline-style
2188 % \begin{macrocode}
2189 \titleformat{\chapter}[display]{\normalfont\centering\bfseries}{\@chapapp\thinspace \thechapter}{-3pt}{\MakeTextUppercase}
2190 \titlespacing{\chapter}{0pt}{50pt}{15pt}
2191 % \end{macrocode}
2192 % Level 2: Centered, Regular, Headline-style
2193 % \begin{macrocode}
2194 \titleformat{\section}{\normalfont\centering\normalsize}{\thesection}{1.5ex}{\MakeTextUppercase}
2195 \titlespacing{\section}{0pt}{3.5ex plus 1ex minus .2ex}{2.3ex plus .2ex}
2196 % \end{macrocode}
2197 % Level 3: Flush Left, Bold Italic, Headline-style
2198 % \begin{macrocode}
2199 \titleformat{\subsection}{\normalfont\bfseries\itshape\normalsize}{\thesubsection}{1em}{\MakeTextUppercase}
2200 \titlespacing{\subsection}{0pt}{3.25ex plus 1ex minus .2ex}{1.5ex plus .1ex}
2201 % \end{macrocode}
2202 % Level 4: Flush left, Roman type, Sentence-style
2203 % \begin{macrocode}
2204 \titleformat{\subsubsection}{\normalfont\normalsize}{\thesubsubsection}{1em}{}
2205 \titlespacing{\subsubsection}{0pt}{3.25ex plus 1ex minus .2ex}{0pt plus .1ex}
2206 % \end{macrocode}
2207 % Level 5: Run in, Bold Italic, Sentence-style, with period
2208 % \begin{macrocode}
2209 \titleformat{\paragraph}[runin]{\normalfont\bfseries\itshape}{\theparagraph}{1em}{\adddot}
2210 \titlespacing{\paragraph}{\parindent}{3.25ex plus 1ex minus .2ex}{0pt}[1em]
2211 }
2212 % \end{macrocode}
2213 % \end{macro}
2214 %
2215 % \begin{macro}{\mainethesisheadings}
2216 % The format that was provided in the old DOCX template from the Graduate School
2217 %\begin{itemize}
2218 % \item Underlining: It uses underlining for several heading levels.
2219 % \item Levels 1-3: Level 1 (Chapter) is centered and bold. Level 2 and 3 (Section and Subsection) are flush left and bold. Level 2 is followed by an underline, and level 3 is a run-in heading that is bold, followed by a period and underline.
2220 % \item Levels 4-5: The fourth- and fifth-level headings are also run-in, with the fourth being bold and underlined, and the fifth (paragraph) being regular text with a period and underline.
2221 % \end{itemize}
2222 %
2223 % \begin{macrocode}
2224 \newcommand{\mainethesisheadings}{%
2225 % \end{macrocode}
2226 % \begin{macrocode}
2227 \setcounter{tocdepth}{3}
2228 \setcounter{secnumdefault}{3}
2229 % \end{macrocode}
2230 % Chapter Titles
2231 % \begin{macrocode}
2232 \titleformat{\chapter}[display]{\normalfont\centering\bfseries}{\@chapapp\thinspace \thechapter}{-3pt}{\MakeTextUppercase}
2233 \titlespacing{\chapter}{0pt}{50pt}{15pt}
2234 % \end{macrocode}
2235 % First Level Headings
2236 % \begin{macrocode}
2237 \titleformat{\section}{\normalfont\bfseries}{}{0pt}{\addul}
2238 \titlespacing{\section}{0pt}{3.5ex plus 1ex minus .2ex}{2.3ex plus .2ex}
2239 % \end{macrocode}
2240 % Second Level Headings
2241 % \begin{macrocode}
2242 \titleformat{\subsection}{\normalfont\bfseries}{}{0pt}{}
2243 \titlespacing{\subsection}{0pt}{3.25ex plus 1ex minus .2ex}{1.5ex plus .1ex}
2244 % \end{macrocode}
2245 % Third Level Headings
2246 % \begin{macrocode}
2247 \titleformat{\subsubsection}[runin]{\normalfont\bfseries}{}{0pt}{\adddotul}
2248 \titlespacing{\subsubsection}{0pt}{3.25ex plus 1ex minus .2ex}{0pt}
2249 % \end{macrocode}
2250 % Fourth Level Headings
2251 % \begin{macrocode}
2252 \titleformat{\paragraph}[runin]{\normalfont}{}{0pt}{\adddotul}
2253 \titlespacing{\paragraph}{0pt}{3.25ex plus 1ex minus .2ex}{0pt}
2254 }
2255 % \end{macrocode}
2256 % \end{macro}
2257 %
2258 % \begin{macro}{\idecimalheadings}
2259 % The iDecimal format emphasizes a clear decimal numbering system. Its critical features are:
2260 %\begin{itemize}
2261 % \item Numbering: All heading levels are numbered, which is more explicit than some other styles.
2262 % \item Consistency: The style maintains a consistent use of bold for all heading levels.
2263 % \item Alignment: Headings are flush left, except for the chapter title, which is centered.
2264 % \item Run-in Headings: The last two levels are run-in, with a period at the end.
2265 % \end{itemize}
2266 %
2267 % \begin{macrocode}
2268 \newcommand{\idecimalheadings}{%
2269 % \end{macrocode}
2270
2271 % \begin{macrocode}
2272 \setcounter{tocdepth}{4}
2273 \setcounter{secnumdefault}{4}
2274 % \end{macrocode}
2275
2276 % Chapter Titles: Centered and bold
2277 % \begin{macrocode}
2278 \titleformat{\chapter}[display]{\normalfont\centering\bfseries}{\@chapapp\thinspace \thechapter}{1em}{}
2279 \titlespacing{\chapter}{0pt}{50pt}{15pt}
2280 % \end{macrocode}
2281 % Level 1 Headings: Bold, followed by a line break
2282 % \begin{macrocode}
2283 \titleformat{\section}{\normalfont\bfseries}{\thesection}{1em}{}
2284 \titlespacing{\section}{0pt}{3.5ex plus 1ex minus .2ex}{2.3ex plus .2ex}
2285 % \end{macrocode}
2286 % Level 2 Headings: Bold, followed by a line break
2287 % \begin{macrocode}
2288 \titleformat{\subsection}{\normalfont\bfseries}{\thesubsection}{1em}{}
2289 \titlespacing{\subsection}{0pt}{3.25ex plus 1ex minus .2ex}{1.5ex plus .1ex}
2290 % \end{macrocode}
2291 % Level 3 Headings: Bold, run-in with a period, with 1em spacing between number and title
2292 % \begin{macrocode}
2293 \titleformat{\subsubsection}[runin]{\normalfont\bfseries}{\thesubsubsection}{1em}{\adddot}
2294 \titlespacing{\subsubsection}{\parindent}{3.25ex plus 1ex minus .2ex}{0pt}[1em]
2295 % \end{macrocode}
2296 % Level 4 Headings: Bold, run-in with a period, with 1em spacing
2297 % \begin{macrocode}
2298 \titleformat{\paragraph}[runin]{\normalfont\bfseries}{\theparagraph}{1em}{\adddot}
2299 \titlespacing{\paragraph}{\parindent}{3.25ex plus 1ex minus .2ex}{0pt}[1em]
2300 }
2301 % \end{macrocode}
2302 % \end{macro}
2303 % \begin{macro}{\jdecimalheadings}
2304 % The jDecimal format, or Justified Decimal System, is characterized by its use of indentation in a justified, decimal format.
2305 %\begin{itemize}
2306 % \item Indentation: It uses increasing indentation for lower-level headings. For example, subsection has 1.5em indentation, and subsubsection has 3.8em.
2307 % \item Uppercase: It uses uppercase for both chapters and sections.
2308 % \item Consistency: Like the iDecimal format, it uses bolding for most levels to provide emphasis.
2309 % \end{itemize}
2310 %
2311 % \begin{macrocode}
2312 \newcommand{\jdecimalheadings}{%
2313 \setcounter{secnumdefault}{3}
2314 % \begin{macrocode}
2315 % Chapter Titles
2316 \titleformat{\chapter}[display]{\normalfont\centering\bfseries\normalsize}{\@chapapp \thinspace \thechapter}{-3pt}{\MakeUppercase}
2317 \titlespacing{\chapter}{0pt}{0pt}{15pt}
2318 % \end{macrocode}
2319 % First Level Headings
2320 % \begin{macrocode}
2321 \titleformat{\section}{\normalfont\bfseries}{\thesection}{1.5ex}{\MakeTextUppercase}
2322 \titlespacing{\section}{0pt}{1.5ex plus .2ex minus 0pt}{.3ex plus .2ex}
2323 % \end{macrocode}
2324 % Second Level Headings
2325 % \begin{macrocode}
2326 \titleformat{\subsection}{\normalfont\bfseries}{\thesubsection}{1.5ex}{}
2327 \titlespacing{\subsection}{1.5em}{0.3ex plus .2ex minus 0pt}{.2ex plus .1ex}
2328 % \end{macrocode}
2329 % Third Level Headings
2330 % \begin{macrocode}
2331 \titleformat{\subsubsection}{\normalfont\bfseries}{\thesubsubsection}{1.5ex}{}
2332 \titlespacing{\subsubsection}{3.8em}{0.2ex plus .1ex minus 0pt}{0.2ex plus .1ex}
2333 % \end{macrocode}
2334 % Fourth Level Headings
2335 % \begin{macrocode}
2336 \titleformat{\paragraph}{\normalfont\bfseries}{\theparagraph}{1.5ex}{}
2337 \titlespacing{\paragraph}{7.0em}{3.25ex plus 1ex minus .2ex}{3.25ex plus 1ex minus .2ex}
2338 % \end{macrocode}
2339 % Fifth Level Headings
2340 % \begin{macrocode}
2341 \titleformat{\subparagraph}{\normalfont\hspace{1.5em}}{\thesubparagraph}{1.5ex}{\addul}
2342 \titlespacing{\subparagraph}{7.0em}{3.25ex plus 1ex minus .2ex}{3.25ex plus 1ex minus .2ex}
2343 }
2344 % \end{macrocode}
2345 %\end{macro}
2346 %
2347 %\subsection{Implement Heading from Options Flag}
2348 % Use Justified Decimal System style as default
2349 %
2350 % \begin{macrocode}
2351 \ifdefined\HeadingStyle
2352 \csname\HeadingStyle headings\endcsname
2353 \else
2354 \jdecimalheadings
2355 \fi
2356 % \end{macrocode}
2357 %
2358 % \section{Page Style}
2359 % \subsection{Bottom of Page}
2360 % \begin{macrocode}
2361 \newcommand{\ps@bottom}{%
2362 \renewcommand{\@oddhead}{%
2363 \ifdraft\drafttext\hfil\today\hfil\drafttext\else\fi}%
2364 \renewcommand{\@evenhead}{\@oddhead}
2365 \renewcommand{\@oddfoot}{%
2366 \ifdraft\drafttext\hfil\thepage
2367 \hfil\drafttext\else\hfil\thepage\hfil\fi}
2368 \renewcommand{\@evenfoot}{\@oddfoot}
2369 }
2370 % \end{macrocode}
2371 %
2372 % \subsection{Empty Page}
2373 % \begin{macrocode}
2374 \renewcommand{\ps@empty}{%
2375 \renewcommand{\@oddhead}{%
2376 \ifdraft\drafttext\hfil\today\hfil\drafttext\else\fi}%
2377 \renewcommand{\@evenhead}{\@oddhead}
2378 \renewcommand{\@oddfoot}{%
2379 \ifdraft\drafttext\hfil\drafttext\else\fi}
2380 \renewcommand{\@evenfoot}{\@oddfoot}
2381 }
2382 % \end{macrocode}
2383 %
2384
2385 % \subsection{Top of Page}
2386 % \begin{macrocode}
2387 \newcommand{\ps@top}{%
2388 \renewcommand{\@oddhead}{%
2389 \ifdraft\drafttext\hfil\today\hfil\drafttext\else\thepage\fi}%
2390 \renewcommand{\@evenhead}{%
2391 \ifdraft\drafttext\hfil\today\hfil\drafttext\else\thepage\fi}%
2392 \renewcommand{\@oddfoot}{%
2393 \ifdraft\drafttext\hfil\thepage\hfil\drafttext\else\fi}%
2394 \renewcommand{\@evenfoot}{\@oddfoot}%
2395 }
2396 % \end{macrocode}
2397 %
2398
2399 % \subsection{Plain Page}
2400 % \begin{macrocode}
2401 \pagestyle{\mt@pagestyle}
2402 \renewcommand{\ps@plain}{\csname ps@\mt@pagestyle\endcsname}
2403 % \end{macrocode}
2404 %
2405
2406 % \section{Title Page Format}
2407 % The Title Page is the first page of the manuscript. It is considered page “i”, but the number does not appear on the page.
2408 % The following should be CENTERED included on the title page:
2409 % \begin{itemize}
2410 % \item Title of thesis in ALL CAPS, bold, and inverted pyramid format
2411 % \item The student’s full name as it appears in University records
2412 % \item Previous degree(s) earned
2413 % \item A statement of fulfilling requirements for the degree sought
2414 % \item Institution name\: The Graduate School
2415 % \item Institution name\: The University of Maine
2416 % \item The month and year of the student’s graduation date
2417 % \item The advisory committee members (single space \& left justify if necessary to keep on one page)
2418 % \end{itemize}
2419 %
2420 % Note: The first name(s) listed is the Advisor’s (or Co-Advisors’) and their title(s) followed by the names and titles of the remaining committee members.
2421 % Do not include degrees such as “Dr.” on the title page. \footnote{this requires review of the package specifications, and additional documentation for its use}
2422 % This page is to acknowledge committee members exclusively,
2423 % “Readers” are recognized in the Acknowledgements.
2424 % \subsection{Parameters for Make Title}
2425 % The maine-thesis class now uses \texttt{maketitle} instead of \texttt{titlepage}.
2426 %
2427 % \begin{macrocode}
2428 \date{}
2429 % \end{macrocode}
2430 %% an empty date prevents the date from displaying on the title page
2431
2432 % \subsubsection{Pre Title Formatting}
2433 % \begin{macrocode}
2434 \pretitle{
2435 \begin{center}
2436
2437 \bfseries\MakeTextUppercase
2438 }
2439 % \end{macrocode}
2440 %
2441
2442 % \subsubsection{Post Title Formatting}
2443 % \begin{macrocode}
2444 \posttitle{
2445 \end{center}
2446 }
2447 % \end{macrocode}
2448 %
2449
2450 % \subsubsection{Pre Author Formatting}
2451 % \begin{macrocode}
2452 \preauthor{
2453 \begin{center}
2454 By \\
2455 }
2456 % \end{macrocode}
2457 %
2458
2459 % \subsubsection{Post Author Formatting}
2460 % \begin{macrocode}
2461 \postauthor{
2462 \\
2463 \@degreesheld
2464 \end{center}
2465 }
2466 % \end{macrocode}
2467 %
2468
2469 % \subsubsection{Title Page Hook Formatting}
2470 % \begin{macrocode}
2471 \renewcommand{\maketitlehooka}{
2472 \thispagestyle{empty}
2473 \ifverybigtitlepage
2474 \onehalfspacing
2475 \else
2476 \doublespacing
2477 \fi
2478 }
2479 % \end{macrocode}
2480
2481 % \begin{macrocode}
2482 \renewcommand{\maketitlehookd}{
2483 \begin{center}
2484 A \MakeTextUppercase{\@type}\\[4pt]
2485 Submitted in Partial Fulfillment of the\\
2486 Requirements for the Degree of\\
2487 \expandafter{\@degree}\\
2488 (in \expandafter{\@program})\\
2489 \vskip 0.5in
2490 The Graduate School\\
2491 The University of Maine\\
2492 \expandafter{\@submitdate}
2493 \vfill
2494 \end{center}
2495 \ifbigtitlepage
2496 \singlespacing
2497 \fi
2498 \begin{flushleft}
2499 Advisory Committee:
2500 \begin{list}{}{%
2501 \setlength{\itemsep}{0pt}%
2502 \setlength{\topsep}{0in}%
2503 \setlength{\partopsep}{0pt}%
2504 \setlength{\itemindent}{-\parindent}%
2505 \setlength{\leftmargin}{1cm}%
2506 }
2507 % \end{macrocode}
2508 % Check if the principal advisor is defined before printing
2509 % \begin{macrocode}
2510 \ifx\@principaladvisor\empty\else
2511 \item{\@principaladvisor, %
2512 \ifnum\numadv=2%
2513 Co-%
2514 \fi%
2515 Advisor}
2516 \fi
2517 % \end{macrocode}
2518 % Check for second advisor before printing
2519 % \begin{macrocode}
2520 \ifx\@secondadvisor\empty\else
2521 \item{\@secondadvisor, Co-Advisor}
2522 \fi
2523 % \end{macrocode}
2524 % Check for each reader before printing
2525 % \begin{macrocode}
2526 \ifx\@firstreader\empty\else
2527 \item{\@firstreader}
2528 \fi
2529 \ifx\@secondreader\empty\else
2530 \item{\@secondreader}
2531 \fi
2532 \ifx\@thirdreader\empty\else
2533 \item{\@thirdreader}
2534 \fi
2535 \ifx\@fourthreader\empty\else
2536 \item{\@fourthreader}
2537 \fi
2538 \ifx\@fifthreader\empty\else
2539 \item{\@fifthreader}
2540 \fi
2541 \end{list}
2542 \end{flushleft}
2543 }
2544 % \end{macrocode}
2545
2546
2547 % \section{Table of Contents Formatting}
2548 % All chapter divisions and subsections must be included in the Table of Contents and labeled exactly as they appear in the text.
2549 % \subsection{Unlisted Sections}
2550 % The Copyright page, Abstract, and Table of Contents are NOT listed in the Table of Contents. \footnote{this is handled within each of the enviornment definitions}
2551 % \subsection{Chapter Divisions and Subsections}
2552 % All chapter divisions and subsections must be listed in the Table of Contents. Regardless of the system of headings being used for organizing the text of the manuscript (headings system or decimal system), all sub-divisions should be indented appropriately in the Table of Contents.
2553 % One system should be used consistently throughout the entire manuscript to define the chapter divisions and subsections.\footnote{five styles are provided here}
2554
2555 % \subsection{Table of Contents Font Specs}
2556 % \begin{macrocode}
2557 \renewcommand{\cftchapfont}{\normalfont\bfseries\MakeUppercase}
2558 \renewcommand{\cftchappagefont}{\normalfont}
2559 \renewcommand{\cftloftitlefont}{\normalfont\bfseries}
2560
2561 % \end{macrocode}
2562
2563 % \subsection{Add List of Figures and List of Tables to TOC}
2564 % The package tocbibind has been removed fo compatibility
2565 % \begin{macrocode}
2566 \renewcommand*\listfigurename{LIST OF FIGURES}
2567 \renewcommand*\listtablename{LIST OF TABLES}
2568 \renewcommand{\listoffigures}{%
2569 \@ifundefined{chapter}{%
2570 \section*{\listfigurename}%
2571 \addcontentsline{toc}{section}{\MakeUppercase\listfigurename}%
2572 }{%
2573 \chapter*{\listfigurename
2574 \@mkboth{\listfigurename}{\listfigurename}}%
2575 \addcontentsline{toc}{chapter}{\MakeUppercase\listfigurename}%
2576 }%
2577 \@starttoc{lof}%
2578 }
2579
2580 \renewcommand{\listoftables}{%
2581 \@ifundefined{chapter}{%
2582 \section*{\listtablename}%
2583 \addcontentsline{toc}{section}{\MakeUppercase\listtablename}%
2584 }{%
2585 \chapter*{\listtablename
2586 \@mkboth{\listtablename}{\listtablename}}%
2587 \addcontentsline{toc}{chapter}{\MakeUppercase\listtablename}%
2588 }%
2589 \@starttoc{lot}%
2590 }
2591 % \end{macrocode}
2592
2593 % \subsection{Define Enviornment for Custom Thesis List}
2594 % \begin{macrocode}
2595 \newenvironment{thesislist}[1]{%
2596 \chapter*{\listname\ #1}
2597 \addcontentsline{toc}{chapter}{{\texorpdfstring{\MakeTextUppercase{\listname\ #1}}{\listname\ #1}}}
2598 \begingroup
2599 \parindent=0pt
2600 \leftskip=0pt
2601 }{\par\endgroup}
2602 % \end{macrocode}
2603
2604 %% Define Leader Dots
2605 % \subsection{Leader Dots in the Table of Cotents}
2606 % Leader dots must be used to connect the chapter divisions/subsection headings to their respective page numbers.
2607 % A minimum of 5 leader dots between the chapter divisions/subsections and the page numbers is required (i.e. the text of the headings should not extend into the area where the page numbers are placed).
2608 % \begin{macrocode}
2609 \renewcommand{\cftdotsep}{2}
2610 \renewcommand{\cftchapleader}{\cftdotfill{\cftdotsep}}
2611 \renewcommand{\cftsecleader}{\cftdotfill{\cftdotsep}}
2612 \renewcommand{\cftsubsecleader}{\cftdotfill{\cftdotsep}}
2613 \renewcommand{\cftfigleader}{\cftdotfill{\cftdotsep}}
2614 \renewcommand{\cfttableader}{\cftdotfill{\cftdotsep}}
2615 \renewcommand{\contentsname}{Table of Contents}
2616 % \end{macrocode}
2617
2618 % \subsubsection{Ensuring that Leaders Dots meet 5-dot-rule}
2619 % These should eventually be exposed as options with default values.
2620 % cftsecindent and cftsecnumwidth define where the title starts.
2621
2622 % \begin{macrocode}
2623 \setlength{\cftsecindent}{1em}
2624 \setlength{\cftsecnumwidth}{3em}
2625 % \end{macrocode}
2626
2627 % \begin{macrocode}
2628 \setlength{\cftchapindent}{1em}
2629 \setlength{\cftchapnumwidth}{3em}
2630 % \end{macrocode}
2631
2632 % cftsetrmarg and cftsetpnumwidth define where the dotted leader ends and where the page number starts.
2633 % \begin{macrocode}
2634 \cftsetrmarg{3cm}
2635 % \end{macrocode}
2636 % Sets the right margin for the TOC entry
2637 % \begin{macrocode}
2638 \cftsetpnumwidth{0.5cm}
2639 % \end{macrocode}
2640 % Sets the width for the page number box
2641
2642 % \section{Abstract Environment}
2643 % An abstract (not paginated), which is a clearly written, concise summary of the thesis, must be included in the manuscript. It describes the problem, the procedures or methods used, and the results and conclusions of the research. Since doctoral abstracts are included in Dissertation Abstracts International, it is extremely important to write accurately. Formulas, diagrams, or other illustrations are not included in the abstract.
2644 %
2645 % The heading of the abstract should be centered and include:
2646 % \begin{itemize}
2647 % \item Title of the thesis in ALL CAPS, bold, and inverted pyramid format
2648 % \item The author’s full name
2649 % \item The name of the thesis advisor (including degree “Dr.”)
2650 % \item A statement that the thesis is fulfilling requirements for a degree sought in a particular department
2651 % \item The month and year of the student’s graduation date
2652 % \end{itemize}
2653 % \begin{macrocode}
2654 \newcounter{mt@page}
2655 % \end{macrocode}
2656 % \begin{macro}{abstract}
2657 % \begin{macrocode}
2658 \renewenvironment{abstract}{%
2659 \doublespacing
2660 \begin{center}
2661 {\bfseries\MakeTextUppercase{\@title}}\\
2662 By\space\@author\\[4pt]
2663 \@type\ %
2664 \ifnum\numadv=2%
2665 Co-Advisors: \@principalshort and \@secondadvisor
2666 \else
2667 Advisor: \@principalshort
2668 \fi
2669 \vskip 0.33in
2670 \singlespacing
2671 An Abstract of the \@type\ Presented\\
2672 in Partial Fulfillment of the Requirements for the\\
2673 Degree of \@degree\\
2674 (in \@program)\\
2675 \@submitdate
2676 \vskip 36pt plus 2pt minus 12pt
2677 \end{center}
2678 \doublespacing
2679 \begingroup\par
2680 \pagestyle{empty}
2681 }
2682 {\cleardoublepage
2683 \par\endgroup
2684 }
2685 % \end{macrocode}
2686 % \end{macro}
2687
2688 % \subsection{Lay Abstract Environment}
2689 % \begin{macro}{layabstract}
2690 % This parallels the lay abstract, as an abreviated version with slight changes to the title text.
2691 % \begin{macrocode}
2692 \newenvironment{layabstract}[1]{%
2693 \doublespacing
2694 \begin{center}
2695 {\bfseries\MakeTextUppercase{\@title}}\\
2696 By\space\@author\\[4pt]
2697 \@type\ %
2698 \ifnum\numadv=2%
2699 Co-%
2700 \fi%
2701 Advisor%
2702 \ifnum\numadv=2%
2703 s%
2704 \fi%
2705 : \@principalshort
2706 \vskip 0.33in
2707 \singlespacing
2708 A Lay Abstract of the \@type\ Presented\\
2709 in Partial Fulfillment of the Requirements for the\\
2710 Degree of \@degree\\
2711 (in \@program)\\
2712 \@submitdate
2713 \vskip 26pt plus 2pt minus 12pt
2714 \end{center}
2715 Keywords: \MakeLowercase{#1}
2716 \vskip 26pt plus 2pt minus 12pt
2717 \doublespacing
2718 \begingroup\par
2719 \pagestyle{empty}
2720 }
2721 {\cleardoublepage
2722 \par\endgroup
2723 }
2724 % \end{macrocode}
2725 % \end{macro}
2726
2727 % \section{Acknowledgements Environment}
2728
2729 % \begin{macro}{acknowledgements}
2730 % \begin{macrocode}
2731 \newenvironment{acknowledgements}{%
2732 \chapter*{\acknowledgename}
2733 \addcontentsline{toc}{chapter}{\texorpdfstring{\MakeTextUppercase{\acknowledgename}}{\acknowledgename}}
2734 \doublespacing
2735 \begingroup
2736 }{\par\endgroup}
2737 % \end{macrocode}
2738 % \end{macro}
2739
2740 % \section{Land Acknowledgements Environment}
2741 %University of Maine graduate students are expected to include a statement in their final thesis or dissertation that acknowledges that their graduate study has taken place on the ancestral lands of the Wabanaki Tribal Nations. The Graduate School acting through the Graduate Board recommends two nonexclusive options for a tribal land acknowledgement. The first option is to include the statement that was developed by the President’s Council on Diversity, Equity, and Inclusion and adopted by the University of Maine in the acknowledgments section of the thesis/dissertation.
2742 %\footnote{The `glsa` command supports this default option.}
2743 %The second option, which may be especially relevant to graduate students undertaking qualitative research studies is to include a researcher positionality statement in the thesis/dissertation.
2744 %\footnote{The LandAcknowledgements Enviornment supports this option.}
2745 %
2746 %Graduate programs supporting option two should provide resources to graduate students electing this option. The development of a researcher positionality statement that acknowledges the land may be used to complement the formal University land acknowledgment statement or may be used as an alternative to this statement.
2747 %
2748 %\subsection{Custom Land Acknowledgements}
2749 % \begin{macro}{landacknowledgements}
2750 % \begin{macrocode}
2751 \newenvironment{landacknowledgements}{%
2752 \chapter*{\landacknowledgename}
2753 \addcontentsline{toc}{chapter}{\texorpdfstring{\MakeTextUppercase{\landacknowledgename}}{\landacknowledgename}}
2754 \doublespacing
2755 \begingroup
2756 }{
2757 \cleardoublepage
2758 \par\endgroup
2759 }
2760 % \end{macrocode}
2761 % \end{macro}
2762
2763 % \subsection{Graduate School Land Acknowledgement}
2764 % Default GLSA Land Acknowledgement. Please check to see if this has been updated and file an issue as necessary to patch.
2765 % \begin{macro}{glsa}
2766 % \begin{macrocode}
2767 \newcommand{\glsa}{%
2768 \chapter*{UNIVERSITY OF MAINE GRADUATE SCHOOL LAND ACKNOWLEDGMENT}
2769 The University of Maine recognizes that it is located on Marsh Island in the homeland of Penobscot people, where issues of water and territorial rights, and encroachment upon sacred sites, are ongoing. Penobscot homeland is connected to the other Wabanaki Tribal Nations— the Passamaquoddy, Maliseet, and Micmac—through kinship, alliances, and diplomacy. The University also recognizes that the Penobscot Nation and the other Wabanaki Tribal Nations are distinct, sovereign, legal and political entities with their own powers of self-governance and self-determination.
2770 \vfill
2771 \clearpage
2772 }
2773 % \end{macrocode}
2774 % \end{macro}
2775
2776 % \section{Pagination}
2777 % \begin{itemize}
2778 % \item Pagination: Check pagination carefully. Account for all pages.
2779 % \item The Title Page is counted as page “i” but the number does not appear on the page.
2780 % \item Excluding the Abstract, all other pages of the thesis are numbered including display (optional) pages.
2781 % \item The preliminary pages, starting with the Copyright Notice (if included), are marked by lowercase Roman numerals (ii, iii, iv, v, vi, etc.).
2782 % \item Beginning with the first page of the text, all pages including the appendices, are numbered consecutively with Arabic numerals (1, 2, 3, 4, etc.). The following table displays the proper pagination of all parts of the thesis and which pages should be listed on the Table of Contents.
2783 % \item Page numbers appear either on the top right or bottom center of the page. Page numbers need not fall within the required margins of the text, yet they must not appear closer than half an inch from the top, one inch from the right, or half an inch from the bottom edge of the page. The page numbers’ location and font style must be consistent throughout the manuscript.
2784 % \end{itemize}
2785 % \begin{macro}{\preliminary}
2786 % Contents following this tag are front matter with roman numeral page numbering
2787 % \begin{macrocode}
2788 \newcommand{\preliminary}{%
2789 \pagenumbering{roman}
2790 % \end{macrocode}
2791 % Sets the ToC depth to chapters and above
2792 % \begin{macrocode}
2793 \setcounter{secnumdepth}{1}
2794 }
2795 % \end{macrocode}
2796 % Sets the section numbering depth to chapters and above
2797 % \end{macro}
2798 % \begin{macro}{\mainmatter}
2799 % Contents following this tag are considered chapters
2800 % \begin{macrocode}
2801 \newcommand{\mainmatter}{%
2802 \cleardoublepage
2803 \doublespacing
2804 \pagenumbering{arabic}
2805 \setcounter{secnumdepth}{\value{secnumdefault}}
2806 }
2807 % \end{macrocode}
2808 % \end{macro}
2809
2810 % \section{Biography Environment}
2811 % The Biography of the Author page is the LAST page of the thesis.
2812 % A biography of the candidate must be included in the thesis.
2813 %
2814 % For privacy reasons, students may exclude personal information. In such a case, the only line on the biography will read:
2815 % “`Name/Pronoun` is/are a candidate for the `DEGREE TYPE` degree in `FIELD OF STUDY` from The University of Maine in `Month` `Year`.”
2816 % If a student chooses to include a biography, it must be written in the third person. The absolute last line MUST read:
2817 % “`Name/Pronoun` is/are a candidate for the `DEGREE TYPE` degree in `FIELD OF STUDY` from The University of Maine in `Month` `Year`.”
2818 % \begin{macro}{biography}
2819 % \begin{macrocode}
2820 \newenvironment{biography}{%
2821 \chapter*{\bioname}
2822 \addtocontents{toc}{\protect\nopagebreak}
2823 \addcontentsline{toc}{chapter}{\texorpdfstring{\MakeTextUppercase{\bioname}}{\bioname}}
2824 \begingroup
2825 \doublespacing
2826 \thispagestyle{plain}
2827 }{%
2828 % \end{macrocode}
2829 % This section adds the required text as the last sentance of the biography.
2830 % \begin{macrocode}
2831 \par
2832 \ifx\@authorpronoun\empty
2833 \@author
2834 \else
2835 \@authorpronoun
2836 \fi%
2837 \ is a candidate for the \@degree\ degree in \@program\ from The University of Maine in \@submitdate.\par\endgroup
2838 }
2839 % \end{macrocode}
2840 % \end{macro}
2841
2842 % \section{Copyright Page}
2843 % Unless the manuscript has been formally registered (copyrighted), this page is optional.
2844 % If the student chooses to acknowledge his or her rights as an author, a copyright notice should be placed as the sole text on a page immediately following the title page.
2845 % The page is numbered but a listing does not appear on the Table of Contents.
2846 % The copyright notice is centered vertically and horizontally within the margins.
2847 % Unless there are special terms under which the work has been copyrighted the text of the notice may take either of the two forms below.
2848 % Consider Creative Commons as an option for obtaining copyright.
2849 %
2850 % Use of Third-Party Content: For additional information regarding the use of copyrighted materials, please visit the U.S. Copyright Office website at http://www.copyright.gov
2851 % \begin{macro}{\copyrightpage}
2852 % \begin{macrocode}
2853 \newcommand{\copyrightpage}{%
2854 \setcounter{page}{3}
2855 % \end{macrocode}
2856 % we must manually set the copyright page because of the runtime call of preliminary.
2857 % \begin{macrocode}
2858 \copyrightpagetrue
2859 \onehalfspacing
2860 \thispagestyle{plain}
2861 \hbox{ }
2862 \vfill
2863 \begin{center}
2864 \copyright \the\year{} \space \@author\\
2865 All Rights Reserved
2866 \end{center}
2867 \vfill
2868 \clearpage
2869 }
2870 % \end{macrocode}
2871 % \end{macro}
2872 % \section{Dedication Environment}
2873 % This page is for the author to express professional and/or personal indebtedness.
2874 % Permission(s) to use previously copyrighted materials, receipt of grant funds, recognition of “readers”, etc. are acknowledged on this page.
2875 % Students must be consistent with the use of the third (“the author”) or first person throughout.
2876 % This page is optional, but if included, it is paginated (lowercase Roman numerals) and listed in the Table of Contents.
2877 %
2878 % The use of copyrighted materials can be mentioned on the Acknowledgments page. Any copyright permission letters related to the manuscript should be included in an appendix.
2879 % \begin{macro}{dedication}
2880 % \begin{macrocode}
2881 \newenvironment{dedication}{%
2882 \chapter*{\dedicationname}
2883 \addcontentsline{toc}{chapter}{\texorpdfstring{\MakeTextUppercase{\dedicationname}}{\dedicationname}}
2884 \vskip 0.5in
2885 \doublespacing
2886 \begingroup
2887 \begin{center}
2888 }{\end{center}\par\endgroup}
2889 % \end{macrocode}
2890 % \end{macro}
2891
2892 % \section{Preface Environment}
2893 % This is an optional section in the front matter.
2894 % \begin{macro}{preface}
2895 % \begin{macrocode}
2896 \newenvironment{preface}{%
2897 \chapter*{\prefacename}
2898 \addcontentsline{toc}{chapter}{\texorpdfstring{\MakeTextUppercase{\prefacename}}{\prefacename}}
2899 \doublespacing
2900 \begingroup\setcounter{secnumdepth}{0}
2901 }{\setcounter{secnumdepth}{\value{secnumdefault}}\par\endgroup}
2902 % \end{macrocode}
2903 % \end{macro}
2904
2905 % \section{Custom Formatting for References}
2906 % The graduate school allows for field-specific citation styles, but requires.
2907 % Note that the citation style is specified in the class options above and implemented with Biblatex and Biber.
2908 %
2909 % The references command will render the references on a new page.
2910 % \begin{macrocode}
2911 \DefineBibliographyStrings{english}{
2912 bibliography = {References},
2913 }
2914 \newcommand{\references}{%
2915 \cleardoublepage
2916 \singlespacing
2917 % \end{macrocode}
2918 % The references are added to the table of contents as a chapter.
2919 % \begin{macrocode}
2920 \phantomsection
2921 \addcontentsline{toc}{chapter}{\texorpdfstring{\MakeTextUppercase{\bibname}}{\bibname}}
2922 % \end{macrocode}
2923 % The bibliography is printed from Biblatex and Biber.
2924 % \begin{macrocode}
2925 \printbibliography[title=\bibname]
2926 \doublespacing
2927 }
2928 % \end{macrocode}
2929 % Double space between entries in the bibliography, per graduate school requirements.
2930 % \begin{macrocode}
2931 \setlength\bibitemsep{\baselineskip}
2932 % \end{macrocode}
2933
2934 % \section{Leagacy Document Markup}
2935 %
2936 % This command is a custom macro that discards its argument, effectively making the text disappear. It doesn't rely on any external package for this functionality.
2937 % \begin{macro}{ignore}
2938 % \begin{macrocode}
2939 \newcommand{\ignore}[1]{}
2940 % \end{macrocode}
2941 % \end{macro}
2942 %
2943 % \begin{macrocode}
2944 %</package>
2945 % \end{macrocode}
2946 %
2947 % \section{Future Work: Class Development Needs}
2948 % \subsection{Local Names and Functions}
2949 % This package has a number of local functions and names that should not be called outside of the class. These should be refactored appropriately.
2950 % \subsection{Exposing Options}
2951 % There are a few parameters that would be useful to expose to the user to help them fine tune their document if there are small differences in font, spacing, etc.
2952 %
2953 % \Finale
2954
2955 \endinput