Skip to content

jimjam-slam/unswthesisdown

 
 

Repository files navigation

unswthesisdown

This is a fork of ismayc/thesisdown designed to produce theses for UNSW students. Write your thesis in RMarkdown! Installation is mostly as the original thesisdown package, described below, but for the modified repo and package name:

install.packages("devtools")
devtools::install_github("rstudio/bookdown")
devtools::install_github("rensa/unswthesisdown")

In RStudio (step 3 below), the template will appear as 'UNSW Thesis'. Once you've created a new RMarkdown document in R or RStudio using the blow instructions, all you need to do it replace the .Rmd files with your own. You should also modify the YAML (metadata) at the top of index.Rmd to fill in details like your name and school, as well as some of the preliminary matter. You can also use this to switch between PDF and HTML output.

Note that Word and EPUB output are available, but neither have been modified for UNSW: the Word template is from Reed College (so don't submit it!) and the EPUB is, I think, based on the bookdown default (so not great). Stick to Gitbook while you write and switch to PDF as you get toward submission.

If you have any UNSW-specific feedback, add an issue, send me a PR or get in touch :)

thesisdown

This project was inspired by the bookdown package and is an updated version of my Senior Thesis template in the reedtemplates package 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 Reed College LaTeX template (and soon the Reed College Word 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 thesisdown 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.

Using thesisdown from Chester's GitHub

To use thesisdown from RStudio:

  1. Install the latest RStudio.

  2. Install the bookdown and thesisdown packages:

install.packages("devtools")
devtools::install_github("rstudio/bookdown")
devtools::install_github("ismayc/thesisdown")
  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.

About

A forked version of thesisdown for writing UNSW theses with bookdown and RMarkdown

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TeX 86.7%
  • R 13.3%