Buckets:

download
raw
34.1 kB
<meta charset="utf-8" /><meta name="hf:doc:metadata" content="{&quot;title&quot;:&quot;چگونه یک issue خوب بنویسیم&quot;,&quot;local&quot;:&quot;how-to-write-a-good-issue&quot;,&quot;sections&quot;:[{&quot;title&quot;:&quot;ایجاد یک مثال حداقل قابل تکرار&quot;,&quot;local&quot;:&quot;creating-a-minimal-reproducible-example&quot;,&quot;sections&quot;:[],&quot;depth&quot;:2},{&quot;title&quot;:&quot;پر کردن الگوی مشکل&quot;,&quot;local&quot;:&quot;filling-out-the-issue-template&quot;,&quot;sections&quot;:[{&quot;title&quot;:&quot;از جمله اطلاعات محیطی شما&quot;,&quot;local&quot;:&quot;including-your-environment-information&quot;,&quot;sections&quot;:[],&quot;depth&quot;:3},{&quot;title&quot;:&quot;برچسب زدن افراد&quot;,&quot;local&quot;:&quot;tagging-people&quot;,&quot;sections&quot;:[],&quot;depth&quot;:3},{&quot;title&quot;:&quot;از جمله یک مثال قابل تکرار&quot;,&quot;local&quot;:&quot;including-a-reproducible-example&quot;,&quot;sections&quot;:[],&quot;depth&quot;:3},{&quot;title&quot;:&quot;شرح رفتار مورد انتظار&quot;,&quot;local&quot;:&quot;describing-the-expected-behavior&quot;,&quot;sections&quot;:[],&quot;depth&quot;:3}],&quot;depth&quot;:2},{&quot;title&quot;:&quot;بعد از آن چه؟&quot;,&quot;local&quot;:&quot;and-then-what&quot;,&quot;sections&quot;:[],&quot;depth&quot;:2}],&quot;depth&quot;:1}"/>
<link href="/docs/course/pr_1364/fa/_app/immutable/entry/start.CqZXmSrv.js" rel="modulepreload">
<link href="/docs/course/pr_1364/fa/_app/immutable/chunks/oyrVqMhC.js" rel="modulepreload">
<link href="/docs/course/pr_1364/fa/_app/immutable/chunks/B3UUDp28.js" rel="modulepreload">
<link href="/docs/course/pr_1364/fa/_app/immutable/entry/app.B4UvgX5H.js" rel="modulepreload">
<link href="/docs/course/pr_1364/fa/_app/immutable/chunks/BioDZtGL.js" rel="modulepreload">
<link href="/docs/course/pr_1364/fa/_app/immutable/chunks/NIl2lQjl.js" rel="modulepreload">
<link href="/docs/course/pr_1364/fa/_app/immutable/chunks/DN6uzRQe.js" rel="modulepreload">
<link href="/docs/course/pr_1364/fa/_app/immutable/chunks/DsnmJJEf.js" rel="modulepreload">
<link href="/docs/course/pr_1364/fa/_app/immutable/nodes/0.DcFj1eGj.js" rel="modulepreload">
<link href="/docs/course/pr_1364/fa/_app/immutable/chunks/u5kFQ1Zb.js" rel="modulepreload">
<link href="/docs/course/pr_1364/fa/_app/immutable/nodes/92.HWw_UXlT.js" rel="modulepreload">
<link href="/docs/course/pr_1364/fa/_app/immutable/chunks/BjCHz3cj.js" rel="modulepreload">
<link href="/docs/course/pr_1364/fa/_app/immutable/chunks/BPNwLiYb.js" rel="modulepreload">
<link href="/docs/course/pr_1364/fa/_app/immutable/chunks/B8VBSgkq.js" rel="modulepreload">
<link href="/docs/course/pr_1364/fa/_app/immutable/chunks/DFIrGYWg.js" rel="modulepreload">
<!--1ydlzh0--><meta name="hf:doc:metadata" content="{&quot;title&quot;:&quot;چگونه یک issue خوب بنویسیم&quot;,&quot;local&quot;:&quot;how-to-write-a-good-issue&quot;,&quot;sections&quot;:[{&quot;title&quot;:&quot;ایجاد یک مثال حداقل قابل تکرار&quot;,&quot;local&quot;:&quot;creating-a-minimal-reproducible-example&quot;,&quot;sections&quot;:[],&quot;depth&quot;:2},{&quot;title&quot;:&quot;پر کردن الگوی مشکل&quot;,&quot;local&quot;:&quot;filling-out-the-issue-template&quot;,&quot;sections&quot;:[{&quot;title&quot;:&quot;از جمله اطلاعات محیطی شما&quot;,&quot;local&quot;:&quot;including-your-environment-information&quot;,&quot;sections&quot;:[],&quot;depth&quot;:3},{&quot;title&quot;:&quot;برچسب زدن افراد&quot;,&quot;local&quot;:&quot;tagging-people&quot;,&quot;sections&quot;:[],&quot;depth&quot;:3},{&quot;title&quot;:&quot;از جمله یک مثال قابل تکرار&quot;,&quot;local&quot;:&quot;including-a-reproducible-example&quot;,&quot;sections&quot;:[],&quot;depth&quot;:3},{&quot;title&quot;:&quot;شرح رفتار مورد انتظار&quot;,&quot;local&quot;:&quot;describing-the-expected-behavior&quot;,&quot;sections&quot;:[],&quot;depth&quot;:3}],&quot;depth&quot;:2},{&quot;title&quot;:&quot;بعد از آن چه؟&quot;,&quot;local&quot;:&quot;and-then-what&quot;,&quot;sections&quot;:[],&quot;depth&quot;:2}],&quot;depth&quot;:1}"/><!---->
<link href="/docs/course/pr_1364/fa/_app/immutable/assets/0.tn0RQdqM.css" rel="modulepreload"> <!--[--><!--[0--><!--[--><!--[0--><!--[--><p></p> <div class="items-center shrink-0 min-w-[100px] max-sm:min-w-[50px] justify-end ml-auto flex" style="float: right; margin-left: 10px; display: inline-flex; position: relative; z-index: 10;"><div class="inline-flex rounded-md max-sm:rounded-sm"><button class="inline-flex items-center gap-1 h-7 max-sm:h-7 px-2 max-sm:px-1.5 text-sm font-medium text-gray-800 border border-r-0 rounded-l-md max-sm:rounded-l-sm border-gray-200 bg-white hover:shadow-inner dark:border-gray-850 dark:bg-gray-950 dark:text-gray-200 dark:hover:bg-gray-800" aria-live="polite"><span class="inline-flex items-center justify-center rounded-md p-0.5 max-sm:p-0 hover:text-gray-800 dark:hover:text-gray-200"><svg class="sm:size-3.5 size-3" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg><!----></span> <span>Copy page</span></button> <button class="inline-flex items-center justify-center w-6 max-sm:w-5 h-7 max-sm:h-7 disabled:pointer-events-none text-sm text-gray-500 hover:text-gray-700 dark:hover:text-white rounded-r-md max-sm:rounded-r-sm border border-l transition border-gray-200 bg-white hover:shadow-inner dark:border-gray-850 dark:bg-gray-950 dark:text-gray-200 dark:hover:bg-gray-800" aria-haspopup="menu" aria-expanded="false" aria-label="Open copy menu"><svg class="transition-transform text-gray-400 overflow-visible sm:size-3.5 size-3 rotate-0" width="1em" height="1em" viewBox="0 0 12 7" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M1 1L6 6L11 1" stroke="currentColor"></path></svg><!----></button></div> <!--[-1--><!--]--></div><!----> <!--[0--><h1 class="relative group"><a id="how-to-write-a-good-issue" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#how-to-write-a-good-issue"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span>چگونه یک issue خوب بنویسیم</span></h1><!--]--><!----> <div dir="rtl"><div class="flex space-x-1 absolute z-10 right-0 top-0"><a href="https://discuss.huggingface.co/t/chapter-8-questions" target="_blank"><img alt="Ask a Question" class="!m-0" src="https://img.shields.io/badge/Ask%20a%20question-ffcb4c.svg?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgLTEgMTA0IDEwNiI+PGRlZnM+PHN0eWxlPi5jbHMtMXtmaWxsOiMyMzFmMjA7fS5jbHMtMntmaWxsOiNmZmY5YWU7fS5jbHMtM3tmaWxsOiMwMGFlZWY7fS5jbHMtNHtmaWxsOiMwMGE5NGY7fS5jbHMtNXtmaWxsOiNmMTVkMjI7fS5jbHMtNntmaWxsOiNlMzFiMjM7fTwvc3R5bGU+PC9kZWZzPjx0aXRsZT5EaXNjb3Vyc2VfbG9nbzwvdGl0bGU+PGcgaWQ9IkxheWVyXzIiPjxnIGlkPSJMYXllcl8zIj48cGF0aCBjbGFzcz0iY2xzLTEiIGQ9Ik01MS44NywwQzIzLjcxLDAsMCwyMi44MywwLDUxYzAsLjkxLDAsNTIuODEsMCw1Mi44MWw1MS44Ni0uMDVjMjguMTYsMCw1MS0yMy43MSw1MS01MS44N1M4MCwwLDUxLjg3LDBaIi8+PHBhdGggY2xhc3M9ImNscy0yIiBkPSJNNTIuMzcsMTkuNzRBMzEuNjIsMzEuNjIsMCwwLDAsMjQuNTgsNjYuNDFsLTUuNzIsMTguNEwzOS40LDgwLjE3YTMxLjYxLDMxLjYxLDAsMSwwLDEzLTYwLjQzWiIvPjxwYXRoIGNsYXNzPSJjbHMtMyIgZD0iTTc3LjQ1LDMyLjEyYTMxLjYsMzEuNiwwLDAsMS0zOC4wNSw0OEwxOC44Niw4NC44MmwyMC45MS0yLjQ3QTMxLjYsMzEuNiwwLDAsMCw3Ny40NSwzMi4xMloiLz48cGF0aCBjbGFzcz0iY2xzLTQiIGQ9Ik03MS42MywyNi4yOUEzMS42LDMxLjYsMCwwLDEsMzguOCw3OEwxOC44Niw4NC44MiwzOS40LDgwLjE3QTMxLjYsMzEuNiwwLDAsMCw3MS42MywyNi4yOVoiLz48cGF0aCBjbGFzcz0iY2xzLTUiIGQ9Ik0yNi40Nyw2Ny4xMWEzMS42MSwzMS42MSwwLDAsMSw1MS0zNUEzMS42MSwzMS42MSwwLDAsMCwyNC41OCw2Ni40MWwtNS43MiwxOC40WiIvPjxwYXRoIGNsYXNzPSJjbHMtNiIgZD0iTTI0LjU4LDY2LjQxQTMxLjYxLDMxLjYxLDAsMCwxLDcxLjYzLDI2LjI5YTMxLjYxLDMxLjYxLDAsMCwwLTQ5LDM5LjYzbC0zLjc2LDE4LjlaIi8+PC9nPjwvZz48L3N2Zz4="/></a><!----> <!--[0--><a href="https://colab.research.google.com/github/huggingface/notebooks/blob/master/course/en/chapter8/section5.ipynb" target="_blank"><img alt="Open In Colab" class="!m-0" src="https://colab.research.google.com/assets/colab-badge.svg"/></a><!--]--> <!--[0--><a href="https://studiolab.sagemaker.aws/import/github/huggingface/notebooks/blob/master/course/en/chapter8/section5.ipynb" target="_blank"><img alt="Open In Studio Lab" class="!m-0" src="https://studiolab.sagemaker.aws/studiolab.svg"/></a><!--]--></div><!----> <p>وقتی با چیزی روبه‌رو می‌شوید که در یکی از کتابخانه‌های هاگینگ‌فیس درست به نظر نمی‌رسد، حتماً به ما اطلاع دهید تا بتوانیم آن را اصلاح کنیم (همین موضوع درباره‌ی هر کتابخانه‌ی متن‌باز دیگری هم صدق می‌کند). اگر کاملاً مطمئن نیستید باگ در کد شماست یا در یکی از کتابخانه‌های ما، نخستین جایی که باید بررسی کنید <a href="https://discuss.huggingface.co/" rel="nofollow">انجمن‌ها</a> هستند. جامعه به شما کمک می‌کند موضوع را مشخص کنید و تیم هاگینگ‌فیس نیز گفت‌وگوهای آنجا را از نزدیک دنبال می‌کند.</p> <iframe class="w-full xl:w-4/6 h-80" src="https://www.youtube-nocookie.com/embed/_PAli-V4wj0" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen=""></iframe><!----> <p>وقتی مطمئن هستید که یک باگ در دست دارید، اولین قدم ساختن یک نمونه حداقل قابل تکرار است.</p> <!--[1--><h2 class="relative group"><a id="creating-a-minimal-reproducible-example" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#creating-a-minimal-reproducible-example"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span>ایجاد یک مثال حداقل قابل تکرار</span></h2><!--]--><!----> <p>مهم است قطعه‌کدی را که باگ را ایجاد می‌کند جدا کنید، چون هیچ‌کس در تیم هاگینگ‌فیس (هنوز) جادوگر نیست و نمی‌تواند چیزی را که نمی‌بیند اصلاح کند. یک مثال حداقلیِ قابل‌بازتولید، همان‌طور که از نامش پیداست، باید قابل‌بازتولید باشد. این یعنی نباید به فایل یا داده‌ی خارجی‌ای که ممکن است در اختیار داشته باشید وابسته باشد. داده‌های مورد استفاده را با مقادیر ساختگی شبیه مقادیر واقعی جایگزین کنید؛ مقادیری که همچنان همان خطا را ایجاد می‌کنند.</p> <blockquote class="tip"><p>🚨 بسیاری از issueهای مخزن 🤗 ترنسفورمرها حل‌نشده باقی مانده‌اند، چون داده‌های لازم برای بازتولید آن‌ها در دسترس نیست.</p></blockquote> <p>وقتی چیزی مستقل و کامل دارید، می‌توانید آن را به خطوط کد کمتری کاهش دهید و چیزی بسازید که آن را <em>مثال حداقلیِ قابل‌بازتولید</em> می‌نامیم. این کار کمی تلاش بیشتر می‌خواهد، اما اگر بازتولیدکننده‌ی کوتاه و خوبی برای باگ ارائه دهید، تقریباً حتماً کمک و اصلاحیه دریافت خواهید کرد.</p> <p>اگر به‌اندازه‌ی کافی راحت هستید، کد منبعی را که باگ در آن رخ می‌دهد بررسی کنید. شاید راه‌حل مشکل را پیدا کنید (و حتی بتوانید برای اصلاح آن یک pull request پیشنهاد دهید)، اما در حالت کلی این کار به نگه‌دارندگان کمک می‌کند هنگام خواندن گزارش شما منشأ مشکل را بهتر بفهمند.</p> <!--[1--><h2 class="relative group"><a id="filling-out-the-issue-template" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#filling-out-the-issue-template"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span>پر کردن الگوی مشکل</span></h2><!--]--><!----> <p>هنگام ثبت issue متوجه می‌شوید الگویی برای تکمیل وجود دارد. در اینجا الگوی <a href="https://github.com/huggingface/transformers/issues/new/choose" rel="nofollow">issueهای 🤗 ترنسفورمرها</a> را دنبال می‌کنیم، اما اگر در مخزن دیگری issue گزارش دهید، همان نوع اطلاعات لازم خواهد بود. الگو را خالی نگذارید: وقت‌گذاشتن برای تکمیل آن، شانس دریافت پاسخ و حل مشکل را به بیشترین مقدار می‌رساند.</p> <p>در حالت کلی هنگام ثبت issue همیشه مؤدب باشید. این یک پروژه‌ی متن‌باز است؛ بنابراین از نرم‌افزار رایگان استفاده می‌کنید و هیچ‌کس موظف نیست به شما کمک کند. می‌توانید نقدی را که به‌نظر خودتان موجه است در issue بنویسید، اما نگه‌دارندگان ممکن است آن را بد برداشت کنند و برای کمک عجله‌ای نداشته باشند. حتماً <a href="https://github.com/huggingface/transformers/blob/master/CODE_OF_CONDUCT.md" rel="nofollow">آیین‌نامه‌ی رفتاری</a> پروژه را بخوانید.</p> <!--[2--><h3 class="relative group"><a id="including-your-environment-information" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#including-your-environment-information"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span>از جمله اطلاعات محیطی شما</span></h3><!--]--><!----> <p>🤗 ترنسفورمرها ابزاری برای دریافت همه‌ی اطلاعات مورد نیاز درباره‌ی محیط شما فراهم می‌کنند. کافی است دستور زیر را در ترمینال وارد کنید:</p> <div class="code-block relative "><div class="absolute top-2.5 right-4"><button class="inline-flex items-center relative text-sm focus:text-green-500 cursor-pointer focus:outline-none transition duration-200 ease-in-out opacity-0 mx-0.5 text-gray-600 " title="code excerpt" type="button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg><!----> <div class=" absolute pointer-events-none transition-opacity bg-black text-white py-1 px-2 leading-tight rounded font-normal shadow left-1/2 top-full transform -translate-x-1/2 translate-y-2 opacity-0 "><div class="absolute bottom-full left-1/2 transform -translate-x-1/2 w-0 h-0 border-black border-4 border-t-0" style="border-left-color: transparent; border-right-color: transparent;"></div> Copied</div><!----></button><!----></div> <pre class=" "><!---->transformers-<span class="hljs-keyword">cli</span> env<!----></pre></div><!----> <p>و شما باید چیزی شبیه به این دریافت کنید:</p> <div class="code-block relative "><div class="absolute top-2.5 right-4"><button class="inline-flex items-center relative text-sm focus:text-green-500 cursor-pointer focus:outline-none transition duration-200 ease-in-out opacity-0 mx-0.5 text-gray-600 " title="code excerpt" type="button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg><!----> <div class=" absolute pointer-events-none transition-opacity bg-black text-white py-1 px-2 leading-tight rounded font-normal shadow left-1/2 top-full transform -translate-x-1/2 translate-y-2 opacity-0 "><div class="absolute bottom-full left-1/2 transform -translate-x-1/2 w-0 h-0 border-black border-4 border-t-0" style="border-left-color: transparent; border-right-color: transparent;"></div> Copied</div><!----></button><!----></div> <pre class="language-out "><!----><span class="hljs-keyword">Copy</span>-<span class="hljs-keyword">and</span>-paste the <span class="hljs-type">text</span> below <span class="hljs-keyword">in</span> your GitHub issue <span class="hljs-keyword">and</span> FILL <span class="hljs-keyword">OUT</span> the two last points.
- `transformers` <span class="hljs-keyword">version</span>: <span class="hljs-number">4.12</span><span class="hljs-number">.0</span>.dev0
- Platform: Linux<span class="hljs-number">-5.10</span><span class="hljs-number">.61</span><span class="hljs-number">-1</span>-MANJARO-x86_64-<span class="hljs-keyword">with</span>-arch-Manjaro-Linux
- Python <span class="hljs-keyword">version</span>: <span class="hljs-number">3.7</span><span class="hljs-number">.9</span>
- PyTorch version (GPU?): <span class="hljs-number">1.8</span><span class="hljs-number">.1</span>+cu111 (<span class="hljs-keyword">True</span>)
- Tensorflow version (GPU?): <span class="hljs-number">2.5</span><span class="hljs-number">.0</span> (<span class="hljs-keyword">True</span>)
- Flax version (CPU?/GPU?/TPU?): <span class="hljs-number">0.3</span><span class="hljs-number">.4</span> (cpu)
- Jax <span class="hljs-keyword">version</span>: <span class="hljs-number">0.2</span><span class="hljs-number">.13</span>
- JaxLib <span class="hljs-keyword">version</span>: <span class="hljs-number">0.1</span><span class="hljs-number">.65</span>
- <span class="hljs-keyword">Using</span> GPU <span class="hljs-keyword">in</span> script?: &lt;fill <span class="hljs-keyword">in</span>&gt;
- <span class="hljs-keyword">Using</span> distributed <span class="hljs-keyword">or</span> parallel <span class="hljs-keyword">set</span>-up <span class="hljs-keyword">in</span> script?: &lt;fill <span class="hljs-keyword">in</span>&gt;<!----></pre></div><!----> <p>همچنین می توانید یک <code>!</code> را در ابتدای دستور <code>transformers-cli env</code> اضافه کنید تا آن را از یک سلول نوت بوک اجرا کنید و سپس نتیجه را در ابتدای شماره خود کپی و جایگذاری کنید.</p> <!--[2--><h3 class="relative group"><a id="tagging-people" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#tagging-people"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span>برچسب زدن افراد</span></h3><!--]--><!----> <p>تگ کردن افراد با تایپ <code>@</code> و به دنبال آن شناسهٔ گیت‌هاب آن‌ها، به آن‌ها اعلانی ارسال می‌کند تا مشکل شما را ببینند و ممکن است سریع‌تر پاسخ دهند. از این روش با احتیاط استفاده کنید، زیرا افرادی که تگ می‌کنید ممکن است از مطلع شدن از چیزی که هیچ لینک مستقیمی به آن ندارند، خوششان نیاید. اگر فایل‌های منبع مربوط به اشکال خود را بررسی کرده‌اید، باید آخرین فردی را که در خطی که فکر می‌کنید تغییر ایجاد کرده است و مسئول مشکل شماست تگ کنید (می‌توانید این اطلاعات را با مراجعه به همان خط در GitHub، انتخاب آن و سپس کلیک روی «View git blame» پیدا کنید).</p> <p>در غیر این صورت، قالب پیشنهادهایی برای تگ کردن افراد ارائه می‌دهد. به طور کلی، هرگز بیش از سه نفر را تگ نکنید!</p> <!--[2--><h3 class="relative group"><a id="including-a-reproducible-example" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#including-a-reproducible-example"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span>از جمله یک مثال قابل تکرار</span></h3><!--]--><!----> <p>اگر موفق شده‌اید مثالی مستقل بسازید که باگ را ایجاد می‌کند، اکنون زمان افزودن آن است! خطی شامل سه بک‌تیک و سپس <code>python</code> بنویسید، مانند زیر:</p> <div class="code-block relative "><div class="absolute top-2.5 right-4"><button class="inline-flex items-center relative text-sm focus:text-green-500 cursor-pointer focus:outline-none transition duration-200 ease-in-out opacity-0 mx-0.5 text-gray-600 " title="code excerpt" type="button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg><!----> <div class=" absolute pointer-events-none transition-opacity bg-black text-white py-1 px-2 leading-tight rounded font-normal shadow left-1/2 top-full transform -translate-x-1/2 translate-y-2 opacity-0 "><div class="absolute bottom-full left-1/2 transform -translate-x-1/2 w-0 h-0 border-black border-4 border-t-0" style="border-left-color: transparent; border-right-color: transparent;"></div> Copied</div><!----></button><!----></div> <pre class=" "><!---->```python<!----></pre></div><!----> <p>سپس مثال حداقلیِ قابل‌بازتولید خود را درج کنید و در خطی جدید سه بک‌تیک دیگر بنویسید. این کار باعث می‌شود کد شما به‌درستی قالب‌بندی شود.</p> <p>اگر نتوانستید یک مثال قابل‌بازتولید ایجاد کنید، مراحل رسیدن به مشکل را به‌روشنی توضیح دهید. اگر می‌توانید، پیوندی به یک نوت‌بوک Google Colab که خطا در آن رخ داده است اضافه کنید. هرچه اطلاعات بیشتری ارائه دهید، نگه‌دارندگان بهتر می‌توانند به شما پاسخ دهند.</p> <p>در همهٔ موارد، باید متن کامل پیام خطایی را که دریافت می‌کنید کپی و جای‌گذاری کنید. اگر در Colab کار می‌کنید، به یاد داشته باشید که ممکن است برخی فریم‌ها در ردپای پشته به‌طور خودکار جمع شوند؛ بنابراین پیش از کپی کردن، آن‌ها را باز کنید. مانند نمونهٔ کد، پیام خطا را بین دو خط شامل سه بک‌تیک قرار دهید تا به‌درستی قالب‌بندی شود.</p> <!--[2--><h3 class="relative group"><a id="describing-the-expected-behavior" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#describing-the-expected-behavior"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span>شرح رفتار مورد انتظار</span></h3><!--]--><!----> <p>در چند خط توضیح دهید انتظار داشتید چه چیزی دریافت کنید تا نگه‌دارندگان درک کاملی از مشکل پیدا کنند. این بخش معمولاً کاملاً روشن است و باید در یک جمله بگنجد، اما در برخی موارد ممکن است توضیحات زیادی داشته باشید.</p> <!--[1--><h2 class="relative group"><a id="and-then-what" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#and-then-what"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span>بعد از آن چه؟</span></h2><!--]--><!----> <p>پس از ثبت issue، سریع بررسی کنید که همه‌چیز درست به نظر می‌رسد. اگر اشتباهی کرده‌اید، می‌توانید issue را ویرایش کنید یا اگر متوجه شدید مشکل با چیزی که ابتدا تصور می‌کردید متفاوت است، حتی عنوان آن را تغییر دهید.</p> <p>اگر پاسخی دریافت نمی‌کنید، پیام دادن مکرر به افراد فایده‌ای ندارد. اگر پس از چند روز کسی به شما کمک نکرد، احتمالاً هیچ‌کس نتوانسته است مشکل شما را درک کند. در بازگشت به مثال قابل‌بازتولید تردید نکنید: آیا می‌توانید آن را کوتاه‌تر و دقیق‌تر کنید؟ اگر پس از یک هفته پاسخی نگرفتید، می‌توانید پیامی مؤدبانه برای درخواست کمک بگذارید؛ به‌ویژه اگر issue خود را ویرایش کرده‌اید تا اطلاعات بیشتری دربارهٔ مشکل در آن بگنجانید.</p></div> <a class="!text-gray-400 !no-underline text-sm flex items-center not-prose mt-4" href="https://github.com/huggingface/course/blob/main/chapters/fa/chapter8/5.mdx" target="_blank"><svg class="mr-1" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M31,16l-7,7l-1.41-1.41L28.17,16l-5.58-5.59L24,9l7,7z"></path><path d="M1,16l7-7l1.41,1.41L3.83,16l5.58,5.59L8,23l-7-7z"></path><path d="M12.419,25.484L17.639,6.552l1.932,0.518L14.351,26.002z"></path></svg><!----> <span><span class="underline">Update</span> on GitHub</span></a><!----> <p></p><!--]--><!----><!--]--><!--]--><!--]--> <!--[-1--><!--]--><!--]-->
<script>
{
__sveltekit_pfm8ny = {
base: "/docs/course/pr_1364/fa",
assets: "/docs/course/pr_1364/fa"
};
const element = document.currentScript.parentElement;
Promise.all([
import("/docs/course/pr_1364/fa/_app/immutable/entry/start.CqZXmSrv.js"),
import("/docs/course/pr_1364/fa/_app/immutable/entry/app.B4UvgX5H.js")
]).then(([kit, app]) => {
kit.start(app, element, {
node_ids: [0, 92],
data: [null,null],
form: null,
error: null
});
});
}
</script>

Xet Storage Details

Size:
34.1 kB
·
Xet hash:
6c9dd0c6ee82d1b01ffeea671517df20ab3c211508d88dc808628ed3f6b4083e

Xet efficiently stores files, intelligently splitting them into unique chunks and accelerating uploads and downloads. More info.