Acest repertoriu găzduiește conținutul în limba română pentru The Modern JavaScript Tutorial, publicat în https://javascript.info.
- Consultați acest issue Romanian Translate Progress.
- Alegeți un articol nebifat pe care doriți să îl traduceți.
- Adăugați un comentariu cu titlul articolului la issue, e.g.
An Introduction to JavaScript
.- Bot-ul nostru îl va marca automat în issue pentru ca toată lumea să știe că îl traduceți.
- Comentariul trebuie să conțină doar titlul.
- Faceți un fork la repository, traduceți și apoi trimiteți un PR când ați terminat.
- Titlul din PR trebuie să se potrivească cu titlul articolului, bot-ul va scrie automat numărul acestuia în issue.
Vedeți https://javascript.info/translate pentru mai multe detalii.
Vă rugăm să păstrați liniile și paragrafele "așa cum sunt": nu adăugați linii noi și nu le eliminați pe cele existente. Asta facilitează îmbinarea viitoarelor modificări din versiunea engleză în traducere.
Dacă vedeți că versiunea în limba engleză poate fi îmbunătățită - grozav, vă rugăm să trimiteți un PR pentru asta în versiunea din limba engleză. Îmbunătățirile vor fi adăugate și în limba română după ce sunt integrate acolo mai întăi.
- Unii termeni din specificații nu trebuie traduși, spre exemplu, "Function Declaration" poate fi lăsat "așa cum este".
- Pentru alți termeni, cum ar fi
resolved promise
,slash
,regexp
și așa mai departe căutați un glosar bun.- Dacă nu există un dicționar, căutați traduceri în manuale, cum ar fi MDN.
- Traduceți comentariile și mesajele din string.
- Nu traduceți variabile, clase, identificatori.
- Verificați dacă funcționează codul după traducere :)
Exemplu de cod:
// Example
const text = 'Hello, world';
document.querySelector('.hello').innerHTML = text;
✅ Așa da:
// Exemplu
const text = 'Bună ziua`
document.querySelector('.hello').innerHTML = text;
// traduceți comentariul și mesajul text
❌ Așa nu:
// Exemplu
const text = 'Bună ziua lume';
document.querySelector('.salut').innerHTML = text;
// ".salut" este o clasă
// NU se traduce
Dacă un link extern este către Wikipedia, de exemplu https://en.wikipedia.org/wiki/JavaScript
, și există o versiune a articolului respectiv în limba română de o calitate decentă, folosiți link-ul către acea versiune.
Exemplu:
[JavaScript](https://en.wikipedia.org/wiki/JavaScript) is a programming language.
✅ Așa da:
[JavaScript](https://ro.wikipedia.org/wiki/JavaScript) este un limbaj de programare.
Dacă un articol cu link nu are o versiune tradusă, lăsați link-ul "așa cum este".
Unele fișiere, de obicei tasks, au metadate YAML în partea de sus, delimitate prin ---
:
importance: 5
---
Vă rugăm să nu traduceți "importance" (și alte metadate de acolo).
Unele anteturi au [#anchor]
la sfârșit, de ex:
## Spread operator [#spread-operator]
Vă rugăm să nu traduceți sau să eliminați partea [#...]
, aceasta este pentru ancorele URL.
Vă rugăm frumos să permiteți responsabililor să revizuiască și să fuzioneze sau să solicite modificări în traducerea dvs.
Fiecare capitol, un articol sau task au propriul folder.
Dosarul se numește N-url
, unde N
- este numărul pentru sortare (articolele sunt ordonate), iar url
este URL-slug-ul de pe site.
Dosarul are unul dintre fișiere:
index.md
reprezintă un capitolarticle.md
reprezintă un articoltask.md
reprezintă o sarcină (soluția trebuie să fie furnizată și în fișierulsolution.md
)
Un fișier începe cu # Title Header
, apoi textul în format de tip Markdown editabil într-un editor de text simplu. Dacă folosiți o extensie precum Prettier care vă formatează codul, e recomandat să o dezactivați (traducerea trebuie să aibă același format cu originalul).
Resursele suplimentare și exemplele se află de asemenea în același folder.
Puteți rula serverul tutorialului la nivel local pentru a vedea cum arată traducerea.
Serverul și instrucțiunile de instalare sunt la https://github.com/javascript-tutorial/server.
Alternativ, puteți folosi o extensie (de browser sau pentru code editor) pentru vizualizarea fișierelor Markdown.
În cazul în care responsabilii nu răspund sau dacă doriți să deveniți responsabil, scrieți-ne la main repo.
Spune-le și altora ce traduci prin forumuri sau chat-uri. Invitați-i să se alăture!
🎉 Mulțumesc!
Puteți edita textul în orice editor. Tutorialul folosește formatul îmbunătățit "markdown", ușor de înțeles. Vezi Markdown Cheat Sheet.
P.S. Lista completă a limbilor traduse poate fi găsită la https://javascript.info/translate.
♥
Ilya Kantor @iliakan