summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/utexasthesis/README.md
blob: 6f3a65a166e7dbfe9168835c48b006608a01c1ea (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
## University of Texas at Austin graduate thesis LaTeX style

The [Digital Submission Requirement](https://gradschool.utexas.edu/academics/theses-and-dissertations/digital-submission-requirement) page describes the requirements for Masters and Ph.D. thesis submissions.
Most `utexas.edu` URLs are fragile; if that link is dead, try searching for [utexas graduate thesis style](https://www.google.com/search?q=utexas+graduate+thesis+style).


### Instructions

1. Download the [`utexasthesis.cls`](https://raw.githubusercontent.com/linguistics/utexas-latex/master/utexasthesis.cls) (right click and "Save As...") file into your working directory
2. Replace your initial `\documentclass{...}` call with `\documentclass{utexasthesis}`
3. Fill in the required personal information by calling the following commands in your preamble (i.e., somewhere before `\begin{document}`):
   - `\title{The Title of Your Dissertation or Treatise}`
   - `\author{Full Official Name}`
     + This should match the "Name of Doctoral Candidate" field on your official "Request For Final Oral Examination" form.
   - `\graduationdate{May}{2017}`
   - `\supervisor{Supervisor Name}`
   - `\cosupervisor{Cosupervisor Name}`
     + `% \cosupervisor{}` is optional, unless you use the `masters` option (described [below](#options)),
       in which case it's required and `\othercommitteemembers{}` is ignored.
   - `\othercommitteemembers{Member's Name, Member's Name, Member's Name}`
4. Supply `\maketitle` and the other commands and environments in the proper order.
5. Use `\maketableofcontents` instead of `\tableofcontents`
6. Use `\makebibliography{yourbib}` instead of `\bibliography{yourbib}`
   (and be sure to specify a style with `\bibliographystyle{...}`).

Alternatively, you can use the [`basic.tex`](https://raw.githubusercontent.com/linguistics/utexas-latex/master/template/basic.tex) (right click and "Save As...") example as a starting point, replacing the placeholder text with your own information.
View the `pdflatex` render of `basic.tex` on GitHub at [`basic.pdf`](https://github.com/linguistics/utexas-latex/blob/master/template/basic.pdf), or [download](https://raw.githubusercontent.com/linguistics/utexas-latex/master/template/basic.pdf).


### Customizations

The formatting guide doesn't specify a required font face.
The `utexasthesis` class doesn't set one, which leaves "Computer Modern Roman" as the default font family.

You can use any font supported by your LaTeX distribution; e.g., to use the Palatino font, as in the formatting guideline's examples:

    \usepackage{palatino}

Or to use Times, along with a teletype font (which is used in URLs) that's more compact than Courier:

    \usepackage{times}
    \renewcommand*\ttdefault{cmvtt}


### Options

The `utexasthesis` class can be customized with several optional arguments,
which are supplied in the `\documentclass{}` call, e.g., `\documentclass[masters]{utexasthesis}`.

- **`masters`**: switch format to Masters thesis, which has the following effects:
  + The document type is set to "Thesis" instead of "Dissertation".
  + The degree is set to "Master of Arts" (M.A.) instead of "Doctor of Philosophy" (Ph.D.).
  + The signatures page is styled differently.
- **`copyright`**: adds a copyright page at the beginning of your thesis.
- Line spacing (defaults to `onehalfspacing` if omitted):
  + **`singlespacing`**: Use single-spacing throughout the document,
    which is prohibited by the formatting guidelines.
  + **`onehalfspacing`**: Use 1.5-spacing throughout the document.
  + **`doublespacing`**: Use double-spacing throughout the document.
- Font sizes (defaults to `12pt` if omitted):
  + **`10pt`**: Use 10 point font,
    which is not recommended by the formatting guidelines.
  + **`11pt`**: Use 11 point font,
    which is not recommended by the formatting guidelines.
  + **`12pt`**: Use 12 point font.
- **`draft`**: renders a compact version of your thesis.
  The layout does not comply with the graduate school requirements,
  but may be useful to print out drafts for review.
  + This option applies the usual `draft` class options to the underlying `report` class.
  + The copyright page is omitted even if the `copyright` option is used.
  + The signatures page is omitted.
  + The main title page is omitted.
  + Chapters do not trigger a page break.

All of these can be used in combination, separated by commas.
The few options that have overlapping effects will give priority to the last-listed argument(s) in the listings above.
E.g., `\documentclass[masters,12pt,draft,11pt]{utexasthesis}` will render the Masters thesis format in 12 point font,
even though `11pt` comes after `12pt` in the list of options.


### Packages

The following packages are imported by `utexasthesis`:

* `geometry` (to set paper size, layout dimensions, and margins)
* `fontenc`
* `setspace` (configurable via `singlespacing` / `onehalfspacing` / `doublespacing` option)
* `indentfirst` (to indent every paragraph, even at the beginning of chapters and sections)
* `natbib`
* `tocloft`
* `tocbibind`
* `url`
* `hyperref`
* `doi` (to hyperlink DOIs in bibliography)


### F.A.Q.

- **Q**: How do I number subsubsections?
     E.g., <code><i>Chap</i>.<i>Sec</i>.<i>Subsec</i>.<i>Subsubsec</i></code>

  **A**: Set the `secnumdepth` and `tocdepth` counters:
  ```latex
  % number subsubsections
  \setcounter{secnumdepth}{3} % default: 2 (which only numbers up to subsections)
  % include subsubsections in table of contents
  \setcounter{tocdepth}{3} % default: 2
  ```
  See [How to show subsections and subsubsections in TOC?](https://tex.stackexchange.com/a/17879) for details.


## License

The `utexasthesis` document class and related materials are [CC0](https://creativecommons.org/publicdomain/zero/1.0/)-licensed.
This is similar to the [Unlicense](http://unlicense.org) and [WTFPL](http://wtfpl.net).
This means I (Christopher Brown), have waived all copyright rights to this work, to the extent allowed by law.