# Education & Publishing

Part of the HebrewCore documentation. Web: https://hc.itsbaba.com/docs#solution-education · Whole docs: https://hc.itsbaba.com/docs.md · Index: https://hc.itsbaba.com/llms.txt

Language-learning apps, children's books, readers and audio, where vowel points, transliteration and the learner's gender matter as much as the translation.

## What to Use

| Need | Use |
| --- | --- |
| Vocalized text for readers and speech | `/v1/nikud`, checked so no letter changes. |
| A reading in Latin letters | `transliterate: true` on `/v1/translate`, or `/v1/transliterate`. |
| Addressing the learner | `listener_gender` on protected translation (`סיימת`, `ты закончила`). |
| Search across vocalized text | `/v1/strip-nikud` to build search keys. |
| Course interface strings | The [App Localization](https://hc.itsbaba.com/docs#solution-localization) setup. |

## Example

```http
POST /v1/nikud
{ "text": "הילדים קוראים ספר בספרייה" }

{ "text": "הילדים קוראים ספר בספרייה", "nikud": "הַיְלָדִים קוֹרְאִים סֵפֶר בַּסִּפְרִיָּה", "verified": true }

POST /v1/translate
{ "text": "The children are reading a book in the library.", "target_lang": "he", "transliterate": true }

→ "text": "הילדים קוראים ספר בספרייה.", "transliteration": "Hayeladim kor'im sefer basifriya."
```

## Pitfalls

- **Unverified nikud.** When `verified` is false, `nikud` is your text unchanged. Show or speak the plain text.
- **Transliteration scheme.** The scheme is a general reading aid, not an academic standard. Keep that in mind for citations.
- **Mixed search.** Index both the plain and the vocalized form, or strip nikud from queries and documents alike.