Morfana
Library for morphemes higlighting specializing in Russian language. Inspired by kityan/morfana library
Commands
| 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 |
Syntax
| 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;Customisation
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 |
Methods
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 |
Components
MarkedWord
Component renders word and morphemes based on the markup string. Uses Word as a view component.
Word
Component that renders word and morphemes based on symbols map and markup data.
Letter
Component that renders symbol in a box of certain configured dimentions. Can be replaced in config in order to add styles or functionality.
Morpheme
Component that renders morpheme. Can be replaced in config in order to add styles or functionality.
MorphemeWrapper
Component that wraps morpheme.
Recomendations
It is recomended to use monospace font in order to avoid akward letter spacing.