Skip to content

Commit 4060ad0

Browse files
committed
Update getting_started.md with standardized image paths and labels
Changes: - Add (getting_started)= label after line 11 for cross-references - Convert 11 image references from images/getting-started/ to _static/lecture_specific/getting_started/ for consistency - Add :figclass: auto to 10 figures (standard style) - Add :figclass: terminal to starting_nb.png (terminal screenshot) - Add :scale: 50% to debug.png per English source - Namespace all :name: attributes with gs_ prefix to avoid global label collisions (gs_jp_demo, gs_starting_nb, gs_nb, etc.) This aligns the Persian translation with the established conventions from the English source and other QuantEcon lectures.
1 parent 7977f90 commit 4060ad0

File tree

1 file changed

+69
-11
lines changed

1 file changed

+69
-11
lines changed

lectures/getting_started.md

Lines changed: 69 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ kernelspec:
99
name: python3
1010
---
1111

12+
(getting_started)=
1213
# بیاین شروع کنیم
1314

1415
## مقدمه
@@ -86,7 +87,12 @@ kernelspec:
8687
به دلیل این قابلیت ها، امروزه ژوپیتر یکی از ابزارهای مهم در اکوسیستم محاسبات علمی محسوب می شود.
8788
در [اینجا](http://matplotlib.org/examples/pylab_examples/hexbin_demo.html) تصویری از اجرای کد در یک ژوپیتر نوت بوک آورده شده است.
8889

89-
![نمونه اجرای کد](images/getting-started/jp_demo.png)
90+
```{figure} _static/lecture_specific/getting_started/jp_demo.png
91+
:name: gs_jp_demo
92+
:figclass: auto
93+
94+
نمونه اجرای کد
95+
```
9096

9197
درحالیکه ژوپیتر تنها روش برنامه نویسی در پایتون نیست، اما بهترین گزینه برای موقعیت هایی است که:
9298

@@ -113,7 +119,12 @@ kernelspec:
113119

114120
اگر روش دوم را انتخاب کنید، با چیزی مشابه تصویر زیر رو به رو خواهید شد.
115121

116-
![ترمینال](images/getting-started/starting_nb.png)
122+
```{figure} _static/lecture_specific/getting_started/starting_nb.png
123+
:name: gs_starting_nb
124+
:figclass: terminal
125+
126+
ترمینال
127+
```
117128

118129
خروجی نشان می دهد که نوت بوک در `/http://localhost:8888` در حال اجرا است.
119130

@@ -126,7 +137,12 @@ kernelspec:
126137

127138
اگر همه چیز به درستی پیش رفته باشد، مرورگر پیش فرض شما باید به طور خودکار یک صفحه ی وب مشابه تصویر زیر را باز کرده باشد.
128139

129-
![ژوپیتر](images/getting-started/nb.png)
140+
```{figure} _static/lecture_specific/getting_started/nb.png
141+
:name: gs_nb
142+
:figclass: auto
143+
144+
ژوپیتر
145+
```
130146

131147

132148
آنچه در اینجا می بینید *داشبورد* ژوپیتر نام دارد.
@@ -136,7 +152,13 @@ kernelspec:
136152
در صورتیکه همه چیز به درستی کار کرده باشد، اکنون می توانید روی "New" در گوشه ی بالا سمت راست کلیک کنید و `Python 3` یا چیزی مشابه آن را انتخاب کنید.
137153

138154
در زیر تصویری که در سیستم ما نشان می دهد را میتوانید ببینید:
139-
![ژوپیتر2](images/getting-started/nb2.png)
155+
156+
```{figure} _static/lecture_specific/getting_started/nb2.png
157+
:name: gs_nb2
158+
:figclass: auto
159+
160+
ژوپیتر
161+
```
140162

141163
نوت بوک یک سلول کد فعال را نشان می دهد که می توانید دستورات پایتون را در آن وارد کنید.
142164

@@ -150,7 +172,12 @@ kernelspec:
150172

151173
وقتی آماده ی اجرای کدی که در سلول نوشتید هستید، به جای آنکه به طور معمول از "Enter" استفاده کنید، کلیدهای "Shift + Enter" را بزنید.
152174

153-
![ژوپیتر3](images/getting-started/nb3.png)
175+
```{figure} _static/lecture_specific/getting_started/nb3.png
176+
:name: gs_nb3
177+
:figclass: auto
178+
179+
ژوپیتر
180+
```
154181

155182
```{note}
156183
همچنین با کمی جستجو می توانید گزینه های منو و دکمه هایی را برای اجرای کد درون سلول پیدا کنید.
@@ -245,7 +272,12 @@ plt.show()
245272

246273
برای نمونه، کافی است تایپ کنیم `np.random.r` و سپس کلید Tab را فشار دهیم.
247274

248-
![numpy](images/getting-started/nb6.png)
275+
```{figure} _static/lecture_specific/getting_started/nb6.png
276+
:name: gs_nb6
277+
:figclass: auto
278+
279+
numpy
280+
```
249281

250282
ژوپیتر نوت بوک چندین گزینه ی تکمیل کننده ی خودکار را برای انتخاب در اختیارتان قرار می دهد.
251283

@@ -257,7 +289,12 @@ plt.show()
257289

258290
مستندات مربوط به این نحو در پنجره ای به طور جداگانه همانند تصویر زیر نمایش داده می شود.
259291

260-
![online help](images/getting-started/nb6a.png)
292+
```{figure} _static/lecture_specific/getting_started/nb6a.png
293+
:name: gs_nb6a
294+
:figclass: auto
295+
296+
online help
297+
```
261298

262299
با کلیک بر روی ضربدر در قسمت بالایی سمت راست در نیم پنجره ی ایجاد شده برای راهنمای دستور، راهنمای آنلاین بسته می شود.
263300

@@ -273,11 +310,21 @@ plt.show()
273310

274311
(همچنین می توانید با استفاده از ماوس، گزینه " Markdown " را از منوی کشویی "Code" که درست زیر نوار منو قرار دارد، انتخاب کنید.)
275312

276-
![markdown](images/getting-started/nb7.png)
313+
```{figure} _static/lecture_specific/getting_started/nb7.png
314+
:name: gs_nb7
315+
:figclass: auto
316+
317+
markdown
318+
```
277319

278320
حال ما کلیدهای `Shift + Enter` را میزنیم تا نتیجه ای مطابق تصویر زیر ایجاد کنیم:
279321

280-
![resultmd](images/getting-started/nb8.png)
322+
```{figure} _static/lecture_specific/getting_started/nb8.png
323+
:name: gs_nb8
324+
:figclass: auto
325+
326+
resultmd
327+
```
281328

282329
### اشکال زدایی کد
283330

@@ -287,7 +334,13 @@ plt.show()
287334

288335
اگر از نسخه ی جدیدتری از ژوپیتر نوت بوک استفاده می کنید، باید نماد یک حشره (bug) را در انتهای سمت راست نوار ابزار خود داشته باشید.
289336

290-
![dedugicon](images/getting-started/debug.png)
337+
```{figure} _static/lecture_specific/getting_started/debug.png
338+
:name: gs_debug
339+
:scale: 50%
340+
:figclass: auto
341+
342+
debug icon
343+
```
291344

292345
با کلیک بر روی این آیکون، اشکال زدایی ژوپیتر فعال می شود.
293346

@@ -300,7 +353,12 @@ plt.show()
300353

301354
سپس می توانید خط به خط کد را با استفاده از دکمه های "Next" که در نوار ابزار CALLSTACK در پنجره ی سمت راست قرار دارد، بررسی کنید.
302355

303-
![degug2](images/getting-started/debugger_breakpoint.png)
356+
```{figure} _static/lecture_specific/getting_started/debugger_breakpoint.png
357+
:name: gs_debugger_breakpoint
358+
:figclass: auto
359+
360+
debugger breakpoint
361+
```
304362

305363
می توانید قابلیت های بیشتری از اشکال زدایی در ژوپیتر را در [اینجا](https://jupyterlab.readthedocs.io/en/latest/user/debugger.html) پیدا کنید.
306364

0 commit comments

Comments
 (0)