App-Greple-xlate
view release on metacpan or search on metacpan
i18n/src/xlate.deepl-RO.pod view on Meta::CPAN
=encoding utf-8
=head1 NAME
App::Greple::xlate - modul de suport pentru traducere pentru Greple
=head1 SYNOPSIS
greple -Mxlate --xlate-engine gpt5 --xlate pattern target-file
greple -Mxlate --xlate-engine deepl --xlate pattern target-file
=head1 VERSION
Version 2.02
=head1 DESCRIPTION
B<Greple> B<xlate> modulul găsește blocurile de text dorite și le înlocuiește cu textul tradus. Motorul principal este GPT-5.6 Terra (F<llm/gpt5.pm>), care apelează comanda L<llm|https://llm.datasette.io/>; sunt incluse, de asemenea, DeepL (F<d...
Traducerile sunt stocate în cache pentru fiecare fișier, astfel încât rulați din nou o comandă nu implică costuri suplimentare pentru textul nemodificat. Când un document este editat, doar paragrafele modificate sunt trimise din nou către AP...
Dacă doriți să traduceți blocuri de text normale dintr-un document scris în stilul pod al limbajului Perl, utilizați comanda B<greple> împreună cu modulele C<--xlate-engine gpt5> și C<perl> astfel:
greple -Mxlate --xlate-engine gpt5 -Mperl --pod --re '^([\w\pP].*\n)+' --all foo.pm
În această comandă, șirul de modele C<^([\w\pP].*\n)+> înseamnă linii consecutive care încep cu litere alfanumerice și de punctuație. Această comandă afișează evidențiată zona care urmează să fie tradusă. Opțiunea B<--all> este uti...
=for html <p>
<img width="750" src="https://raw.githubusercontent.com/kaz-utashiro/App-Greple-xlate/main/images/select-area.png">
</p>
Apoi adăugați opțiunea C<--xlate> pentru a traduce zona selectată. Astfel, se vor identifica secțiunile dorite și se vor înlocui cu rezultatul generat de motorul de traducere.
În mod implicit, textul original și cel tradus sunt tipărite în formatul "conflict marker" compatibil cu L<git(1)>. Utilizând formatul C<ifdef>, puteți obține cu ușurință partea dorită prin comanda L<unifdef(1)>. Formatul de ieșire poate ...
=for html <p>
<img width="750" src="https://raw.githubusercontent.com/kaz-utashiro/App-Greple-xlate/main/images/format-conflict.png">
</p>
Dacă doriți să traduceți întregul text, utilizați opțiunea B<--match-all>. Aceasta este o scurtătură pentru a specifica modelul C<(?s).+> care se potrivește cu întregul text.
Datele din formatul markerului de conflict pot fi vizualizate în stil paralel prin comanda L<sdif|App::sdif> cu opțiunea C<-V>. Deoarece nu are sens să comparați fiecare șir de caractere, este recomandată opțiunea C<--no-cdif>. Dacă nu trebui...
sdif -V --no-filename --no-tc --no-cdif data_shishin.deepl-EN-US.cm
=for html <p>
<img width="750" src="https://raw.githubusercontent.com/kaz-utashiro/App-Greple-xlate/main/images/sdif-cm-view.png">
</p>
=head1 NORMALIZATION
Prelucrarea se face în unități specificate, dar în cazul unei secvențe de linii multiple de text nevid, acestea sunt convertite împreună într-o singură linie. Această operațiune se efectuează după cum urmează:
=over 2
=item *
Se elimină spațiul alb de la începutul și sfârșitul fiecărei linii.
=item *
Dacă o linie se termină cu un caracter de punctuație de lățime maximă, concatenarea se face cu linia următoare.
=item *
Dacă o linie se termină cu un caracter de lățime întreagă și următoarea linie începe cu un caracter de lățime întreagă, se concatenează liniile.
=item *
Dacă sfârșitul sau începutul unei linii nu este un caracter de lățime maximă, concatenați-le prin inserarea unui caracter de spațiu.
=back
Datele din cache sunt gestionate pe baza textului normalizat, astfel încât, chiar dacă sunt efectuate modificări care nu afectează rezultatele normalizării, datele de traducere din cache vor fi în continuare eficiente.
Acest proces de normalizare se efectuează numai pentru primul model (al 0-lea) și pentru cel cu număr par. Astfel, dacă sunt specificate două modele după cum urmează, textul care corespunde primului model va fi prelucrat după normalizare și ...
greple -Mxlate -E normalized -E not-normalized
Prin urmare, utilizaÈ›i primul model pentru textul care urmează să fie prelucrat prin combinarea mai multor linii într-o singură linie È™i utilizaÈ›i al doilea model pentru textul preformattat. Dacă nu există niciun text care să se potriveascÄ...
=head1 MASKING
Ocazional, există părți de text pe care nu le doriți traduse. De exemplu, etichetele din fișierele markdown. DeepL sugerează ca, în astfel de cazuri, partea de text care trebuie exclusă să fie convertită în etichete XML, tradusă și apoi ...
--xlate-setopt maskfile=MASKPATTERN
Acest lucru va interpreta fiecare linie a fișierului C<MASKPATTERN> ca o expresie regulată, va traduce șirurile care se potrivesc și va reveni la starea inițială după procesare. Liniile care încep cu C<#> sunt ignorate.
Modelele complexe pot fi scrise pe mai multe linii, cu caracterul de linie nouă precedat de o bară oblică inversă.
Modul în care textul este transformat prin mascare poate fi văzut prin opțiunea B<--xlate-mask>.
Marcatorii de substituție sunt etichete XML auto-închise, bine formate, precum C<< <m id="1" /> >>. Motoarele LLM bazate pe JSON primesc etichetele în matricile lor de intrare. Pentru DeepL, o cerere care conține etichete de marcator este escapat...
Mascarea protejează marcajul împotriva traducerii. Pentru a ascunde șirurile sensibile chiar de serviciul de traducere, consultați L</ANONYMIZATION AND TEMPLATES>; ambele opțiuni pot fi utilizate împreună.
Această interfață este experimentală și poate fi modificată în viitor.
=head1 ANONYMIZATION AND TEMPLATES
Șirurile sensibile pot fi ascunse înainte de a fi trimise către API-ul de traducere și restabilite în ieșire. Sunt disponibile trei surse de reguli de anonimizare: un fișier dicționar (B<--xlate-anonymize>), marcaje încorporate în documentu...
Pentru documentele de tip formular (rapoarte trimestriale și altele asemenea), definiți actorii de la început și faceți referire la ei în corpul textului:
---
å ±å‘Šè€…: 山田太郎
i18n/src/xlate.deepl-RO.pod view on Meta::CPAN
=item --xlate-cache=I<strategy>
=over 4
=item C<auto> (Default)
Menține fișierul cache dacă acesta există.
=item C<create>
Creează un fișier cache gol și iese.
=item C<always>, C<yes>, C<1>
Menține oricum memoria cache în măsura în care fișierul țintă este un fișier normal.
=item C<clear>
Ștergeți mai întâi datele din memoria cache.
=item C<never>, C<no>, C<0>
Nu utilizează niciodată fișierul cache, chiar dacă există.
=item C<accumulate>
Prin comportament implicit, datele neutilizate sunt eliminate din fișierul cache. Dacă nu doriți să le eliminați și să le păstrați în fișier, utilizați C<acumulare>.
=back
=item B<--xlate-update>
Această opțiune forțează actualizarea fișierului cache chiar dacă nu este necesar.
=back
=head1 COMMAND LINE INTERFACE
Puteți utiliza cu ușurință acest modul din linia de comandă folosind comanda C<xlate> inclusă în distribuție. Consultați pagina de manual C<xlate> pentru utilizare.
Comanda C<xlate> acceptă opțiuni lungi în stil GNU, precum C<--to-lang>, C<--from-lang>, C<--engine> și C<--file>. Utilizați C<xlate -h> pentru a vedea toate opțiunile disponibile.
Comanda C<xlate> funcționează de comun acord cu mediul Docker, astfel încât, chiar dacă nu aveți nimic instalat la îndemână, îl puteți utiliza atâta timp cât Docker este disponibil. Utilizați opțiunea C<-D> sau C<-C>.
Operațiunile Docker sunt gestionate de L<App::dozo>, care poate fi utilizată și ca o comandă de sine stătătoare. Comanda C<dozo> acceptă fișierul de configurare C<.dozorc> pentru setările persistente ale containerului.
De asemenea, deoarece sunt furnizate makefile-uri pentru diferite stiluri de documente, traducerea în alte limbi este posibilă fără specificații speciale. Utilizați opțiunea C<-M>.
De asemenea, puteți combina opțiunile Docker și C<make> astfel încât să puteți rula C<make> într-un mediu Docker.
Executarea ca C<xlate -C> va lansa un shell cu depozitul git de lucru curent montat.
Citiți articolul japonez din secțiunea L</SEE ALSO> pentru detalii.
=head1 EMACS
Încărcați fișierul F<xlate.el> inclus în depozit pentru a utiliza comanda C<xlate> din editorul Emacs. Funcția C<xlate-region> traduce regiunea dată. Limba implicită este C<EN-US> și puteți specifica limba invocând-o cu argumentul prefix.
=for html <p>
<img width="750" src="https://raw.githubusercontent.com/kaz-utashiro/App-Greple-xlate/main/images/emacs.png">
</p>
=head1 ENVIRONMENT
=over 7
=item DEEPL_AUTH_KEY
Setați cheia de autentificare pentru serviciul DeepL.
=item OPENAI_API_KEY
Cheia de autentificare OpenAI, utilizată de motoarele vechi B<gpty>. Motorul B<gpt5> bazat pe C<llm> citește și această variabilă, dar funcționează și cheile stocate cu C<llm keys set openai>.
=item GREPLE_XLATE_CACHE
Setați strategia implicită de cache (consultați L</CACHE OPTIONS>).
=back
=head1 INSTALL
=head2 CPANMINUS
$ cpanm App::Greple::xlate
=head2 TOOLS
Instalați instrumentul de linie de comandă pentru motorul pe care îl utilizați: C<llm> pentru motorul B<gpt5>, C<deepl> pentru DeepL, C<gpty> pentru motoarele GPT vechi.
L<https://llm.datasette.io/>
L<https://github.com/DeepLcom/deepl-python>
L<https://github.com/tecolicom/App-gpty>
=head1 SEE ALSO
=head2 MODULES
L<App::Greple::xlate::llm>, L<App::Greple::xlate::deepl>
L<App::dozo> - Docker runner generic utilizat de xlate pentru operațiunile cu containere
=head2 RELATED MODULES
=over 2
=item * L<App::Greple>
Consultați manualul B<greple> pentru detalii despre modelul de text țintă. Utilizați opțiunile B<--inside>, B<--outside>, B<--include>, B<--exclude> pentru a limita zona de potrivire.
=item * L<App::Greple::update>
Puteți utiliza modulul C<-Mupdate> pentru a modifica fișierele în funcție de rezultatul comenzii B<greple>.
=item * L<App::sdif>
Folosiți B<sdif> pentru a afișa formatul markerilor de conflict unul lângă altul cu opțiunea B<-V>.
( run in 2.511 seconds using v1.01-cache-2.11-cpan-364913b4093 )