Thesis template

A simple Thesis template for the Bachelor Degree in Computer Science @Unipadova

Installation

To use this template you will need a full LaTeX configuration installed. If you don't have an already installed distribution you can read the following instructions and you'll be ready to go!

Read more

TeX Live installation

You can use whatever you want to compile your thesis, but one of the most straightforward ways is using TeX Live. It should be available on every platform you use and comes with a lot of packages and tools.

There are downloads for Windows and macOS, or instead you can install it using your favorite package manager:

sudo apt install texlive-full

sudo pacman -S texlive-most

sudo dnf install texlive-scheme-full

brew install basictex

choco install texlive

Configuration for TeX Live

This template is pretty big and complex, hence it requires a lot of specific packages that may not be shipped with your installation of TeX Live by default.

Here's the complete list of packages that you'll need, in order to be able to successfully compile your thesis:

• filecontents
• pdfx
• xcolor
• xmpincl
• caption
• changepage
• csquotes
• emptypage
• epigraph
• nextpage
• eurosym
• layaureo
• listings
• microtype
• mparhack
• relsize
• quoting
• subfig
• booktabs
• glossaries
• glossaries-italian
• glossaries-english
• biber
• biblatex
• babel
• babel-italian
• cm-super
• latexmk

You can install them manually using the TeX Live Manager (have fun!), or using the CLI utility counterpart tlmgr

Just copy and paste the following command in your terminal.

sudo tlmgr update --self
sudo tlmgr update --all
sudo tlmgr install filecontents pdfx xcolor xmpincl caption changepage csquotes emptypage epigraph nextpage eurosym layaureo listings microtype mparhack relsize quoting subfig booktabs glossaries glossaries-italian glossaries-english biber biblatex babel babel-italian cm-super latexmk

As you can see tlmgr asks for admin rights, so you'll need to use sudo on Linux/macOS, while on Windows you have to open a command prompt instance as admin and omit the sudo at the beginning of the lines.

---

Compilation

You tried to compile this template and the glossary isn't showing up or the bibliography is empty? Don't panic, that's pretty normal. It happens because glossary and bibliography need a special treatment during the compilation process.

Down here you find all the details to successfully compile the PDF

Read more

Latexmk

In order to get the complete PDF of your thesis, with all the rings and bells of glossaries and bibliographies you need to compile using latexmk with the following command:

latexmk thesis.tex

Latexmk is a powerful tool and allows you to do some other interesting stuff too, see latexmk -help. Most notably, if something feels wrong in the produced PDF you may want to force a full recompilation, using the -g (or the more aggressive -gg) option.

Yeah ok, cool, but I don't want to always compile from the terminal

You can tell your LaTeX editor to compile using latexmk by default.

VS Code + TeX Workshop extension

This template comes with a settings.json file, that sets latexmk as the default command to compile the PDF. Everything should work fine out of the box.

TeXStudio

Read the first 3 points of this guide.

---

Template structure

So, you finally managed to get your setup working and you're ready to begin to write actual stuff, but you just realized there are so mamy files in here and you don't even know where to start from...

First of all, these are the only files you should care about:

Thesis
├── appendix
│   ├── appendice-a.tex
│   ├── bibliography.bib
│   ├── bibliography.tex
│   └── glossary-entries.tex
├── chapters
│   ├── concept.tex
│   └── ...
├── config
│   ├── packages.tex
│   └── thesis-config.tex
├── images
│   ├── unipd-logo.png
│   └── ...
├── preface
│   ├── acknowledgements.tex
│   ├── copyright.tex
│   ├── dedication.tex
│   ├── summary.tex
│   ├── table-of-contents.tex
│   └── title-page.tex
├── structure.tex
├── printable-thesis.tex
└── thesis.tex

Yeah, well, not actually all of them. Let's break down their purpose down here

Read more

• config/thesis-config is the first file you may want to look into. Don't worry, most of it are just configurations you'll never touch, but you should of course fill the variables on top of it with you personal informations. They will be used to automatically fill some contents
• config/packages should be self-explanatory. Just the declaration of all the packages used in the project. Nothing relevant to see here
• structure doesn't contain any actual content at all. It just sets down the structure of the document, importing other files in the right order. You may occasionally need to put some new chapters you will write, but apart from that there's not much to do here
• thesis is the root file of your thesis. As you can read above it is the only file to compile, in order to get the final PDF. Nothing more to say
• printable-thesis is yet another root file. When compiled, this one produces a version that is more fit to be printed as an elegant sweet physical copy, than to be viewed on your favorite PDF reader. It provides asymmetrical margins, chapters openings on the right and no links highlighting
• preface groups all those pages you find before the actual chapters:
  • summary briefly explains what the thesis is about. You shouldn't spend much effort on this, just look at what's already in there and adapt it to your experience
  • acknowledgements should be clear by itself. Just remeber to thank your professor first
  • dedication makes a small dedication with famous quote
  • title-page declares the structure of the front page. Everything is automatic and the various names, such as your name, you thesis title, your professor etc get filled from those variables you set in config/thesis-config. If your thesis has a very long title you may need to slightly adjust some spacing, in order to keep a decent layout
  • table-of-contents generates the table of contents. Nothing to see here
  • copyright is nothing special, just that blank page with copyright
• chapters has the real stuff in it. This is the directory you will spend most of your time in, writing the main content. You will already find some example chapters in there, which are meant to show you how to use the template and to give an example of the structure of a thesis.
  Use file names that reflect the content of the chapter, avoid calling them chapter-03.tex. When creating, deleting or modifying chapters remember that you have to put them in structure.tex too
• images is where the template will look for images, when including one
• appendix are the last chapters, such as custom appendix chapters, bibliography and glossary
  • bibliography.bib is where you put actual bibliography content
  • glossary-entries is where you put your glossary definitions, following the syntax of the example terms
  • bibliography.tex is the automatic structure of bibliography. No need to change anything here

---

Remember not to unconditionally stick with this structure, as it's just an example. If you feel you don't need this chapter or that section, or you prefer a different order and organization of the content do as you want.

Before really starting to write actual content you should take some time to think about the strcuture of your chapters, filling them with the (empty) sections you will then develop, as it should help later on, avoiding to constantly rewrite and reorder stuff.