Obwohl docmd über integrierte Übersetzungen für gängige Sprachen verfügt, möchten Sie möglicherweise UI-Texte für ein bestimmtes Projekt anpassen (z. B. “Search” in “In der Doku suchen” ändern).

Globale Konfiguration

Sie können Übersetzungen für bestimmte Locales direkt in Ihrer docmd.config.js definieren.

import { defineConfig } from '@docmd/core';

export default defineConfig({
  locales: {
    en: { title: 'English', label: 'English' },
    de: { title: 'German', label: 'Deutsch' }
  },
  plugins: {
    localisation: {
      translations: {
        de: {
          'search.placeholder': 'Dokumentation durchsuchen...',
          'nav.next': 'Nächste Seite',
          'nav.prev': 'Vorherige Seite',
          'toc.title': 'Auf dieser Seite'
        }
      }
    }
  }
});

Verfügbare UI-Keys

Dies sind die am häufigsten verwendeten UI-Strings, die Sie überschreiben können:

Plugin-Beiträge

Wenn Sie ein Plugin entwickeln, können Sie auch neue Übersetzungsschlüssel über den translations-Hook bereitstellen:

export default {
  name: 'mein-plugin',
  translations(localeId) {
    if (localeId === 'de') {
      return { 'meinplugin.status': 'Status' };
    }
    return { 'meinplugin.status': 'Status' };
  }
};