Git Product home page Git Product logo

sotonthesis's Introduction

sotonthesis

Travis-CI Build Status Project Status: Active โ€“ The project has reached a stable, usable state and is being actively developed. AppVeyor Build Status

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:

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:

  1. Install the latest RStudio. Note: if you are at Southampton university, the standard version of R provided on computers is the still version 0.99.473. You can check this in RStudio within "Help-> About RStudio"

  2. Install the bookdown and sotonthesis packages:

install.packages("devtools")
devtools::install_github("rstudio/bookdown")
devtools::install_github("mikey-harper/sotonthesis")
  1. Use the New R Markdown dialog to select Thesis:

New R Markdown

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

Template Output

sotonthesis's People

Contributors

imgbotapp avatar ismayc avatar nicksolomon avatar rudeboybert avatar

Watchers

 avatar  avatar

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.