◐ Shell
clean mode source ↗

polyfills and transpilers by newshahn · Pull Request #104 · javascript-tutorial/fa.javascript.info

@newshahn

polyfills and transpilers is done.

mahdyar

@@ -1,92 +1,92 @@

# Polyfills and transpilers

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Titles should also be translated, for example here would be:
# پلیفیل‌ها و ترنسپایلرها

# Polyfills and transpilers

The JavaScript language steadily evolves. New proposals to the language appear regularly, they are analyzed and, if considered worthy, are appended to the list at <https://tc39.github.io/ecma262/> and then progress to the [specification](http://www.ecma-international.org/publications/standards/Ecma-262.htm).
زبان جاوااسکریپت پیوسته در حال تکامل است. پیشنهادهایی برای بهتر شدن آن به‌طور منظم صورت می‌گیرد، این پیشنهاد‌ها بررسی می‌شوند و اگر ارزشمند باشند، به لیست <https://tc39.github.io/ecma262/> اضافه می‌شوند و سپس به [specification](http://www.ecma-international.org/publications/standards/Ecma-262.htm) راه می‌یابند.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Link titles should also be translated:
زبان جاوااسکریپت پیوسته در حال تکامل است. پیشنهادهایی برای بهتر شدن آن به‌طور منظم صورت می‌گیرد، این پیشنهاد‌ها بررسی می‌شوند و اگر ارزشمند باشند، به لیست <https://tc39.github.io/ecma262/> اضافه می‌شوند و سپس برای [تشخیص](http://www.ecma-international.org/publications/standards/Ecma-262.htm) پیش می‌روند.

زبان جاوااسکریپت پیوسته در حال تکامل است. پیشنهادهایی برای بهتر شدن آن به‌طور منظم صورت می‌گیرد، این پیشنهاد‌ها بررسی می‌شوند و اگر ارزشمند باشند، به لیست <https://tc39.github.io/ecma262/> اضافه می‌شوند و سپس به [specification](http://www.ecma-international.org/publications/standards/Ecma-262.htm) راه می‌یابند.

Teams behind JavaScript engines have their own ideas about what to implement first. They may decide to implement proposals that are in draft and postpone things that are already in the spec, because they are less interesting or just harder to do.
تیم‌های مسئول موتورهای جاوااسکریپت تصمیم می‌گیرند کدام یک را اول پیاده‌سازی کنند. ممکن است تصمیم بگیرند پیشنهادهایی که هنوز به‌صورت پیش‌نویس هستند را اول پیاده‌سازی کنند و چیزهایی که در spec هستند را به بعدتر موکول کنند. دلیلش هم می‌تواند این باشد که شاید بعضی جذابیت کمتری دارند یا انجام آن‌ها سخت‌تر است.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

و پیشنهادهایی که در مرحلهٔ تشخیص هستند را به بعدتر موکول کنند، به دلیل اینکه کمتر جالب هستند و یا فقط سخت‌تر هستند.

Comment on lines 17 to 18

1. Transpilers.
2. Polyfills.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should be translated here as well, alternatively you can keep their English equivalent in parentheses.

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

Usually, a developer runs the transpiler on their own computer, and then deploys the transpiled code to the server.
معمولا برنامه‌نویس transpiler را روی کامپیوتر خودش اجرا می‌کند و سپس کد transpileشده را روی سرور deploy می‌کند.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Developer" means توسعه‌دهنده.

- [core js](https://github.com/zloirock/core-js) that supports a lot, allows to include only needed features.
- [polyfill.io](http://polyfill.io) service that provides a script with polyfills, depending on the features and user's browser.
دو کتابخانه جالب polyfills:

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Don't add extra newlines.

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

Just don't forget to use transpiler (if using modern syntax or operators) and polyfills (to add functions that may be missing). And they'll ensure that the code works.
فراموش نکنید که از یک transpiler (اگر از syntax یا operatorهای مدرن استفاده می‌کنید) و polyfills (برای اضافه کردن فانکشن‌هایی که ممکن است موجود نباشند) استفاده کنید. و با این کار مطمئن خواهید بود که کد شما کار می‌کند.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Operator" means عملگر.

فراموش نکنید که از یک transpiler (اگر از syntax یا operatorهای مدرن استفاده می‌کنید) و polyfills (برای اضافه کردن فانکشن‌هایی که ممکن است موجود نباشند) استفاده کنید. و با این کار مطمئن خواهید بود که کد شما کار می‌کند.

For example, later when you're familiar with JavaScript, you can setup a code build system based on [webpack](http://webpack.github.io/) with [babel-loader](https://github.com/babel/babel-loader) plugin.
برای مثال، بعدها که با جاوااسکریپت آشنایی بیشتری پیدا کنید، می‌توانید یک سیستم build کد با [webpack](http://webpack.github.io/) و پلاگین [babel-loader](https://github.com/babel/babel-loader) بالا بیاورید.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It'd be a better idea to use راه‌اندازی کنید instead of بالا بیاورید

- <https://kangax.github.io/compat-table/es6/> - for pure JavaScript.
- <https://caniuse.com/> - for browser-related functions.
منابع خوبی که نشان می‌دهند فیچرهای مختلف در چه حالتی از پشتیبانی قرار دارند:

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do not add extra new lines.

P.S. Google Chrome is usually the most up-to-date with language features, try it if a tutorial demo fails. Most tutorial demos work with any modern browser though.
- <https://kangax.github.io/compat-table/es6/> - برای جاوااسکریپت.
- <https://caniuse.com/> - برای فانکشن‌های مربوط به مرورگر.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do not add extra new lines.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is not an extra new line. The original file has this as far as I can tell. but I can delete it if you want.

@javascript-translate-bot

Please make the requested changes. After it, add a comment "/done".
Then I'll ask for a new review 👻

@newshahn

mahdyar

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hello @newshahn,
Please read the Translation Tips:

Please keep line breaks and paragraphs "as is": don't add newlines and don't remove existing ones. Makes it easy to merge future changes from the English version into the translation.

You can see the difference in Files changed section, line numbers on both sides should be the same.

@@ -1,92 +1,89 @@
# پلیفیل‌ها و ترنسپایلرها

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There's been a new line at the first line, add it back.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@mahdyar sorry about all these. I was using a formatter and it was changing my files. Hopefully it's fixed now.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It happens. :)

@javascript-translate-bot

Please make the requested changes. After it, add a comment "/done".
Then I'll ask for a new review 👻

@newshahn

Sorry about all the mistakes.
Hopefully they're fixed now.
/done

mahdyar

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also add a newline at the end of the file.

دو کتابخانه جالب پلیفیل‌ها:
- [core js](https://github.com/zloirock/core-js) که از چیزهای زیادی پشتیبانی می‌کند و اجازه می‌دهد فقط فیچرهای مورد نیاز خود را اضافه کنید.
- [polyfill.io](http://polyfill.io) سرویسی که یک اسکریپت با پلیفیل‌ها ارائه می‌دهد. بسته به فیچرها و مرورگر کاربر.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

## خلاصه should be on line 79.

@javascript-translate-bot

Please make the requested changes. After it, add a comment "/done".
Then I'll ask for a new review 👻

@newshahn

mahdyar

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.