bib2qr

A LaTeX package for citing BibTeX entries with QR codes.

The bib2qr package provides functionality to cite BibTeX entries with QR codes for easy sharing and referencing. The target of the QR code is the entry's DOI, or URL if no DOI exists. A citation generated via \qrfullcite, which is part of bib2qr, might look as follows:

Installation

Skip this section, if bib2qr is already provided in your TeX distribution. You should be able to install it from the CTAN via your distribution's utility (e.g. the TeX Live Utility).

Manual installation

You can get the package's source code from the project repository on Codeberg. The repository contains a build script, which allows you to build the required files for the bib2qr package and copy them into your TeX Directory Structure (TDS) using l3build. Ensure that l3build is installed on your system and run it from the repository's root directory as follows:

l3build install --full

The --full option ensures that all necessary files are built and installed.

If you do not want to install the package into your TDS, but use it in a particular LaTeX project, follow the steps listed below.

1. unpack bib2qr.sty from the bib2qr.dtx file
   • using l3build and the build.lua script: l3build unpack, or
   • directly via the installer file: pdflatex bib2qr.ins
2. copy the extracted bib2qr.sty file into the same directory as your LaTeX sources.

Usage

Please consult the package documentation for detailed usage information.

If you have any questions or need assistance, feel free to open an issue on the repository.

Changes

All notable changes to this project are documented in the file CHANGELOG.md.

Contributing

Contributions to the bib2qr package are very welcomed. Feel free to submit a pull request, if you would like to contribute to the project. In case you are unfamiliar with the process, consult the forgejo documentation and follow the steps using this repository instead of the example repository.

Create your pull request (PR) to inform that you start working on a contribution. Provide a clear description of your envisaged changes and the motivation behind them, prefix the PR's title with WIP: until your changes are finalised.

All kind of contributions are appreciated, whether they are bug fixes, new features, or improvements to the documentation.

Contributors

• Christian Schreinemachers
• Markus Kohm

This package was created and is maintained by Christian Schreinemachers, (C) 2024.