This template is a general template for scientific theses. Currently, it is the unofficial LaTeX template for Master, Bachelor, Diploma, and Student Theses at following institutions:

• University of Stuttgart, Computer Science. [example-english], [example-german], [example-minted-german]
• Paderborn University, Computer Science. - To be confirmed. [example-english] [example-german]

It will be extended to support theses from different institutions.

This file (README.md) of the template is also rendered at https://latextemplates.github.io/scientific-thesis-template/. For architectural decision records see docs/adr.

• Characteristics of the template
• Quick start
• Recommended LaTeX environments
• Installation hints for Ubuntu
• Installation hints for Windows
• LaTeX compilation
• FAQ
• Contained Files and Directories
• Resources
• License

• Most recent packages and package configuration based on long-time experience.
• lualatex (with pdflatex fallback) to enable proper typeset ligatures.
• Open for contributions.
• latexmk - Reasoning available at https://tex.stackexchange.com/a/249243/9075.
• biblatex+biber instead of plain bibtex, because biblatex fully supports UTF-8 and commands such as \citeauthor{...} work out of the box. See also https://tex.stackexchange.com/q/8411/9075.
• Automatic adjustment of wrong ligatures using the selnolig package
• Full Unicode (UTF-8) support
• Optional: Render listings using minted, which provides better output than listings, but requires pygments to be installed.

Even though AuToLaTeX is more powerful than latexmk, it is not included in MiKTeX and therefore it is not used here.

1. Go to the latest release via https://github.com/latextemplates/scientific-thesis-template/releases/latest.
2. Download the file source.zip
3. Extract source.zip to the directory you want to work. E.g., c:\users\user\documents\thesis.
4. Start texing at main-english.tex or main-german.tex.
5. Users of Paderborn University:
   • Start texing at main-paderborn-english.tex or main-paderborn-german.tex.
   • Adapt logos/UBP-background-picture.pdf to your needs. It has the format 20cm x 10cm.
   • Change !TeX root = in latexhints-english.tex and latexhints-german.tex.

See overleaf.

We do not recommend to fork this project as a fork denotes that you work on improving the template itself. Thus, just create a new git repository and populate it using the files provided at source.zip, which you downloaded at the latest release page.

• offline: Grammar and spell checking is available at TeXstudio. Please download LanguageTool and configure TeXstudio to use it. Note that it is enough to point to languagetool.jar. Use JabRef to manage your bibliography. Quick installation using Chocolatey: choco install texstudio languagetool jabref. A comparison to other literature management software is available at https://ultimate-comparisons.github.io/ultimate-reference-management-software-comparison/.
• online: overleaf. Also with git support.

See LaTeX Editors/IDEs question on TeX.SX for a complete list of LaTeX editors.

From Ubuntu 17.04 onwards, this template works without issues.

Ubuntu 16.04 ships biber 2.4, so you have to upgrade your texlive distribution. The easiest way is to uninstall the ubuntu package and use install-tl-ubuntu. Then, you can follow the instructions given at http://tex.stackexchange.com/a/55459/9075 to update your texlive distribution. If you do not want to have an updated installation, but fiddle around with dirty patching your installation, please follow http://tex.stackexchange.com/questions/84624/how-to-upgrade-biblatex-properly.

• The default installation of MiKTeX might ship with incompatible biblatex and biber packages. You have to keep your MiKTeX up to date. In case you followed the linked installation steps, you only have to run "Update MiKTeX". If you installed MiKTeX other ways, you have to run "Update MiKTeX (Admin)" and "Update MiKTeX" and check in both tools for updates (see http://tex.stackexchange.com/a/108490/9075).
• Install other tools using chocolatey: choco install texstudio sumatrapdf.install latexmk strawberryperl jabref languagetool jre8. This allows you to run choco upgrade all to keep the software updated.
• Ensure that in the "MiKTeX Package Manager" "biber" and "biblatex-lni" are installed

• Download the basic installer from http://miktex.org/download
• Start it
• First screen: Read the license conditions and be sure that you really agree.
  • Check "I accept the MiKTeX copying conditions"
  • Click "Next"
• Second screen: "Shared Installation": Install MiKTeX for: "Only for: username".
  • Check first option
  • Click "Next"
• Third screen: "Installation Directory": Install MiKTeX to: C:\MiKTeX. This enabled browsing for documentation at C:\MiKTeX29\doc\latex
  • Input "C:\MiKTeX" in the input field
  • Click "Next"
• Fourth screen: "Settings": Preferred paper: A4 and install missing packages on the fly.
  • First combo box: "A4"
  • Second combo box: "Yes":
  • Click "Next"
• Fifth screen: Press "Start"
• Now a window "Executing" appears. It will take about 5 minutes until this is finished.
• At the last screen: Click "Close"
• After the installation:
  1. Open cmd.exe
  2. Execute refreshenv to make MiKTeX's binaries known right after the installation
  3. Execute mpm --update-db
  4. Execute mpm --update
  5. Execute mpm --install=tex-gyre (to resolve fontspec error: "font-not-found", \setmainfont{TeX Gyre Termes})
  6. Execute mpm --install=tex-gyre-math
  7. Execute mpm --install=cm-super
  8. Execute initexmf --update-fndb (ensure that no other MiKTeX tooling such as the MiKTeX Console is run in parallel - see MiKTeX/miktex#98 (comment))
  9. Execute initexmf --mklinks --force

The template is compiled using normal compiliation commands. Your LaTeX environment (such as TeXStudio) should take care about the compilation transparently. If you open main-minted-german.tex, there will be a warning that the compilation command will be overriden. Please anwer "(a) allow for this document". When the "Package Installation" dialog pops up at TeXStudio, choose your username at "The package will be installed for:" and uncheck "Always show this dialog before installing packages." If you want to include .svg graphics, inkscape has to be in your path.

If you want to compile using the command line, you can use following tools.

latexmk main-german

latexmk -pvc main-german

This will open a Sumatra PDF and only works with the supplied configuration.

This repository ships a .latexmk which is read by latexmk. It is configured for Windows and especially sets Sumatra PDF as default PDF viewer. You can make this local configuration a global configuration, when you put it at the right place.

If you want to add more packages, configure it there. For instance, for support of makeglossaries see http://tex.stackexchange.com/questions/1226/how-to-make-latexmk-use-makeglossaries.

A ligature is the joining of letters to look better. There are rules that there should be no ligatures at "morpheme boundaries". See english.stackexchange.com for a long discusisson.

Example with correct ligatures:

Example with wrong ligatures:

See ADR-0004 for a discussion on the technical solution possiblities.

See installation hints of how to update them at different systems.

Google for the name of the sty and upload it to overleaf. As of 2018-02-17, these are:

• lccaps.sty - can be downloaded from https://latextemplates.github.io/stys-for-overleaf/.
• scientific-thesis-cover.sty - can be downloaded from https://raw.githubusercontent.com/latextemplates/scientific-thesis-cover/master/scientific-thesis-cover.sty.

Use the MiKTeX console to refresh the package index. Then, automatic installation should work again.

Please ensure that your compiliation command includes -shell-escape. E.g., lualatex -shell-escape -synctex=1 main-minted-german.tex. When compiling main-minted-german.tex with TeXStudio, you will see a dialog warning about overriding the comipiliation command. Just anser "(a) allow for this document" and it will work.

Just run pdflatex again.

Install the cm-super package using the MiKTeX package manager. Then, run initexmf --mkmaps on the command line. (Long description: http://tex.stackexchange.com/a/324972/9075)

Edit preambel/chapterheads.tex.

1. Select the excel chart you want to use.
2. Print to PDF with the option "Print Selected Chart".
3. Remove empty space of the created PDF page with pdfcrop chart.pdf chart_cropped.pdf (install via MikTex first, if not available; check via pdfcrop --version).
4. Use pdfscissors (https://sites.google.com/site/pdfscissors) to crop the borders and title (maybe you have to allow https://sites.google.com in the Java security center in the control panel).
5. Include the PDF in LaTex via \includegraphics{chart_cropped.pdf}.

Please remove the magic comments (% !TeX program ...) at the top of the main-....tex file. Although LaTeX-Workshop supports magic comments, it currently does not work reliably. Without the magic comments, compilation works.

• If you included some version control statements, please remove them. Currently, the template does not support any, but it used to support SVN.
• By using \largepage and \shortpage, single lines at the bottom or at the top of the page can be manually fixed.
• Search the PDF for "TODO" or similar things. Remove \usepackage{todonotes} in config.tex.
• Ensure that you run lualatex at least three times and that there are no "undefined references".
• The margins are intended for good screen reading. Do not change them (or do exactly know what you are doing).

For those, who have cygwin installed or run a linux machine, this template offers a simple LaTeX makefile. It is not as sophisticated as other projects, but does its job.

make

Make targets:

• pdf (default): Generates ausarbeitung.pdf
• aspell: Checks all files using aspell.
• clean: Removes all temporary files.
• mrproper: Cleans up and removes also editor backup files.
• stand: Creates a new PDF with the current status of the thesis.
• view: Opens the configured viewer
• 6: Generates a 3x2 postscriptfile using psnup.

• https://github.com/akerbos/ltx2any
• https://github.com/shiblon/latex-makefile
• https://github.com/ransford/pdflatex-makefile
• https://github.com/brotchie/latex-rubber-makefile
• LaTeX-Mk
• See also Recommended build system for latex? and How to properly 'make' a latex project?

1. Install python and pygments:

• choco install python
• pip install pygments

1. Start with main-minted-german.tex
2. Use -shell-escape when texing: lualatex -shell-escape main-minted-german.tex

For German users, go to http://texfragen.de/.

This template uses the alphabetic style. That style is explained at the biblatex documentation on page 60:

The alphabetic labels resemble a compact author-year style to some extent, but the way they are employed is similar to a numeric citation scheme. For example, instead of “Jones 1995” this style would use the label “[Jon95]”. “Jones and Williams 1986” would be rendered as “[JW86]”.

We are aware that the University of Stuttgart recommends to use the Hardvard style. However, this style is not common in natural sciences and information science.

Execute latexindent -l -s -sl -w main-english.tex

Execute latexindent -m -l -s -sl -w main-english.tex. Attention! This is work in progress and does not always produce best results.

Sure. The Hagenberg Thesis Document Collection seems to be the most promising. However, they currently do not support microtype and not the cover of the University of Stuttgart.

We are collecting alternatives at the issue #25 and plan to add a comparison to each other template.

• graphics Directory containing the figures. By using LuaLaTex/PDFLaTeX it is possible to use PDFs, JPGs, PNGs, ... We recommend to use PDFs to enable smooth scaling.

• main-*.tex - Start file for theses
  • The files follow the pattern main-[institution-][feature-][language].tex, where
    • institution is empty or paderborn
    • feature is empty or minted
    • language is english or german
    • main-german.tex for German
    • main-english.tex for English
    • main-paderborn-german.tex for German theses at Paderborn University
    • main-paderborn-english.tex for English theses at Paderborn University
  • Add text here
  • Adjust title etc. here
• bibliography.bib - Bibliography. biblatex format. Manage it with JabRef.
• acronyms.tex - Abbreviations.
• commands.tex - Example macros
• config.tex - The place to add packages etc.

Following additional files are included, which do not need to be adapted:

• Makefile - The Makefile. Builds on latexmk.
• README.md - Explains the template

• Lutz Hering, Heike Hering: How to Write Technial Reports, Springer, 2010; also available in German Technische Berichte - verständlich gliedern, gut gestalten, überzeugend vortragen. - Highly recommended, because it guides through all aspects of a report (such as a Master Thesis).
• Marcus Deininger et al.: Studienarbeiten - Ein Leitfaden zur Erstellung, Durchführung und Präsentation wissenschaftlicher Abschlussarbeiten am Beispiel Informatik, vdf. - Recommended as guideline for planning and working on the whole thesis.
• Charles Lipson, Cite Right, Second Edition: A Quick Guide to Citation Styles--MLA, APA, Chicago, the Sciences, Professions, and More, Chicago Guides to Writing, Editing, and Publishing, 2011. - Recommended in case you are unsure about how to correctly cite something.

The license of this work is CC0, which corresponds to "public domain".

The images in logos are subject to other copyright from other parties:

• UPB_LOGO_GB_RGB_15.pdf and UPB_Logo_RGB_D_2012.pdf are copyright Paderborn University. Refer to https://www.uni-paderborn.de/universitaet/marketing/design-vorgaben-templates/ for proper use.
• UBP-background-picture.* are demonstration files generated using an educational edition of Microsoft Office. They can be used in a scientific context only. For commercial use, please change them.
• UBP-background-picture.pdf is generated out of UBP-background-picture.pptx and is free for personal use only.