Awesome
sotonthesis
<img src="https://img.shields.io/github/last-commit/dr-harper/sotonthesis.svg" />
<img src="https://img.shields.io/github/stars/dr-harper/sotonthesis.svg" />
This project is a modified version Chester Ismay's thesisdown package. This respository has updated the template and made other alterations to the code to make it suitable for the use with the Southampton University thesis template here.
Currently, the PDF and gitbook versions are fully-functional. The word and epub versions are developmental, have no templates behind them, and are essentially calls to the appropriate functions in bookdown.
The current output for the four versions is here:
- PDF (Generating LaTeX file is available here with other files at in the book directory.)
- Word
- ePub
- gitbook
Under the hood, the Southampton University thesis template is used to ensure that documents conform precisely to submission standards. At the same time, composition and formatting can be done using lightweight markdown syntax, and R code and its output can be seamlessly included using rmarkdown.
Using sotonthesis has some prerequisites which are described below. To compile PDF documents using R, you are going to need to have LaTeX installed. It can be downloaded for Windows at http://http://miktex.org/download and for Mac at http://tug.org/mactex/mactex-download.html. Follow the instructions to install the necessary packages after downloading the (somewhat large) installer files. You may need to install a few extra LaTeX packages on your first attempt to knit as well.
If you are installing MikTex on a university computer, you may encounter a problem with "pdflatex". It appears this is resolved by only setting MikTex to be installed for the local account within the installation.
Using sotonthesis package:
To use sotonthesis from RStudio:
- Install the latest RStudio.
- Install the bookdown and sotonthesis packages:
install.packages("bookdown")
install.packages("devtools")
devtools::install_github("dr-harper/sotonthesis")
- Use the New R Markdown dialog to select Thesis:
Note that this will currently only Knit if you name the directory index as shown above.
Customising the Template
Once you have downloaded the file, you can customise the template using the parameters within the index.Rmd
---
title: 'Title'
author: 'Author'
supervisor: "Supervisor"
university: "University"
department: "Department"
degree: "Doctor of Philosophy"
group: "Group"
faculty: 'Faculty of X'
date: "`r format(Sys.time(), '%d %B, %Y')`"
knit: "bookdown::render_book"
fontfamily: cmss # cmr (standard), cmss (modern) cmtt (typewriter)
site: bookdown::bookdown_site
frontmatter: true
output:
thesisdown::thesis_pdf: default
# thesisdown::thesis_gitbook: default
# thesisdown::thesis_word: default
# thesisdown::thesis_epub: default
# If you are creating a PDF you'll need to write your preliminary content here or
# use code similar to line 20 for the files. If you are producing in a different
# format than PDF, you can delete or ignore lines 20-31 in this YAML header.
abstract: |
# If you'd rather include the preliminary content in files instead of inline
# like below, use a command like that for the abstract above. Note that a tab is
# needed on the line after the |.
acknowledgements: |
Include Acknowledgements
bibliography: "bib/thesis.bib"
biblio-style: apalike
# Download your specific bibliography database file and refer to it in the line above.
csl: csl/apa.csl
# Download your specific csl file and refer to it in the line above.
lot: true
lof: true
fontsize: 11pt
#space_between_paragraphs: true
# Delete the # at the beginning of the previous line if you'd like
# to have a blank new line between each paragraph
#header-includes:
#- \usepackage{tikz}
---
Example Output
You can view the PDF output of the base template here
