/snolabib

Bibliography generator for SNOLA

Primary LanguagePythonApache License 2.0Apache-2.0

snolabib

A bibliography generator for SNOLA

Generates web bibliography from a set of DBLP entries in a json file.

The resulting webpage is by default self-contained. The default template includes js-powered, 0-dependency interactive filtering based on author, year, and venue, and some css to make it look better.

Relies on DBLP's well-curated bibtex and predictable behavior by citeproc-java to build correct webpages. Using less-consistent bibtex and/or a different bibtex-to-html engine will probably break functionality.

Requires:

Help

usage: snolabib.py [-h] [--mode MODE] [--authors_file AUTHORS_FILE] [--first_year FIRST_YEAR] [--last_year LAST_YEAR] [--citeproc_executable CITEPROC_EXECUTABLE]
                   [--html_file HTML_FILE] [--bib_file BIB_FILE] [--template_file TEMPLATE_FILE] [--output_file OUTPUT_FILE]

Download bibliography from a set of authors from DBLP and prepare it for inclusion in a website.

options:
  -h, --help            show this help message and exit
  --mode MODE           Step of processing: 'download', 'filter', 'generate_html', 'fix_html', or 'all' (default; executes all steps in order)
  --authors_file AUTHORS_FILE
                        A json file with a single object, where the keys (with no spaces) are used to name downloaded author bibliographies, and for each author
                        there is both a DBLP ID (either x/y, where both x and y are integers; or a/b, where a is a single letter and b is an actual name), and a
                        full name
  --first_year FIRST_YEAR
                        First year for filtered pubs (default: 2019)
  --last_year LAST_YEAR
                        Last year for filtered pubs (default: 2024)
  --citeproc_executable CITEPROC_EXECUTABLE
                        Full path to citeproc-java-tool executable; download from https://github.com/michel-kraemer/citeproc-
                        java/releases/download/2.0.0/citeproc-java-tool-2.0.0.zip
  --html_file HTML_FILE
                        An html-fragment file. Generated by 'generate_html', used by 'fix_html'
  --bib_file BIB_FILE   A bibtex bibliography, with a few additional fields; Generated by 'download', used by 'generate_html' and 'filter_html'
  --template_file TEMPLATE_FILE
                        Template html to use for output file (default: 'template.html'), used by 'fix_html'
  --output_file OUTPUT_FILE
                        Where to write the output html file generated by 'fix_html'