{"id":16284683,"url":"https://github.com/pachadotdev/varsityblues","last_synced_at":"2025-03-20T02:31:13.460Z","repository":{"id":81294136,"uuid":"407025615","full_name":"pachadotdev/varsityblues","owner":"pachadotdev","description":null,"archived":false,"fork":false,"pushed_at":"2024-03-24T20:51:54.000Z","size":7529,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-28T22:41:06.394Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pachadotdev.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-09-16T04:57:25.000Z","updated_at":"2024-07-15T06:00:09.000Z","dependencies_parsed_at":"2024-10-27T21:42:31.016Z","dependency_job_id":"fe45d8fb-4f29-4f61-93aa-92d761fd531b","html_url":"https://github.com/pachadotdev/varsityblues","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pachadotdev%2Fvarsityblues","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pachadotdev%2Fvarsityblues/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pachadotdev%2Fvarsityblues/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pachadotdev%2Fvarsityblues/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pachadotdev","download_url":"https://codeload.github.com/pachadotdev/varsityblues/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244041583,"owners_count":20388265,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-10T19:20:26.641Z","updated_at":"2025-03-20T02:31:12.314Z","avatar_url":"https://github.com/pachadotdev.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"# varsityblues \u003cimg src=\"https://github.com/pachadotdev/varsityblues/blob/main/images/varsityblues_hex.png\" align=\"right\" width=200 /\u003e\n\n\u003c!-- badges: start --\u003e\n[![R-CMD-check](https://github.com/pachadotdev/varsityblues/workflows/R-CMD-check/badge.svg)](https://github.com/pachadotdev/varsityblues/actions)\n\u003c!-- badges: end --\u003e\n  \n## About\n\nA package for writing UofT papers, presentations and thesis using Quarto.\n\nThis package aims to encourage reproducible research and better reproducibility\npractices using simple Markdown syntax while embedding all of the R code to\nproduce plots and analyses as well.\n\nThis R package will conduct all the steps required to create a pdf document,\nincluding installing LaTeX if needed.\n\nSee https://github.com/pachadotdev/lucida-minion-tex to install a better font\nfor your documents.\n\n## Acknowledgements\n\nThis is based on [thesisdown](https://github.com/ismayc/thesisdown), \n[beardown](https://github.com/kelseygonzalez/beardown) R packages, and\nyears of LaTeX tricks I learned at the Catholic University of Chile and the late\nprofessor Kim C. Border.\n\nThanks a lot to [Kelsey Gonzalez](https://github.com/kelseygonzalez) for\npolishing beardown, it made creating varsityblues much more simple!\n\n## Examples\n\nSee an example **paper** output in \n[qmd](https://github.com/pachadotdev/varsityblues/blob/main/inst/extdata/paper/paper.qmd) and [pdf](https://github.com/pachadotdev/varsityblues/blob/main/inst/extdata/paper/paper.pdf).\n\nSee an example **presentation** output in \n[qmd](https://github.com/pachadotdev/varsityblues/blob/main/inst/extdata/presentation/presentation.qmd) and [pdf](https://github.com/pachadotdev/varsityblues/blob/main/inst/extdata/presentation/presentation.pdf).\n\nSee an example **thesis** output in\n[qmd](https://github.com/pachadotdev/varsityblues/blob/main/inst/extdata/thesis/thesis.qmd) and [pdf](https://github.com/pachadotdev/varsityblues/blob/main/inst/extdata/thesis/thesis.pdf)\n\n## Using varsityblues\n\n1) Install the varsityblues package. Note that varsityblues is not available on CRAN and that you will be installing from an unofficial source which is my GitHub repository.\n\n```r\nremotes::install_github(\"pachadotdev/varsityblues\")\n```\n\n2) From the R terminal\n\n```r\nvarsityblues::start_project()\n```\n\nOtherwise, click *File -\u003e New Project -\u003e New Directory -\u003e UofT paper/presentation/thesis using varsityblues* in RStudio's top bar.\n\nNote that you may need to restart RStudio at this point if the dialog didn't show up.\n\n![Create new project](images/varsityblues_project.png)\n\n3) Edit `paper`'s contents. To render your paper into a pdf, open the `qmd` file inside the `paper` directory in RStudio and then click the \"render/knit\" button. The pdf file of your paper will be created in the same directory.\n\nThe same steps apply to presentations and thesis.\n\nYou can copy and paste the `paper`/`presentation`/`thesis` directory to create a new paper/presentation/thesis as many times as you want and it will be lightweight because the tex files are not duplicated.\n\nYou can also edit the contents of the `tex` folder, but beware that the changes will after any new paper/presentation/thesis that you create.\n\n## Components\n\n### `paper/paper.qmd`\n\nReady to use template to create a pdf document. You'll need to edit the top portion of this file (the YAML header) to put your name, the title, etc and then you can start writing your paper.\n\n### `presentation/presentation.qmd`\n\nReady to use template to create a pdf presentation. You'll need to edit the top portion of this file (the YAML header) to put your name on the title slide and then you can start writing your presentation.\n\n### `thesis/thesis.qmd`\n\nReady to use template to create a pdf thesis according to UofT design rules. You'll need to edit the top portion of this file (the YAML header) to put your name, the title, etc and then you can start writing your thesis.\n\n### `bib/`\n\nStore your bibliography (as bibtex files) here. I recommend using the [citr addin](https://github.com/crsh/citr) and [Zotero](https://www.zotero.org/) to efficiently manage and insert citations.\n\n### `csl/`\n\nSpecific style files for bibliographies should be stored here. A good source for\ncitation styles is https://github.com/citation-style-language/styles#readme.\n\n### `figure/` and `data/`\n\nStore 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.\n\n## Troubleshooting\n\n1) The varsityblues templates shall detect existing LaTeX install or shall install a minimal version that just works when you knit the document.\n2) Ensure that you have already installed [Quarto](https://quarto.org). I moved everything to Quarto because it is easier to use.\n\n## Using wihout RStudio\n\nYou can use `varsityblues` without RStudio. For example, you can write the qmd files in your favourite text editor (e.g. Visual Studio Code).\n\n## (Totally optional) Install lucimatx\n\n`lucimatx` provides better typography but it's a paid package. Install it \nunder `~/.TinyTeX/texmf-local`.\n\nThe steps that worked for me are:\n```\ncd ~/.TinyTeX/texfmf-local\nunzip ~/Downloads/lucida-type1.zip\nunzip ~/Downloads/lucimacros.zip\nmktexlsr\nupdmap-sys --enable Map=lucida.map\nupdmap-sys\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpachadotdev%2Fvarsityblues","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpachadotdev%2Fvarsityblues","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpachadotdev%2Fvarsityblues/lists"}