journals

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.

Installation

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.

Use

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.

Bibliography keys

🔑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.

1. The first authors last name without apostrophes, etc.
2. The four-digit year the reference was published.
3. 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}

{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.

Future

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.