TypeScript/React library for Pashto inflection, verb conjugation, phrase generation, text conversion, and more
Go to file
adueck 1295ff05cf fix ci 2024-08-06 17:39:59 -04:00
.github/workflows fix ci 2024-08-06 17:39:59 -04:00
.vscode mostly done plural recognition 2023-08-01 18:49:11 +04:00
diagrams more work on parser and fixed some verb conjugation bugs 2023-08-30 17:32:54 +04:00
public robots.txt 2023-08-18 20:17:46 +04:00
src fix issues with verbConjugation failing by assuming that we would get simple verb conjugation results 2024-08-06 17:26:06 -04:00
vocab error handling for verbs erroring on render 2024-08-06 14:03:56 -04:00
.env plural from for words like قاضۍ 2024-07-08 13:28:30 -04:00
.gitignore fix 2022-10-09 10:58:28 +05:00
.npmrc bump 2021-03-16 11:58:53 +04:00
.nvmrc add nvmrc 2022-10-09 11:02:14 +05:00
LICENSE switch to GPLv3 license 2022-11-05 16:29:31 +05:00
README.md center diagram 2023-08-21 14:31:43 +04:00
check-all-inflections.ts fix issues with verbConjugation failing by assuming that we would get simple verb conjugation results 2024-08-06 17:26:06 -04:00
dev try nix for ci 2023-11-29 11:18:47 +04:00
get-words.js fix ci 2024-08-06 17:39:59 -04:00
netlify.toml fixed test issue 2023-08-22 23:22:40 +04:00
package.json fix ci 2024-08-06 17:39:59 -04:00
shell.nix try nix for ci 2023-11-29 11:18:47 +04:00
test.http cleanup 2023-07-27 17:07:59 +04:00
tsconfig.json more towards parsing vps 2023-08-09 16:04:36 +04:00
yarn.lock fix ci 2024-08-06 17:39:59 -04:00

README.md

pashto-inflector

License: GPL v3 Netlify Status build build

A pashto inflection, verb conjugation, and phrase-generation engine, as well as functions and components for modifying and displaying Pashto text.

Pashto Inflector Website/Demo

How it works

This library uses a 3-step process to generate gramattically correct Pashto phrases. This 3-step process corresponds directly to Chomsky's tripartrite structure for tranformational generative grammars.

Pashto Inflector Function Chomskian Grammar Level
1. Assemble the phrase tree Phrase Structure Rules
2. Inflect the words in tree Morphophonemic Rules
3. Arrange the inflected words in order Transformational Rules

1. Assemble the phrase tree

Phrase Structure Rules

An abstract syntax tree is created with the various parts of a phrase represented as dictionary entries of the words as well as information about gender, number, and tense, etc. These are arranged in typed structures that allow for arranging NP and APs into verbal or equative phrases.

2. Inflect all the words in the phrase tree

Morphophonemic Rules

The dictionary entries for the words are inflected and conjugated as necessary.

3. Arrange the inflected words

Transformational Rules

The inflected words are arranged into possible phrases with various options for dropping or encliticizing pronouns, and placing the negation particle in the correct place(s).

Phrase building process

  • The full process of phrase building

Distributions

This is published on a private NPM proxy registry as two libraries:

  • @lingdocs/inflect
    • /src/lib
    • The core inflection engine with grammatical information and tools for processing LingDocs dictionary entries and Pashto text.
    • Can be used with Node 16, as CommonJS
  • @lingdocs/ps-react
    • /src/components
    • @lingdocs/inflect plus react components for displaying Pashto text, phrase engine UI etc.
    • Only available as an ES6 Module

@lingdocs/pashto-inflector is deprecated. Use @lingdocs/inflect or @lingdocs/ps-react instead.

Development

The Pashto Verb Explorer website can be used to view and play with the verb conjugations and various components.

cd src/components
yarn install
cd ../lib
yarn install
cd ../..
yarn install
yarn start

Building

⚠ Don't use yarn build. Use one of the commands below: ⚠

Website

To build the Pashto Verb Explorer website:

yarn build-website

This outputs a site at /build

Libraries

To build the @lingdocs/inflet and @lingdocs/ps-react libraries ready for publishing to NPM:

yarn build-library