Skip to content

Repository files navigation

Sid's PhD Thesis Compile thesis

Download: Thesis (with comments) | Submission (without comments)

Build it yourself

Requires TeX Live 2025 (or any distribution with latexmk and minted 3), Python 3, and latexminted's cwd-config support:

bash ./tools/create_latexminted_config.sh   # once, writes ~/.latexminted_config
make          # thesis.pdf
make submission  # thesis-submission.pdf
make both     # both of the above

make regenerates .latexminted_config (the SHA256 of the custom Lean 4 lexer under tools/lexers/) before compiling; if a code listing suddenly fails to highlight, make clean refreshes those hashes.


Usage details

Class options

cam-thesis supports all the options of the standard report class (on which it is based).

It also supports some custom options.

  • techreport: formats the document as a technical report (here's a sample). Here is a list of formatting points in which the technical report differs from a normal thesis (see guidelines for more information):

    • different margins (left and right margins are 25mm, top and bottom margins are 20mm),
    • normal line spacing (instead of one-half spacing),
    • no custom title page,
    • no declaration,
    • page count starts with 3,
    • if the hyperref package is used, the option pdfpagelabels=false will be passed to it.
  • firstyr: formats the document as a first-year report (here's a sample). This option removes some unneeded elements and modifies the submission note. Here is a list of formatting points in which the first year report differs from a normal thesis:

    • an appropraite subtitle is added,
    • the submission note is changed appropriately,
    • no standalone abstract,
    • no declaration,
    • no acknowledgements.
  • secondyr: formats the document as a second-year report (here's a sample). Similarly to firstyr, this style modifies the submission note and removes unneeded elements. Specially, an abstract is retained (as for this report, research is often in a more "stable" state). Here is a list of formatting points in which the second year report differs from a normal thesis:

    • an appropraite subtitle is added,
    • the submission note is changed appropriately,
    • no declaration,
    • no acknowledgements.
  • times: tells the class to use the times font.

  • glossary: puts the glossary after the TOC. The glossary contains a list of abbreviations, their explanations etc. Describe your abbreviations and add them to the glossary immediately after you introduce them in the body of your thesis. You can use the following command for this:

    \newglossaryentry{computer}
    {
      name=computer,
      description={is a programmable machine that receives input,
                   stores and manipulates data, and provides
                   output in a useful format}
    }
    

    After that, you can reference particular glossary entries like this:

    \gls{computer}
    

    You can also change the glossary style. For example, try putting this on the very top of the preamble (even before you define the document class with \documentclass[glossary]{cam-thesis}):

    \PassOptionsToPackage{style=altlong4colheader}{glossaries}
    

    Further instructions can be found on LaTeX Wikibooks or the user manual at CTAN.

    Note: glossaries is the package used to create the glossary.

  • withindex: build the index, which you can put at the and of the thesis with the following command (it will create a new unnumbered chapter):

    \printthesisindex
    

    Instructions on how to use the index can be found here.

    Note: the package makeidx is used to create the index.

  • backrefs: Add back references in the References section (here's a sample). In other words, for each reference, it adds the page(s) where it is cited.

    Note: the package backref is used to create the back references.


Q2: Where can I find the thesis formatting guidelines this class is based on?

The University of Cambridge submission guidelines:

https://www.cambridgestudents.cam.ac.uk/your-course/examinations/graduate-exam-information/submitting-and-examination/phd-msc-mlitt/submit

The University of Cambridge final submission guidelines:

https://www.cambridgestudents.cam.ac.uk/your-course/examinations/graduate-exam-information/after-examination/degree-approval-and-1

The Computer Laboratory guidelines:

https://www.cl.cam.ac.uk/local/typography/phd/

The Computer Laboratory guidelines for technical reports:

https://www.cl.cam.ac.uk/techreports/submission.html

Q5: Where can I find newer versions of the University of Cambridge logo?

The university updates its logo every now and then. You can find up-to-date logos on this page (subject to change without notice).

Download and exchange the new logos with CUni.eps and/or CUni.pdf.

Q8: How should I count the number of words in my thesis?

There is a page on the Computer Lab's web site. They recommend using this command:

ps2ascii thesis.pdf | wc -w

Q9: How can I change the College Shield?

In thesis.tex use \collegeshield{CollegeShields/<college>} with <college> as your your desired college name, as found in CollegeShields.

Alternatively, \collegeshield{CollegeShields/CUniNoText} can be used to display the University of Cambridge shield design.

About

The one with my thesis

Resources

Contributing

Stars

2 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages