@gentbajko/slopify 4.1.0 → 4.3.0

package/dist/tutorials/Narration-Aliases-and-Glossary.md

@@ -1,8 +1,55 @@
 # Narration Aliases and Glossary
 
-Two tools control how the narrator says words without changing what is written. **Narration aliases** swap a written form for a spoken one, such as `Dr.` said as "Doctor", with any generated voice. The **Pronunciation Glossary** gives exact IPA pronunciations for names, such as `Arda: /ˈɑɹdə/`, with Inworld's TTS-2 voices. In both cases the article, the transcript and the captions keep the written words; only the audio changes.
+Three tools control how the narrator says words without changing what is written. **Name pronunciations** is your own list of names with their IPA, used before anything an article says, so a name sounds the same in every video. **Narration aliases** swap a written form for a spoken one, such as `Dr.` said as "Doctor", with any generated voice. The **Pronunciation Glossary** is the list each article writes for itself, such as `Arda: /ˈɑɹdə/`. IPA is read by Inworld's TTS-2 voices; aliases work with every voice. In all three the article, the transcript and the captions keep the written words; only the audio changes.
 
-**Where to find it:** aliases in **Settings → Voices → Pronunciation**. Both switches are on Create under **Narration → Change → More narration settings**, and in a project's **Edit settings** → **Narration**. A project's glossary is shown on its **Article** section, in the **Pronunciation** tab.
+**Where to find it:** your list in **Settings → Voices → Name pronunciations**, aliases in **Settings → Voices → Pronunciation**. The switches are on Create under **Narration → Change → More narration settings**, and in a project's **Edit settings** → **Narration**. A project's own glossary is shown on its **Article** section, in the **Pronunciation** tab.
+
+## Name pronunciations
+
+Your list settles a name once. Every project copies it when it starts, and its entries come **before** the glossary that project's article wrote, so the name is said your way whatever the article spelled out.
+
+1. Open **Settings → Voices → Name pronunciations**.
+2. Write one `Term: /IPA/` per line, in standard-English IPA between slashes:
+
+```
+Gygax: /ˈɡaɪɡæks/
+Faerûn: /feɪˈruːn/
+Mordenkainen: /ˌmɔːrdənˈkeɪnən/
+```
+
+3. Press **Save pronunciations**. The line under the box says how many names the list pronounces, and a note names any line narration has to skip, by its number and reason, the way the article's glossary does.
+
+- One IPA word per written word. A hyphenated name's parts each get one.
+- A possessive follows its name: `Gygax's` is said from the `Gygax` entry.
+- A dash, `n/a` or nothing leaves the name read as written: useful for a name you want plain.
+- Up to 100,000 characters, which is thousands of names.
+- Only Inworld **TTS-2** and **TTS-2 Flash** read IPA. For any other voice, use an alias instead.
+- **Use pronunciations** must be on for the project (the default) — the same switch that reads the article's glossary.
+
+A project keeps the copy it started with. Editing the list later changes new projects only, until you open a project's **Edit settings** → **Narration** and press **Copy the list again** under **Use pronunciations**; only the narration where a changed name appears is made again.
+
+### Two people, or an agent, at the same list
+
+The whole list is saved at once, so Slopify makes sure one save never quietly replaces another. Every save carries the version of the list it was made from. If something else saved meanwhile — a second window, or an agent — the save is refused and the page says so:
+
+> **The list changed somewhere else.** An agent saved it: it has 3 names you don't have, 1 said differently.
+
+Nothing is lost. What you typed stays in the box, and you choose:
+
+- **Save mine anyway** keeps what is on screen, over theirs.
+- **Load theirs instead** puts their list in the box, so you can add your change to it and save.
+
+An agent gets the same refusal as a sentence, with the list as it stands: it reads the version, folds its change into that text, and saves again (`get_library_pronunciations`, then `set_library_pronunciations` with `{text, version}`).
+
+### Which list wins
+
+| Where a pronunciation comes from | Order |
+|---|---|
+| **Name pronunciations** (your list) | First: it wins everywhere |
+| The article's own **Pronunciation Glossary** | Next, for names your list does not have |
+| **Other projects' pronunciations**, while shared | Last, for names neither of the above has |
+
+An alias beats all three, because it changes the words before the sounds are decided.
 
 ## Narration aliases
 
@@ -39,7 +86,7 @@ Each row's title line sums it up, for example "Says Dr. as Doctor · whole word"
 - Two aliases can't share a written form.
 - Where two overlap in the text, the one starting first wins, then the longer.
 - A multi-word alias is read with single spaces around it: "Grey et al. wrote" goes to the voice as "Grey and others wrote".
-- An alias wins over a Pronunciation Glossary entry for the same words.
+- An alias wins over a Name pronunciations entry and a Pronunciation Glossary entry for the same words.
 - Aliases work with every generated voice, and in multi-voice runs they apply to each speaker's turn.
 - Aliases also change the sentences **Narration preparation** reads, so its cues match what is said.
 
@@ -87,7 +134,7 @@ A table with `Term | IPA` columns works too. If you paste your own article, add
 ### Turn it on
 
 1. On Create, open **Narration → Change → More narration settings**.
-2. Keep **Use the article's pronunciation glossary** on (the default). It shows only while the voice is one that reads it.
+2. Keep **Use pronunciations** on (the default). It shows only while the voice is one that reads IPA, and it covers both your Name pronunciations and this article's glossary.
 3. Optional: keep **Also use pronunciations from my other projects** on (the default). It adds every term from your other projects' glossaries, copied when this project starts. This project's own glossary wins where they differ. Turn it off to use only this article's glossary.
 
 ### Entries that are skipped
@@ -104,21 +151,64 @@ An entry narration can't use is skipped and read as ordinary text. It never bloc
 
 To fix skipped entries, edit the Pronunciation Glossary at the end of the article in **Edit settings** → **Article**, then save. See [Editing a project](Editing-a-Project).
 
-## Aliases or glossary?
+## Does this video say the names right?
+
+Two checks on the project page answer that from files the project already has. Neither one blocks the run or the upload, neither costs anything, and neither changes a thing.
+
+### Before the narration is paid for
+
+The **Narration** section says, in one line, which names this article uses that nothing pronounces: not its own Pronunciation Glossary, not your **Name pronunciations** list, not the pooled copy of the other projects' glossaries. **Every mention** opens the table — each name, how often it is said as written and how often as a possessive, proper names first.
+
+This is the cheapest moment to settle a name, because adding it to **Name pronunciations** costs nothing and the voice has not been paid yet.
+
+It also catches the names a glossary looks like it covers and doesn't:
+
+| What the glossary has | What the article says | Why the voice guesses |
+|---|---|---|
+| `Belwar Dissengulp` | "Belwar" on its own | A two-word term never matches one of its words said alone. |
+| `Drizzt` | "Drizzt's" | A project narrated under the old pronunciation rules wrapped no possessive. |
+| `Catti-brie` | "Catti-brie" | The old rules skipped a hyphenated term, so it was read as ordinary text. |
+
+A project is judged by the rules it was voiced under, so a video made before those rules changed is told what actually happened to it, not what would happen today.
+
+### After the render, before the upload
+
+The **YouTube** section carries the same line, saying two things.
+
+**What the voice was sent.** Counted from the voice script itself, which is exactly the text the voice received: a name with no IPA in front of it there was guessed, whatever the glossary says.
+
+**How each name was heard.** Read from the per-word confidence the subtitle timing already wrote when the captions were made: each name's mean, and the spread across its mentions. Nothing is listened to again and nothing is re-aligned.
+
+The spread is the signal, not a low score. A rare name is heard poorly even when it is said perfectly, so only a name whose own mentions disagree with each other is flagged: eight mentions or more, and a spread of 0.30 or more between its 10th and 90th percentile.
+
+**What came out.** The timing model writes down the letters it heard over a word whenever they are not the word itself, so **Came out as** shows how a name was actually said, next to how many of its mentions came out that way — `“eltarel” · 21 of 21` — and **You asked for** shows the IPA your glossary gave it. This is the one part of the check that can catch a name said wrong the *same* way every time: that name scores high and scores evenly, so nothing above it would ever flag.
+
+Spelling is folded away before anything is compared, because the model writes what it hears and has no idea how the name is spelled. It writes “creeg” for Kreeg, “bell” for Bel, “tier” for Tyr and “drist” for Drizzt — all of them the name said correctly — and none of those is reported. What is reported is a sound the name does not spell, in most of its mentions: six in ten or more, over at least three.
+
+Read the letters rather than trust them: they come from a second model listening, not from a verdict, and a word that is spelled unlike how it sounds can still be named although it was said right. If what came out is wrong, change the name's IPA in **Name pronunciations** and narrate again; if it sounds right to you, nothing needs doing.
+
+If the captions were timed before Slopify started keeping this, the check says so instead of calling the names right. Making the captions again fills it in and costs nothing but time.
+
+A name read as an ordinary English word is left out of both checks: a one-word name that the same text also writes in lower case is a word here and not a name, which is why "Hall" stays quiet in a video that also says "hall".
+
+## Which one do I use?
 
 | You want | Use |
 |---|---|
 | An abbreviation read in full (Dr., St., vs.) | Alias |
 | A word read as a different word or spelling | Alias |
 | Any voice service | Alias |
-| A made-up or foreign name said exactly right, on Inworld TTS-2 | Glossary |
-| Pronunciations that come with each article automatically | Glossary |
+| A name said the same way in every video | Name pronunciations |
+| To correct a name once, for everything you have made since | Name pronunciations |
+| A made-up or foreign name said exactly right, on Inworld TTS-2 | Name pronunciations, or the article's glossary |
+| Pronunciations that come with each article automatically | The article's glossary |
 
 ## Tips
 
 - Spell **Say it as** the way it sounds, not the way it is written: "Shiv-awn" rather than "Siobhan".
 - Keep **Whole word** on unless you really want to match inside other words. Otherwise `St.` could fire inside unrelated text.
 - Listen to the first minute of a new run before a long batch, and add aliases for anything the voice stumbles on.
+- A name that comes back video after video belongs in **Name pronunciations**, not in each article's prompt: one line there holds for every project that follows.
 
 ## Related pages
 

package/dist/tutorials/Settings-Reference.md

@@ -58,6 +58,7 @@ Full details: [Keys and Services](Providers-and-Keys) and [AI CLIs](AI-CLIs).
 | **Sounds like a real person** | On for a voice cloned from, or made to sound like, someone real. Copy for YouTube Studio then answers Yes to YouTube's question for videos it narrates. | Default: off. |
 | **Listen** | Reads one sentence aloud: free with the system voice, one short paid request with a service that has a key. | |
 | **Remove** | Removes the voice after you confirm. Projects keep the audio they made with it. | |
+| **Name pronunciations** | Opens your own list of names with their IPA, said that way in every video, before any article's own glossary. | |
 | **Pronunciation** | Opens the narration aliases: words the narrator says differently from how they are written. | |
 
 A line above the table says when a voice's service has no key yet, with a button to add it. See [Keys and Services](Providers-and-Keys#add-a-voice) and [Narration Aliases and Glossary](Narration-Aliases-and-Glossary).