Mit KI übersetzte offizielle Angular-Dokumentation
(angular-kr-docs.web.app)Hallo! Vor Kurzem bin ich zum Angular-Projekt dazugestoßen und hatte wegen des Mangels an koreanischem Material einige Schwierigkeiten.
Deshalb habe ich ein Open-Source-Projekt für KI-Übersetzungen genutzt, um die offizielle Angular-Dokumentation in nur 5 Stunden auf Koreanisch zu lokalisieren und anschließend zu veröffentlichen.
Derzeit wurde größtenteils nur eine erste Rohübersetzung mit KI erstellt!
Fortschritt der Übersetzung
- Rund 300
md-Dateien übersetzt - Zusätzliche Übersetzung von Dateien wie HTML-Dateien, die nicht automatisch übersetzt wurden
- Zentrale Konzepte können zusammen mit Codebeispielen auf Koreanisch verstanden werden
- Benötigte Inhalte lassen sich dank derselben Struktur wie im englischen Original leicht finden
Ich habe tatsächlich überlegt, ob ich die Kategorie Show GN nutzen soll, um die übersetzte Angular-Dokumentation vorzustellen, oder die Kategorie News, um das Übersetzungstool vorzustellen.
Auch wenn es vielleicht nicht viele Menschen gibt, die Angular nutzen, habe ich mich für Show GN entschieden, in der Hoffnung, dass es denen helfen könnte, die koreanisches Material suchen!
Verwendete Tools
Ich habe ein kleines Projekt namens "ai-markdown-translator" entdeckt, und das Ergebnis war besser als erwartet.
Es hat mir ziemlich gut gefallen, daher habe ich das Repository geforkt und arbeite gerade daran, den Code zu ändern, um zum Projekt beizutragen.
Vorteile
- Open-Source-Projekt, das auf die Übersetzung von Markdown-Dokumenten spezialisiert ist
- Dateien mit bestimmten Erweiterungen in einem Ordner können rekursiv übersetzt werden
- Übersetzung auf einmal mit dem Befehl
npx ai-markdown-translator -i . -e md -l "Korean" --log - Übersetzt unter weitgehender Beibehaltung von Syntaxstruktur und Markdown-Format
- Geeignet für technische Dokumentation, bei der Seiten auf Basis von MD-Inhalten erstellt werden
Einschränkungen
- Wörtliche Übersetzungen von Fachbegriffen, etwa wenn Signal als „Signal“ übersetzt wird, sind etwas unbefriedigend
- Es wurde ein Problem entdeckt, bei dem einige Dateiverweis-Pfade falsch geändert werden
- Da es sich um eine Rohübersetzung handelt, gibt es noch Bereiche, die verbessert werden müssen
Übersetzungs- und Bereitstellungsprozess
- Das offizielle Angular-Dokumentations-Repository klonen
- Befehl ausführen und nach 2 Stunden rund 300 Dateien übersetzt
- Falsch geänderte Dateiverweis-Pfade korrigieren
- Unter Bezug auf die Firebase-Einstellungen des bestehenden Angular-Projekts die Bereitstellung durchführen
Es gibt noch vieles, das überarbeitet werden muss und nach und nach geprüft und korrigiert werden sollte, aber gemessen an der investierten Zeit ist das Ergebnis ziemlich ordentlich geworden.
Wer technische Dokumentation im MD-Format übersetzen möchte, dem kann ich nur empfehlen, es einmal zu testen!!
Vielen Dank fürs Lesen des langen Beitrags! Ich wünsche euch einen schönen Tag!! ❤️🔥
4 Kommentare
Wow! Angular!
...! Nutzt du Angular?
In letzter Zeit scheint es in Korea kaum noch Nutzer zu geben, deshalb freue ich mich total, dass du einen Kommentar hinterlassen hast! haha
Ich kann kein React und nur ein bisschen Angular, aber es freut mich, in der koreanischen Community einen Artikel über Angular zu sehen.
Ich habe nur React benutzt und bin dann zu Angular gewechselt, hier ist es also genau umgekehrt, haha.
Wenn sich irgendwann die Gelegenheit ergibt, schreibe ich vielleicht noch einmal einen Angular-Artikel,,, hehe