AzeLexicon – Azerbaijani Word List & Terminology

AzeLexicon is a structured, open-source repository of Azerbaijani words and terminology. Its main purpose is to serve as the primary source for the Azerbaijani word list, its hyphenated version, and academic/scientific terminology, supporting anyone producing academic or scientific work in Azerbaijani.

📚 Project Scope

The repository includes:

• General word list
  A plain list of Azerbaijani words (txt format). It contains only words, without translations. Some cleanup and refinement are still needed.

• Hyphenated words
  A hyphenated version of the general word list. This list is not yet complete, as the hyphenation algorithm is under active development.

• Academic and scientific terminology
  Organized by subject (mathematics, physics, computer science, etc.). Each subject has a main file (terms.json) containing the translations of English terms into Azerbaijani. Subfields (e.g., linear algebra, probability) are used for initial collection of terms, which are then consolidated into the main terms.json.

This project aims to be the authoritative reference for Azerbaijani in scientific and academic contexts.

Repository Structure

AzeLexicon/
├── data/
│ ├── general/
│ │ ├── words.txt # Plain list of Azerbaijani words (no translations)
│ │ └── words-hyphenated.txt # Hyphenated version of the general word list
│ │
│ ├── scripts/
│ │ ├── generate_markdown.py # Generates Markdown glossaries from terms.json
│ │ └── hyphenation.py # Experimental hyphenation algorithm
│ │
│ └── subjects/
│ ├── math/
│ │ ├── terms.json # Glossary of math terms (EN ↔ AZ)
│ │ ├── math_terms.txt # Consolidated list of all English math terms
│ │ ├── categories/ # Subfield-specific English terms
│ │ │ ├── linalg.txt # Linear Algebra terms
│ │ │ ├── prob.txt # Probability terms
│ │ │ └── ... # More subfields can be added here
│ │ └── scripts/
│ │ └── process_subject.py # Script to process, validate, and sort terms
│ │
│ └── ... # Other subjects (physics, chemistry, biology, etc.)
│
├── glossary/
│ ├── math.md # Generated Markdown glossary from terms.json
│ └── ... # Glossaries for other subjects
│
├── .github/workflows/
│ └── sort-validate.yml # Automated Term Standardization workflow
│
├── LICENSE
├── README.md
├── CONTRIBUTING.md
├── CODE_OF_CONDUCT.md
└── CONTRIBUTORS.md # List of contributors and maintainers

⚙️ Automation

To maintain consistency and quality across the repository, all terms.json files are automatically sorted alphabetically and checked for duplicates by the 🛠 Automated Term Standardization workflow (sort-validate.yml). Contributors are expected to update the status for each term they are contributing in the JSON file. The workflow automatically flags missing translations with ❌ Missing, so there is no need to add this manually.

Valid statuses are:

• ❌ Missing – automatically flagged by the workflow for missing translations.
• ⚠️ Revision – use this if the translation needs review or you are unsure.
• ✅ Complete – use this if the translation is verified and fully correct.

The workflow can be triggered manually in the GitHub Actions tab.

Caution

Before submitting a pull request (PR), ensure that the 🛠 Automated Term Standardization workflow completes successfully. For guidance on when to run the workflow, please refer to the wiki section describing the appropriate cases. Additionally, make sure that the status of each contributed term is updated correctly.