Skip to content

An updated R Markdown thesis template using the bookdown package

License

Notifications You must be signed in to change notification settings

ben-schwen/robotdown

 
 

Repository files navigation

robotdown

This project is an adaption of the thesisdown package to work for the TU Wien.

thesisdown

This project was inspired by the bookdown package and is an updated version of my Senior Thesis template in the reedtemplates package here. It was originally designed to only work with the Reed College LaTeX template, but has since been adapted to work with many different institutions by many different individuals. Check out the Customizing thesisdown to your institution section below for examples.

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.

If you are new to working with bookdown/rmarkdown, please read over the documentation available in the gitbook template at https://thesisdown.netlify.com/. This is also available below at https://ismayc.github.io/thesisdown_book.

The current output for the four versions is here:

Under the hood, the Reed College LaTeX 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.

Customizing thesisdown to your institution

In an ideal world, this package would support a variety of different LaTeX templates from a wide range of institutions and we'd love to get it there at some point. Until that time, realize that this was designed to only work with the Reed College LaTeX template but others have adapted it to work with their institutions. Here are some that have customized it to fit their needs. It is recommended you review how they changed the files by comparing their repositories to this one and then make tweaks to yours as needed. Feel free to file an issue on this repo if you have questions/troubles.

Have you created a thesisdown template for your institution and would like to have it included here? Make a PR similar to the commit done to include jayhawkdown. I'll review it and merge it in. Let's keep the list going!

College/University Repository Based on
American University SimonHeuberger/eagledown benmarwick/huskydown
Brock University brentthorne/brockdown zkamvar/beaverdown
Duke University mine-cetinkaya-rundel/thesisdowndss ismayc/thesisdown
Humboldt University of Berlin phister/huwiwidown ismayc/thesisdown
Kansas State University emraher/wildcatdown benmarwick/huskydown
Massachusetts Institute of Technology ratatstats/manusdown ismayc/thesisdown
Oregon State University zkamvar/beaverdown ismayc/thesisdown
Oxford University davidplans/oxdown ismayc/thesisdown
Southampton University dr-harper/sotonthesis ismayc/thesisdown
Stanford University mhtess/treedown ismayc/thesisdown
University College London benyohaiphysics/thesisdownUCL ismayc/thesisdown
University of California, Davis ryanpeek/aggiedown DanOvando/gauchodown
University of California, Santa Barbara DanOvando/gauchodown benmarwick/huskydown
University of Florida ksauby/thesisdownufl ismayc/thesisdown
University of Freiburg vivekbhr/doctorRbite ismayc/thesisdown
University of Kansas wjakethompson/jayhawkdown ismayc/thesisdown
University of Minnesota zief0002/qmedown ismayc/thesisdown
University of New South Wales rensa/unswthesisdown ismayc/thesisdown
University of Salzburg irmingard/salzburgthesisdown ismayc/thesisdown
University of Washington benmarwick/huskydown ismayc/thesisdown
TU Wien
ben-schwen/robotdown ismayc/thesisdown

Using thesisdown from Chester's GitHub

Special thanks to Ben Marwick for helping to add a lot more clarity to the directions below from the README of his spin-off huskydown package.

Using thesisdown has some prerequisites which are described below. To compile PDF documents using R, you are going to need to have LaTeX installed. By far the easiest way to install LaTeX on any platform is with the tinytex R package:

install.packages(c('tinytex', 'rmarkdown'))
tinytex::install_tinytex()
# after restarting RStudio, confirm that you have LaTeX with 
tinytex:::is_tinytex() 

You may need to install a few extra LaTeX packages on your first attempt to knit as well.

To use robotdown from RStudio:

  1. Ensure that you have already installed LaTeX and the fonts described above, and are using the latest version of RStudio. You can use robotdown without RStudio. For example, you can write the Rmd files in your favourite text editor (e.g. Atom, Notepad++). But RStudio is probably the easiest tool for writing both R code and text in your thesis. It also provides a nice way to build your thesis while editing. We'll proceed assuming that you have decided to use the RStudio workflow.

  2. Install the bookdown and robotdown packages:

if (!require("remotes")) install.packages("remotes", repos = "http://cran.rstudio.org")
remotes::install_github("rstudio/bookdown")
remotes::install_github("ben-schwen/robotdown")
  1. Use the New R Markdown dialog to select TU Wien Thesis:

    New R Markdown

    Note that this will currently only Knit if you name the directory index as shown above. This guarantees that index.html is generated correctly for the Gitbook version of the thesis.

  2. After choosing which type of output you'd like in the YAML at the top of index.Rmd, Knit the index.Rmd file to get the book in PDF or HTML formats.

Day-to-day writing of your thesis

You need to edit the individual chapter R Markdown files to write your thesis. It's recommended that you version control your thesis using GitHub if possible. RStudio can also easily sync up with GitHub to make the process easier. While writing, you should git commit your work frequently, after every major activity on your thesis. For example, every few paragraphs or section of text, and after major step of analysis development. You should git push at the end of each work session before you leave your computer or change task. For gentle novice-friendly guide to getting starting with using Git with R and RStudio, see http://happygitwithr.com/.

Rendering

To render your thesis into a PDF, open index.Rmd in RStudio and then click the "knit" button. To change the output formats between PDF, gitbook and Word , look at the output: field in index.Rmd and comment-out the formats you don't want.

The PDF file of your thesis will be deposited in the _book/ directory, by default.

Components

The following components are ones you should edit to customize your thesis:

_bookdown.yml

This is the main configuration file for your thesis. It determines what Rmd files are included in the output, and in what order. Arrange the order of your chapters in this file and ensure that the names match the names in your folders.

index.Rmd

This file contains all the meta information that goes at the beginning of your document. You'll need to edit this to put your name on the first page, the title of your thesis, etc.

01-chap1.Rmd, 02-chap2.Rmd, etc.

These are the Rmd files for each chapter in your dissertation. Write your thesis in these. If you're writing in RStudio, you may find the wordcount addin useful for getting word counts and readability statistics in R Markdown documents.

bib/

Store your bibliography (as bibtex files) here. We recommend using the citr addin and Zotero to efficiently manage and insert citations.

csl/

Specific style files for bibliographies should be stored here. A good source for citation styles is https://github.com/citation-style-language/styles#readme

figure/ and data/

Store your figures and data here and reference them in your R Markdown files. See the bookdown book for details on cross-referencing items using R Markdown.

About

An updated R Markdown thesis template using the bookdown package

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TeX 86.6%
  • R 13.4%