Gender Plugin Guide
Real-World Use Case: Romance Language Learning App
Scenario: You’re building a French/Spanish/German learning app. Nouns have grammatical gender (masculine/feminine/neuter) which affects articles, adjectives, and agreement. Students need to learn and practice gender.
Before (Without Gender Data)
French: "le chat" vs "la chat"
Spanish: "el gato" vs "la gata"
German: "der Hund" vs "die Katze" vs "das Haus"
Students memorize each noun's gender individually.
No visual cues or pattern recognition support.After (With Gender Plugin)
Sample French Nouns
const frenchNouns = [
"chat", // cat (masculine)
"chien", // dog (masculine)
"maison", // house (feminine)
"voiture", // car (feminine)
"livre", // book (masculine)
"table", // table (feminine)
];With Gender Data (From French Dictionary)
import { processGLOSTWithExtensionsAsync } from "@glotblocks/glost-plugins";
import { createGenderExtension } from "@glotblocks/glost-gender";
import { createFrenchGenderProvider } from "./my-dictionary-provider";
// Real dictionary data
const frenchGenders = new Map([
["chat", "masculine"],
["chien", "masculine"],
["maison", "feminine"],
["voiture", "feminine"],
["livre", "masculine"],
["table", "feminine"],
]);
const provider = createFrenchGenderProvider({ dictionary: frenchGenders });
const [genderGen, genderEnh] = createGenderExtension({
targetLanguage: "fr",
provider
});
const result = await processGLOSTWithExtensionsAsync(glostDoc, [genderGen, genderEnh]);Output (Visualized)
📘 le chat [Masc] → Masculine (blue)
📘 le chien [Masc] → Masculine (blue)
📕 la maison [Fem] → Feminine (pink)
📕 la voiture [Fem] → Feminine (pink)
📘 le livre [Masc] → Masculine (blue)
📕 la table [Fem] → Feminine (pink)UI Implementation
function NounWithGender({ word }) {
const gender = word.extras?.gender;
if (!gender) {
return <span className="no-gender">{word.text}</span>;
}
const styles = {
masculine: {
color: "#4A90E2",
icon: "♂",
article: "le/un"
},
feminine: {
color: "#E24A90",
icon: "♀",
article: "la/une"
},
neuter: {
color: "#9B59B6",
icon: "⚬",
article: "das/ein"
}
};
const style = styles[gender.type] || styles.masculine;
return (
<span
className={`noun gender-${gender.type}`}
style={{
borderLeft: `4px solid ${style.color}`,
paddingLeft: '8px'
}}
title={`${gender.display} - use "${style.article}"`}
>
<span className="icon">{style.icon}</span>
{word.text}
</span>
);
}Value Demonstrated
1. Article Selection Helper
function getCorrectArticle(noun, articleType) {
const gender = noun.extras?.gender?.type;
const articles = {
fr: {
masculine: { definite: "le", indefinite: "un" },
feminine: { definite: "la", indefinite: "une" }
},
es: {
masculine: { definite: "el", indefinite: "un" },
feminine: { definite: "la", indefinite: "una" }
},
de: {
masculine: { definite: "der", indefinite: "ein" },
feminine: { definite: "die", indefinite: "eine" },
neuter: { definite: "das", indefinite: "ein" }
}
};
return articles[noun.lang]?.[gender]?.[articleType];
}
// "chat" (masculine) + definite → "le"
// "maison" (feminine) + indefinite → "une"2. Gender Agreement Exercise Generator
function generateAgreementExercise(noun, adjective) {
const gender = noun.extras?.gender?.type;
// French: adjectives often add -e for feminine
const adjectiveForm = gender === "feminine"
? adjective + "e" // "petit" → "petite"
: adjective; // "petit" stays "petit"
return {
question: `What is the correct form: "${noun.text}" ___ ?`,
options: [adjective, adjective + "e"],
correct: adjectiveForm,
explanation: `"${noun.text}" is ${gender}, so use "${adjectiveForm}"`
};
}
// "chat" (masculine) + "petit" → "petit chat" (no -e)
// "maison" (feminine) + "petit" → "petite maison" (add -e)3. Pattern Recognition
function identifyGenderPatterns(nouns) {
const byEnding = {};
nouns.forEach(noun => {
const ending = noun.text.slice(-3); // last 3 letters
const gender = noun.extras?.gender?.type;
if (!byEnding[ending]) {
byEnding[ending] = { masculine: 0, feminine: 0 };
}
byEnding[ending][gender]++;
});
// Find patterns
const patterns = Object.entries(byEnding)
.filter(([ending, counts]) => {
const total = counts.masculine + counts.feminine;
const dominant = Math.max(counts.masculine, counts.feminine);
return dominant / total > 0.8; // 80%+ correlation
});
return patterns;
}
// French patterns discovered:
// -tion → 95% feminine ("nation", "station", "action")
// -age → 85% masculine ("garage", "village", "message")
// -eur → 90% masculine ("acteur", "docteur", "professeur")Real Data Example: German (Three Genders)
German Gender System
const germanGenders = new Map([
// Masculine
["Mann", "masculine"], // man
["Hund", "masculine"], // dog
["Tisch", "masculine"], // table
// Feminine
["Frau", "feminine"], // woman
["Katze", "feminine"], // cat
["Lampe", "feminine"], // lamp
// Neuter
["Kind", "neuter"], // child
["Haus", "neuter"], // house
["Auto", "neuter"], // car
]);
const germanProvider = createGermanGenderProvider({
dictionary: germanGenders
});German Sentence Example
Text: “Der Mann und die Frau lesen das Buch”
(The man and the woman read the book)
Output with Gender:
Der [Art-Masc] ♂ Masculine article
Mann [N-Masc] ♂ Masculine noun
und [Conj] - (and)
die [Art-Fem] ♀ Feminine article
Frau [N-Fem] ♀ Feminine noun
lesen [V] - (read)
das [Art-Neut] ⚬ Neuter article
Buch [N-Neut] ⚬ Neuter nounPattern Shown:
- der + masculine noun (Mann)
- die + feminine noun (Frau)
- das + neuter noun (Buch)
Student learns article-gender agreement!
Spanish Example: Gender with Plural Forms
Spanish Gender and Number
const spanishNouns = [
{ word: "gato", gender: "masculine", plural: "gatos" }, // cat(s)
{ word: "gata", gender: "feminine", plural: "gatas" }, // cat(s) female
{ word: "libro", gender: "masculine", plural: "libros" }, // book(s)
{ word: "mesa", gender: "feminine", plural: "mesas" }, // table(s)
];Gender + Number Agreement
function getSpanishArticle(noun, number = "singular") {
const gender = noun.extras?.gender?.type;
const articles = {
masculine: { singular: "el", plural: "los" },
feminine: { singular: "la", plural: "las" }
};
return articles[gender]?.[number];
}
// "gato" + singular → "el gato"
// "gato" + plural → "los gatos"
// "mesa" + singular → "la mesa"
// "mesa" + plural → "las mesas"Visual Representation
Singular:
📘 el gato (masculine singular)
📕 la mesa (feminine singular)
Plural:
📘 los gatos (masculine plural)
📕 las mesas (feminine plural)
Pattern: Masculine uses el/los, Feminine uses la/lasPractical Applications
1. Flashcard Study Mode
function createGenderFlashcard(noun) {
const gender = noun.extras?.gender;
return {
front: noun.text, // "chat"
back: {
gender: gender?.display, // "Masculine"
article: getCorrectArticle(noun), // "le"
example: `${getCorrectArticle(noun)} ${noun.text}`, // "le chat"
mnemonic: generateMnemonic(noun) // "Chat sounds like 'shah' - masculine"
},
review: {
question: `What is the gender of "${noun.text}"?`,
options: ["Masculine", "Feminine", "Neuter"],
correct: gender?.type
}
};
}2. Fill-in-the-Blank Exercises
function generateArticleExercise(sentence) {
// Original: "Le chat mange la souris"
// Remove articles: "___ chat mange ___ souris"
const nouns = extractNouns(sentence);
const blanks = nouns.map(noun => ({
word: noun.text,
gender: noun.extras?.gender?.type,
correct: getCorrectArticle(noun, "definite")
}));
return {
text: sentence.replace(/\b(le|la|les|l')\b/gi, "___"),
blanks,
check: (userAnswers) => {
return userAnswers.map((answer, i) =>
answer.toLowerCase() === blanks[i].correct.toLowerCase()
);
}
};
}
// Student fills: "_le_ chat mange _la_ souris"
// Instant feedback based on gender data3. Gender Consistency Checker
function checkGenderAgreement(sentence) {
const errors = [];
// Check article-noun agreement
for (let i = 0; i < sentence.words.length - 1; i++) {
const word = sentence.words[i];
const next = sentence.words[i + 1];
if (word.pos === "article" && next.pos === "noun") {
const articleGender = inferArticleGender(word.text);
const nounGender = next.extras?.gender?.type;
if (articleGender !== nounGender) {
errors.push({
position: i,
error: `Article "${word.text}" (${articleGender}) doesn't match noun "${next.text}" (${nounGender})`,
suggestion: `Use "${getCorrectArticle(next)}" instead`
});
}
}
}
return errors;
}
// "la chat" → Error: "la" (feminine) doesn't match "chat" (masculine)
// Suggestion: "Use 'le' instead"French Ending Patterns (Data-Driven)
Pattern Discovery
// Analyze 10,000 French nouns from dictionary
const frenchNouns = await loadFrenchDictionary();
const patterns = discoverGenderPatterns(frenchNouns);
// Results:
const reliablePatterns = {
feminine: [
{ ending: "-tion", accuracy: 96%, examples: ["nation", "station", "action"] },
{ ending: "-sion", accuracy: 94%, examples: ["passion", "mission", "vision"] },
{ ending: "-té", accuracy: 92%, examples: ["liberté", "beauté", "vérité"] },
{ ending: "-ette", accuracy: 89%, examples: ["cigarette", "cassette", "tablette"] }
],
masculine: [
{ ending: "-age", accuracy: 85%, examples: ["garage", "village", "fromage"] },
{ ending: "-ment", accuracy: 93%, examples: ["moment", "document", "élément"] },
{ ending: "-eur", accuracy: 88%, examples: ["acteur", "professeur", "docteur"] },
{ ending: "-isme", accuracy: 97%, examples: ["capitalisme", "tourisme", "réalisme"] }
]
};Teaching Patterns
function teachGenderPattern(pattern) {
const nouns = findNounsWithEnding(pattern.ending);
return {
rule: `Words ending in "${pattern.ending}" are usually ${pattern.gender}`,
accuracy: `${pattern.accuracy}% accurate`,
examples: nouns.slice(0, 5),
practice: generatePatternExercise(nouns)
};
}
// "Words ending in '-tion' are usually feminine (96% accurate)"
// Examples: nation ♀, station ♀, action ♀, solution ♀, option ♀Integration Example: Complete Gender Learning System
import { glost } from "@glotblocks/glost";
import { createGenderPlugin } from "@glotblocks/glost-gender";
// 1. Load gender dictionary
const genderDict = await loadFrenchGenderDictionary();
const provider = createFrenchGenderProvider({ dictionary: genderDict });
// 2. Create and freeze processor for reuse
const processor = glost()
.use(createGenderPlugin({
targetLanguage: "fr",
provider
}))
.freeze();
// 3. Process text
const text = "Le chat noir joue avec la souris grise.";
const glostDoc = convertTextToGLOST(text, "fr");
const result = await processor.process(glostDoc);
// 4. Render gender-aware UI
function GenderLearningView({ document }) {
const nouns = extractNouns(document);
const patterns = identifyGenderPatterns(nouns);
return (
<div className="gender-view">
<div className="text-display">
{document.children.map(sentence => (
<SentenceWithGender sentence={sentence} />
))}
</div>
<div className="gender-stats">
<GenderDistribution nouns={nouns} />
<PatternHighlights patterns={patterns} />
</div>
<div className="practice">
<ArticleExercises nouns={nouns} />
<GenderQuiz nouns={nouns} />
</div>
</div>
);
}
// 5. Show statistics
function GenderDistribution({ nouns }) {
const counts = countByGender(nouns);
return (
<div className="distribution">
<div className="masculine">
♂ Masculine: {counts.masculine}
<small>{nouns.filter(n => n.gender === 'masculine').map(n => n.text).join(', ')}</small>
</div>
<div className="feminine">
♀ Feminine: {counts.feminine}
<small>{nouns.filter(n => n.gender === 'feminine').map(n => n.text).join(', ')}</small>
</div>
</div>
);
}Conclusion
Gender data transforms noun learning from memorization into pattern recognition:
- ✅ Visual cues (colors, icons) reinforce gender
- ✅ Correct articles automatically shown (le vs la, der vs die vs das)
- ✅ Patterns discovered (-tion = feminine, -age = masculine)
- ✅ Agreement errors caught (la chat → le chat)
- ✅ Exercises generated automatically (fill article, match gender)
The key: Validated gender data from dictionaries, not guessing from endings (which is only 85-95% accurate at best, and patterns vary by language).
Note: The Gender plugin is only applicable to languages with grammatical gender (French, Spanish, German, Russian, etc.). For languages without grammatical gender (English, Thai, Japanese, Chinese), this plugin returns undefined for all words.