Skip to content

MooersLab/modular-annotated-bibliography-biblatex-latex

Repository files navigation

Version License: MIT

Template for making an enhanced annotated and illustrated bibliography with BibLaTeX in LaTeX

What is this? Annotated bibliography on steroids

An annotated bibliography summarizes notes about papers being read during a research project. It is one of several methods for working with the knowledge gleaned from reading.

Screenshot 2024-10-24 at 1 40 36 PM

This modular form enables the reuse of entries in annotated bibliographies for related projects. It has the following enhanced features that the classic annotated bibliography lacks:

  • No longer restrained by the annotation field in BibLaTeX, which removes whitespace, including blank lines between paragraphs.
  • Modular entries for easy reuse in related projects.
  • Images.
  • Tables.
  • Equations.
  • Code blocks.
  • Hyperlinks: internal and external.
  • Bibliographic entries can be reordered for subgrouping by category.
  • Table of contents, hyperlinked to sections
  • Index of terms.
  • Bibliography includes papers cited outside those listed in the annotated bibliography.
  • List of acronyms used.
  • List of glossary terms used.
  • List of mathematical notation.

Screenshot 2024-10-24 at 1 41 09 PM

Why LaTeX

It is the gold standard for typesetting scientific documents. This template can be used on Overleaf. It can also be used collaboratively online in Overleaf.

Drag-and-Drop install instructions for Overleaf.com

This is the fastest way to explore the features of this template. The files in overleaf-biblatex-drag-n-drop.zip have been configured for running on Overleaf.

  1. Download the zipfile:overleaf-biblatex-drag-n-drop.zip`.
  2. Upload this zip file into a new project on Overleaf.

The file `mabib0573.tex will compile automatically to a PDF. The compile job will finish with one warning of no consequence.

Usage

  1. Create one tex file per reference in the bibNotes folder.

    • Use the supplied examples as templates.
    • Use the citekey from BibLaTeX as the name of the bibNote file.
    • Use a blank line between paragraphs.
    • Note that text-wrapping figures is easier than text-wrapping tables.
    • Skip text-wrapping if it is too tedious.
    • As you work, add
      • figures
      • tables
      • equations
      • URLs (including links to videos)
      • citekeys to references in and out of the annotated bibliography
      • index macros
      • acronyms
      • glossary terms
      • math notation
  2. Use the citekey as the argument of the \bibentry macro inside a new subsection heading. This will inject the bibliography entry upon export to PDF.

  3. You can cluster citations by topic and subtopic by using the section and subsection macros. You can lower the heading level to the subsubsection level for the bibliographic entry if you need the subsection heading for subgroups.

  4. The colored boxes indicate hyperlinks. Comment out the hypperref package in the preamble to disable.

  5. The \glsaddall command is used to print out the entire contents of a glossary file rather than only the entries that are used in the bibNote files.

  6. Compile to HTML to enjoy the output in your web browser.

  7. Compile to PDF to print and edit while traveling or otherwise away from the computer.

  8. Compiles locally with the full installation of texlive.

  9. Compiles in Textmate.app with the Option-R command.

Customization

  • Edit the title, author, and affiliation.
  • Edit the lines with the R, C, and L arguments in the preamble. These are the parts of the headline.
  • rename the imagesBlaine folder. Use a imagesOthers folder for images made by others.
  • Rename the tex files in bibNotes and change their content.
  • Replace mabib0573.bib with the file path to your global BibLaTex file for storing BibLaTex entries.

Status:

Ready to use and enjoy on Overleaf by drag and drop. I used pdfLaTeX version 2024 to compile. Access compiler selection under the Menu in the upper left.

Local use requires customization of the file paths.

  1. I store the above files in a subfolder of my project folder, which I store at the top level of my home directory for rapid access.
  2. I store the subfolders (bibNotes, imagesBlaine, and glossaries) in a global location (e.g. ~./) for easy access by other projects.

Bash Function to generate subfolder with required files

Edit the file paths as needed. Takes a project ID as the only argument. Assumes that the following folders are in you home directory:

  • bibNotes
  • glossaries
  • imagesBlaine

Customize the name of the last folder.

Run from the top level of your writing project directory. Upon reuse, delete the cp -R commands to avoid overwriting existing files.

function mabtex {
echo "Create a modular annotated bibliography (mab) subfolder and populate with required files with project number in the title."
if [ $# -lt 1 ]; then
  echo 1>&2 "$0: not enough arguments"
  echo "Usage1: mabibtex projectIndexNumber"
  return 2
elif [ $# -gt 1 ]; then
  echo 1>&2 "$0: too many projectIndexNumber"
  echo "Usage1: mabtex projectIndexNumber"
  return 2
fi
projectID="$1"
mkdir mab$1
cp ~/6112MooersLabGitHubLabRepos/modular-annotated-bibliography-biblatex-latex/compile.sh ./mab$1/.
cp ~/6112MooersLabGitHubLabRepos/modular-annotated-bibliography-biblatex-latex/apacannx.bst ./mab$1/.
cp ~/6112MooersLabGitHubLabRepos/modular-annotated-bibliography-biblatex-latex/mab0519.bib ./mab$1/mab$1.bib
cp ~/6112MooersLabGitHubLabRepos/modular-annotated-bibliography-biblatex-latex/mab0519.tex ./mab$1/mab$1.tex
cp -R ~/6112MooersLabGitHubLabRepos/modular-annotated-bibliography-biblatex-latex/glossaries/glossary.tex ~/glossaries/.
cp -R ~/6112MooersLabGitHubLabRepos/modular-annotated-bibliography-biblatex-latex/bibNotes ~/glossary/.
cp -R ~/6112MooersLabGitHubLabRepos/modular-annotated-bibliography-biblatex-latex/notation.tex ~/glossary/.
cp -R ~/6112MooersLabGitHubLabRepos/modular-annotated-bibliography-biblatex-latex/bibNotes/* ~/bibNotes/.
cp -R ~/6112MooersLabGitHubLabRepos/modular-annotated-bibliography-biblatex-latex/imagesBlaine/* ~/imagesBlaine/.
}

Coming soon

  • Variants for org-mde.

Sources of funding

  • NIH: R01 CA242845
  • NIH: R01 AI088011
  • NIH: P30 CA225520 (PI: R. Mannel)
  • NIH: P20 GM103640 and P30 GM145423 (PI: A. West)

Update history

Version Changes Date
0.1 Initial commit. 2024 October 24
0.2 Edited folder names in bash script to be consistent with the analogous Typst project. 2024 October 27

About

Illustrated and annotated bibliography made with BibLaTeX and LaTeX

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published