You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This repository hosts the translation of <https://javascript.info> in Persian (Farsi).
4
4
5
+
**Got a question to ask? feel free to ask in our Telegram group: [t.me/javascriptFa](https://t.me/javascriptFa)**
6
+
5
7
**That's how you can contribute:**
6
8
7
9
- See the [Persian (Farsi) Translate Progress](https://github.com/javascript-tutorial/fa.javascript.info/issues/1) issue.
@@ -20,9 +22,9 @@ If maintainers do not respond, or if you'd like to become a maintainer, write us
20
22
21
23
🎉 Thank you!
22
24
23
-
ما همچنین میخواهیم در این آموزش با افراد دیگر نیز همکاری کنیم.
25
+
We'd also like to collaborate on the tutorial with other people.
24
26
25
-
چیزی اشتباه است؟ موضوعی کم است؟ آن را به افراد دیگر توضیح دهید و با PR آن را اضافه کنید.
27
+
Something's wrong? A topic is missing? Explain it to people, add it as PR 👏
26
28
27
29
**You can edit the text in any editor.** The tutorial uses an enhanced "markdown" format, easy to grasp. And if you want to see how it looks on-site, there's a server to run the tutorial locally at <https://github.com/javascript-tutorial/server>.
28
30
@@ -137,113 +139,137 @@ Please don't translate or remove the `[#...]` part, it's for URL anchors.
137
139
## نکات ترجمهٔ فارسی
138
140
در این بخش، نکاتی مختص ترجمه به زبان فارسی را بررسی میکنیم. لطفاً قبل از خواندن این بخش، [نکات کلی ترجمه](#translation-tips) را مطالعه کنید.
139
141
140
-
لغتنامه در انتها و بعد از تمام نکات قرار دارد.
141
-
142
142
### نیمفاصله
143
143
نیمفاصله، نویسهای در استاندارد یونیکد است که برای حروفچینی کامپیوتری برخی خطها همچون خط فارسی و خطهای هندیک بهکار میرود.[^1]
144
144
برای خوانایی بهتر متن لطفاً از آن استفاده کنید اما اگر قصد انجام چنین کاری را ندارید، لطفاً در هیچ کجای متن از آن استفاده نکنید تا ترجمهای یکدست داشته باشیم.
145
145
146
146
برای آشنایی با نحوهٔ استفاده از نیمفاصله، به صفحهٔ آن [^1] در ویکیپدیای فارسی مراجعه کنید.
147
147
148
148
### ترجمۀ کامنتها در کد
149
-
ترجمۀ کامنتها میتواند کمی سخت باشد. کامنتها دو حالت دارند:
150
-
151
-
1. کامنتهایی که در ترجمۀ آنها کلمۀ انگلیسی وجود ندارد.
152
-
2. کامنتهایی که در ترجمۀ آنها کلمۀ انگلیسی وجود دارد.
149
+
ترجمۀ کامنتها میتواند کمی دشوار باشد. ترجمۀ کامنتهایی که کاملا فارسی هستند به درستی در بلوکهای کد نشان داده میشوند اما ترجمههایی که شامل کلمات انگلیسی میشوند خوانایی راحتی ندارند.
153
150
154
-
کامنتهای نوع اول خوانایی خود را در کد حفظ میکنند. اما به دلیل اینکه کد از چپ به راست نوشته و خوانده میشود، کامنتهای نوع دوم خوانایی خوبی ندارند.
151
+
برای خوانا کردن کامنتهای نوع دوم، باید ترتیب نوشتن را تغییر دهیم. برای مثال کامنت پایین را در نظر بگیرید:
155
152
156
-
ما اینجا روشی را معرفی میکنیم تا این کامنتها به راحتی متن اصلی خوانده شوند.
153
+
<divdir="ltr">
157
154
158
-
زمانی که نوشتن از چپ به راست است اگر شما به فارسی چیزی بنویسید، در صورت وجود کلمۀ انگلیسی، ترتیب خواندن جمله بهم میریزد.
155
+
```
156
+
... code ...
157
+
// We want the for..of to work
158
+
... code ...
159
+
```
160
+
</div>
159
161
160
-
بیایید با یک مثال این را نشان دهیم:
162
+
ترجمۀ معمولی این کامنت به صورت زیر خواهد بود:
161
163
162
164
<divdir="ltr">
163
-
164
-
```
165
-
...code...
166
165
167
-
// امروز John را دیدم
168
-
169
-
...code...
166
+
```
167
+
... code ...
168
+
// ما میخواهیم که for..of کار کند
169
+
... code ...
170
170
```
171
171
</div>
172
172
173
-
همانطور که میبینید، ترتیب جمله بالا به دلیل وجود کلمه "John" تغییر کرده است. اگر به طور معمولی و از راست به چپ جمله را بخوانیم، اینگونه خواهد بود: «را دیدم John امروز».
174
-
اما در اصل جمله باید اینگونه خوانده شود: «امروز John را دیدم».
173
+
برای خوانا کردن این کامنت، باید ترتیب نوشتن را تغییر دهیم. با شروع از راست به چپ، به صورت زیر عمل میکنیم:
175
174
176
-
حالا بیایید ترتیب جمله در کد را تغییر دهیم:
175
+
1. به عبارت «کار کند» میرسیم و آن را مینویسیم:
177
176
178
177
<divdir="ltr">
179
-
180
-
```
181
-
...code...
182
-
183
-
// را دیدم John امروز
184
178
185
-
...code...
179
+
```
180
+
... code ...
181
+
// ما میخواهیم for..of کار کند
182
+
// کار کند
183
+
... code ...
186
184
```
187
185
</div>
188
186
189
-
حالا میتوانیم جمله را با ترتیب درست بخوانیم. بیایید به تغییرات دقت کنیم. در جمله بالایی «را دیدم» سمت راست بود اما حالا سمت چپ. موقعیت "John" تفاوتی نداشته اما «امروز» هم جابجا شده و سمت راست قرار گرفته است.
190
-
191
-
بنابراین ما با جابجایی کلمات فارسی نسبت به کلمات انگلیسی، توانستیم جمله را خوانا کنیم. حالا بیایید یک مثال طولانیتر ببینیم:
187
+
2. سپس به عبارت «for..of» میرسیم و آن را مینویسیم:
192
188
193
189
<divdir="ltr">
194
190
195
191
```
196
-
...code...
197
-
198
-
// امروز John را همراه با Merry دیدم
199
-
200
-
...code...
192
+
... code ...
193
+
// ما میخواهیم for..of کار کند
194
+
// کار کند for..of
195
+
... code ...
201
196
```
202
197
</div>
203
198
204
-
برای اینکه ترتیب این جمله را درست کنیم، باید جمله را به طور برعکس بنویسیم؛ یعنی از سمت راست به چپ هر کلمه را دوباره بنویسیم:
199
+
3.به عبارت «ما میخواهیم» میرسیم و آن را مینویسیم:
205
200
206
201
<divdir="ltr">
207
202
208
203
```
209
-
...code...
204
+
... code ...
205
+
// ما میخواهیم for..of کار کند
206
+
// کار کند for..of ما میخواهیم
207
+
... code ...
208
+
```
209
+
</div>
210
210
211
-
// امروز John را همراه با Merry دیدم
212
-
// دیدم Merry را همراه با John امروز
211
+
4. در نهایت کامنت قبلی را پاک میکنیم. ترجمۀ نهایی به این صورت است:
213
212
214
-
...code...
213
+
<divdir="ltr">
214
+
215
+
```
216
+
... code ...
217
+
// کار کند for..of ما میخواهیم
218
+
... code ...
215
219
```
216
220
</div>
217
221
218
-
در مثال بالا با شروع از سمت راست جمله، اینگونه عمل کردیم:
222
+
همانطور که میبینید با برعکس کردن ترتیب عبارات ترجمه شده از راست به چپ کامنت خوانایی خود را بدست آورد.
219
223
220
-
1. به کلمه «دیدم» رسیدیم و در خط پایین آن را نوشتیم.
221
-
2. سپس به کلمه "Merry" رسیدیم و آن را نوشتیم.
222
-
3. به عبارت «را همراه با» رسیدیم و آن را نوشتیم.
223
-
4. پس از آن "John" را نوشتیم.
224
-
5. و سرانجام «امروز».
224
+
این روش ممکن است کمی دشوار به نظر برسد اما ارزش آن را دارد. فراموش نکنید خوانا بودن متن به فهم آن کمک زیادی میکند.
225
+
226
+
**توجه کنید که این روش تنها برای ترجمۀ کامنتها استفاده میشود و متن اصلی به این روش نیازی ندارد.** متن اصلی مانند جملات بالایی و به صورت معمولی ترجمه میشود.
225
227
226
-
در نهایت باید جمله بالایی را پاک کنیم پس نتیجه نهایی اینگونه است:
228
+
مثالهایی بیشتر (نوشتن مراحل در این مثالها تنها برای فهم بهتر است و شما نیازی به نوشتن مراحل ندارید. کامنتها باید بدون نوشتن مراحل ترجمه شوند):
227
229
228
230
<divdir="ltr">
229
231
230
232
```
231
-
...code...
233
+
... code ...
234
+
// await تنها در توابع async کار می کند
235
+
// 1. کار میکند
236
+
// 2. کار میکند async
237
+
// 3. کار میکند async تنها در توابع
238
+
// 4. کار میکند async تنها در توابع await
239
+
... code ...
240
+
```
241
+
</div>
232
242
233
-
// دیدم Merry را همراه با John امروز
243
+
<divdir="ltr">
234
244
235
-
...code...
245
+
```
246
+
... code ...
247
+
// بعد از 1000 میلی ثانیه با مقدار this.num * 2 حل می شود
248
+
// 1. حل میشود
249
+
// 2. حل میشود this.num * 2
250
+
// 3. حل میشود this.num * 2 بعد از 1000 میلی ثانیه با مقدار
251
+
... code ...
236
252
```
237
253
</div>
238
254
239
-
همانطور که میبینید، با نوشتن جملۀ بالایی به صورت برعکس، به جملۀ پایین با ترتیب درست رسیدیم.
240
-
241
-
این نحوۀ نوشتن ترجمۀ کامنتهایی است که کلمات انگلیسی دارند. با برعکس کردن ترتیب جملۀ ترجمه شده!
255
+
<divdir="ltr">
242
256
243
-
این روش ممکن است کمی دشوار به نظر برسد اما ارزش آن را دارد. فراموش نکنید خوانا بودن متن به فهم آن کمک زیادی میکند.
257
+
```js
258
+
let hello ='Hello world!';
259
+
260
+
let message;
261
+
262
+
// 'Hello world' را از hello درون message کپی کن
263
+
// 1. کپی کن
264
+
// 2. کپی کن message
265
+
// 3. کپی کن message درون
266
+
// 4. کپی کن message درون hello
267
+
// 5. کپی کن message درون hello را از
268
+
// 6. کپی کن message درون hello را از 'Hello world'
269
+
message = hello;
270
+
```
271
+
</div>
244
272
245
-
**توجه کنید که این روش تنها برای ترجمۀ کامنتها استفاده میشود و متن اصلی به این روش نیازی ندارد.** متن اصلی مانند جملات بالایی و به صورت معمولی ترجمه میشود.
246
-
247
273
در صورتی که راه بهتری را برای ترجمۀ کامنتها سراغ دارید ممنون میشویم با [ساختن یک issue](https://github.com/javascript-tutorial/fa.javascript.info/issues/new/choose)
248
274
آن را با ما در میان بگذارید.
249
275
@@ -261,91 +287,10 @@ Please don't translate or remove the `[#...]` part, it's for URL anchors.
261
287
262
288
### نکات جزئی
263
289
264
-
- سعی کنید تیترها و جملهها را با کلمات فارسی شروع کنید.
265
290
- خوانایی جمله مهم است، لطفا به آن توجه کنید.
266
-
- لطفا از لغتنامه پایین **استفاده کنید** تا ترجمهای یکدست داشته باشیم.
267
291
- استفاده از علائم نگارشی حتما نباید دقیقا مانند متن باشد. ممکن است ما در فارسی جایی ویرگول نگذاریم اما در انگلیسی نیاز به کاما وجود داشته باشد. فقط بیان جلمات را تغییر ندهید، برای مثال اگر جمله سوالی یا تعجبی نیست علائم مربوط را اضافه یا حذف نکنید.
268
292
- مقدارهای بولین (boolean) را ترجمه نکنید.
269
293
270
-
### لغتنامه
271
-
در صورتی که کلمۀ مورد نظر شما در این جدول نبود لطفا به ما اطلاع دهید یا README را ویرایش کنید و یک Pull Request بفرستید.
0 commit comments