{"id":17321810,"url":"https://github.com/rzach/ucalgmthesis","last_synced_at":"2025-04-14T16:07:17.927Z","repository":{"id":65935843,"uuid":"125543637","full_name":"rzach/ucalgmthesis","owner":"rzach","description":"A LaTeX class to produce a University of Calgary (UCalgary) graduate thesis (uses memoir class)","archived":false,"fork":false,"pushed_at":"2023-04-13T20:07:14.000Z","size":57,"stargazers_count":15,"open_issues_count":1,"forks_count":4,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-02-06T17:21:52.403Z","etag":null,"topics":["latex-template","thesis","thesis-template"],"latest_commit_sha":null,"homepage":"","language":"TeX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rzach.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-03-16T16:40:55.000Z","updated_at":"2025-02-01T00:14:55.000Z","dependencies_parsed_at":"2023-02-17T04:25:14.881Z","dependency_job_id":null,"html_url":"https://github.com/rzach/ucalgmthesis","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rzach%2Fucalgmthesis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rzach%2Fucalgmthesis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rzach%2Fucalgmthesis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rzach%2Fucalgmthesis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rzach","download_url":"https://codeload.github.com/rzach/ucalgmthesis/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240226345,"owners_count":19768065,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["latex-template","thesis","thesis-template"],"created_at":"2024-10-15T13:39:45.295Z","updated_at":"2025-02-25T17:30:47.924Z","avatar_url":"https://github.com/rzach.png","language":"TeX","funding_links":[],"categories":[],"sub_categories":[],"readme":"ucalgmthesis\n============\n\n`ucalgmthesis.cls` is a LaTeX class file that produces documents\naccording to the thesis guidelines of the [University of Calgary\nFaculty of Graduate\nStudies](https://grad.ucalgary.ca/current-students/thesis-based-students/thesis/building-thesis). It\nuses the [`memoir`](https://ctan.org/pkg/memoir?lang=en) class, which\nprovides very powerful and flexible mechanisms for book design and\nlayout. All `memoir` commands for changing chapter and section\nheadings, page layout, fancy foot- and endnotes, typesetting poems,\netc., can be used. (Memoir is meant as a replacement for the standard\nLaTeX classes, so all standard LaTeX commands such as `\\chapter`,\n`\\section`, etc., still work.) Likewise, any of `memoir`'s class\noptions can be passed as options to `ucalgmthesis`, in particular\n`12pt` to select 12 point type (11 point is the default).\n\nLicense\n-------\n\nThe files in this directory are provided under the terms of the MIT\nLicense. `natbib-oup.bst` is provided under the terms of the LaTeX\nProject Public License.\n\nUsage\n-----\n\nConsult the file `sample-thesis.tex` for an example thesis setup\nwith parts `\\include`'d from separate files. Here's a minimal file:\n```\n\\documentclass{ucalgmthesis}\n\n\\author{...}\n\\title{...}\n\\prog{...}\n\\degree{...}\n\\thesisyear{...}\n\\monthname{...}\n\n\\begin{document}\n\n\\frontmatter\n\n\\makethesistitle\n\n\\chapter{Abstract}\n\n...\n\n\\tableofcontents\n\n\\mainmatter\n\n...\n\n\\backmatter\n\n....\n\\end{document}\n```\n\nThe easiest way to get started is perhaps to rename\n`sample-thesis.tex`, change the metadata and layout options to your\nliking, and put the content of your thesis into the files it includes\n(`frontmatter.tex`, `chapter1.tex`, etc.)\n\n`ucalgmthesis` is part of TeXLive and MikTeX. If you have one of these\ninstalled (or you are working on Overleaf), you do not need the class file\n`ucalgmthesis.cls` itself in your thesis directory. You can just copy\nthe TeX and Bib file from the source directory in your TeXLive tree,\nfrom [CTAN](https://ctan.org/tex-archive/macros/latex/contrib/ucalgmthesis),\nor from the [GitHub\nrepository](https://github.com/rzach/ucalgmthesis) to get started.\n\nCommands\n--------\n\nThe class provides a number of commands to facilitate the production\nof the thesis.\n\n- `\\makethesistitle` to produce the title page\n\n- `\\degree`, `\\prog`, `\\monthname`, `\\thesisyear` are used to provide\n  the names of the degree and graduate program, and the month and year\n  of the thesis. (These are compatible with the legacy `ucalgthes1` class.)\n\n- `\\dedication` produces a dedication centered on its own page\n\n- `\\fullpagethesis` sets up the type block to have 1\" margins on all\n  sides. `\\manuscriptthesis` sets up the typeblock to have a line\n  length of about 72 characters and 25 lines per page. The package\n  options `fullpage` and `manuscript` use these at the appropriate\n  time, but you can use them after you set up your own fonts in the\n  preamble.\n\nOtherwise, all the class does is change `memoir`'s defaults to comply\nwith FGS thesis guidelines. Specifically:\n\n- All page numbers appear in the same place (centered in footer).\n- All pages except title page are numbered.\n- Front matter is numbered in roman numerals, main matter in arabic.\n- Abstract, preface, acknowledgments, dedication are included in table\n  of contents.\n- The table of contents is called \"Table of Contents\".\n\nClass options\n-------------\n\nThe class takes a number of options:\n\n- `singlespaced`, `onehalfspaced`, `doublespaced` sets up the line\n  spacing (`onehalfspaced` is the default).\n\n- `palatino`, `times`, `garamond`, `utopia`, `libertine` offer some\n  nice alternative typefaces (i.e., fonts) to the default Computer\n  Modern. Note that `garamond` uses the\n  [`garamondx`](https://ctan.org/tex-archive/fonts/garamondx?lang=en)\n  package, which is not included in the TeXLive distibution (and is\n  not available on Overleaf).\n\n- `headers` produces running heads. Per the guidelines, the running\n  heads must not be the thesis title or author's name, and must be\n  separated from the main text by a line. The class uses the chapter\n  number and title and places it flush right in the header.\n\n- `fullpage` calls `\\fullpagethesis`, so produces a thesis with 1\"\n  margins all around. This produces very long lines and is not\n  recommended for review or submission, but if you have to pay by the\n  page for printing you may want to use it.\n\n- `manuscript` sets the type size to 12 points, double spaces the\n  text, and calls `\\manuscriptthesis` to set the textblock to be about\n  72 characters wide and 25 lines high. That makes a page longer than\n  a standard manuscript page (60 characters by 25 lines, or about 250\n  words), but produces reasonably readable lines and plenty of space\n  between lines and in the margins for remarks, corrections, and\n  annotations. Recommended for the version you submit for\n  examination. You might remove the option for the final version\n  submitted to the Vault.\n\nA sample thesis file is also provided. The various parts of the thesis\nare included from subsidiary files to enable generating PDFs of the\ntitle page and individual chapters separately.\n\nSwitching from `ucalgthes1`\n---------------------------\n\nIf you are already using the `ucalgthes1` class, you don't have to do\nmuch to switch to `ucalgmthesis`:\n\n- Change `ucalgthes1` to `ucalgmthesis` in the `\\documentclass` command.\n\n- The thesis template provided with `ucalgthes1` then uses the\n  `geometry` package to set the margins to 1\" on all sides. This\n  produces atrocious results and you should remove that line. If you\n  really want the same narrow margins, use the `fullpage` class\n  option, i.e.,\n  `\\documentclass[12pt,doublespaced,fullpage]{ucalgmthesis}`.  A\n  better option for reading and reviewing the thesis is the\n  `manuscript` class option (see above). \n\n- The template also loads the `mathptmx` package to set the typeface\n  to Times New Roman. Times is a good typeface for newspapers, but not\n  for dissertations or books. Pick a different one! But if you do want\n  Times, use the `times` class option instead and delete this\n  line. (The class option loads the newer\n  [`newtx`](https://ctan.org/pkg/newtx?lang=en) packages.)\n\n- Delete all the lines from the template that say `\\pagenumbering`,\n  `\\newpage`, `\\clearpage`, `\\phantomsection`, `\\setcounter`,\n  `\\begin{singlespace}`, `\\end{singlespace}`.\n\n- Abstract and Acknowledgments just start with `\\chapter{Abstract}`\n  and `\\chapter{Acknowledgments}`.\n\n- Insert `\\frontmatter` at the very beginning, `\\mainmatter` before\n  your first real chapter, and `\\endmatter` after the last real\n  chapter and before the bibliography, etc.\n\nNote that the `ucalgmthesis` class sets much wider margins even with\nthe `manuscript` option than the `ucalgthes1` template. Lines are\nshorter than the excessively long lines resulting from just setting\nleft and right margins to 1 inch. This will change the number of pages\nin the PDF and may result in some displayed formulas and tables not\nfitting into the type block anymore. So be sure to check the result\nfor such problems.\n\nTroubleshooting and Known Issues\n--------------------------------\n\n- The font options may interact badly with other packages you\n  load. Try compiling without the font option to see if that's the\n  problem.\n\n- The font options all load the `newtxmath` or `newpxmath` packages.\n  These have to be loaded after `amsthm`, so the class loads `amsthm`\n  before it sets up these fonts. If you don't want that, leave out the\n  font option, load the font in your main document preamble, then call\n  `\\manuscriptthesis` or `\\fullpagethesis` to set the right page\n  dimensions based on the new font.\n\n- `garamond` uses the `garamondx` package. This package has a\n  restrictive license and is thus not included in the TeXLive\n  distribution. Use the\n  [`getnonfreefonts`](https://www.tug.org/fonts/getnonfreefonts/)\n  installer to download it.\n\n- The guidelines require that the official filed thesis is laid out\n  for one-sided printing (equal left and right margins). You may want\n  to print the thesis two-sided, however, e.g., to give a nice bound\n  copy to your supervisor or your mom. You can produce a version for\n  two-sided printing using the `twoside` class option of `memoir`. The\n  page layout will be altered to have spine and edge margins in the\n  golden ratio, and alternating on rectos and versos. This will\n  produce a nicer-looking page spread. However, both\n  `\\makethesistitle` and `\\mainmatter` clear to a recto (odd) page\n  even with the `openany` option, and so `twoside` will produce\n  additional blank pages in the front matter. The main text, however,\n  should have the same pagination as the \"official\" one-sided version,\n  as the size of the typeblock is the same.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frzach%2Fucalgmthesis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frzach%2Fucalgmthesis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frzach%2Fucalgmthesis/lists"}