This package provides a template for writing theses and dissertations at Brigham Young University using rmarkdown and bookdown. Much of this was inspired by the thesisdown package by Chester Ismay, and this particular implementation was taken directly from jahawkdown by Jake Thompson.
The original LaTeX template and class document were written by Tim McClain and Andrew Ning, and modified for use with pandoc and R markdown. If you are looking for the BYU Engineering LaTeX class only, it is available here.
You can install cosmodown from github with:
# install.packages("devtools")
devtools::install_github("gregmacfarlane/cosmodown")You also need a working LaTeX program; I recommend the TinyTeX distribution, but complete LaTeX distributions are available below:
The recommended way to use this template is with RStudio; however, it is possible to use this template with a different IDE.
-
Open Rstudio
-
Start a new Rstudio project in a new directory
-
On the list of templates, select “BYU Thesis using cosmodown”.
-
On the new project page, name your project and give it a location. This will be the name of the folder as well as the
.RprojRstudio project file.
-
Select “OK”, and the new project should open automatically. To render the document to a website and to a PDF, push the “Build Book” button under the “Build” tab. This button also has a drop-down that will allow you to build either the site or the PDF.
-
The site and the rendered PDF will be stored in the
docs/folder.
If the example PDF fails to render, try these steps:
- If you are not using RStudio, attempt to render in RStudio.
- Make sure your LaTeX environment was successfully setup.
- Make sure your R packages are up to date, specifically rmarkdown, bookdown, cosmodown, and knitr.
If errors persist after trying all of these steps, post your process along with the resulting error to a new issue on Github, and I will try to help.