Custom Glossary

Learn how to create and manage custom glossaries for consistent terminology across your translations.

Mafkers allows you to create custom glossaries for consistent terminology across your translations.

What is a Glossary?

A glossary is a list of terms that should NOT be translated (or should be translated consistently). For example:

• Character names: “Aerith” should always stay “Aerith”
• Place names: “Midgar” should always stay “Midgar”
• Item names: “Buster Sword” should always stay “Buster Sword”
• Skill names: “Firaga” should always stay “Firaga”

How Mafkers Handles Glossary

Mafkers uses a 5-layer proper noun protection protocol:

1. Detection: spaCy NER (Named Entity Recognition) detects proper nouns
2. Heuristics: Capitalization + frequency analysis
3. Glossary: Pre-built or user-provided glossary
4. Freeze List: All detected proper nouns are “frozen” (replaced with <NAME_NNN> placeholders)
5. Verification: Post-translation check ensures all proper nouns are preserved

Creating a Custom Glossary

Via App Settings

1. Open Mafkers → Settings → Glossary
2. Click “Add Term”
3. Enter:
   • Term: “Buster Sword”
   • Type: item_name
   • Do not translate: Yes
   • Translation: (leave blank to keep original, or enter custom translation)
4. Click “Save”

Via Import

You can import a glossary from JSON:

[
{
  "term": "Aerith",
  "type": "character_name",
  "do_not_translate": true
},
{
  "term": "Midgar",
  "type": "place_name",
  "do_not_translate": true
},
{
  "term": "Buster Sword",
  "type": "item_name",
  "do_not_translate": true
}
]

Glossary Types

Cross-Game Glossary

For game series (Final Fantasy, Persona, Elder Scrolls), Mafkers maintains cross-game glossaries:

• “Aerith” appears in FF7, FF7 Remake, FF7 Rebirth - all consistent
• “Chocobo” appears in all FF games

These are pre-built by Mafkers and bundled in the knowledge base.