Add MyST structural elements to getting_started.md

- Add raw jupyter directive with QuantEcon header banner
- Add index roles for Python, Anaconda, IPython, Jupyter, JupyterLab, QuantEcon
- Add target labels: install_anaconda, ipython_notebook, a_test_program, gs_help, gs_qe, gs_install_qe
- Add {ref} cross-reference to Docstrings
- Translate secondary index terms to Persian (راه‌اندازی, مبانی, راهنما, اشکال‌زدایی, اشتراک‌گذاری)
- Keep proper nouns in English for index entries

Author: mmcky

lectures/getting_started.md

@@ -10,8 +10,19 @@ kernelspec:
 ---
 
 (getting_started)=
+```{raw} jupyter
+<div id="qe-notebook-header" align="right" style="text-align:right;">
+        <a href="https://quantecon.org/" title="quantecon.org">
+                <img style="width:250px;display:inline;" width="250px" src="https://assets.quantecon.org/img/qe-menubar-logo.svg" alt="QuantEcon">
+        </a>
+</div>
+```
+
 # بیاین شروع کنیم
 
+```{index} single: Python
+```
+
 ## مقدمه
 
  در این بخش شما خواهید آموخت که چگونه:
@@ -51,7 +62,12 @@ kernelspec:
 
 **تمام مطالبی که در ادامه خواهید آموخت بر این فرض استوار است که شما این توصیه ها را پذیرفته اید!**
 
+(install_anaconda)=
 ### نصب آناکوندا
+
+```{index} single: Python; Anaconda
+```
+
 برای نصب آناکوندا فایل باینری را از سایت اصلی آناکوندا [دانلود](https://www.anaconda.com/download/) کرده و دستورالعمل ها را دنبال کنید.
 
 نکات:
@@ -73,7 +89,15 @@ kernelspec:
 
 برای اطلاعات بیشتر درباره کوندا، در ترمینال عبارت " conda help " را تایپ کنید.
 
-## ژوپیتر نوت بوک
+(ipython_notebook)=
+## Jupyter Notebooks
+
+```{index}
+single: Python; IPython
+single: IPython
+single: Jupyter
+```
+
 [ژوپیتر](http://jupyter.org/) نوت بوک ها یکی از چندین راه های قابل دسترس برای ارتباط برقرار کردن با پایتون هستند.
 ژوپیتر نوت بوک ها از یک رابط مبتنی بر مرورگر برای دسترسی به پایتون استفاده می کنند که دارای ویژگی های زیر است:
 
@@ -108,6 +132,9 @@ kernelspec:
 
 ### راه اندازی ژوپیتر نوت بوک
 
+```{index} single: Jupyter Notebook; راه‌اندازی
+```
+
 بعد از نصب آناکوندا، شما می توانید ژوپیتر نوت بوک را اجرا کنید.
 
 برای اینکار می توانید:
@@ -163,6 +190,10 @@ kernelspec:
 نوت بوک یک سلول کد فعال را نشان می دهد که می توانید دستورات پایتون را در آن وارد کنید.
 
 ### اصول اولیه نوت بوک
+
+```{index} single: Jupyter Notebook; مبانی
+```
+
 بیاید با نحوه ی ویرایش کد و اجرای برنامه های ساده شروع کنیم.
 
 #### اجرای سلول ها
@@ -217,6 +248,7 @@ kernelspec:
 
 در یک سلول، عبارت `alpha/`  را تایپ کنید و سپس کلید Tab را از صفحه کیبورد خود فشار دهید.
 
+(a_test_program)=
 #### یک برنامه ی آزمایشی
 
 بیایید یک برنامه آزمایشی اجرا کنیم.
@@ -283,8 +315,12 @@ numpy
 
 به همین ترتیب، کلید Tab هم یادآوری می کند که چه قابلیت هایی در دسترس شما قرار دارد و هم باعث صرفه جویی در تایپ می شود.
 
+(gs_help)=
 #### راهنمای آنلاین
 
+```{index} single: Jupyter Notebook; راهنما
+```
+
 برای مشاهده ی راهنمای نحو `np.random.randn` کافی است دستور `?np.random.randn` را اجرا کنید.
 
 مستندات مربوط به این نحو در پنجره ای به طور جداگانه همانند تصویر زیر نمایش داده می شود.
@@ -298,7 +334,7 @@ online help
 
 با کلیک بر روی ضربدر در قسمت بالایی سمت راست در نیم پنجره ی ایجاد شده برای راهنمای دستور، راهنمای آنلاین بسته می شود.
 
-در ادامه، بیشتر درباره ی نحوه ی ایجاد مستندات مشابه بیشتر یادخواهیم گرفت!
+در ادامه، بیشتر درباره ی نحوه ی ایجاد مستندات مشابه {ref}`یاد خواهیم گرفت <Docstrings>`!
 
 #### سایر محتواها
 
@@ -328,6 +364,9 @@ resultmd
 
 ### اشکال زدایی کد
 
+```{index} single: Jupyter Notebook; اشکال‌زدایی
+```
+
 به فرآیند شناسایی و حذف خطاها از یک برنامه، اشکال زدایی یا Debugging می گویند.
 
 ازآنجایی که شما زمان زیادی را صرف اشکال زدایی کد خواهید کرد، بنابراین [یادگرفتن نحوه ی انجام درست](https://www.freecodecamp.org/news/what-is-debugging-how-to-debug-code/) آن ضروری است.
@@ -364,6 +403,12 @@ debugger breakpoint
 
 ### اشتراک گذاری نوت بوک ها
 
+```{index} single: Jupyter Notebook; اشتراک‌گذاری
+```
+
+```{index} single: Jupyter Notebook; nbviewer
+```
+
 فایل های نوت بوک صرفا فایل های متنی با ساختار [JSON](https://en.wikipedia.org/wiki/JSON) هستند که معمولا پسوند `.ipynb` دارند.
 
  شما می توانید آن ها را به همان شیوه که سایر فایل ها را به اشتراک می گذارید، ارسال کنید یا اینکه از سرویس های وب مانند [nbviewer](http://nbviewer.jupyter.org/) استفاده کنید.
@@ -392,10 +437,15 @@ debugger breakpoint
 
 ## نصب کتابخانه ها
 
+(gs_qe)=
+```{index} single: QuantEcon
+```
+
 بیشتر کتابخانه های موردنیاز ما در این دوره در آناکوندا وجود دارند. اما سایر کتابخانه ها را می توان با `conda` یا `pip` نصب کرد.
 
 یکی از کتابخانه هایی که از آن استفاده خواهیم کرد، [QuantEcon.py](http://quantecon.org/quantecon-py) است.
 
+(gs_install_qe)=
 شما می توانید با اجرای ژوپیتر و تایپ دستور زیر درون یک سلول [QuantEcon.py](http://quantecon.org/quantecon-py) را نصب کنید.
 
 ```{code-block} ipython3
@@ -459,6 +509,9 @@ print("foobar")
 
 #### گزینه اول: JupyterLab
 
+```{index} single: JupyterLab
+```
+
 محیط [JupyterLab](https://github.com/jupyterlab/jupyterlab) یک محیط توسعه ی یکپارچه (IDE) است که بر پایه ی نوت بوک ها ژوپیتر ساخته شده است. با استفاده از JupyterLab می توانید فایل هایی با پسوند `*.py` را همانند ژوپیتر نوت بوک ها را ویرایش و اجرا کنید. 
 
 برای اجرای JupyterLab می توانید آن را در فهرست برنامه ها جستجو کنید یا در ترمینال دستور `jupyter-lab` را وارد نمایید.