Slovak translation notes

SkillDev tools

Glossary and phrasing rules for Slovak (sk) translations of Editoria11y and Sa11y strings. Read before writing or reviewing src/lang/sk.js or src/sa11y-lang/sk.js.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Slovak translation notes skill

What this skill tells your AI

The instructions your AI receives, as published by itmaybejj/editoria11y in .agents/skills/translate-slovak/SKILL.md and read by ahel’s review.

Derived from a native-speaker rewrite of the machine-translated src/sa11y-lang/sk.js (upstream Sa11y PR). Apply these when producing or reviewing any Slovak string.

Glossary

EnglishUseNever
accessible nameprístupný názovprístupné meno
assistive technologyasistenčné technológieasistívne technológie
alt textalternatívny text (always spelled out)alt text, text alt
issue / alertproblém / upozornenievydanie
headingnadpis (capitalized in "Nadpis 1", "Nadpis 2")smerovanie, položka, záhlavie
label (<label>, field/element label)štítokpopis
caption (figcaption)popis (pod obrázkom)nadpis, titul, titulok
descriptionopis
accessibilityprístupnosťdostupnosť
carouselkaruselkolotoč
colour blindnessslepota na … farburoleta, farebná slepá
frame / iframerámecrám
complex wordszložité slovázložené slová
Deaf and hard of hearingNepočujúci a nedoslýchavíosoby s poruchou sluchu
developer checksvývojárske kontrolykontroly vývojáře (Czech)
justified texttext zarovnaný do blokuzarovnaný text
"click here"„kliknite sem“„kliknite tu“
Learn more about …Viac informácií o …Ďalšie informácie o …
To fix …Ak to chcete opraviť …Ak to chcete napraviť …
fragile (of code)nespoľahlivýkrehký
raw URLholá URL adresasurová URL adresa
editors (people)redaktorieditori

Note: the two files diverge deliberately on table headers — sa11y-lang/sk.js uses záhlavie, lang/sk.js uses hlavička. Both are correct; keep each file internally consistent. No string from one surfaces beside the other in a tooltip.

Phrasing

  • Quotes: Slovak typographic quotes „…“. Never "…", &quot;, or »…«.
  • Verify whether → či, not že. "Skontrolujte, či je dostupný prepis." ("Uistite sa, že …" is correct — different verb.)
  • Imperative, not nominalized. "Odstráňte prázdne odkazy", not "Odstránenie prázdnych odkazov".
  • Reflexive passive over byť + participle (Germanism): "Nenašli sa žiadne obrázky", not "Neboli nájdené žiadne obrázky".
  • Statements stay statements. English sentences ending in . must not become ?.
  • sa zdá byť is machine-translation filler. Prefer je zrejme … or sa líši od ….
  • ani after a negated verb, not alebo: "nemal obsahovať prípony súborov ani rozmery".
  • Untranslated English left inside markup ("Head %(level)", "Normal", "Paragraph", "strong importance", "4th") is a red flag — translate it (Nadpis / Normálny / Odsek / silný dôraz / 4.).

Mechanics

  • Keep %(...) placeholders identical in count, spelling and order to en.js / baseAll.js. Placeholder names are case-sensitive (%(TEXT)%(text)).
  • Keep HTML markup, {B} / {C} / {L} / {ALT} tokens, and <hr> separators unchanged.
  • src/lang/*.js keys must match src/lang/baseAll.js exactly, except that translations may add META_MAX / META_SCALABLE tips (most do) to override the Sa11y fallback.
  • Localize documentation links where a locale exists: support.google.com/docs/answer/6199477?hl=sk, support.microsoft.com/sk-sk/office/….

Plurals

Counted phrases use CLDR plural categories via pluralKey() in src/js/utils/utils.js. For a base key, a language supplies ${base}_one, _two, _few, _many, _zero only for the categories it actually inflects; every other count falls back to the base key. Languages with a single plural form need no extra strings.

Never invent count thresholds — check the real categories first:

const pr = new Intl.PluralRules('sk');
[1, 2, 3, 5, 21, 101].map((n) => `${n}:${pr.select(n)}`);
// [ '1:one', '2:few', '3:few', '5:other', '21:other', '101:other' ]

Slovak uses one (1), few (2-4) and other (5+). Note that Slovak does not restart the cycle at 21 or 101, unlike Polish, Ukrainian, Lithuanian and Slovene.

KeyCountSlovak
main_toggle_1exactly 1Jedno upozornenie na prístupnosť
main_toggle_2exactly 2Dve upozornenia na prístupnosť
main_toggle_few3-4 upozornenia na prístupnosť
main_toggle_plural5+ (fallback) upozornení na prístupnosť
PANEL_DISMISS_BUTTON_one1Zobraziť %(dismissCount) skryté upozornenie
PANEL_DISMISS_BUTTON_few2-4Zobraziť %(dismissCount) skryté upozornenia
PANEL_DISMISS_BUTTON5+ (fallback)Zobraziť %(dismissCount) skrytých upozornení
buttonHideHiddenAlerts_few2-4Skryť %(count) skryté upozornenia
buttonHideHiddenAlerts5+ (fallback)Skryť %(count) skrytých upozornení

main_toggle_1 and main_toggle_2 spell the number out and match on the literal count, so they are not plural categories. buttonHideHiddenAlerts is only ever called with 2 or more, which is why Slovak needs no _one for it.

Inflect the adjective too, not just the noun: skryté upozornenia (few) vs skrytých upozornení (other).

Signals

GitHub stars
54
Forks
12
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
translate-slovak
Source
github.com/itmaybejj/editoria11y