🌐 Add Persian translation for docs/fa/docs/advanced/sub-applications.md
#9692
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,72 @@ | ||
| # زیر برنامه ها - نصب | ||
|
|
||
| اگر نیاز دارید که دو برنامه مستقل FastAPI، با OpenAPI مستقل و رابط‌های کاربری اسناد خود داشته باشید، می‌توانید یک برنامه | ||
| اصلی داشته باشید و یک (یا چند) زیر برنامه را "mount" (سوار) کنید. | ||
|
|
||
| ## نصب کردن یک برنامه **FastAPI** | ||
|
|
||
| "Mounting" به معنای افزودن یک برنامه کاملاً مستقل در یک مسیر خاص است، که پس از آن به مدیریت همه چیز در آن مسیر، با | ||
| عملیات مسیر اعلام شده در آن زیر برنامه، رسیدگی می کند. | ||
|
|
||
| ### برنامه سطح بالا | ||
|
|
||
| ابتدا برنامه اصلی سطح بالا، **FastAPI** و عملیات مسیر آن را ایجاد کنید: | ||
|
|
||
| ```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 است، اما این برنامه ای است که "mount" می شود: | ||
|
|
||
| ```Python hl_lines="11 14-16" | ||
|
There was a problem hiding this comment. {!../../../docs_src/sub_applications/tutorial001.py!} |
||
| {!../../../ 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!} |
||
| {!../../../ docs_src / sub_applications / tutorial001.py!} | ||
| ``` | ||
|
|
||
| ### اسناد API خودکار را بررسی کنید | ||
|
|
||
| حالا ‘uvicorn’ را برای برنامه اصلی اجرا کنید، برای مثال اگر فایل شما`main.py` هست: | ||
|
There was a problem hiding this comment. برنامه را با استفاده از uvicorn اجرا کنید، اگر فایل شما main.py نام دارد، دستور زیر را وارد کنید همچنین تو ترجمه ای که انجام دادی یک space برای main.py جا افتاده 😃 |
||
| <div class="termy"> | ||
|
|
||
| ```console | ||
| $ uvicorn main:app --reload | ||
|
|
||
| <span style="color: green;">INFO</span>: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit) | ||
| ``` | ||
|
|
||
| </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 باز کنید. |
||
| اسناد API خودکار برنامه اصلی را مشاهده خواهید کرد که فقط شامل عملیات مسیر خود می شود: | ||
|
There was a problem hiding this comment. خب الان مشاهده میکنید که اسناد API خودکار برنامه اصلی فقط شامل path operations خود میباشد این ترجمه و ترجمه بالا باید تو دو خط جدا باشند |
||
|
|
||
| <img src="/img/tutorial/sub-applications/image01.png"> | ||
|
|
||
| و سپس اسناد زیر برنامه را در آدرس <a href="http://127.0.0.1:8000/subapi/docs" class="external-link" target="_blank">http://127.0.0.1:8000/subapi/docs</a>. باز کنید. | ||
|
|
||
| اسناد API خودکار برای زیر برنامه را خواهید دید، که فقط شامل عملیات مسیر خود می شود، همه در زیر مسیر `/subapi` قرار دارند: | ||
|
|
||
| <img src="/img/tutorial/sub-applications/image02.png"> | ||
|
|
||
| اگر سعی کنید با هر یک از این دو رابط کاربری تعامل داشته باشید، آنها به درستی کار می کنند، زیرا مرورگر می تواند با هر یک از برنامه ها یا زیر برنامه های خاص صحبت کند. | ||
|
|
||
| ### جرئیات فنی : `root_path` | ||
|
|
||
| هنگامی که یک زیر برنامه را همانطور که در بالا توضیح داده شد نصب می کنید,FastAPI با استفاده از مکانیزمی از مشخصات ASGI به نام `root_path` ارتباط مسیر mount را برای زیر برنامه انجام می دهد. | ||
|
|
||
| به این ترتیب، زیر برنامه می داند که از آن پیشوند مسیر برای رابط کاربری اسناد (docs UI) استفاده کند. | ||
|
|
||
| و زیر برنامه ها نیز می تواند زیر برنامه های نصب شده خود را داشته باشد و همه چیز به درستی کار کند، زیرا FastAPI تمام این مسیرهای `root_path` را به طور خودکار مدیریت می کند. | ||
|
|
||
| در بخش [پشت پراکسی](./behind-a-proxy.md){.internal-link target=_blank}. درباره `root_path` و نحوه استفاده درست از آن بیشتر خواهید آموخت. | ||
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
به نظرم تو ترجمه مطالب تکنیکال نباید تمام کلمات به فارسی ترجمه بشن چون معنی, خوانایی و درک جمله رو پایین میارن, برای مثال تو این قسمت استفاده از path operations به جای "عملیات مسیر" هم معنی بهتری داره و هم خواناتر هستش یا اینکه استفاده کلمه sub-application بهتر از کلمه "زیر برنامه" هستش, برای عنوان هم فکر میکنم اینجا کلمه اتصال بهتر از نصب باشه
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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.