awg-utils

A repo for utility scripts of the Anton Webern Gesamtausgabe.

---

Virtual Environments

Activating a Virtual Environment

1. Navigate to the target folder:

cd /d/Repositories/webern-unibas-ch/awg-utils/compare_pdfs

2. Create a virtual environment:

python -m venv .venv

3. Activate the virtual environment:

source .venv/Scripts/activate

Note

Only for Devs: To create (or update) dependency files, install pip-tools via python -m pip install pip-tools

Then create/update the requirements.txt file via pip-compile --generate-hashes --strip-extras requirements.in

4. Install the dependencies:

pip install -r requirements.txt --require-hashes

Deactivating a Virtual Environment

To deactivate the currently active virtual environment, simply run:

deactivate

[SCRIPT]: convert_intro_to_md

The python script in this folder converts an AWG intro JSON file (with HTML block content) to Markdown, producing one output file per locale.

See HOW TO ... convert an AWG intro JSON to Markdown?

[SCRIPT]: convert_source_description

The python script in this folder converts a source description given in Word format from .docx to .json.

See HOW TO ... convert source-descriptions from WORD to JSON?

[SCRIPT]: compare_pdfs

The python script in this folder compares the pages of two pdfs and highlights any diffs.

See HOW TO ... compare two PDF files and highlight differences?

[SCRIPT]: unify_ids

The python scripts in this folder unify SVG group IDs for TKK and link-box elements across JSON textcritics and SVG files.

See HOW TO ... unify IDs in SVG and JSON files?

Repository structure