Localize the Article editor UI based on Bolt backend locale

README.md

@@ -101,6 +101,22 @@ default:
     autolink: false
 ```
 
+## Language / locale
+
+The editor UI language always follows the current Bolt **backend locale** — each
+user sees the editor in the language they've selected for the Bolt admin, with no
+configuration. The matching Article language file
+(`assets/article/langs/<code>.js`) is loaded automatically; English and Czech ship
+with the extension, and locales without a translation file fall back to English.
+
+This is driven solely by the user's Bolt locale and is not overridable via
+`editor.lang`.
+
+To add a language, copy `assets/article/langs/en.js` to `assets/article/langs/<code>.js`
+and translate the values (any key you leave out falls back to English). The file is
+loaded before the plugin scripts, so each plugin's own English strings deep-merge on
+top and remain available as fallbacks.
+
 ## Adding custom plugins
 
 If you've written your own block or plugin for Article according to the

assets/article/langs/cs.js

@@ -0,0 +1,175 @@
+/**
+ * Czech (cs) UI language for the Bolt Article editor.
+ *
+ * Loaded by Bolt\Article\TwigExtension::articleLangInclude before the plugin
+ * scripts. Keys left out fall back to English (see en.js) automatically.
+ *
+ * Structure mirrors en.js: the core editor UI first, then one clearly labelled
+ * group per plugin. Plugin strings are NOT merged into non-English locales at
+ * runtime, so every plugin group must be carried here to be shown in Czech.
+ */
+(function (AE) {
+    AE.lang = AE.lang || {};
+    AE.lang['cs'] = {
+        // ─────────────────────────────────────────────────────────────
+        // Core editor UI
+        // ─────────────────────────────────────────────────────────────
+        accessibility: { 'help-label': 'Textový editor' },
+        editor: { title: 'Článek', multiple: 'Vícenásobné' },
+        placeholders: {
+            figcaption: 'Zadejte popisek (nepovinné)',
+            text: 'Začněte psát...',
+            code: 'Upravte pro přidání kódu...',
+            layer: 'Stiskněte Enter pro přidání nového textu...'
+        },
+        popup: {
+            link: 'Odkaz', add: 'Přidat', grid: 'Mřížka', back: 'Zpět',
+            image: 'Obrázek', snippets: 'Úryvky', 'add-image': 'Přidat obrázek'
+        },
+        shortcuts: {
+            'meta-a': 'Vybrat text v bloku', 'meta-shift-a': 'Vybrat všechny bloky',
+            'meta-click': 'Vybrat více bloků', 'meta-z': 'Zpět', 'meta-shift-z': 'Znovu',
+            'meta-shift-m': 'Odebrat vložené formátování', 'meta-b': 'Tučné',
+            'meta-i': 'Kurzíva', 'meta-u': 'Podtržené', 'meta-h': 'Horní index',
+            'meta-l': 'Dolní index', 'meta-k': 'Odkaz', 'meta-alt-0': 'Normální text',
+            'meta-alt-1': 'Nadpis 1', 'meta-alt-2': 'Nadpis 2', 'meta-alt-3': 'Nadpis 3',
+            'meta-alt-4': 'Nadpis 4', 'meta-alt-5': 'Nadpis 5', 'meta-alt-6': 'Nadpis 6',
+            'meta-shift-7': 'Číslovaný seznam', 'meta-shift-8': 'Odrážkový seznam',
+            'meta-indent': 'Odsadit', 'meta-outdent': 'Zrušit odsazení',
+            'meta-shift-backspace': 'Smazat blok', 'meta-shift-d': 'Duplikovat blok',
+            'meta-shift-up': 'Posunout řádek nahoru', 'meta-shift-down': 'Posunout řádek dolů'
+        },
+        headings: {
+            h1: 'Nadpis 1', h2: 'Nadpis 2', h3: 'Nadpis 3',
+            h4: 'Nadpis 4', h5: 'Nadpis 5', h6: 'Nadpis 6'
+        },
+        inline: { bold: 'Tučné', italic: 'Kurzíva', deleted: 'Přeškrtnuté' },
+        list: {
+            'unordered-list': 'Odrážkový seznam', 'ordered-list': 'Číslovaný seznam',
+            indent: 'Odsadit', outdent: 'Zrušit odsazení'
+        },
+        link: {
+            link: 'Odkaz', 'edit-link': 'Upravit odkaz', unlink: 'Zrušit odkaz',
+            'link-in-new-tab': 'Otevřít odkaz v nové kartě', save: 'Uložit',
+            insert: 'Vložit', cancel: 'Zrušit', text: 'Text', url: 'URL'
+        },
+        table: {
+            width: 'Šířka', nowrap: 'Nezalamovat', save: 'Uložit', cancel: 'Zrušit',
+            'table-cell': 'Buňka tabulky', 'add-head': 'Přidat záhlaví',
+            'remove-head': 'Odebrat záhlaví', 'add-row-below': 'Přidat řádek pod',
+            'add-row-above': 'Přidat řádek nad', 'remove-row': 'Odebrat řádek',
+            'add-column-after': 'Přidat sloupec za', 'add-column-before': 'Přidat sloupec před',
+            'remove-column': 'Odebrat sloupec'
+        },
+        image: {
+            or: 'nebo', 'alt-text': 'Alternativní text', save: 'Uložit', link: 'Odkaz',
+            width: 'Šířka', delete: 'Smazat', cancel: 'Zrušit', insert: 'Vložit',
+            caption: 'Popisek', 'link-in-new-tab': 'Otevřít odkaz v nové kartě',
+            'url-placeholder': 'Vložte URL obrázku...',
+            'upload-new-placeholder': 'Přetáhněte pro nahrání nového obrázku<br>nebo klikněte pro výběr'
+        },
+        code: { code: 'Kód', insert: 'Vložit', save: 'Uložit', cancel: 'Zrušit' },
+        embed: {
+            embed: 'Vložený obsah', caption: 'Popisek', insert: 'Vložit', save: 'Uložit',
+            cancel: 'Zrušit',
+            description: 'Vložte libovolný embed/HTML kód nebo zadejte URL (pouze video Vimeo nebo YouTube)',
+            'responsive-video': 'Responzivní video'
+        },
+        upload: { placeholder: 'Přetáhněte pro nahrání <br>nebo klikněte pro výběr' },
+        templates: { templates: 'Šablony' },
+        snippets: { snippets: 'Úryvky' },
+        form: {
+            link: 'Odkaz', url: 'URL', text: 'Text', name: 'Název',
+            'alt-text': 'Alternativní text', image: 'Obrázek', upload: 'Nahrát',
+            alignment: 'Zarovnání', outset: 'Přesah', valign: 'Svislé zarovnání'
+        },
+        buttons: {
+            'mobile-view': 'Mobilní zobrazení', cancel: 'Zrušit', insert: 'Vložit',
+            unlink: 'Zrušit odkaz', save: 'Uložit', add: 'Přidat',
+            'transform-to-text': 'Převést na text', align: 'Zarovnání', valign: 'Svislé zarovnání',
+            outset: 'Přesah', indent: 'Odsadit', outdent: 'Zrušit odsazení', head: 'Záhlaví',
+            row: 'Řádek', cell: 'Buňka', html: 'HTML', templates: 'Šablony',
+            shortcuts: 'Klávesové zkratky', format: 'Formát', bold: 'Tučné', italic: 'Kurzíva',
+            deleted: 'Přeškrtnuté', underline: 'Podtržené', table: 'Tabulka', link: 'Odkaz',
+            undo: 'Zpět', redo: 'Znovu', style: 'Styl', config: 'Konfigurace',
+            settings: 'Nastavení', text: 'Text', embed: 'Vložený obsah', grid: 'Mřížka',
+            image: 'Obrázek', list: 'Seznam', delete: 'Smazat', duplicate: 'Duplikovat',
+            sort: 'Seřadit', edit: 'Upravit', inline: 'Vložené'
+        },
+        // Popisky bloků. Poslední dva přidávají pluginy `math` a `variable`;
+        // ostatní jsou základní typy bloků.
+        blocks: {
+            noneditable: 'Needitovatelné', paragraph: 'Odstavec', heading: 'Nadpis',
+            image: 'Obrázek', figcaption: 'Popisek obrázku', embed: 'Vložený obsah',
+            line: 'Čára', code: 'Kód', quote: 'Citace', quoteitem: 'Odstavec',
+            snippet: 'Úryvek', column: 'Sloupec', grid: 'Mřížka', list: 'Seznam',
+            table: 'Tabulka', layer: 'Vrstva', row: 'Řádek', text: 'Text', cell: 'Buňka',
+            dlist: 'Definiční seznam', address: 'Adresa', form: 'Formulář', card: 'Karta',
+            tags: 'Štítky', math: 'Matematický výraz', variable: 'Proměnná'
+        },
+
+        // ─────────────────────────────────────────────────────────────
+        // Plugin UI — jedna skupina na plugin (abecedně)
+        // ─────────────────────────────────────────────────────────────
+        // blockcode plugin
+        blockcode: { save: 'Uložit', cancel: 'Zrušit', 'edit-code': 'Upravit kód' },
+        // buttonlink plugin
+        buttonlink: { button: 'Tlačítko' },
+        // carousel plugin
+        carousel: { carousel: 'Karusel', save: 'Uložit', cancel: 'Zrušit', insert: 'Vložit' },
+        // clips plugin
+        clips: { clips: 'Klipy' },
+        // counter plugin
+        counter: { words: 'slov', chars: 'znaků' },
+        // filelink plugin
+        filelink: {
+            file: 'Soubor', upload: 'Nahrát', title: 'Název', choose: 'Vybrat',
+            placeholder: 'Přetáhněte pro nahrání souboru<br>nebo klikněte pro výběr'
+        },
+        // handle plugin
+        handle: { handle: 'Úchyt' },
+        // icons plugin
+        icons: { icons: 'Ikony' },
+        // imageposition plugin
+        imageposition: { 'image-position': 'Pozice obrázku' },
+        // imageresize plugin
+        imageresize: { 'image-resize': 'Změna velikosti obrázku' },
+        // inlineformat plugin
+        inlineformat: {
+            'inline-format': 'Vložené formátování', underline: 'Podtržené',
+            superscript: 'Horní index', subscript: 'Dolní index', mark: 'Zvýraznění',
+            code: 'Kód', shortcut: 'Zkratka', 'remove-format': 'Odebrat formátování'
+        },
+        // makebutton plugin
+        makebutton: {
+            'make-a-button': 'Vytvořit tlačítko', 'remove-button': 'Odebrat tlačítko',
+            button: 'Tlačítko'
+        },
+        // math plugin
+        math: {
+            math: 'Matematický výraz', label: 'Zadejte výraz', add: 'Přidat',
+            save: 'Uložit', cancel: 'Zrušit'
+        },
+        // print plugin
+        print: { print: 'Tisk' },
+        // removeformat plugin
+        removeformat: { removeformat: 'Odebrat formátování' },
+        // selector plugin
+        selector: { selector: 'Výběr', save: 'Uložit', cancel: 'Zrušit' },
+        // slideshow plugin
+        slideshow: { slideshow: 'Prezentace', save: 'Uložit', cancel: 'Zrušit', insert: 'Vložit' },
+        // specialchars plugin
+        specialchars: { 'special-chars': 'Speciální znaky' },
+        // style plugin
+        style: { style: 'Styl', 'remove-style': 'Odebrat styl' },
+        // tags plugin
+        tags: {
+            tags: 'Štítky', add: 'Přidat', save: 'Uložit', cancel: 'Zrušit',
+            label: 'Přidejte štítky oddělené čárkou'
+        },
+        // textdirection plugin
+        textdirection: { title: 'RTL-LTR', ltr: 'Zleva doprava', rtl: 'Zprava doleva' },
+        // variable plugin
+        variable: { variable: 'Proměnná' }
+    };
+})(ArticleEditor);