Arabic Translation Progress

[iliakan]

Maintainer List

@alahnomi, @Jamil-Bailony, @3imed-jaberi, @atefBB, @afilahkle

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 (@abdomagdi) #47
• [X] Manuals and specifications (@OmarioHasan) #12
• [X] Code editors (@abdomagdi) #29
• [X] Developer console

JavaScript Fundamentals

• [X] Hello, world!
• [X] Code structure (@AhmedIbrahimGalal)
• [X] The modern mode, "use strict" (@Salah856)
• [X] Variables (@AhmedIbrahimGalal) #6
• [X] Data types (@WaleedOMEGA) #56
• [X] Interaction: alert, prompt, confirm (@WaleedOMEGA) #56
• [X] Type Conversions (@WaleedOMEGA) #56
• [X] Basic operators, maths (@Salah856 ) #18
• [X] Comparisons (@Salah856) #17
• [X] Conditional branching: if, '?'
• [X] Logical operators (@mostafaHegab) #14
• [X] Nullish coalescing operator '??' (@mostafaHegab) #16
• [X] Loops: while and for (@mostafaHegab) #16
• [X] The "switch" statement (@mostafaHegab) #26
• [X] Functions (@mostafaHegab) #36
• [X] Function expressions (@mostafaHegab) #68
• [X] Arrow functions, the basics (@mostafaHegab) #68
• [X] JavaScript specials (@Abdulrahmanh95) #63

Code quality

• [X] Debugging in the browser
• [X] Coding Style (@Ahmed-Adel3) #81
• [X] Comments (@Salah856) #64
• [X] Ninja code (@MostafaSamer) #72
• [X] Automated testing with Mocha (@Abdelrahmansherwida) #110
• [X] Polyfills and transpilers (@afilahkle) #285

Objects: the basics

• [X] Objects (@Sara-Elsayed) (@Abdelrahmansherwida)
• [X] Object references and copying (@afilahkle) #286
• [X] Garbage collection (@Ahmed-Adel3) #73
• [X] Object methods, "this" (@Ahmed-Adel3)
• [X] Constructor, operator "new" (@AhmedIbrahimGalal)
• [X] Optional chaining '?.' (@Abdulrahmanh95) #53
• [X] Symbol type (@dvmhmdsd) #11
• [X] Object to primitive conversion (@dvmhmdsd) #13

Data types

• [X] Methods of primitives (@moaztayea)
• [X] Numbers (@Ahmed-Adel3 )
• [X] Strings (@Adham-Niazy)
• [X] Arrays (@yehiafouda) #33
• [X] Array methods (@Abdelrahmansherwida)
• [X] Iterables (@dvmhmdsd) #19
• [X] Map and Set (@Salah856) #90
• [X] WeakMap and WeakSet (@Salah856 ) #90
• [X] Object.keys, values, entries (@Abdelrahmansherwida) #111
• [X] Destructuring assignment (@Salah856)
• [X] Date and time (@Salah856)
• [X] JSON methods, toJSON (@dvmhmdsd) #24

Advanced working with functions

• [X] Recursion and stack (@Adham-Niazy) #76
• [X] Rest parameters and spread syntax (@Adham-Niazy)
• [X] Variable scope, closure (@afilahkle)
• [X] The old "var" (@Adham-Niazy )
• [X] Global object (@Adham-Niazy)
• [X] Function object, NFE (@Adham-Niazy)
• [X] The "new Function" syntax (@Adham-Niazy) #77
• [X] Scheduling: setTimeout and setInterval
• [X] Decorators and forwarding, call/apply
• [X] Function binding
• [X] Arrow functions revisited

Object properties configuration

• [X] Property flags and descriptors (@OmarioHasan) #22
• [X] Property getters and setters (@OmarioHasan) #21

Prototypes, inheritance

• [X] Prototypal inheritance (@Ahmed-Adel3)
• [X] F.prototype (@Salah856)
• [X] Native prototypes (@dvmhmdsd)
• [X] Prototype methods, objects without proto (@dvmhmdsd) #27

Classes

• [X] Class basic syntax (@Salah856) #45
• [X] Class inheritance (@Salah856) #45
• [X] Static properties and methods (@Salah856)
• [X] Private and protected properties and methods (@Salah856)
• [X] Extending built-in classes (@Salah856)
• [X] Class checking: "instanceof" (@Ahmed-Adel3)
• [X] Mixins (@OmarioHasan) #61

Error handling

• [X] Error handling, "try...catch" (@afilahkle) #288
• [X] Custom errors, extending Error (@AhmedIbrahimGalal)

Promises, async/await

• [X] Introduction: callbacks (@AhmedIbrahimGalal) #70
• [X] Promise (@AhmedIbrahimGalal)
• [X] Promises chaining (@AhmedIbrahimGalal)
• [X] Error handling with promises (@Salah856) #57
• [X] Promise API (@Salah856) #64
• [X] Promisification (@Salah856) #57
• [X] Microtasks (@Salah856) #57
• [X] Async/await (@Salah856) #65

Generators, advanced iteration

• [X] Generators (@IEEE-AlAzhar) #31
• [X] Async iteration and generators (@afilahkle) #289

Modules

• [X] Modules, introduction
• [X] Export and Import (@Salah856)
• [X] Dynamic imports (@Salah856) #79

Miscellaneous

• [X] Proxy and Reflect (@dvmhmdsd) #96
• [X] Eval: run a code string
• [X] Currying
• [X] Reference Type (@OmarioHasan) #118
• [X] BigInt (@MostafaMahmoud93) #78
• [ ] Unicode, String internals
• [ ] WeakRef and FinalizationRegistry

Browser: Document, Events, Interfaces

Document

• [X] Browser environment, specs (@abdelrhmanali29)
• [X] DOM tree
• [X] Walking the DOM (@afilahkle) #279
• [ ] Searching: getElement, querySelector (@aladdinshammr) #317
• [X] Node properties: type, tag and contents (@Salah856) #23
• [X] Attributes and properties (@Salah856 ) #20
• [ ] Modifying the document
• [ ] Styles and classes (@abdelrhmanali29)
• [X] Element size and scrolling (@Salah856) #66
• [X] Window sizes and scrolling (@Salah856) #66
• [X] Coordinates (@Salah856) #28

Introduction to Events

• [ ] Introduction to browser events (@belalmosad)
• [ ] Bubbling and capturing
• [X] Event delegation (@afilahkle) #281
• [ ] Browser default actions
• [ ] Dispatching custom events

UI Events

• [X] Mouse events (@mohamedElkast) #25
• [ ] Moving the mouse: mouseover/out, mouseenter/leave
• [ ] Drag'n'Drop with mouse events
• [ ] Pointer events
• [ ] Keyboard: keydown and keyup
• [ ] Scrolling

Forms, controls

• [ ] Form properties and methods
• [ ] Focusing: focus/blur
• [ ] Events: change, input, cut, copy, paste
• [ ] Forms: event and method submit

Document and resource loading

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

Miscellaneous

• [ ] Mutation observer
• [ ] Selection and Range
• [ ] Event loop: microtasks and macrotasks

Frames and windows

• [ ] Popups and window methods
• [ ] Cross-window communication
• [ ] The clickjacking attack

Binary data, files

• [ ] ArrayBuffer, binary arrays
• [ ] TextDecoder and TextEncoder
• [ ] Blob
• [ ] File and FileReader

Network requests

• [ ] Fetch
• [ ] FormData
• [ ] Fetch: Download progress
• [ ] Fetch: Abort
• [ ] Fetch: Cross-Origin Requests
• [ ] Fetch API
• [ ] URL objects
• [ ] XMLHttpRequest
• [ ] Resumable file upload
• [ ] Long polling
• [ ] WebSocket
• [ ] Server Sent Events

Storing data in the browser

• [ ] Cookies, document.cookie
• [ ] LocalStorage, sessionStorage
• [ ] IndexedDB

Animation

• [ ] Bezier curve
• [ ] CSS-animations
• [ ] JavaScript animations

Web components

• [ ] From the orbital height
• [ ] Custom elements
• [ ] Shadow DOM
• [ ] Template element
• [ ] Shadow DOM slots, composition
• [ ] Shadow DOM styling
• [ ] Shadow DOM and events

Regular expressions

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

[iliakan]

p.s. not sure if rtl.styl is used now, I created it just to make sure things can work out.

[OmarioHassan]

Sidebar must be on the right I'm tried to specify the style for ar in body.styl and rtl.style but seems not to work in both

[iliakan]

You'd like to have a working rtl.styl? Anything else?

[OmarioHassan]

No thank you and thanks for your help 😊

[iliakan]

No - means no rtl.styl? Nothing needed? 😮

[OmarioHassan]

No I just need only a working rtl.styl I need a style file and nothing else and thnx for help 😊

[iliakan]

Ok, I'll do it and write here.

[iliakan]

I pushed the change. Instead of a separate rtl.styl file, you have the variable rtl in styles now.

That's better, as RTL styles can be naturally embedded into stylesheets.

Like this:

body
  color white
  if rtl
    direction rtl

[OmarioHassan]

Got it thanks I will make a necessary changes and then make a pull request

[OmarioHassan]

@iliakan
For sorry your latest changes didn't work with me

[iliakan]

I updated it once again.

Try ./edit ar - you should see green body:

[OmarioHassan]

@iliakan It's not working & i'm using this to serve ./edit ar

[iliakan]

You do it, and then re-run ./edit ar?

Also, do you clear browser cache?

---

Best Regards, Ilya Kantor https://javascript.info

On 22 May 2020, at 00:43, Omar Hasan notifications@github.com wrote:

@iliakan https://github.com/iliakan It's not working https://user-images.githubusercontent.com/8146344/82609386-bf11e780-9bbc-11ea-979d-c7a86225dcd0.png https://user-images.githubusercontent.com/8146344/82609407-cafda980-9bbc-11ea-9a16-147275c804a7.png — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/javascript-tutorial/ar.javascript.info/issues/1#issuecomment-632361839, or unsubscribe https://github.com/notifications/unsubscribe-auth/AACVJGEK3NQNEJPVL6EONH3RSWN67ANCNFSM4ILYTUNA.

[OmarioHassan]

Yes I'm closed and reserving about 5 times and I'm serving on incognito window

[iliakan]

So my change isn't working for you?

Here's how it should look:

Please note: incognito doesn't mean "no cache". It merely hides your identifying tokens/empties the environment. So you may still have it cached. I guess, that's the reason.

Also, when you see things working, you can try ./dev ar (as described in the readme, see Dev mode).

[iliakan]

Please check public/en/pack/styles.css, are the changes there, in the body{...} clause?

[OmarioHassan]

I got this error when using ./dev ar

and there no rtl in styles.css

[iliakan]

Yes, ./dev expects to see ar.yml files, the translation of the web interface. That's not needed for ./edit that uses en.yml by default.

Note: rtl.styl is not used now. There should be body{...} style with the change.

[OmarioHassan]

I'm using this file server\modules\styles\blocks\body\body.styl and this is what it includes

[OmarioHassan]

i think it reads rtl as variable direction: false

[OmarioHassan]

Here is the problem

[iliakan]

Strange, please git pull latest?

Here's my edit:

/js/server master> cat edit
#!/usr/bin/env bash

# ./edit ru <- tutorial language: RU, server: EN
# ./edit ru ru <- tutorial language: RU, server: RU

: ${1?"Usage: $0 <tutorial language> [<server language>]"}

export TUTORIAL_ROOT="../$1.javascript.info"
export NODE_LANG="${2:-en}"
export TUTORIAL_LANG=$1 <-------------------------

So when you run ./edit ar, the variable should be there.

[OmarioHassan]

It's the latest already

[iliakan]

That's odd indeed. Why the variable does not get through then?

[OmarioHassan]

I'm using the engine and server and ar projects through the fork, can this make any problems?

[iliakan]

If you pull from upstream, so that the fork is up to date, then it shouldn't be the reason.

[OmarioHassan]

did you recommend to remove the local and fork projects and repeat this process again?

[iliakan]

The edit file is correct: there's the variable TUTORIAL_LANG. But then it must be in process.env.TUTORIAL_LANG. That has nothing to do with my scripts, it's a straightforward node.js feature.

[OmarioHassan]

I think i've found what we can fix and made a PR for it I'm using windows btw

[iliakan]

Of course, that explains everything. I assumed you're running ./edit, not ./edit.cmd. Great, so now it works!

[OmarioHassan]

@iliakan I think there is a problem related to displaying SVG is that just a local issue for me?

[iliakan]

Do you have ImageMagick installed? It tries to get image size.

[iliakan]

It might be better to make separate issues for different stuff, not to write everything here, in the progress tracker. Here in the same repo.

[OmarioHassan]

ok no problem but did we need to install ImageMagick

[iliakan]

No need, unless you want to see pictures locally.

[OmarioHassan]

I also made a PR for RTL in server hope changes merged to use it with my team

[iliakan]

I'll merge it later, after you evaluate it during the translation, ok? Anyway, RTL isn't yet used, as no translation exists.

[OmarioHassan]

My Team about 18 developers is using this style and they have now yesterday version with background green

[OmarioHassan]

at least this PR

[iliakan]

Yes, green was temporary =) merged it.

[dvmhmdsd]

Symbol type

[OmarioHassan]

Manuals and specifications

[Eyad-Bereh]

An Introduction to JavaScript

[dvmhmdsd]

Object to primitive conversion

[Salah856]

Comparisons

[Salah856]

Basic operators, maths

[dvmhmdsd]

Iterables

[OmarioHassan]

Property getters and setters

[Salah856]

Attributes and properties

[OmarioHassan]

Property flags and descriptors