Skip to content

Latest commit

 

History

History
248 lines (176 loc) · 17.2 KB

File metadata and controls

248 lines (176 loc) · 17.2 KB

Co-op Translator

Erleichtern Sie die Automatisierung und Pflege von Übersetzungen für Ihre edukativen GitHub-Inhalte über mehrere Sprachen hinweg, während Ihr Projekt wächst.

Python 3.10–3.12 Python package License: MIT Downloads Downloads Container: GHCR Code style: black

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

🌐 Mehrsprachige Unterstützung

Unterstützt von Co-op Translator

Arabisch | Bengalisch | Bulgarisch | Birmanisch (Myanmar) | Chinesisch (Vereinfacht) | Chinesisch (Traditionell, Hongkong) | Chinesisch (Traditionell, Macau) | Chinesisch (Traditionell, Taiwan) | Kroatisch | Tschechisch | Dänisch | Niederländisch | Estnisch | Finnisch | Französisch | Deutsch | Griechisch | Hebräisch | Hindi | Ungarisch | Indonesisch | Italienisch | Japanisch | Kannada | Khmer | Koreanisch | Litauisch | Malaiisch | Malayalam | Marathi | Nepalesisch | Nigerianisches Pidgin | Norwegisch | Persisch (Farsi) | Polnisch | Portugiesisch (Brasilien) | Portugiesisch (Portugal) | Punjabi (Gurmukhi) | Rumänisch | Russisch | Serbisch (Kyrillisch) | Slowakisch | Slowenisch | Spanisch | Swahili | Schwedisch | Tagalog (Filipino) | Tamil | Telugu | Thailändisch | Türkisch | Ukrainisch | Urdu | Vietnamesisch

Lieber lokal klonen?

Dieses Repository enthält über 50 Sprachübersetzungen, was die Downloadgröße erheblich erhöht. Um ohne Übersetzungen zu klonen, verwenden Sie sparse checkout:

Bash / macOS / Linux:

git clone --filter=blob:none --sparse https://github.com/Azure/co-op-translator.git
cd co-op-translator
git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'

CMD (Windows):

git clone --filter=blob:none --sparse https://github.com/Azure/co-op-translator.git
cd co-op-translator
git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"

So erhalten Sie alles, was Sie für den Kurs benötigen, mit einem deutlich schnelleren Download.

GitHub watchers GitHub forks GitHub stars

Microsoft Foundry Discord

Open in GitHub Codespaces

Übersicht

Co-op Translator hilft Ihnen, Ihre edukativen GitHub-Inhalte mühelos in mehrere Sprachen zu lokalisieren.
Wenn Sie Ihre Markdown-Dateien, Bilder oder Notebooks aktualisieren, bleiben Übersetzungen automatisch synchronisiert, sodass Ihre Inhalte für Lernende weltweit stets aktuell und korrekt sind.

Beispiel, wie übersetzte Inhalte organisiert sind:

Beispiel

Wie der Übersetzungsstatus verwaltet wird

Co-op Translator verwaltet übersetzte Inhalte als versionierte Software-Artefakte,
nicht als statische Dateien.

Das Tool verfolgt den Status von übersetztem Markdown, Bildern und Notebooks
mit sprachspezifischen Metadaten.

Dieses Design erlaubt Co-op Translator:

  • Zuverlässiges Erkennen von veralteten Übersetzungen
  • Einheitlichen Umgang mit Markdown, Bildern und Notebooks
  • Sichere Skalierung in großen, schnelllebigen, mehrsprachigen Repositories

Indem Übersetzungen als verwaltete Artefakte modelliert werden,
richten sich Übersetzungsprozesse natürlich nach modernen
Software-Abhängigkeits- und Artefaktmanagement-Praktiken aus.

Wie der Übersetzungsstatus verwaltet wird

Schnellstart

# Erstellen und Aktivieren einer virtuellen Umgebung (empfohlen)
python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS/Linux
source .venv/bin/activate
# Paket installieren
pip install co-op-translator
# Übersetzen
translate -l "ko ja fr" -md

Docker:

# Ziehen Sie das öffentliche Image von GHCR
docker pull ghcr.io/azure/co-op-translator:latest
# Führen Sie es mit dem aktuellen Ordner eingebunden und bereitgestellter .env-Datei aus (Bash/Zsh)
docker run --rm -it --env-file .env -v "${PWD}:/work" ghcr.io/azure/co-op-translator:latest -l "ko ja fr" -md

Minimale Einrichtung

  1. Stellen Sie sicher, dass Sie eine unterstützte Python-Version (aktuell 3.10–3.12) verwenden. In poetry (pyproject.toml) wird dies automatisch gehandhabt.
  2. Erstellen Sie eine .env-Datei anhand der Vorlage: .env.template
  3. Konfigurieren Sie einen LLM-Anbieter (Azure OpenAI oder OpenAI)
  4. (Optional) Für die Bildübersetzung (-img) konfigurieren Sie Azure AI Vision
  5. (Optional) Sie können mehrere Anmeldedatensätze konfigurieren, indem Sie Variablen mit Suffixen wie _1, _2, etc. duplizieren. Alle Variablen in einem Satz müssen denselben Suffix teilen.
  6. (Empfohlen) Bereinigen Sie vorherige Übersetzungen, um Konflikte zu vermeiden (z.B. translations/)
  7. (Empfohlen) Fügen Sie in Ihrer README eine Übersetzungssektion mit der README-Sprachvorlage hinzu
  8. Siehe: Azure AI einrichten

Nutzung

Übersetzen aller unterstützten Typen:

translate -l "ko ja"

Nur Markdown:

translate -l "de" -md

Markdown + Bilder:

translate -l "pt" -md -img

Nur Notebooks:

translate -l "zh" -nb

Weitere Optionen: Befehlsreferenz

Funktionen

  • Automatisierte Übersetzung für Markdown, Notebooks und Bilder
  • Hält Übersetzungen synchron mit Quelländerungen
  • Funktioniert lokal (CLI) oder in CI (GitHub Actions)
  • Verwendet Azure OpenAI oder OpenAI; optional Azure AI Vision für Bilder
  • Bewahrt Markdown-Formatierung und -Struktur

Dokumentation

Microsoft-spezifische Anleitung

Note

Nur für Maintainer der Microsoft „Für Anfänger“ Repositories.

Unterstützen Sie uns und fördern Sie globales Lernen

Begleiten Sie uns bei der Revolutionierung, wie edukative Inhalte weltweit geteilt werden! Geben Sie Co-op Translator auf GitHub einen ⭐ und unterstützen Sie unsere Mission, Sprachbarrieren im Lernen und in der Technologie abzubauen. Ihr Interesse und Ihre Beiträge machen einen bedeutenden Unterschied! Code-Beiträge und Feature-Vorschläge sind stets willkommen.

Erkunden Sie Microsoft-Bildungsinhalte in Ihrer Sprache

Videopräsentationen

👉 Klicken Sie auf das Bild unten, um es auf YouTube anzuschauen.

  • Open at Microsoft: Eine kurze Einführung von 18 Minuten und Schnellstart-Anleitung zur Nutzung von Co-op Translator.

    Open at Microsoft

Beitragen

Dieses Projekt freut sich über Beiträge und Vorschläge. Interessieren Sie sich für eine Mitarbeit am Azure Co-op Translator? Bitte lesen Sie unsere CONTRIBUTING.md für Richtlinien, wie Sie Co-op Translator zugänglicher machen können.

Mitwirkende

co-op-translator contributors

Verhaltenskodex

Dieses Projekt hat den Microsoft Open Source Code of Conduct übernommen.
Weitere Informationen finden Sie in den FAQ zum Verhaltenskodex oder
kontaktieren Sie opencode@microsoft.com bei weiteren Fragen oder Anmerkungen.

Verantwortungsvolle KI

Microsoft setzt sich dafür ein, unseren Kunden zu helfen, unsere KI-Produkte verantwortungsvoll zu nutzen, unsere Erkenntnisse zu teilen und vertrauensbasierte Partnerschaften durch Tools wie Transparenznotizen und Auswirkungen-Bewertungen aufzubauen. Viele dieser Ressourcen finden Sie unter https://aka.ms/RAI.
Der Ansatz von Microsoft für verantwortungsvolle KI basiert auf unseren KI-Prinzipien Fairness, Zuverlässigkeit und Sicherheit, Datenschutz und Sicherheit, Inklusivität, Transparenz und Verantwortlichkeit.

Großangelegte Modelle für natürliche Sprache, Bilder und Sprache – wie die in diesem Beispiel verwendeten – können sich potenziell unfair, unzuverlässig oder anstößig verhalten und dadurch Schäden verursachen. Bitte konsultieren Sie die Transparenznotiz des Azure OpenAI-Dienstes, um über Risiken und Einschränkungen informiert zu sein.

Der empfohlene Ansatz zur Minderung dieser Risiken besteht darin, ein Sicherheitssystem in Ihre Architektur zu integrieren, das schädliches Verhalten erkennen und verhindern kann. Azure AI Content Safety bietet eine unabhängige Schutzschicht, die in der Lage ist, schädliche, von Benutzern oder KI erzeugte Inhalte in Anwendungen und Diensten zu erkennen. Azure AI Content Safety umfasst Text- und Bild-APIs, mit denen Sie schädliche Inhalte erkennen können. Wir bieten auch ein interaktives Content Safety Studio, das Ihnen ermöglicht, Beispielcodes zur Erkennung schädlicher Inhalte in verschiedenen Modalitäten anzusehen, zu erkunden und auszuprobieren. Die folgende Schnellstart-Dokumentation führt Sie durch das Stellen von Anfragen an den Dienst.

Ein weiterer zu berücksichtigender Aspekt ist die Gesamtleistung der Anwendung. Bei multimodalen und multimodellspezifischen Anwendungen verstehen wir unter Leistung, dass das System so funktioniert, wie Sie und Ihre Benutzer es erwarten, einschließlich der Vermeidung schädlicher Ausgaben. Es ist wichtig, die Leistung Ihrer Gesamtanwendung mit Generierungsqualität sowie Risiko- und Sicherheitsmetriken zu bewerten.

Sie können Ihre KI-Anwendung in Ihrer Entwicklungsumgebung mit dem prompt flow SDK evaluieren. Basierend auf einem Testdatensatz oder einem Ziel werden Ihre generativen KI-Anwendungsergebnisse quantitativ mit eingebauten oder benutzerdefinierten Evaluatoren gemessen. Um mit dem Prompt Flow SDK zur Bewertung Ihres Systems zu starten, können Sie der Schnellstartanleitung folgen. Nach Ausführung eines Evaluationslaufs können Sie die Ergebnisse im Azure AI Studio visualisieren.

Marken

Dieses Projekt kann Marken oder Logos für Projekte, Produkte oder Dienste enthalten. Die autorisierte Verwendung von Microsoft-Marken oder -Logos unterliegt und muss den Microsoft Trademark & Brand Guidelines entsprechen.
Die Verwendung von Microsoft-Marken oder -Logos in modifizierten Versionen dieses Projekts darf keine Verwirrung stiften oder eine Microsoft-Unterstützung suggerieren.
Die Verwendung von Marken oder Logos Dritter unterliegt den jeweiligen Richtlinien dieser Dritten.

Hilfe erhalten

Wenn Sie nicht weiterkommen oder Fragen zum Erstellen von KI-Apps haben, treten Sie bei:

Microsoft Foundry Discord

Wenn Sie Produktfeedback oder Fehler beim Erstellen melden möchten, besuchen Sie:

Microsoft Foundry Developer Forum


Haftungsausschluss:
Dieses Dokument wurde mit dem KI-Übersetzungsdienst Co-op Translator übersetzt. Obwohl wir uns um Genauigkeit bemühen, beachten Sie bitte, dass automatische Übersetzungen Fehler oder Ungenauigkeiten enthalten können. Das Originaldokument in seiner Originalsprache ist als maßgebliche Quelle zu betrachten. Für kritische Informationen wird eine professionelle menschliche Übersetzung empfohlen. Wir übernehmen keine Haftung für Missverständnisse oder Fehlinterpretationen, die aus der Verwendung dieser Übersetzung entstehen.