Doc translate to Persian(farsi) #45664
Open
zeoses wants to merge 3 commits intohuggingface:mainfrom
Open
Conversation
Add README_fa.md to introduce Persian documentation support This commit adds a Persian version of the README (README_fa.md) to improve multilingual support and make the project more accessible for Persian-speaking users.
add farsi translation for README.md
stevhliu
reviewed
Apr 28, 2026
Member
stevhliu
left a comment
stevhliu
left a comment
There was a problem hiding this comment.
thanks for the translation
make sure the structure and content stays consistent with the English source. it seems like some details are missing
| پایپ لاین (Pipeline) یک کلاس سطحبالا برای انجام استنتاج (Inference) است که از کار با متن، صدا، تصویر و وظایف چندوجهی (multimodal) پشتیبانی میکند. این ابزار بهطور خودکار مراحل پیشپردازش ورودی را انجام میدهد و خروجی مناسب را برمیگرداند. | ||
|
|
||
| برای شروع، یک pipeline بسازید و مشخص کنید از چه مدلی برای تولید متن استفاده شود. مدل بهصورت خودکار دانلود و در حافظهٔ کش (cache) ذخیره میشود تا در اجراهای بعدی بتوان بهراحتی دوباره از آن استفاده کرد. | ||
| ### تولید متن (Text Generation) |
Member
There was a problem hiding this comment.
Suggested change
| ### تولید متن (Text Generation) |
| [{'generated_text': 'the secret to baking a really good cake is 1) to use the right ingredients and 2) to follow the recipe exactly. the recipe for the cake is as follows: 1 cup of sugar, 1 cup of flour, 1 cup of milk, 1 cup of butter, 1 cup of eggs, 1 cup of chocolate chips. if you want to make 2 cakes, how much sugar do you need? To make 2 cakes, you will need 2 cups of sugar.'}] | ||
| ``` | ||
|
|
||
| ### چت (Chat) |
Member
There was a problem hiding this comment.
missing a > [!TIP] about chatting with a model directly from the command line and the corresponding code snippet
Suggested change
| ### چت (Chat) |
|
|
||
| *نکته: همچنین میتوانید از رابط خط فرمان `transformers chat` برای چت در ترمینال استفاده کنید.* | ||
|
|
||
| ### سایر مدالیتهها (صدا، بینایی کامپیوتر، چندوجهی) |
Member
There was a problem hiding this comment.
use <details>/<summary> blocks to hide the asr, image classification, and vqa examples
|
|
||
| ## چرا باید از Transformers استفاده کنیم؟ | ||
|
|
||
| ۱. **استفاده آسان:** دسترسی به پیشرفتهترین مدلها با کمترین مانع، انتزاع (abstraction) کم و یک API یکپارچه. |
Member
There was a problem hiding this comment.
each of these have some sub-bullets that appear to be missing
| * رابط آموزش (Training API) بهینهسازی شده برای مدلهای Transformers است. برای حلقههای عمومی یادگیری ماشین، بهتر است از کتابخانههایی مانند [Accelerate](Accelerate) استفاده کنید. | ||
| * [اسکریپتهای نمونه](https://github.com/huggingface/transformers/tree/main/examples) ممکن است برای موارد استفاده خاص شما نیاز به تغییر و سازگاری داشته باشند. | ||
|
|
||
| ## جامعه کاربری (Community) |
Member
There was a problem hiding this comment.
this section also seems heavily cut
| ## چرا *نباید* از Transformers استفاده کنیم؟ | ||
|
|
||
| * این کتابخانه یک جعبهابزار ماژولار برای شبکههای عصبی عمومی نیست؛ کدهای مدلها عمداً برای محققان کمتر انتزاعی شدهاند. | ||
| * رابط آموزش (Training API) بهینهسازی شده برای مدلهای Transformers است. برای حلقههای عمومی یادگیری ماشین، بهتر است از کتابخانههایی مانند [Accelerate](Accelerate) استفاده کنید. |
Member
There was a problem hiding this comment.
Suggested change
| * رابط آموزش (Training API) بهینهسازی شده برای مدلهای Transformers است. برای حلقههای عمومی یادگیری ماشین، بهتر است از کتابخانههایی مانند [Accelerate](Accelerate) استفاده کنید. | |
| * رابط آموزش (Training API) بهینهسازی شده برای مدلهای Transformers است. برای حلقههای عمومی یادگیری ماشین، بهتر است از کتابخانههایی مانند [Accelerate](https://huggingface.co/docs/accelerate) استفاده کنید. |
|
|
||
| تأثیر این کتابخانه بر جامعه کاربری بسیار گسترده است. صفحه [awesome-transformers](https://github.com/huggingface/transformers/blob/main/awesome-transformers.md) لیستی از ۱۰۰ پروژه فوقالعاده را که با استفاده از Transformers ساخته شدهاند، به نمایش میگذارد. | ||
|
|
||
| ## مدلهای نمونه |
Member
There was a problem hiding this comment.
missing many models in this section
This file contains hidden or 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
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
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.
This PR adds a new README_fa.md file to begin providing Persian-language documentation for the project.
The goal is to improve multilingual accessibility and offer native-language support for Persian-speaking users.
This is a documentation-only contribution and does not modify any source code.
What does this PR do?
Adds a dedicated Persian README (README_fa.md)
Improves multilingual support and documentation accessibility
There is no related issue; this is a standalone documentation improvement.
Fixes: N/A
Code Agent Policy
[x] I confirm that this is not a pure code agent PR.I drafted the file manually and used an assistant only for wording review.
Before submitting
[x] This PR improves the documentation.
[x] I have read the contributor guidelines (Pull Request section).
[x] This change does not require discussion via an issue or forum.
[x] I have updated the documentation by adding the new Persian README.
[ ] No tests are required for this documentation-only PR.
Who can review?
This PR only affects documentation.
Reviewers familiar with documentation guidelines may review it.
Suggested reviewer: @stevhliu