Giter Site home page Giter Site logo

ucl-latex-thesis-templates's Introduction

UCL LaTeX Thesis Templates

Build Status

This is a skeletal thesis template with a class and .sty file that you can use separately if you'd prefer.

To change the thesis type from PhD to MRes or MPhil, look for the setting in Main.tex.

The class needs some updating and could use a lot of commenting, and these are being worked on, but the files are perfectly usable right now with pdfLaTeX or lualatex. The repo is tested after each push with lualatex on Travis.

If you have suggestions for improvements, please do submit an issue, drop me a line ([email protected]), or throw me a pull request.

@ikirker

Licensing

This work was previously available to be distributed and/or modified under the conditions of the LaTeX Project Public License (>=1.3), however, I realised that that doesn't make a lot of sense for a template.

Therefore, all files except ucl_thesis.cls are released into the public domain under CC-0-1.0, as described in the COPYING file.

The classfile ucl_thesis.cls may be distributed and/or modified under the conditions of the LaTeX Project Public License, either version 1.3 of this license or (at your option) any later version. The latest version of this license is in http://www.latex-project.org/lppl.txt and version 1.3 or later is part of all distributions of LaTeX version 2005/12/01 or later.

This work has the LPPL maintenance status `maintained'.

The Current Maintainer of this work is I. Kirker.

This work consists of all files listed in MANIFEST.md.

Known Issues

Citation Links

If you see this error while compiling:

pdfTeX warning (dest): name{cite.whatever} has been referenced but does not exist, replaced by a fixed one

and then get links that don't work in the PDF, try un-commenting the line below in MainPackages.tex even if you don't use that style of citation.

\usepackage{natbib}

FAQ

What should I use for editing .tex files?

If you're already comfortable with programming on the command-line, you can use whatever plain text editor you'd like.

If you're new to LaTeX, though, or want something to help you keep your files together, you may want TeXMaker or LyX (both available for Windows, Linux, or OS X), or TeXShop (for OS X).

TeXShop and TeXMaker are both oriented around helping you write plaintext .tex files, while LyX is more aimed at presenting a structured document with some of the formatting rendered, to make it a little less abstract to work with.

If you want something quick that runs entirely through a browser, so you don't even have to set up your own LaTeX installation, UCL also has a subscription for Overleaf, a service that does that. You'll have to register using your UCL email address to use the subscription. It's also good for working with someone else on a document, with live shared editing.

What is the Makefile for?

If you're using this from the Linux command-line, the Makefile defines a few things to make it easier to build the LaTeX document. If not, you can happily ignore it.

What graphics formats are good to include with this?

PNG and JPEG images work perfectly well, as do PDF files (including vector graphics). Vector graphics in PDFs will remain as vectors. Remember to produce higher-resolution images than you'd use online -- 300 or 600 dpi are typical print qualities, rather than the 72 dpi standard for websites. If you don't have control over this setting directly from whatever you're using to produce your images, a good rule of thumb is that you should aim to generate them 3 and a bit times larger on screen than you want them to be on paper.

Can I just make it produce one section in the PDF?

In the Main.tex file there are a list of \include statements. If you add an \includeonly statement to match those with one or more of the same labels, it'll just produce the content for those sections. (Labels, references, figures, and table numbers will be consistent as if you'd generated the whole document.)

Didn't there used to be different files for PhD, MRes, and MPhil dissertations?

Yes, but they only differed by 4 characters each, so it seemed silly to maintain them each separately. Change the setting in the Main.tex file to get the one you need.

ucl-latex-thesis-templates's People

Contributors

alghamdi avatar da5nsy avatar fmaguire avatar harryscholes avatar ikirker avatar tomtomrixrix avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

ucl-latex-thesis-templates's Issues

Update fonts from times to mathptx

Apparently the times package is deprecated (see #12), so it would be a good idea to work out what should be used now instead. (I think it's mathptx.)

Helvetica/Arial

Hi! (The template is awesome, thank you so much.)

The guidelines recommend using Arial or Helvetica.
Afraid I'm relatively new to LaTeX and so I'm not sure how to properly implement this.

I tried adding \usepackage{helvet} to MainPackages.tex to no avail.

Long headers compressed into one line only, exceeds margins

Hi, when chapter titles exceed a certain character limit, the headers go a bit wild and continue into the margin. Can we change the height of the header? Or preferably remove the chapter/section title from the header, leaving only the page number?

Reset mathcal fonts to default

mathptmx introduces a really terrible font for mathcal. Consider adding \DeclareMathAlphabet{\mathcal}{OMS}{cmsy}{m}{n} to reset it to the standard alphabet.

openright doesn't do anything

\documentclass[12pt,phd,a4paper,twoside,twopage,openright]{ucl_thesis}

doesn't produce the proper openright effect.

hyperref links broken

When compiling I was getting errors such as:

pdfTeX warning (dest): name{cite.whatever} has been referenced but does not exist, replaced by a fixed one

meaning that the links in the PDF just went to the first page.

To fix this, I found that adding:
\usepackage{natbib}

before the line \usepackage{bibitem} did the trick.

I haven't found that this causes any other issues, so you might want to make this change on the repo.

Enabling APA citations

First of all, thanks for this template. It's great and saved me a lot of time.
I need to use APA citation style but the template that I found is using \documentclass[a4paper,man,natbib]{apa6} which overwrites the settings from \documentclass[12pt,phd,draft,a4paper,oneside]{ucl_thesis}.

What would be a correct way to use APA6 style citation in the ucl_thesis template?

\hbar not working

Hi, \hbar doesn't seem to work with amssymb at the same time.
MWE:

\documentclass[12pt,phd,a4paper,oneside]{ucl_thesis}

\usepackage{amssymb}
\begin{document}
    \begin{equation}
        \hbar
    \end{equation}
      $ \hbar $
\end{document}

This fails with the Undefined control sequence error.

Tex version:

latex --version
pdfTeX 3.141592653-2.6-1.40.24 (TeX Live 2022)
kpathsea version 6.3.4
Copyright 2022 Han The Thanh (pdfTeX) et al.
There is NO warranty.  Redistribution of this software is
covered by the terms of both the pdfTeX copyright and
the Lesser GNU General Public License.
For more information about these matters, see the file
named COPYING and the pdfTeX source.
Primary author of pdfTeX: Han The Thanh (pdfTeX) et al.
Compiled with libpng 1.6.37; using libpng 1.6.37
Compiled with zlib 1.2.11; using zlib 1.2.11
Compiled with xpdf version 4.03

Spaces in references for web citations

Has anyone else had issues with spaces in references for web page citations?

Attached is an example of what is happening for me.

Screenshot 2022-05-08 at 12 25 23 pm

There are work arounds for this online such as here: https://tex.stackexchange.com/questions/200333/bibliography-in-latex-spaces-between-words however when I try to implement these packages which I believe are already included I get errors whilst compiling.

Does any one else know of a work around for these spaces in references? Perhaps instead of doing them as web links something else?

Regards,

Peter

Citation \item Error

From RC00005675:

There is an issue about the bibliography in the UCL PhD thesis latex template. When I tried to cite a reference in the thesis, it threw out an exception during the compiling : "LaTeX Error: Lonely \item--perhaps a missing list environment."

"ucl_a4.sty" conflicts with "geometry" package

Including the ucl_a4.sty style makes it impossible to use the geometry package: simply loading it (without any options) makes this apparent. Removing ucl_a4 from the class fixes this with no other noticeable problems.

In fact, I'm not even sure why this style is necessary at all, since all well-behaved packages understand what a4paper is.

Share the UCL Thesis template in sharelatex.com

Hi,
First to note I did not found any other means of contacting so my bad for putting this as an issue.

I'm a PhD student at UCL and really appreciate this template. I use a lot sharelatex and wanted to encourage you, or with your consent to share this as an UCL template for thesis there.

All the best!

Onesided setting produces uneven margins

Hi,
Thanks for providing this great template.
I have noticed that the following results in uneven margins:
\documentclass[11pt,phd,a4paper,oneside]{ucl_thesis}
image

After some digigng, I think this is because the margin sizes in the cls just dont add up:

\setlength \voffset{-25.4mm}
\setlength \textwidth{140mm}
\setlength \textheight{232mm} % I think you need some extra vertical space for headers and page numbers
\setlength \topmargin{20mm}
\setlength \oddsidemargin {39mm} % Allow a mm for the bleed.
\if@twoside
  \setlength \evensidemargin {20mm}
\else
  \setlength \evensidemargin {39mm}
\fi

A4 paper is 210mm wide, but the textwidth plus the margins adds up to: 140 + 39 + 39 = 218

I guess this is causing the issue or is this intentional?

I changed the settings to

\if@twoside
  \setlength \oddsidemargin {40mm} % Allow a mm for the bleed.
  \setlength \evensidemargin {29mm}
\else
  \setlength \oddsidemargin {34.5mm} % Allow a mm for the bleed.
  \setlength \evensidemargin {34.5mm}
\fi

Doe you see any issues with that?

make command throws error

I'm getting the following error when running make all

lualatex --halt-on-error Main.tex
This is LuaTeX, Version 0.95.0 (TeX Live 2016)
 restricted system commands enabled.
(./Main.tex
LaTeX2e <2016/03/31>
Babel <3.9r> and hyphenation patterns for 1 language(s) loaded.
(/usr/local/texlive/2016/texmf-dist/tex/latex/nag/nag.sty
(/usr/local/texlive/2016/texmf-dist/tex/latex/nag/nag-l2tabu.cfg)
(/usr/local/texlive/2016/texmf-dist/tex/latex/nag/nag-orthodox.cfg))
(./ucl_thesis.cls
Document Class: ucl_thesis 2014/08/12 v1.6 UCL MRes/MPhil/PhD Thesis class
(/usr/local/texlive/2016/texmf-dist/tex/latex/base/book.cls
Document Class: book 2014/09/29 v1.4h Standard LaTeX document class
(/usr/local/texlive/2016/texmf-dist/tex/latex/base/bk12.clo))
(/usr/local/texlive/2016/texmf-dist/tex/latex/psnfss/times.sty)
(/usr/local/texlive/2016/texmf-dist/tex/latex/psnfss/mathptmx.sty))
(./MainPackages.tex
(/usr/local/texlive/2016/texmf-dist/tex/latex/blindtext/blindtext.sty
(/usr/local/texlive/2016/texmf-dist/tex/latex/tools/xspace.sty))
(/usr/local/texlive/2016/texmf-dist/tex/latex/emptypage/emptypage.sty)
(/usr/local/texlive/2016/texmf-dist/tex/latex/graphics/graphicx.sty
(/usr/local/texlive/2016/texmf-dist/tex/latex/graphics/keyval.sty)
(/usr/local/texlive/2016/texmf-dist/tex/latex/graphics/graphics.sty
(/usr/local/texlive/2016/texmf-dist/tex/latex/graphics/trig.sty)
(/usr/local/texlive/2016/texmf-dist/tex/latex/graphics-cfg/graphics.cfg)
(/usr/local/texlive/2016/texmf-dist/tex/lualatex/luatex-def/luatex.def
(/usr/local/texlive/2016/texmf-dist/tex/generic/oberdiek/infwarerr.sty)
(/usr/local/texlive/2016/texmf-dist/tex/generic/oberdiek/ltxcmds.sty))))
! Undefined control sequence.
l.21 \pdfimageresolution
                      =300
 317 words of node memory still in use:
   1 hlist, 1 rule, 1 dir, 4 glue, 40 glue_spec, 1 write nodes
   avail lists: 2:12,3:1,4:1,5:1,7:2,9:3
!  ==> Fatal error occurred, no output PDF file produced!
Transcript written on Main.log.
make: *** [Main.pdf] Error 1

Would you know what might be the cause of it? Maybe related to:

! Undefined control sequence.
l.21 \pdfimageresolution
                      =300

Add a FAQ entry for Arial/Helvetica font changes

Since someone decided that Arial and Helvetica were the officially recommended fonts to set theses in, I should probably add a FAQ entry for how to do that, based on #12.

And find out who that someone is so I can ask them about it.

MSc option

How do I add an option for Master of Science (msc) please?

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.