-
Notifications
You must be signed in to change notification settings - Fork 1
/
README.Rmd
134 lines (82 loc) · 6.99 KB
/
README.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
---
output: github_document
---
<!-- README.md is generated from README.Rmd. Please edit that file -->
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
# macdown <img src="man/figures/macdown.png" align="right" width=180 />
This project is inspired by the [{bookdown}](https://bookdown.org/) and [{thesisdown}](http://thesisdown.rbind.io/) packages, adapted to provide a template for writing a McMaster graduate thesis in R markdown.
The PDF uses McMaster Graduate Thesis LaTeX template.
<!--
The current output for the four versions is here:
- [PDF](https://github.com/ismayc/thesisdown_book/blob/gh-pages/thesis.pdf) (Generating LaTeX file is available [here](https://github.com/ismayc/thesisdown_book/blob/gh-pages/thesis.tex) with other files in the [book directory](https://github.com/ismayc/thesisdown_book/tree/gh-pages).)
- [Word](https://github.com/ismayc/thesisdown_book/blob/gh-pages/thesis.docx)
- [ePub](https://github.com/ismayc/thesisdown_book/blob/gh-pages/thesis.epub)
- [gitbook](https://ismayc.github.io/thesisdown_book)
-->
Under the hood, the McMaster Graduate Thesis 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}](https://rmarkdown.rstudio.com/authoring_basics.html) syntax, and `R` code and its output can be seamlessly included using [{rmarkdown}](https://rmarkdown.rstudio.com).
### Using {macdown}
Using {macdown} 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}](https://yihui.name/tinytex/) R package:
```{r eval=FALSE}
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. Here is one such example of how to do so:
```{r eval=FALSE}
tinytex::tlmgr_install("babel-portuges")
```
To use {macdown} from [RStudio](https://www.rstudio.com/products/rstudio/download/):
1) Ensure that you have already installed LaTeX and the fonts described above, and are using the latest version of [RStudio](https://www.rstudio.com/products/rstudio/download/). You can use {macdown} without RStudio. For example, you can write the Rmd files in your favourite text editor (e.g. [Atom](https://atom.io/), [Notepad++](https://notepad-plus-plus.org/)). 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 {macdown} packages. Note that {macdown} is not available on CRAN and `install.packages("macdown")` will not work. Use `remotes::install_github()` as shown below instead to install the package.
```{r eval=FALSE}
if (!require("remotes"))
install.packages("remotes",
repos = "https://cran.rstudio.org")
if (!require("bookdown"))
install.packages("bookdown",
repos = "https://cran.rstudio.org")
remotes::install_github("paezha/macdown")
```
Note that you may need to restart RStudio at this point before the template becomes available in the menu.
3) Create a project to work on your thesis! Do not nest your thesis as part of another project, since this will confuse the directory structure.
Create your project in a new directory:
For the type of project select "Thesis Project using macdown":
4) Customize the information for the thesis in the YAML at the top of index.Rmd. There you can enter your name, title of the thesis, abstract, etc.
5) Create R markdown documents with the content of your thesis. Each chapter could be a separate R markdown document. To include in the thesis, use chunks in `index.rmd` as follows:
```
```
**Knit** the `index.Rmd` file to get the thesis in PDF format.
### 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 tasks. For a gentle, novice-friendly guide to getting starting with using Git with R and RStudio, see <https://happygitwithr.com/>.
## Rendering
To render your thesis into a PDF, open `index.Rmd` in RStudio and then click the "knit" button.
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. You can change the name of your outputted file here and other options about your thesis here.
### `index.Rmd`
This file contains all the meta information that goes at the beginning of your document. You'll need to edit the top portion of this file (the YAML) to put your name on the first page, the title of your thesis, etc. Note that you need to have at least one chapter start in the `index.Rmd` file for the build to work. For the template, this is done with `# Preface` in the example from the template.
### `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](https://github.com/benmarwick/wordcountaddin) 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](https://github.com/crsh/citr) and [Zotero](https://www.zotero.org/) 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](https://bookdown.org/yihui/bookdown/) for details on cross-referencing items using R Markdown.
## Where to find more information
If you are new to working with these packages, there is much more information and examples available at [{bookdown}](https://bookdown.org/) and [{rmarkdown}](https://rmarkdown.rstudio.com/).