How etcbc/bhsa works
Project type and purpose
• This is an open-source data-centric toolset and repository (“bhsa”) that provides the Hebrew Bible with linguistic annotations in the Text-Fabric format.
• It bundles:
– A data storage layer of multiple versions of the BHSA data (MQL files, Text-Fabric feature files, YAML config)
– A data processing layer (Python programs and Jupyter notebooks) to generate, analyze, and transform the data
– A minimal web application (static search interface and a small Flask-style app)
– Extensive documentation and tutorials
File structure
• Top-level “storage” directories:
– source/ (raw ETCBC MQL exports)
– tf/ (Text-Fabric feature tables per version)
– shebanq/ (intermediate SQL dumps for the SHEBANQ site)
– yaml/ (configuration schemas for features)
• Data processing:
– programs/ (Python scripts + notebooks)
– primer/ (utility module + example notebooks)
– ner/ (named-entity config and sheets)
• Application layer:
– app/app.py (entry point of the static search server)
– app/config.yaml (app configuration)
– app/static/ (HTML/CSS/JS for browser UI)
• Documentation layer:
– docs/ + mkdocs.yml (feature docs, reference PDFs)
– tutorial/ (Jupyter notebooks illustrating TF API usage)
• UI prototypes:
– ui/ (example Python UI layouts)
README for additional insights
• Describes usage via the Text-Fabric library (tf.app.use) and the static web interface (“bhsa-search”).
• Mentions external dependencies: Text-Fabric and Python environment, Jupyter for notebooks.