{"id":22901273,"url":"https://github.com/mooerslab/annotatedbibliography","last_synced_at":"2025-05-08T02:00:26.087Z","repository":{"id":165234099,"uuid":"533074406","full_name":"MooersLab/annotatedBibliography","owner":"MooersLab","description":"Annotated bibliography template in LaTeX for specific writing projects","archived":false,"fork":false,"pushed_at":"2024-10-24T08:20:31.000Z","size":151,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-31T16:23:30.915Z","etag":null,"topics":["annotated-bibliography","latex"],"latest_commit_sha":null,"homepage":"","language":"TeX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","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":"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":"2022-09-05T22:08:19.000Z","updated_at":"2025-03-14T02:03:52.000Z","dependencies_parsed_at":"2024-02-13T14:05:15.580Z","dependency_job_id":"c6912219-38db-430f-a7c7-e3f2c3c9d2f3","html_url":"https://github.com/MooersLab/annotatedBibliography","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/MooersLab%2FannotatedBibliography","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MooersLab%2FannotatedBibliography/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MooersLab%2FannotatedBibliography/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MooersLab%2FannotatedBibliography/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MooersLab","download_url":"https://codeload.github.com/MooersLab/annotatedBibliography/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252983757,"owners_count":21835764,"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","latex"],"created_at":"2024-12-14T01:32:39.213Z","updated_at":"2025-05-08T02:00:26.037Z","avatar_url":"https://github.com/MooersLab.png","language":"TeX","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Version](https://img.shields.io/static/v1?label=annotatedBibliography\u0026message=0.6\u0026color=brightcolor)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n# Annotated bibliography template in LaTeX for specific writing projects\n\n## Purpose\nGenerate lists of cited papers with annotations following each citation. This document is useful when writing review articles.\n\n## How it works\n\nThese files support the automated generation of an annotated bibliography in LaTeX using bibliographic information in a BibTeX file (NOT BibLaTeX).\nThe *AnnoBib.tex* file is the master file.\nIt uses the *annote* field in the BibTeX entry in *cited.bib*.\nIts style is set by *apacannx.bst*, which must be present unless this file is stored in your library of files for LaTeX on your local computer.\n\n\n## Generate a bib file with only cited references\n\nTo write out the cited bib entries in a manuscript from *global.bib*, use the command line program **bibtool** with the main.tex file's corresponding main.aux file:\n \nRun the following code to generate a bib file of the papers cited in a manuscript. \nNote that main.tex is the manuscript file. \nThe *main.aux* file is hidden on Overleaf. \nFind it under the \"Logs and outputs\" pulldown menu. \n\nThe following command will preserve the letter case in the cite key. \nThe default behavior is to lower the case.\n\n```bash\nbibtool --preserve.key.case=on -x main.aux \u003e cited.bib\n```\n\nBibtool is distributed with LaTeX.\n\n## Writing the annotations\n\nIf you are using BibTeX, manually add `annote` fields to the *AnnoBibMyBDA.bib* file and enter your annotations.\nOr, if you are more disciplined, you can add the *annote* fields in a *global.bib* file and repeat the extraction of the cited entries when you are finished.\nAll entries in `cited.bib` will be used to create the annotated bibliography regardless of whether the *annote* field is present.\n\nThe annote field does not have to be limited to a single paragraph summary like in the one you made in the sixth grade.\nThe annotation field can contain figures, tables, coding listings, and equations.\n\nI store these files in an *annotatedBibliography* subfolder in my writing project's folder.\nThese files work on Overleaf, too.\n\nIf you are using BibLaTeX, manually add `annotation` fields to the *AnnoBibMyBDA.bib*.\n\nFor journal article entries, the difference from BibTeX is that BibLaTeX uses a `journaltitle` field insead of a `journal` field.\n\nNote that you can use JabRef to export a BibTeX library to a BibLaTeX library.\nUse can also use the R statistical package for this purpose.\nSee below.\n\n## Protocol for BibTeX to BibLaTeX library conversion with R\n\nNote that you must supply the full file paths.\nAlso, note the order of the arguments to bibConvert.\nThe third argument is the file type of the first.\nThe fourth argument is the file type of the second argument.\n\n\n1. Start R-Studio\n2. Run the following code after editing the file paths:\n\n\n```R\nlibrary(devtools)\ninstall_github(\"GeoBosh/rbibutils\")\nlibrary(rbibutils)\nbibConvert(\"/Users/blaine/Documents/global.bib\", \"/Users/blaine/Documents/globalBiblatex.bib\", \"bibtex\", \"biblatex\")\n````\n\nOf course, flip the order of the arguments to convert from BibLaTeX to BibTeX.\n\n## Alternative bibliographic styles\n\nAlternatively, you can use the *IEEEannot.bst* bibliography style file that returns numbered entries in alphabetic order.\n\n## Annote fields with multiple paragraphs in BibTeX\n\nI have found no support for blank lines between paragraphs in the annotation stored  in the annote field of BibTeX entries.\nI wrap each paragraph in `\\par{\\noindent   .... }` to have the paragraphs printed in block format.\nI insert `\\vspace{10pt}` between paragraphs to generate a blank line between paragraphs.\nThe result is visually pleasing to me.\nSpace will flank display math, figures, code listings, and tables.\n\n## Annotation fields with multiple paragraphs in BibLaTeX\nYou may be using BibLaTeX if you use typst because typst does not support BibTeX.\nBibLaTeX uses different tools then BibTeX to generate the bibliography.\nIts tool `biber` converts blank lines into whitespace early in the processing of the bib file.\nYou can start new paragraphs separated by blank lines in an [imported tex file](https://tex.stackexchange.com/questions/488913/how-to-embed-a-review-in-biblatex) that stores a single annotation.\nHowever, the blank line will be lost in the exported PDF.\n\nYou can use the biblatex-chicago package, which has added support for [annotated bibliographies](https://tex.stackexchange.com/questions/183743/why-cant-i-get-annotations-in-the-bibliography-here/183917#183917).\nYou can add `\\par` after each paragraph to break the text into paragraphs, but there will be no spacing between paragraphs.\nThe result is visually displeasing to me.\n\u003cimg width=\"965\" alt=\"par\" src=\"https://github.com/user-attachments/assets/50e3c510-408a-4eac-89f8-fd8d158ce474\"\u003e\n\nA work around is to replace the `\\par` with display `$$ $$`. \nThis will give a wider than desired paragraph spacing, but it is better than no blank lines.\n\n\u003cimg width=\"970\" alt=\"emptyDisplayMath\" src=\"https://github.com/user-attachments/assets/68fef0c3-7691-4978-bea8-e07f8a145ab4\"\u003e\n\n\n## Colored annotations\n\nYou can color the annotation blue.\n\n- Load the *color* or *xcolor* package with the `\\usepackage{xcolor}` macro in the preamble of the *main.tex* file.\n- Add the macro `\\color{blue}` to the line in the `*.bst` file that describes the format of the *annote* field.\n\nYou could also print the annotation in bold or italics.\n\n## Support beyond text\n\nYour annotated bibliography can be spiced up:\nYou can include lists, display math, computer code blocks, figures, and tables in the *annote* fields.\n\n\n## Related projects of possible interest\n\n- [LaTeX manuscript template](https://github.com/MooersLab/manuscriptInLaTeX/edit/main/README.md)\n- [Writing log template](https://github.com/MooersLab/writingLogTemplate)\n- [Slideshow Template](https://github.com/MooersLab/slideshowTemplateLaTeX)\n- [Diary for 2022 in LaTeX](https://github.com/MooersLab/diary2022inLaTeX)\n- [Diary for 2023 in LaTeX](https://github.com/MooersLab/diary2023inLaTeX)\n- [latex-emacs profile](https://github.com/MooersLab/latex-emacs)\n- [snippets for latex-mode in Emacs](https://github.com/MooersLab/snippet-latex-mode)\n- [Quizzes about Emacs to improve recall of keybindings](https://github.com/MooersLab/qemacs)\n- [Slides from talk about LaTeX in Emacs at the Berlin Emacs Meetup Aug 31, 2022](https://github.com/MooersLab/BerlinEmacsAugust2022)\n- [Slides from talk about GhostText, Data Science Workshop, July 2022](https://github.com/MooersLab/DSW22ghosttext)\n- [Video link to talk about GhostText, Data Science Workshop, July 2022](https://mediasite.ouhsc.edu/Mediasite/Channel/python/watch/4da0872f028c4255ae12935655e911321d)\n- [The writer's law](https://github.com/MooersLab/thewriterslaw)\n\n## Version History\n\n|Version      | Changes                                               | Date            |\n|:------------|:------------------------------------------------------|:----------------|\n| Version 0.2 | Added Update table to README.md                       | 2024 April 7    |\n| Version 0.3 | Edit the README.md heavily.                           | 2024 April 17   |\n| Version 0.4 | Edit the README.md heavily.                           | 2024 October 8   |\n| Version 0.5 | Edit the README.md heavily.                           | 2024 October 16   |\n| Version 0.6 | Added running title to header of AnnoBib.tex.    | 2024 October 24   |\n\n\n## Sources of Funding\n\n- NIH: R01 CA242845\n- NIH: R01 AI088011\n- NIH: P30 CA225520 (PI: R. Mannel)\n- NIH P20GM103640 and P30GM145423 (PI: A. West)\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmooerslab%2Fannotatedbibliography","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmooerslab%2Fannotatedbibliography","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmooerslab%2Fannotatedbibliography/lists"}