Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add instructions to README for using cdl.bib as a common bibliography with TeXShop/TeX Live (MacOS) #58

Open
paxtonfitzpatrick opened this issue Oct 12, 2022 · 0 comments

Comments

@paxtonfitzpatrick
Copy link
Member

The common "MacTeX" TeX distribution for MacOS (which ContextLab/lab-manual links to and recommends) bundles TeX Live and some other tools, one of which is the TeXShop editor. TeXShop is generally great -- it has lots of useful features and makes working with LaTeX/BibTeX a lot easier, especially for beginners.

However, because Mac apps don't run internal commands in the user's shell environment, adding the CDL-bibliography repo to $BIBINPUTS doesn't make cdl.bib available to all projects when using TeXShop like it does if you compile from the command line.

TeX Live expects personal files to be placed in ~/Library/texmf/ and will prioritize any files there over the main texmf tree. So to make cdl.bib available to all projects:

  1. create the directory BibTeX checks for personal files (it doesn't exist unless manually created)
    • mkdir -p ~/Library/texmf/bibtex/bib
  2. symlink cdl.bib from your local CDL-bibliography repo into this folder
    • ln -s /Users/<username>/path/to/CDL-bibliography/cdl.bib /Users/<username>/Library/texmf/bibtex/bib/cdl.bib
    • Note: you must use absolute paths; relative paths or shortenings like ~ won't work

This method works for compiling from the command line as well, so setting $BIBINPUTS is actually not necessary. You can also place/link personal files in ~/Library/texmf/tex/latex or ~/Library/texmf/bibtex/bst/ rather than setting $BSTINPUTS or $TEXINPUTS, and this is actually the preferred/recommended method.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

1 participant