grzegorz

grzegorz is a linguistics tool which primarily concerns minimal pairs. For a detailed history of the project's development, check the Changelog

Overview

NOTE: throughout the documentation, "IPA" is used as an abbreviation for International Phonetic Alphabet transcription.

• What are minimal pairs?
• Usage manual, contains brief technical descriptions of everything
• Quickshot phonological parsing
• Getting a decently-sized wordlist
• Fetching International Phonetic Alphabet spellings
• Finding minimal pairs with the help of the generator
• Creating an Anki deck and importing it into the app
• The convenient fullmake command

Getting started

Requirements

• python3
• pip

Installation

Make sure the pip installation directory (default: ${HOME}/.local/bin) is on your ${PATH}. If not, add it (to your .bashrc or .zshrc preferably):

export PATH="${HOME}/.local/bin:${PATH}"

From PyPi

$ pip install grzegorz

From source

Clone this repository and run pip:

$ git clone https://github.com/xylous/grzegorz grzegorz
$ cd grzegorz
$ pip install .

Usage

Check the "overview" section

Roadmap

• fetch a wordlist of most used words in a given language
• fetch the International Phonetic Alphabet spelling for a given wordlist
• generate minimal pairs
  • look for phoneme differences
    • optimise: look for interesting differences
    • optimise: ignore stressed syllables
  • look for chroneme differences
  • look for syllable stress differences
• Anki integration
  • create Anki flashcards from the generated minimal pairs
  • export a deck containing the created flashcards
  • add audio pronunciations for every flashcard
• print phonetical analysis of a word:
  • given its IPA
  • given its language
• check if two words form a minimal pair, given their IPAs
• search and print the IPA of a word in a given language (on the English Wiktionary)
• minimise side effects of functions, delegate commands to wrappers around class functions
• documentation
  • technical docs for usage as a binary
  • "tutorial" for usage as a binary
  • technical docs for usage as a library
  • "tutorial" for usage as a library

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

But, honestly, the greatest contribution you can make is to add International Phonetic Alphabet (IPA) spellings to words on the English Wiktionary, which is the source for all the spellings that grzegorz uses. The more IPA spellings there are, the higher the number of words that can be used, the more possibilities for minimal pairs.

License

GPLv3