dissertation-4-dissertation/README.md

534 lines
24 KiB
Markdown
Raw Normal View History

2014-06-09 19:09:11 +01:00
CUED PhD thesis template
2013-12-06 18:47:28 +00:00
========================
2016-01-11 09:59:38 +00:00
[![Join the chat at https://gitter.im/kks32/phd-thesis-template](https://badges.gitter.im/kks32/phd-thesis-template.svg)](https://gitter.im/kks32/phd-thesis-template?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
2015-06-19 22:08:36 +01:00
> A LaTeX / XeLaTeX / LuaLaTeX PhD thesis template for Cambridge University Engineering Department.
2014-07-06 12:32:04 +01:00
[![Build Status](https://api.travis-ci.org/kks32/phd-thesis-template.svg)](https://travis-ci.org/kks32/phd-thesis-template)
2014-07-06 15:07:05 +01:00
[![License MIT](http://img.shields.io/badge/license-MIT-brightgreen.svg)](license.md)
2015-06-19 23:59:43 +01:00
[![Version](http://img.shields.io/badge/version-2.0-brightgreen.svg)](https://github.com/kks32/phd-thesis-template/releases/latest)
## Author(s)
2013-12-06 18:47:28 +00:00
* Krishna Kumar
--------------------------------------------------------------------------------
## Features
2013-11-24 18:40:44 +00:00
2013-12-05 12:45:11 +00:00
* Conforms to the Student Registry PhD dissertation guidelines and CUED PhD guidelines
2015-06-19 22:08:36 +01:00
* Supports LaTeX, XeLaTeX and LuaLaTeX
2013-11-24 18:40:44 +00:00
* Adaptive Title Page: Title page adapts to title length
2015-06-19 23:22:31 +01:00
* Title page with both College and University crests.
2013-12-05 23:59:39 +00:00
* Print / On-line version: Different layout and hyper-referencing styles
2013-11-24 18:40:44 +00:00
2013-12-05 23:59:39 +00:00
* Pre-defined and custom fonts (Times / Fourier / Latin Modern) with math support
2013-11-24 18:40:44 +00:00
2015-06-19 23:22:31 +01:00
* Supports system fonts (XeLaTeX)
2013-11-24 23:26:21 +00:00
* Pre-defined and custom bibliography style support (authoryear / numbered / custom)
2013-11-24 18:40:44 +00:00
* Custom page styles: 3 Different Header / Footer styles
* Pre-defined and custom margin size
2013-11-25 11:11:21 +00:00
* A separate abstract with thesis title and author name, along with the titlepage can be generated by passing the argument `abstract` to the document class.
2013-12-05 12:45:11 +00:00
* Option to generate only specific chapters and references without the frontmatter and title page. Useful for review and corrections.
2014-06-09 19:09:11 +01:00
* Draft mode: Draft water mark, timestamp, version numbering and line numbering
* Add supervisor and/or advisor to your PhD thesis or MPhil report
* A LyX Template is now available at [https://github.com/kks32/PhDThesisLyX/](https://github.com/kks32/PhDThesisLyX/)
2014-07-15 12:41:00 +01:00
--------------------------------------------------------------------------------
2015-06-19 22:08:36 +01:00
## Building your thesis - XeLaTeX
2013-11-26 18:36:37 +00:00
2014-04-21 23:20:36 +01:00
### Using latexmk (Unix/Linux/Windows)
2015-06-19 22:08:36 +01:00
This template supports `XeLaTeX` compilation chain. To generate PDF run
2014-04-21 23:20:36 +01:00
2016-01-18 08:17:42 +00:00
latexmk -xelatex thesis.tex
makeindex thesis.nlo -s nomencl.ist -o thesis.nls
latexmk -xelatex -g thesis.tex
2014-04-21 23:20:36 +01:00
2015-06-19 22:08:36 +01:00
## Building your thesis - LuaLaTeX
### Using latexmk (Unix/Linux/Windows)
2014-06-09 19:09:11 +01:00
2015-06-19 22:08:36 +01:00
This template supports `XeLaTeX` compilation chain. To generate PDF run
2014-04-21 23:20:36 +01:00
2015-06-19 23:22:31 +01:00
latexmk -pdflatex=lualatex -pdf thesis.tex
2014-06-09 19:09:11 +01:00
2015-04-02 10:46:19 +01:00
2015-06-19 22:08:36 +01:00
## Building your thesis - LaTeX / PDFLaTeX
### Using latexmk (Unix/Linux/Windows)
This template supports `latexmk`. To generate DVI, PS and PDF run
latexmk -dvi -ps -pdf thesis.tex
2014-04-15 11:43:19 +01:00
2014-06-09 19:09:11 +01:00
### Using the make file (Unix/Linux)
2013-11-26 18:36:37 +00:00
2013-11-16 18:30:39 +00:00
The template supports PDF, DVI and PS formats. All three formats can be generated
with the provided `Makefile`.
To build the `PDF` version of your thesis, run:
make
This build procedure uses `pdflatex` and will produce `thesis.pdf`.
To produce `DVI` and `PS` versions of your document, you should run:
make BUILD_STRATEGY=latex
This will use the `latex` command to build the document and will produce
2013-12-05 23:59:39 +00:00
`thesis.dvi`, `thesis.ps` and `thesis.pdf` documents. You will need psutils installed
2013-11-16 18:30:39 +00:00
2013-11-26 18:36:37 +00:00
Clean unwanted files
2013-11-16 18:30:39 +00:00
To clean unwanted clutter (all LaTeX auto-generated files), run:
make clean
__Note__: the `Makefile` itself is take from and maintained at
[here](http://code.google.com/p/latex-makefile/).
### Shell script for PDFLaTeX (Unix/Linux)
2013-11-26 18:36:37 +00:00
Usage: `sh ./compile-thesis.sh [OPTIONS] [filename]`
2013-12-06 18:47:28 +00:00
2013-11-26 18:36:37 +00:00
[option] compile: Compiles the PhD Thesis
2013-12-06 18:47:28 +00:00
2013-12-05 23:59:39 +00:00
[option] clean: removes temporary files - no filename required
2013-11-26 18:36:37 +00:00
2014-06-09 19:09:11 +01:00
### Using the batch file on Windows OS (PDFLaTeX)
2013-11-26 18:36:37 +00:00
2013-12-06 18:47:28 +00:00
* Open command prompt and navigate to the directory with the tex file. Run:
2014-06-09 19:09:11 +01:00
2013-12-06 18:47:28 +00:00
`compile-thesis-windows.bat`.
2013-11-26 18:36:37 +00:00
2013-12-05 23:59:39 +00:00
* Alternatively, double click on `compile-thesis-windows.bat`
2013-11-26 18:36:37 +00:00
2015-06-19 22:08:36 +01:00
-------------------------------------------------------------------------------
2013-12-06 19:10:15 +00:00
## Usage details
2014-02-04 01:41:11 +00:00
Thesis information such as title, author, year, degree, etc., and other meta-data can be modified in `thesis-info.tex`
2014-06-09 19:09:11 +01:00
### Class options
2013-12-05 23:59:39 +00:00
The class file, `PhDThesisPSnPDF`, is based on the standard `book` class
It supports the following custom options in the documentclass in thesis.tex:
(Usage `\documentclass[a4paper,11pt,print]{Classes/PhDThesisPSnPDF}`)
2013-12-05 02:24:35 +00:00
* `a4paper` (default as per the University guidelines) or `a5paper`: Paper size
2013-12-05 02:24:35 +00:00
* `11pt` or `12pt`: The University of Cambridge guidelines recommend using a minimum font size of 11pt (12pt is preferred) and 10pt for footnotes. This template also supports `10pt`.
2013-11-23 18:46:46 +00:00
* `oneside` or `twoside` (default): This is especially useful for printing double side (twoside) or single side.
2013-11-19 11:32:39 +00:00
* `print`: Supports Print and Online Version with different page margins and hyperlink styles.
2014-06-09 19:09:11 +01:00
Use `print` in the options to activate Print Version with appropriate margins and page layout and view styles.
2013-11-19 11:32:39 +00:00
Leaving the options field blank will activate Online version.
2014-06-09 19:09:11 +01:00
* `custommargin`: You can alter the margin dimension for both print and online version by using the keyword `custommargin` in the options. Then you can define the dimensions of the margin in the `preamble.tex` file:
2013-12-06 19:19:36 +00:00
2014-06-09 19:09:11 +01:00
\ifsetCustomMargin
\RequirePackage[left=37mm,right=30mm,top=35mm,bottom=30mm]{geometry}
\setFancyHdr
2013-12-06 19:19:36 +00:00
\fi
`\setFancyHdr` should be called when using custom margins for proper header/footer dimensions
2013-11-25 11:11:21 +00:00
2014-06-09 19:09:11 +01:00
`\ifsetMargin` is deprecated, please use `\ifsetCustomMargin` instead.
2013-12-05 23:59:39 +00:00
* `index`: Including this option builds the index, which is placed at the end of the thesis.
Instructions on how to use the index can be found [here](http://en.wikibooks.org/wiki/LaTeX/Indexing#Using_makeidx).
_Note_: the package `makeidx` is used to create the index.
2014-06-09 19:09:11 +01:00
* `abstract`: This option enables only the thesis title page and the abstract with title and author to be printed.
2013-12-05 23:59:39 +00:00
* `chapter`: This option enables only the specified chapter and it's references. Useful for review and corrections.
2014-10-21 09:54:12 +01:00
* `draft`: The default draft mode supports some special features such as line numbers, images, and water mark with
timestamp and custom text. Position of the text can be modified in `preamble.tex`.
2014-06-09 19:09:11 +01:00
2014-10-21 09:54:12 +01:00
* `draftclassic`: This mode is similar to the default draft mode in the book class. Images are not loaded.
2014-04-21 23:20:36 +01:00
2014-06-09 19:09:11 +01:00
* `lineno`: Enables pagewise line numbering on the outer edge. You can switch-off line numbering by specifying `nolineno` in the options.
2014-10-21 09:54:12 +01:00
2014-07-15 12:27:27 +01:00
* `flushleft`: The University recommends using ragged right or flush left alignment for texts. The reason behind this is left justifying a text may exclude a certain readers. Dyslexic people find it hard to read justified text. You can enable `raggedright` option in the document class by passing `flushleft` argument. Default is flush left and right.
### Title page
The front page (title page) resizes to fit your title length. You can modify the options in `thesis-info.tex`.
* `\subtitle` (optional): Adds a subtitle to your thesis.
2014-04-21 23:20:36 +01:00
2014-07-15 12:27:27 +01:00
* `\college` (optional): This option adds the name of your college on the bottom left.
2014-07-15 12:27:27 +01:00
If `\college` is defined, the bottom of the title page will look like this:
2015-06-19 23:22:31 +01:00
King's College 2014
2014-07-15 12:27:27 +01:00
If `\college` is undefined or blank, the `degreedate` will be centered.
2015-06-19 23:22:31 +01:00
2014
The template offers support to having both the college and university crests or just one of the crests.
* `\collegeshield` (optional): Includes college crest in addition to the university crest. This reformats the front page layout.
### Abstract separate
2013-12-05 23:59:39 +00:00
* A separate abstract with the title of the PhD and the candidate name has to be submitted to the Student Registry. This can be generated using `abstract` option in the document class. Ignore subsequent warnings about skipping sections (if any).
2013-11-25 11:11:21 +00:00
2014-06-09 19:09:11 +01:00
* To generate the separate abstract and the title page, make sure the following commands are in the preamble section of `thesis.tex` file:
2013-12-06 18:47:28 +00:00
\ifdefineAbstract
\includeonly{Abstract/abstract}
\fi
2013-11-25 11:11:21 +00:00
2014-06-09 19:09:11 +01:00
### Chapter mode
* The chapter mode allows user to only print specific chapters along with references. By default, it excludes everything else in the front matter and appendices. This can done by using `chapter` option in the document class in `thesis.tex`. Ignore subsequent warnings about skipping sections (if any).
2014-06-09 19:09:11 +01:00
* To generate the separate abstract and the title page, make sure the following commands are in the preamble section of `thesis.tex` file:
\ifdefineChapter
2014-06-09 19:09:11 +01:00
\includeonly{Chapter3/chapter3}
\fi
2015-06-19 22:08:36 +01:00
### Draft
2014-10-21 09:54:12 +01:00
`draft` adds a watermark `draft` text with timestamp and version number at the top or
the bottom of the page. Pagewise line numbering is added on every page. `draft` settings can be tweaked in the `preamble.tex`.
2014-06-09 19:09:11 +01:00
2014-10-21 09:54:12 +01:00
* Use `draftclassic` in the document class options to use the default book class draft mode.
* To add figures in draft mode (default enabled), in the preamble set `\setkeys{Gin}{draft=false}`. `draft=true` disables figures
2013-12-05 23:59:39 +00:00
2014-06-09 19:09:11 +01:00
* To change the watermark text
\SetDraftText{DRAFT}
* To change the position of the watermark text. Default watermark position is top. The location can be changed to (top / bottom)
\SetDraftWMPosition{bottom}
* To change the draft version. Default draft version is v1.0.
\SetDraftVersion{v1.1}
* Watermark grayscale value can be modified. Text grayscale value (should be between 0-black and 1-white). Default value is 0.75
\SetDraftGrayScale{0.8}
2014-10-21 09:54:12 +01:00
2014-06-09 19:09:11 +01:00
### Choosing the fonts
`PhDThesisPSnPDF` currently supports three fonts `Times`, `Fourier` and `Latin Modern (default)`.
2013-12-05 02:24:35 +00:00
* `times`: (The University of Cambridge guidelines recommend using Times). Specifying times option in the document class will use `mathptpx` or `Times` font with Math Support.
2013-11-25 20:53:18 +00:00
* `fourier`: fourier font with math support
2014-06-09 19:09:11 +01:00
* `default (empty)`: When no font is specified, `Latin Modern` is used as the default font with Math Support.
2013-12-05 23:59:39 +00:00
* `customfont`: Any custom font can be set in preamble by using `customfont` option in the document class. Then the custom font can be loaded in preamble.tex in the line:
2013-12-06 18:47:28 +00:00
2014-06-09 19:09:11 +01:00
\ifsetCustomFont
\RequirePackage{Your_Custom_Font}
2013-12-06 18:47:28 +00:00
\fi
2014-06-09 19:09:11 +01:00
### Choosing the bibliography style
2014-02-04 01:41:11 +00:00
`PhDThesisPSnPDF` currently supports two styles `authoryear` and `numbered (default)`. Citation style has to be set. You can also specify `custombib` style and customise the bibliography.
* `authoryear`: For author-year citation eg., Krishna (2013)
* `numbered`: (Default Option) For numbered and sorted citation e.g., [1,5,2]
* `custombib`: Define your own bibliography style in the `preamble.tex` file.
2013-12-06 18:47:28 +00:00
\RequirePackage[square, sort, numbers, authoryear]{natbib}
2013-12-08 01:03:07 +00:00
* (Overview of Bibtex-Styles with preview)[http://nodonn.tipido.net/bibstyle.php?]
2014-02-11 00:50:17 +00:00
* If you would like to use biblatex instead of natbib. Pass the option `custombib` in the documentclass. In the `preamble.tex` file, edit the custombib section. Make sure you don't load the natbib package and you can specify the layout of your references in `thesis.tex` in the reference section. If you are using `biber` as backend, run `pdflatex thesis.tex >> biber thesis >> pdflatex thesis.tex >> biber thesis >> pdflatex thesis.tex`. If you are using the default natbib package, don't worry about this.
2014-06-09 19:09:11 +01:00
### Choosing the page style
2013-11-24 00:53:30 +00:00
`PhDThesisPSnPDF` defines 3 different page styles (header and footer). The following definition is for `twoside` layout.
* `default (leave empty)`: For Page Numbers in Header (Left Even, Right Odd) and Chapter Name in Header (Right Even) and Section #. Section Name (Left Odd). Blank Footer.
2014-06-09 19:09:11 +01:00
Header (Even) : 4 Introduction
2013-12-06 18:47:28 +00:00
2013-12-09 22:04:17 +00:00
Header (Odd) : 1.2 Section Name 5
2013-12-06 18:47:28 +00:00
2013-12-06 19:19:36 +00:00
Footer : Empty
2013-11-24 00:53:30 +00:00
2013-11-24 23:26:21 +00:00
* `PageStyleI`: For Page Numbers in Header (Left Even, Right Odd) and Chapter Name next to the Page Number on Even Side (Left Even). Section Number and Section Name and Page Number in Header on Odd Side (Right Odd). Footer is empty. Layout:
2013-11-24 00:53:30 +00:00
2014-06-09 19:09:11 +01:00
Header (Even) : 4 | Introduction
2013-12-06 18:47:28 +00:00
2013-12-09 22:04:17 +00:00
Header (Odd) : 1.2 Section Name | 5
2013-12-06 18:47:28 +00:00
2013-12-09 22:04:17 +00:00
Footer : Empty
2013-11-24 00:53:30 +00:00
* `PageStyleII`: Chapter Name on Even Side (Left Even) in Header. Section Number and Section Name in Header on Odd Side (Right Odd). Page numbering in footer. Layout:
2013-12-06 19:19:36 +00:00
Header (Even) : Introduction
2014-06-09 19:09:11 +01:00
2013-12-09 22:04:17 +00:00
Header (Odd) : 1.2 Section Name
2014-06-09 19:09:11 +01:00
2013-12-09 22:04:17 +00:00
Footer[centered]: 3
### Changing the visual style of chapter headings
The visual style of chapter headings can be modified using the `titlesec` package. Edit the following lines in the `preamble.tex` file.
\RequirePackage{titlesec}
\newcommand{\PreContentTitleFormat}{\titleformat{\chapter}[display]{\scshape\Large}
{\Large\filleft{\chaptertitlename} \Huge\thechapter}
{1ex}{}
[\vspace{1ex}\titlerule]}
\newcommand{\ContentTitleFormat}{\titleformat{\chapter}[display]{\scshape\huge}
{\Large\filleft{\chaptertitlename} \Huge\thechapter}{1ex}
{\titlerule\vspace{1ex}\filright}
[\vspace{1ex}\titlerule]}
\newcommand{\PostContentTitleFormat}{\PreContentTitleFormat}
\PreContentTitleFormat
2014-06-09 19:09:11 +01:00
### Custom settings
* The depth for the table of contents can be set using:
2014-04-21 23:20:36 +01:00
\setcounter{secnumdepth}{3}
\setcounter{tocdepth}{3}
2013-12-05 23:59:39 +00:00
A depth of [3] indicates to a level of `\subsubsection` or #.#.#.#. Default set as 2.
* To hide sections from appearing in TOC use: `\tochide\section{Section name}` in your TeX files
* Define custom caption style for figure and table caption in `preamble.tex` using:
2013-12-06 18:47:28 +00:00
\RequirePackage[small,bf,figurename=Fig.,labelsep=space,tableposition=top]{caption}
2014-04-21 23:20:36 +01:00
* Uncomment the following lines in `preamble.tex` to force a figure to be displayed in a particular location. Use `H` when including graphics. Note `H` instead of `h`.
\usepackage{float}
\restylefloat{figure}
* Bibliography with Author-Year Citation in `preamble.tex`:
2014-06-09 19:09:11 +01:00
2013-12-06 18:47:28 +00:00
\RequirePackage[round, sort, numbers, authoryear]{natbib}
2013-11-17 11:54:48 +00:00
2014-04-21 23:20:36 +01:00
* Line spacing for the entire document can be specified in `preamble.tex`. Uncomment the line spacing you prefer. e.g.,
\onehalfspacing
2014-06-09 19:09:11 +01:00
### Nomenclature definition
2013-11-20 01:18:06 +00:00
* To use nomenclature in your chapters:
2013-12-06 19:19:36 +00:00
\nomenclature[g-pi]{$\pi$}{ $\simeq 3.14\ldots$}
2014-06-09 19:09:11 +01:00
2013-12-06 19:19:36 +00:00
The sort keys have prefix. In this case a prefix of `g` is used to denote Greek Symbols, followed by `-pi` or `-sort_key`. Use a `-` to separate sort key from the prefixes. The standard prefixes defined in this class are:
2013-11-20 01:18:06 +00:00
2013-12-06 19:19:36 +00:00
* `A` or `a`: Roman Symbols
2013-11-20 01:18:06 +00:00
2013-12-06 19:19:36 +00:00
* `G` or `g`: Greek Symbols
2013-11-20 01:18:06 +00:00
2013-12-06 19:19:36 +00:00
* `Z` or `z`: Acronyms/Abbreviations
2013-11-20 01:18:06 +00:00
2013-12-06 19:19:36 +00:00
* `R` or `r`: Superscripts
2013-11-20 01:18:06 +00:00
2013-12-06 19:19:36 +00:00
* `S` or `s`: Subscripts
* `X` or `x`: Other Symbols
2013-11-20 01:18:06 +00:00
2013-11-24 23:26:21 +00:00
* You can change the Title of Nomenclature to Notations or Symbols in the `preamble.tex` using:
2013-12-06 19:19:36 +00:00
\renewcommand\nomname{Symbols}
2015-06-19 22:08:36 +01:00
TexStudio's default compile option doesn't include `nomenclature`, to compile your document with the nomenclature, do the following:
2015-06-19 22:08:36 +01:00
Options >> Configure TexStudio >> Build >> User Commands >> add user command
In `add user command` type `makenomeclature:makenomenclature` on the left pane and `makeindex %.nlo -s nomencl.ist -o %.nls` on the execution side. Now you can run the user defined command `makenomenclature` from `Tools >> User >> makenomenclature`.
Alternatively, you can use the `compile-thesis-windows.bat` file or run `make` on Unix / Linux / MacOS
## To-do Notes
2014-10-21 09:54:12 +01:00
To include custom to-do notes in your pdf document use `\mynote{Hey! I have a note}` anywhere in your chapters. To activate this feature, you need to uncomment the following lines in `preamble.tex`. To-do notes will be available only in the `draft` or `draftclassic` and not in the final thesis.
\ifsetDraft
\usepackage[colorinlistoftodos]{todonotes}
\newcommand{\mynote}[1]
{\todo[author=kks32,size=\small,inline,color=green!40]{#1}}
\else
\newcommand{\mynote}[1]{}
\newcommand{\listoftodos}{}
\fi
2013-11-24 23:26:21 +00:00
2014-06-09 19:09:11 +01:00
2013-12-06 19:10:15 +00:00
## General guidelines
2013-12-06 18:47:28 +00:00
[Why is it important to follow good practices and not get killed by a Velociraptor ;)](http://www.xkcd.com/292/)
2013-12-05 23:59:39 +00:00
* To restrict the length of the figure caption in List of figures use a \[short-title\] and {longtitle} for the caption or the section:
2013-12-06 18:47:28 +00:00
2013-12-05 23:59:39 +00:00
`\caption[Caption that you want to appear in TOC]{Actual caption of the figure}`
`\section[short]{title}`
2013-12-06 18:47:28 +00:00
* To exclude sections from being numbered and disable it from appearing in the Table of Contents use \section*{Section_Name} or \chapter*{Chapter_Name}
* To only exclude it from being listed in the Table of Contents encapsulate the section command inside the `\tochide` command. `\tochide{\section{Section_Name}}` the section will not appear in the Table of Contents, but the section will be numbered.
* When including figures in your tex file, it's a good practice to size your picture depending on the page size, instead of using absolute values. In the following example `0.75\textwidth` refers to picture width being set to 75% of the text width.
2013-12-06 18:47:28 +00:00
\includegraphics[width=0.75\textwidth]{minion}
2013-12-05 23:59:39 +00:00
2015-04-02 10:44:23 +01:00
* Use a `-` to separate sort key from the prefixes, eg., `g-pi` denotes the Greek symbol `pi`.
2013-12-05 12:45:11 +00:00
-------------------------------------------------------------------------------
## Frequently Asked Questions
2014-07-15 12:27:27 +01:00
#### _Q1_: Where can I find the thesis formatting guidelines this class is based on?
[https://www.admin.cam.ac.uk/students/studentregistry/exams/submission/phd/format.html](https://www.admin.cam.ac.uk/students/studentregistry/exams/submission/phd/format.html)
2014-07-15 12:27:27 +01:00
#### _Q2_: Where can I find newer versions of the University of Cambridge crest/logos?
The university updates its crest every now and then. You can find up-to-date
logos on [this page](http://www.cam.ac.uk/brand-resources/about-the-logo/logo-downloads)
(subject to change without notice).
Download and exchange the new logos with `University_Crest.eps` and/or `University_Crest.pdf`. I'll try to keep the crest up to date.
2014-07-15 12:27:27 +01:00
#### _Q3_: Where can I find the guidelines to submit my thesis and requirements?
[Preparing to submit:](https://www.admin.cam.ac.uk/students/studentregistry/exams/submission/phd/preparing.html)
[Formatting styles:](https://www.admin.cam.ac.uk/students/studentregistry/exams/submission/phd/format.html)
[Submitting the dissertation](https://www.admin.cam.ac.uk/students/studentregistry/exams/submission/phd/submitting.html)
2014-07-15 12:27:27 +01:00
#### _Q4_: How can I count the number of words in my thesis?
2013-12-05 23:59:39 +00:00
You can run the following command (Linux/Unix):
`ps2ascii thesis.pdf | wc -w` (eg., result 2713 words)
2014-06-09 19:09:11 +01:00
or
`pdftotext thesis.pdf | wc thesis.txt -w` (eg., result 2690 words)
2014-04-15 11:43:19 +01:00
or
`texcount -inc *.tex` (eg., result 2341 words)
2015-06-19 23:22:31 +01:00
#### _Q5_: How do I use a system font (libertine)?
To use a system font (open type) font with XeLaTeX, please select `customfont` option in the `documentclass` in `thesis.tex`. Add the path and font name to the custom font definition in `preamble.tex`
\ifsetCustomFont
\setmainfont[
Path = ./libertine/opentype/,
Extension = .otf,
UprightFont = LinLibertine_R,
BoldFont = LinLibertine_RZ, % Regular Semibold
ItalicFont = LinLibertine_RI,
BoldItalicFont = LinLibertine_RZI, % Regular Semibold Italic
] {libertine}
\newfontfamily\libertinesystemfont{Linux Libertine O}
\fi
Please use XeLaTeX tool chain with LaTeXmk.
#### _Q6_: I found a bug in the template. Where do I report bugs?
You can report issues at
[our GitHub repository](https://github.com/kks32/phd-thesis-template).
2014-06-09 19:09:11 +01:00
You can also mail
2013-12-09 15:33:06 +00:00
[the developer](https://github.com/kks32/phd-thesis-template/graphs/contributors) directly or contact [Tim Love, CUED](mailto:tpl@eng.cam.ac.uk)
2013-11-24 23:26:21 +00:00
--------------------------------------------------------------------------------
2014-06-09 19:09:11 +01:00
## Troubleshooting warnings
2013-11-24 23:26:21 +00:00
2014-07-15 12:27:27 +01:00
#### _W1_: I get the LaTeX Warning: You have requested document class `Classes/PhDThesisPSnPDF`, but the document class provides `PhDThesisPSnPDF`, should I be concerned?
2013-11-24 23:26:21 +00:00
2013-12-06 18:47:28 +00:00
No! Do nothing, or if you don't want any warning messages change the line near the top of the class file to \ProvidesClass{Classes/PhDthesisPSnPDF} if you're not going to install the class file in a more standard location. You can install it in a standard location like `/usr/share/texmf/tex/latex/` and run `texhash` to reconfigure.
2013-11-24 23:26:21 +00:00
2014-07-15 12:27:27 +01:00
#### _W2_:I get the package Fancyhdr Warning: \fancyhead's `E` option without twoside option is useless on input line \# or \#. What should I do?
2013-11-24 23:26:21 +00:00
2014-06-09 19:09:11 +01:00
Nothing. The warning is because the twoside option is also defined in the class, although only the oneside option is currently used.
2013-11-24 23:26:21 +00:00
2014-07-15 12:27:27 +01:00
#### _W3_: I get the Class PhDThesisPSnPDF Warning: Unknown or non-standard option 'something'. Will see if I can load it from the book class. If you get a warning unused global option(s): `something` then the option is not supported! on input line \#.
2013-11-24 23:26:21 +00:00
2014-06-09 19:09:11 +01:00
You are either trying to use a undefined option or a non-standard option which is in the book class but not defined in the PhD Thesis Template. If it can be used it will be loaded and you will get no further warnings. If not, the option you chose is unavailable.
2013-11-24 23:26:21 +00:00
2014-07-15 12:27:27 +01:00
#### _W4_: I get LaTeX Warning: Unused global option(s):[something].
2013-11-24 23:26:21 +00:00
2013-12-05 23:59:39 +00:00
You are trying to load an option that is not supported in the PhDThesisClass and the Book Class. Are you sure you are using the right option? Check your spelling!
2013-11-24 23:26:21 +00:00
2014-07-15 12:27:27 +01:00
#### _W5_: I get I'm skipping whatever remains of this command line \# of file thesis.aux \@input{Chapter1/chapter1.aux}
2013-12-05 12:45:11 +00:00
2013-12-05 23:59:39 +00:00
If you are generating a separate abstract for your thesis submission, ignore this warning and good luck with your submission. If you are compiling your thesis and see this warning, please remove the option `abstract` from the document class.
2013-12-05 12:45:11 +00:00
2015-04-02 10:44:23 +01:00
#### _W6_: I get blank pages between chapters
This is normal for a book class. Usually, a new chapter in a book always starts on the right hand side, which is why you see a blank page. You can remove the extra blank page by passing `openany` option to the documentclass. This works for double sided printing. However, if you are printing on a single side, please pass `oneside` option to the document class.
2015-06-19 22:08:36 +01:00
#### _W7_: My references aren't listed in the ordered in which I cite them
This is controlled by the bibliography style. Please use `\bibliographystyle{unsrt}` in `thesis.tex` instead of `apalike`. This applicable only for numerically sorted references.
2013-11-18 00:27:00 +00:00
--------------------------------------------------------------------------------
2014-07-15 12:27:27 +01:00
## Known issue(s) / Bugs / Feature requests
2013-11-18 00:27:00 +00:00
* Hyperlinks doesn't seem to be working in Post-Script file, however works on DVI and PDF (which is produced from the PS file), possibly viewer limitation than a code bug.
2013-12-09 22:04:17 +00:00
* On older versions of dvips (version 5.97 or below), if your page margins do not appear properly in your PDF, when compiling through DVI >> PS >> PDF, please ensure that you have set a4paper or a5paper in the document class. If you are still having issues you can run:
2013-12-09 00:34:09 +00:00
ps2pdf -sPAPERSIZE=a4 thesis.ps thesis.pdf
2013-12-09 22:04:17 +00:00
This issue occurs only when the papersize is not specified in the document class and you are compiling DVI >> PS >> PDF using an older version (5.97 or below) of dvips.
2013-12-09 00:34:09 +00:00
2014-07-15 12:27:27 +01:00
* Open issues can be tracked at [https://github.com/kks32/phd-thesis-template/issues](https://github.com/kks32/phd-thesis-template/issues). If you would like a new feature to be added to the template, please create an issue and label it as an enhancement.
* Please [fork me on github](https://github.com/kks32/phd-thesis-template/fork) and create a pull request, if you would like to contribute to the repo.
2014-07-15 12:27:27 +01:00
## ChangeLog
2014-07-15 12:27:27 +01:00
The history of releases can be viewed at [ChangeLog](ChangeLog.md)
--------------------------------------------------------------------------------
2014-07-15 12:27:27 +01:00
## Inspirations/Based on
* Cambridge Computer Laboratory PhD Thesis Template [https://github.com/cambridge/thesis](https://github.com/cambridge/thesis)
* CUED Version 1.1 Template by H. Banderi
## Acknowlegments
* Alex Ridge - original idea, code concepts & testing
* Steven Kaneti - code concepts
2014-06-09 19:09:11 +01:00
* Tina Schwamb - testing and bug reports
* John Plaice - Bug fixes