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

[Jamil-Bailony]

The JavaScript language We, my team at Academy Hsoub, are working on translating the first book, which is "The JavaScript language". We have finished the first three chapters until now: An introduction, JavaScript Fundamentals, and Code quality. We are working right now on the "Objects: the basics" and "Data types" chapters.

I would like to be a maintainer, please. @iliakan

[iliakan]

Welcome, @Jamil-Bailony !

[iliakan]

@Jamil-Bailony did you try to submit a comment with "An Introduction to JavaScript"?

The bot will mark it then. If the bot isn't working, I'll fix it.

[iliakan]

@Jamil-Bailony Did you merge in the translation? I see the articles are checked, but can't find the text.

[Jamil-Bailony]

Did you merge in the translation? I see the articles are checked, but can't find the text.

Not yet. The translations are in my Drive account. I will work on merging them as soon as possible.

did you try to submit a comment with "An Introduction to JavaScript"?

Yes, I had added a comment as mentioned above but nothing happened, so I deleted it. @iliakan

[iliakan]

@Jamil-Bailony ok, next time don't remove the comment please, if the bot doesn't work, I'll fix it =)

[musaab-abdalla]

Hello @iliakan I would like to join the Arabic translation team, please add me so I can start do some translation process.

[iliakan]

You can submit PR right now, there's no need to become a maintainer for that =). See the top of this issue.

If your PRs are good, we'll add you as a maintainer.

[HNBR]

Debugging in Chrome

[Emmanuel-Melon]

Hey there, I'd love to take part in translating this awesome project. Can I take on the Objects article?

[iliakan]

@alahnomi, @Jamil-Bailony , are you online?

[iliakan]

If you have enough JS knowledge, I can make you a contributor.

[LeOndaz]

Ninja code

[OmarioHassan]

@iliakan
Hello World <3 I can give help with this amazing website As I'm the founder of Angular Army 'Ng Arab' I can help with my team for the whole translation Just let me know what's done and what's not and how many developers we need
Regards

[iliakan]

Hi @OmarioHasan,

Guess, you can take a look at the existing PRs and this repo to see what's done =)

The tutorial is big, so there's a lot to translate, because modern JS has a lot of features =)

[OmarioHassan]

@iliakan I've already taken a look but didn't find any Arabic words in this PRs

[iliakan]

@OmarioHasan https://github.com/javascript-tutorial/ar.javascript.info/pull/2/files this isn't Arabic?

[OmarioHassan]

@iliakan yes sure didn't this translation merged yet?

[iliakan]

@OmarioHasan I don't see much activity in Arabic.

You want to take it over?

[iliakan]

@alahnomi, @Jamil-Bailony is there anything you've fully translated?

[OmarioHassan]

@OmarioHasan I don't see much activity in Arabic.

You want to take it over?

I just need to help because this website is very valuable Any kind of help that I can support then I'm in

[iliakan]

@OmarioHasan Do you think Arabic version is needed? I'm not familiar with the state of the web development in Arabic countries.

[OmarioHassan]

@iliakan You are right we have a weakness in many points but the current generation may change this weakness. here you can find Ng Arab Community: https://www.angular-communities.com It's my first step to help Arabian developers. If you need to fill this branch with Arabic words I can support you and thanks for your efforts for spreading the knowledge Regards

[iliakan]

@OmarioHasan I'm helping to translate the tutorial in languages that are much less popular than Arabic.

So what we can do is to take the current English version and translate it, and maybe make use of the existing PR.

@OmarioHasan May I assume that you're familiar with git?

[OmarioHassan]

@iliakan yes sure

[iliakan]

@OmarioHasan All right, it's done! You're the contributor now (got an invite?)

I also updated the repo from upstream.

[OmarioHassan]

@iliakan got it thanks I assume we will translate all topics I mean there is no pending on in progress translate for any topic is that right

[iliakan]

I only see one PR.

[OmarioHassan]

@iliakan
Our heroes listed here When the team is ready, we will start right away

[iliakan]

@OmarioHasan what stops them now?

[iliakan]

@OmarioHasan did you read the issue top? https://github.com/javascript-tutorial/ar.javascript.info/issues/1

There are some details about the translation bot there. It helps to facilitate team translation.

[OmarioHassan]

@iliakan We will make a slack to discuss what we will do If you need to join and say something to the team it will be fine

[OmarioHassan]

@iliakan yes I've read the full details is there something I need to know other ?

[iliakan]

@OmarioHasan is there anything else I can do here?

[iliakan]

@OmarioHasan everything's set up for the translation.

[OmarioHassan]

@OmarioHasan is there anything else I can do here?

No thank you

[OmarioHassan]

@iliakan Hello I've a question about the direction It must be RTL in Arabic Is there a something we can make now during the translation to help the direction or just let it for now ?

[iliakan]

@OmarioHasan Can you install the tutorial server locally? And see how it goes https://github.com/javascript-tutorial/server

[iliakan]

I can apply necessary fixed to styles, if any required.

[OmarioHassan]

@iliakan I used the server already but just asking about if we can fix the style or not And can we fix it now or after translation complete. That was a starter lesson for Ng Arab community to start contribute to javascriot.info : https://youtu.be/pq8Dnmkrnuk

[iliakan]

@OmarioHasan of course we can update the styles, please fix them as appropriate and submit a PR. Just mark what's ltr-only and maybe(if any) Arabic-only. I'll introduce an additional variable to support that.

[OmarioHassan]

@iliakan
I think if i make a changes for this file body.styl it will affect the whole project That's what i need to do for the view so it will be kind of you if you can guide me to steps for AR style

[OmarioHassan]

@iliakan can we have a direct chat better than commenting to make sure all the process the working well with us

[iliakan]

@OmarioHasan We can, but I'm not a specialist in RTL-sites. All I did was LTR.

I hope there's a way to properly fix styles =)

[iliakan]

By the way, you can apply styles for Arabic-only with if.

Like here for Japanese:

if lang=='ja'
  font = BlinkMacSystemFont, -apple-system, "Hiragino Kaku Gothic ProN","メイリオ", serif
else
  font = BlinkMacSystemFont, -apple-system, Segoe UI, Roboto, Helvetica, Arial, serif

[OmarioHassan]

this styles to include inside .styl extension is that right ?

[iliakan]

Right.

[iliakan]

Stylus preprocessor

[OmarioHassan]

@iliakan Sorry for too much asking but i think this is not working is there a something related to locales missed for AR Version ?

also i found i file rtl.style can we use this file for all Arabic Styles ?

[iliakan]

Well, rtl.styl was created for Fahrsi language (also rtl), we can use for ar also, of course!

Is it ok that the sidebar remains on the left in Arabic?