QuantEcon / QuantEcon/lecture-python-programming.fa
Questions regarding updating about_py.md and handling LTR fragments in RTL layout
還沒有人認領這個 Issue。
- 主要語言
- Python
- 星號
- 1
- 分支
- 1
- 平均合併
- 10 小時 5 分鐘
- 30 天內合併 PR
- 5
描述
Hi @mmcky
I have two questions as I continue reviewing the Persian lecture files:
1.Update of about_py.md
Based on the updates you recently applied to the other lectures — including the new conventions for figure directives, LaTeX alignment — the overall structure of the lecture series has now become consistent and standardized.
The about_py.md lecture, however, still follows the older structure. I wanted to ask whether you are planning to update this lecture as well so that it aligns with the new conventions.
If this update is planned, will you be handling it, or would you prefer that I apply the necessary changes and open a PR?
2.LTR content inside RTL text
Some English fragments need to remain left-to-right within the Persian (RTL) text, for example:
- file extensions (e.g., .ipynb)
- function names (e.g., append())
- assignments or short code expressions (e.g., ϵ_values = [])
These currently render right-to-left in the preview.
Should I continue fixing these manually (as I did in getting_started.md by reversing placement), or do you expect that the theme will eventually handle such cases automatically?
Thank you, and please let me know how you would like me to proceed.
貢獻指南
這個儲存庫沒有索引到貢獻指南
從這裡開始
- 先讀完整個 Issue,再讀專案的貢獻指南。
- 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
- Fork 儲存庫,在一個分支上完成修改。
- 送出 Pull Request,並在描述裡引用這個 Issue 編號。
研究方向
先查看 about_py.md 以及 getting_started.md 中現有的 RTL 處理,然後檢查所列英文片段的預覽行為。明確預期結果是更新文件、手動進行 LTR 修正,還是變更 theme;當達成共識的方向,且波斯語講義檔案中的呈現保持一致時,即視為完成。
由索引模型根據 Issue 內容生成。
評估
- 領域
- documentation, internationalization
- Issue 類型
- 文件
- 難度
- 4/5
- 預估耗時
- 3-5 天
- 活躍度
- 停滯
- 描述清晰度
- 需要釐清
- 新手友好度
- 25/100