# R for CVs / resumes

### Workshop details

Title: Customizable Resumes with R Tools

Learn how to create and customize your CV / resume using R Markdown templates. From this workshop, you will become familiar with the options in R for making resumes and come away with one with your own information. While previous experience with R is useful, it is not a prerequisite to participate in this workshop.

### Installation instructions

Attendees should install / update R & RStudio
Should also install CCT DS fork / version of `datadrivencv` using `devtools::install_github("cct-datascience/datadrivencv")` (link to GH repo)
ideal to have a Gmail account with access to Google Sheets, though this isn't necessary

If they encounter problems, can come to our drop-in hours for troubleshooting help

BCC participant list from Zoom registration
CC Eric

### Slides notes

- This is not about what your resume contents should be! This is about using R tools to more easily create, customize, format, reuse CV / resume
- Pros and cons of this approach

### Teaching notes

- They will need to install from our org's fork or r-universe
- README documentation are not great instructions
- Create local or Google sheets copy of dataset
- Will need to change to "anyone with link"
- Make R project with title "CV" or something, then can push to GH
- Save out pdf and html locally first

This creates local files in a local directory

use_datadriven_cv(full_name = "Kristina Riemer", data_location = "https://docs.google.com/spreadsheets/d/133qp5WEhti00MamTPX0J_-qj35bvVMNcfuZprJRUZfQ/edit#gid=917338460", output_dir = "cv_temp/")

Need to run lines in `render_cv.R` to get html or PDF of CV

- Change paths to local dir

**make template google sheet**

#### Steps
1. Install `datadrivencv` (hopefully everyone before workshop) from CCT DS r-universe or GH repo
2. Create CV R Rproject from RStudio
3. Generate v1 (their name + template Google sheet) files and walk through these 4 files

library(datadrivencv)
use_datadriven_cv(full_name = "name here", data_location = "https://docs.google.com/spreadsheets/d/1mq7H8ZiF6k7H_f6rY2eA0sq2Xyxf9msmXv3LPsvSYoo/edit#gid=1730172225")

At this point, shouldn't need `datadrivencv` anymore?

4. Generate PDF + html files by running `render_cv.R`

customize data files

5. Show local text file method

use `use_csv_data_storage` to create them

5. Create their own data file (copy Google Sheet or do local text file)

put it online w/ html_location arg

customize appearance

*take suggestions for what to modify*
- Bits to change...and most importantly how to figure out how to do this -- change `dd_cv.css` file
- Image
- Colors?
- Fonts?
- Other templates?
- Remove network logo w/ argument (changes it to the R logo), replace with something else in cv.Rmd (replace chunk line 48 with `{width=100%}`)
- Change icons in contact_info tab of Gsheet
- Change colors with hex values in css

### instructions for template repo

To be able to use without needing to install `datadrivencv`

1. Download [template_resume_datadrivencv repo](https://github.com/cct-datascience/template_resume_datadrivencv)
2. Unzip downloaded file and rename folder
3. Create R project for this new folder
4. Run `render_cv.R`
5. Customize by changing `cv.rmd`, `dd_cv.cs`, and files in `data/`

Note this uses local files option. Can change to using Google Sheet as data input by...

### Options

| Option | Pros | Cons |
| -------- | -------- | -------- |
| Quarto template using Latex | Multiple templates available | Hard to fix Latex |
| Quarto template using css | Doesn't use Latex | Hard to fix css? |
| R Markdown template using Latex | Update table with new data | Hard to fix Latex |

- 4 CV templates with underlying Latex (all adapted by the same person from pre-existing Latex templates): https://github.com/schochastics/quarto-cv
- If these break, people might have a hard time fixing?
- Latex also underlies vitae R markdown templates
- [Blog post](https://alexbass.me/posts/resume/) with simple template
- Can't output to Word if using custom Latex?
- Most options are with R Markdown so far and not much for Quarto?
- R Markdown with tribbles or Excel/Google sheet containing data
- `vitae` can only render `.Rmd`, not `.qmd`, to PDF, and poorly to HTML? https://community.rstudio.com/t/unable-to-use-vitae-package-with-quarto-to-create-cv/138800
- They were waiting for Quarto to mature to do CV templates. `vitae` developer is thinking about this but hasn't done it yet: https://github.com/mitchelloharawild/vitae/issues/215
- Doesn't seem like Quarto is planning on supporting this
- Quarto template without Latex, but requires css stylesheet (and a standalone program that produces PDF): https://www.cynthiahqy.com/posts/cv-html-pdf/
- Another R Markdown option is using `pagedown`
- Some templates: https://github.com/ulyngs/pagedownCV
- `datadrivencv` package: https://github.com/nstrayer/datadrivencv

### Zoom chat

11:01:23 From Ryan Stephenson to Everyone:
yay
11:08:59 From Kristina Riemer to Everyone:
https://cct-datascience.quarto.pub/customizable-resumes-with-r-tools/
11:11:14 From Eric Scott to Everyone:
pak::pak("cct-datascience/datadrivencv")
11:14:07 From Ryan Stephenson to Everyone:
rscript or rmarkdown more appropriate?
11:15:17 From Ryan Stephenson to Everyone:
this exercise4
11:15:25 From Ryan Stephenson to Everyone:
ty
11:18:18 From Ryan Stephenson to Everyone:
ahhhhh. sorry--been honing my attention to this from other tasks. Sorry. This list of options is awesome and insightful
11:18:42 From Eric Scott to Everyone:
Reacted to "ahhhhh. sorry--been ..." with 🥳
11:19:09 From Renata Diaz to Everyone:
Reacted to "ahhhhh. sorry--been ..." with 🥳
11:24:17 From Eric Scott to Everyone:
Another possible way to install if devtools isn’t working:

install.packages('datadrivencv', repos = c('https://cct-datascience.r-universe.dev', 'https://cloud.r-project.org'))
11:24:39 From Ryan Stephenson to Everyone:
why in console vs markdown?
11:25:06 From Ryan Stephenson to Everyone:
k ty
11:28:39 From Kristina Riemer to Everyone:
https://docs.google.com/spreadsheets/d/1mq7H8ZiF6k7H_f6rY2eA0sq2Xyxf9msmXv3LPsvSYoo/edit#gid=917338460
11:29:46 From Ryan Stephenson to Everyone:
Options to copy have been disabled
11:30:24 From Renata Diaz to Everyone:
I updated the permissions to allow editing
11:30:31 From Ryan Stephenson to Everyone:
ya
11:30:49 From Ryan Stephenson to Everyone:
ty
11:33:48 From Ryan Stephenson to Everyone:
can you share again?
11:35:47 From Kristina Riemer to Everyone:
use_datadriven_cv(full_name = "Kristina Riemer", data_location = "https://docs.google.com/spreadsheets/d/1mq7H8ZiF6k7H_f6rY2eA0sq2Xyxf9msmXv3LPsvSYoo/edit#gid=917338460")
11:37:38 From Ryan Stephenson to Everyone:
Error: '/cloud/lib/x86_64-pc-linux-gnu-library/4.3/datadrivencv/templates/cv.rmd' does not exist.
11:43:42 From Eric Scott to Everyone:
Replying to "Error: '/cloud/lib/x..."

An alternative to try:

usethis::use_course("cct-datascience/template_resume_datadrivencv")
11:43:58 From Eric Scott to Everyone:
Replying to "Error: '/cloud/lib/x..."

That should create a new project that already has all the files that datadrivencv creates
11:44:17 From Eric Scott to Everyone:
Replying to "Error: '/cloud/lib/x..."

Haven’t tested it on posit cloud, but should work?
11:45:00 From Ryan Stephenson to Everyone:
Replying to "Error: '/cloud/lib/x..."

Downloading into '/home/r1475300/'.
Prefer a different location? Cancel, try again, and specify `destdir`
OK to proceed?

1: Yes
2: Nope
3: Absolutely not
11:45:44 From Eric Scott to Everyone:
Replying to "Error: '/cloud/lib/x..."

Say no for now
11:45:46 From Ryan Stephenson to Everyone:
Replying to "Error: '/cloud/lib/x..."

How can I use destdir to change directory?
11:46:02 From Eric Scott to Everyone:
Replying to "Error: '/cloud/lib/x..."

Do this instead: usethis::use_course("cct-datascience/template_resume_datadrivencv", destdir = ".")
11:46:49 From Ryan Stephenson to Everyone:
Replying to "Error: '/cloud/lib/x..."

booyah
11:47:03 From Eric Scott to Everyone:
Replying to "Error: '/cloud/lib/x..."

It puts ieverything in a folder, which is not exactly right, but I think knitting the cv.rmd will still work
11:48:01 From Leif Abrell to Kristina Riemer(Direct Message):
windows defender blocked some
11:48:15 From Ryan Stephenson to Everyone:
Replying to "Error: '/cloud/lib/x..."

I have cv.rmd in the folder
11:48:22 From Leif Abrell to Kristina Riemer(Direct Message):
features of RStudio
11:48:54 From Eric Scott to Everyone:
Replying to "Error: '/cloud/lib/x..."

What happens when you “kind” the cv.Rmd? Any issues?
11:49:07 From Ryan Stephenson to Everyone:
Replying to "Error: '/cloud/lib/x..."

Kind?
11:49:10 From David LeBauer to Everyone:
I got the error

> pagedown::chrome_print(input = tmp_html_cv_loc,
+ output = "cv.pdf")
Error in pagedown::chrome_print(input = tmp_html_cv_loc, output = "cv.pdf") :
The browser is not executable: /Applications/Google Chrome.app/Contents/MacOS/Google Chrome

And no PDF was generated.
11:49:20 From Eric Scott to Everyone:
Replying to "Error: '/cloud/lib/x..."

Oops, “knit”
11:49:33 From David LeBauer to Everyone:
Replying to "I got the error

>..."

But no need to slow down for me.
11:49:49 From David LeBauer to Everyone:
Replying to "I got the error

>..."

> pagedown::find_chrome()
[1] "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
11:51:34 From Ryan Stephenson to Everyone:
Replying to "Error: '/cloud/lib/x..."

Spinning wheel of death in a new chrome \window
11:51:41 From Melanee Steadman to Everyone:
I am using Opera (for my browser) and encountered no issues
11:52:05 From Ryan Stephenson to Everyone:
Replying to "Error: '/cloud/lib/x..."

ok it worked
11:52:30 From Melanee Steadman to Everyone:
Not that I know of. It'san alt browser
11:52:43 From Melanee Steadman to Everyone:
It's primarily used for gaming lol
12:08:23 From Kristina Riemer to Everyone:
https://docs.google.com/spreadsheets/d/1mq7H8ZiF6k7H_f6rY2eA0sq2Xyxf9msmXv3LPsvSYoo/edit#gid=917338460
12:17:15 From Ryan Stephenson to Everyone:
I think it worked...there's something "CV" in the environment
12:18:15 From Eric Scott to Everyone:
Reacted to "I think it worked......" with 🤩
12:18:48 From Eric Scott to Everyone:
Ryan, if you run all the code in render_cv.r, you should also get a cv.pdf created
12:20:26 From David LeBauer to Everyone:
Replying to "I got the error

>..."

Turns out … when on macOS, this path is hardcoded into the find_chrome package. 🤷
12:23:10 From Melanee Steadman to Everyone:
success! I think my connection must have timed out when I ran it initially
12:26:28 From Kristina Riemer to Everyone:
https://fontawesome.com/icons
12:28:03 From David LeBauer to Everyone:
As an aside about the asides (pardon the pun): these are based on the ‘tufte style’ layout, which is in turn based on the layout of the Feynman lectures in physics. with a goal of maximizing information density by making use of margins
12:28:21 From Ryan Stephenson to Everyone:
Reacted to "As an aside about th..." with 😯
12:28:41 From Leif Abrell to Everyone:
yes
12:35:12 From Leif Abrell to Everyone:
what about the image (a network concept?) at the top of the right hand margin?
12:35:54 From Ryan Stephenson to Everyone:
🤯
12:38:09 From David LeBauer to Everyone:
Did you show how to add publications? Also, did any of the CV packages you came across source publications and other information from, e.g. ORCID or WOS or Google Scholar?
12:38:35 From Eric Scott to Everyone:
Here’s some customizations I made to an old pagedown resume in case anyone is interested: https://github.com/Aariq/resumes/blob/main/css/custom.css
12:40:03 From Leif Abrell to Everyone:
Reacted to "Did you show how to ..." with 👍🏼
12:43:08 From Eric Scott to Everyone:
This is how I automatically update my publications on my website. Should work in this cv.rmd too??
12:43:09 From Eric Scott to Everyone:
https://github.com/Aariq/website-quarto/blob/main/publications.qmd
12:44:45 From Eric Scott to Everyone:
Looks like this when rendered: https://ericrscott.com/publications
12:50:40 From David LeBauer to Everyone:
Thanks Kristina et al!
12:50:49 From Ryan Stephenson to Everyone:
Reacted to "Thanks Kristina et a..." with 👏🏼
12:51:51 From Leif Abrell to Everyone:
Can you please explain the content at your website for drop-in hours?

https://datascience.cct.arizona.edu/drop-in-hours
12:52:34 From L Salas to Everyone:
thank you guys, this was very interesting!
12:53:16 From Ryan Stephenson to Everyone:
it's so cool
12:53:37 From Ryan Stephenson to Everyone:
lol
12:54:33 From Renata Diaz to Everyone:
Reacted to "Thanks Kristina et a..." with 👏🏼