journals provides easy access to a selection of .bib files stored in the
TeX User Group bibliography archive.
First and foremost, the authors of journals would like to thank
Nelson H. F. Beebe for his tireless dedication to
archiving robust bibliographic information and
for being willing to extend his tools to journals outside of his domain.
Second, we encourage readers to peruse the
full and
fisheries research
archives kindly hosted by the
University of Utah's Department of Mathematics.
Where, journals is currently focused on information stored in the latter.
Clone the GitHub repository using
git clone https://github.com/nmfs-fish-tools/journals.git
and use your favorite text editor to view the bib files. You can also view a complete list of the fishery journals that are covered in fishery-journals.txt.
Roll the 🎲 and give journals a try 🤷.
🚫 writing your own .bib files or relying on a
reference management software to manage your bibliographic data.
journals lets you take the easy 🛣️ where you just have to learn the
syntax surrounding bibliography keys that is used within the archive.
🔑s or 🏷️s are created using strict rules using the biblabel software such that all keys are unique. For details see the documentation for biblabel.
In short, keys are created by pasting the following three strings together with colons.
- The first authors last name without apostrophes, etc.
- The four-digit year the reference was published.
- Captial letters representing the first letter of the first three important words in the title.
For example, the bib 🔑 for Scheffel et al. (2020) with a title of
"Coupling acoustic tracking with conventional tag returns to estimate mortality
for a coastal flatfish with high rates of emigration"
is Scheffel:2020:CAT.
{RefManageR} is a great package within R that can help search .bib files and generate citations and bibliographies. For example, a given .bib file can be read in and searched using
cjfas <- RefManageR::ReadBib(
file = file.path("inst", "bib", "canjfishaquatsci2020.bib")
)
scheffel2020 <- RefManageR::SearchBib(
x = cjfas,
doi = "cjfas-2018-0174"
)
# print the bib key
names(scheffel2020)
# [1] "Scheffel:2020:CAT"
# print a citation
RefManageR::AutoCite(scheffel2020, .opts = list(max.names = 3))
# [1] "(Scheffel, Hightower, Buckel, et al., 2020)"
# print a bibliography
RefManageR::PrintBibliography(scheffel2020)
More work needs to be done to make the formatting of the printed bibliography more in line with user needs but it is a start.
This repository is under active development with the following goals:
- Create an R package with tools for helping manage/search .bib files.
- Create vignettes that clearly outline how to use these .bib files.
- Document a pathway for using bib keys with roxygen2.