Persian (Farsi) Translation Progress

iliakan commented 5 years ago

Maintainer List

@mahdyar

For New Translators

Please read this first (click to open)

To translate an article: 1. Check that no one else has claimed your article in the checklist below. 2. Comment below with the title of the article that you would like to translate, exactly as listed, e.g. `An Introduction to JavaScript`. - Please take only one article at a time. 3. Fork this repo, translate the article in your fork and submit a pull request! - The pull request title should be same as the article, e.g. `An Introduction to JavaScript` (just like comment) Please be prompt with your translations! If you find that you can't commit any more, let maintainers know so they can assign the page to someone else.

For Maintainers

Click to open

We recommend that a translation has 2 reviews to be merged. Please let others know what you do, on community boards and chats, invite them to join. Translations become better if more people see them. Translations are tracked below, like this: * [ ] [Home Page](url) (@iliakan) #1 Our helpful bot watches comments and adds the translator nick and PR id, marks completed, when PR is merged. You can read the details at . If something doesn't work right, please contact @iliakan.

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

[X] An Introduction to JavaScript
[X] Manuals and specifications (@kooshan75)
[X] Code editors
[X] Developer console

JavaScript Fundamentals

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

Code quality

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

Objects: the basics

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

Data types

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

Advanced working with functions

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

Object properties configuration

[X] Property flags and descriptors (@mahdiHash) #168
[X] Property getters and setters (@mahdiHash) #170

Prototypes, inheritance

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

Classes

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

Error handling

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

Promises, async/await

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

Generators, advanced iteration

[X] Generators (@alivarastepour) #270
[ ] Async iteration and generators (@KhodeAmirreza)

Modules

[X] Modules, introduction (@emadPoursina) #106
[X] Export and Import (@mostafa-nematpour) #297
[X] Dynamic imports (@mostafa-nematpour) #299

Miscellaneous

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

Browser: Document, Events, Interfaces

Document

[X] Browser environment, specs (@kooshan75)
[X] DOM tree (@Beroozam) #188
[ ] Walking the DOM
[X] 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

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

UI Events

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

Forms, controls

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

Document and resource loading

Miscellaneous

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

Frames and windows

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

Binary data, files

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

Storing data in the browser

[ ] Cookies, document.cookie (@reza-nikravesh)
[X] LocalStorage, sessionStorage (@TheVelius)
[ ] IndexedDB

Animation

Web components

[X] 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)
[X] Character classes (@EhsanShahbazii) #252
[X] Unicode: flag "u" and class \p{...} (@EhsanShahbazii) #253
[ ] Anchors: string start ^ and end $ (@EhsanShahbazii)
[X] 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

mahdyar commented 3 years ago

Logical operators

Try again. :)

mahdiHash commented 3 years ago

Logical operators

mahdiHash commented 3 years ago

Thanks, @mahdyar

emadpoursina commented 3 years ago

Comparisons

Hi this comment is for two years ago and nothing since then, I translate this section today can I send a pull request for this section?? I translated Comparisons @mahdyar

mahdiHash commented 3 years ago

Loops: while and for

javascript-translate-bot commented 3 years ago

Error: the article already has meta information in the Progress Issue "(@DieHardd)" :interrobang:

mahdyar commented 3 years ago

Comparisons

Hi this comment is for two years ago and nothing since then, I translate this section today can I send a pull request for this section?? I translated Comparisons @mahdyar

Sure. Comparisons is now unclaimed. Please read the For New Translators section:

Comment below with the title of the article that you would like to translate, exactly as listed, e.g. An Introduction to JavaScript.

mahdyar commented 3 years ago

Loops: while and for

Try again. :)

emadpoursina commented 3 years ago

Comparisons

mahdiHash commented 3 years ago

Loops: while and for

emadpoursina commented 3 years ago

first please unassigne me from Promise API because I'm working on early chapters. second my "Comparisons" translate is at pull request level, wanted to know if I can translate "Conditional branching: if, '?'"?? P.S.: The @ali-sefidmouy doesn't even commented and assign to this section.

mahdyar commented 3 years ago

first please unassigne me from Promise API because I'm working on early chapters. second my "Comparisons" translate is at pull request level, wanted to know if I can translate "Conditional branching: if, '?'"?? P.S.: The @ali-sefidmouy doesn't even commented and assign to this section.

Done.
You can translate multiple articles simultaneously, and there is no limitation if you can.
@ali-sefidmouy has commented here, and I will unassign him in a day or two if there was no news of him, but in the meantime feel free to translate other articles.

iliakan commented 3 years ago

To "unassign" someone, @mahdyar can just edit the progress issue text manually, removing their nick.

mahdiHash commented 3 years ago

Function expressions

javascript-translate-bot commented 3 years ago

Error: the article already has meta information in the Progress Issue "(@mhMoazennia)" :interrobang:

emadpoursina commented 3 years ago

Modules, introduction

emadpoursina commented 3 years ago

Export and Import

emadpoursina commented 3 years ago

Dynamic imports

emadpoursina commented 3 years ago

Hi I had a question: For long lessons I should translate all of it and then send a pull request or every chunk has been finished???

iliakan commented 3 years ago

Usually, translate and send an article as a whole. However, you may choose to make a draft PR for a preliminary review.

emadpoursina commented 3 years ago

Some suggestions:

Put a period length that if someone is not committing or have any action will remove from table so other people can translate that.

emadpoursina commented 3 years ago

first please unassigne me from Promise API because I'm working on early chapters. second my "Comparisons" translate is at pull request level, wanted to know if I can translate "Conditional branching: if, '?'"?? P.S.: The @ali-sefidmouy doesn't even commented and assign to this section.
1. Done.

2. You can translate multiple articles simultaneously, and there is no limitation if you can.

3. @ali-sefidmouy has commented [here](https://github.com/javascript-tutorial/fa.javascript.info/issues/1#issuecomment-731557989), and I will unassign him in a day or two if there was no news of him, but in the meantime feel free to translate other articles.

was there any news of @ali-sefidmouy ??

mahdyar commented 3 years ago

first please unassigne me from Promise API because I'm working on early chapters. second my "Comparisons" translate is at pull request level, wanted to know if I can translate "Conditional branching: if, '?'"?? P.S.: The @ali-sefidmouy doesn't even commented and assign to this section.
1. Done.

2. You can translate multiple articles simultaneously, and there is no limitation if you can.

3. @ali-sefidmouy has commented [here](https://github.com/javascript-tutorial/fa.javascript.info/issues/1#issuecomment-731557989), and I will unassign him in a day or two if there was no news of him, but in the meantime feel free to translate other articles.
was there any news of @ali-sefidmouy ??

conditional branching: if, '?' is unassigned.

mahdiHash commented 3 years ago

Function expressions

I would like to translate "Function Expressions" chapter but it's claimed by a username that doesn't exist anymore. Can you please unassign it so I could claim?

iliakan commented 3 years ago

Should I add someone else as a maintainer @mahdyar ?

mahdyar commented 3 years ago

Function expressions

I would like to translate "Function Expressions" chapter but it's claimed by a username that doesn't exist anymore. Can you please unassign it so I could claim?

It's unassigned.

Should I add someone else as a maintainer @mahdyar ?

Yeah, that'd be a good idea.

iliakan commented 3 years ago

I can add, given a github nick.

mahdiHash commented 3 years ago

Function expressions

mahdyar commented 3 years ago

I can add, given a github nick.

Oh, I thought someone has requested. I guess I can maintain it by my own for now. 🤔

emadpoursina commented 3 years ago

Conditional branching: if, '?'

newshahn commented 3 years ago

I have submitted "The switch statement" chapter months ago but it hasn't been accepted yet. Is there a reason for this? Do I need to change anything and resubmit?

mahdyar commented 3 years ago

I have submitted "The switch statement" chapter months ago but it hasn't been accepted yet. Is there a reason for this? Do I need to change anything and resubmit?

Please read the For New Translators section (#1):

The pull request title should be same as the article, e.g. An Introduction to JavaScript (just like comment)

You should've named your PR (#61) after the article name, therefore @javascript-translate-bot could recognize it. I'll update the progress manually.

mahdiHash commented 3 years ago

Objects

javascript-translate-bot commented 3 years ago

Error: the article already has meta information in the Progress Issue "(@kooshan75)" :interrobang:

mahdyar commented 3 years ago

Objects

I assigned "Objects" to you. :)

mahdiHash commented 3 years ago

Objects

I assigned "Objects" to you. :)

Thanks

amirhshahbazi commented 3 years ago

BigInt

mahdiHash commented 3 years ago

Object references and copying

mahdyar commented 3 years ago

Object references and copying

I assigned "Object references and copying" to you. :)

mahdiHash commented 3 years ago

Object methods, "this"

mahdyar commented 3 years ago

Object methods, "this"

I assigned 'Object methods, "this"' to you. :)

mahdiHash commented 3 years ago

Garbage collection

mahdiHash commented 3 years ago

Conditional branching: if, '?'

javascript-translate-bot commented 3 years ago

Error: the article already has meta information in the Progress Issue "(@emadPoursina)" :interrobang:

mahdyar commented 3 years ago

Conditional branching: if, '?'

About a month ago @emadPoursina claimed it. So please don't translate this article yet and wait a day or two to see if he's still on it.

mahdiHash commented 3 years ago

Symbol type

mahdyar commented 3 years ago

Symbol type

I assigned "Symbol type" to you. :)

mahdiHash commented 3 years ago

Strings

mahdyar commented 3 years ago

Strings

I assigned "Strings" to you. :)

mahdiHash commented 2 years ago

Arrays

javascript-tutorial / fa.javascript.info