A streamlined, containerized web application to lint and validate BibLaTeX files.
This project is a modernized fork of Pezmc/BibLaTeX-Check. It has been refactored to run seamlessly in modern environments using Docker Compose and uv.
BibLaTeX Linter is part of a lineage of academic tools:
- Adapted from BibLaTeX-Check by Pezmc.
- Which was adapted from BibTex Check by Fabian Beck.
This version focuses on local developer experience and zero-configuration deployment.
The fastest way to get the linter running is using Docker. No Python installation is required on your host machine.
# 1. Clone and enter the directory
git clone https://github.com/your-repo/BibLaTeX-Linter.git
cd BibLaTeX-Linter
# 2. Start the application
docker compose upThe app will be live at http://localhost:8000/.
If you prefer to run it natively for development:
# Install dependencies
uv sync
# Run development server
uv run python manage.py runserverPaste the contents of your .bib file into the validator. The tool checks for:
- Missing required fields (year, journal, etc.) based on entry type.
- Non-unique IDs.
- Common formatting flaws (abbreviated journal titles, missing commas).
Basic configuration is handled via environment variables (see .env.example). For local Docker usage, the defaults are already configured in docker-compose.yml.
MIT License