{"id":22901263,"url":"https://github.com/mooerslab/modular-annotated-bibliography-bibtex-rmarkdown","last_synced_at":"2026-03-19T23:57:27.256Z","repository":{"id":260602437,"uuid":"881800257","full_name":"MooersLab/modular-annotated-bibliography-bibtex-rmarkdown","owner":"MooersLab","description":"Modular, illustrated, and annotated bibliography for self study in R Markdown","archived":false,"fork":false,"pushed_at":"2024-11-06T04:01:55.000Z","size":502,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-07T03:41:59.664Z","etag":null,"topics":["annotated-bibliography-for-self-study","code-listings-in-bibliography","equations-in-bibliography","figures-in-bibliography","full-featured-annotated-bibliography","glossaries","illustrated-annotated-bibliography","indexed-annotated-bibliography","interactive-computing-in-bibliography","list-of-acronyms","list-of-mathematical-notation","modular-annotated-bibliography","rmarkdown-and-latex","tinytex"],"latest_commit_sha":null,"homepage":"","language":"TeX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MooersLab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2024-11-01T09:00:23.000Z","updated_at":"2024-11-06T04:01:59.000Z","dependencies_parsed_at":"2025-02-07T03:41:38.245Z","dependency_job_id":"eeb599f1-1129-4f5d-b9c1-34447e45bb88","html_url":"https://github.com/MooersLab/modular-annotated-bibliography-bibtex-rmarkdown","commit_stats":null,"previous_names":["mooerslab/modular-annotated-bibliography-bibtex-rmarkdown"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MooersLab%2Fmodular-annotated-bibliography-bibtex-rmarkdown","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MooersLab%2Fmodular-annotated-bibliography-bibtex-rmarkdown/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MooersLab%2Fmodular-annotated-bibliography-bibtex-rmarkdown/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MooersLab%2Fmodular-annotated-bibliography-bibtex-rmarkdown/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MooersLab","download_url":"https://codeload.github.com/MooersLab/modular-annotated-bibliography-bibtex-rmarkdown/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246591782,"owners_count":20801984,"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":["annotated-bibliography-for-self-study","code-listings-in-bibliography","equations-in-bibliography","figures-in-bibliography","full-featured-annotated-bibliography","glossaries","illustrated-annotated-bibliography","indexed-annotated-bibliography","interactive-computing-in-bibliography","list-of-acronyms","list-of-mathematical-notation","modular-annotated-bibliography","rmarkdown-and-latex","tinytex"],"created_at":"2024-12-14T01:32:35.750Z","updated_at":"2026-01-11T05:06:04.968Z","avatar_url":"https://github.com/MooersLab.png","language":"TeX","funding_links":[],"categories":[],"sub_categories":[],"readme":"# modular-annotated-bibliography-bibtex-rmarkdown\n![Version](https://img.shields.io/static/v1?label=modular-annotated-bibliography-bibtex-rmarkdown\u0026message=0.1\u0026color=brightcolor)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n\n# Template in R Markdown for generating a modular, illustrated, and annotated bibliography for the 21st Century with BibTeX\n\n## Status: works\n\n## What is this?\n\nThis template supports making single-paragraph annotations found in classical annotated bibliographies for undergrad homework.\nIt also supports making multi-paragraph entries illustrated with figures, tables, equations, code listings, hyperlinks to videos online, and citations inside and outside the annotated bibliography.\nYes, the annotated bibliography includes an inclusive Literature Cited section.\nThese additional features make this modern approach to knowledge management more effective as a tool in science research and for self-study.\nWe have to use a modular approach to the annotations to be able to avoid the loss of whitespace between paragraphs and to enable text wrapping around embedded figures.\nThe modular approach also enables the reuse of annotations in the  bibliographies of related projects.\n\nThe 21st Century bibliography has the following enhanced features that the classic annotated bibliography lacks:\n\n- No longer restrained by the `annote` field in the BibTeX entry.\n- Modular annotation for easy reuse in related projects.\n- Images\n- Tables\n- Equations\n- Code blocks\n- Hyperlinks: internal and external\n- Bibliographic entries can be reordered for subgrouping by category. \n- Table of contents, hyperlinked to sections\n- Index of terms\n- Bibliography includes papers cited outside of those listed in the annotated bibliography.\n- List of acronyms used\n- List of glossary terms used\n- List of mathematical notation\n  \n## Why R Markdown?\n\nThis template can be used in RStudio or an advanced text editor.\nMany people prefer to write in R Markdown.\nR Markdown is a [wrapper](https://everyday.codes/tutorials/how-to-use-latex-in-rmarkdown/) for LaTeX.\n\n\n## System requirements\n\nYou need a recent version of R.\nR Studio is optional.\n\nYou can use your current install of LaTeX (e.g., texlive).\nIf you lack one, you can install via R a slimmed-down version of texlive called tinytex.\nIt will fetch and install packages as you need them.\n\n```R\ntinytex::install_tinytex()\n```\n\nYou can install and import LaTeX packages using the following in the YAML header of the main Rmd file:\n\n```yaml\npdf_document:\n  extra_dependencies: ['amsmath', 'minted']\n```\n\nThe template has a code block to send the `-shell-escape` flag to the PDF compiler to enable the use of the minted package for syntax highlighting of code blocks.\n\n\n## You will need to install the following R packages: \n\nThe packages in [ ] are alternatives to the glossaries package in LaTeX.\n\n- rmarkdown\n- [acronymsdown](https://rchaput.github.io/acronymsdown/)\n- [glossary](https://debruine.github.io/glossary/) \n\n## Additional requirements\n\n- a BibTeX file (annote fields are not used. )\n- a `~/bibNotes` folder for storing the annotations. See example above.\n- a `~/bibNotes/images` folder for storing image files used in the bibNotes.\n- a `~/glossaries` folder to store the list of acronyms and glossary files.\n  \n## Adding to the bibliography\n\n1. Provide the path to your BibTeX file in the argument to `\\bibliography{}.`\n2. Create a \u003ccitekey\u003e.tex or \u003ccitekey\u003e.Rmd file for each entry and store it in the bibNotes folder. No enabling code on the top line of these files is required.\n3. Store associated image files in the images subfolder.\n4. Inject the bibliographic entry in a subsection heading by calling with its citekey in the argument for \\bibentry{}. See below.\n   \n```latex\n\\subsection*{\\bibentry{Mooers2021TemplatesForWritingPyMOLScripts}}\n\\addcontentsline{toc}{subsection}{Mooers2021TemplatesForWritingPyMOLScripts}\n\\input{/Users/blaine/bibNotes/Mooers2021TemplatesForWritingPyMOLScripts.Rmd}\n```\n\n## Bash function for compiling to PDF and automatically opening the PDF\n\nThis function supports editing the R Markdown file outside of R Studio and compiling it from the command line (e.g., `rmd main` to compile to PDF and open the PDF in the Preview.app).\nPaste the code below into `.bashrc` or `.zshrc` and source this file (e.g., source .zshrc).\n\n```bash\nfunction rmd {\necho \"Compile Rmd (R Markdown) file with R, and open the resulting PDF with the Preview.app. (Mapped to the alias 'pre').\"\nif [ $# -lt 1 ]; then\n  echo 1\u003e\u00262 \"$0: not enough arguments\"\n  echo \"Usage1: rmd \u003cfilename stem\u003e\"\n  return 2\nelif [ $# -gt 1 ]; then\n  echo 1\u003e\u00262 \"$0: too many arguments\"\n  echo \"Usage1: rmd  \u003cfilename stem\u003e\"\n  return 2\nfi\nRscript -e \"library('rmarkdown');library('acronymsdown');library('gloassary');rmarkdown::render('$1.Rmd')\" \u0026\u0026 pre $1.pdf\n}\n```\n\n### Notes\nThe compiling of the PDF could be faster.\nIt is tolerable if you only occasionally need to compile the master file to make a PDF.\nIf you seek a more interactive experience, try the typst variant found [here](https://github.com/MooersLab/modular-annotated-bibliography-typst).\nTypst may be easier for beginners to learn.\nThe template for Typst has all of the same features except for support for lists of Math Notations and for interactive computing in code blocks in RStudio.\nA nice introduction to Typst in October 2024 by Dr. Chase Brown of the University of Central Florida is found [here](https://mediasite.ouhsc.edu/Mediasite/Channel/python/browse/null/most-recent/null/0/null).\n\n## Update history\n\n|Version      | Changes                                                                                                                                   | Date                |\n|:------------|:------------------------------------------------------------------------------------------------------------------------------------------|:--------------------|\n| Version 0.1 |   Added badges, funding, and update table. Initial commit of working version.                                                             | 2024 November 1     |\n\n## Sources of funding\n\n- NIH: R01 CA242845\n- NIH: R01 AI088011\n- NIH: P30 CA225520 (PI: R. Mannel)\n- NIH: P20 GM103640 and P30 GM145423 (PI: A. West)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmooerslab%2Fmodular-annotated-bibliography-bibtex-rmarkdown","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmooerslab%2Fmodular-annotated-bibliography-bibtex-rmarkdown","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmooerslab%2Fmodular-annotated-bibliography-bibtex-rmarkdown/lists"}