Library for morphemes higlighting specializing in Russian language. Inspired by kityan/morfana library
| Command | Description |
|---|---|
| build | build es and generate types |
| build:es | build es |
| build:types | build types |
| coverage | check test coverage |
| lint | lint code with eslint |
| start | run docs for developing |
| storybook | run storybook for developing |
| build-storybook | build docs |
| test | run tests |
| type-check | check typings |
| type-check:watch | start ts server in watch mode |
| Markdown prefix | Morpheme |
|---|---|
| pr | prefix |
| su | suffix |
| po | postfix |
| ro | root |
| en | ending |
| st | stem |
Word description looks like this:
ro:0-5;en:6-8;st:1-5;Config has a variety of options for customisation. Replace letter or morpheme wrapper to ad interactivity.
| Parameter | Type | Description |
|---|---|---|
| strokeWidth | number | Morpheme view stroke width (px) |
| strokeColor | string | Morpheme view stroke color |
| markupItemsDelimeter | string | Markup items delimeter |
| markupKeyValDelimeter | string | Markup key/value delimeter |
| markupRangeDelimeter | string | Markup range start/end delimeter |
| zeroEndingSymbol | string | Zero ending symbol |
| letterHeight | number | Letter component height (px) |
| letterWidth | number | Letter component width (px) |
| morphemeSpacing | number | Morphemes horisontal spacing (px) |
| morphemeHeightRatio | number | 0-1 Morphemes root node height ratio. Adjusts morhemes paths heihgt |
| letterComponent | FC<LetterProps> |
Custom Letter component |
| morphemeWrapperComponent | FC<MorphemeWrapperProps> |
Custom morpheme wrapper component |
| morphemesViewsMap | MorphemesViews | Custom morpheme views component map |
| morphemesTypesMap | MorphemesTypes | Custom morpheme types map (used in markup) |
| errorsLogLevel | ErrorsLogLevel | Errors log level |
| logger | Logger | Logger with 3 methods: info, warn, error |
Morfana's class methods
| Method | Description |
|---|---|
| setConfig | Set instance config |
| getConfig | Get instance config |
| log | Log error or other message (according to current log level) |
| validateMarkup | Check validity of markup elements string e.g. "ro:1-5", return valid values |
| parseMarkup | Parse markup string e.g. "ro:1-5;en:6-8;st:1-5;" into array "ro:1-5", "en:6-8", "st:1-5" |
| getMarkupData | Prepare markup data, e.g. from array of 'ro:1-5' to array of { type: 'ro', range: [1, 5] } |
| prepareWord | Prepare word for parsing (add zero ending symbol) |
| getSymbolsMap | Get symbols map with morhpemes data |
| process | Process markup and word to get symbols map and markup data for the markup display |
| getMarkupFromMarkupData | Get markup string from markupData |
Component renders word and morphemes based on the markup string. Uses Word as a view component.
Component that renders word and morphemes based on symbols map and markup data.
Component that renders symbol in a box of certain configured dimentions. Can be replaced in config in order to add styles or functionality.
Component that renders morpheme. Can be replaced in config in order to add styles or functionality.
Component that wraps morpheme.
It is recomended to use monospace font in order to avoid akward letter spacing.