3 releases
| 0.0.2 | Aug 27, 2025 |
|---|---|
| 0.0.1 | Jul 14, 2025 |
| 0.0.0 | Apr 4, 2025 |
#2165 in Text processing
179 downloads per month
165KB
2K
SLoC
Contains (Zip file, 33KB) doc/to_UTF8, (Zip file, 31KB) doc/Accuracy, (Zip file, 32KB) doc/mapping
hebrew_accents
Managing Masoretic Hebrew Accents
Project Status
This project is currently in the design/development mode.
Current Version: v0.0.1.
Current feautures:
- fn contains_accent(SentenceContext, HebrewAccent) -> bool
Description
This crate will serve as a library for finding, filtering, and displaying Hebrew accents, specifically focusing on the Tiberian accent system as documented by the Masoretes.
Brief overview in the accents in the Tanach
The accents used in the Tanach have been (are) the subject of extensive scholarly research and discussion, with numerous books and articles written on the topic over the years. The system of accents employed in the Tanach is complex and nuanced, presenting a challenging area of study for scholars and researchers.
Several factors contribute to the complexity of Hebrew accents in the Tanach, including:
-
Accents have three roles at the same time:
- To indicate of stressed syllables, but not always.
- To indicate the syntactic relation in a sentence.
- Intonation of the words, used for singing the sentence.
-
In the Tanach, there are two main systems of accents used: one for the majority of the books, known as the "Twenty-One Books" (which includes all the books except for the three poetic books), and another for the three poetic books of Psalms, Proverbs, and Job, known as "Three Books".
-
Within the main system there are two major categories of Masoretic accents:
- Disjunctive accents
- Conjunctive accents
-
Disjunctive accents are ordered according their relative importance.
-
Disjunctive accents may be organized hiarchial groups.
- In the "Twenty-One Books," there are four groups of disjunctive accents, while the "Three Books" contain three groups.
-
The same (UTF-8) accent can be disjunctive in the "Twenty-One Books" and conjunctive in the "Three Books".
-
It is possible that one Unicode code-point can be mapped to different Hebrew accents.
Notes
-
Accents are sometimes referred to as Hebrew Cantilationmarks, taʿamei ha-mikra (טעמי המקרא) or teʿamim (טעמים).
-
Disjunctivesare sometimes referred to as pausal or domini -
Conjunctivesare sometimes referred to as non-pausal or servi
More details can be found in the references section at the end of this document
Goal
The main goal is to write a library that can be used to learn the Masoretic Hebrew accents.
Sub-goals:
- Identify Hebrew accents within the provided text.
- Offer the ability to filter specific accents.
- Offer an option to display only specific accents including all consonants.
- Supply statistical information regarding the usage of the accents.
Non-Goals
- Detect errors in the text related to accentuation rules.
- Determine the type of text based on the identified accents.
- Achieve absolute accuracy (100% correctness).
Examples
Usage contains_accent()
use hebrew_accents::SentenceContext;;
use hebrew_accents::Context;
use hebrew_accents::HebrewAccent;
use hebrew_accents::ProseAccent;
let newsc = SentenceContext::new("ויּ֣ר֖א עשׂ֔ו כּ֥י רע֖ות נ֣ות כּ֖נ֑ען בּעינ֖י יצח֥ק א֖בֽיו׃", Context::Prosaic,);
assert!(newsc.contains_accent(HebrewAccent::Prose(ProseAccent::Tiphcha)));
use hebrew_accents::SentenceContext;;
use hebrew_accents::Context;
use hebrew_accents::HebrewAccent;
use hebrew_accents::PoetryAccent;
let newsc = SentenceContext::new("יצחק אל־יע֓קב ׀ ויברך", Context::Poetic);
assert!(newsc.contains_accent(HebrewAccent::Poetry(PoetryAccent::ShalsheletGadol)));
Usage find_accent()
TODO
Releases
For an overview of released versions see releases.
How to install hebrew_accents
For installation see the hebrew_accents page at crates.io.
Safety
TODO
Panics
TODO
Errors
TODO
License
The hebrew_accents library is distributed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
References
-
Basics of Hebrew Accents, written by Mark D. Futato, Sr.
-
Hebrew Cantillation Marks And Their Encoding by Helmut Richter.
-
A treatise on the accentuation of the twenty-one so-called prose books of the Old Testament by Wickes
-
A treatise on the accentuation of the three so-called poetical books of the Old Testament by Wickes
-
The Syntax of Masoretic Accents in the Hebrew Bible by James D. Price, Ph.D.
-
Tabula Accentum of the "Biblia Hebraica Stuttgartensia".
-
Introduction to Tiberian Hebrew Accents an excerpt by Sung Jin Park.
-
The Masoretes and the Punctuation of Biblical Hebrew from the British & Foreign Bible Society
-
ACCENTS IN HEBREW by Max L. Margolis
-
The Masoretic Hebrew Accents in Translation and Interpretation by William D. Barrick
-
Hebrew_Cantillation (wikipedia)
Dependencies
~5MB
~103K SLoC