javascript-tutorial / fa.javascript.info Goto Github PK

هدف از این ریپو ترجمۀ مقاله‌های javascript.info به زبان فارسی هست و به همین دلیل ما تا حد ممکن مقاله‌ها رو ترجمه کردیم حتی کلمات تخصصی.

اما حالا که دوباره مقاله‌ها رو نگاه انداختیم به این نتیجه رسیدیم که بعضی از کلمات نباید ترجمه بشن و به صورت انگلیسی داخل مقاله‌ها نوشته بشن.

الان تصمیم گرفتیم که ترجمۀ بعضی از کلمه‌های مقاله‌ها رو به انگلیسی برگردونیم. این کار کمی زمان‌بر هست و از کسانی که توانایی‌ش رو دارن درخواست کمک داریم تا هرچه سریع‌تر مقاله‌ها آماده بشن.

اینجا لیستی از مقاله‌هایی که ترجمه شدن رو میذاریم و تیک هر کدوم که درست شد رو می‌زنیم.

لطفا اگه مایل به همکاری هستین، یکی از این مقاله‌ها رو انتخاب و ریپو رو fork کنین و ترجمۀ کلماتی که بنظرتون باید انگلیسی باشن رو برگردونین و زمانی که هر مقاله تموم شد یه PR بسازین. برای عنوان PR لطفا کلمه Update رو قبل از اسم مقاله قرار بدین.

لیست مقالات:

The JavaScript language

An introduction

• An Introduction to JavaScript
• Manuals and specifications
• Code editors
• Developer console

JavaScript Fundamentals

• Hello, world!
• Code structure
• The modern mode, "use strict"
• Variables (@Bexacuter) #244
• Data types (@Bexacuter) #245
• Interaction: alert, prompt, confirm (@TheBehnvm) #248
• Type Conversions (@TheVelius) #260
• Basic operators, maths
• Comparisons (@TheVelius) #261
• Conditional branching: if, '?'
• Logical operators
• Nullish coalescing operator '??'
• Loops: while and for
• The "switch" statement
• Functions
• Function expressions
• Arrow functions, the basics
• JavaScript specials

Code quality

• Debugging in the browser
• Coding Style
• Comments
• Ninja code
• Polyfills and transpilers

Objects: the basics

• Objects
• Object references and copying
• Garbage collection
• Object methods, "this"
• Constructor, operator "new"
• Optional chaining '?.'
• Symbol type
• Object to primitive conversion

Data types

• Methods of primitives
• Numbers
• Strings
• Arrays
• Array methods
• Iterables
• Map and Set
• WeakMap and WeakSet
• Object.keys, values, entries
• Destructuring assignment
• Date and time
• JSON methods, toJSON

Advanced working with functions

• Recursion and stack
• Rest parameters and spread syntax
• Variable scope, closure
• The old "var"
• Global object
• Function object, NFE
• The "new Function" syntax
• Scheduling: setTimeout and setInterval
• Decorators and forwarding, call/apply
• Function binding
• Arrow functions revisited

Object properties configuration

• Property flags and descriptors
• Property getters and setters

Prototypes, inheritance

• Prototypal inheritance
• F.prototype
• Native prototypes
• Prototype methods, objects without proto

Classes

• Class basic syntax
• Class inheritance
• Static properties and methods
• Private and protected properties and methods
• Extending built-in classes
• Class checking: "instanceof"
• Mixins

Error handling

• Error handling, "try...catch"
• Custom errors, extending Error

Promises, async/await

• Introduction: callbacks
• Promise
• Promises chaining
• Error handling with promises
• Async/await

Modules

• Modules, introduction

Miscellaneous

• Eval: run a code string
• BigInt

Browser: Document, Events, Interfaces

Document

• Browser environment, specs
• DOM tree

Introduction to Events

• Introduction to browser events
• Bubbling and capturing

UI Events

• Mouse events
• Moving the mouse: mouseover/out, mouseenter/leave

Maintainer List

@mahdyar

For New Translators

For Maintainers

Team translation

More details about team translation: https://javascript.info/translate/bot.

Only maintainers can check/uncheck items below. If you're not, please write in a comment what you take to translate, the title, exactly as in the list.

The JavaScript language

An introduction

• An Introduction to JavaScript
• Manuals and specifications (@kooshan75)
• Code editors
• Developer console

JavaScript Fundamentals

• Hello, world!
• Code structure
• The modern mode, "use strict"
• Variables
• Data types
• Interaction: alert, prompt, confirm (@mahdyar) #96
• Type Conversions
• Basic operators, maths (@kooshan75) #19
• Comparisons (@emadpoursina) #101
• Conditional branching: if, '?' (@mahdiHash) #143
• Logical operators (@mahdiHash) #100
• Nullish coalescing operator '??' (@hossein13m) #53
• Loops: while and for (@mahdiHash) #103
• The "switch" statement (@newshahn) #61
• Functions (@kooshan75) #22
• Function expressions (@mahdiHash) #105
• Arrow functions, the basics (@newshahn) #59
• JavaScript specials

Code quality

• Debugging in the browser (@mahdyar) #93
• Coding Style (@mahdi-momeni) #72
• Comments (@samanzameni)
• Ninja code (@mrmowji)
• Automated testing with Mocha (@EhsanShahbazii) #250
• Polyfills and transpilers (@newshahn) #104

Objects: the basics

• Objects (@mahdiHash) #118
• Object references and copying (@mahdiHash) #121
• Garbage collection (@mahdiHash) #123
• Object methods, "this" (@mahdiHash) #122
• Constructor, operator "new" (@mahdiHash) #98
• Optional chaining '?.' (@mahdi-momeni) #70
• Symbol type (@mahdiHash) #126
• Object to primitive conversion (@mahdiHash) #177

Data types

• Methods of primitives
• Numbers (@kooshan75) #18
• Strings (@mahdiHash) #128
• Arrays (@mahdiHash) #131
• Array methods (@mahdiHash) #132
• Iterables (@mahdiHash) #133
• Map and Set (@mahdiHash) #135
• WeakMap and WeakSet (@mahdiHash) #136
• Object.keys, values, entries (@mahdiHash) #137
• Destructuring assignment (@mahdiHash) #155
• Date and time (@mahdiHash) #139
• JSON methods, toJSON (@mahdiHash) #141

Advanced working with functions

• Recursion and stack (@mahdiHash) #159
• Rest parameters and spread syntax (@Amirhossein-Veysi) #142
• Variable scope, closure (@mahdiHash) #150
• The old "var" (@mahdiHash) #161
• Global object (@Amirhossein-Veysi) #146
• Function object, NFE (@mahdiHash) #156
• The "new Function" syntax (@erfanyeganegi) #151
• Scheduling: setTimeout and setInterval (@mahdiHash) #157
• Decorators and forwarding, call/apply (@mahdiHash) #163
• Function binding (@mahdiHash) #165
• Arrow functions revisited (@mahdiHash) #166

Object properties configuration

• Property flags and descriptors (@mahdiHash) #168
• Property getters and setters (@mahdiHash) #170

Prototypes, inheritance

• Prototypal inheritance (@mahdiHash) #172
• F.prototype (@Amirhossein-Veysi) #171
• Native prototypes (@mahdiHash) #175
• Prototype methods, objects without proto (@Amirhossein-Veysi) #174

Classes

• Class basic syntax (@Amirhossein-Veysi) #176
• Class inheritance (@mahdiHash) #178
• Static properties and methods (@mahdiHash) #179
• Private and protected properties and methods (@mahdiHash) #182
• Extending built-in classes (@mahdiHash) #184
• Class checking: "instanceof" (@mahdiHash) #186
• Mixins (@mahdiHash) #189

Error handling

• Error handling, "try...catch" (@mahdiHash) #194
• Custom errors, extending Error (@mahdiHash) #199

Promises, async/await

• Introduction: callbacks (@Arash-1999) #80
• Promise (@Beroozam) #197
• Promises chaining (@mahdiHash) #223
• Error handling with promises (@mahdiHash) #224
• Promise API (@mahdiHash)
• Promisification (@samanzameni)
• Microtasks (@D0x45) #277
• Async/await (@ARTM2000) #219

Generators, advanced iteration

• Generators (@alivarastepour) #270
• Async iteration and generators (@KhodeAmirreza)

Modules

• Modules, introduction (@emadpoursina) #106
• Export and Import (@mostafa-nematpour) #297
• Dynamic imports (@mostafa-nematpour) #299

Miscellaneous

• Proxy and Reflect (@mostafa-nematpour)
• Eval: run a code string (@AminZibayi) #44
• Currying (@moAlireza) #304
• Reference Type (@nafasebra)
• BigInt (@amirhshahbazi) #120
• Unicode, String internals (@mostafa-nematpour) #269
• WeakRef and FinalizationRegistry

Browser: Document, Events, Interfaces

Document

• Browser environment, specs (@kooshan75)
• DOM tree (@Beroozam) #188
• Walking the DOM
• Searching: getElement*, querySelector* (@shahrzadJavadiKoushesh) #278
• Node properties: type, tag and contents
• Attributes and properties
• Modifying the document
• Styles and classes
• Element size and scrolling
• Window sizes and scrolling
• Coordinates

Introduction to Events

• Introduction to browser events (@erfanyeganegi) #154
• Bubbling and capturing (@erfanyeganegi) #158
• Event delegation (@MHMighani) #319
• Browser default actions (@MHMighani) #318
• Dispatching custom events (@HannaParsa) #283

UI Events

• Mouse events (@erfanyeganegi) #149
• Moving the mouse: mouseover/out, mouseenter/leave (@erfanyeganegi) #152
• Drag'n'Drop with mouse events (@hiradsajde)
• Pointer events
• Keyboard: keydown and keyup (@khosrovafaee)
• Scrolling (@TheVelius) #276

Forms, controls

• Form properties and methods (@shahrzadJavadiKoushesh) #285
• Focusing: focus/blur (@shahrzadJavadiKoushesh) #282
• Events: change, input, cut, copy, paste (@shahrzadJavadiKoushesh) #290
• Forms: event and method submit (@shahrzadJavadiKoushesh) #292

Document and resource loading

• Page: DOMContentLoaded, load, beforeunload, unload
• Scripts: async, defer
• Resource loading: onload and onerror

Miscellaneous

• Mutation observer (@HannaParsa) #288
• Selection and Range
• Event loop: microtasks and macrotasks

Frames and windows

• Popups and window methods (@shahrzadJavadiKoushesh) #294
• Cross-window communication (@shahrzadJavadiKoushesh) #302
• The clickjacking attack (@shahrzadJavadiKoushesh) #308

Binary data, files

• ArrayBuffer, binary arrays (@mehrsa-a) #309
• TextDecoder and TextEncoder (@mehrsa-a) #310
• Blob (@mehrsa-a)
• File and FileReader

Network requests

• Fetch (@amirroox) #264
• FormData (@Atefeh-Masoumi) #315
• Fetch: Download progress
• Fetch: Abort
• Fetch: Cross-Origin Requests
• Fetch API
• URL objects (@shahrzadJavadiKoushesh)
• XMLHttpRequest
• Resumable file upload
• Long polling
• WebSocket (@MHMighani) #316
• Server Sent Events

Storing data in the browser

• Cookies, document.cookie (@reza-nikravesh)
• LocalStorage, sessionStorage (@TheVelius)
• IndexedDB

Animation

• Bezier curve
• CSS-animations
• JavaScript animations

Web components

• From the orbital height (@HannaParsa) #313
• Custom elements
• Shadow DOM
• Template element
• Shadow DOM slots, composition
• Shadow DOM styling
• Shadow DOM and events

Regular expressions

• Patterns and flags (@EhsanShahbazii)
• Character classes (@EhsanShahbazii) #252
• Unicode: flag "u" and class \p{...} (@EhsanShahbazii) #253
• Anchors: string start ^ and end $ (@EhsanShahbazii)
• Multiline mode of anchors ^ $, flag "m" (@EhsanShahbazii) #259
• Word boundary: \b (@EhsanShahbazii)
• Escaping, special characters (@EhsanShahbazii)
• Sets and ranges [...]
• Quantifiers +, *, ? and {n}
• Greedy and lazy quantifiers
• Capturing groups
• Backreferences in pattern: \N and \k<name>
• Alternation (OR) |
• Lookahead and lookbehind
• Catastrophic backtracking
• Sticky flag "y", searching at position
• Methods of RegExp and String

As I was translating files into Persian, I faced an issue relating to the RTL problem. I think somehow we should modify CSS files to support this.

سلام
برای ترجمه میشه از حالت گفتاری هم استفاده کرد؟ مثلا به جای ترجمه رسمی و گاها سخت از ترجمه روان و لفظی استفاده کرد برای درک بهتر خواننده؟
قبلا یکی این پیشنهاد رو داده بود. اما به نظرم خواننده ها مشکلی با کتابی نبودن ندارن. البته منظورم از ترجمه لفظی این نیست که متن رو از حالت آموزشی به حالت فان در بیاریم ، منطورم اینه به جای جملات سنگین تا جای ممکن آسون ترشون کنیم.
اگر موافق هستید من میتونم توی تغییر ترجمه های قبلی کمک کنم.

مثلا جمله زیر در بخش مقدمه ایی بر جاوا اسکریپت :
در اینجا به قابلیت‌های جاوااسکریپت، اینکه به واسطه آن چه کارهایی می‌توان انجام داد و چه تکنولوژی‌هایی با آن به خوبی کار می‌کنند، نگاهی می‌اندازیم.
تبدیل بشه به متن زیر :
در این بخش به قابلیت های جاوااسکریپت میپردازیم و میبینم چه کارهایی میتونیم باهاش انجام بدیم و با چه ابزارها و تکنولوژی هایی هماهنگی بالاتری داره.

یا این متن :
جاوااسکریپت مدرن یک زبان برنامه‌نویسی «امن» است. این زبان اجازه دسترسی در سطوح پایین مانند دسترسی به حافظه (Memory) و پردازنده (CPU) را نمی‌دهد، چراکه از ابتدا برای مرورگرها (که نیازی به این موراد ندارند) ساخته شده بود.
تبدیل بشه به متن زیر :
جاوااسکریپت یه زبان امنه! این زبان اجازه دسترسی شما رو به سطوح پایین سخت افزار مثل حافظه یا سی پی یو نمیده.چون از اول برای مروگرها ساخته شده بود که نیازی به این دسترسی ها نداشت.

البته این متن های ساده ایی هستند و با یکمی خودمونی تر میشه درک مطلب رو بالاتر برد (حتی توی متن های سنگین تر )

سلام مرسی از سایتتون
لطفا سعی کنید توضیحات رو به زبون ساده و خودمونی بذارید
اینجوری ادم گیج میشه

I like to translate .svg files.
Is there any recommended application that I can use?
When the translation is done, should I just upload the .svg file or something else?

لینک تاپیک‌ها همونطور که توی گیف ضمیمه مشخص هست مشکل تجربه کاربری داره و یوزر نمیتونه راحت روی تاپیک ها کلیک کنه و وارد بشه (زمان هایی که نشانگر ماوس به شکل دیفالت هست امکان ورود وجود نداره و فقط با رفتن به حاشیه ها میتونه کلیک کنه )

This issue is created to get help/advice for translation.

If you have any problem with translating a word/line/comment, you can ask for help here and wait for us to respond. You can @mention the maintainers for a quicker response (maintainer list is here).

Please consider reading "Translation tips" and "نکات ترجمۀ فارسی" of README before asking your question.

Hope your problem gets resolved ;)

این ایشیو برای گرفتن کمک/راهنمایی در ترجمه ایجاد شده است.

اگر هرگونه مشکلی با ترجمهٔ یک کلمه، خط و کامنت داشتید، می‌توانید در این‌جا کمک بگیرید و منتظر ما بمانید تا پاسخ دهیم. برای اینکه زودتر پاسخ بگیرید می‌توانید maintainerها را منشن کنید (لیست maintainer اینجاست).

لطفاً خواندن «Translation tips» و «نکات ترجمۀ فارسی» از README را قبل از پرسیدن سوال در نظر بگیرید.

به امید حل مشکلات پیش اومده ;)

please translate all content into persian

سلام وقت بخیر
می خواستم بدونم میتونم در صورت نیاز برای ترجمه و خوانایی بهتر در قسمت هایی که کد داریم کامنت اضافه کنم؟
مثلا در این مورد:

اینجا همون طوری که داخل README گفته شده من فقط ترجمه کردم:

و اگه بتونم کامنت اضافه کنم تا خوانایی بهتر بشه اینطوری میشه:

میتونم همچین کاری کنم؟
این مشکل زیاد پیش میاد برای من و با توجه به اینکه متن فارسی از راست به چپ خونده میشه ولی کد از چپ به راست، اگه بتونیم خطوطی که کامنت ندارن رو خودمون برای خوانایی بهتر بهشون کامنت اضافه کنیم بنظرم کمک میکنه.
داخل متن فارسی چون بعدا از RTL استفاده میشه مشکلی پیش نمیاد ولی برای قسمتی که کد وجود داره جمله بهم میریزه.