How acl-org/aclpubcheck works
ACL pubcheck is a Python tool for checking ACL paper PDFs and reporting formatting and citation issues. The main workflow is a user invoking the CLI with a paper and paper type; the formatter checks page margins, numbering, fonts, and references, then writes a JSON report and margin-annotated page images. Citation name checking is an integrated branch that uses external bibliography services. The repository also includes publication-chair utilities for validating PDF metadata against submission spreadsheets and optionally posting problems to Google Sheets, plus a utility for producing copyright-signature summaries. Some subsystem links are based on README documentation because their source was not sampled.
Main entry points: formatchecker.py PDF formatter · name_check.py Citation name check · metadatachecker.py Metadata checker · copyright_signatures.py Signature summary
Components 19
Paper checking
- CLI entry
aclpubcheck/__main__.py - PDF formatter
aclpubcheck/formatchecker.py - Margin check
aclpubcheck/formatchecker.py - Page and font checks
aclpubcheck/formatchecker.py - Reference checks
aclpubcheck/formatchecker.py
Citation checking
- Citation name check
aclpubcheck/name_check.py - Scholarcy API
- rebiber
- ACL Anthology, DBLP, arXiv
Publication-chair tools
- Metadata checker
aclpubcheck/metadatachecker.py - Submission data
- Google Sheets client
aclpubcheck/googletools.py - Google Sheets
- Signature summary
aclpubcheck/copyright_signatures.py
Reports and outputs
- JSON report
- Annotated page images
- Signature text file
Other components
- Paper author
- Publication chair
Connections 18
- Paper author → CLI entry: runs check
README.md - CLI entry → PDF formatter: invokes
aclpubcheck/__main__.py - PDF formatter → Margin check: checks margins
aclpubcheck/formatchecker.py - PDF formatter → Page and font checks: checks pages and fonts
aclpubcheck/formatchecker.py - PDF formatter → Reference checks: checks references
aclpubcheck/formatchecker.py - PDF formatter → Citation name check: runs name check
aclpubcheck/formatchecker.py - Citation name check → Scholarcy API: extracts bibliography
aclpubcheck/name_check.py - Citation name check → rebiber: updates bibliography
aclpubcheck/name_check.py - rebiber → ACL Anthology, DBLP, arXiv: looks up records
- PDF formatter → JSON report: writes report
README.md - PDF formatter → Annotated page images: writes annotations
README.md - Publication chair → Metadata checker: runs validation
aclpubcheck/metadatachecker.py - Submission data → Metadata checker: provides spreadsheet and PDFs
aclpubcheck/metadatachecker.py - Metadata checker → Google Sheets client: requests Sheets client
aclpubcheck/metadatachecker.py - Google Sheets client → Google Sheets: builds API client
aclpubcheck/googletools.py - Publication chair → Signature summary: runs export
aclpubcheck/copyright_signatures.py - Submission data → Signature summary: provides submissions
aclpubcheck/copyright_signatures.py - Signature summary → Signature text file: writes summary
aclpubcheck/copyright_signatures.py