Thiorosan: Create the documentation subpage

2026-08-27T12:19:41Z

Create the documentation subpage

New page

This is the documentation for [[Module:Auphen/YBS-PJ]], the sound data for [[Pjany language|Pjany]] (registry code <code>YBS-PJ</code>) on the Yezur wiki. It is pure data and defines no functions: [[Module:Auphen/frame]] loads it whenever [[Template:Auphen]] is called as <code><nowiki>{{auphen|word|YBS-PJ}}</nowiki></code> and hands its tables to [[Module:Auphen]], which does the work. The rule notation, and the engine's divergences from it, are documented on [[Module talk:Auphen]].

== Fields ==

{| class="wikitable"
! Field !! Contents
|-
| <code>ipacats</code> || The category sets the ruleset works with, written <code><nowiki>[X]</nowiki></code>. They hold sounds, not letters, because they are read after the transposition. Pjany supplies <code>ipacats</code> only; [[Module:Auphen/frame]] falls back to a <code>cats</code> table where a language declares one for rulesets that operate on spelling.
|-
| <code>ipa_rules</code> || The transposition from spelling to sound, applied once before <code>pronounce</code> runs. It is passed to the engine in pronunciation estimation only, so a named ruleset from <code>sets</code> would see the orthography untransposed.
|-
| <code>pronounce</code> || The ruleset used for pronunciation estimation.
|-
| <code>sets</code> || Named rulesets for grammar and derivation. Empty for Pjany.
|}

== Spelling and sound ==

The word is lower-cased before transposition, and the longest spelling that matches at a given point wins, so digraphs are read ahead of their component letters whatever order they stand in.

{| class="wikitable"
! Spelling !! Sound !! !! Spelling !! Sound
|-
| <code>a</code> || <code>a</code> || || <code>ae</code> || <code>æ:</code>
|-
| <code>e</code> || <code>ɛ</code> || || <code>ao</code> || <code>ɑ:</code>
|-
| <code>i</code> || <code>i</code> || || <code>au</code> || <code>ɐʊ</code>
|-
| <code>o</code> || <code>ɔ</code> || || <code>aú</code> || <code>ɑu</code>
|-
| <code>u</code> || <code>ə</code> || || <code>éi</code> || <code>eɪ</code>
|-
| <code>é</code> || <code>e</code> || || <code>ou</code> || <code>ɔə</code>
|-
| <code>ó</code> || <code>o</code> || || <code>oú</code> || <code>oʊ</code>
|-
| <code>ú</code> || <code>u</code> || || <code>ui</code> || <code>əɪ</code>
|-
| || || || <code>úi</code> || <code>ɥi</code>
|}

{| class="wikitable"
! Spelling !! Sound !! !! Spelling !! Sound
|-
| <code>b</code> || <code>b</code> || || <code>n</code> || <code>n</code>
|-
| <code>d</code> || <code>d</code> || || <code>p</code> || <code>p</code>
|-
| <code>g</code> || <code>g</code> || || <code>q</code> || <code>q</code>
|-
| <code>h</code> || <code>h</code> || || <code>qh</code> || <code>q͡χ</code>
|-
| <code>k</code> || <code>k</code> || || <code>r</code> || <code>ɹ</code>
|-
| <code>l</code> || <code>l</code> || || <code>s</code> || <code>s</code>
|-
| <code>m</code> || <code>m</code> || || <code>t</code> || <code>t</code>
|-
| || || || <code>z</code> || <code>z</code>
|}

Two spellings carry no sound of their own. An apostrophe <code>'</code> geminates the consonant before it; a hyphen <code>-</code>, or an en dash <code>–</code>, marks a seam within a compound. Both are carried through the ruleset as digits, <code>4</code> and <code>5</code>, so that rules can see them: the <code>4</code> is dropped as soon as the doubling has applied, and the <code>5</code> becomes a <code>~</code> in the last rules, which [[Module:Auphen]] renders as a space. The digits <code>1</code>, <code>2</code> and <code>3</code> do the same work for palatalisation and <code>8</code> for vowel length; none survive to the output. Length is written <code>:</code> throughout the data and rewritten to <code>ː</code> by the last rule.

An <code>e</code> that stands before another vowel is not read as <code>ɛ</code> where it opens the word or follows a consonant: there the ruleset takes it as a palatal element, described below.

== Categories ==

Members are declared in order, and category-to-category mapping is positional, so the paired sets below line up member by member.

{| class="wikitable"
! Category !! Members !! Role
|-
| <code><nowiki>[V]</nowiki></code> || the vowel inventory, with the backed vowels of <code><nowiki>[B]</nowiki></code> appended || Vowel environments.
|-
| <code><nowiki>[C]</nowiki></code> || the consonant inventory, including the palatals, lenited velars and uvulars that later rules derive || Consonant environments.
|-
| <code><nowiki>[A]</nowiki></code> || <code>i e ɛ æ: æ a</code> || Front vowels.
|-
| <code><nowiki>[K]</nowiki></code> || <code>p b k g t d</code> || Plosives.
|-
| <code><nowiki>[R]</nowiki></code> || <code>r ʀ ɹ</code> || Rhotics.
|-
| <code><nowiki>[Q]</nowiki></code> → <code><nowiki>[B]</nowiki></code> || <code>i ɛ e ə a æ ɐ</code> → <code>ɯ ʌ ɤ o̞ ɑ ɑ ɑ</code> || Backing next to a uvular.
|-
| <code><nowiki>[H]</nowiki></code> → <code><nowiki>[J]</nowiki></code> || <code>s z l n t d p b h k g</code> → <code>ʃ ʒ ʎ ɲ tʃ dʒ ɸ β j x ɣ</code> || Palatalisation.
|-
| <code><nowiki>[W]</nowiki></code> → <code><nowiki>[Y]</nowiki></code> || <code>g k q</code> → <code>ɣ x x</code> || Lenition after a lateral.
|}

<code><nowiki>[V]</nowiki></code> holds vowels proper: the offglides <code>ɪ</code> and <code>ʊ</code> and the glide <code>ɥ</code> that the diphthongs bring in are not members, so a rule keyed on <code><nowiki>[V]</nowiki></code> does not match them.

== The pronunciation ruleset ==

<code>pronounce</code> applies the following, in this order.

{| class="wikitable"
! Process !! Effect
|-
| Seam breathing || A seam standing between two vowels takes an inserted <code>h</code>.
|-
| Gemination || A consonant before <code>'</code> is doubled and the <code>'</code> dropped. A glottal element is inserted between the two copies late in the ruleset, so <code>t'</code> surfaces as <code>tˀt</code>.
|-
| Palatalisation || The palatal element surfaces as <code>j</code> word-initially and as a <code>ʲ</code> diacritic after <code>ɹ</code> or <code>m</code>, with <code>ɹ</code> hardening to <code>r</code> before the diacritic. Before a front vowel a preceding plosive instead takes an inserted <code>j</code>, unless that vowel is itself followed by <code>q</code> or <code>qh</code>. Otherwise the preceding consonant shifts to its palatal counterpart, <code><nowiki>[H]</nowiki></code> → <code><nowiki>[J]</nowiki></code>. After <code>q</code> the element is dropped and the <code>q</code> held aside as a marker until the backing rule has run, so the following vowel does not back.
|-
| Uvular colouring || Beside <code>q</code> or <code>q͡χ</code>, front and central vowels back, <code><nowiki>[Q]</nowiki></code> → <code><nowiki>[B]</nowiki></code>.
|-
| Nasal assimilation || <code>n</code> becomes <code>m</code> before a labial, <code>ŋ</code> before a velar and <code>ɴ</code> before <code>q</code>.
|-
| Rhotic backing || <code>r</code> and <code>ɹ</code> become <code>ʀ</code> beside <code>q</code>.
|-
| Lenition after a lateral || <code>g k q</code> become <code>ɣ x x</code> after <code>l</code> or <code>ʎ</code>.
|-
| L-vocalisation || <code>l</code> becomes <code>ʊ</code> before <code>t d n s z</code> and <code>ə</code> before <code>p b m ɸ β</code>, in both cases only when no consonant-plus-vowel follows. A word-final <code>l</code> after a consonant takes a preceding <code>ə</code>.
|-
| R-vocalisation || A rhotic becomes <code>ə</code> after a front vowel when a consonant or the word end follows, and after <code>ə</code> when a consonant follows. An <code>ə</code> before a word-final rhotic opens to <code>ɔ</code>.
|-
| Final adjustments || <code>hə</code> becomes <code>x</code> except word-finally; <code>ɛə</code> becomes <code>ɛ:</code>; <code>ɥi</code> becomes <code>ɥʲ</code> before a vowel; and two identical vowels merge into one long vowel.
|}

A seam blocks adjacency, so rules that are meant to reach across one list it in their environments explicitly; the rest do not apply over it.

== Named rulesets ==

<code>sets</code> is empty: Pjany has no derivation rulesets yet, and the three-argument form <code><nowiki>{{auphen|word|YBS-PJ|name}}</nowiki></code> therefore reports an unknown ruleset and files the page into [[:Category:Auphen errors]].

Four worked Pjany estimations are checked on every parse at [[Template:Auphen/testcases]].

Module:Auphen/YBS-PJ/doc - Revision history

Thiorosan: Create the documentation subpage