README.de.md

Ein Befehlszeilen-Interface-Tool zur automatischen Übersetzung von .xcstring Katalogen mit OpenAI.

Englisch · Chinesisch (vereinfacht) · Französisch · Spanisch · Deutsch

Setup · Verwendung · Konfiguration · Markdown · Häufige Probleme · Motivation · Mitwirken · Mitwirkende

tranzlate_demo.mov

Tranzlate CLI Interface

Setup

Die Minimum unterstützte Version von Node.js ist v14

1. Installiere tranzlate global:

   npm install -g tranzlate.js

2. Hole deinen API-Schlüssel von OpenAI

   Hinweis: Wenn du noch kein Konto hast, musst du dich registrieren und die Rechnungsstellung einrichten.

3. Setze den Schlüssel, damit tranzlate ihn verwenden kann. Du kannst dies tun, indem du folgenden Befehl ausführst:

   echo export OPENAI_API_KEY=<Dein Token> >> ~/.bashrc

   Alternativ kannst du den Schlüssel angeben, wenn du den Befehl ausführst

Verwendung

tranzlate

Dann erhältst du eine Ausgabe wie diese, die dich durch den Prozess der Übersetzung eines String-Katalogs führt:

┌   tranzlate: automatische String-Übersetzung
│
◇  Gib die Eingabe-Datei ein
│  Localizable.xcstrings
│
◇  Gib die Ausgabe-Datei ein
│  Localizable.xcstrings
│
◆  Wähle die zu übersetzenden Sprachen aus.
│  ◻ Arabisch
│  ◻ Katalanisch
│  ◻ Chinesisch (vereinfacht)
│  ◻ Chinesisch (traditionell)
│  ◻ Kroatisch
│  ◼ Tschechisch
│  ◼ Dänisch
│  ◻ Holländisch
│  ◻ Englisch
│  ◻ Englisch (Australien)
│  ◻ Englisch (Kanada)
│  ◻ Englisch (U.K.)
│  ◻ Englisch (U.S.)
│  ◻ Finnisch
│  ◻ Französisch
│  ◻ Französisch (Kanada)
│  ◻ Deutsch
│  ◻ Griechisch
│  ◻ Hebräisch
│  ◻ Hindi
│  ◻ Ungarisch
│  ◼ Indonesisch
│  ◻ Italienisch
│  ◻ Japanisch
│  ◻ Koreanisch
│  ◻ Malay
│  ◻ Norwegisch
│  ◻ Polnisch
│  ◼ Portugiesisch (Brasilien)
│  ◻ Portugiesisch (Portugal)
│  ◻ Rumänisch
│  ◻ Russisch
│  ◻ Slowakisch
│  ◻ Spanisch (Mexiko)
│  ◼ Spanisch (Spanien)
│  ◻ Schwedisch
│  ◻ Thailändisch
│  ◻ Türkisch
│  ◼ Ukrainisch
└  ◻ Vietnamesisch

Konfiguration

multiple-languages.mov

Da es ironisch wäre, als Übersetzungstool nur eine einzige Sprache zu unterstützen, unterstützen wir das Ändern Ihrer Konfigurationssprache. Du kannst deine Sprache einstellen, indem du folgendes ausführst:

tranzlate set-language <Sprache>

Wo <Sprache> eine der folgenden ist:

Sprache	Schlüssel
Englisch	en
Vereinfachtes Chinesisch	zh-Hans
Traditionelles Chinesisch	zh-Hant
Spanisch	es
Japanisch	ja
Koreanisch	ko
Französisch	fr
Deutsch	de
Russisch	ru
Ukrainisch	uk
Vietnamesisch	vi
Arabisch	ar
Portugiesisch	pt-BR
Türkisch	tr

Zum Beispiel, wenn du auf Vereinfachtes Chinesisch wechseln möchtest, kannst du das tun, indem du den LANGUAGE-Wert auf zh-Hans setzt:

tranzlate set-language zh-Hans

Dadurch wird deine Sprache auf Vereinfachtes Chinesisch eingestellt.

Markdown

Die Unterstützung für Markdown-Übersetzungen wird unterstützt. Um in den Markdown-Modus zu wechseln, führe aus:

tranzlate markdown

Du wirst aufgefordert, eine Markdown-Datei oder eine Glob-Datei zur Übersetzung einzugeben. Die Ausgabeübersetzungen fügen den ISO-Sprachcode am Ende jedes Dateinamens an. Zum Beispiel, wenn du README.md ins Vereinfachte Chinesisch (zh-Hans) übersetzt, wird die Ausgabedatei README.zh-Hans.md sein.

┌   tranzlate: automatische markdown Übersetzung
│
◇  Gib eine markdown Datei oder Glob ein
│  ./README.md
│
◇  Wähle die zu übersetzenden Sprachen aus
│  fi - Finnisch, hu - Ungarisch, pl - Polnisch, ru - Russisch
│
◇  Wähle ein Modell aus
│  gpt-3.5-turbo
◆  Übersetzung von README.md...

Hinweis: Die Markdown-Übersetzung befindet sich in der Beta-Phase. Bitte melde alle Probleme, auf die du stößt.

Häufige Probleme

429 Fehler

Einige Benutzer melden einen 429 von OpenAI. Dies liegt an einer falschen Rechnungsstellungseinstellung oder übermäßiger Quotennutzung. Bitte folgen Sie dieser Anleitung, um das zu beheben.

Sie können die Abrechnung unter diesem Link aktivieren. Stellen Sie sicher, dass Sie eine Zahlungsmethode hinzufügen, wenn Sie nicht unter einer aktiven Förderung von OpenAI stehen.

Motivation

Ich bin kein Sprachexperte. Meine Übersetzungskompetenz erstreckt sich nur auf Spanisch auf Mittelschulniveau. Aber ich glaube an Software und ihre Bedeutung. Für wen die Software entwickelt wird, ist wichtig. Lokalisierung ist kein und sollte nie ein nachträglicher Gedanke sein. Durch die Nutzung von KI-Übersetzungstools können Gespräche über die Auswirkungen von Software auf verschiedene Gemeinschaften früher in der Produktentwicklung und nicht später geführt werden.

Die Beschleunigung von Gesprächen über die Auswirkungen von Software führt zu bedeutenden Veränderungen, bevor die Merkmalssets festgelegt sind. Deshalb glaube ich an die Macht von, oft unvollkommenen, KI-Übersetzungstools. Lass das Perfekte nicht der Feind des Guten sein.

Einfache Übersetzung, von Zeichenketten-Katalogen, und hoffentlich noch vielen weiteren Dateiformaten ist der Grund, warum ich tranzlate erstellt habe.

Mitwirken

Wenn Sie einen Bug beheben oder ein Feature in Problemen implementieren möchten, tun Sie das bitte. Swift-Entwicklung ist für mich etwas Neues, daher würde ich die Rückmeldung der Community zu schätzen wissen.

Mitwirkende

Danke an ai-shell für ihre README, die ich als Vorlage verwendet habe.