Buckets:
| <meta charset="utf-8" /><meta name="hf:doc:metadata" content="{"title":"درخواست کمک در انجمنها","local":"asking-for-help-on-the-forums","sections":[{"title":"نوشتن یک پست خوب در انجمن","local":"writing-a-good-forum-post","sections":[{"title":"انتخاب عنوانی توصیفی","local":"choosing-a-descriptive-title","sections":[],"depth":3},{"title":"قالببندی قطعه کدهای شما","local":"formatting-your-code-snippets","sections":[],"depth":3},{"title":"گنجاندن traceback کامل","local":"including-the-full-traceback","sections":[],"depth":3},{"title":"ارائهی یک مثال قابلبازتولید","local":"providing-a-reproducible-example","sections":[],"depth":3}],"depth":2}],"depth":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/89.Dc4P99yP.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"> | |
| <!--181r8xm--><meta name="hf:doc:metadata" content="{"title":"درخواست کمک در انجمنها","local":"asking-for-help-on-the-forums","sections":[{"title":"نوشتن یک پست خوب در انجمن","local":"writing-a-good-forum-post","sections":[{"title":"انتخاب عنوانی توصیفی","local":"choosing-a-descriptive-title","sections":[],"depth":3},{"title":"قالببندی قطعه کدهای شما","local":"formatting-your-code-snippets","sections":[],"depth":3},{"title":"گنجاندن traceback کامل","local":"including-the-full-traceback","sections":[],"depth":3},{"title":"ارائهی یک مثال قابلبازتولید","local":"providing-a-reproducible-example","sections":[],"depth":3}],"depth":2}],"depth":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="asking-for-help-on-the-forums" 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="#asking-for-help-on-the-forums"><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></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/section3.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/section3.ipynb" target="_blank"><img alt="Open In Studio Lab" class="!m-0" src="https://studiolab.sagemaker.aws/studiolab.svg"/></a><!--]--></div><!----> <iframe class="w-full xl:w-4/6 h-80" src="https://www.youtube-nocookie.com/embed/S2EEG3JIt2A" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen=""></iframe><!----> <p><a href="https://discuss.huggingface.co" rel="nofollow">انجمنهای هاگینگفیس</a> مکان بسیار خوبی برای دریافت کمک از تیم متنباز و جامعهی گستردهتر هاگینگفیس هستند. صفحهی اصلی انجمن در یک روز معمولی چیزی شبیه تصویر زیر است:</p> <div class="flex justify-center"><img src="https://huggingface.co/datasets/huggingface-course/documentation-images/resolve/main/en/chapter8/forums.png" alt="The Hugging Face forums." width="100%"/></div> <p>در سمت چپ میتوانید دستهبندیهایی را ببینید که موضوعهای مختلف در آنها گروهبندی شدهاند و سمت راست جدیدترین موضوعها را نشان میدهد. موضوع پستی است که عنوان، دستهبندی و توضیح دارد؛ چیزی بسیار شبیه issueهای گیتهاب که هنگام ساخت دیتاسِت خودمان در <a href="/course/chapter5">فصل ۵</a> دیدیم. همانطور که از نامش پیداست، دستهبندی <a href="https://discuss.huggingface.co/c/beginners/5" rel="nofollow">مبتدیان</a> عمدتاً برای افرادی است که تازه کار با کتابخانهها و اکوسیستم هاگینگفیس را شروع کردهاند. هر پرسشی دربارهی هر یک از کتابخانهها در آنجا پذیرفته است؛ چه برای اشکالزدایی کد و چه برای درخواست راهنمایی دربارهی انجام کاری. (البته اگر پرسشتان به یک کتابخانهی خاص مربوط است، بهتر است به دستهبندی همان کتابخانه در انجمن بروید.)</p> <p>بهطور مشابه، دستهبندیهای <a href="https://discuss.huggingface.co/c/intermediate/6" rel="nofollow">متوسط</a> و <a href="https://discuss.huggingface.co/c/research/7" rel="nofollow">پژوهش</a> برای پرسشهای پیشرفتهتر هستند؛ مثلاً دربارهی کتابخانهها یا پژوهش جدید و جالبی در NLP که میخواهید دربارهاش گفتوگو کنید.</p> <p>و طبیعتاً، باید به دستهبندی <a href="https://discuss.huggingface.co/c/course/20" rel="nofollow">دوره</a> هم اشاره کنیم، جایی که میتوانید هر سوالی که مربوط به دوره هاگینگفِیس دارید را بپرسید!</p> <p>پس از انتخاب دستهبندی، آمادهاید نخستین موضوع خود را بنویسید. در انجمن <a href="https://discuss.huggingface.co/t/how-to-request-support/3128" rel="nofollow">راهنماهایی</a> برای این کار وجود دارد و در این بخش چند قابلیت سازندهی یک موضوع خوب را بررسی میکنیم.</p> <!--[1--><h2 class="relative group"><a id="writing-a-good-forum-post" 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="#writing-a-good-forum-post"><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>برای مثال، فرض کنید میخواهیم از مقالههای ویکیپدیا embedding بسازیم تا یک موتور جستوجوی سفارشی ایجاد کنیم. طبق معمول، توکنساز و مدل را به شکل زیر بارگذاری میکنیم:</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-python "><!----><span class="hljs-keyword">from</span> transformers <span class="hljs-keyword">import</span> AutoTokenizer, AutoModel | |
| model_checkpoint = <span class="hljs-string">"distilbert-base-uncased"</span> | |
| tokenizer = AutoTokenizer.from_pretrained(model_checkpoint) | |
| model = AutoModel.from_pretrained(model_checkpoint)<!----></pre></div><!----> <p>حالا فرض کنید میخواهیم یک بخش کامل از <a href="https://en.wikipedia.org/wiki/Transformers" rel="nofollow">مقالهی ویکیپدیا</a> دربارهی ترنسفورمرها را embedding کنیم (منظور مجموعهی فیلمهاست، نه کتابخانه!):</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-python "><!---->text = <span class="hljs-string">""" | |
| Generation One is a retroactive term for the Transformers characters that | |
| appeared between 1984 and 1993. The Transformers began with the 1980s Japanese | |
| toy lines Micro Change and Diaclone. They presented robots able to transform | |
| into everyday vehicles, electronic items or weapons. Hasbro bought the Micro | |
| Change and Diaclone toys, and partnered with Takara. Marvel Comics was hired by | |
| Hasbro to create the backstory; editor-in-chief Jim Shooter wrote an overall | |
| story, and gave the task of creating the characthers to writer Dennis O'Neil. | |
| Unhappy with O'Neil's work (although O'Neil created the name "Optimus Prime"), | |
| Shooter chose Bob Budiansky to create the characters. | |
| The Transformers mecha were largely designed by Shōji Kawamori, the creator of | |
| the Japanese mecha anime franchise Macross (which was adapted into the Robotech | |
| franchise in North America). Kawamori came up with the idea of transforming | |
| mechs while working on the Diaclone and Macross franchises in the early 1980s | |
| (such as the VF-1 Valkyrie in Macross and Robotech), with his Diaclone mechs | |
| later providing the basis for Transformers. | |
| The primary concept of Generation One is that the heroic Optimus Prime, the | |
| villainous Megatron, and their finest soldiers crash land on pre-historic Earth | |
| in the Ark and the Nemesis before awakening in 1985, Cybertron hurtling through | |
| the Neutral zone as an effect of the war. The Marvel comic was originally part | |
| of the main Marvel Universe, with appearances from Spider-Man and Nick Fury, | |
| plus some cameos, as well as a visit to the Savage Land. | |
| The Transformers TV series began around the same time. Produced by Sunbow | |
| Productions and Marvel Productions, later Hasbro Productions, from the start it | |
| contradicted Budiansky's backstories. The TV series shows the Autobots looking | |
| for new energy sources, and crash landing as the Decepticons attack. Marvel | |
| interpreted the Autobots as destroying a rogue asteroid approaching Cybertron. | |
| Shockwave is loyal to Megatron in the TV series, keeping Cybertron in a | |
| stalemate during his absence, but in the comic book he attempts to take command | |
| of the Decepticons. The TV series would also differ wildly from the origins | |
| Budiansky had created for the Dinobots, the Decepticon turned Autobot Jetfire | |
| (known as Skyfire on TV), the Constructicons (who combine to form | |
| Devastator),[19][20] and Omega Supreme. The Marvel comic establishes early on | |
| that Prime wields the Creation Matrix, which gives life to machines. In the | |
| second season, the two-part episode The Key to Vector Sigma introduced the | |
| ancient Vector Sigma computer, which served the same original purpose as the | |
| Creation Matrix (giving life to Transformers), and its guardian Alpha Trion. | |
| """</span> | |
| inputs = tokenizer(text, return_tensors=<span class="hljs-string">"pt"</span>) | |
| logits = model(**inputs).logits<!----></pre></div><!----> <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-python "><!---->IndexError: index out of <span class="hljs-built_in">range</span> <span class="hljs-keyword">in</span> <span class="hljs-variable language_">self</span><!----></pre></div><!----> <p>ای وای، به مشکل خوردیم—پیام خطا بسیار رمزآلودتر از خطاهایی است که در <a href="/course/chapter8/section2">بخش ۲</a> دیدیم! از traceback کامل سر درنمیآوریم، پس تصمیم میگیریم برای کمک به انجمنهای هاگینگفیس مراجعه کنیم. چگونه باید موضوع را مطرح کنیم؟</p> <p>برای شروع، باید روی دکمهی «New Topic» در گوشهی بالا سمت راست کلیک کنیم (توجه کنید که برای ایجاد موضوع باید وارد حساب شده باشیم):</p> <div class="flex justify-center"><img src="https://huggingface.co/datasets/huggingface-course/documentation-images/resolve/main/en/chapter8/forums-new-topic.png" alt="Creating a new forum topic." width="100%"/></div> <p>با این کار، رابطی برای نوشتن باز میشود که در آن میتوانیم عنوان موضوع را وارد کنیم، دستهبندی را انتخاب کنیم و محتوا را بنویسیم:</p> <div class="flex justify-center"><img src="https://huggingface.co/datasets/huggingface-course/documentation-images/resolve/main/en/chapter8/forum-topic01.png" alt="The interface for creating a forum topic." width="100%"/></div> <p>از آنجا که به نظر میرسد خطا منحصراً به 🤗 ترنسفورمرها مربوط است، همین گزینه را برای دستهبندی انتخاب میکنیم. نخستین تلاشمان برای توضیح مشکل ممکن است چیزی شبیه این باشد:</p> <div class="flex justify-center"><img src="https://huggingface.co/datasets/huggingface-course/documentation-images/resolve/main/en/chapter8/forum-topic02.png" alt="Drafting the content for a new forum topic." width="100%"/></div> <p>اگرچه این تاپیک حاوی پیام خطایی است که در مورد آن به کمک نیاز داریم، اما چند مشکل در نحوه نگارش آن وجود دارد:</p> <p>۱. عنوان خیلی توصیفی نیست، بنابراین هر کسی که در انجمن جستجو کند، بدون خواندن متن اصلی نمیتواند تشخیص دهد که موضوع در مورد چیست. | |
| ۲. متن اصلی اطلاعات کافی دربارهی <em>محل</em> وقوع خطا و <em>نحوهی بازتولید</em> آن ارائه نمیکند. | |
| ۳. موضوع، چند نفر را مستقیماً و با لحنی تاحدی مطالبهگر تگ میکند.</p> <p>موضوعاتی مثل این بعید است که به سرعت به پاسخ برسند (اگر اصلاً پاسخی دریافت کنند)، بنابراین بیایید ببینیم چگونه میتوانیم آن را بهبود بخشیم. با اولین مورد انتخاب یک عنوان خوب شروع خواهیم کرد.</p> <!--[2--><h3 class="relative group"><a id="choosing-a-descriptive-title" 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="#choosing-a-descriptive-title"><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>model(**inputs)</code> را فراخوانی میکنیم. برای انتقال این موضوع، یکی از عنوانهای ممکن چنین است:</p> <blockquote><p>منبع خطای IndexError در پاس رو به جلوی AutoModel چیست؟</p></blockquote> <p>این عنوان به خواننده میگوید <em>فکر میکنید خطا از کجا میآید</em> و اگر قبلاً با <code>IndexError</code> روبهرو شده باشد، احتمالاً میداند چگونه آن را اشکالزدایی کند. البته عنوان میتواند هر چیزی باشد و گزینههای دیگری مانند این هم مناسباند:</p> <blockquote><p>چرا مدل من یک IndexError تولید میکند؟</p></blockquote> <p>حالا که عنوانی توصیفی داریم، بیایید به بهبود متن اصلی بپردازیم.</p> <!--[2--><h3 class="relative group"><a id="formatting-your-code-snippets" 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="#formatting-your-code-snippets"><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>خواندن کد منبع در یک IDE بهاندازهی کافی دشوار است، اما وقتی کد بهصورت متن ساده کپی و جایگذاری شود دشوارتر هم میشود! خوشبختانه انجمنهای هاگینگفیس از Markdown پشتیبانی میکنند؛ بنابراین همیشه بلوکهای کد را با سه بکتیک (```) دربر بگیرید تا خوانایی بیشتری داشته باشند. بیایید پیام خطا را مرتب کنیم و همزمان متن اصلی را کمی مؤدبانهتر بنویسیم:</p> <div class="flex justify-center"><img src="https://huggingface.co/datasets/huggingface-course/documentation-images/resolve/main/en/chapter8/forum-topic03.png" alt="Our revised forum topic, with proper code formatting." width="100%"/></div> <p>همانطور که در تصویر میبینید، دربرگرفتن بلوکهای کد با بکتیک، متن خام را به کدی قالببندیشده و رنگی تبدیل میکند! همچنین توجه کنید که میتوان از بکتیکهای تکی برای قالببندی متغیرهای درونخطی، مانند <code>distilbert-base-uncased</code>، استفاده کرد. این موضوع حالا بسیار بهتر به نظر میرسد و شاید با کمی شانس کسی در جامعه بتواند حدس بزند خطا دربارهی چیست. اما بهجای تکیه بر شانس، با افزودن traceback در تمام جزئیاتش کار را برای دیگران آسانتر کنیم!</p> <!--[2--><h3 class="relative group"><a id="including-the-full-traceback" 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-the-full-traceback"><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>گنجاندن traceback کامل</span></h3><!--]--><!----> <p>از آنجا که آخرین خط traceback اغلب برای اشکالزدایی کد خودتان کافی است، ممکن است وسوسه شوید برای «صرفهجویی در فضا» فقط همان را در موضوع قرار دهید. با اینکه نیت خوبی دارد، این کار اشکالزدایی مشکل را برای دیگران <em>دشوارتر</em> میکند، چون اطلاعات بخشهای بالاتر traceback نیز میتواند بسیار مفید باشد. بنابراین، بهتر است <em>کل</em> traceback را کپی و جایگذاری کنید و مطمئن شوید که بهخوبی قالببندی شده است. از آنجا که tracebackها ممکن است طولانی باشند، بعضی افراد ترجیح میدهند آنها را بعد از توضیح کد منبع نشان دهند. بیایید همین کار را انجام دهیم. اکنون موضوع انجمن ما شبیه زیر است:</p> <div class="flex justify-center"><img src="https://huggingface.co/datasets/huggingface-course/documentation-images/resolve/main/en/chapter8/forum-topic04.png" alt="Our example forum topic, with the complete traceback." width="100%"/></div> <p>این بسیار آموزندهتر است، و یک خواننده دقیق ممکن است بتواند به این نکته اشاره کند که به نظر میرسد مشکل به دلیل ارسال یک ورودی طولانی به دلیل این خط در traceback است:</p> <blockquote><p>طول توالی شاخصهای توکن از حداکثر طول توالی مشخص شده برای این مدل (583 > 512) بیشتر است.</p></blockquote> <p>بااینحال، میتوانیم کار را برای آنها آسانتر کنیم و کدی را که خطا را ایجاد کرده است ارائه دهیم. بیایید همین حالا این کار را انجام دهیم.</p> <!--[2--><h3 class="relative group"><a id="providing-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="#providing-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>اگر تا به حال تلاش کرده باشید کد شخص دیگری را اشکالزدایی کنید، احتمالاً ابتدا سعی کردهاید مشکلی را که گزارش کرده بازسازی کنید تا بتوانید traceback را مرحلهبهمرحله دنبال کرده و خطا را مشخص کنید. دریافت یا ارائهی کمک در انجمنها نیز همینطور است؛ بنابراین اگر مثال کوچکی ارائه کنید که خطا را بازتولید کند، بسیار کمککننده خواهد بود. نیمی از مواقع، همین تمرین به شما کمک میکند بفهمید چه چیزی اشتباه است. در هر صورت، بخش گمشدهی مثال ما نشاندادن <em>ورودیهایی</em> است که به مدل دادهایم. با این کار، مثال کاملشدهای مانند زیر خواهیم داشت:</p> <div class="flex justify-center"><img src="https://huggingface.co/datasets/huggingface-course/documentation-images/resolve/main/en/chapter8/forum-topic05.png" alt="The final version of our forum topic." width="100%"/></div> <p>این موضوع اکنون اطلاعات زیادی دارد و به شکلی نوشته شده است که احتمال جلب توجه جامعه و دریافت پاسخی مفید را بسیار بیشتر میکند. با این دستورالعملهای پایه، حالا میتوانید برای یافتن پاسخ پرسشهای خود دربارهی 🤗 ترنسفورمرها موضوعهای خوبی ایجاد کنید!</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/3.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, 89], | |
| data: [null,null], | |
| form: null, | |
| error: null | |
| }); | |
| }); | |
| } | |
| </script> | |
Xet Storage Details
- Size:
- 37 kB
- Xet hash:
- cca4692e6612a4b776930627547aca90d8649b47c747293dc0c55e2bdb3bab8a
·
Xet efficiently stores files, intelligently splitting them into unique chunks and accelerating uploads and downloads. More info.