.gitignore

-*.log
-*.tex
 *.bst
-*.cls
 *.bib
 *.eps
 *.aux
+*.fls
 *.out
 *.bbl
-*.lol
-*.lot
-*.lof
+*.blg
+*.lo?
 *.toc
 *_latexmk
+*.synctex.gz

README.md

+# University Of Southampton LaTeX documents
+LaTeX Documents for the University of Southampton. Mainly for Thesis and project reports
+
+For slides with Beamer, please see https://git.soton.ac.uk/sw2f11/latex-slides-template
+
+## FAQ
+#### Q: How do I install and use the templates?
+See the [Install](#install-instructions) section below.
+
+#### Q: How do I include an "Accessed on", "Visited on", "Date last Accessed" or "Last visited" note for urls?
+The bibliography is formatted by the `natbib` package that does not support the `urldate` field in `.bib` files.
+As a work around, add a `note={Accessed on 2020-01-01}` to the relevant bib entry.
+
+For more info, see [this Stack Exchange question](https://tex.stackexchange.com/questions/103133/problems-with-natbib-strange-url-format-and-urldate-not-shown).
+
+#### Q: How do I fix a bib entry with special characters (`&%`)?
+You may get an error like "Paragraph ended before \\BR@@bibitem was complete"
+or there may be a cascade of errors because of an unclosed `\begin` statement.
+
+The short term solution is to manually "escape" special characters in the `.bib` url fields,
+i.e. `url = {http://www.somesite.com/8%20report}` => `url = {http://www.somesite.com/8\%20report}`.
+
+Unfortunately, the longer term solution requires editing some source files.
+Locate the `plainnat.bst` (or `biblatex.bst` file, if using `biblatex`)
+and add the following in the file at the end of `FUNCTION {begin.bib}`
+```
+    "\providecommand{\BIBdecl}{\relax}"
+    write$ newline$
+    "\BIBdecl"
+    write$ newline$
+```
+Then add ``\newcommand{\BIBdecl}{\catcode`\%=12 }`` before `\begin{document}` in your `.tex` document source.
+
+[Stack Exchange Source](https://tex.stackexchange.com/questions/140143/hyperref-with-pagebackref-requires-manual-escaping-of-percentage-signs-in-urls)
+
+#### Q: Can I use `biblatex` instead of `natbib`?
+Yes, you can. Since this template has existed longer than `biblatex` it uses the older `natbib`.
+there are good reasons to change to `biblatex` but `natbib` is still preferred by journals,
+so using `natbib` will mean that source material from papers will not need to be modified.
+
+# Install instructions
+This is if you do not want to use a service like Overleaf or want to use a different template other than the uosthesis class provided.
+If you want to compile documents on your own machine, first you must install a LaTeX distribution.
+Either TeXLive or MikTeX will work. For TeXLive, you do not need a full installation (which is huge).
+
+For detailed LaTeX Installation help please look at the [detailed template instructions](https://git.soton.ac.uk/el7g15/uos-latex-template-instructions/-/blob/master/README.pdf)
+## For preparing a single document - just one Thesis, Dissertation or Final project report
+This is if you will only need to use one template, and works on Overleaf too. Go to the [Releases page](https://git.soton.ac.uk/el7g15/uos-latex-template/-/releases) and download the relevant quickstart package. Unzip and start editing the `Thesis.tex`,`Progress.tex`,`GDP.tex` file as appropriate for the report you are doing. This should compile straight away from an editor like TeXstudio, or from the Overleaf workspace.
+
+## For multiple use - for Progress reports, Thesis and more frequent use
+Given you will use the template more than once, this is definitely the preferred option.
+Download the `Source Code` from the [Releases page](https://git.soton.ac.uk/el7g15/uos-latex-template/-/releases) and extract it to the `{TEXMF}` folder (see below).
+### Your `{TEXMF}` root subdirectory
+For Tex Live: This whole folder can be moved into the `~/texmf` directory to begin using the class files.
+
+For MikTeX: It is platform dependent, See `UserInstall` from (https://miktex.org/kb/texmf-roots).
+You may need to register your directories: https://docs.miktex.org/manual/localadditions.html.
+You will need to update the filename database (FNDB) (MiKTeX Console -> Tasks -> Refresh file name database), see https://docs.miktex.org/manual/configuring.html#fndbupdate. You can do this in the command line with the `initexmf -u` command.
+
+### The folder post install
+If using the zip download, there may be one or two containing directories before the actual
+folders that need copying. Once the folder has been extracted your `{TEXMF}` directory should
+look like so.
+
+```
++-{TEXMF}
+    +-bibtex
+    |  +-bib
+    |      +-uosdocs
+    +-doc
+    |  +-latex
+    |      +-uosdocs
+    +-templates
+    |  +-latex
+    |      +-uosdocs
+    +-tex
+    |  +-latex
+    |      +-uosdocs
+    +-source
+       +-docstrip
+           +-uosdocs
+```
+
+### Using the template
+Now copy the contents of the `templates/latex/uosdocs` directory into your working directory.
+
+In the working directory, open the relevant copied root `tex` file, i.e. `Thesis.tex` etc. and begin your masterpiece.
+
+More info can be found in the [Instructions](https://git.soton.ac.uk/el7g15/uos-latex-template-instructions/-/blob/master/README.pdf).
+
+## Updating
+Repeat the installation step and it will overwrite the existing files.
+
+# About this package
+Created with docstrip `.ins` and `.dtx` files in the source directory. See the [Instructions](https://git.soton.ac.uk/el7g15/uos-latex-template-instructions/-/blob/master/README.pdf) for more info about usage and building.
+
+The version hosted on https://git.soton.ac.uk/el7g15/uos-latex-template is kept up to date with the University of Southampton template. The version hosted on GitHub may diverge from that.

bibtex/bib/uosdocs/UOS.bib

+%% ----------------------------------------------------------------
+%% UOS.bib
+%% ---------------------------------------------------------------- 
+@MISC{Longman:2019:templ,
+  author =       {E. Longman},
+  title =        {{University of Southampton LaTeX documents}},
+  year =         {2019},
+  NOTE =     "\url{https://library.soton.ac.uk/thesis/templates} and
+             \url{https://git.soton.ac.uk/el7g15/uos-latex-template}",
+}
+@MISC{Gunn:2001:pdflatex,
+  author =       {S.R. Gunn},
+  title =        {PDFLaTeX Instructions},
+  year =         {2001},
+  url =          {http://www.ecs.soton.ac.uk/~srg/softwaretools/document/}
+}
+@MISC{Lovell:2011:updated,
+  author =       {C. J. Lovell},
+  title =        {Updated templates},
+  year =         {2011}
+}
+@MISC{Gunn:2011:updated2,
+  author =       {S.R. Gunn and C. J. Lovell},
+  title =        {Updated templates reference 2},
+  year =         {2011}
+}
+@MISC{attribpackage,
+  author =       {Matt Swift},
+  title =        {The attrib LaTeX package
+attribution of block elements (Frankenstein’s hat)},
+  year =         {1999},
+  url =          {http://cs.brown.edu/about/system/managed/latex/doc/attrib.pdf}
+}
+

Makefile → source/latex/uosdocs/Makefile

 #*=============================================================================
-# Makefile for ecsdocs LaTeX Style
+# Makefile for uosdocs LaTeX Style
 # Date: 11/05/2002
-# Author: Steve Gunn and Edward Longman
+# Author: Steve Gunn
 # Use for rebuilding class files when the original dtx source has been changed
 # Change TEXMF to represent the installation directory of texlive (or MiKTeX)
 # The style is the name of the style for these templates.
+# Date: 30/01/2019
+# Author: Edward Longman
+# Rebuild and change name to uosdocs
 # make
-#	     all - creates all the necessart files to install the class
-#      install - moves all of the created files into the
+#	     all - creates all the necessary files to install the class
+#      install - moves all of the created files into the specified TEXMF directory
 #*======================BUILD AND INSTALL NAMES================================
 
 TEXMF      = C:\Users\<username>\texmf
-STYLE      = ecsdocs
+STYLE      = uosdocs
 
 #*====================DEFINE EXPECTED OUTPUT FILES=============================
 
-CLSFILES   = ecsthesis.cls \
-             ecsminithesis.cls \
-             ecsprogress.cls \
-             ecsproject.cls \
-             ecsreport.cls \
-             ecsarticle.cls \
-             ecsgdp.cls \
-             ecsgdpsummary.cls \
-             ecsUoSLogo.png
+CLSFILES   = uosthesis.cls \
+             uosminithesis.cls \
+             uosprogress.cls \
+             uosproject.cls \
+             uosreport.cls \
+             uosarticle.cls \
+             uosgdp.cls \
+             uosgdpsummary.cls \
+             UoSLogo.pdf
 
 TPLFILES   = AppendixA.tex \
              Article.tex \
@@ -40,11 +43,9 @@ TPLFILES   = AppendixA.tex \
 
 EPSFILES   = figure.eps
 
-DOCFILES   = ecsdocs.pdf
+DOCFILES   = uosdocs.pdf
 
-BSTFILES   = ecs.bst
-
-BIBFILES   = ECS.bib
+BIBFILES   = UOS.bib
 
 TESTFILES  = Article.pdf \
              GDP.pdf \
@@ -57,27 +58,38 @@ TESTFILES  = Article.pdf \
 
 SRCFILES   = $(STYLE).dtx \
              $(STYLE).ins \
-             ecsUoSLogo.png \
+             UoSLogo.pdf \
 	     			 Makefile
 
 GENFILES   = $(CLSFILES) \
              $(TPLFILES) \
              $(EPSFILES) \
-             $(BSTFILES) \
              $(BIBFILES)
 
 CLSDIR     = "$(TEXMF)/tex/latex/$(STYLE)"
 TPLDIR     = "$(TEXMF)/templates/latex/$(STYLE)"
 DOCDIR     = "$(TEXMF)/doc/latex/$(STYLE)"
-BSTDIR     = "$(TEXMF)/bibtex/bst/$(STYLE)"
 BIBDIR     = "$(TEXMF)/bibtex/bib/$(STYLE)"
-SRCDIR     = "$(TEXMF)/source/docstrip/$(STYLE)"
+SRCDIR     = "$(TEXMF)/source/latex/$(STYLE)"
+
+TEMPLATEDEPS = figure.eps UOS.bib
+ARTICLEDEPS = uosarticle.cls Article.tex $(TEMPATEDEPS)
+BOOKDEPS = $(TEMPATEDEPS) Definitions.tex Introduction.tex Conclusions.tex AppendixA.tex
+GDPDEPS = uosgdp.cls GDP.tex $(BOOKDEPS)
+GDPSUMMARYDEPS = uosgdpsummary.cls GDPSummary.tex $(TEMPATEDEPS)
+MINITHESISDEPS = uosminithesis.cls MiniThesis.tex $(BOOKDEPS)
+PROGRESSDEPS = uosprogress.cls Progress.tex $(BOOKDEPS)
+PROJECTDEPS = uosproject.cls Project.tex $(BOOKDEPS)
+REPORTDEPS = uosreport.cls  Report.tex $(BOOKDEPS)
+THESISDEPS = uosthesis.cls Thesis.tex UoSLogo.pdf $(BOOKDEPS)
 
 #*====================== LATEX INSTALLATION CONFIG ==========================
 
 LATEX      = pdflatex
 PDFTEXIFY  = texify --pdf
 MAKEINDEX  = makeindex
+ZIP = 7z a -tzip
+UNZIP = 7z e
 
 #*==================== DIFFERENT MAKE CONFIGURATIONS ========================
 
@@ -85,6 +97,8 @@ all: $(GENFILES) $(DOCFILES)
 
 dist: $(STYLE).zip
 test: $(GENFILES) $(TESTFILES)
+UNZIPFILES = $(patsubst %, unzipped/%, $(TESTFILES))
+ziptest: $(UNZIPFILES)
 
 #* .SECONDARY used to stop it building repeatedly
 #* https://stackoverflow.com/questions/2973445/
@@ -102,13 +116,30 @@ $(DOCFILES): $(STYLE).dtx
 
 %.pdf: %.tex
 	$(PDFTEXIFY) $*.tex
-
+unzipped/%.pdf: %.zip
+	$(UNZIP) -obuild/ $*.zip
+	$(PDFTEXIFY) build/$*.tex -output-directory="build/" --quiet
+	grep "2021/06/08 v1.5" build/$*.log
+	cp build/$*.pdf unzipped/$*.pdf
+	rm build/*
 #*========================== ZIP REQUIREMENTS ===============================
 
-
-$(STYLE).zip: $(GENFILES) $(DOCFILES)
-	$(MAKE) clean
-	zip $@ $(SRCFILES) $(GENFILES) $(DOCFILES)
+Article.zip: $(GENFILES) $(DOCFILES)
+	$(ZIP) $@ $(ARTICLEDEPS)
+GDP.zip: $(GENFILES) $(DOCFILES)
+	$(ZIP) $@ $(GDPDEPS)
+GDPSummary.zip: $(GENFILES) $(DOCFILES)
+	$(ZIP) $@ $(GDPSUMMARYDEPS)
+MiniThesis.zip: $(GENFILES) $(DOCFILES)
+	$(ZIP) $@ $(MINITHESISDEPS)
+Progress.zip: $(GENFILES) $(DOCFILES)
+	$(ZIP) $@ $(PROGRESSDEPS)
+Project.zip: $(GENFILES) $(DOCFILES)
+	$(ZIP) $@ $(PROJECTDEPS)
+Report.zip: $(GENFILES) $(DOCFILES)
+	$(ZIP) $@ $(REPORTDEPS)
+Thesis.zip: $(GENFILES) $(DOCFILES)
+	$(ZIP) $@ $(THESISDEPS)
 
 #*============================= CLEAN TYPES =================================
 clean:
@@ -130,8 +161,6 @@ install: $(GENFILES) $(DOCFILES)
 	install $(EPSFILES) $(TPLDIR)
 	install -d $(DOCDIR)
 	install $(DOCFILES) $(DOCDIR)
-	install -d $(BSTDIR)
-	install $(BSTFILES) $(BSTDIR)
 	install -d $(BIBDIR)
 	install $(BIBFILES) $(BIBDIR)
 	install -d $(SRCDIR)

ecsdocs.dtx → source/latex/uosdocs/uosdocs.dtx

@@ -5,15 +5,10 @@
 % and Computer Science at the University of Southampton.
 %
 % The thesis, minithesis, progress, project, report, gdp, gdpsummary and article environments are written to separate
-% class files ecsthesis.cls, ecsminithesis.cls, ecsprogress.cls, ecsproject.cls, ecsreport.cls, ecsgdp.cls, ecsgdpsummary.cls and ecsarticle.cls.
-% \fi
-%
-
-% \CheckSum{1908}
-%
-% \iffalse
+% class files uosthesis.cls, uosminithesis.cls, uosprogress.cls, uosproject.cls, uosreport.cls, uosgdp.cls, uosgdpsummary.cls and uosarticle.cls.
 % Copyright (C) 2001 by Steve R. Gunn
-% Later Modifications 2018 by Edward Longman
+% Later Modifications (C) 2018 by Edward Longman
+% Later Modifications (C) 2020 by Edward Longman
 %    \begin{macrocode}
 %<thesis|minithesis|progress|project|article|report|gdp|gdpsummary>\NeedsTeXFormat{LaTeX2e}[2007/02/26]
 %    \end{macrocode}
@@ -21,19 +16,19 @@
 %    Announce the document class and its version.
 %
 %    \begin{macrocode}
-%<thesis>\ProvidesClass{ecsthesis}
-%<minithesis>\ProvidesClass{ecsminithesis}
-%<progress>\ProvidesClass{ecsprogress}
-%<project>\ProvidesClass{ecsproject}
-%<article>\ProvidesClass{ecsarticle}
-%<report>\ProvidesClass{ecsreport}
-%<gdp>\ProvidesClass{ecsgdp}
-%<gdpsummary>\ProvidesClass{ecsgdpsummary}
+%<thesis>\ProvidesClass{uosthesis}
+%<minithesis>\ProvidesClass{uosminithesis}
+%<progress>\ProvidesClass{uosprogress}
+%<project>\ProvidesClass{uosproject}
+%<article>\ProvidesClass{uosarticle}
+%<report>\ProvidesClass{uosreport}
+%<gdp>\ProvidesClass{uosgdp}
+%<gdpsummary>\ProvidesClass{uosgdpsummary}
 %<*driver>
-\ProvidesFile{ecsdocs.drv}
+\ProvidesFile{uosdocs.drv}
 %</driver>
 %<*thesis|minithesis|progress|project|report|article|gdp|gdpsummary|driver>
-              [2018/12/20 v2.0
+              [2022/08/15 v1.6
 %</thesis|minithesis|progress|project|report|article|gdp|gdpsummary|driver>
 %<thesis|minithesis|progress|project|report|article|gdp|gdpsummary>   LaTeX document class]
 %    \end{macrocode}
@@ -46,11 +41,11 @@
 %<*driver>
 ]
 \documentclass[a4paper,10pt]{ltxdoc}
-\GetFileInfo{ecsdocs.drv} \CodelineIndex \EnableCrossrefs
+\GetFileInfo{uosdocs.drv} \CodelineIndex \EnableCrossrefs
 %\RecordChanges
 \setcounter{IndexColumns}{2}
 \begin{document}
-\DocInput{ecsdocs.dtx}
+\DocInput{uosdocs.dtx}
 \PrintIndex
 %\PrintChanges
 \end{document}
@@ -69,21 +64,21 @@
 % \maketitle
 % \section{Quickstart}
 %   This guide assumes you have installed MiKTeX or TeX live distributions.
-%   It also requires having the program "make" for producing the templates again.
+%   It also requires having the program ``make'' for producing the templates again.
 %
 %   The folder labelled tex-mf should be installed in your local tex files
 %   source or whatever your tex distro uses.
 %
 %   The Templates have been built for the Deparment of Electronics and Computer
 %   Science in the Faculty of Engineering and Physical Science at the University
-%   Of Southampton.
+%   of Southampton.
 %
 %   The basic settings for University, Faculty and School are explained in Section~\ref{IntNames}
 %
 %   If a user only wishes to change the file for their thesis it is probably
-%   easier to navigate to the class file labeled ecsthesis and change the
+%   easier to navigate to the class file labeled uosthesis and change the
 %   department and faculty naming there. This will be located in the
-%   subdirectory where you unzipped the files under tex/latex/ecsdocs/
+%   subdirectory where you unzipped the files under tex/latex/uosdocs/
 %
 % \section{Description}
 %
@@ -103,14 +98,14 @@
 % {\sc docstrip} when generating the external files:
 % \begin{center}
 % \begin{tabular}{ll}
-%   thesis            & produce the \texttt{ecsthesis} document class\\
-%   minithesis        & produce the \texttt{ecsminithesis} document class\\
-%   progress          & produce the \texttt{ecsprogress} document class\\
-%   project           & produce the \texttt{ecsproject} document class\\
-%   report            & produce the \texttt{ecsreport} document class\\
-%   article           & produce the \texttt{ecsarticle} document class\\
-%   gdp               & produce the \texttt{ecsgdp} document class\\
-%   gdpsummary        & produce the \texttt{ecsgdpsummary} document class\\
+%   thesis            & produce the \texttt{uosthesis} document class\\
+%   minithesis        & produce the \texttt{uosminithesis} document class\\
+%   progress          & produce the \texttt{uosprogress} document class\\
+%   project           & produce the \texttt{uosproject} document class\\
+%   report            & produce the \texttt{uosreport} document class\\
+%   article           & produce the \texttt{uosarticle} document class\\
+%   gdp               & produce the \texttt{uosgdp} document class\\
+%   gdpsummary        & produce the \texttt{uosgdpsummary} document class\\
 %   testthesis        & produce an example thesis\\
 %   testminithesis    & produce an example minithesis\\
 %   testprogress      & produce an example progress\\
@@ -134,6 +129,10 @@
 %
 % The checksum is to determine if there has been a truncation in the file during transmission over a network
 %
+%    The class has a custom option to define what colours should be used for links.
+%    This option defines \texttt{sotoncolour} to use UoS palette colours.
+%    Colour Code taken from \texttt{http://edshare.soton.ac.uk/10481}
+%
 %    All options are passed on to the \texttt{book} or \texttt{article} class.
 %
 %    \begin{macrocode}
@@ -156,6 +155,18 @@
 % \end{macro}
 %
 %    \begin{macrocode}
+\RequirePackage{xcolor}
+\colorlet{linkBlue}{blue}
+\colorlet{custGray}{gray}
+\colorlet{chapRed}{red}
+\DeclareOption{sotoncolour}{
+\definecolor{sotonMarineBlue}{RGB}{1,67,89} % Soton marine blue (P 7469C)
+  \definecolor{sotonGrey}{RGB}{153,153,166} % Soton grey (P 443C)
+  \definecolor{sotonRed}{RGB}{171,18,16} % Soton Red (P 484C)
+  \colorlet{linkBlue}{sotonMarineBlue}
+  \colorlet{custGray}{sotonGrey}
+  \colorlet{chapRed}{sotonRed}
+}
 \DeclareOption*{\PassOptionsToClass{\CurrentOption}{\baseclass}}
 %    \end{macrocode}
 %
@@ -269,29 +280,39 @@
 %
 %  \subsection{Margins}
 %
-%    Load the \texttt{vmargin} package to setup the page dimensions.
+%    Load the \texttt{geometry} package to setup the page dimensions.
 %
 %    \begin{macrocode}
-\usepackage{vmargin}
+\usepackage{geometry}
 %<*thesis|minithesis|progress|project|report|gdp|gdpsummary>
-\setmarginsrb           { 1.5in}  % left margin
-                        { 0.6in}  % top margin
-                        { 1.0in}  % right margin
-                        { 0.8in}  % bottom margin
-                        {  20pt}  % head height
-                        {0.25in}  % head sep
-                        {   9pt}  % foot height
-                        { 0.3in}  % foot sep
+\geometry{a4paper,
+            % left=1.25in,
+            % right=1.25in,
+            hmarginratio=1:2,
+            textwidth=146.5mm,
+            top=0.6in,
+            bottom=0.8in,
+            headheight=20pt,
+            headsep=0.25in,
+            foot=9pt,
+            footskip=0.3in,
+            bindingoffset=0.5in,
+            includeheadfoot}
 %</thesis|minithesis|progress|project|report|gdp|gdpsummary>
 %<*article>
-\setmarginsrb           { 0.8in}  % left margin
-                        { 0.6in}  % top margin
-                        { 0.8in}  % right margin
-                        { 0.8in}  % bottom margin
-                        {  20pt}  % head height
-                        {0.25in}  % head sep
-                        {   9pt}  % foot height
-                        { 0.3in}  % foot sep
+\geometry{a4paper,
+            % left=1.25in,
+            % right=1.25in,
+            hmarginratio=1:1,
+            textwidth=169.4mm,
+            top=0.6in,
+            bottom=0.8in,
+            headheight=20pt,
+            headsep=0.25in,
+            foot=9pt,
+            footskip=0.3in,
+            bindingoffset=0.5in,
+            includeheadfoot}
 %</article>
 %    \end{macrocode}
 %
@@ -422,7 +443,7 @@
 % \begin{macro}{\sref}
 % \begin{macro}{\aref}
 %
-%   Load the \texttt{caption2} package to improve formatting of captions,
+%   Load the \texttt{caption} package to improve formatting of captions,
 %   and provide short referencing commands.
 %
 %    \begin{macrocode}
@@ -503,10 +524,10 @@
 %
 % \subsection{Subfigures and subtables}
 %
-%    Load the \texttt{subfigure} package, so we can include subfigures easily.
+%    Load the \texttt{subcaption} package, so we can include subfigures easily.
 %
 %    \begin{macrocode}
-\usepackage[scriptsize]{subfigure}
+\usepackage[]{subcaption}
 \usepackage{booktabs}
 \usepackage{rotating}
 %    \end{macrocode}
@@ -535,13 +556,9 @@
 %    Load the \texttt{hyperref} package to provide hyperlinks in pdf and dvi documents.
 %
 %    \begin{macrocode}
-\usepackage{xcolor}
-\definecolor{SotRed}{rgb}{0.67,0.07,0.06}
-\definecolor{SotBlue}{rgb}{0,0.26,0.35}
-\definecolor{SotGray}{rgb}{0.6,0.6,0.65}
 \usepackage[pdfpagemode={UseOutlines},bookmarks=true,bookmarksopen=true,
-   bookmarksopenlevel=0,bookmarksnumbered=true,hypertexnames=false,
-   colorlinks,linkcolor={SotBlue},citecolor={SotBlue},urlcolor={SotBlue},
+   bookmarksopenlevel=0,bookmarksnumbered=true,plainpages=false,pdfpagelabels,
+   colorlinks,linkcolor={linkBlue},citecolor={linkBlue},urlcolor={linkBlue},
    pdfstartview={FitV},unicode,breaklinks=true]{hyperref}
 \pdfstringdefDisableCommands{
    \let\\\space
@@ -568,17 +585,24 @@
 %
 %    The various elements of the documents are defined
 %    as control sequences to make it easy to customize this
-%    style for other parts of the University.
+%    style for other parts of the University. When the
+%    command is run the other terms are defined by the args.
+%
+%    The examiner and supervisor commands can be puralised
+%    so that it can print "Supervisors:". This is with an
+%    optional argument. [s] which will add and ``s'' to the
+%    word "Supervisor"
 %
 %    \begin{macrocode}
 %% --------------------- Organisational Structure ----------------------
-\newcommand*{\supervisor}[1]{\def\supname{#1}}
-\newcommand*{\examiner}[1]{\def\examname{#1}}
+\newcommand*{\supervisor}[2][]{\def\supname{#2}\def\supplural{#1}}
+\newcommand*{\examiner}[2][]{\def\examname{#2}\def\examplural{#1}}
 \newcommand*{\degree}[1]{\def\degreename{#1}}
 \newcommand*{\authors}[1]{\def\authornames{#1}}
 \newcommand*{\qualifications}[1]{\def\quals{#1}}
 \newcommand*{\addresses}[1]{\def\addressnames{#1}}
-\newcommand*{\doi}[1]{\def\doicode{#1}}
+\newcommand*{\documentDoi}[1]{\def\doicode{#1}}
+\newcommand*{\volume}[2]{\def\volno{#1}\def\volof{#2}}
 \newcommand*{\orcidid}[1]{\def\orcid{#1}}
 \newcommand*{\university}[1]{\def\univname{#1}}
 \newcommand*{\UNIVERSITY}[1]{\def\UNIVNAME{#1}}
@@ -630,28 +654,23 @@
 %    By running these commands at the top of your tex file it will overwrite the defaults.
 %    \begin{macrocode}
 %% --------------------- Organisational Structure ----------------------
-\doi{}
+\documentDoi{}
 \supervisor  {}
 \examiner    {}
 \degree      {}
 \authors     {}
 \qualifications{}
 \orcidid{}
-\university  {\texorpdfstring{\href{http://www.soton.ac.uk}
+\volume{}{}
+\university  {\texorpdfstring{\href{http://www.southampton.ac.uk}
                 {University of Southampton}}
                 {University of Southampton}}
 \UNIVERSITY  {\MakeUppercase{\univname}}
-\department  {\texorpdfstring{\href{http://www.ecs.soton.ac.uk}
-                {School of Electronics and Computer Science}}
-                {School of Electronics and Computer Science}}
+\department  {School of Electronics and Computer Science}
 \DEPARTMENT  {\MakeUppercase{\deptname}}
-\group       {\texorpdfstring{\href{http://cps.ecs.soton.ac.uk}
-                {Cyber Physical Systems Group}}
-                {Cyber Physical Systems Group}}
+\group       {}
 \GROUP       {\MakeUppercase{\groupname}}
-\faculty     {\texorpdfstring{\href{http://www.feps.soton.ac.uk}
-                {Faculty of Engineering and Physical Science}}
-                {Faculty of Engineering and Physical Science}}
+\faculty     {Faculty of Engineering and Physical Science}
 \FACULTY     {\MakeUppercase{\facname}}
 \addresses   {}
 \subject     {}
@@ -682,12 +701,13 @@
 %    Setup an appropriate title page and pdf strings if we are using
 %    pdf\LaTeX.
 %
-%    The %\global\let\@title\@empty has been removed
+%    The %\\global\\let\\@title\\@empty has been removed
 %
 %    Possibly the relax statement also needs to be removed
 %
 %   \begin{macrocode}
 %<*thesis|minithesis|progress|project|report|gdp|gdpsummary>}
+%    Start by Adding meta data to the produced document
 \usepackage{titling}
 \AtBeginDocument{
   \hypersetup{pdftitle={\thetitle}}
@@ -695,6 +715,7 @@
   \hypersetup{pdfauthor={\authornames}}
   \hypersetup{pdfkeywords={\keywordnames}}
 }
+%    Define the title page layout
 \renewcommand\maketitle{
   \btypeout{Title Page}
   \thispagestyle{empty}
@@ -712,10 +733,11 @@
 %<*thesis|minithesis|progress|project|gdp|gdpsummary>
       \bigskip
       {\large \facname \par}
-%</thesis|minithesis|progress|project|gdp|gdpsummary>
-%<*thesis|minithesis|progress|project>
       {\large \deptname \par}
-%</thesis|minithesis|progress|project>
+%</thesis|minithesis|progress|project|gdp|gdpsummary>
+%<*thesis|minithesis|progress>
+      {\large \groupname \par}
+%</thesis|minithesis|progress>
       \vfill
 %<*minithesis>
       {\large A mini-thesis submitted for transfer from}
@@ -737,10 +759,11 @@
       {\large A group design project summary report submitted}
       {\large for the award of \par \degreename \par}
 %</gdpsummary>
-%<*minithesis|progress|project|gdp|gdpsummary>
+%<*minithesis|progress|project>
       \vfill
-      {\normalsize Supervisor: \supname \par}
-      {\normalsize Examiner: \examname \par}
+      {\normalsize Supervisor\supplural: \supname \par}
+      \ifthenelse{\isempty{\examname}}
+      {\normalsize Examiner\examplural: \examname \par}{}
       \vfill
       \hspace{6mm}\parbox[t][51mm][s]{89mm}{
         \center
@@ -753,13 +776,33 @@
         \vfill
       }
       \parbox[t][95mm][s]{89mm}{}
-%</minithesis|progress|project|gdp|gdpsummary>
+%</minithesis|progress|project>
+%<*gdp|gdpsummary>
+      \vfill
+      {\normalsize \textit{by} \textbf\authornames \par}
+      \bigskip
+      {\normalsize Supervisor\supplural: \supname \par}
+      {\normalsize Examiner\examplural: \examname \par}
+      \vfill
+      \hspace{6mm}\parbox[t][51mm][s]{89mm}{
+        \center
+        \vfill
+        {\large \bf \@title \par}
+        \vfill
+        {\normalsize \@date \par}
+        \vfill
+      }
+      \parbox[t][95mm][s]{89mm}{}
+%</gdp|gdpsummary>
 %<*thesis|report>
       {\huge \bf \@title \par
 }
       \ifthenelse{\equal{\doicode}{}}
       {}
-      {\smallskip DOI: \doicode}
+      {\smallskip DOI: \href{https://doi.org/\doicode}{\doicode}\par}
+      \ifthenelse{\equal{\volno}{}}
+      {}
+      {\smallskip Volume \volno{} of \volof}
       \vfill
       {\LARGE \textit{by} \par}
       \smallskip
@@ -772,7 +815,7 @@
         \ifthenelse{\equal{\orcid}{}}
         {}
         {\smallskip
-        ORCiD: \href{http://orcid.org/\orcid}{\orcid}}
+        ORCID iD: \href{https://orcid.org/\orcid}{\orcid}}
 
       \vfill
 %<*thesis>
@@ -806,7 +849,9 @@
   \global\let\author\relax
   \global\let\date\relax
   \global\let\and\relax
+%<*thesis|minithesis|progress|project|report>
   \cleardoublepage
+%</thesis|minithesis|progress|project|report>
 }
 %</thesis|minithesis|progress|project|report|gdp|gdpsummary>
 %<*article>
@@ -940,15 +985,16 @@
 {
   \btypeout{Abstract Page}
   \thispagestyle{empty}
-  \null\vfil
-  \begin{center}
+  \null\vfil\vfil
+  \begingroup
+   \centering
     \setlength{\parskip}{0pt}
     {\textsc\normalsize \univname \par}
     \bigskip
     {\underline{Abstract} \par}
+%<*thesis|minithesis|progress|project|report>
     \bigskip
     {\textsc\normalsize \facname \par}
-%<*thesis|minithesis|progress|project|report>
     {\textsc\normalsize \deptname \par}
 %</thesis|minithesis|progress|project|report>
     \bigskip
@@ -964,19 +1010,18 @@
 %<*project>
     {\normalsize \underline{A project report submitted for the award of \degreename}\par}
 %</project>
-%<*gdp>
-    {\normalsize \underline{A group design project report submitted for the award of \degreename}\par}
-%</gdp>
     \bigskip
     {\normalsize\bf \@title \par}
     \medskip
     {\normalsize by \authornames \par}
     \bigskip
-  \end{center}
+  \endgroup
 }
 {
-  \vfil\vfil\vfil\null
+%<*thesis|minithesis|progress|project|report>
+  \vfil\vfil\null
   \cleardoublepage
+%</thesis|minithesis|progress|project|report>
 }
 %</thesis|minithesis|progress|project|report|gdp>
 %<*article>
@@ -1039,16 +1084,22 @@
 % \end{macro}
 %
 % \subsection{Contents Pages}
+% Possibly all of these pages should be redone by using the tocloft package to reduce
+% complexity in this style file.
 %
 % \subsubsection{Add to Table of Contents}
 %
+% \begin{macro}{\addtotoc}
+%    Get a better list of contents package
+%
 %    Ensures numbering for sub-subsections in the table of contents, and provide
 %    for 6 levels to appear in toc. Define \texttt{addtotoc} to enable adding
 %    elements to the toc at chapter level, using a dummy counter to fix bookmarks
-%    in pdf\LaTeX.
+%    in pdf\LaTeX{}.
 %
 %    \begin{macrocode}
 %<*thesis|minithesis|progress|project|report|gdp|article>
+\usepackage[nottoc]{tocbibind}         % Put the Lists, Glossary, Biblog and Idx in the contents
 \addtocounter{secnumdepth}{1}
 \setcounter{tocdepth}{6}
 \newcounter{dummy}
@@ -1061,7 +1112,7 @@
 \addcontentsline{toc}{section}{#1}}
 %</article>
 %    \end{macrocode}
-%
+% \end{macro}
 % \subsubsection{Table of Contents}
 %
 % \begin{macro}{\tableofcontents}
@@ -1163,15 +1214,16 @@
 %    \end{macrocode}
 % \end{macro}
 %
-% \subsection{List of Symbols}
+% \subsubsection{List of Symbols}
 %
+% \begin{macro}{\listsymbolname}
 % \begin{macro}{\listofsymbols}
 %
 %    Provide a \texttt{listofsymbols} command to produce a list of symbols,
 %
 %    \begin{macrocode}
 %<*thesis|minithesis|progress|report|article>
-\newcommand\listsymbolname{Nomenclature}
+\newcommand\listsymbolname{Definitions and Abbreviations}
 %</thesis|minithesis|progress|report|article>
 %<*project|gdp>
 \newcommand\listsymbolname{List of Symbols}
@@ -1197,21 +1249,72 @@
 %    \end{macrocode}
 %
 % \end{macro}
+% \end{macro}
+%
+% \subsubsection{List of Additional Material}
+%
+% \begin{macro}{\addmaterialname}
+% \begin{macro}{\listofaddmaterial}
+% \begin{macro}{\addtolom}
+%
+%    Provide a \texttt{listofaddmaterial} command to produce a list of additional material,
+%    the name can be changed with \verb|\addmaterialname{NewName}|
+%
+%    Material can be added by using \verb|\addcontentsline{lom}{chapter}{Material Name}|
+%
+%    \begin{macrocode}
+\newcommand\addmaterialname{List of Additional Material}
+\newcommand\listofaddmaterial{
+\addtotoc{\addmaterialname}
+\begin{spacing}{1}{
+    \setlength{\parskip}{1pt}
+    \if@twocolumn
+      \@restonecoltrue\onecolumn
+    \else
+      \@restonecolfalse
+    \fi
+%<*thesis|minithesis|progress|project|report|gdp>
+    \chapter*{\addmaterialname
+%</thesis|minithesis|progress|project|report|gdp>
+%<*article|gdpsummary>
+    \section*{\addmaterialname
+%</article|gdpsummary>
+      \@mkboth{
+          \MakeUppercase\addmaterialname}{\MakeUppercase\addmaterialname}}
+    \@starttoc{lom}
+    \if@restonecol\twocolumn\fi
+%<*thesis|minithesis|progress|project|report|gdp>
+    \cleardoublepage
+%</thesis|minithesis|progress|project|report|gdp>
+}\end{spacing}
+}
+\newcommand\addtolom[1]{%
+\addtocontents{lom}{\protect\contentsline{chapter}{\protect\numberline{}#1}{}{}}
+}
+%    \end{macrocode}
+%
+% \end{macro}
+% \end{macro}
+% \end{macro}
 %
 % \subsection{Declaration of Authorship}
 % \begin{macro}{\authorshipdeclaration}
-% Taken from Modified Template by Lovell TODO: Complete reference
+% Taken from Modified Template by Lovell \ref{references}
+%
 % TODO: Consider a separate dissertation class for non techinical?
+%
 % TODO: Provide extra argument for putting the date into the Declaration
-% TODO: make slightly different declarations for theses and projects
 %
 % This Authorship macro takes one argument for the case of People
 % who have published part of their thesis already (perhaps in a paper).
 %
+% This authoship macro produces the statement of Originality for the gdp class.
+% The authorship is normally done in custom appendix for projects like this.
+%
 % xifthen else package used for the isempty command
 %
 %    \begin{macrocode}
-%<*thesis|minithesis|progress|report|article>
+%<*thesis|minithesis|progress|report|article|project>
 \usepackage{xifthen}
 \newcommand\authorshipdeclaration[1]{
 \btypeout{Declaration of Authorship}
@@ -1226,8 +1329,14 @@ been generated by me as the result of my own original research.
 I confirm that:
 
 \begin{enumerate}
+%<*thesis|minithesis|progress|article>
 \item This work was done wholly or mainly while in candidature for a research degree at this University;
 \item Where any part of this thesis has previously been submitted for a degree or any other qualification at this University or any other institution, this has been clearly stated;
+%</thesis|minithesis|progress|article>
+%<*project|report>
+\item This work was done wholly or mainly while in candidature for a degree at this University;
+\item Where any part of this report has previously been submitted for any other qualification at this University or any other institution, this has been clearly stated;
+%</project|report>
 \item Where I have consulted the published work of others, this is always clearly attributed;
 \item Where I have quoted from the work of others, the source is always given. With the exception of such quotations, this thesis is entirely my own work;
 \item I have acknowledged all main sources of help;
@@ -1239,17 +1348,47 @@ I confirm that:
 \end{enumerate}
 
 \vspace{15.0mm}
-\begin{minipage}{0.7\textwidth}
+\begin{minipage}[t]{0.7\textwidth}
   Signed:..........................................................................
 \end{minipage}%
-\begin{minipage}{0.3\textwidth}
-\vspace{3.0mm}
+\begin{minipage}[t]{0.3\textwidth}
   Date:..................
 \end{minipage}
 \vfil\vfil\null
 \cleardoublepage
 }
-%</thesis|minithesis|progress|report|article>
+%</thesis|minithesis|progress|report|article|project>
+%<*gdp>
+\usepackage{xifthen}
+\newcommand\authorshipdeclaration[2][]{
+\btypeout{Declaration of Authorship}
+\addtotoc{Statement of Originality}
+\thispagestyle{plain}
+\null\vfil
+\vskip 60\p@
+\begin{center}{\Large\bf Statement of Originality \par}\end{center}
+%TODO Check Spelling
+
+\begin{enumerate}
+
+\ifthenelse{\isempty{#1}}
+{
+\item I have read and understood the ECS Academic Integrity information
+%% http://ecs.gg/ai
+and the University’s Academic Integrity Guidance for Students.
+%% https://www.southampton.ac.uk/quality/assessment/academic_integrity.page
+\item I am aware that failure to act in accordance with the Regulations Governing Academic Integrity
+%% http://www.calendar.soton.ac.uk/sectionIV/academic-integrity-regs.html
+may lead to the imposition of penalties which, for the most serious cases, may include termination of programme.
+\item I consent to the University copying and distributing any or all of my work in any form and using third parties (who may be based outside the EU/EEA) to verify whether my work contains plagiarised material, and for quality assurance purposes.}
+{#1}
+%% The project specific statements
+#2
+\end{enumerate}
+\vfil\vfil\null
+\cleardoublepage
+}
+%</gdp>
 %    \end{macrocode}
 %
 % \end{macro}
@@ -1257,7 +1396,7 @@ I confirm that:
 % \subsection{Copyright Statement}
 % \begin{macro}{\copyrightDeclaration}
 %
-%    This standard Copyright statement is to be included for a theis submission
+%    This standard Copyright statement is to be included for a thesis submission
 %    to University of Southampton Digital Repository
 %
 %    \begin{macrocode}
@@ -1270,17 +1409,17 @@ I confirm that:
 
 \hspace{-1.5in}\hspace{2.5cm}\begin{minipage}{17cm}
 \null\vfil
-\includegraphics[width=6cm,right]{ecsUoSLogo.png}
+\includegraphics[width=6cm,right]{UoSLogo.pdf}
 
 \vskip 60\p@
 \begin{center}{\selectfont\huge
-\textcolor{SotGray}{University~of~Southampton~Research~Repository}\par}
+\textcolor{custGray}{University~of~Southampton~Research~Repository}\par}
 \end{center}
 \vspace{1cm}
 
-{\fontfamily{fds}\selectfont
+{\droidsans
 
-\noindent Copyright \textcopyright~ and Moral Rights for this thesis and, where
+\noindent Copyright \textcopyright{} and Moral Rights for this thesis and, where
 applicable, any accompanying data are retained by the author and/or other
 copyright owners. A copy can be downloaded for personal non-commercial research
 or study, without prior permission or charge. This thesis and the accompanying
@@ -1297,7 +1436,7 @@ details must be given, e.g.
 
 \vspace{0.5cm}
 
-Thesis: Author (Year of Submission) "Full thesis title", University of
+Thesis: Author (Year of Submission) ``Full thesis title'', University of
 Southampton, name of the University Faculty or School or Department,
 PhD Thesis, pagination.
 
@@ -1370,52 +1509,41 @@ Data: Author (Year) Title. URI [dataset]}
 % \section{Parts}
 %
 % \begin{macro}{\frontmatter}
-%
-%    Modify \texttt{frontmatter}.
-%
-%    \begin{macrocode}
-%<*article>
-\newcommand\frontmatter{ }
-%</article>
-%    \end{macrocode}
-% \end{macro}
-%
 % \begin{macro}{\mainmatter}
+% \begin{macro}{\backmatter}
+% \begin{macro}{\appendix}
 %
-%    Modify \texttt{mainmatter}.
+%    Define \texttt{frontmatter},\texttt{mainmatter},\texttt{backmatter} for the article class
+%    and rename the bibliography to something that makes more sense. For other classes make the
+%    Appendix entry in the table of contents better and rename the references in a slightly
+%    different way.
 %
 %    \begin{macrocode}
 %<*article>
+\newcommand\frontmatter{ }
 \newcommand\mainmatter{ }
+\newcommand\bibname{References}
+\newcommand\backmatter{}
 %</article>
-%    \end{macrocode}
-% \end{macro}
-%
-% \begin{macro}{\backmatter}
-%
-%    Modify \texttt{backmatter} to add the bibliography to the table of contents.
-%
-%    \begin{macrocode}
 %<*thesis|minithesis|progress|project|report|gdp>
-\renewcommand\backmatter{
-  \if@openright
-    \cleardoublepage
-  \else
-    \clearpage
-  \fi
-  \addtotoc{\bibname}
-  \btypeout{\bibname}
-  \@mainmatterfalse}
+\renewcommand\bibname{References}
+\let\oldappendix\appendix % Put full appendix name in ToC
+\renewcommand{\appendix}{%
+  \oldappendix
+  \let\oldacl@pp=\addcontentsline
+  \def\addcontentsline##1##2##3{\oldacl@pp{##1}{##2}{\appendixname\space ##3}}
+}
+\let\oldbackmatter\backmatter
+\def\backmatter{%
+  \oldbackmatter
+  \let\addcontentsline=\oldacl@pp
+  }
 %</thesis|minithesis|progress|project|report|gdp>
-%<*article>
-\newcommand\bibname{References}
-\newcommand\backmatter{
-  \addtotoc{\bibname}
-  \btypeout{\bibname}
-}
-%</article>
 %    \end{macrocode}
 % \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
 %
 %    \begin{macrocode}
 %</thesis|minithesis|progress|project|report|article|gdp|gdpsummary>
@@ -1426,45 +1554,67 @@ Data: Author (Year) Title. URI [dataset]}
 %
 %    \begin{macrocode}
 %<*testthesis>
-\documentclass{ecsthesis}      % Use the Thesis Style
+\documentclass[sotoncolour]{uosthesis}      % Use the Thesis Style with custom link colour
 %</testthesis>
 %<*testminithesis>
-\documentclass{ecsminithesis}  % Use the minithesis Style
+\documentclass[sotoncolour]{uosminithesis}  % Use the minithesis Style with custom link colour
 %</testminithesis>
 %<*testprogress>
-\documentclass{ecsprogress}    % Use the progress Style
+\documentclass[sotoncolour]{uosprogress}    % Use the progress Style with custom link colour
 %</testprogress>
 %<*testproject>
-\documentclass{ecsproject}     % Use the Project Style
+\documentclass[sotoncolour]{uosproject}     % Use the Project Style with custom link colour
 %</testproject>
 %<*testreport>
-\documentclass{ecsreport}      % Use the Report Style
+\documentclass[sotoncolour]{uosreport}      % Use the Report Style with custom link colour
 %</testreport>
 %<*testarticle>
-\documentclass{ecsarticle}     % Use the Article Style
+\documentclass[sotoncolour]{uosarticle}     % Use the Article Style with custom link colour
 %</testarticle>
 %<*testgdp>
-\documentclass{ecsgdp}         % Use the GDP Report Style
+\documentclass[sotoncolour]{uosgdp}         % Use the GDP Report Style with custom link colour
 %</testgdp>
 %<*testgdpsummary>
-\documentclass{ecsgdpsummary}  % Use the GDP Summary Report Style
+\documentclass[sotoncolour]{uosgdpsummary}  % Use the GDP Summary Report Style with custom link colour
 %</testgdpsummary>
 %<*testthesis|testminithesis|testprogress|testproject|testreport|testarticle|testgdp|testgdpsummary>
 \graphicspath{{../Figures/}}   % Location of your graphics files
-\usepackage{natbib}            % Use Natbib style for the refs.
+\usepackage[round]{natbib}            % Use Natbib style for the refs.
+%<*testthesis|testminithesis|testproject|testreport|testgdp>
+\usepackage{bibentry}          % Use bibentry for prepublished works
+\nobibliography*               % Use bibentry for prepublished works
+\usepackage{attrib}            % Use the attrib package for quotations
+%</testthesis|testminithesis|testproject|testreport|testgdp>
 \hypersetup{colorlinks=true}   % Set to false for black/white printing
+%<*testthesis>
+\hypersetup{pdfstartpage=3}    % Set first page to skip copyright declaration
+%</testthesis>
 \input{Definitions}            % Include your abbreviations
 %% ----------------------------------------------------------------
 %% --------------------THESIS/DOC INFORMATION ---------------------
+\faculty     {Faculty of [Insert faculty]}
+\FACULTY     {\MakeUppercase{\facname}}
+\department  {School of [Insert school]}
+\DEPARTMENT  {\MakeUppercase{\deptname}}
+\group       {[Group name]}
+\GROUP       {\MakeUppercase{\groupname}}
 \title      {An Investigation into \dots}
+%<*testthesis>
+%% TODO: Replace with your name removing []
+\authors    {[Insert full name, for example, Sarah Alison Watson]} % Use of Soton Email unadvised, use ORCID iD instead.
+%</testthesis>
+%<*testminithesis|testprogress|testproject|testreport|testarticle|testgdp|testgdpsummary>
 \authors    {\texorpdfstring
-             {\href{mailto:S.R.Gunn@ecs.soton.ac.uk}{Steve R. Gunn}}
-             {Steve R. Gunn}
+             {\href{mailto:S.A.Watson@soton.ac.uk}{Name and email, for example, Sarah Alison Watson}}
+             {Name and email, for example, Sarah Alison Watson}
             }
+%</testminithesis|testprogress|testproject|testreport|testarticle|testgdp|testgdpsummary>
 \addresses  {\groupname\\\deptname\\\univname}
 \date       {\today}
 %<*testminithesis|testprogress|testproject|testgdp|testgdpsummary>
+% \supervisor[s] {Mr Beavis and Mrs S Supervisor}
 \supervisor {Mr Beavis}
+% \examiner[s] {Dr Butthead and Dr A.N. Other}
 \examiner   {Dr Butthead}
 %</testminithesis|testprogress|testproject|testgdp|testgdpsummary>
 %<*testproject>
@@ -1473,11 +1623,13 @@ Data: Author (Year) Title. URI [dataset]}
 %<*testgdp|testgdpsummary>
 \degree     {Master of Engineering}
 %</testgdp|testgdpsummary>
-%% Optional Fields
-%<testthesis|testminithesis|testprogress> \qualifications{MEng PhD}
+%% Optional Fields TODO: Replace these fields with your own data
+%<testthesis|testminithesis|testprogress>
+\qualifications{[Insert Previous Qualifications, for example MEng]}
 %<*testthesis>
 \orcidid{0000-0002-1825-0097}
-\doi{10.1002/0470841559.ch1}
+\documentDoi{10.1002/0470841559.ch1}
+\volume{n}{m} %Optional Volume Numbering Volume n of m
 %</testthesis>
 \subject    {}
 \keywords   {}
@@ -1487,6 +1639,8 @@ Data: Author (Year) Title. URI [dataset]}
 %<*testthesis>
 \pagenumbering{gobble} % removes page number
 \copyrightDeclaration{} % !!! Comment this line when printing the hardcopy !!!
+\raggedright                  %% Set the style to Left justification, remove for fill justification
+                              %% Must be done after copyrightDeclaration
 %</testthesis>
 \frontmatter
 \maketitle
@@ -1494,27 +1648,59 @@ Data: Author (Year) Title. URI [dataset]}
 %<*testthesis|testminithesis|testprogress|testproject|testreport|testarticle|testgdp>
 \begin{abstract}
 This work is all about \dots
+%<*testthesis|testminithesis|testprogress>
+There are broad instructions for this template entitled: How to use the University of Southampton LaTeX template. There is a technical reference included in the \texttt{doc} folder with the templates.
+
+There is no prescribed font, you should use a font appropriate to your discipline.  See Producing your thesis section 7.2.
+%</testthesis|testminithesis|testprogress>
 \end{abstract}
 %<*testthesis|testminithesis|testprogress|testproject|testreport|testgdp>
+\pdfbookmark[0]{\contentsname}{toc} % Add pdf bookmark for contents page for navigation
 \tableofcontents
 \listoffigures
 \listoftables
 %% The List of listings does not, by default, appear in the ToC, so....
-\addtotoc{List of Listings}
+\addtotoc{Listings}
 \lstlistoflistings
-%</testthesis|testminithesis|testprogress|testproject|testreport|testgdp>
-\listofsymbols{ll}{$w$ & The weight vector}
-%</testthesis|testminithesis|testprogress|testproject|testreport|testarticle|testgdp>
-%<*testthesis|testminithesis|testproject|testreport|testgdp>
+\listofaddmaterial
+\addtolom{Material Name e.g Map}
+\addtolom{Material Name e.g CD}
+\addtolom{Test Material}
+%<*testthesis|testminithesis|testproject|testreport>
 %% ---------- AUTHORSHIP DECLARATION/ ACKNOW. / DEDICATORY ----------
 %% Either include citations like below (as many as required spaced with commas or 'and').
-\authorshipdeclaration{\citep{Gunn:2001:pdflatex}, \citep{Lovell:2011:updated} and \citep{Gunn:2011:updated2}}
+%% \bibentry command must be used here with prepublished papers
+% https://www.stefaanlippens.net/bibentry/
+\authorshipdeclaration{\bibentry{Gunn:2001:pdflatex}\newline\bibentry{Lovell:2011:updated}\newline\bibentry{Gunn:2011:updated2}}
 %% Or state no citations like below
 %% \authorshipdeclaration{}
 %% -----------------------
 \acknowledgements{Thanks to no one.}
 \dedicatory{To \dots}
-%</testthesis|testminithesis|testproject|testreport|testgdp>
+%</testthesis|testminithesis|testproject|testreport>
+%<*testgdp>
+%% ---------- STATEMENT OF ORIGINALITY/ ACKNOW. / DEDICATORY ----------
+%% based on ai_statement.docx available: https://secure.ecs.soton.ac.uk/notes/elec6200/
+%% If not for an ECS GDP and you want to remove or change the ECS Manadatory ai statements.
+%%\authorshipdeclaration[\item Department specific regulation]{\item extra statements}
+\authorshipdeclaration{
+%% ********You must change the statements below if you do not agree with them. ***********
+\item I have acknowledged all sources, and identified any content taken from elsewhere.
+\item I have not used any resources produced by anyone else.
+\item I did all the work myself, or with my allocated group, and have not helped anyone else.
+\item The material in the report is genuine, and I have included all my data/code/designs.
+\item I have not submitted any part of this work for another assessment.
+\item My work did not involve human participants, their cells or data, or animals.}
+%% -----------------------
+
+\acknowledgements{Thanks to no one.}
+\dedicatory{To \dots}
+%</testgdp>
+%%Lightweight Definitions and Abbreviations see package:nomencl for alternative
+%% Include if relevant to discipline
+\listofsymbols{ll}{$w$ & The weight vector\\$\S$ & If relevant to discipline}
+%</testthesis|testminithesis|testprogress|testproject|testreport|testgdp>
+%</testthesis|testminithesis|testprogress|testproject|testreport|testarticle|testgdp>
 %<*testthesis|testminithesis|testprogress|testproject|testreport|testarticle|testgdp|testgdpsummary>
 \mainmatter
 %% ------------------ MAIN MATTER (CONTENT) --------------------
@@ -1522,18 +1708,26 @@ This work is all about \dots
 %<*testthesis|testminithesis|testprogress|testproject|testreport|testgdp>
 \include{Introduction}
 \include{Conclusions}
-\begin{lstlisting}[caption=Without a title it doesn't appear in the table]
+\begin{lstlisting}[caption=Listing of what an example listing would be like]
 This is a test listing
 
-It has several lines
-That
-say not much at all
+The test listing has several lines
+to show how the listings
+will be displayed
 \end{lstlisting}
 \appendix
 \include{AppendixA}
 \backmatter
-\bibliographystyle{ecs}
-\bibliography{ECS}
+%<*testthesis|testminithesis|testprogress>
+\chapter{Glossary [if relevant]}
+%</testthesis|testminithesis|testprogress>
+\bibliographystyle{plainnat}
+\bibliography{UOS}
+%<*testthesis|testminithesis|testprogress>
+\chapter{Bibliography}
+To use bibliography as well as the references section use the \texttt{multibbl} package.
+\chapter{Index [if relevant]}
+%</testthesis|testminithesis|testprogress>
 %</testthesis|testminithesis|testprogress|testproject|testreport|testgdp>
 %<*testgdpsummary>
 \section*{Introduction}
@@ -1553,8 +1747,12 @@ say not much at all
 \section{Introduction} \label{Section:Introduction}
 %</testarticle>
 %<*introduction|testarticle>
-You probably found all the files from \cite{Gunn:2001:pdflatex}.
-\tref{Table:tabex} illustrates the results of my work.
+You probably found all the files from \cite{Longman:2019:templ},
+they were originally made from \cite{Gunn:2001:pdflatex}.
+Template specific instructions can be found at:
+\url{https://git.soton.ac.uk/el7g15/uos-latex-template-instructions}.
+
+\tref{Table:tabex} illustrates the results of some arbitrary example work.
 \begin{table}[!htb]
   \centering
   \begin{tabular}{cc}
@@ -1579,11 +1777,11 @@ You probably found all the files from \cite{Gunn:2001:pdflatex}.
 This page shows you a subfigure example in \fref{Figure:figsubex}.
 \begin{figure}[!htb]
   \centering
-  \subfigure[The left caption]{
+  \subcaptionbox{The left caption}{
     \includegraphics[width=4.2cm]{figure}
     \label{Figure:figsubex:left}
   }
-  \subfigure[The right caption]{
+  \subcaptionbox{The right caption}{
     \includegraphics[width=4.2cm]{figure}
     \label{Figure:figsubex:right}
   }
@@ -1592,11 +1790,22 @@ This page shows you a subfigure example in \fref{Figure:figsubex}.
 \end{figure}
 Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec rutrum sodales ligula, ac aliquam sem interdum at. Ut commodo pulvinar ipsum. Aliquam et diam sed nibh tincidunt mollis vitae quis nunc. In vel ante vitae felis semper malesuada sed a metus. Aliquam semper metus vel metus imperdiet, quis mollis nisi volutpat. Integer in convallis erat, et auctor dui. Phasellus id tristique tortor. Mauris ac nisi ut mi pulvinar interdum. Donec quis nibh tempus erat lobortis dapibus non a nunc. Nulla laoreet tempus fringilla. Aliquam pulvinar, sapien eu interdum gravida, libero urna dapibus sem, sodales efficitur lorem nunc et justo. Proin vitae dolor nisl.
 
+\section{A Section of a chapter}
 Nulla molestie velit sed dui ullamcorper viverra. Fusce placerat vulputate lacus eu consequat. Cras ullamcorper vel mauris quis aliquam. Curabitur non varius elit, eget commodo urna. Phasellus erat libero, faucibus elementum augue eget, malesuada fringilla purus. Quisque pulvinar, lectus sit amet ultricies tristique, eros nunc commodo lacus, nec ultrices risus lorem vitae diam. Cras ac ornare nisi.
 
-Nam egestas felis euismod erat tincidunt ornare. Nulla hendrerit tempor purus ac consequat. Aliquam commodo, ipsum vestibulum lobortis semper, urna turpis sagittis dolor, id ullamcorper nulla nisl vitae ex. Vivamus ut metus vel velit rhoncus pulvinar sit amet nec diam. Aliquam aliquet, enim eget efficitur euismod, velit arcu mattis nisl, a mollis dui leo vel libero. Nullam porttitor convallis magna ut feugiat. Cras at ultrices metus. Nullam vulputate quis justo sit amet pharetra. Praesent sodales eros non suscipit gravida.
+\subsection{Some quotes}
+
+Nam egestas felis euismod erat tincidunt ornare. Nulla hendrerit tempor purus ac consequat. Aliquam commodo, ipsum vestibulum lobortis semper, urna turpis sagittis dolor, id ullamcorper nulla nisl vitae ex. Vivamus ut metus vel velit rhoncus pulvinar sit amet nec diam. Aliquam aliquet, enim eget efficitur euismod, velit arcu mattis nisl, a mollis dui leo vel libero. Nullam porttitor convallis magna ut feugiat. `Cras at ultrices metus.' Nullam vulputate quis justo sit amet pharetra. Praesent sodales eros non suscipit gravida.
+\begin{quote}
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec rutrum sodales ligula, ac aliquam sem interdum at.
+\end{quote}
 
 Pellentesque sodales lobortis feugiat. Vivamus volutpat mauris id odio aliquam maximus sed sit amet nibh. Fusce odio tortor, aliquam et mauris facilisis, interdum placerat tortor. Suspendisse dapibus, massa eget cursus congue, mi lectus luctus nisl, vitae sagittis ligula ante sit amet enim. Donec quis sapien vel ex vestibulum porta. Vivamus mattis sodales turpis, id interdum justo ullamcorper a. Aenean ornare urna turpis, id fermentum eros commodo aliquet. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Donec cursus pretium ex at mollis. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae; Sed at diam quam. Etiam a sollicitudin dui. Nulla facilisi. Phasellus condimentum tincidunt ipsum. Sed dignissim neque a porttitor finibus. Maecenas pretium dictum lorem vitae viverra.
+\begin{quote}
+The \verb|\attrib| macro attributes block elements, for example when citing
+a reference after a block quotation.
+\ifdefined\attrib\attrib{\cite{attribpackage}}\fi
+\end{quote}
 
 Donec vitae massa nisi. Praesent sed sollicitudin urna. Suspendisse vitae cursus tortor. In egestas quis dolor ac porttitor. Pellentesque suscipit leo nisi, a semper nunc interdum quis. Aenean massa magna, aliquam imperdiet lorem vitae, vestibulum dignissim nunc. Nunc molestie eleifend dui et porta. Sed auctor eu nunc vel faucibus. Integer et finibus metus, pharetra egestas velit. Sed nec magna semper, rutrum diam vitae, accumsan sapien. Donec congue viverra luctus.
 %</introduction|testarticle>
@@ -1613,9 +1822,9 @@ It works.
 %<*testarticle>
 \acknowledgements{Thanks to no one.}
 \backmatter
-\bibliographystyle{ecs}
-\bibliography{ECS}
 \appendix
+\bibliographystyle{plainnat}
+\bibliography{UOS}
 %</testarticle>
 %<*appendix|testarticle>
 %<*appendix>
@@ -1836,10 +2045,17 @@ showpage
 %</definitions>
 %    \end{macrocode}
 %
-% \subsection{References File}
+% \subsection{References File}\label{references}
 %
 %    \begin{macrocode}
 %<*references>
+@MISC{Longman:2019:templ,
+  author =       {E. Longman},
+  title =        {{University of Southampton LaTeX documents}},
+  year =         {2019},
+  NOTE =     "\url{https://library.soton.ac.uk/thesis/templates} and
+             \url{https://git.soton.ac.uk/el7g15/uos-latex-template}",
+}
 @MISC{Gunn:2001:pdflatex,
   author =       {S.R. Gunn},
   title =        {PDFLaTeX Instructions},
@@ -1856,1374 +2072,19 @@ showpage
   title =        {Updated templates reference 2},
   year =         {2011}
 }
+@MISC{attribpackage,
+  author =       {Matt Swift},
+  title =        {The attrib LaTeX package
+attribution of block elements (Frankenstein’s hat)},
+  year =         {1999},
+  url =          {http://cs.brown.edu/about/system/managed/latex/doc/attrib.pdf}
+}
 
 %</references>
 %    \end{macrocode}
 %
 % \subsection{Bibliography Style File}
-%
-%    \begin{macrocode}
-%<*bst>
-%% File: `ecs.bst'
-%% A modification of `plainnat.bst' for use with natbib package
-%%
-%% Copyright 1993-1999 Patrick W Daly
-%% Max-Planck-Institut f\"ur Aeronomie
-%% Max-Planck-Str. 2
-%% D-37191 Katlenburg-Lindau
-%% Germany
-%% E-mail: daly@linmpi.mpg.de
-%%
-%% This program can be redistributed and/or modified under the terms
-%% of the LaTeX Project Public License Distributed from CTAN
-%% archives in directory macros/latex/base/lppl.txt; either
-%% version 1 of the License, or any later version.
-%%
-%% Includes field URL for Internet addresses
-%%
-ENTRY
-  { address
-    author
-    booktitle
-    chapter
-    edition
-    editor
-    howpublished
-    institution
-    isbn
-    issn
-    journal
-    key
-    month
-    note
-    number
-    organization
-    pages
-    publisher
-    school
-    series
-    title
-    type
-    url
-    volume
-    year
-  }
-  {}
-  { label extra.label sort.label short.list }
-
-INTEGERS { output.state before.all mid.sentence after.sentence after.block }
-
-FUNCTION {init.state.consts}
-{ #0 'before.all :=
-  #1 'mid.sentence :=
-  #2 'after.sentence :=
-  #3 'after.block :=
-}
-
-STRINGS { s t }
-
-FUNCTION {output.nonnull}
-{ 's :=
-  output.state mid.sentence =
-    { ", " * write$ }
-    { output.state after.block =
-        { add.period$ write$
-          newline$
-          "\newblock " write$
-        }
-        { output.state before.all =
-            'write$
-            { add.period$ " " * write$ }
-          if$
-        }
-      if$
-      mid.sentence 'output.state :=
-    }
-  if$
-  s
-}
-
-FUNCTION {output}
-{ duplicate$ empty$
-    'pop$
-    'output.nonnull
-  if$
-}
-
-FUNCTION {output.check}
-{ 't :=
-  duplicate$ empty$
-    { pop$ "empty " t * " in " * cite$ * warning$ }
-    'output.nonnull
-  if$
-}
-
-FUNCTION {fin.entry}
-{ add.period$
-  write$
-  newline$
-}
-
-FUNCTION {new.block}
-{ output.state before.all =
-    'skip$
-    { after.block 'output.state := }
-  if$
-}
-
-FUNCTION {new.sentence}
-{ output.state after.block =
-    'skip$
-    { output.state before.all =
-        'skip$
-        { after.sentence 'output.state := }
-      if$
-    }
-  if$
-}
-
-FUNCTION {not}
-{   { #0 }
-    { #1 }
-  if$
-}
-
-FUNCTION {and}
-{   'skip$
-    { pop$ #0 }
-  if$
-}
-
-FUNCTION {or}
-{   { pop$ #1 }
-    'skip$
-  if$
-}
-
-FUNCTION {new.block.checka}
-{ empty$
-    'skip$
-    'new.block
-  if$
-}
-
-FUNCTION {new.block.checkb}
-{ empty$
-  swap$ empty$
-  and
-    'skip$
-    'new.block
-  if$
-}
-
-FUNCTION {new.sentence.checka}
-{ empty$
-    'skip$
-    'new.sentence
-  if$
-}
-
-FUNCTION {new.sentence.checkb}
-{ empty$
-  swap$ empty$
-  and
-    'skip$
-    'new.sentence
-  if$
-}
-
-FUNCTION {field.or.null}
-{ duplicate$ empty$
-    { pop$ "" }
-    'skip$
-  if$
-}
-
-FUNCTION {emphasize}
-{ duplicate$ empty$
-    { pop$ "" }
-    { "{\em " swap$ * "}" * }
-  if$
-}
-
-INTEGERS { nameptr namesleft numnames }
-
-FUNCTION {format.names}
-{ 's :=
-  #1 'nameptr :=
-  s num.names$ 'numnames :=
-  numnames 'namesleft :=
-    { namesleft #0 > }
-    { s nameptr "{ff~}{vv~}{ll}{, jj}" format.name$ 't :=
-      nameptr #1 >
-        { namesleft #1 >
-            { ", " * t * }
-            { numnames #2 >
-                { "," * }
-                'skip$
-              if$
-              t "others" =
-                { " et~al." * }
-                { " and " * t * }
-              if$
-            }
-          if$
-        }
-        't
-      if$
-      nameptr #1 + 'nameptr :=
-      namesleft #1 - 'namesleft :=
-    }
-  while$
-}
-
-FUNCTION {format.key}
-{ empty$
-    { key field.or.null }
-    { "" }
-  if$
-}
-
-FUNCTION {format.authors}
-{ author empty$
-    { "" }
-    { author format.names }
-  if$
-}
-
-FUNCTION {format.editors}
-{ editor empty$
-    { "" }
-    { editor format.names
-      editor num.names$ #1 >
-        { ", editors" * }
-        { ", editor" * }
-      if$
-    }
-  if$
-}
-
-FUNCTION {format.isbn}
-{ isbn empty$
-    { "" }
-    { new.block "ISBN " isbn * }
-  if$
-}
-
-FUNCTION {format.issn}
-{ issn empty$
-    { "" }
-    { new.block "ISSN " issn * }
-  if$
-}
-
-%FUNCTION {format.url}
-%{ url empty$
-%    { "" }
-%    { new.block "URL \url{" url * "}" * }
-%  if$
-%}
-%
-%FUNCTION {format.title}
-%{ title empty$
-%    { "" }
-%    { title "t" change.case$ }
-%  if$
-%}
-FUNCTION {format.url}
-{ ""
-}
-
-FUNCTION {format.title}
-{ title empty$
-    { "" }
-    { url empty$
-        { title "t" change.case$ }
-        { "\href{" url * "}{" * title "t" change.case$ * "}" * }
-      if$
-    }
-    if$
-}
-
-
-FUNCTION {format.full.names}
-{'s :=
-  #1 'nameptr :=
-  s num.names$ 'numnames :=
-  numnames 'namesleft :=
-    { namesleft #0 > }
-    { s nameptr
-      "{vv~}{ll}" format.name$ 't :=
-      nameptr #1 >
-        {
-          namesleft #1 >
-            { ", " * t * }
-            {
-              numnames #2 >
-                { "," * }
-                'skip$
-              if$
-              t "others" =
-                { " et~al." * }
-                { " and " * t * }
-              if$
-            }
-          if$
-        }
-        't
-      if$
-      nameptr #1 + 'nameptr :=
-      namesleft #1 - 'namesleft :=
-    }
-  while$
-}
-
-FUNCTION {author.editor.full}
-{ author empty$
-    { editor empty$
-        { "" }
-        { editor format.full.names }
-      if$
-    }
-    { author format.full.names }
-  if$
-}
-
-FUNCTION {author.full}
-{ author empty$
-    { "" }
-    { author format.full.names }
-  if$
-}
-
-FUNCTION {editor.full}
-{ editor empty$
-    { "" }
-    { editor format.full.names }
-  if$
-}
-
-FUNCTION {make.full.names}
-{ type$ "book" =
-  type$ "inbook" =
-  or
-    'author.editor.full
-    { type$ "proceedings" =
-        'editor.full
-        'author.full
-      if$
-    }
-  if$
-}
-
-FUNCTION {output.bibitem}
-{ newline$
-  "\bibitem[" write$
-  label write$
-  ")" make.full.names duplicate$ short.list =
-     { pop$ }
-     { * }
-   if$
-  "]{" * write$
-  cite$ write$
-  "}" write$
-  newline$
-  ""
-  before.all 'output.state :=
-}
-
-FUNCTION {n.dashify}
-{ 't :=
-  ""
-    { t empty$ not }
-    { t #1 #1 substring$ "-" =
-        { t #1 #2 substring$ "--" = not
-            { "--" *
-              t #2 global.max$ substring$ 't :=
-            }
-            {   { t #1 #1 substring$ "-" = }
-                { "-" *
-                  t #2 global.max$ substring$ 't :=
-                }
-              while$
-            }
-          if$
-        }
-        { t #1 #1 substring$ *
-          t #2 global.max$ substring$ 't :=
-        }
-      if$
-    }
-  while$
-}
-
-FUNCTION {format.date}
-{ year duplicate$ empty$
-    { "empty year in " cite$ * warning$
-       pop$ "" }
-    'skip$
-  if$
-  month empty$
-    'skip$
-    { month
-      " " * swap$ *
-    }
-  if$
-  extra.label *
-}
-
-FUNCTION {format.btitle}
-{ title emphasize
-}
-
-FUNCTION {tie.or.space.connect}
-{ duplicate$ text.length$ #3 <
-    { "~" }
-    { " " }
-  if$
-  swap$ * *
-}
-
-FUNCTION {either.or.check}
-{ empty$
-    'pop$
-    { "can't use both " swap$ * " fields in " * cite$ * warning$ }
-  if$
-}
-
-FUNCTION {format.bvolume}
-{ volume empty$
-    { "" }
-    { "volume" volume tie.or.space.connect
-      series empty$
-        'skip$
-        { " of " * series emphasize * }
-      if$
-      "volume and number" number either.or.check
-    }
-  if$
-}
-
-FUNCTION {format.number.series}
-{ volume empty$
-    { number empty$
-        { series field.or.null }
-        { output.state mid.sentence =
-            { "number" }
-            { "Number" }
-          if$
-          number tie.or.space.connect
-          series empty$
-            { "there's a number but no series in " cite$ * warning$ }
-            { " in " * series * }
-          if$
-        }
-      if$
-    }
-    { "" }
-  if$
-}
-
-FUNCTION {format.edition}
-{ edition empty$
-    { "" }
-    { output.state mid.sentence =
-        { edition "l" change.case$ " edition" * }
-        { edition "t" change.case$ " edition" * }
-      if$
-    }
-  if$
-}
-
-INTEGERS { multiresult }
-
-FUNCTION {multi.page.check}
-{ 't :=
-  #0 'multiresult :=
-    { multiresult not
-      t empty$ not
-      and
-    }
-    { t #1 #1 substring$
-      duplicate$ "-" =
-      swap$ duplicate$ "," =
-      swap$ "+" =
-      or or
-        { #1 'multiresult := }
-        { t #2 global.max$ substring$ 't := }
-      if$
-    }
-  while$
-  multiresult
-}
-
-FUNCTION {format.pages}
-{ pages empty$
-    { "" }
-    { pages multi.page.check
-        { "pages" pages n.dashify tie.or.space.connect }
-        { "page" pages tie.or.space.connect }
-      if$
-    }
-  if$
-}
-
-FUNCTION {format.vol.num.pages}
-{ volume field.or.null
-  number empty$
-    'skip$
-    { "\penalty0 (" number * ")" * *
-      volume empty$
-        { "there's a number but no volume in " cite$ * warning$ }
-        'skip$
-      if$
-    }
-  if$
-  pages empty$
-    'skip$
-    { duplicate$ empty$
-        { pop$ format.pages }
-        { ":\penalty0 " * pages n.dashify * }
-      if$
-    }
-  if$
-}
-
-FUNCTION {format.chapter.pages}
-{ chapter empty$
-    'format.pages
-    { type empty$
-        { "chapter" }
-        { type "l" change.case$ }
-      if$
-      chapter tie.or.space.connect
-      pages empty$
-        'skip$
-        { ", " * format.pages * }
-      if$
-    }
-  if$
-}
-
-FUNCTION {format.in.ed.booktitle}
-{ booktitle empty$
-    { "" }
-    { editor empty$
-        { "In " booktitle emphasize * }
-        { "In " format.editors * ", " * booktitle emphasize * }
-      if$
-    }
-  if$
-}
-
-FUNCTION {empty.misc.check}
-{ author empty$ title empty$ howpublished empty$
-  month empty$ year empty$ note empty$
-  and and and and and
-  key empty$ not and
-    { "all relevant fields are empty in " cite$ * warning$ }
-    'skip$
-  if$
-}
-
-FUNCTION {format.thesis.type}
-{ type empty$
-    'skip$
-    { pop$
-      type "t" change.case$
-    }
-  if$
-}
-
-FUNCTION {format.tr.number}
-{ type empty$
-    { "Technical Report" }
-    'type
-  if$
-  number empty$
-    { "t" change.case$ }
-    { number tie.or.space.connect }
-  if$
-}
-
-FUNCTION {format.article.crossref}
-{ key empty$
-    { journal empty$
-        { "need key or journal for " cite$ * " to crossref " * crossref *
-          warning$
-          ""
-        }
-        { "In {\em " journal * "\/}" * }
-      if$
-    }
-    { "In " key * }
-  if$
-  " \citep{" * crossref * "}" *
-}
-
-FUNCTION {format.book.crossref}
-{ volume empty$
-    { "empty volume in " cite$ * "'s crossref of " * crossref * warning$
-      "In "
-    }
-    { "Volume" volume tie.or.space.connect
-      " of " *
-    }
-  if$
-  editor empty$
-  editor field.or.null author field.or.null =
-  or
-    { key empty$
-        { series empty$
-            { "need editor, key, or series for " cite$ * " to crossref " *
-              crossref * warning$
-              "" *
-            }
-            { "{\em " * series * "\/}" * }
-          if$
-        }
-        { key * }
-      if$
-    }
-    'skip$
-  if$
-  ", \citet{" * crossref * "}" *
-}
-
-FUNCTION {format.incoll.inproc.crossref}
-{ editor empty$
-  editor field.or.null author field.or.null =
-  or
-    { key empty$
-        { booktitle empty$
-            { "need editor, key, or booktitle for " cite$ * " to crossref " *
-              crossref * warning$
-              ""
-            }
-            { "In {\em " booktitle * "\/}" * }
-          if$
-        }
-        { "In " key * }
-      if$
-    }
-    { "In " }
-  if$
-  " \citet{" * crossref * "}" *
-}
-
-FUNCTION {article}
-{ output.bibitem
-  format.authors "author" output.check
-  author format.key output
-  new.block
-  format.title "title" output.check
-  new.block
-  crossref missing$
-    { journal emphasize "journal" output.check
-      format.vol.num.pages output
-      format.date "year" output.check
-    }
-    { format.article.crossref output.nonnull
-      format.pages output
-    }
-  if$
-  format.issn output
-  format.url output
-  new.block
-  note output
-  fin.entry
-}
-
-FUNCTION {book}
-{ output.bibitem
-  author empty$
-    { format.editors "author and editor" output.check
-      editor format.key output
-    }
-    { format.authors output.nonnull
-      crossref missing$
-        { "author and editor" editor either.or.check }
-        'skip$
-      if$
-    }
-  if$
-  new.block
-  format.btitle "title" output.check
-  crossref missing$
-    { format.bvolume output
-      new.block
-      format.number.series output
-      new.sentence
-      publisher "publisher" output.check
-      address output
-    }
-    { new.block
-      format.book.crossref output.nonnull
-    }
-  if$
-  format.edition output
-  format.date "year" output.check
-  format.isbn output
-  format.url output
-  new.block
-  note output
-  fin.entry
-}
-
-FUNCTION {booklet}
-{ output.bibitem
-  format.authors output
-  author format.key output
-  new.block
-  format.title "title" output.check
-  howpublished address new.block.checkb
-  howpublished output
-  address output
-  format.date output
-  format.isbn output
-  format.url output
-  new.block
-  note output
-  fin.entry
-}
-
-FUNCTION {inbook}
-{ output.bibitem
-  author empty$
-    { format.editors "author and editor" output.check
-      editor format.key output
-    }
-    { format.authors output.nonnull
-      crossref missing$
-        { "author and editor" editor either.or.check }
-        'skip$
-      if$
-    }
-  if$
-  new.block
-  format.btitle "title" output.check
-  crossref missing$
-    { format.bvolume output
-      format.chapter.pages "chapter and pages" output.check
-      new.block
-      format.number.series output
-      new.sentence
-      publisher "publisher" output.check
-      address output
-    }
-    { format.chapter.pages "chapter and pages" output.check
-      new.block
-      format.book.crossref output.nonnull
-    }
-  if$
-  format.edition output
-  format.date "year" output.check
-  format.isbn output
-  format.url output
-  new.block
-  note output
-  fin.entry
-}
-
-FUNCTION {incollection}
-{ output.bibitem
-  format.authors "author" output.check
-  author format.key output
-  new.block
-  format.title "title" output.check
-  new.block
-  crossref missing$
-    { format.in.ed.booktitle "booktitle" output.check
-      format.bvolume output
-      format.number.series output
-      format.chapter.pages output
-      new.sentence
-      publisher "publisher" output.check
-      address output
-      format.edition output
-      format.date "year" output.check
-    }
-    { format.incoll.inproc.crossref output.nonnull
-      format.chapter.pages output
-    }
-  if$
-  format.isbn output
-  format.url output
-  new.block
-  note output
-  fin.entry
-}
-
-FUNCTION {inproceedings}
-{ output.bibitem
-  format.authors "author" output.check
-  author format.key output
-  new.block
-  format.title "title" output.check
-  new.block
-  crossref missing$
-    { format.in.ed.booktitle "booktitle" output.check
-      format.bvolume output
-      format.number.series output
-      format.pages output
-      address empty$
-        { organization publisher new.sentence.checkb
-          organization output
-          publisher output
-          format.date "year" output.check
-        }
-        { address output.nonnull
-          format.date "year" output.check
-          new.sentence
-          organization output
-          publisher output
-        }
-      if$
-    }
-    { format.incoll.inproc.crossref output.nonnull
-      format.pages output
-    }
-  if$
-  format.isbn output
-  format.url output
-  new.block
-  note output
-  fin.entry
-}
-
-FUNCTION {conference} { inproceedings }
-
-FUNCTION {manual}
-{ output.bibitem
-  format.authors output
-  author format.key output
-  new.block
-  format.btitle "title" output.check
-  organization address new.block.checkb
-  organization output
-  address output
-  format.edition output
-  format.date output
-  format.url output
-  new.block
-  note output
-  fin.entry
-}
-
-FUNCTION {mastersthesis}
-{ output.bibitem
-  format.authors "author" output.check
-  author format.key output
-  new.block
-  format.title "title" output.check
-  new.block
-  "Master's thesis" format.thesis.type output.nonnull
-  school "school" output.check
-  address output
-  format.date "year" output.check
-  format.url output
-  new.block
-  note output
-  fin.entry
-}
-
-FUNCTION {misc}
-{ output.bibitem
-  format.authors output
-  author format.key output
-  title howpublished new.block.checkb
-  format.title output
-  howpublished new.block.checka
-  howpublished output
-  format.date output
-  format.issn output
-  format.url output
-  new.block
-  note output
-  fin.entry
-  empty.misc.check
-}
-
-FUNCTION {phdthesis}
-{ output.bibitem
-  format.authors "author" output.check
-  author format.key output
-  new.block
-  format.btitle "title" output.check
-  new.block
-  "PhD thesis" format.thesis.type output.nonnull
-  school "school" output.check
-  address output
-  format.date "year" output.check
-  format.url output
-  new.block
-  note output
-  fin.entry
-}
-
-FUNCTION {proceedings}
-{ output.bibitem
-  format.editors output
-  editor format.key output
-  new.block
-  format.btitle "title" output.check
-  format.bvolume output
-  format.number.series output
-  address output
-  format.date "year" output.check
-  new.sentence
-  organization output
-  publisher output
-  format.isbn output
-  format.url output
-  new.block
-  note output
-  fin.entry
-}
-
-FUNCTION {techreport}
-{ output.bibitem
-  format.authors "author" output.check
-  author format.key output
-  new.block
-  format.title "title" output.check
-  new.block
-  format.tr.number output.nonnull
-  institution "institution" output.check
-  address output
-  format.date "year" output.check
-  format.url output
-  new.block
-  note output
-  fin.entry
-}
-
-FUNCTION {unpublished}
-{ output.bibitem
-  format.authors "author" output.check
-  author format.key output
-  new.block
-  format.title "title" output.check
-  format.url output
-  new.block
-  note "note" output.check
-  format.date output
-  fin.entry
-}
-
-FUNCTION {default.type} { misc }
-
-
-MACRO {jan} {"January"}
-
-MACRO {feb} {"February"}
-
-MACRO {mar} {"March"}
-
-MACRO {apr} {"April"}
-
-MACRO {may} {"May"}
-
-MACRO {jun} {"June"}
-
-MACRO {jul} {"July"}
-
-MACRO {aug} {"August"}
-
-MACRO {sep} {"September"}
-
-MACRO {oct} {"October"}
-
-MACRO {nov} {"November"}
-
-MACRO {dec} {"December"}
-
-
-
-MACRO {acmcs} {"ACM Computing Surveys"}
-
-MACRO {acta} {"Acta Informatica"}
-
-MACRO {cacm} {"Communications of the ACM"}
-
-MACRO {ibmjrd} {"IBM Journal of Research and Development"}
-
-MACRO {ibmsj} {"IBM Systems Journal"}
-
-MACRO {ieeese} {"IEEE Transactions on Software Engineering"}
-
-MACRO {ieeetc} {"IEEE Transactions on Computers"}
-
-MACRO {ieeetcad}
- {"IEEE Transactions on Computer-Aided Design of Integrated Circuits"}
-
-MACRO {ipl} {"Information Processing Letters"}
-
-MACRO {jacm} {"Journal of the ACM"}
-
-MACRO {jcss} {"Journal of Computer and System Sciences"}
-
-MACRO {scp} {"Science of Computer Programming"}
-
-MACRO {sicomp} {"SIAM Journal on Computing"}
-
-MACRO {tocs} {"ACM Transactions on Computer Systems"}
-
-MACRO {tods} {"ACM Transactions on Database Systems"}
-
-MACRO {tog} {"ACM Transactions on Graphics"}
-
-MACRO {toms} {"ACM Transactions on Mathematical Software"}
-
-MACRO {toois} {"ACM Transactions on Office Information Systems"}
-
-MACRO {toplas} {"ACM Transactions on Programming Languages and Systems"}
-
-MACRO {tcs} {"Theoretical Computer Science"}
-
-
-READ
-
-FUNCTION {sortify}
-{ purify$
-  "l" change.case$
-}
-
-INTEGERS { len }
-
-FUNCTION {chop.word}
-{ 's :=
-  'len :=
-  s #1 len substring$ =
-    { s len #1 + global.max$ substring$ }
-    's
-  if$
-}
-
-FUNCTION {format.lab.names}
-{ 's :=
-  s #1 "{vv~}{ll}" format.name$
-  s num.names$ duplicate$
-  #2 >
-    { pop$ " et~al." * }
-    { #2 <
-        'skip$
-        { s #2 "{ff }{vv }{ll}{ jj}" format.name$ "others" =
-            { " et~al." * }
-            { " and " * s #2 "{vv~}{ll}" format.name$ * }
-          if$
-        }
-      if$
-    }
-  if$
-}
-
-FUNCTION {author.key.label}
-{ author empty$
-    { key empty$
-        { cite$ #1 #3 substring$ }
-        'key
-      if$
-    }
-    { author format.lab.names }
-  if$
-}
-
-FUNCTION {author.editor.key.label}
-{ author empty$
-    { editor empty$
-        { key empty$
-            { cite$ #1 #3 substring$ }
-            'key
-          if$
-        }
-        { editor format.lab.names }
-      if$
-    }
-    { author format.lab.names }
-  if$
-}
-
-FUNCTION {author.key.organization.label}
-{ author empty$
-    { key empty$
-        { organization empty$
-            { cite$ #1 #3 substring$ }
-            { "The " #4 organization chop.word #3 text.prefix$ }
-          if$
-        }
-        'key
-      if$
-    }
-    { author format.lab.names }
-  if$
-}
-
-FUNCTION {editor.key.organization.label}
-{ editor empty$
-    { key empty$
-        { organization empty$
-            { cite$ #1 #3 substring$ }
-            { "The " #4 organization chop.word #3 text.prefix$ }
-          if$
-        }
-        'key
-      if$
-    }
-    { editor format.lab.names }
-  if$
-}
-
-FUNCTION {calc.short.authors}
-{ type$ "book" =
-  type$ "inbook" =
-  or
-    'author.editor.key.label
-    { type$ "proceedings" =
-        'editor.key.organization.label
-        { type$ "manual" =
-            'author.key.organization.label
-            'author.key.label
-          if$
-        }
-      if$
-    }
-  if$
-  'short.list :=
-}
-
-FUNCTION {calc.label}
-{ calc.short.authors
-  short.list
-  "("
-  *
-  year duplicate$ empty$
-  short.list key field.or.null = or
-     { pop$ "" }
-     'skip$
-  if$
-  *
-  'label :=
-}
-
-FUNCTION {sort.format.names}
-{ 's :=
-  #1 'nameptr :=
-  ""
-  s num.names$ 'numnames :=
-  numnames 'namesleft :=
-    { namesleft #0 > }
-    { nameptr #1 >
-        { "   " * }
-        'skip$
-      if$
-      s nameptr "{vv{ } }{ll{ }}{  ff{ }}{  jj{ }}" format.name$ 't :=
-      nameptr numnames = t "others" = and
-        { "et al" * }
-        { t sortify * }
-      if$
-      nameptr #1 + 'nameptr :=
-      namesleft #1 - 'namesleft :=
-    }
-  while$
-}
-
-FUNCTION {sort.format.title}
-{ 't :=
-  "A " #2
-    "An " #3
-      "The " #4 t chop.word
-    chop.word
-  chop.word
-  sortify
-  #1 global.max$ substring$
-}
-
-FUNCTION {author.sort}
-{ author empty$
-    { key empty$
-        { "to sort, need author or key in " cite$ * warning$
-          ""
-        }
-        { key sortify }
-      if$
-    }
-    { author sort.format.names }
-  if$
-}
-
-FUNCTION {author.editor.sort}
-{ author empty$
-    { editor empty$
-        { key empty$
-            { "to sort, need author, editor, or key in " cite$ * warning$
-              ""
-            }
-            { key sortify }
-          if$
-        }
-        { editor sort.format.names }
-      if$
-    }
-    { author sort.format.names }
-  if$
-}
-
-FUNCTION {author.organization.sort}
-{ author empty$
-    { organization empty$
-        { key empty$
-            { "to sort, need author, organization, or key in " cite$ * warning$
-              ""
-            }
-            { key sortify }
-          if$
-        }
-        { "The " #4 organization chop.word sortify }
-      if$
-    }
-    { author sort.format.names }
-  if$
-}
-
-FUNCTION {editor.organization.sort}
-{ editor empty$
-    { organization empty$
-        { key empty$
-            { "to sort, need editor, organization, or key in " cite$ * warning$
-              ""
-            }
-            { key sortify }
-          if$
-        }
-        { "The " #4 organization chop.word sortify }
-      if$
-    }
-    { editor sort.format.names }
-  if$
-}
-
-FUNCTION {presort}
-{ calc.label
-  label sortify
-  "    "
-  *
-  type$ "book" =
-  type$ "inbook" =
-  or
-    'author.editor.sort
-    { type$ "proceedings" =
-        'editor.organization.sort
-        { type$ "manual" =
-            'author.organization.sort
-            'author.sort
-          if$
-        }
-      if$
-    }
-  if$
-  "    "
-  *
-  year field.or.null sortify
-  *
-  "    "
-  *
-  title field.or.null
-  sort.format.title
-  *
-  #1 entry.max$ substring$
-  'sort.label :=
-  sort.label *
-  #1 entry.max$ substring$
-  'sort.key$ :=
-}
-
-ITERATE {presort}
-
-SORT
-
-STRINGS { longest.label last.label next.extra }
-
-INTEGERS { longest.label.width last.extra.num number.label }
-
-FUNCTION {initialize.longest.label}
-{ "" 'longest.label :=
-  #0 int.to.chr$ 'last.label :=
-  "" 'next.extra :=
-  #0 'longest.label.width :=
-  #0 'last.extra.num :=
-  #0 'number.label :=
-}
-
-FUNCTION {forward.pass}
-{ last.label label =
-    { last.extra.num #1 + 'last.extra.num :=
-      last.extra.num int.to.chr$ 'extra.label :=
-    }
-    { "a" chr.to.int$ 'last.extra.num :=
-      "" 'extra.label :=
-      label 'last.label :=
-    }
-  if$
-  number.label #1 + 'number.label :=
-}
-
-FUNCTION {reverse.pass}
-{ next.extra "b" =
-    { "a" 'extra.label := }
-    'skip$
-  if$
-  extra.label 'next.extra :=
-  extra.label
-  duplicate$ empty$
-    'skip$
-    { "{\natexlab{" swap$ * "}}" * }
-  if$
-  'extra.label :=
-  label extra.label * 'label :=
-}
-
-EXECUTE {initialize.longest.label}
-
-ITERATE {forward.pass}
-
-REVERSE {reverse.pass}
-
-FUNCTION {bib.sort.order}
-{ sort.label  'sort.key$ :=
-}
-
-ITERATE {bib.sort.order}
-
-SORT
-
-FUNCTION {begin.bib}
-{   preamble$ empty$
-    'skip$
-    { preamble$ write$ newline$ }
-  if$
-  "\begin{thebibliography}{" number.label int.to.str$ * "}" *
-  write$ newline$
-  "\expandafter\ifx\csname natexlab\endcsname\relax\def\natexlab#1{#1}\fi"
-  write$ newline$
-  "\expandafter\ifx\csname url\endcsname\relax" write$ newline$
-  "  \def\url#1{{\tt #1}}\fi" write$ newline$
-}
-
-EXECUTE {begin.bib}
-
-EXECUTE {init.state.consts}
-
-ITERATE {call.type$}
-
-FUNCTION {end.bib}
-{ newline$
-  "\end{thebibliography}" write$ newline$
-}
-
-EXECUTE {end.bib}
-%</bst>
-%    \end{macrocode}
+%    This has now been changed to the ordinary plainnat as natbib caught up
 %
 % \Finale
 %

ecsdocs.ins → source/latex/uosdocs/uosdocs.ins

@@ -6,13 +6,14 @@
 \preamble
 
 Copyright (C) 2001 by Steve R. Gunn
+Modifications Copyright (C) 2019 by Edward Longman
 
-This file is part of the ECSDocs class distribution
+This file is part of the UoSDocs class distribution
 
 \endpreamble
 \edef\eps{\perCent!PS-Adobe-3.0^^J%
           \DoubleperCent Title: \outFileName^^J%
-          \DoubleperCent Creator: ECSThesis.dtx
+          \DoubleperCent Creator: UoSThesis.dtx
 }
 \edef\tex{\DoubleperCent\space ----------------------------------------------------------------^^J%
           \DoubleperCent\space\outFileName^^J%
@@ -27,65 +28,65 @@ This file is part of the ECSDocs class distribution
           \DoubleperCent\space ----------------------------------------------------------------
 }
 
-\usedir{tex/latex/ecsdocs}
+\usedir{tex/latex/uosdocs}
 \keepsilent
 \askforoverwritefalse
 
 \Msg{*** Generating thesis, minithesis and project class files ***}
 
-\generate{\file{ecsthesis.cls}      {\from{ecsdocs.dtx}{thesis}}
-          \file{ecsminithesis.cls}  {\from{ecsdocs.dtx}{minithesis}}
-          \file{ecsprogress.cls}    {\from{ecsdocs.dtx}{progress}}
-          \file{ecsproject.cls}     {\from{ecsdocs.dtx}{project}}
-          \file{ecsreport.cls}      {\from{ecsdocs.dtx}{report}}
-          \file{ecsarticle.cls}     {\from{ecsdocs.dtx}{article}}
-          \file{ecsgdp.cls}         {\from{ecsdocs.dtx}{gdp}}
-          \file{ecsgdpsummary.cls}  {\from{ecsdocs.dtx}{gdpsummary}}
+\generate{\file{uosthesis.cls}      {\from{uosdocs.dtx}{thesis}}
+          \file{uosminithesis.cls}  {\from{uosdocs.dtx}{minithesis}}
+          \file{uosprogress.cls}    {\from{uosdocs.dtx}{progress}}
+          \file{uosproject.cls}     {\from{uosdocs.dtx}{project}}
+          \file{uosreport.cls}      {\from{uosdocs.dtx}{report}}
+          \file{uosarticle.cls}     {\from{uosdocs.dtx}{article}}
+          \file{uosgdp.cls}         {\from{uosdocs.dtx}{gdp}}
+          \file{uosgdpsummary.cls}  {\from{uosdocs.dtx}{gdpsummary}}
           \file{Thesis.tex}         {\usepreamble\tex
                                      \nopostamble
-                                     \from{ecsdocs.dtx}{testthesis}}
+                                     \from{uosdocs.dtx}{testthesis}}
           \file{MiniThesis.tex}     {\usepreamble\tex
                                      \nopostamble
-                                     \from{ecsdocs.dtx}{testminithesis}}
+                                     \from{uosdocs.dtx}{testminithesis}}
           \file{Progress.tex}       {\usepreamble\tex
                                      \nopostamble
-                                     \from{ecsdocs.dtx}{testprogress}}
+                                     \from{uosdocs.dtx}{testprogress}}
           \file{Project.tex}        {\usepreamble\tex
                                      \nopostamble
-                                     \from{ecsdocs.dtx}{testproject}}
+                                     \from{uosdocs.dtx}{testproject}}
           \file{Report.tex}         {\usepreamble\tex
                                      \nopostamble
-                                     \from{ecsdocs.dtx}{testreport}}
+                                     \from{uosdocs.dtx}{testreport}}
           \file{Article.tex}        {\usepreamble\tex
                                      \nopostamble
-                                     \from{ecsdocs.dtx}{testarticle}}
+                                     \from{uosdocs.dtx}{testarticle}}
           \file{GDP.tex}            {\usepreamble\tex
                                      \nopostamble
-                                     \from{ecsdocs.dtx}{testgdp}}
+                                     \from{uosdocs.dtx}{testgdp}}
           \file{GDPSummary.tex}     {\usepreamble\tex
                                      \nopostamble
-                                     \from{ecsdocs.dtx}{testgdpsummary}}
+                                     \from{uosdocs.dtx}{testgdpsummary}}
           \file{Introduction.tex}   {\usepreamble\tex
                                      \nopostamble
-                                     \from{ecsdocs.dtx}{introduction}}
+                                     \from{uosdocs.dtx}{introduction}}
           \file{Conclusions.tex}    {\usepreamble\tex
                                      \nopostamble
-                                     \from{ecsdocs.dtx}{conclusions}}
+                                     \from{uosdocs.dtx}{conclusions}}
           \file{AppendixA.tex}      {\usepreamble\tex
                                      \nopostamble
-                                     \from{ecsdocs.dtx}{appendix}}
+                                     \from{uosdocs.dtx}{appendix}}
           \file{figure.eps}         {\usepreamble\eps
                                      \nopostamble
-                                     \from{ecsdocs.dtx}{figure}}
+                                     \from{uosdocs.dtx}{figure}}
           \file{Definitions.tex}    {\usepreamble\tex
                                      \nopostamble
-                                     \from{ecsdocs.dtx}{definitions}}
-          \file{ECS.bib}            {\usepreamble\bib
+                                     \from{uosdocs.dtx}{definitions}}
+          \file{UOS.bib}            {\usepreamble\bib
                                      \nopostamble
-                                     \from{ecsdocs.dtx}{references}}
-          \file{ecs.bst}            {\usepreamble\bst
+                                     \from{uosdocs.dtx}{references}}
+          \file{uos.bst}            {\usepreamble\bst
                                      \nopostamble
-                                     \from{ecsdocs.dtx}{bst}}
+                                     \from{uosdocs.dtx}{bst}}
          }
 
 \endbatchfile

templates/latex/uosdocs/AppendixA.tex

+%% ----------------------------------------------------------------
+%% AppendixA.tex
+%% ---------------------------------------------------------------- 
+\chapter{Stuff} \label{Chapter:Stuff}
+The following gets in the way of the text....

templates/latex/uosdocs/Article.tex

+%% ----------------------------------------------------------------
+%% Article.tex
+%% ---------------------------------------------------------------- 
+\documentclass[sotoncolour]{uosarticle}     % Use the Article Style with custom link colour
+\graphicspath{{../Figures/}}   % Location of your graphics files
+\usepackage[round]{natbib}            % Use Natbib style for the refs.
+\hypersetup{colorlinks=true}   % Set to false for black/white printing
+\input{Definitions}            % Include your abbreviations
+%% ----------------------------------------------------------------
+%% --------------------THESIS/DOC INFORMATION ---------------------
+\faculty     {Faculty of [Insert faculty]}
+\FACULTY     {\MakeUppercase{\facname}}
+\department  {School of [Insert school]}
+\DEPARTMENT  {\MakeUppercase{\deptname}}
+\group       {[Group name]}
+\GROUP       {\MakeUppercase{\groupname}}
+\title      {An Investigation into \dots}
+\authors    {\texorpdfstring
+             {\href{mailto:S.A.Watson@soton.ac.uk}{Name and email, for example, Sarah Alison Watson}}
+             {Name and email, for example, Sarah Alison Watson}
+            }
+\addresses  {\groupname\\\deptname\\\univname}
+\date       {\today}
+%% Optional Fields TODO: Replace these fields with your own data
+\qualifications{[Insert Previous Qualifications, for example MEng]}
+\subject    {}
+\keywords   {}
+
+\begin{document}
+%% ------------------ FRONT MATTER ORGANISATION -------------------
+\frontmatter
+\maketitle
+\begin{abstract}
+This work is all about \dots
+\end{abstract}
+\mainmatter
+%% ------------------ MAIN MATTER (CONTENT) --------------------
+\section{Introduction} \label{Section:Introduction}
+You probably found all the files from \cite{Longman:2019:templ},
+they were originally made from \cite{Gunn:2001:pdflatex}.
+Template specific instructions can be found at:
+\url{https://git.soton.ac.uk/el7g15/uos-latex-template-instructions}.
+
+\tref{Table:tabex} illustrates the results of some arbitrary example work.
+\begin{table}[!htb]
+  \centering
+  \begin{tabular}{cc}
+  \toprule
+  \textbf{Training Error} & \textbf{Testing Error}\\
+  \midrule
+  0 & $\infty$\\
+  \bottomrule
+  \end{tabular}
+  \caption{The Results}
+  \label{Table:tabex}
+\end{table}
+
+\fref{Figure:figex} shows why this is the case.
+\begin{figure}[!htb]
+  \centering
+  \includegraphics[width=8cm]{figure}
+  \caption{A colourful picture.}
+  \label{Figure:figex}
+\end{figure}
+
+This page shows you a subfigure example in \fref{Figure:figsubex}.
+\begin{figure}[!htb]
+  \centering
+  \subcaptionbox{The left caption}{
+    \includegraphics[width=4.2cm]{figure}
+    \label{Figure:figsubex:left}
+  }
+  \subcaptionbox{The right caption}{
+    \includegraphics[width=4.2cm]{figure}
+    \label{Figure:figsubex:right}
+  }
+  \caption{A doubly colourful picture.}
+  \label{Figure:figsubex}
+\end{figure}
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec rutrum sodales ligula, ac aliquam sem interdum at. Ut commodo pulvinar ipsum. Aliquam et diam sed nibh tincidunt mollis vitae quis nunc. In vel ante vitae felis semper malesuada sed a metus. Aliquam semper metus vel metus imperdiet, quis mollis nisi volutpat. Integer in convallis erat, et auctor dui. Phasellus id tristique tortor. Mauris ac nisi ut mi pulvinar interdum. Donec quis nibh tempus erat lobortis dapibus non a nunc. Nulla laoreet tempus fringilla. Aliquam pulvinar, sapien eu interdum gravida, libero urna dapibus sem, sodales efficitur lorem nunc et justo. Proin vitae dolor nisl.
+
+\section{A Section of a chapter}
+Nulla molestie velit sed dui ullamcorper viverra. Fusce placerat vulputate lacus eu consequat. Cras ullamcorper vel mauris quis aliquam. Curabitur non varius elit, eget commodo urna. Phasellus erat libero, faucibus elementum augue eget, malesuada fringilla purus. Quisque pulvinar, lectus sit amet ultricies tristique, eros nunc commodo lacus, nec ultrices risus lorem vitae diam. Cras ac ornare nisi.
+
+\subsection{Some quotes}
+
+Nam egestas felis euismod erat tincidunt ornare. Nulla hendrerit tempor purus ac consequat. Aliquam commodo, ipsum vestibulum lobortis semper, urna turpis sagittis dolor, id ullamcorper nulla nisl vitae ex. Vivamus ut metus vel velit rhoncus pulvinar sit amet nec diam. Aliquam aliquet, enim eget efficitur euismod, velit arcu mattis nisl, a mollis dui leo vel libero. Nullam porttitor convallis magna ut feugiat. `Cras at ultrices metus.' Nullam vulputate quis justo sit amet pharetra. Praesent sodales eros non suscipit gravida.
+\begin{quote}
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec rutrum sodales ligula, ac aliquam sem interdum at.
+\end{quote}
+
+Pellentesque sodales lobortis feugiat. Vivamus volutpat mauris id odio aliquam maximus sed sit amet nibh. Fusce odio tortor, aliquam et mauris facilisis, interdum placerat tortor. Suspendisse dapibus, massa eget cursus congue, mi lectus luctus nisl, vitae sagittis ligula ante sit amet enim. Donec quis sapien vel ex vestibulum porta. Vivamus mattis sodales turpis, id interdum justo ullamcorper a. Aenean ornare urna turpis, id fermentum eros commodo aliquet. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Donec cursus pretium ex at mollis. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae; Sed at diam quam. Etiam a sollicitudin dui. Nulla facilisi. Phasellus condimentum tincidunt ipsum. Sed dignissim neque a porttitor finibus. Maecenas pretium dictum lorem vitae viverra.
+\begin{quote}
+The \verb|\attrib| macro attributes block elements, for example when citing
+a reference after a block quotation.
+\ifdefined\attrib\attrib{\cite{attribpackage}}\fi
+\end{quote}
+
+Donec vitae massa nisi. Praesent sed sollicitudin urna. Suspendisse vitae cursus tortor. In egestas quis dolor ac porttitor. Pellentesque suscipit leo nisi, a semper nunc interdum quis. Aenean massa magna, aliquam imperdiet lorem vitae, vestibulum dignissim nunc. Nunc molestie eleifend dui et porta. Sed auctor eu nunc vel faucibus. Integer et finibus metus, pharetra egestas velit. Sed nec magna semper, rutrum diam vitae, accumsan sapien. Donec congue viverra luctus.
+%% ----------------------------------------------------------------
+\section{Conclusions} \label{Section: Conclusions}
+It works.
+\acknowledgements{Thanks to no one.}
+\backmatter
+\appendix
+\bibliographystyle{plainnat}
+\bibliography{UOS}
+%% ----------------------------------------------------------------
+\section{Stuff} \label{Section:Stuff}
+The following gets in the way of the text....
+\end{document}
+%% ----------------------------------------------------------------

templates/latex/uosdocs/Conclusions.tex

+%% ----------------------------------------------------------------
+%% Conclusions.tex
+%% ---------------------------------------------------------------- 
+\chapter{Conclusions} \label{Chapter: Conclusions}
+It works.

templates/latex/uosdocs/Definitions.tex

+%% ----------------------------------------------------------------
+%% Definitions.tex
+%% ---------------------------------------------------------------- 
+\newcommand{\BibTeX}{{\rm B\kern-.05em{\sc i\kern-.025em b}\kern-.08em T\kern-.1667em\lower.7ex\hbox{E}\kern-.125emX}}
+
+%% People
+\newcounter{address}
+\setcounter{address}{1}
+\renewcommand{\theaddress}{\textsuperscript{\fnsymbol{address}}}
+\newcommand{\address}[1]{\refstepcounter{address}\theaddress#1\\}
+\newcommand{\Name}[3]{\texorpdfstring{\href{mailto:#3}{#2}#1}{#2}\xspace}
+\newcommand{\SteveRGunn}[1]{\Name{#1}{Steve R. Gunn}{S.R.Gunn@ecs.soton.ac.uk}}
+
+%% Dingbats
+\newcommand{\tick}{\ding{51}}
+\newcommand{\cross}{\ding{55}}
+
+%% Calculus
+\newcommand{\pd}[2]{\ensuremath{\frac{\partial #1}{\partial #2}}\xspace}
+\newcommand{\fd}[2]{\ensuremath{\frac{d #1}{d #2}}\xspace}
+\newcommand{\dint}{\ensuremath{\int\!\!\!\int}\xspace}
+\newcommand{\tint}{\ensuremath{\int\!\!\!\int\!\!\!\int}\xspace}
+
+%% Math Sets
+\newcommand{\Q}[1]{\ensuremath{\mathbb{#1}}\xspace}
+\newcommand{\R}{\Q{R}}
+
+%% Matrix, Vector
+\newcommand{\V}[1]{\ensuremath{\boldsymbol{#1}}\xspace}
+\newcommand{\M}[1]{\ensuremath{\boldsymbol{#1}}\xspace}
+\newcommand{\0}{\V{0}}
+\newcommand{\1}{\V{1}}
+\newcommand{\I}{\M{I}}
+
+%% Math Functions
+\newcommand{\F}[1]{\ensuremath{\mathrm{#1}}\xspace}
+\newcommand{\sgn}{\F{sgn}}
+\newcommand{\tr}{\F{trace}}
+\newcommand{\diag}{\F{diag}}
+
+%% Math Names
+\newcommand{\N}[1]{\ensuremath{\mathit{#1}}\xspace}
+
+%% Data
+\newcommand{\mc}[1]{\ensuremath{\mathcal{#1}}\xspace}
+\newcommand{\Hyp}{\mc{H}}
+\newcommand{\D}{\mc{D}}
+
+%% Kernel
+\newcommand{\K}{\M{K}}
+\newcommand{\eins}{\texorpdfstring{\ensuremath{\epsilon}}{\textepsilon}-insensitive\xspace}
+\newcommand{\e}{\ensuremath{\epsilon}\xspace}
+\newcommand{\Bxi}{\ensuremath{\boldsymbol{\xi}}\xspace}
+\newcommand{\Kanova}{\ensuremath{\mathit{K_{ANOVA}}}\xspace}
+\newcommand{\Kspline}{\ensuremath{\mathit{K_{spline}}}\xspace}
+
+%% Bayesian
+\newcommand{\MP}{\ensuremath{\mathit{{\scriptscriptstyle \hspace{-1.5pt}M\hspace{-1.5pt}P}}}\xspace}
+\newcommand{\ML}{\ensuremath{\mathit{{\scriptscriptstyle \hspace{-1.5pt}M\hspace{-1.5pt}L}}}\xspace}
+\newcommand{\Qw}{\ensuremath{Q_{\w}(\w)}\xspace}
+\newcommand{\Qa}{\ensuremath{Q_{\Ba}(\Ba)}\xspace}
+\newcommand{\Qb}{\ensuremath{Q_{\beta}(\beta)}\xspace}
+\newcommand{\wMPab}{\ensuremath{\w_{\MP|\bar {\Ba},\bar \beta}}\xspace}
+\newcommand{\wMP}{\ensuremath{\w_{\MP}}\xspace}
+\newcommand{\yMP}{\ensuremath{y_{\MP}}\xspace}
+\newcommand{\BaMP}{\ensuremath{\Ba_{\hspace{1pt}\MP}}\xspace}
+\newcommand{\aMP}{\ensuremath{\alpha_{\hspace{1pt}\MP}}\xspace}
+\newcommand{\bMP}{\ensuremath{\beta_{\hspace{1pt}\MP}}\xspace}
+\newcommand{\Sab}{\ensuremath{\M{\Sigma}_{\bar \Ba,\bar \beta}}\xspace}
+\newcommand{\Ba}{\ensuremath{\boldsymbol{\alpha}}\xspace}
+\newcommand{\Bb}{\ensuremath{\boldsymbol{\beta}}\xspace}
+\newcommand{\Bm}{\ensuremath{\boldsymbol{\mu}}\xspace}
+\newcommand{\BL}{\ensuremath{\boldsymbol{\Lambda}}\xspace}
+\newcommand{\BPhi}{\ensuremath{\boldsymbol{\Phi}}\xspace}
+\newcommand{\SMP}{\ensuremath{\M{\Sigma}_{\MP}}\xspace}
+
+\newcommand{\Pa}{\ensuremath{P(\alpha|\mathcal{H})}\xspace}
+\newcommand{\Pb}{\ensuremath{P(\beta|\mathcal{H})}\xspace}
+\newcommand{\Pab}{\ensuremath{P(\alpha,\beta|\mathcal{H})}\xspace}
+\newcommand{\Pw}{\ensuremath{P(\w|\mathcal{H})}\xspace}
+\newcommand{\PD}{\ensuremath{P(\D|\mathcal{H})}\xspace}
+\newcommand{\PwIa}{\ensuremath{P(\w|\alpha,\mathcal{H})}\xspace}
+\newcommand{\PDIwb}{\ensuremath{P(\D|\w,\beta,\mathcal{H})}\xspace}
+\newcommand{\PDwab}{\ensuremath{P(\D,\w,\alpha,\beta|\mathcal{H})}\xspace}
+\newcommand{\PDIw}{\ensuremath{P(\D|\w,\mathcal{H})}\xspace}
+\newcommand{\PwID}{\ensuremath{P(\w|\D,\mathcal{H})}\xspace}
+\newcommand{\PwabID}{\ensuremath{P(\w,\alpha,\beta|\D,\mathcal{H})}\xspace}
+
+\newcommand{\PanH}{\ensuremath{P(\alpha)}\xspace}
+\newcommand{\PbnH}{\ensuremath{P(\beta)}\xspace}
+\newcommand{\PabnH}{\ensuremath{P(\alpha,\beta)}\xspace}
+\newcommand{\PwnH}{\ensuremath{P(\w)}\xspace}
+\newcommand{\PDnH}{\ensuremath{P(\D)}\xspace}
+\newcommand{\PwIanH}{\ensuremath{P(\w|\alpha)}\xspace}
+\newcommand{\PDIwbnH}{\ensuremath{P(\D|\w,\beta)}\xspace}
+\newcommand{\PDwabnH}{\ensuremath{P(\D,\w,\Ba,\beta)}\xspace}
+\newcommand{\PDIwnH}{\ensuremath{P(\D|\w)}\xspace}
+\newcommand{\PwIDnH}{\ensuremath{P(\w|\D)}\xspace}
+\newcommand{\PwabIDnH}{\ensuremath{P(\w,\alpha,\beta|\D)}\xspace}
+
+\newcommand{\PDwBab}{\ensuremath{P(\D,\w,\Ba,\beta|\mathcal{H})}\xspace}
+\newcommand{\PwIBa}{\ensuremath{P(\w|\Ba,\mathcal{H})}\xspace}
+\newcommand{\PBab}{\ensuremath{P(\Ba,\beta|\mathcal{H})}\xspace}
+\newcommand{\PwBabID}{\ensuremath{P(\w,\Ba,\beta|\D,\mathcal{H})}\xspace}
+
+\newcommand{\PBanH}{\ensuremath{P(\Ba)}\xspace}
+\newcommand{\PwIBanH}{\ensuremath{P(\w|\Ba)}\xspace}
+
+%% Snakes
+\newcommand{\Esnake}{\ensuremath{\mathit{E_{snake}}}\xspace}
+\newcommand{\Eimage}{\ensuremath{\mathit{E_{image}}}\xspace}
+\newcommand{\Econt}{\ensuremath{\mathit{E_{cont}}}\xspace}
+\newcommand{\Ecurv}{\ensuremath{\mathit{E_{curv}}}\xspace}
+\newcommand{\Eint}{\ensuremath{\mathit{E_{int}}}\xspace}
+\newcommand{\Eext}{\ensuremath{\mathit{E_{ext}}}\xspace}
+\newcommand{\Eterm}{\ensuremath{\mathit{E_{term}}}\xspace}
+\newcommand{\Eline}{\ensuremath{\mathit{E_{line}}}\xspace}
+\newcommand{\Eedge}{\ensuremath{\mathit{E_{edge}}}\xspace}
+\newcommand{\Econ}{\ensuremath{\mathit{E_{con}}}\xspace}
+\newcommand{\Eangle}{\ensuremath{\mathit{E_{angle}}}\xspace}
+\newcommand{\Elshape}{\ensuremath{\mathit{E_{lshape}}}\xspace}
+\newcommand{\Eedgedir}{\ensuremath{\mathit{E_{edgedir}}}\xspace}
+\newcommand{\Emodel}{\ensuremath{\mathit{E_{model}}}\xspace}
+\newcommand{\wte}{\ensuremath{\mathit{w_{term}}}\xspace}
+\newcommand{\wli}{\ensuremath{\mathit{w_{line}}}\xspace}
+\newcommand{\wed}{\ensuremath{\mathit{w_{edge}}}\xspace}
+\newcommand{\wco}{\ensuremath{\mathit{w_{con}}}\xspace}
+
+%% Environments
+\newcounter{alg}
+\newenvironment{algorithm}[1]
+{
+    \stepcounter{alg}
+    \begin{table}[htb]
+    \centering
+    \begin{tabular}[t]{ll}
+    \hline&\\
+    \multicolumn{2}{l}{\bf Algorithm \arabic{alg}: #1}\\&\\
+} {
+    &\\
+    \hline
+    \end{tabular}
+    \end{table}
+}

templates/latex/uosdocs/GDP.tex

+%% ----------------------------------------------------------------
+%% GDP.tex
+%% ---------------------------------------------------------------- 
+\documentclass[sotoncolour]{uosgdp}         % Use the GDP Report Style with custom link colour
+\graphicspath{{../Figures/}}   % Location of your graphics files
+\usepackage[round]{natbib}            % Use Natbib style for the refs.
+\usepackage{bibentry}          % Use bibentry for prepublished works
+\nobibliography*               % Use bibentry for prepublished works
+\usepackage{attrib}            % Use the attrib package for quotations
+\hypersetup{colorlinks=true}   % Set to false for black/white printing
+\input{Definitions}            % Include your abbreviations
+%% ----------------------------------------------------------------
+%% --------------------THESIS/DOC INFORMATION ---------------------
+\faculty     {Faculty of [Insert faculty]}
+\FACULTY     {\MakeUppercase{\facname}}
+\department  {School of [Insert school]}
+\DEPARTMENT  {\MakeUppercase{\deptname}}
+\group       {[Group name]}
+\GROUP       {\MakeUppercase{\groupname}}
+\title      {An Investigation into \dots}
+\authors    {\texorpdfstring
+             {\href{mailto:S.A.Watson@soton.ac.uk}{Name and email, for example, Sarah Alison Watson}}
+             {Name and email, for example, Sarah Alison Watson}
+            }
+\addresses  {\groupname\\\deptname\\\univname}
+\date       {\today}
+\supervisor {Mr Beavis}
+\examiner   {Dr Butthead}
+\degree     {Master of Engineering}
+%% Optional Fields TODO: Replace these fields with your own data
+\qualifications{[Insert Previous Qualifications, for example MEng]}
+\subject    {}
+\keywords   {}
+
+\begin{document}
+%% ------------------ FRONT MATTER ORGANISATION -------------------
+\frontmatter
+\maketitle
+\begin{abstract}
+This work is all about \dots
+\end{abstract}
+\pdfbookmark[0]{\contentsname}{toc} % Add pdf bookmark for contents page for navigation
+\tableofcontents
+\listoffigures
+\listoftables
+%% The List of listings does not, by default, appear in the ToC, so....
+\addtotoc{Listings}
+\lstlistoflistings
+\listofaddmaterial
+\addtolom{Material Name e.g Map}
+\addtolom{Material Name e.g CD}
+\addtolom{Test Material}
+%% ---------- STATEMENT OF ORIGINALITY/ ACKNOW. / DEDICATORY ----------
+%% based on ai_statement.docx available: https://secure.ecs.soton.ac.uk/notes/elec6200/
+%% If not for an ECS GDP and you want to remove or change the ECS Manadatory ai statements.
+%%\authorshipdeclaration[\item Department specific regulation]{\item extra statements}
+\authorshipdeclaration{
+%% ********You must change the statements below if you do not agree with them. ***********
+\item I have acknowledged all sources, and identified any content taken from elsewhere.
+\item I have not used any resources produced by anyone else.
+\item I did all the work myself, or with my allocated group, and have not helped anyone else.
+\item The material in the report is genuine, and I have included all my data/code/designs.
+\item I have not submitted any part of this work for another assessment.
+\item My work did not involve human participants, their cells or data, or animals.}
+%% -----------------------
+
+\acknowledgements{Thanks to no one.}
+\dedicatory{To \dots}
+%%Lightweight Definitions and Abbreviations see package:nomencl for alternative
+%% Include if relevant to discipline
+\listofsymbols{ll}{$w$ & The weight vector\\$\S$ & If relevant to discipline}
+\mainmatter
+%% ------------------ MAIN MATTER (CONTENT) --------------------
+\include{Introduction}
+\include{Conclusions}
+\begin{lstlisting}[caption=Listing of what an example listing would be like]
+This is a test listing
+
+The test listing has several lines
+to show how the listings
+will be displayed
+\end{lstlisting}
+\appendix
+\include{AppendixA}
+\backmatter
+\bibliographystyle{plainnat}
+\bibliography{UOS}
+\end{document}
+%% ----------------------------------------------------------------

templates/latex/uosdocs/GDPSummary.tex

+%% ----------------------------------------------------------------
+%% GDPSummary.tex
+%% ---------------------------------------------------------------- 
+\documentclass[sotoncolour]{uosgdpsummary}  % Use the GDP Summary Report Style with custom link colour
+\graphicspath{{../Figures/}}   % Location of your graphics files
+\usepackage[round]{natbib}            % Use Natbib style for the refs.
+\hypersetup{colorlinks=true}   % Set to false for black/white printing
+\input{Definitions}            % Include your abbreviations
+%% ----------------------------------------------------------------
+%% --------------------THESIS/DOC INFORMATION ---------------------
+\faculty     {Faculty of [Insert faculty]}
+\FACULTY     {\MakeUppercase{\facname}}
+\department  {School of [Insert school]}
+\DEPARTMENT  {\MakeUppercase{\deptname}}
+\group       {[Group name]}
+\GROUP       {\MakeUppercase{\groupname}}
+\title      {An Investigation into \dots}
+\authors    {\texorpdfstring
+             {\href{mailto:S.A.Watson@soton.ac.uk}{Name and email, for example, Sarah Alison Watson}}
+             {Name and email, for example, Sarah Alison Watson}
+            }
+\addresses  {\groupname\\\deptname\\\univname}
+\date       {\today}
+\supervisor {Mr Beavis}
+\examiner   {Dr Butthead}
+\degree     {Master of Engineering}
+%% Optional Fields TODO: Replace these fields with your own data
+\qualifications{[Insert Previous Qualifications, for example MEng]}
+\subject    {}
+\keywords   {}
+
+\begin{document}
+%% ------------------ FRONT MATTER ORGANISATION -------------------
+\frontmatter
+\maketitle
+\mainmatter
+%% ------------------ MAIN MATTER (CONTENT) --------------------
+\section*{Introduction}
+\section*{Objectives}
+\section*{Resources}
+\section*{Constraints}
+\section*{Approaching the task}
+\section*{Team Organisation}
+\section*{Important Results}
+\section*{Conclusions}
+\section*{Recommendations}
+\end{document}
+%% ----------------------------------------------------------------

templates/latex/uosdocs/Introduction.tex

+%% ----------------------------------------------------------------
+%% Introduction.tex
+%% ---------------------------------------------------------------- 
+\chapter{Introduction} \label{Chapter:Introduction}
+You probably found all the files from \cite{Longman:2019:templ},
+they were originally made from \cite{Gunn:2001:pdflatex}.
+Template specific instructions can be found at:
+\url{https://git.soton.ac.uk/el7g15/uos-latex-template-instructions}.
+
+\tref{Table:tabex} illustrates the results of some arbitrary example work.
+\begin{table}[!htb]
+  \centering
+  \begin{tabular}{cc}
+  \toprule
+  \textbf{Training Error} & \textbf{Testing Error}\\
+  \midrule
+  0 & $\infty$\\
+  \bottomrule
+  \end{tabular}
+  \caption{The Results}
+  \label{Table:tabex}
+\end{table}
+
+\fref{Figure:figex} shows why this is the case.
+\begin{figure}[!htb]
+  \centering
+  \includegraphics[width=8cm]{figure}
+  \caption{A colourful picture.}
+  \label{Figure:figex}
+\end{figure}
+
+This page shows you a subfigure example in \fref{Figure:figsubex}.
+\begin{figure}[!htb]
+  \centering
+  \subcaptionbox{The left caption}{
+    \includegraphics[width=4.2cm]{figure}
+    \label{Figure:figsubex:left}
+  }
+  \subcaptionbox{The right caption}{
+    \includegraphics[width=4.2cm]{figure}
+    \label{Figure:figsubex:right}
+  }
+  \caption{A doubly colourful picture.}
+  \label{Figure:figsubex}
+\end{figure}
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec rutrum sodales ligula, ac aliquam sem interdum at. Ut commodo pulvinar ipsum. Aliquam et diam sed nibh tincidunt mollis vitae quis nunc. In vel ante vitae felis semper malesuada sed a metus. Aliquam semper metus vel metus imperdiet, quis mollis nisi volutpat. Integer in convallis erat, et auctor dui. Phasellus id tristique tortor. Mauris ac nisi ut mi pulvinar interdum. Donec quis nibh tempus erat lobortis dapibus non a nunc. Nulla laoreet tempus fringilla. Aliquam pulvinar, sapien eu interdum gravida, libero urna dapibus sem, sodales efficitur lorem nunc et justo. Proin vitae dolor nisl.
+
+\section{A Section of a chapter}
+Nulla molestie velit sed dui ullamcorper viverra. Fusce placerat vulputate lacus eu consequat. Cras ullamcorper vel mauris quis aliquam. Curabitur non varius elit, eget commodo urna. Phasellus erat libero, faucibus elementum augue eget, malesuada fringilla purus. Quisque pulvinar, lectus sit amet ultricies tristique, eros nunc commodo lacus, nec ultrices risus lorem vitae diam. Cras ac ornare nisi.
+
+\subsection{Some quotes}
+
+Nam egestas felis euismod erat tincidunt ornare. Nulla hendrerit tempor purus ac consequat. Aliquam commodo, ipsum vestibulum lobortis semper, urna turpis sagittis dolor, id ullamcorper nulla nisl vitae ex. Vivamus ut metus vel velit rhoncus pulvinar sit amet nec diam. Aliquam aliquet, enim eget efficitur euismod, velit arcu mattis nisl, a mollis dui leo vel libero. Nullam porttitor convallis magna ut feugiat. `Cras at ultrices metus.' Nullam vulputate quis justo sit amet pharetra. Praesent sodales eros non suscipit gravida.
+\begin{quote}
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec rutrum sodales ligula, ac aliquam sem interdum at.
+\end{quote}
+
+Pellentesque sodales lobortis feugiat. Vivamus volutpat mauris id odio aliquam maximus sed sit amet nibh. Fusce odio tortor, aliquam et mauris facilisis, interdum placerat tortor. Suspendisse dapibus, massa eget cursus congue, mi lectus luctus nisl, vitae sagittis ligula ante sit amet enim. Donec quis sapien vel ex vestibulum porta. Vivamus mattis sodales turpis, id interdum justo ullamcorper a. Aenean ornare urna turpis, id fermentum eros commodo aliquet. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Donec cursus pretium ex at mollis. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae; Sed at diam quam. Etiam a sollicitudin dui. Nulla facilisi. Phasellus condimentum tincidunt ipsum. Sed dignissim neque a porttitor finibus. Maecenas pretium dictum lorem vitae viverra.
+\begin{quote}
+The \verb|\attrib| macro attributes block elements, for example when citing
+a reference after a block quotation.
+\ifdefined\attrib\attrib{\cite{attribpackage}}\fi
+\end{quote}
+
+Donec vitae massa nisi. Praesent sed sollicitudin urna. Suspendisse vitae cursus tortor. In egestas quis dolor ac porttitor. Pellentesque suscipit leo nisi, a semper nunc interdum quis. Aenean massa magna, aliquam imperdiet lorem vitae, vestibulum dignissim nunc. Nunc molestie eleifend dui et porta. Sed auctor eu nunc vel faucibus. Integer et finibus metus, pharetra egestas velit. Sed nec magna semper, rutrum diam vitae, accumsan sapien. Donec congue viverra luctus.

templates/latex/uosdocs/MiniThesis.tex

+%% ----------------------------------------------------------------
+%% MiniThesis.tex
+%% ---------------------------------------------------------------- 
+\documentclass[sotoncolour]{uosminithesis}  % Use the minithesis Style with custom link colour
+\graphicspath{{../Figures/}}   % Location of your graphics files
+\usepackage[round]{natbib}            % Use Natbib style for the refs.
+\usepackage{bibentry}          % Use bibentry for prepublished works
+\nobibliography*               % Use bibentry for prepublished works
+\usepackage{attrib}            % Use the attrib package for quotations
+\hypersetup{colorlinks=true}   % Set to false for black/white printing
+\input{Definitions}            % Include your abbreviations
+%% ----------------------------------------------------------------
+%% --------------------THESIS/DOC INFORMATION ---------------------
+\faculty     {Faculty of [Insert faculty]}
+\FACULTY     {\MakeUppercase{\facname}}
+\department  {School of [Insert school]}
+\DEPARTMENT  {\MakeUppercase{\deptname}}
+\group       {[Group name]}
+\GROUP       {\MakeUppercase{\groupname}}
+\title      {An Investigation into \dots}
+\authors    {\texorpdfstring
+             {\href{mailto:S.A.Watson@soton.ac.uk}{Name and email, for example, Sarah Alison Watson}}
+             {Name and email, for example, Sarah Alison Watson}
+            }
+\addresses  {\groupname\\\deptname\\\univname}
+\date       {\today}
+\supervisor {Mr Beavis}
+\examiner   {Dr Butthead}
+%% Optional Fields TODO: Replace these fields with your own data
+
+\qualifications{[Insert Previous Qualifications, for example MEng]}
+\subject    {}
+\keywords   {}
+
+\begin{document}
+%% ------------------ FRONT MATTER ORGANISATION -------------------
+\frontmatter
+\maketitle
+\begin{abstract}
+This work is all about \dots
+There are broad instructions for this template entitled: How to use the University of Southampton LaTeX template. There is a technical reference included in the \texttt{doc} folder with the templates.
+
+There is no prescribed font, you should use a font appropriate to your discipline.  See Producing your thesis section 7.2.
+\end{abstract}
+\pdfbookmark[0]{\contentsname}{toc} % Add pdf bookmark for contents page for navigation
+\tableofcontents
+\listoffigures
+\listoftables
+%% The List of listings does not, by default, appear in the ToC, so....
+\addtotoc{Listings}
+\lstlistoflistings
+\listofaddmaterial
+\addtolom{Material Name e.g Map}
+\addtolom{Material Name e.g CD}
+\addtolom{Test Material}
+%% ---------- AUTHORSHIP DECLARATION/ ACKNOW. / DEDICATORY ----------
+%% Either include citations like below (as many as required spaced with commas or 'and').
+%% \bibentry command must be used here with prepublished papers
+\authorshipdeclaration{\bibentry{Gunn:2001:pdflatex}\newline\bibentry{Lovell:2011:updated}\newline\bibentry{Gunn:2011:updated2}}
+%% Or state no citations like below
+%% \authorshipdeclaration{}
+%% -----------------------
+\acknowledgements{Thanks to no one.}
+\dedicatory{To \dots}
+%%Lightweight Definitions and Abbreviations see package:nomencl for alternative
+%% Include if relevant to discipline
+\listofsymbols{ll}{$w$ & The weight vector\\$\S$ & If relevant to discipline}
+\mainmatter
+%% ------------------ MAIN MATTER (CONTENT) --------------------
+\include{Introduction}
+\include{Conclusions}
+\begin{lstlisting}[caption=Listing of what an example listing would be like]
+This is a test listing
+
+The test listing has several lines
+to show how the listings
+will be displayed
+\end{lstlisting}
+\appendix
+\include{AppendixA}
+\backmatter
+\chapter{Glossary [if relevant]}
+\bibliographystyle{plainnat}
+\bibliography{UOS}
+\chapter{Bibliography}
+To use bibliography as well as the references section use the \texttt{multibbl} package.
+\chapter{Index [if relevant]}
+\end{document}
+%% ----------------------------------------------------------------

templates/latex/uosdocs/Progress.tex

+%% ----------------------------------------------------------------
+%% Progress.tex
+%% ---------------------------------------------------------------- 
+\documentclass[sotoncolour]{uosprogress}    % Use the progress Style with custom link colour
+\graphicspath{{../Figures/}}   % Location of your graphics files
+\usepackage[round]{natbib}            % Use Natbib style for the refs.
+\hypersetup{colorlinks=true}   % Set to false for black/white printing
+\input{Definitions}            % Include your abbreviations
+%% ----------------------------------------------------------------
+%% --------------------THESIS/DOC INFORMATION ---------------------
+\faculty     {Faculty of [Insert faculty]}
+\FACULTY     {\MakeUppercase{\facname}}
+\department  {School of [Insert school]}
+\DEPARTMENT  {\MakeUppercase{\deptname}}
+\group       {[Group name]}
+\GROUP       {\MakeUppercase{\groupname}}
+\title      {An Investigation into \dots}
+\authors    {\texorpdfstring
+             {\href{mailto:S.A.Watson@soton.ac.uk}{Name and email, for example, Sarah Alison Watson}}
+             {Name and email, for example, Sarah Alison Watson}
+            }
+\addresses  {\groupname\\\deptname\\\univname}
+\date       {\today}
+\supervisor {Mr Beavis}
+\examiner   {Dr Butthead}
+%% Optional Fields TODO: Replace these fields with your own data
+
+\qualifications{[Insert Previous Qualifications, for example MEng]}
+\subject    {}
+\keywords   {}
+
+\begin{document}
+%% ------------------ FRONT MATTER ORGANISATION -------------------
+\frontmatter
+\maketitle
+\begin{abstract}
+This work is all about \dots
+There are broad instructions for this template entitled: How to use the University of Southampton LaTeX template. There is a technical reference included in the \texttt{doc} folder with the templates.
+
+There is no prescribed font, you should use a font appropriate to your discipline.  See Producing your thesis section 7.2.
+\end{abstract}
+\pdfbookmark[0]{\contentsname}{toc} % Add pdf bookmark for contents page for navigation
+\tableofcontents
+\listoffigures
+\listoftables
+%% The List of listings does not, by default, appear in the ToC, so....
+\addtotoc{Listings}
+\lstlistoflistings
+\listofaddmaterial
+\addtolom{Material Name e.g Map}
+\addtolom{Material Name e.g CD}
+\addtolom{Test Material}
+%%Lightweight Definitions and Abbreviations see package:nomencl for alternative
+%% Include if relevant to discipline
+\listofsymbols{ll}{$w$ & The weight vector\\$\S$ & If relevant to discipline}
+\mainmatter
+%% ------------------ MAIN MATTER (CONTENT) --------------------
+\include{Introduction}
+\include{Conclusions}
+\begin{lstlisting}[caption=Listing of what an example listing would be like]
+This is a test listing
+
+The test listing has several lines
+to show how the listings
+will be displayed
+\end{lstlisting}
+\appendix
+\include{AppendixA}
+\backmatter
+\chapter{Glossary [if relevant]}
+\bibliographystyle{plainnat}
+\bibliography{UOS}
+\chapter{Bibliography}
+To use bibliography as well as the references section use the \texttt{multibbl} package.
+\chapter{Index [if relevant]}
+\end{document}
+%% ----------------------------------------------------------------

templates/latex/uosdocs/Project.tex

+%% ----------------------------------------------------------------
+%% Project.tex
+%% ---------------------------------------------------------------- 
+\documentclass[sotoncolour]{uosproject}     % Use the Project Style with custom link colour
+\graphicspath{{../Figures/}}   % Location of your graphics files
+\usepackage[round]{natbib}            % Use Natbib style for the refs.
+\usepackage{bibentry}          % Use bibentry for prepublished works
+\nobibliography*               % Use bibentry for prepublished works
+\usepackage{attrib}            % Use the attrib package for quotations
+\hypersetup{colorlinks=true}   % Set to false for black/white printing
+\input{Definitions}            % Include your abbreviations
+%% ----------------------------------------------------------------
+%% --------------------THESIS/DOC INFORMATION ---------------------
+\faculty     {Faculty of [Insert faculty]}
+\FACULTY     {\MakeUppercase{\facname}}
+\department  {School of [Insert school]}
+\DEPARTMENT  {\MakeUppercase{\deptname}}
+\group       {[Group name]}
+\GROUP       {\MakeUppercase{\groupname}}
+\title      {An Investigation into \dots}
+\authors    {\texorpdfstring
+             {\href{mailto:S.A.Watson@soton.ac.uk}{Name and email, for example, Sarah Alison Watson}}
+             {Name and email, for example, Sarah Alison Watson}
+            }
+\addresses  {\groupname\\\deptname\\\univname}
+\date       {\today}
+\supervisor {Mr Beavis}
+\examiner   {Dr Butthead}
+\degree     {BEng Electronic Engineering}
+%% Optional Fields TODO: Replace these fields with your own data
+\qualifications{[Insert Previous Qualifications, for example MEng]}
+\subject    {}
+\keywords   {}
+
+\begin{document}
+%% ------------------ FRONT MATTER ORGANISATION -------------------
+\frontmatter
+\maketitle
+\begin{abstract}
+This work is all about \dots
+\end{abstract}
+\pdfbookmark[0]{\contentsname}{toc} % Add pdf bookmark for contents page for navigation
+\tableofcontents
+\listoffigures
+\listoftables
+%% The List of listings does not, by default, appear in the ToC, so....
+\addtotoc{Listings}
+\lstlistoflistings
+\listofaddmaterial
+\addtolom{Material Name e.g Map}
+\addtolom{Material Name e.g CD}
+\addtolom{Test Material}
+%% ---------- AUTHORSHIP DECLARATION/ ACKNOW. / DEDICATORY ----------
+%% Either include citations like below (as many as required spaced with commas or 'and').
+%% \bibentry command must be used here with prepublished papers
+\authorshipdeclaration{\bibentry{Gunn:2001:pdflatex}\newline\bibentry{Lovell:2011:updated}\newline\bibentry{Gunn:2011:updated2}}
+%% Or state no citations like below
+%% \authorshipdeclaration{}
+%% -----------------------
+\acknowledgements{Thanks to no one.}
+\dedicatory{To \dots}
+%%Lightweight Definitions and Abbreviations see package:nomencl for alternative
+%% Include if relevant to discipline
+\listofsymbols{ll}{$w$ & The weight vector\\$\S$ & If relevant to discipline}
+\mainmatter
+%% ------------------ MAIN MATTER (CONTENT) --------------------
+\include{Introduction}
+\include{Conclusions}
+\begin{lstlisting}[caption=Listing of what an example listing would be like]
+This is a test listing
+
+The test listing has several lines
+to show how the listings
+will be displayed
+\end{lstlisting}
+\appendix
+\include{AppendixA}
+\backmatter
+\bibliographystyle{plainnat}
+\bibliography{UOS}
+\end{document}
+%% ----------------------------------------------------------------

templates/latex/uosdocs/Report.tex

+%% ----------------------------------------------------------------
+%% Report.tex
+%% ---------------------------------------------------------------- 
+\documentclass[sotoncolour]{uosreport}      % Use the Report Style with custom link colour
+\graphicspath{{../Figures/}}   % Location of your graphics files
+\usepackage[round]{natbib}            % Use Natbib style for the refs.
+\usepackage{bibentry}          % Use bibentry for prepublished works
+\nobibliography*               % Use bibentry for prepublished works
+\usepackage{attrib}            % Use the attrib package for quotations
+\hypersetup{colorlinks=true}   % Set to false for black/white printing
+\input{Definitions}            % Include your abbreviations
+%% ----------------------------------------------------------------
+%% --------------------THESIS/DOC INFORMATION ---------------------
+\faculty     {Faculty of [Insert faculty]}
+\FACULTY     {\MakeUppercase{\facname}}
+\department  {School of [Insert school]}
+\DEPARTMENT  {\MakeUppercase{\deptname}}
+\group       {[Group name]}
+\GROUP       {\MakeUppercase{\groupname}}
+\title      {An Investigation into \dots}
+\authors    {\texorpdfstring
+             {\href{mailto:S.A.Watson@soton.ac.uk}{Name and email, for example, Sarah Alison Watson}}
+             {Name and email, for example, Sarah Alison Watson}
+            }
+\addresses  {\groupname\\\deptname\\\univname}
+\date       {\today}
+%% Optional Fields TODO: Replace these fields with your own data
+\qualifications{[Insert Previous Qualifications, for example MEng]}
+\subject    {}
+\keywords   {}
+
+\begin{document}
+%% ------------------ FRONT MATTER ORGANISATION -------------------
+\frontmatter
+\maketitle
+\begin{abstract}
+This work is all about \dots
+\end{abstract}
+\pdfbookmark[0]{\contentsname}{toc} % Add pdf bookmark for contents page for navigation
+\tableofcontents
+\listoffigures
+\listoftables
+%% The List of listings does not, by default, appear in the ToC, so....
+\addtotoc{Listings}
+\lstlistoflistings
+\listofaddmaterial
+\addtolom{Material Name e.g Map}
+\addtolom{Material Name e.g CD}
+\addtolom{Test Material}
+%% ---------- AUTHORSHIP DECLARATION/ ACKNOW. / DEDICATORY ----------
+%% Either include citations like below (as many as required spaced with commas or 'and').
+%% \bibentry command must be used here with prepublished papers
+\authorshipdeclaration{\bibentry{Gunn:2001:pdflatex}\newline\bibentry{Lovell:2011:updated}\newline\bibentry{Gunn:2011:updated2}}
+%% Or state no citations like below
+%% \authorshipdeclaration{}
+%% -----------------------
+\acknowledgements{Thanks to no one.}
+\dedicatory{To \dots}
+%%Lightweight Definitions and Abbreviations see package:nomencl for alternative
+%% Include if relevant to discipline
+\listofsymbols{ll}{$w$ & The weight vector\\$\S$ & If relevant to discipline}
+\mainmatter
+%% ------------------ MAIN MATTER (CONTENT) --------------------
+\include{Introduction}
+\include{Conclusions}
+\begin{lstlisting}[caption=Listing of what an example listing would be like]
+This is a test listing
+
+The test listing has several lines
+to show how the listings
+will be displayed
+\end{lstlisting}
+\appendix
+\include{AppendixA}
+\backmatter
+\bibliographystyle{plainnat}
+\bibliography{UOS}
+\end{document}
+%% ----------------------------------------------------------------