🌐 Add Persian translation for docs/fa/docs/advanced/sub-applications.md
#9692
Conversation
|
📝 Docs preview for commit 6226e54 at: https://648da98878649d03c1a5bd47--fastapi.netlify.app |
tiangolo
changed the title
docs/fa/docs/advanced/sub-applications.md
tiangolo
added
lang-all
| @@ -0,0 +1,72 @@ | |||
| # برنامه فرعی - نصب | |||
There was a problem hiding this comment.
دلیل خاصی داره کلمه «برنامه اصلی» رو انتخاب کردی؟ کلمه «زیربرنامه» ترجمه دقیق تری نیست؟
There was a problem hiding this comment.
بله نظر شما درست تر است و آن را تغییر دادم.
ممنون از توجهات به این مطلب
Co-authored-by: Amin Alaee <mohammadamin.alaee@gmail.com>
|
📝 Docs preview for commit 14550db at: https://64948757c0798e57b6bd8e37--fastapi.netlify.app |
A better translation for the word sub-applications
|
📝 Docs preview for commit ebd5eb5 at: https://64948b3595eb4000865e04a4--fastapi.netlify.app |
| ## نصب کردن یک برنامه **FastAPI** | ||
|
|
||
| "Mounting" به معنای افزودن یک برنامه کاملاً مستقل در یک مسیر خاص است، که پس از آن به مدیریت همه چیز در آن مسیر، با | ||
| عملیات مسیر اعلام شده در آن زیر برنامه، رسیدگی می کند. |
There was a problem hiding this comment.
به نظرم تو ترجمه مطالب تکنیکال نباید تمام کلمات به فارسی ترجمه بشن چون معنی, خوانایی و درک جمله رو پایین میارن, برای مثال تو این قسمت استفاده از path operations به جای "عملیات مسیر" هم معنی بهتری داره و هم خواناتر هستش یا اینکه استفاده کلمه sub-application بهتر از کلمه "زیر برنامه" هستش, برای عنوان هم فکر میکنم اینجا کلمه اتصال بهتر از نصب باشه
There was a problem hiding this comment.
I agree with the suggestion, but there’s a limit that you need to draw the line.
For example you are right that “path operations” should not be translated, but we can translate sub-application as we already have a good translation for application.
I checked the documentation translation and improved it a bit.
|
📝 Docs preview for commit 402960b at: https://64953d22f52eb444e494bdf9--fastapi.netlify.app |
There was a problem hiding this comment.
Some suggestions to improve the translation, also the code blocks are not displayed
You can check in the following link:
https://64953d22f52eb444e494bdf9--fastapi.netlify.app/fa/advanced/sub-applications/
|
|
||
| ### اتصال زیر برنامه | ||
|
|
||
| در برنامه سطح بالا `app` اتصال زیر برنامه `subapi` در این نمونه `/subapi` در مسیر قرار میدهد و میشود: |
There was a problem hiding this comment.
در برنامه اصلی(سطح بالا) که app نام دارد، زیربرنامه subapi را متصل (mount) کنید.
در این مورد، زیربرنامه در مسیر /subapi متصل خواهد شد.
| ## اتصال (mount) به یک برنامه **FastAPI** | ||
|
|
||
| "Mounting" به معنای افزودن یک برنامه کاملاً مستقل در یک مسیر خاص است، که پس از آن مدیریت همه چیز در آن مسیر، با | ||
| path operations (عملیات مسیر) اعلام شده در آن زیر برنامه می باشد. |
There was a problem hiding this comment.
عملیات مسیر جالب نیستش پس بهتر نباشه یا حداقل «عملیات های مسیر» درست تر هستش
|
|
||
| ### اسناد API خودکار را بررسی کنید | ||
|
|
||
| حالا ‘uvicorn’ را برای برنامه اصلی اجرا کنید، برای مثال اگر فایل شما`main.py` هست: |
There was a problem hiding this comment.
برنامه را با استفاده از uvicorn اجرا کنید، اگر فایل شما main.py نام دارد، دستور زیر را وارد کنید
همچنین تو ترجمه ای که انجام دادی یک space برای main.py جا افتاده 😃
| </div> | ||
|
|
||
| و باز کنید مستندات را در | ||
| آدرس <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a> |
There was a problem hiding this comment.
صفحه مستندات را در آدرس http://127.0.0.1:8000/docs باز کنید.
|
|
||
| و باز کنید مستندات را در | ||
| آدرس <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a> | ||
| اسناد API خودکار برنامه اصلی را مشاهده خواهید کرد که فقط شامل عملیات مسیر خود می شود: |
There was a problem hiding this comment.
خب الان مشاهده میکنید که اسناد API خودکار برنامه اصلی فقط شامل path operations خود میباشد
این ترجمه و ترجمه بالا باید تو دو خط جدا باشند
|
|
||
| ### جرئیات فنی : `root_path` | ||
|
|
||
| هنگامی که یک زیر برنامه را همانطور که در بالا توضیح داده شد متصل می کنید,FastAPI با استفاده از مکانیزمی از مشخصات ASGI به نام `root_path` ارتباط مسیر mount را برای زیر برنامه انجام می دهد. |
Make some changes to the translated documentation
|
📝 Docs preview for commit b7572cc at: https://64955d89e032e50b82130ef4--fastapi.netlify.app |
There was a problem hiding this comment.
The code blocks are not correct (I think because of space it is), that's why nothing is loaded, they should be corrected
You can see it in the following link:
https://64955d89e032e50b82130ef4--fastapi.netlify.app/fa/advanced/sub-applications/
| ابتدا برنامه اصلی سطح بالا، **FastAPI** و path operations آن را ایجاد کنید: | ||
|
|
||
| ```Python hl_lines="3 6-8" | ||
| {!../../../ docs_src / sub_applications / tutorial001.py!} |
There was a problem hiding this comment.
{!../../../docs_src/sub_applications/tutorial001.py!}
باید اصلاح بشه
|
|
||
| این زیر برنامه فقط یکی دیگر از برنامه های استاندارد FastAPI است، اما این برنامه ای است که متصل می شود: | ||
|
|
||
| ```Python hl_lines="11 14-16" |
There was a problem hiding this comment.
{!../../../docs_src/sub_applications/tutorial001.py!}
باید اصلاح بشه
|
|
||
| در برنامه سطح بالا `app` اتصال زیر برنامه `subapi` در این نمونه `/subapi` در مسیر قرار میدهد و میشود: | ||
|
|
||
| ```Python hl_lines="11 19" |
There was a problem hiding this comment.
{!../../../docs_src/sub_applications/tutorial001.py!}
باید اصلاح بشه
There were some wrong spaces in the links, I deleted them.
|
📝 Docs preview for commit 22bcb14 at: https://64959158be371e2b9e7b689e--fastapi.netlify.app |
|
📝 Docs preview for commit cad7ac6 at: https://649a316c443f2f2085861512--fastapi.netlify.app |
|
Great, thank you @mojtabapaso! 🎉 And thanks for the reviews @aminalaee and @heysaeid 🙇 ☕ |
I made a directory for the advanced section.
I translated and placed the sub-applications.md file inside it