Skip to content

A comand-line phonetics tool for finding minimal pairs

License

Notifications You must be signed in to change notification settings

xylous/grzegorz

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

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