@texttree/translation-words-helpers NPM

About The Project

The library allows you to mark repeated words in TSV Translation Words Links and TSV OBS Translation Words Links from git.door43 in your app.

Purpose

mark repeated words in in TSV Translation Words Links and TSV OBS Translation Words Links for filtering

Problem

in some verses there a many repeated words

Scope

the library helps to mark and filter words for traslators in apps

Background

(back to top)

Built With

JavaScript
Webpack

(back to top)

Getting Started

Installation

Add the library to your app

yarn

yarn add @texttree/translation-words-helpers

npm install @texttree/translation-words-helpers

(back to top)

Usage

Example of usage

const { data } = await axios(
    'https://git.door43.org/unfoldingWord/en_obs-twl/raw/branch/master/twl_OBS.tsv'
  )
const json = tsvToJson(data)
const markedWords = markRepeatedWords(json)

json will have this structure:

[
  {
    Reference: '1:1',
    ID: 'aoaa',
    Tags: 'keyterm',
    OrigWords: 'God',
    Occurrence: '1',
    TWLink: 'rc://*/tw/dict/bible/kt/god'
  },...
]

and markedWords:

[
  {
    Reference: '1:1',
    ID: 'aoaa',
    Tags: 'keyterm',
    OrigWords: 'God',
    Occurrence: '1',
    TWLink: 'rc://*/tw/dict/bible/kt/god',
    isRepeatedInVerse: false
  },

At default this function add mark just in verse, but you can change it if you add type ('chapter', 'book', 'all'). For example:

const markedWords = markRepeatedWords(json, 'all')

returns

[...
  {
    Reference: '4:4',
    ID: 'o16m',
    Tags: 'keyterm',
    OrigWords: 'bless',
    Occurrence: '1',
    TWLink: 'rc://*/tw/dict/bible/kt/bless',
    isRepeatedInVerse: false,
    isRepeatedInChapter: false,
    isRepeatedInBook: true
  },...
]

More examples you can get from tests.

(back to top)

Roadmap

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated. Guidelines for external contributions.

You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

If you would like to fork the repo and create a pull request.