summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/bangorcsthesis/README
blob: 75e62dc72836985475752197dfbf1540747d0949 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
Bangor University Computer Science Department Thesis Document Class

Cameron Gray <c.gray@bangor.ac.uk> 
December 1, 2014

Abstract

Starting with the 2014/15 academic year, the Computer Science department at
Bangor University have standardised the appearance, layout and formatting of
all thesis/dissertation documents for all levels (undergraduate and
postgraduate). This package (containing a LATEX document class) is the
embodiment of that standard. It includes all of the elements of a thesis, and
supports a limited number of customisation options that individual students
may choose (or their supervisors may insist upon). It also makes the process
of creating a thesis very much simpler with the inclusion of several macros
(LATEX commands) that streamline the process.

1 Usage - Class Options

The document class is activated (or loaded) using the usual LATEX command
\documentclass{bangorcsthesis}. The class requires at least one of the
following options to be specified, these dictate what type of thesis the
document forms;

[⟨phd⟩] - Doctor of Philosophy / Doctorate 
[⟨pgcert⟩] - Postgraduate Certificate
[⟨mphil⟩] - Master of Philosophy
[⟨mscres⟩] - Master of Science by Research 
[⟨mres⟩] - Master of Research
[⟨msc⟩] - Master of Science (Taught courses)
[⟨ba⟩] - Bachelor of Arts (Undergraduate courses) 
[⟨bsc⟩] - Bachelor of Science (Undergraduate courses)

For example; an undergraduate dissertation for a Computer Science degree (a
B.Sc. course) would start with a document class definition as follows:-
\documentclass[bsc]{bangorcsthesis}. There are also the following entirely
optional modifiers that student’s can elect to use;

[⟨noindent⟩] - Suppress indentation of first lines of paragraphs.

[⟨nohyphen⟩] - Attempt (as far as possible) to prevent LATEX hyphenating words
at the ends of lines in the output.

[⟨draft⟩] - Mark the document as draft, this includes adding a watermark to
all pages. This is highly recommended until the document is final.

[⟨serif⟩] - Convert the thesis to use serif fonts for the main body text.

[⟨twoside⟩] - Make the output ‘two-sided’, much like a book. This may only be
required for the final copy to be deposited in certain libraries.

2 Usage - Preamble Macros

The class includes several macros that must be used in the preamble, the
portion of the document before \begin{document}. These set several important
parameters such as the degree scheme, supervisors and author details.

\title{⟨title⟩}

The title of the thesis/dissertation. This macro is not provided by this class
but is required in the preamble.

\author{⟨author⟩}

The author of the document. Not provided by this class, but required in the
preamble. It is recommended that the author name is specified as First M.I.
Last.

\date{⟨date⟩}

The date of the document. It is recommended that the date argument is set to
the month and year of submission of the thesis in full, e.g. May, 2014. This
macro is not provided by this class but is required in the preamble.

\degreeScheme{⟨scheme name⟩}

This macro must be used to set the title of the student’s overall degree
scheme. It has a single parameter, the name will be reproduced (verbatim) on
the title/cover page of the thesis. Use of this macro is required.

\supervisor{⟨name⟩}

The \supervisor macro adds a named supervisor to the student’s thesis. (In
theory) an unlimited number of these commands can be used, although LATEX has
internal memory limits. When there is more than one supervisor defined, the
title/cover page changes to accommodate them appropriately. At least one
supervisor must be included.

\bibliographySetup

This macro configures BibLaTeX, the successor to BibTeX, to departmental
standards. The Computer Science department have standardised on IEEE
referencing, using Name, Year, Title ordering. This means that the first
citation to appear may not be numbered [1] in the thesis. Use of this macro is
required.

\addbibresource {⟨name.bib⟩}

The \addbibresource macro is not provided by this package, but is required in
the preamble. The parameter is the name of the BibLaTeX/BibTeX database that
should be processed for the document.

3 Usage - Other Items

\acknowledgements [⟨quote text⟩] [⟨person quoted⟩] {⟨acknowledgements⟩}

The \acknowledgements macro creates the standard acknowledgments page for the
front of the thesis. Use of this macro is optional although highly recommended
as there is usually someone to thank for contributing to your work (including
your supervisor). You can optionally include an inspirational and/or funny
quote for the top of the page. If you do not wish to include the quote, simply
omit the optional arguments.

\statements

This macro creates the required statements page for the front matter of a
thesis. This must be included, failure to do so can result in the thesis being
rejected as it cannot be accepted into the University library or other
depositories.

\tables

The \tables macro creates the appropriate tables (of contents, of figures and
of tables) for the front matter of the thesis. Tables of figures and tables of
tables are only included when figures and tables are included in the document
text respectively. If the thesis includes other items (for example code
listings), you are responsible for including tables of these items yourself
after the use of this macro.

\thesisContent

This macro marks the start of the actual ‘content’ of the thesis, separate
from the ‘front matter’ (contents, etc.) and the appendices. Use of this macro
is required to maintain correct formatting.

4 Document Section Order The Computer Science Thesis has a very specific
section order; this does not prescribe the format of your thesis, just the
front and back matter.

1. Title/Cover Page
2. Acknowledgments Page
3. Statements Page
4. Contents
5. Tables
6. Thesis Content
7. References
8. Other Appendices

5 Skeleton Thesis

A very much skeleton document is provided here as a starting point when using
this document class.

\documentclass[bsc,noindent,nohyphen]{bangorcsthesis}
\title{Thesis Title}
\author{Just A. Student}
\degreeScheme{Computer Science}
\date{May, 2015}
\supervisor{Dr. S.P.R. Visor}
\bibliographySetup
\addbibresource{file.bib}
\begin{document}
\maketitle
\acknowledgements[Quote][Person Quoted]{Acknowledgements}
\statements
\begin{abstract}
    ... thesis abstract...
\end{abstract}
\tables
\thesisContent
    ... document ...
\references
    ... other appendices ...
\end{document}