npm package: @gedeonix/hebrew
Description: Library of simple tools to support work on text in Hebrew (very early alpha)
Author: Przemysław Sołtan
Latest version: 0.0.6

# Gedeonix Hebrew Lib (transcription of Hebrew into Polish)

Library of simple tools to support work on text in Hebrew (very early alpha)

## Demos

 * Simple demo in ./public/interline.html file.
 ![demo screen](./public/images/interline.png)
 
 * Simple demo in ./public/keyboard.html file.
 ![demo screen](./public/images/demo.png)
 
## Test examples

### Tanah תנ״ך

    Unicode/XML Leningrad Codex - http://www.tanach.us/
    source XML: http://www.tanach.us/Books/Tanach.xml.zip

    Genesis 1:1 בראשית
    (Accents) בְּרֵאשִׁ֖ית בָּרָ֣א אֱלֹהִ֑ים אֵ֥ת הַשָּׁמַ֖יִם וְאֵ֥ת הָאָֽרֶץ׃
    (Vovels) בְּרֵאשִׁית בָּרָא אֱלֹהִים אֵת הַשָּׁמַיִם וְאֵת הָאָרֶץ׃
    (Consonants) בראשית ברא אלהים את השמים ואת הארץ
    (Morphology) בְּ/רֵאשִׁ֖ית בָּרָ֣א אֱלֹהִ֑ים אֵ֥ת הַ/שָּׁמַ֖יִם וְ/אֵ֥ת הָ/אָֽרֶץ׃

    Exodus 1:1 שמות
    (Accents) וְאֵ֗לֶּה שְׁמוֹת֙ בְּנֵ֣י יִשְׂרָאֵ֔ל הַבָּאִ֖ים מִצְרָ֑יְמָה אֵ֣ת יַעֲקֹ֔ב אִ֥ישׁ וּבֵית֖וֹ בָּֽאוּ׃
    (Vovels) וְאֵלֶּה שְׁמוֹת בְּנֵי יִשְׂרָאֵל הַבָּאִים מִצְרָיְמָה אֵת יַעֲקֹב אִישׁ וּבֵיתוֹ בָּאוּ׃
    (Consonants) ואלה שמות בני ישראל הבאים מצרימה את יעקב איש וביתו באו
    (Morphology) וְ/אֵ֗לֶּה שְׁמוֹת֙ בְּנֵ֣י יִשְׂרָאֵ֔ל הַ/בָּאִ֖ים מִצְרָ֑יְמָ/ה אֵ֣ת יַעֲקֹ֔ב אִ֥ישׁ וּ/בֵית֖/וֹ בָּֽאוּ׃

    Ezekiel 38:12
    (Accents) לִשְׁלֹ֥ל שָׁלָ֖ל וְלָבֹ֣ז בַּ֑ז לְהָשִׁ֨יב יָדְךָ֜ עַל־חֳרָב֣וֹת נוֹשָׁבֹ֗ת וְאֶל־עַם֙ מְאֻסָּ֣ף מִגּוֹיִ֔ם עֹשֶׂה֙ מִקְנֶ֣ה וְקִנְיָ֔ן יֹשְׁבֵ֖י עַל־טַבּ֥וּר הָאָֽרֶץ׃
    (Vovels) לִשְׁלֹל שָׁלָל וְלָבֹז בַּז לְהָשִׁיב יָדְךָ עַל־חֳרָבוֹת נוֹשָׁבֹת וְאֶל־עַם מְאֻסָּף מִגּוֹיִם עֹשֶׂה מִקְנֶה וְקִנְיָן יֹשְׁבֵי עַל־טַבּוּר הָאָרֶץ׃
    (Consonants) לשלל שלל ולבז בז להשיב ידך על חרבות נושבת ואל עם מאסף מגוים עשה מקנה וקנין ישבי על טבור הארץ
    (Morphology) לִ/שְׁלֹ֥ל שָׁלָ֖ל וְ/לָ/בֹ֣ז בַּ֑ז לְ/הָשִׁ֨יב יָדְ/ךָ֜ עַל־חֳרָב֣וֹת נוֹשָׁבֹ֗ת וְ/אֶל־עַם֙ מְאֻסָּ֣ף מִ/גּוֹיִ֔ם עֹשֶׂה֙ מִקְנֶ֣ה וְ/קִנְיָ֔ן יֹשְׁבֵ֖י עַל־טַבּ֥וּר הָ/אָֽרֶץ׃

    license: All biblical Hebrew text, in any format, may be viewed or copied without restriction. (version 26.0)

### Biblia Hebraica Stuttgartensia

    https://www.academic-bible.com/en/online-bibles/biblia-hebraica-stuttgartensia-bhs/read-the-bible-text

    Genesis 1:1
    בְּרֵאשִׁ֖ית בָּרָ֣א אֱלֹהִ֑ים אֵ֥ת הַשָּׁמַ֖יִם וְאֵ֥ת הָאָֽרֶץ׃

    Exodus 1:1
    וְאֵ֗לֶּה שְׁמֹות֙ בְּנֵ֣י יִשְׂרָאֵ֔ל הַבָּאִ֖ים מִצְרָ֑יְמָה אֵ֣ת יַעֲקֹ֔ב אִ֥ישׁ וּבֵיתֹ֖ו בָּֽאוּ׃

    Ezekiel 38:12
    לִשְׁלֹ֥ל שָׁלָ֖ל וְלָבֹ֣ז בַּ֑ז לְהָשִׁ֨יב יָדְךָ֜ עַל־חֳרָבֹ֣ות נֹושָׁבֹ֗ת וְאֶל־עַם֙ מְאֻסָּ֣ף מִגֹּויִ֔ם עֹשֶׂה֙ מִקְנֶ֣ה וְקִנְיָ֔ן יֹשְׁבֵ֖י עַל־טַבּ֥וּר הָאָֽרֶץ׃

    license: Biblia Hebraica Stuttgartensia, © 1977/1997 Deutsche Bibelgesellschaft

## Resource

### Unicode

- https://en.wikipedia.org/wiki/Unicode_and_HTML_for_the_Hebrew_alphabet
- https://en.wikipedia.org/wiki/Hebrew_diacritics

- http://unicode.org/charts/PDF/U0590.pdf
- Alphabetic Presentation Forms - http://unicode.org/charts/PDF/UFB00.pdf

- http://www.unicode.org/versions/Unicode13.0.0/UnicodeStandard-13.0.pdf
- CGJ - http://en.wikipedia.org/wiki/Combining_Grapheme_Joiner

### Transcript (pl)

- Transliteracja i transkrypcja alfabetu hebrajskiego - https://rbl.ptt.net.pl/index.php/RBL/article/view/480/510

### SBL Fonts
Fonts are not a direct part of the library, they were used only for the demo code.

The project (non-profit) uses fonts from www.sbl-site.org
under license
> Fonts SBL fonts are made available without cost to individual scholars for non-profit use.
>
> www.sbl-site.org/educational/biblicalfonts.aspx

- manual https://www.sbl-site.org/Fonts/SBLHebrewManualv1.5.pdf