Co-op Translator este un instrument de tip linie de comandă (CLI) care te ajută să traduci fișierele markdown și imaginile din proiectul tău în mai multe limbi. Această secțiune explică cum să folosești instrumentul, prezintă opțiunile CLI disponibile și oferă exemple pentru diverse scenarii de utilizare.
[!NOTE] Pentru lista completă de comenzi și descrierile lor detaliate, consultă Referința de comenzi.
Mai jos găsești câteva situații comune în care poți folosi Co-op Translator, împreună cu comenzile potrivite.
Pentru a traduce întregul proiect (fișiere markdown și imagini) într-o singură limbă, de exemplu coreeană, folosește comanda de mai jos:
translate -l "ko"
Această comandă va traduce toate fișierele markdown și imaginile în coreeană, adăugând traduceri noi fără a șterge cele existente.
[!TIP]
Vrei să vezi ce coduri de limbă sunt disponibile în Co-op Translator? Vizitează secțiunea Limbi suportate din depozit pentru mai multe detalii.
În Phi-3 CookBook, am folosit metoda de mai jos pentru a adăuga traducerea în coreeană pentru fișierele markdown și imaginile existente.
(.venv) C:\Users\sms79\dev\Phi-3CookBook>translate -l"ko"
Translating images: 100%|███████████████████████████████████████████████████| 276/276 [1:09:56<00:00, 15.37s/it]
Translating markdown files: 100%|████████████████████████████████████████████████| 153/153 [1:43:07<00:00, 241.31s/it]
Pentru a traduce proiectul în mai multe limbi (de exemplu, spaniolă, franceză și germană), folosește această comandă:
translate -l "es fr de"
Comanda va traduce proiectul în spaniolă, franceză și germană, adăugând traduceri noi fără a suprascrie cele existente.
În Phi-3 CookBook, după ce am preluat ultimele modificări pentru a reflecta cele mai recente commit-uri, am folosit metoda de mai jos pentru a traduce fișierele markdown și imaginile nou adăugate.
(.venv) C:\Users\sms79\dev\Phi-3CookBook>translate -l"ko ja zh tw es fr" -a
Translating images: 100%|███████████████████████████████████████████████████| 273/273 [1:09:56<00:00, 15.37s/it]
Translating markdown files: 100%|████████████████████████████████████████████████| 6/6 [24:07<00:00, 241.31s/it]
[!NOTE] De obicei, este recomandat să traduci o limbă pe rând, dar în situații ca aceasta, unde trebuie adăugate modificări specifice, traducerea simultană în mai multe limbi poate fi eficientă.
Pentru a actualiza traducerile existente (adică să ștergi traducerile curente și să le înlocuiești cu unele noi), folosește opțiunea -u. Aceasta va șterge toate traducerile existente pentru limbile specificate și le va retraduce.
translate -l "ko" -u
Atenție: Comanda va cere confirmarea înainte de a șterge traducerile existente.
În Phi-3 CookBook, am folosit metoda de mai jos pentru a actualiza toate fișierele traduse în spaniolă. Recomand această metodă când există modificări semnificative în conținutul original din mai multe documente markdown. Dacă ai doar câteva fișiere traduse de actualizat, e mai eficient să le ștergi manual și apoi să folosești metoda -a pentru a adăuga traducerile actualizate.
(.venv) C:\Users\sms79\dev\Phi-3CookBook>translate -l "es" -u
Warning: The update command will delete all existing translations for 'es' and re-translate everything.
Do you want to continue? Type 'yes' to proceed: yes
Proceeding with update...
Translating images: 100%|████████████████████████████████████████████| 150/150 [43:46<00:00, 15.55s/it]
Translating markdown files: 100%|███████████████████████████████████| 95/95 [1:40:27<00:00, 125.62s/it]
Pentru a traduce doar fișierele imagine din proiect, folosește opțiunea -img:
translate -l "ko" -img
Comanda va traduce doar imaginile în coreeană, fără a afecta fișierele markdown.
Pentru a traduce doar fișierele markdown din proiect, folosește opțiunea -md:
translate -l "ko" -md
În Phi-3 CookBook, am folosit metoda de mai jos pentru a verifica erorile de traducere în fișierele coreene și pentru a retraduce automat fișierele cu probleme detectate.
(.venv) C:\Users\sms79\dev\Phi-3CookBook>translate -l"ko" -chk
Checking translated files for errors in ko...
Checking files for ko: 100%|██████████████████████████████████████████████████| 95/95 [00:01<00:00, 65.47file/s]
Retrying vsc-extension-quickstart.md for ko: 0%| | 0/17 [00:00<?, ?file/s]
Această opțiune verifică erorile de traducere. În prezent, dacă diferența de linii între fișierul original și cel tradus este mai mare de șase, fișierul este marcat ca având o eroare de traducere. Plănuiesc să îmbunătățesc acest criteriu pentru mai multă flexibilitate pe viitor.
De exemplu, această metodă este utilă pentru a detecta fragmente lipsă sau traduceri corupte și va retraduce automat acele fișiere.
Totuși, dacă știi deja care fișiere sunt problematice, e mai eficient să le ștergi manual și să folosești opțiunea -a pentru a le retraduce.
Pentru a activa logarea detaliată pentru depanare, folosește opțiunea -d:
translate -l "ko" -d
Comanda va rula traducerea în modul debug, oferind informații suplimentare care te pot ajuta să identifici problemele apărute în procesul de traducere.
În Phi-3 CookBook, am întâmpinat o problemă în care traducerile cu multe linkuri în fișierele markdown generau erori de formatare, cum ar fi traduceri incomplete sau linii ignorate. Pentru a diagnostica problema, am folosit opțiunea -d ca să văd cum funcționează procesul de traducere.
(.venv) C:\Users\sms79\dev\Phi-3CookBook>translate -l "ko" -d
DEBUG:openai._base_client:Request options: {'method': 'post', 'url': '/chat/completions', 'headers': {'api-key': 'af04e0bea45747d8a7b8c131c1971044'}, 'files': None, 'json_data': {'messages': [{'role': 'user', 'content': "Translate the following text to ko. NEVER ADD ANY EXTRA CONTENT OUTSIDE THE TRANSLATION. TRANSLATE ONLY WHAT IS GIVEN TO YOU.. MAINTAIN MARKDOWN FORMAT\n\n# Phi-3 Cookbook: Hands-On Examples with Microsoft's Phi-3 Models [](https://codespaces.new/microsoft/phi-3cookbook) [![Open in Dev Containers](https://img.shields.io/static/v1?style=for-the-badge&label=Dev%
...
Dacă vrei să traduci proiectul în toate limbile suportate, folosește cuvântul cheie all.
[!WARNING] Traducerea în toate limbile simultan poate dura mult timp, în funcție de dimensiunea proiectului. De exemplu, traducerea Phi-3 CookBook în spaniolă a durat aproximativ 2 ore. Având în vedere amploarea, nu este practic ca o singură persoană să gestioneze 20 de limbi. Recomand să împarți munca între mai mulți colaboratori, fiecare ocupându-se de una sau două limbi, și să actualizezi traducerile treptat.
translate -l "all"
Comanda va traduce proiectul în toate limbile disponibile. Dacă continui, traducerea poate dura mult timp, în funcție de dimensiunea proiectului.
[!TIP]
Ștergerea manuală a fișierelor traduse (opțional)
Fișierele traduse sunt acum detectate automat și curățate când un fișier sursă este actualizat.
Totuși, dacă vrei să actualizezi manual o traducere – de exemplu, să refaci un fișier anume sau să suprascrii comportamentul sistemului – poți folosi comanda de mai jos pentru a șterge toate versiunile fișierului din folderele de limbi.
Pe Windows:
- Folosind Command Prompt:
- Deschide Command Prompt.
- Navighează la folderul unde se află fișierele folosind comanda
cd.- Folosește comanda de mai jos pentru a șterge fișierele:
del /s *filename*Înlocuiește
filenamecu partea specifică din numele fișierului pe care îl cauți. Opțiunea/scaută și în subfoldere.- Folosind PowerShell:
- Deschide PowerShell.
- Rulează această comandă:
Get-ChildItem -Path "C:\YourPath" -Filter "*filename*" -Recurse | Remove-Item -ForceÎnlocuiește
"C:\YourPath"cu calea folderului șifilenamecu numele specific.Pe macOS/Linux:
- Folosind Terminal:
- Deschide Terminal.
- Navighează la director cu
cd.- Folosește comanda
find:find . -type f -name "*filename*" -deleteÎnlocuiește
filenamecu numele specific.Verifică întotdeauna fișierele înainte de a le șterge ca să eviți pierderile accidentale.
După ce ai șters fișierele care trebuie înlocuite, rulează din nou comanda
translate -lpentru a actualiza modificările recente ale fișierelor.
Declarație de responsabilitate: Acest document a fost tradus folosind serviciul de traducere AI Co-op Translator. Deși ne străduim să asigurăm acuratețea, vă rugăm să rețineți că traducerile automate pot conține erori sau inexactități. Documentul original, în limba sa nativă, trebuie considerat sursa autoritară. Pentru informații critice, se recomandă traducerea profesională realizată de oameni. Nu ne asumăm răspunderea pentru orice neînțelegeri sau interpretări greșite care pot apărea din utilizarea acestei traduceri.