ForHosting KIT · Übersetzung

Code-Kommentare übersetzen

Dieses Werkzeug übersetzt Kommentare und Docstrings innerhalb einer Quellcode-Datei in eine andere Sprache und lässt Funktionsnamen, Variablen, Syntax und Logik unverändert. Gedacht für Entwicklerteams, die internen, auf Deutsch kommentierten Code für ein internationales Team oder ein offenes Projekt zugänglich machen wollen.

● Betapro Anfrage + pro 1.000 Wörter$0.003
Nutzen Sie es über WebAPIE-MailApp baldTelegram bald

Führen Sie dies mit Ihrem Konto auf unseren Servern aus. Kostenlose Tools laufen in Ihrem Browser; dieses wird zum oben genannten Preis von Ihrem KIT-Guthaben abgebucht.

Was erkannt und übersetzt wird

Zeilenkommentare, Blockkommentare und Docstrings werden anhand der jeweiligen Sprachsyntax erkannt, etwa doppelte Schrägstriche, Rautenzeichen oder dreifache Anführungszeichen, je nach Programmiersprache. Übersetzt wird ausschließlich der Text innerhalb dieser Kommentare; Funktionsnamen, Variablennamen, Zeichenketten im eigentlichen Programmcode und die Einrückung bleiben unverändert, sodass die Datei nach der Übersetzung weiterhin fehlerfrei kompiliert oder ausgeführt werden kann. Auch Zeichenketten, die im Programmcode selbst als Text ausgegeben werden, bleiben unangetastet.

Codebeispiele innerhalb von Kommentaren

Enthält ein Docstring ein kurzes Codebeispiel, etwa einen Beispielaufruf einer Funktion, bleibt dieses Beispiel unverändert stehen, während der erklärende Text davor und danach übersetzt wird. Diese Unterscheidung folgt derselben Logik wie bei der Markdown-Übersetzung, bei der Codeblöcke ebenfalls von der Übersetzung ausgenommen sind. So bleibt eine Dokumentation aus Text und Beispielcode auch nach der Übersetzung technisch korrekt und unmittelbar nachvollziehbar.

Preis

$0.003 pro Anfrage plus $0.0135 je 1.000 Wörter des Kommentartextes, ohne den eigentlichen Code. Eine Datei mit vielen Funktionen, aber wenigen Kommentaren, kostet entsprechend wenig; eine ausführlich dokumentierte Bibliothek mit langen Docstrings entsprechend mehr. Der Betrag richtet sich also nach der Menge an Erklärtext, nicht nach der Zeilenzahl des Codes insgesamt. Der genaue Betrag wird vor dem Absenden angezeigt, ohne Abonnement und ohne Mindestbestellwert je Datei.

Nutzung

Die Quellcode-Datei wird auf dieser Seite eingefügt oder hochgeladen und mit übersetzten Kommentaren zurückgegeben, oder über die API in eine bestehende Build- oder Dokumentationskette eingebunden, etwa vor der Veröffentlichung eines internen Projekts als offenes Projekt. Diese Fähigkeit befindet sich in der Beta-Phase und wird bei seltenen Kommentarformaten weiter verfeinert. Für README-Dateien und separate Dokumentationsseiten eignet sich das Schwesterwerkzeug für Markdown-Übersetzung.

Das interne Projekt wird zum offenen Projekt

Ein Entwicklerteam von Schneider IT-Systeme GmbH & Co. KG übersetzt die deutschen Kommentare eines internen Projekts ins Englische, bevor der Quellcode als offenes Projekt veröffentlicht wird.

Die Übergabe an ein Entwicklerteam in Polen

Vor der Übergabe eines Moduls an ein Entwicklerteam in Polen lässt Jonas Weber die deutschen Codekommentare ins Englische übersetzen, damit die Logik ohne Rückfragen nachvollziehbar bleibt.

Die Bibliothek mit ausführlichen Docstrings

Lukas Fischer übersetzt die Docstrings einer selbst geschriebenen Bibliothek ins Englische, damit sie sich in der internationalen Paketverwaltung verständlich veröffentlichen lässt.

Wird der eigentliche Code verändert?

Nein, Funktionsnamen, Variablen, Zeichenketten im Programmcode und die Einrückung bleiben unverändert; übersetzt werden ausschließlich Kommentare und Docstrings.

Erkennt das Werkzeug verschiedene Programmiersprachen?

Ja, die gängigen Kommentar- und Docstring-Formate mehrerer verbreiteter Programmiersprachen werden erkannt.

Was passiert mit Codebeispielen innerhalb eines Docstrings?

Sie bleiben unverändert stehen, nur der erklärende Text davor und danach wird übersetzt.

Was kostet die Übersetzung von Codekommentaren?

$0.003 pro Anfrage plus $0.0135 je 1.000 Wörter Kommentartext, ohne den eigentlichen Code.

Wird die hochgeladene Datei gespeichert?

Nein, sie wird zur Übersetzung verarbeitet und danach nicht aufbewahrt; ein Konto ist nicht erforderlich.

Ist diese Funktion schon ausgereift?

Sie befindet sich in der Beta-Phase und wird bei seltenen oder unüblichen Kommentarformaten weiter verfeinert.

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

POSThttps://api.kit.forhosting.com/translate/code-comments

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

curl -X POST https://api.kit.forhosting.com/translate/code-comments \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"…"}'
{
  "text": "…"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "translate.code_comments",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

pro Anfrage$0.003
pro 1.000 Wörter$0.0135

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

max_tokens20000
HTTPCodeBedeutung
401unauthorizedDer API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
402insufficient_balanceIhr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
404unknown_typeUnbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
429rate_limitedZu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.
422task_failedDie Aufgabe ist fehlgeschlagen und wird nicht berechnet.

Vollständige KIT-Dokumentation lesen →