VS Code Extension Localization
Leitfaden für vollständige Lokalisierung von Visual-Studio-Code-Erweiterungen.
- Skill Road
- VS Code Extension Localization
Kategorien
Der Skill VS Code Extension Localization stammt aus dem offiziellen Repository github/awesome-copilot von GitHub. Er unterstützt Teams und Coding-Agenten dabei, sichtbare Texte einer Visual-Studio-Code-Erweiterung systematisch für mehrere Sprachen vorzubereiten. Laut Anbieter unterscheidet die Anleitung drei Ressourcenarten: lokalisierbare Beiträge in package.json, Inhalte von Walkthroughs und Meldungen beziehungsweise Zeichenketten im JavaScript- oder TypeScript-Quellcode. Für jede neu angelegte oder geänderte Ressource soll die passende Lokalisierung für alle aktuell unterstützten Sprachen erstellt oder aktualisiert werden. Der Skill ist keine Erweiterung, kein Übersetzungsdienst und kein automatisches Veröffentlichungswerkzeug. Er ist eine redaktionelle Prüfhilfe, die ein Agent beim Planen, Implementieren und Review von Lokalisierungsänderungen verwenden kann.
Warum die Einteilung wichtig ist
Eine VS-Code-Erweiterung kann Einstellungen, Befehle, Menüs, Ansichten, Begrüßungen und Walkthroughs über contribution points in package.json deklarieren. Laut der offiziellen VS-Code-Dokumentation werden solche deklarativen Texte über sprachspezifische package.nls-Dateien lokalisiert. Der Skill lenkt deshalb auf eine exklusive package.nls-Datei pro Zielsprache. Das verhindert, dass lokalisierbare Werte mit der Erweiterungslogik vermischt werden, und macht im Review sichtbar, welche Sprache zu welchem Ressourcensatz gehört. Die genaue Benennung einer Datei, die unterstützten Sprachkennungen und die tatsächlich verwendeten contribution points müssen weiterhin gegen die aktuelle VS-Code-Referenz und die eigene package.json geprüft werden.
Walkthroughs und Quellcode
Walkthrough-Schritte sind nicht einfach weitere Manifestwerte. Für sie sieht die Quelle eigene Markdown-Dateien vor, die dem jeweiligen Walkthrough-Schritt und der Sprache zugeordnet werden. Ein Agent kann damit prüfen, ob Titel, Beschreibungen und erklärende Texte gemeinsam übersetzt wurden und ob Verweise in der Erweiterung weiterhin stimmen. Für Meldungen und Zeichenketten aus JavaScript- oder TypeScript-Dateien nennt der Anbieter bundle.l10n-Dateien. Diese Trennung ist praktisch, weil deklarative Metadaten, redaktionelle Dokumentation und Laufzeittexte unterschiedliche Änderungs- und Testpfade haben. Eine Übersetzung, die nur die sichtbaren Menüeinträge abdeckt, lässt deshalb noch keine vollständige Lokalisierung erkennen.
Arbeitsablauf für sichere Reviews
Beginne mit einem Inventar aller benutzerseitig sichtbaren Texte. Ordne jede Fundstelle einem Manifestwert, einer Walkthrough-Datei oder einer Laufzeitzeichenkette zu. Prüfe danach, welche Sprachen das Projekt tatsächlich unterstützt, und aktualisiere für jede Sprache den passenden Ressourcensatz. Achte auf konsistente Platzhalter, Kontextbegriffe, Tastaturbefehle, Markup, Dateipfade und technische Bezeichner. Ein Agent sollte Unterschiede zwischen Quellsprache und Übersetzung verständlich begründen, aber keine sprachliche Änderung ohne Diff-Prüfung und Tests übernehmen. Öffne die Erweiterung anschließend in den vorgesehenen VS-Code-Versionen und kontrolliere Command Palette, Einstellungen, Menüs, Ansichten, Walkthroughs und Fehlermeldungen.
Grenzen und Sicherheit
Der Skill bearbeitet keine Dateien selbst und verleiht einem Agenten keine zusätzlichen Rechte. Ein Coding-Agent kann bei einer konkreten Aufgabe dennoch Änderungen an einem Arbeitsbaum vorschlagen oder anwenden. Prüfe die Änderungen deshalb in einer kontrollierten Umgebung, schränke Dateizugriffe ein und bestätige externe Nebenwirkungen. Übersetzungen können auch technische Inhalte verändern: Ein versehentlich übersetzter Konfigurationsschlüssel, ein beschädigter Platzhalter oder eine geänderte Escape-Sequenz kann Laufzeitfehler verursachen. Lokalisierung ersetzt außerdem keine Barrierefreiheitsprüfung, keine Erweiterungstests und keine manuelle Kontrolle des tatsächlichen Editors. GitHub beschreibt das zugrunde liegende Repository laut Anbieter mit einer MIT-Lizenz. Aktuelle Konditionen von GitHub, VS Code und verbundenen Entwicklungsumgebungen gehören nicht zu diesem Skill und werden hier nicht mit festen Preisen behauptet.
Einordnung
Der Eintrag gehört in die Kategorie Coding und ist für agentische Coding-Umgebungen geeignet, die Repositorydateien analysieren und Änderungen erklären können. Für exakte Dateinamen, Sprachkennungen und unterstützte contribution points bleibt die offizielle VS-Code-Dokumentation maßgeblich. Der Skill hilft besonders bei Review-Checklisten, bei der Aufteilung von Arbeit und bei der Suche nach vergessenen Übersetzungsdateien. Er entscheidet jedoch nicht selbst, ob eine Formulierung fachlich, rechtlich oder kulturell angemessen ist. Verantwortliche Entwicklerinnen und Entwickler müssen die Zielsprachen, die Produktterminologie, die Tests und die Darstellung in einer realen VS-Code-Installation prüfen.
Installationsanleitung
Zweck des Localization-Skills fuer VS-Code-Erweiterungen
Der Skill vscode-ext-localization stammt aus dem GitHub-Repository awesome-copilot, das von GitHub selbst gepflegt wird und eine Sammlung von Anleitungen fuer KI-gestuetzte Entwicklungsassistenten enthaelt. Laut Anbieter unterstuetzt der Skill dabei, saemtliche Aspekte einer VS-Code-Erweiterung zu lokalisieren, also fuer verschiedene Sprachen verfuegbar zu machen. Er richtet sich an alle, die neue oder bestehende Konfigurationen wie Einstellungen, Befehle, Menues, Ansichten oder Einfuehrungstexte lokalisieren wollen, sowie an alle, die Textmeldungen im eigentlichen Erweiterungscode fuer Endnutzerinnen und Endnutzer uebersetzen moechten. Der Skill ist bewusst schmal gehalten und beschreibt keine allgemeine Uebersetzungstheorie, sondern die konkreten technischen Konventionen, die Visual Studio Code fuer lokalisierte Erweiterungen vorschreibt.
Die drei Lokalisierungswege in VS Code
Nach den in der Skill-Datei zusammengefassten Richtlinien von Visual Studio Code gibt es drei getrennte Mechanismen, je nachdem, wo ein zu uebersetzender Text herkommt. Erstens: Konfigurationen wie Einstellungen, Befehle, Menues, Ansichten und Einfuehrungstitel, die in der Datei package.json einer Erweiterung definiert sind, werden ueber eine eigene Datei mit dem Namensschema package.nls.SPRACHKENNUNG.json uebersetzt, zum Beispiel package.nls.pt-br.json fuer brasilianisches Portugiesisch. Zweitens: Inhalte von Einfuehrungs-Walkthroughs, die in eigenen Markdown-Dateien liegen, erhalten eine sprachspezifische Kopie mit demselben Namensschema, etwa walkthrough/someStep.pt-br.md. Drittens: Meldungen und Textbausteine, die direkt im JavaScript- oder TypeScript-Quellcode der Erweiterung stehen und fuer Endnutzerinnen und Endnutzer sichtbar sind, werden ueber eine Bundle-Datei mit dem Namen bundle.l10n.SPRACHKENNUNG.json uebersetzt. Diese Trennung ist wichtig, weil ein einzelner Uebersetzungsprozess, der nur eine dieser drei Quellen abdeckt, automatisch Luecken in den anderen beiden hinterlaesst.
Schritt 1: Voraussetzungen fuer den Einsatz
Um den Skill sinnvoll zu nutzen, braucht man ein bestehendes VS-Code-Erweiterungsprojekt mit der ueblichen Ordnerstruktur, insbesondere einer package.json-Datei sowie gegebenenfalls vorhandenen Walkthrough-Dateien und Quellcode mit sichtbaren Textmeldungen. Der Skill selbst uebersetzt keine Inhalte automatisch in eine Fremdsprache, sondern gibt lediglich die Struktur und Konvention vor, nach der neue oder geaenderte lokalisierbare Ressourcen fuer alle bereits unterstuetzten Sprachen ergaenzt werden muessen. Man benoetigt also weiterhin entweder menschliche Uebersetzerinnen und Uebersetzer oder ein zusaetzliches Uebersetzungswerkzeug, das der Skill lediglich sinnvoll anleitet einzusetzen.
Ablauf in der Praxis
Wird eine neue lokalisierbare Ressource erstellt oder eine bestehende geaendert, verlangt der Skill, dass die entsprechende Uebersetzung fuer alle aktuell verfuegbaren Sprachen ebenfalls angelegt oder aktualisiert wird. In der Praxis bedeutet das: Sobald man einer package.json einen neuen Befehl oder eine neue Einstellung hinzufuegt, muss die passende Zeile in jeder vorhandenen package.nls.SPRACHKENNUNG.json-Datei ergaenzt werden. Aendert sich ein Walkthrough-Text, muss die entsprechende uebersetzte Markdown-Datei nachgezogen werden. Und wird eine neue Benutzermeldung im Code eingefuegt, muss der zugehoerige Eintrag in jeder Bundle-Datei erscheinen. Diese konsequente Drei-Wege-Synchronisierung verhindert, dass eine Erweiterung in manchen Sprachen aktuelle Funktionen zeigt, in anderen aber veraltete oder fehlende Texte.
Sicherheit, Grenzen und Nutzen
Sicherheitsrelevante Aspekte spielen bei diesem Skill kaum eine Rolle, da er ausschliesslich mit Textdateien im eigenen Projekt arbeitet und keine externen Dienste oder sensiblen Daten beruehrt. Der Nutzen liegt vor allem darin, dass Entwicklerinnen und Entwickler nicht selbst recherchieren muessen, welche der drei Lokalisierungsmechanismen fuer welchen Texttyp zustaendig ist, sondern dies vom Skill konsistent vorgegeben bekommen. Die Grenzen sind offensichtlich: Der Skill erledigt keine tatsaechliche Uebersetzungsarbeit und kennt auch keine sprachspezifischen Feinheiten wie Pluralformen oder kulturelle Anpassungen; er sorgt lediglich dafuer, dass die technische Struktur fuer mehrsprachige Erweiterungen korrekt eingehalten wird. Fuer die eigentliche Uebersetzungsqualitaet bleiben weiterhin muttersprachliche Pruefungen notwendig.
- Anbieter
- GitHub
- Lizenz
- MIT
- Zuletzt geprüft
- 09.09.2026
Repository und Dokumentation
Kategorien
Kompatibel mit
Passende Ratgeber
Anleitungen und Hintergrund, die zu diesem Eintrag passen.