https://deploy-preview-968--hugo-hextra.netlify.app/fa/blog/Recent content in وبلاگ on هگزتراHugo -- gohugo.iofahttps://deploy-preview-968--hugo-hextra.netlify.app/fa/blog/v0.12/Fri, 20 Feb 2026 00:00:00 +0000https://deploy-preview-968--hugo-hextra.netlify.app/fa/blog/v0.12/ <p>Hextra v0.12.0 مجموعه‌ای غنی از ویژگی‌های جدید شامل منوی زمینه صفحه، زوم تصویر، تب‌های بازطراحی‌شده و موارد بیشتر، به همراه بهبودهای جامع دسترس‌پذیری WCAG 2.2 AA و رفع اشکالات متعدد ارائه می‌دهد.</p> <h2>راهنمای ارتقا<span class="hx:absolute hx:-mt-20" id="راهنمای-ارتقا"></span> <a href="#%d8%b1%d8%a7%d9%87%d9%86%d9%85%d8%a7%db%8c-%d8%a7%d8%b1%d8%aa%d9%82%d8%a7" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h2><p>برای بیشتر سایت‌ها تغییر شکست‌آمیزی وجود ندارد. با استفاده از <a href="https://gohugo.io/hugo-modules/use-modules/"target="_blank" rel="noopener">Hugo Modules<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> به‌روزرسانی کنید:</p> <div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">hugo mod get -u github.com/imfing/hextra</span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-0"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <h2>نکات برجسته<span class="hx:absolute hx:-mt-20" id="نکات-برجسته"></span> <a href="#%d9%86%da%a9%d8%a7%d8%aa-%d8%a8%d8%b1%d8%ac%d8%b3%d8%aa%d9%87" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h2><ul> <li>منوی زمینه صفحه برای کپی/مشاهده سورس Markdown</li> <li>بازطراحی شورت‌کد تب‌ها با نام‌گذاری هر تب و پشتیبانی از آیکون</li> <li>زوم با کلیک برای تصاویر Markdown</li> <li>پشتیبانی از تحلیل‌گر GoatCounter</li> <li>گزینه مخفی‌کردن نوار کناری اصلی در دسکتاپ</li> <li>نمایش آخرین نویسنده ویرایش‌کننده از طریق GitInfo</li> <li>گزینه غیرفعال‌سازی ناوبری قبلی/بعدی</li> <li>صفحه آرشیو داخلی برای فهرست زمانی نوشته‌های وبلاگ</li> <li>شورت‌کد و چیدمان واژه‌نامه</li> <li>حذف صفحات/بخش‌ها از llms.txt</li> <li>ترتیب و برچسب‌های نوار کناری موبایل هم‌راستا با <code>menu.main</code></li> <li>عرض محتوای پایدار با پشتیبانی از بازنویسی متغیر CSS</li> <li>بهبودهای جامع دسترس‌پذیری WCAG 2.2 AA</li> </ul> <h2>ویژگی‌های جدید<span class="hx:absolute hx:-mt-20" id="ویژگیهای-جدید"></span> <a href="#%d9%88%db%8c%da%98%da%af%db%8c%d9%87%d8%a7%db%8c-%d8%ac%d8%af%db%8c%d8%af" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h2><h3>منوی زمینه صفحه<span class="hx:absolute hx:-mt-20" id="منوی-زمینه-صفحه"></span> <a href="#%d9%85%d9%86%d9%88%db%8c-%d8%b2%d9%85%db%8c%d9%86%d9%87-%d8%b5%d9%81%d8%ad%d9%87" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><p><img src="https://github.com/user-attachments/assets/0b55bee9-6f4d-4e1d-9461-60c40208cb6c" alt="منوی زمینه" data-zoomable loading="lazy" /></p> <p>منوی زمینه صفحه دکمه‌ای کشویی فراهم می‌کند که با آن می‌توانید محتوای صفحه را به‌صورت Markdown کپی کنید یا سورس خام Markdown را مشاهده نمایید. با افزایش کاربرانی که مستندات را به ابزارهای هوش مصنوعی مولّد می‌دهند، دسترسی سریع به Markdown تمیز بسیار مفید است. پیوندهای سفارشی با متغیرهای قالب (<code>{url}</code>، <code>{title}</code>، <code>{markdown_url}</code>) به شما امکان می‌دهند میان‌برهای «از AI بپرس» یا سایر یکپارچه‌سازی‌ها را مستقیماً در منو ایجاد کنید.</p> <p>برای استفاده از قابلیت‌های «مشاهده به‌صورت Markdown» و <code>{markdown_url}</code>، فرمت خروجی Markdown را در پیکربندی سایت فعال کنید:</p> <div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div class="hextra-code-filename not-prose" dir="auto">hugo.yaml</div><div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">outputs</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">page</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="l">html, markdown]</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">section</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="l">html, rss, markdown]</span></span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-8"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <p>سپس منوی زمینه را پیکربندی کنید:</p> <div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div class="hextra-code-filename not-prose" dir="auto">hugo.yaml</div><div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">params</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">page</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">contextMenu</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">enable</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">links</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span>- <span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;Ask AI&#34;</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">url</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;https://example.com?content={markdown_url}&#34;</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">icon</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;sparkles&#34;</span></span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-8"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <h3>بازطراحی تب‌ها و پشتیبانی از آیکون<span class="hx:absolute hx:-mt-20" id="بازطراحی-تبها-و-پشتیبانی-از-آیکون"></span> <a href="#%d8%a8%d8%a7%d8%b2%d8%b7%d8%b1%d8%a7%d8%ad%db%8c-%d8%aa%d8%a8%d9%87%d8%a7-%d9%88-%d9%be%d8%b4%d8%aa%db%8c%d8%a8%d8%a7%d9%86%db%8c-%d8%a7%d8%b2-%d8%a2%db%8c%da%a9%d9%88%d9%86" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><p><a href="https://deploy-preview-968--hugo-hextra.netlify.app/fa/docs/guide/shortcodes/tabs/">شورت‌کد تب‌ها</a> بازطراحی شده است. اکنون می‌توان نام تب‌ها را مستقیماً روی هر شورت‌کد <code>tab</code> تنظیم کرد و پارامتر اختیاری <code>icon</code> یک آیکون قبل از برچسب تب نمایش می‌دهد. نحو قبلی همچنان پشتیبانی می‌شود.</p> <div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-md" data-lang="md"><span class="line"><span class="cl">{{&lt; tabs &gt;}} </span></span><span class="line"><span class="cl"> {{&lt; tab name=&#34;Photos&#34; icon=&#34;photograph&#34; &gt;}}مدیریت و سازماندهی کتابخانه عکس‌های شما.{{&lt; /tab &gt;}} </span></span><span class="line"><span class="cl"> {{&lt; tab name=&#34;Music&#34; icon=&#34;music-note&#34; &gt;}}مرور و پخش آهنگ‌های مورد علاقه شما.{{&lt; /tab &gt;}} </span></span><span class="line"><span class="cl"> {{&lt; tab name=&#34;Videos&#34; icon=&#34;film&#34; &gt;}}تماشا و پخش محتوای ویدیویی.{{&lt; /tab &gt;}} </span></span><span class="line"><span class="cl">{{&lt; /tabs &gt;}}</span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-0"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <p><img src="https://github.com/user-attachments/assets/afa4cb8f-615c-4f01-8ae4-81a64c9ce391" alt="تب‌ها با آیکون" data-zoomable loading="lazy" /></p> <h3>زوم تصویر<span class="hx:absolute hx:-mt-20" id="زوم-تصویر"></span> <a href="#%d8%b2%d9%88%d9%85-%d8%aa%d8%b5%d9%88%db%8c%d8%b1" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><p>با یک گزینه پیکربندی جدید، زوم با کلیک را روی تصاویر Markdown فعال کنید. این قابلیت از <a href="https://github.com/francoischalifour/medium-zoom"target="_blank" rel="noopener">medium-zoom<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> استفاده می‌کند.</p> <div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div class="hextra-code-filename not-prose" dir="auto">hugo.yaml</div><div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">params</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">imageZoom</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">enable</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span></span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-8"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <h3>تحلیل‌گر GoatCounter<span class="hx:absolute hx:-mt-20" id="تحلیلگر-goatcounter"></span> <a href="#%d8%aa%d8%ad%d9%84%db%8c%d9%84%da%af%d8%b1-goatcounter" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><p>پشتیبانی داخلی از تحلیل‌گر <a href="https://www.goatcounter.com/"target="_blank" rel="noopener">GoatCounter<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> در کنار یکپارچه‌سازی‌های موجود Google Analytics، Umami و Matomo.</p> <h3>مخفی‌کردن نوار کناری اصلی<span class="hx:absolute hx:-mt-20" id="مخفیکردن-نوار-کناری-اصلی"></span> <a href="#%d9%85%d8%ae%d9%81%db%8c%da%a9%d8%b1%d8%af%d9%86-%d9%86%d9%88%d8%a7%d8%b1-%da%a9%d9%86%d8%a7%d8%b1%db%8c-%d8%a7%d8%b5%d9%84%db%8c" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><p>یک پارامتر جدید فرانت‌متر امکان مخفی‌کردن نوار کناری اصلی در دسکتاپ را فراهم می‌کند تا صفحات محتوا عرض کامل داشته باشند.</p> <div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div class="hextra-code-filename not-prose" dir="auto">content/my-page.md</div><div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nn">---</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="nt">title</span><span class="p">:</span><span class="w"> </span><span class="l">My Page</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="nt">sidebar</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">hide</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="nn">---</span></span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-8"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <h3>آخرین نویسنده ویرایش‌کننده<span class="hx:absolute hx:-mt-20" id="آخرین-نویسنده-ویرایشکننده"></span> <a href="#%d8%a2%d8%ae%d8%b1%db%8c%d9%86-%d9%86%d9%88%db%8c%d8%b3%d9%86%d8%af%d9%87-%d9%88%db%8c%d8%b1%d8%a7%db%8c%d8%b4%da%a9%d9%86%d9%86%d8%af%d9%87" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><p>با استفاده از GitInfo هوگو، آخرین نویسنده کامیت را در کنار تاریخ «آخرین به‌روزرسانی» نمایش دهید.</p> <div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div class="hextra-code-filename not-prose" dir="auto">hugo.yaml</div><div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">params</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">displayUpdatedAuthor</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span></span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-8"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <p><img src="https://github.com/user-attachments/assets/275b7177-e089-483c-abb6-6d8f16616b9b" alt="آخرین نویسنده ویرایش‌کننده" data-zoomable loading="lazy" /></p> <h3>غیرفعال‌سازی ناوبری قبلی/بعدی<span class="hx:absolute hx:-mt-20" id="غیرفعالسازی-ناوبری-قبلیبعدی"></span> <a href="#%d8%ba%db%8c%d8%b1%d9%81%d8%b9%d8%a7%d9%84%d8%b3%d8%a7%d8%b2%db%8c-%d9%86%d8%a7%d9%88%d8%a8%d8%b1%db%8c-%d9%82%d8%a8%d9%84%db%8c%d8%a8%d8%b9%d8%af%db%8c" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><p>دکمه‌های ناوبری قبلی/بعدی را در سطح سایت غیرفعال کنید:</p> <div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div class="hextra-code-filename not-prose" dir="auto">hugo.yaml</div><div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">params</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">page</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">displayPagination</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span></span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-8"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <h3>حذف از LLMs.txt<span class="hx:absolute hx:-mt-20" id="حذف-از-llmstxt"></span> <a href="#%d8%ad%d8%b0%d9%81-%d8%a7%d8%b2-llmstxt" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><p>با تنظیم <code>llms: false</code> در فرانت‌متر، صفحات یا بخش‌های کامل را از خروجی <code>llms.txt</code> حذف کنید.</p> <div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div class="hextra-code-filename not-prose" dir="auto">content/private-page.md</div><div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nn">---</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="nt">title</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;Private Page&#34;</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="nt">llms</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="nn">---</span></span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-8"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <h3>صفحه آرشیو<span class="hx:absolute hx:-mt-20" id="صفحه-آرشیو"></span> <a href="#%d8%b5%d9%81%d8%ad%d9%87-%d8%a2%d8%b1%d8%b4%db%8c%d9%88" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><p>چیدمان جدید داخلی <code>archives</code> نوشته‌های وبلاگ را در یک خط زمانی گروه‌بندی‌شده بر اساس سال نمایش می‌دهد و برچسب‌ها به‌صورت درون‌خطی پس از عنوان هر نوشته نشان داده می‌شوند.</p> <div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div class="hextra-code-filename not-prose" dir="auto">content/archives/_index.md</div><div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nn">---</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="nt">title</span><span class="p">:</span><span class="w"> </span><span class="l">Archives</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="nt">layout</span><span class="p">:</span><span class="w"> </span><span class="l">archives</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="nn">---</span></span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-8"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <p><img src="https://github.com/user-attachments/assets/262cc0fa-e0af-4a50-8c3d-4465059418b8" alt="صفحه آرشیو" data-zoomable loading="lazy" /></p> <h3>واژه‌نامه<span class="hx:absolute hx:-mt-20" id="واژهنامه"></span> <a href="#%d9%88%d8%a7%da%98%d9%87%d9%86%d8%a7%d9%85%d9%87" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><p>یک <a href="https://deploy-preview-968--hugo-hextra.netlify.app/fa/docs/guide/shortcodes/term/">واژه‌نامه</a> اصطلاحات سراسری سایت با صفحه فهرست اختصاصی و شورت‌کد <code>term</code> برای تعاریف درون‌خطی.</p> <h2>دسترس‌پذیری<span class="hx:absolute hx:-mt-20" id="دسترسپذیری"></span> <a href="#%d8%af%d8%b3%d8%aa%d8%b1%d8%b3%d9%be%d8%b0%db%8c%d8%b1%db%8c" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h2><p>بهبودهای جامع دسترس‌پذیری WCAG 2.2 AA (#924):</p> <ul> <li>پیوند رفتن به محتوا و نقش‌های نشانه‌ای ARIA در تمام صفحات</li> <li>ویژگی‌های ARIA برای تمام ابزارک‌های تعاملی (کلید تغییر تم، تب‌ها، نوار کناری، درخت فایل، منوهای بازشو، جستجو، منوها)</li> <li>ناوبری صفحه‌کلیدی برای تب‌ها و کلید تغییر تم (کلیدهای جهتی، Enter، Escape)</li> <li>پشتیبانی از <code>prefers-reduced-motion</code> و سبک‌های سراسری <code>focus-visible</code></li> <li>۱۵ کلید دسترس‌پذیری i18n جدید با ترجمه کامل در تمام ۲۱ محلی‌سازی</li> <li>جایگزینی تمام رشته‌های انگلیسی <code>aria-label</code> که به‌صورت هاردکد بودند با جستجوی i18n</li> </ul> <h2>بهبودهای کیفیت زندگی<span class="hx:absolute hx:-mt-20" id="بهبودهای-کیفیت-زندگی"></span> <a href="#%d8%a8%d9%87%d8%a8%d9%88%d8%af%d9%87%d8%a7%db%8c-%da%a9%db%8c%d9%81%db%8c%d8%aa-%d8%b2%d9%86%d8%af%da%af%db%8c" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h2><ul> <li>بهبود سبک‌های خوانایی جدول</li> <li>پشتیبانی از ویژگی‌های Markdown برای سرتیترها</li> <li>تشخیص بهتر پیوند فعال برای صفحات فرود بخش چندزبانه</li> <li>پشتیبانی شورت‌کد کارت از پارامتر اختیاری <code>alt</code> برای تصاویر</li> <li>پشتیبانی از تصاویر بسته صفحه در ابرداده OpenGraph</li> <li>عرض محتوا اکنون به‌صورت پیش‌فرض ثابت است، با پشتیبانی از بازنویسی متغیر CSS برای چیدمان‌های سفارشی</li> </ul> <h2>رفع اشکالات<span class="hx:absolute hx:-mt-20" id="رفع-اشکالات"></span> <a href="#%d8%b1%d9%81%d8%b9-%d8%a7%d8%b4%da%a9%d8%a7%d9%84%d8%a7%d8%aa" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h2><ul> <li>جلوگیری از پیشوند پایه دوگانه <code>relref</code> در render-link</li> <li>رفع رندر تب‌ها هنگام تودرتوبودن در مراحل</li> <li>هم‌راستاسازی ترتیب و برچسب‌های نوار کناری موبایل با <code>menu.main</code></li> <li>رعایت <code>search.enable</code> در نوار کناری</li> <li>رعایت پارامتر صفحه <code>toc</code> در منوی بازشو موبایل</li> <li>بهبود برجسته‌سازی تطبیق FlexSearch و دستکاری امن DOM</li> <li>رفع موقعیت زیرعنوان کارت</li> <li>مدیریت اسلش‌های ابتدایی در مسیرهای تصویر OG برای استقرارهای زیرمسیر</li> <li>رفع بازگرداندن صفحات نتیجه کمتر از حد انتظار توسط FlexSearch</li> <li>تغییر فایل پیش‌فرض Umami analytics به <code>script.js</code></li> <li>رفع جستجوی نویسنده RSS برای Hugo v0.156.0+ (<code>.Site.Params.Author</code>)</li> </ul> <h2>مستندات و بومی‌سازی<span class="hx:absolute hx:-mt-20" id="مستندات-و-بومیسازی"></span> <a href="#%d9%85%d8%b3%d8%aa%d9%86%d8%af%d8%a7%d8%aa-%d9%88-%d8%a8%d9%88%d9%85%db%8c%d8%b3%d8%a7%d8%b2%db%8c" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h2><ul> <li>افزودن بومی‌سازی ایتالیایی</li> <li>پیوند مستندات KaTeX</li> <li>به‌روزرسانی مستندات شورت‌کد details به نحو angle bracket</li> </ul> <h2>مشارکت‌کنندگان<span class="hx:absolute hx:-mt-20" id="مشارکتکنندگان"></span> <a href="#%d9%85%d8%b4%d8%a7%d8%b1%da%a9%d8%aa%da%a9%d9%86%d9%86%d8%af%da%af%d8%a7%d9%86" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h2><p>این انتشار با مشارکت ۱۱ مشارکت‌کننده جدید ممکن شد:</p> <ul> <li><a href="https://github.com/ghac101"target="_blank" rel="noopener">@ghac101<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> - رفع Umami analytics، غیرفعال‌سازی ناوبری قبلی/بعدی</li> <li><a href="https://github.com/pmarrapese"target="_blank" rel="noopener">@pmarrapese<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> - پشتیبانی از ویژگی‌های Markdown برای سرتیترها</li> <li><a href="https://github.com/Bubbler-4"target="_blank" rel="noopener">@Bubbler-4<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> - مستندات شورت‌کد details</li> <li><a href="https://github.com/bloovis"target="_blank" rel="noopener">@bloovis<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> - رفع تعداد نتایج FlexSearch</li> <li><a href="https://github.com/AntoninPvr"target="_blank" rel="noopener">@AntoninPvr<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> - رفع موقعیت زیرعنوان کارت</li> <li><a href="https://github.com/illia-v"target="_blank" rel="noopener">@illia-v<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> - رفع TOC موبایل و کلید تغییر جستجو</li> <li><a href="https://github.com/gallochri"target="_blank" rel="noopener">@gallochri<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> - بومی‌سازی ایتالیایی</li> <li><a href="https://github.com/MatheusFlausino"target="_blank" rel="noopener">@MatheusFlausino<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> - حذف از LLMs.txt</li> <li><a href="https://github.com/daniseijo"target="_blank" rel="noopener">@daniseijo<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> - قابلیت آخرین نویسنده ویرایش‌کننده</li> <li><a href="https://github.com/confusedkernel"target="_blank" rel="noopener">@confusedkernel<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> - صفحه آرشیو</li> <li><a href="https://github.com/Fenyutanchan"target="_blank" rel="noopener">@Fenyutanchan<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> - رفع سازگاری نویسنده RSS با Hugo v0.156.0</li> </ul> <p>همچنین از مشارکت‌کنندگان بازگشته <a href="https://github.com/KStocky"target="_blank" rel="noopener">@KStocky<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a>، <a href="https://github.com/ldez"target="_blank" rel="noopener">@ldez<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a>، <a href="https://github.com/kowyo"target="_blank" rel="noopener">@kowyo<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a>، <a href="https://github.com/torbjornbp"target="_blank" rel="noopener">@torbjornbp<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a>، <a href="https://github.com/yuri1969"target="_blank" rel="noopener">@yuri1969<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> و <a href="https://github.com/PrintN"target="_blank" rel="noopener">@PrintN<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> بابت مشارکت‌های مداوم‌شان سپاسگزاریم.</p> <hr> <p><strong>تغییرات کامل</strong>: <a href="https://github.com/imfing/hextra/compare/v0.11.1...v0.12.0"target="_blank" rel="noopener">https://github.com/imfing/hextra/compare/v0.11.1...v0.12.0<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a></p>https://deploy-preview-968--hugo-hextra.netlify.app/fa/blog/v0.11/Sat, 30 Aug 2025 00:00:00 +0000https://deploy-preview-968--hugo-hextra.netlify.app/fa/blog/v0.11/ <p>Hextra v0.11.0 بر صیقل UX و مؤلفه‌های جدید کاربردی تمرکز دارد: بنر سراسری سایت، کال‌اوت‌ها و بج‌های بهبودیافته، کارت‌های غنی‌تر، یکپارچه‌سازی تحلیل‌گرها، و چند بهبود ناوبری. همچنین شامل رفع اشکالات پایداری و به‌روزرسانی‌های مستندات است.</p> <h2>راهنمای ارتقا<span class="hx:absolute hx:-mt-20" id="راهنمای-ارتقا"></span> <a href="#%d8%b1%d8%a7%d9%87%d9%86%d9%85%d8%a7%db%8c-%d8%a7%d8%b1%d8%aa%d9%82%d8%a7" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h2><p>برای بیشتر سایت‌ها تغییر شکست‌آمیزی وجود ندارد. با استفاده از <a href="https://gohugo.io/hugo-modules/use-modules/"target="_blank" rel="noopener">Hugo Modules<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> به‌روزرسانی کنید:</p> <div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">hugo mod get -u github.com/imfing/hextra</span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-0"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <h2>نکات برجسته<span class="hx:absolute hx:-mt-20" id="نکات-برجسته"></span> <a href="#%d9%86%da%a9%d8%a7%d8%aa-%d8%a8%d8%b1%d8%ac%d8%b3%d8%aa%d9%87" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h2><ul> <li>مؤلفه بنر بالایی برای اعلان‌ها</li> <li>بازطراحی کال‌اوت‌ها با سبک‌های شفاف‌تر</li> <li>پشتیبانی از تحلیل‌گرهای Umami و Matomo</li> <li>شورت‌کد Asciinema برای ضبط‌های ترمینال</li> <li>گزینهٔ تزئین پیوندهای خارجی</li> <li>مسیر راهنما برای صفحات تکی (غیرِ مستندات/غیرِ وبلاگ)</li> <li>بهبودهای نوار ناوبری: مورد پیوند با آیکون و جای‌گذاری بهتر</li> <li>سفارشی‌سازی بهتر بج‌ها و کارت‌ها</li> <li>کلید تغییر تم از گزینه «System» پشتیبانی می‌کند</li> </ul> <h2>ویژگی‌های جدید<span class="hx:absolute hx:-mt-20" id="ویژگیهای-جدید"></span> <a href="#%d9%88%db%8c%da%98%da%af%db%8c%d9%87%d8%a7%db%8c-%d8%ac%d8%af%db%8c%d8%af" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h2><h3>بنر بالایی<span class="hx:absolute hx:-mt-20" id="بنر-بالایی"></span> <a href="#%d8%a8%d9%86%d8%b1-%d8%a8%d8%a7%d9%84%d8%a7%db%8c%db%8c" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><p>یک بنر سراسری و قابلِ بستن برای اعلان‌ها، لانچ‌ها یا پیام‌های وضعیت اضافه کنید.</p> <div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div class="hextra-code-filename not-prose" dir="auto">hugo.yaml</div><div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">params</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">banner</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;announcement&#34;</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">message</span><span class="p">:</span><span class="w"> </span><span class="l">Welcome!</span></span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-8"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <p><img src="https://github.com/user-attachments/assets/33a08c9b-db84-4200-b37c-1a53c1bef08d" alt="بنر بالایی" data-zoomable loading="lazy" /></p> <h3>بازطراحی Callout<span class="hx:absolute hx:-mt-20" id="بازطراحی-callout"></span> <a href="#%d8%a8%d8%a7%d8%b2%d8%b7%d8%b1%d8%a7%d8%ad%db%8c-callout" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><p><a href="https://deploy-preview-968--hugo-hextra.netlify.app/fa/docs/guide/shortcodes/callout/">Callout</a> برای خوانایی بهتر و تأکید مناسب در تمام تم‌ها بازطراحی شده است.</p> <p><img src="https://github.com/user-attachments/assets/b3154dbb-e582-4c84-a8b8-1ecb02c3464d" alt="بازطراحی Callout" data-zoomable loading="lazy" /></p> <h3>تحلیل‌گرها: Umami و Matomo<span class="hx:absolute hx:-mt-20" id="تحلیلگرها-umami-و-matomo"></span> <a href="#%d8%aa%d8%ad%d9%84%db%8c%d9%84%da%af%d8%b1%d9%87%d8%a7-umami-%d9%88-matomo" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><p>پیکربندی داخلی برای فراهم‌کنندگان تحلیل‌گر:</p> <ul> <li><a href="https://deploy-preview-968--hugo-hextra.netlify.app/fa/docs/guide/configuration/#umami-analytics">Umami</a></li> <li><a href="https://deploy-preview-968--hugo-hextra.netlify.app/fa/docs/guide/configuration/#matomo-analytics">Matomo</a></li> </ul> <h3>شورت‌کد Asciinema<span class="hx:absolute hx:-mt-20" id="شورتکد-asciinema"></span> <a href="#%d8%b4%d9%88%d8%b1%d8%aa%da%a9%d8%af-asciinema" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><p>با استفاده از <a href="https://www.asciinema.org/"target="_blank" rel="noopener">Asciinema<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> و <a href="https://deploy-preview-968--hugo-hextra.netlify.app/fa/docs/guide/shortcodes/asciinema/">شورت‌کد Asciinema</a> ضبط‌های ترمینال را درون‌گذاری کنید.</p> <div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-md" data-lang="md"><span class="line"><span class="cl">{{&lt; asciinema id=&#34;123456&#34; autoplay=true loop=true &gt;}}</span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-0"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <p><img src="https://github.com/user-attachments/assets/3c33a8ef-3c01-4e30-9832-3ccb784ec538" alt="Asciinema" data-zoomable loading="lazy" /></p> <h3>بهبودهای نوار ناوبری<span class="hx:absolute hx:-mt-20" id="بهبودهای-نوار-ناوبری"></span> <a href="#%d8%a8%d9%87%d8%a8%d9%88%d8%af%d9%87%d8%a7%db%8c-%d9%86%d9%88%d8%a7%d8%b1-%d9%86%d8%a7%d9%88%d8%a8%d8%b1%db%8c" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><ul> <li>پشتیبانی از آیکون برای موارد پیوند در نوار ناوبری</li> <li>بهبود موقعیت منو برای هماهنگی با سوییچر زبان و سایر موارد</li> </ul> <p><img src="https://github.com/user-attachments/assets/6c035eee-cd7d-44d8-bcf7-9cbd7f92ab42" alt="نوار ناوبری با مورد آیکون" data-zoomable loading="lazy" /></p> <p>قابل ذکر است، نسخه <a href="https://github.com/imfing/hextra/releases/tag/v0.10.2"target="_blank" rel="noopener">0.10.2<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> امکان افزودن سوییچر زبان و کلید تغییر تم به نوار ناوبری را فراهم می‌کند.</p> <h3>تزئین پیوند خارجی<span class="hx:absolute hx:-mt-20" id="تزئین-پیوند-خارجی"></span> <a href="#%d8%aa%d8%b2%d8%a6%db%8c%d9%86-%d9%be%db%8c%d9%88%d9%86%d8%af-%d8%ae%d8%a7%d8%b1%d8%ac%db%8c" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><p>به‌صورت اختیاری یک تزئین ظریفِ «پیوند خارجی» به پیوندهای خروجی اضافه کنید.</p> <div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div class="hextra-code-filename not-prose" dir="auto">hugo.yaml</div><div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">params</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">externalLinkDecoration</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span></span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-8"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <h3>فعال‌سازی مسیر راهنما<span class="hx:absolute hx:-mt-20" id="فعالسازی-مسیر-راهنما"></span> <a href="#%d9%81%d8%b9%d8%a7%d9%84%d8%b3%d8%a7%d8%b2%db%8c-%d9%85%d8%b3%db%8c%d8%b1-%d8%b1%d8%a7%d9%87%d9%86%d9%85%d8%a7" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><p>با قرار دادن <code>breadcrumbs: true</code> در فرانت‌متر، مسیر راهنما را روی صفحات تکی (غیرِ مستندات/وبلاگ) فعال کنید.</p> <div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div class="hextra-code-filename not-prose" dir="auto">content/about.md</div><div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nn">---</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="nt">title</span><span class="p">:</span><span class="w"> </span><span class="l">About</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="nt">breadcrumbs</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="nn">---</span></span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-8"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <h3>بهبود کارت‌ها و بج‌ها<span class="hx:absolute hx:-mt-20" id="بهبود-کارتها-و-بجها"></span> <a href="#%d8%a8%d9%87%d8%a8%d9%88%d8%af-%da%a9%d8%a7%d8%b1%d8%aa%d9%87%d8%a7-%d9%88-%d8%a8%d8%ac%d9%87%d8%a7" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><ul> <li><a href="https://deploy-preview-968--hugo-hextra.netlify.app/fa/docs/guide/shortcodes/cards/">کارت‌ها</a>: گزینه‌های جدید <code>tagIcon</code> و <code>tagBorder</code>.</li> <li><a href="https://deploy-preview-968--hugo-hextra.netlify.app/fa/docs/guide/shortcodes/others/">بج‌ها</a>: رنگ‌ها و سبک‌های حاشیهٔ جدید.</li> </ul> <h2>بهبودهای کیفیت زندگی<span class="hx:absolute hx:-mt-20" id="بهبودهای-کیفیت-زندگی"></span> <a href="#%d8%a8%d9%87%d8%a8%d9%88%d8%af%d9%87%d8%a7%db%8c-%da%a9%db%8c%d9%81%db%8c%d8%aa-%d8%b2%d9%86%d8%af%da%af%db%8c" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h2><ul> <li>تغییر تم: افزودن گزینه «System» <img src="https://github.com/user-attachments/assets/54a1d315-9243-4814-9154-6e63af9ea2e8" alt="کلید تغییر تم" data-zoomable loading="lazy" /></li> <li>تایپوگرافی: سبک‌های بهتر فهرست کار با چک‌باکس <img src="https://github.com/user-attachments/assets/53722651-63b6-4469-95e7-326849a30306" alt="فهرست کار" data-zoomable loading="lazy" /></li> <li>سوییچر زبان: ترتیب‌دهی بهبود یافته همراه با موارد منوییِ آیکون‌دار</li> </ul> <h2>رفع اشکالات<span class="hx:absolute hx:-mt-20" id="رفع-اشکالات"></span> <a href="#%d8%b1%d9%81%d8%b9-%d8%a7%d8%b4%da%a9%d8%a7%d9%84%d8%a7%d8%aa" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h2><ul> <li>Giscus: همگام‌سازی صحیح تم و زبان</li> <li>کارت‌ها: رفع رندر بج در حالت RTL</li> <li>نوار ناوبری: بهبود موقعیت و تعاملات منو</li> </ul> <h2>مستندات و بومی‌سازی<span class="hx:absolute hx:-mt-20" id="مستندات-و-بومیسازی"></span> <a href="#%d9%85%d8%b3%d8%aa%d9%86%d8%af%d8%a7%d8%aa-%d9%88-%d8%a8%d9%88%d9%85%db%8c%d8%b3%d8%a7%d8%b2%db%8c" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h2><ul> <li>مستندات: صفحهٔ جدیدی دربارهٔ شورت‌کدهای Hextra</li> <li>i18n: افزودن ترجمه‌های <code>copyCode</code> و <code>system</code> به <code>zh-cn</code></li> </ul> <hr> <p><strong>تغییرات کامل</strong>: <a href="https://github.com/imfing/hextra/compare/v0.10.2...v0.11.0"target="_blank" rel="noopener">https://github.com/imfing/hextra/compare/v0.10.2...v0.11.0<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a></p>https://deploy-preview-968--hugo-hextra.netlify.app/fa/blog/v0.10/Thu, 14 Aug 2025 00:00:00 +0000https://deploy-preview-968--hugo-hextra.netlify.app/fa/blog/v0.10/ <p>Hextra v0.10.0 یک انتشار بزرگ است که مملو از قابلیت‌های جدید، ارتقاهای معماری و بهبودهای کیفیت زندگی می‌باشد.</p> <p>همچنین شامل مشارکت‌های 10 <a href="#contributors">مشارکت‌کننده جدید</a> بوده و درخواست‌های دیرینه جامعه را برطرف می‌کند.</p> <h2>راهنمای ارتقا<span class="hx:absolute hx:-mt-20" id="راهنمای-ارتقا"></span> <a href="#%d8%b1%d8%a7%d9%87%d9%86%d9%85%d8%a7%db%8c-%d8%a7%d8%b1%d8%aa%d9%82%d8%a7" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h2><div class="hx:overflow-x-auto hx:mt-6 hx:flex hx:flex-col hx:rounded-lg hx:border hx:py-4 hx:px-4 hx:border-gray-200 hx:contrast-more:border-current hx:contrast-more:dark:border-current hx:border-purple-200 hx:bg-purple-100 hx:text-purple-900 hx:dark:border-purple-200/30 hx:dark:bg-purple-900/30 hx:dark:text-purple-200"> <p class="hx:flex hx:items-center hx:font-medium"><svg height=16px class="hx:inline-block hx:align-middle hx:mr-2" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" aria-hidden="true"><path stroke-linecap="round" stroke-linejoin="round" d="M13 16h-1v-4h-1m1-4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"/></svg>Important</p> <div class="hx:w-full hx:min-w-0 hx:leading-7"> <div class="hx:mt-6 hx:leading-7 hx:first:mt-0"><p><strong>تغییرات شکست‌آمیز</strong>: این انتشار شامل چندین تغییر شکست‌آمیز است. لطفاً قبل از ارتقا، چک‌لیست و <a href="#migration-guide">راهنمای مهاجرت</a> را بررسی کنید.</p></div> </div> </div> <p>قبل از ارتقا به v0.10.0، مطمئن شوید که:</p> <ul> <li>Hugo v0.146.0+ (نسخه extended) نصب شده است</li> <li>CSS سفارشی را برای تغییرات نام کلاس بررسی کرده‌اید (به <a href="#css-class-prefix-changes">تغییرات پیشوند کلاس‌های CSS</a> و <a href="#tailwind-css-v4">Tailwind CSS v4</a> مراجعه کنید)</li> <li>تأیید کرده‌اید که محیط ساخت دسترسی به اینترنت برای دانلود دارایی‌ها هنگام استفاده از LaTeX و/یا Mermaid دارد</li> </ul> <p>پس از آماده‌سازی، ماژول Hugo را به‌روزرسانی کنید:</p> <div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">hugo mod get -u github.com/imfing/hextra@v0.10.0</span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-0"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <h2>ویژگی‌های جدید<span class="hx:absolute hx:-mt-20" id="ویژگیهای-جدید"></span> <a href="#%d9%88%db%8c%da%98%da%af%db%8c%d9%87%d8%a7%db%8c-%d8%ac%d8%af%db%8c%d8%af" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h2><p>در زیر لیستی از ویژگی‌های جدید قابل توجه در این انتشار آمده است:</p> <ul> <li><a href="#dropdown-menu-support-in-navbar"><strong>پشتیبانی از منوی کشویی در نوار ناوبری</strong></a>: ایجاد منوهای ناوبری سلسله‌مراتبی</li> <li><a href="#enhanced-search-experience"><strong>تجربه جستجوی بهبودیافته</strong></a>: جستجوی بهبودیافته در تمام سرتیترها با دقت بهتر</li> <li><a href="#llmstxt-support"><strong>پشتیبانی از llms.txt</strong></a>: تولید خلاصه سایت مناسب برای هوش مصنوعی</li> <li><a href="#table-of-contents-scroll-highlighting"><strong>هایلایت کردن اسکرول فهرست مطالب</strong></a>: هایلایت کردن خودکار سرتیترها هنگام اسکرول صفحه</li> <li><a href="#synchronized-tab-switching"><strong>تبدیل همگام تب‌ها</strong></a>: همگام‌سازی انتخاب تب‌ها در چندین گروه تب</li> <li><a href="#blog-list-pagination"><strong>صفحه‌بندی لیست وبلاگ</strong></a>: اضافه کردن کنترل‌های صفحه‌بندی به صفحات لیست وبلاگ</li> <li><a href="#mathjax-support"><strong>پشتیبانی از MathJax</strong></a>: موتور رندر ریاضی جایگزین در کنار KaTeX</li> </ul> <h3>پشتیبانی از منوی کشویی در نوار ناوبری<span class="hx:absolute hx:-mt-20" id="پشتیبانی-از-منوی-کشویی-در-نوار-ناوبری"></span> <a href="#%d9%be%d8%b4%d8%aa%db%8c%d8%a8%d8%a7%d9%86%db%8c-%d8%a7%d8%b2-%d9%85%d9%86%d9%88%db%8c-%da%a9%d8%b4%d9%88%db%8c%db%8c-%d8%af%d8%b1-%d9%86%d9%88%d8%a7%d8%b1-%d9%86%d8%a7%d9%88%d8%a8%d8%b1%db%8c" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><p>منوهای کشویی را در نوار ناوبری خود برای سازماندهی بهتر موارد ناوبری ایجاد کنید.</p> <div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div class="hextra-code-filename not-prose" dir="auto">hugo.yaml</div><div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">menu</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">main</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span>- <span class="nt">identifier</span><span class="p">:</span><span class="w"> </span><span class="l">products</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;محصولات&#34;</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span>- <span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;محصول الف&#34;</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">parent</span><span class="p">:</span><span class="w"> </span><span class="l">products</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">url</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;/product-a&#34;</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span>- <span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;محصول ب&#34;</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">parent</span><span class="p">:</span><span class="w"> </span><span class="l">products</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">url</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;/product-b&#34;</span></span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-8"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <p><img src="https://github.com/user-attachments/assets/1816f9b9-7fe3-46e8-9546-f15e43e9914a" alt="ناوبری منوی کشویی" data-zoomable loading="lazy" /></p> <h3>تجربه جستجوی بهبودیافته<span class="hx:absolute hx:-mt-20" id="تجربه-جستجوی-بهبودیافته"></span> <a href="#%d8%aa%d8%ac%d8%b1%d8%a8%d9%87-%d8%ac%d8%b3%d8%aa%d8%ac%d9%88%db%8c-%d8%a8%d9%87%d8%a8%d9%88%d8%af%db%8c%d8%a7%d9%81%d8%aa%d9%87" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><ul> <li><strong>جستجو در تمام سرتیترها</strong>: یافتن محتوا در تمام سطوح سرتیترها، نه فقط عنوان صفحات</li> <li><strong>دقت بهتر نتایج</strong>: مدیریت بهتر عنوان‌ها و دقت پیونددهی</li> <li><strong>ناوبری ثابت نتایج</strong>: نتایج جستجو اکنون به بخش‌های صحیح صفحه پیوند می‌خورند</li> </ul> <p>با تشکر ویژه از <a href="https://github.com/ldez"target="_blank" rel="noopener">@ldez<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> برای پیشبرد قابلیت‌های جستجو!</p> <p><img src="https://github.com/user-attachments/assets/f819652a-95d4-4843-b7e2-c7953a8cabe8" alt="نتایج جستجوی بهبودیافته" data-zoomable loading="lazy" /></p> <h3>پشتیبانی از llms.txt<span class="hx:absolute hx:-mt-20" id="پشتیبانی-از-llmstxt"></span> <a href="#%d9%be%d8%b4%d8%aa%db%8c%d8%a8%d8%a7%d9%86%db%8c-%d8%a7%d8%b2-llmstxt" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><p>Hextra اکنون از فرمت خروجی <a href="https://llmstxt.org/"target="_blank" rel="noopener">llms.txt<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> برای سایت شما پشتیبانی می‌کند، که سایت شما را برای ابزارهای هوش مصنوعی و مدل‌های زبانی برای زمینه و مرجع قابل دسترس‌تر می‌سازد.</p> <div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div class="hextra-code-filename not-prose" dir="auto">hugo.yaml</div><div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">outputs</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">home</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="l">html, llms]</span></span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-8"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <p>این یک فایل <code>llms.txt</code> در ریشه سایت شما ایجاد می‌کند.</p> <p><img src="https://github.com/user-attachments/assets/c6e929bb-0fce-4ab2-af15-a71c5a38b22c" alt="مثال llms txt" data-zoomable loading="lazy" /></p> <h3>هایلایت کردن اسکرول فهرست مطالب<span class="hx:absolute hx:-mt-20" id="هایلایت-کردن-اسکرول-فهرست-مطالب"></span> <a href="#%d9%87%d8%a7%db%8c%d9%84%d8%a7%db%8c%d8%aa-%da%a9%d8%b1%d8%af%d9%86-%d8%a7%d8%b3%da%a9%d8%b1%d9%88%d9%84-%d9%81%d9%87%d8%b1%d8%b3%d8%aa-%d9%85%d8%b7%d8%a7%d9%84%d8%a8" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><p>فهرست مطالب اکنون به‌طور خودکار بخش فعلی را هنگام اسکرول صفحه هایلایت می‌کند، که ناوبری را شهودی‌تر می‌سازد.</p> <p><img src="https://github.com/user-attachments/assets/d623fb99-7000-428b-af95-384eb722f0eb" alt="هایلایت اسکرول ToC" data-zoomable loading="lazy" /></p> <h3>تبدیل همگام تب‌ها<span class="hx:absolute hx:-mt-20" id="تبدیل-همگام-تبها"></span> <a href="#%d8%aa%d8%a8%d8%af%db%8c%d9%84-%d9%87%d9%85%da%af%d8%a7%d9%85-%d8%aa%d8%a8%d9%87%d8%a7" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><p>تب‌هایی با موارد یکسان اکنون در سراسر صفحه همگام می‌شوند. هنگامی که همگام‌سازی فعال است، انتخاب یک تب تمام گروه‌های تب که لیست موارد یکسانی دارند را به‌روزرسانی می‌کند (و انتخاب شما به خاطر سپرده می‌شود).</p> <div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div class="hextra-code-filename not-prose" dir="auto">hugo.yaml</div><div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">params</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">page</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">tabs</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">sync</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span></span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-8"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <h3>صفحه‌بندی لیست وبلاگ<span class="hx:absolute hx:-mt-20" id="صفحهبندی-لیست-وبلاگ"></span> <a href="#%d8%b5%d9%81%d8%ad%d9%87%d8%a8%d9%86%d8%af%db%8c-%d9%84%db%8c%d8%b3%d8%aa-%d9%88%d8%a8%d9%84%d8%a7%da%af" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><p>کنترل‌های صفحه‌بندی پایه به صفحات لیست وبلاگ اضافه شده‌اند.</p> <div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div class="hextra-code-filename not-prose" dir="auto">hugo.yaml</div><div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">params</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">blog</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">list</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">pagerSize</span><span class="p">:</span><span class="w"> </span><span class="m">20</span><span class="w"> </span><span class="c"># پست‌ها در هر صفحه</span></span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-8"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <p><img src="https://github.com/user-attachments/assets/60405fb4-ec36-4733-ba13-b4066396b5c5" alt="صفحه‌بندی وبلاگ" data-zoomable loading="lazy" /></p> <h3>پشتیبانی از MathJax<span class="hx:absolute hx:-mt-20" id="پشتیبانی-از-mathjax"></span> <a href="#%d9%be%d8%b4%d8%aa%db%8c%d8%a8%d8%a7%d9%86%db%8c-%d8%a7%d8%b2-mathjax" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><p>عبارات ریاضی را با <a href="https://www.mathjax.org/"target="_blank" rel="noopener">MathJax<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> در کنار پشتیبانی پیش‌فرض KaTeX رندر کنید. موتوری را انتخاب کنید که بهترین تناسب را با نیازهای شما دارد.</p> <div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div class="hextra-code-filename not-prose" dir="auto">hugo.yaml</div><div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">params</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">math</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">engine</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;mathjax&#34;</span><span class="w"> </span><span class="c"># پیش‌فرض &#34;katex&#34; است</span></span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-8"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <h2>بهبودهای فنی<span class="hx:absolute hx:-mt-20" id="بهبودهای-فنی"></span> <a href="#%d8%a8%d9%87%d8%a8%d9%88%d8%af%d9%87%d8%a7%db%8c-%d9%81%d9%86%db%8c" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h2><h3>چارچوب و سیستم ساخت<span class="hx:absolute hx:-mt-20" id="چارچوب-و-سیستم-ساخت"></span> <a href="#%da%86%d8%a7%d8%b1%da%86%d9%88%d8%a8-%d9%88-%d8%b3%db%8c%d8%b3%d8%aa%d9%85-%d8%b3%d8%a7%d8%ae%d8%aa" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><ul> <li><strong>مهاجرت به Tailwind CSS v4</strong>: مهاجرت کامل به <a href="https://tailwindcss.com/blog/tailwindcss-v4"target="_blank" rel="noopener">Tailwind CSS v4<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> با پشتیبانی بهبودیافته سفارشی‌سازی.</li> <li><strong>سیستم قالب Hugo</strong>: سازگار با <a href="https://gohugo.io/templates/new-templatesystem-overview/"target="_blank" rel="noopener">سیستم قالب جدید Hugo<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> (v0.146.0+) برای سازگاری آینده.</li> <li><strong>رندر سمت سرور ریاضی</strong>: مدیریت بهتر رندر معادلات ریاضی با استفاده از رندر بومی Hugo به‌صورت پیش‌فرض.</li> <li><strong>ارتقای FlexSearch 0.8</strong>: ارتقای موتور جستجو <a href="https://github.com/nextapps-de/flexsearch"target="_blank" rel="noopener">FlexSearch<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> برای نتایج سریع‌تر و دقیق‌تر با رمزگذاری بهبودیافته محتوای CJK (چینی، ژاپنی، کرهای).</li> <li><strong>مدیریت بهبودیافته دارایی‌ها</strong>: دارایی‌های KaTeX و Mermaid از بارگیری از CDN یا محلی پشتیبانی می‌کنند</li> </ul> <h2>بهبودهای کیفیت زندگی<span class="hx:absolute hx:-mt-20" id="بهبودهای-کیفیت-زندگی"></span> <a href="#%d8%a8%d9%87%d8%a8%d9%88%d8%af%d9%87%d8%a7%db%8c-%da%a9%db%8c%d9%81%db%8c%d8%aa-%d8%b2%d9%86%d8%af%da%af%db%8c" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h2><ul> <li><strong>تغییر دینامیک favicon</strong>: به‌روزرسانی خودکار favicon بر اساس ترجیحات طرح رنگ</li> <li><strong>صفحه‌بندی معکوس</strong>: نویسندگان اکنون می‌توانند <code>reversePagination</code> را در front matter صفحه تنظیم کنند</li> <li><strong>کنترل نمایه‌سازی گوگل</strong>: پارامتر صفحه جدید برای مسدود کردن نمایه‌سازی گوگل در صورت نیاز</li> <li><strong>بهبودهای مدیریت عرض</strong>: کنترل‌های طراحی پاسخگو بهتر از طریق متغیرهای CSS</li> <li><strong>بهبودهای استایل</strong>: استایل‌های مدرن برای جدول Markdown و خط افقی</li> </ul> <h2>رفع اشکالات و پایداری<span class="hx:absolute hx:-mt-20" id="رفع-اشکالات-و-پایداری"></span> <a href="#%d8%b1%d9%81%d8%b9-%d8%a7%d8%b4%da%a9%d8%a7%d9%84%d8%a7%d8%aa-%d9%88-%d9%be%d8%a7%db%8c%d8%af%d8%a7%d8%b1%db%8c" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h2><ul> <li><strong>همگام‌سازی تم Giscus</strong>: نظرات اکنون به درستی تغییرات حالت تاریک/روشن را دنبال می‌کنند</li> <li><strong>دقت نتایج جستجو</strong>: رفع مشکلات پیونددهی و فرار عنوان در نتایج جستجو</li> <li><strong>تبدیل تب‌ها</strong>: رفع مشکلات ناوبری در حالت غیرهمگام تب</li> <li><strong>اسکرول فانتوم</strong>: رفع رفتار ناخواسته اسکرول هنگام غیرفعال بودن پاورقی</li> <li><strong>دسترسی تصویر</strong>: جلوگیری از رندر تکراری متن alt</li> <li><strong>رندر پیوند</strong>: بهبود مدیریت URL پایه برای ساختارهای پیچیده سایت</li> </ul> <hr> <h2>راهنمای مهاجرت<span class="hx:absolute hx:-mt-20" id="راهنمای-مهاجرت"></span> <a href="#%d8%b1%d8%a7%d9%87%d9%86%d9%85%d8%a7%db%8c-%d9%85%d9%87%d8%a7%d8%ac%d8%b1%d8%aa" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h2><ul> <li><a href="#hugo-version-requirements"><strong>نیازمندی‌های نسخه Hugo</strong></a>: نیاز به Hugo v0.146.0+ (نسخه extended) دارد</li> <li><a href="#css-class-prefix-changes"><strong>تغییرات پیشوند کلاس‌های CSS</strong></a>: کلاس‌های CSS کامپوننت اکنون از پیشوند سازگار <code>hextra-</code> استفاده می‌کنند</li> <li><a href="#asset-management-for-katex-and-mermaid"><strong>مدیریت دارایی‌ها</strong></a>: دارایی‌های KaTeX و Mermaid اکنون در زمان ساخت دانلود می‌شوند</li> <li><a href="#tailwind-css-v4"><strong>Tailwind CSS v4</strong></a>: کامپایل CSS داخلی اکنون از Tailwind CSS v4.x با پیشوند <code>hx:</code> استفاده می‌کند</li> </ul> <h4>نیازمندی‌های نسخه Hugo<span class="hx:absolute hx:-mt-20" id="نیازمندیهای-نسخه-hugo"></span> <a href="#%d9%86%db%8c%d8%a7%d8%b2%d9%85%d9%86%d8%af%db%8c%d9%87%d8%a7%db%8c-%d9%86%d8%b3%d8%ae%d9%87-hugo" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h4><p><strong>تأثیر</strong>: سایت‌هایی که از نسخه‌های قدیمی Hugo استفاده می‌کنند</p> <p>Hextra v0.10.0 به دلیل پذیرش سیستم قالب جدید، نیاز به Hugo v0.146.0 یا بالاتر (نسخه extended) دارد.</p> <p><strong>اقدام مورد نیاز</strong>: قبل از ارتقای Hextra، Hugo را به v0.146.0+ به‌روزرسانی کنید</p> <h4>تغییرات پیشوند کلاس‌های CSS<span class="hx:absolute hx:-mt-20" id="تغییرات-پیشوند-کلاسهای-css"></span> <a href="#%d8%aa%d8%ba%db%8c%db%8c%d8%b1%d8%a7%d8%aa-%d9%be%db%8c%d8%b4%d9%88%d9%86%d8%af-%da%a9%d9%84%d8%a7%d8%b3%d9%87%d8%a7%db%8c-css" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h4><p><strong>تأثیر</strong>: سایت‌هایی با CSS سفارشی که کلاس‌های کامپوننت Hextra را هدف قرار می‌دهند</p> <p>Hextra v0.10.0 پیشوند سازگار <code>hextra-</code> را برای اکثر کلاس‌های CSS کامپوننت معرفی می‌کند تا قابلیت نگهداری را بهبود بخشد و از تداخل با استایل‌های کاربر جلوگیری کند.</p> <p><strong>اقدام مورد نیاز</strong>: اگر CSS سفارشی دارید که کامپوننت‌های Hextra را هدف قرار می‌دهد، نام کلاس‌های زیر را به‌روزرسانی کنید:</p> <table> <thead> <tr> <th>حوزه</th> <th>قبل</th> <th>بعد</th> </tr> </thead> <tbody> <tr> <td>جستجو (ظرف)</td> <td><code>.search-wrapper</code></td> <td><code>.hextra-search-wrapper</code></td> </tr> <tr> <td>جستجو (ورودی)</td> <td><code>.search-input</code></td> <td><code>.hextra-search-input</code></td> </tr> <tr> <td>جستجو (نتایج)</td> <td><code>.search-results</code></td> <td><code>.hextra-search-results</code></td> </tr> <tr> <td>جستجو (عنوان)</td> <td><code>.search-wrapper .title</code></td> <td><code>.hextra-search-wrapper .hextra-search-title</code></td> </tr> <tr> <td>جستجو (مورد فعال)</td> <td><code>.search-wrapper .active</code></td> <td><code>.hextra-search-wrapper .hextra-search-active</code></td> </tr> <tr> <td>جستجو (بدون نتیجه)</td> <td><code>.search-wrapper .no-result</code></td> <td><code>.hextra-search-wrapper .hextra-search-no-result</code></td> </tr> <tr> <td>جستجو (پیشوند)</td> <td><code>.search-wrapper .prefix</code></td> <td><code>.hextra-search-wrapper .hextra-search-prefix</code></td> </tr> <tr> <td>جستجو (گزیده)</td> <td><code>.search-wrapper .excerpt</code></td> <td><code>.hextra-search-wrapper .hextra-search-excerpt</code></td> </tr> <tr> <td>جستجو (مطابقت)</td> <td><code>.search-wrapper .match</code></td> <td><code>.hextra-search-wrapper .hextra-search-match</code></td> </tr> <tr> <td>تارنما محو</td> <td><code>.nav-container-blur</code></td> <td><code>.hextra-nav-container-blur</code></td> </tr> <tr> <td>منوی همبرگر</td> <td><code>.hamburger-menu</code></td> <td><code>.hextra-hamburger-menu</code></td> </tr> <tr> <td>تغییر تم</td> <td><code>.theme-toggle</code></td> <td><code>.hextra-theme-toggle</code></td> </tr> <tr> <td>تغییر زبان</td> <td><code>.language-switcher</code></td> <td><code>.hextra-language-switcher</code></td> </tr> <tr> <td>ظرف نوار کناری</td> <td><code>.sidebar-container</code></td> <td><code>.hextra-sidebar-container</code></td> </tr> <tr> <td>مورد فعال نوار کناری</td> <td><code>.sidebar-active-item</code></td> <td><code>.hextra-sidebar-active-item</code></td> </tr> <tr> <td>نام فایل کد</td> <td><code>.filename</code></td> <td><code>.hextra-code-filename</code></td> </tr> <tr> <td>آیکون کپی</td> <td><code>.copy-icon</code></td> <td><code>.hextra-copy-icon</code></td> </tr> <tr> <td>آیکون موفقیت</td> <td><code>.success-icon</code></td> <td><code>.hextra-success-icon</code></td> </tr> <tr> <td>مراحل</td> <td><code>.steps</code></td> <td><code>.hextra-steps</code></td> </tr> </tbody> </table> <h4>مدیریت دارایی‌ها برای KaTeX و Mermaid<span class="hx:absolute hx:-mt-20" id="مدیریت-داراییها-برای-katex-و-mermaid"></span> <a href="#%d9%85%d8%af%db%8c%d8%b1%db%8c%d8%aa-%d8%af%d8%a7%d8%b1%d8%a7%db%8c%db%8c%d9%87%d8%a7-%d8%a8%d8%b1%d8%a7%db%8c-katex-%d9%88-mermaid" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h4><p><strong>تأثیر</strong>: سایت‌هایی که از KaTeX یا Mermaid استفاده می‌کنند</p> <p>Hextra v0.10.0 اکنون دارایی‌های KaTeX و Mermaid را از CDN در زمان ساخت دانلود می‌کند.</p> <p><strong>چه چیزی تغییر کرده است:</strong></p> <ul> <li>فرآیند ساخت اکنون نیاز به دسترسی به اینترنت برای دانلود این دارایی‌ها دارد</li> <li>دیگر پس از ساخت، فراخوانی CDN خارجی برای این دارایی‌ها وجود ندارد</li> </ul> <p><strong>اقدام مورد نیاز</strong>:</p> <ul> <li>مطمئن شوید که محیط ساخت شما دسترسی به اینترنت برای دانلود دارایی‌ها دارد</li> <li>سایت‌های در محیط‌های ایزوله ممکن است نیاز به پیش‌دانلود این دارایی‌ها و پیکربندی Hextra برای بارگیری آنها داشته باشند</li> </ul> <h4>Tailwind CSS v4<span class="hx:absolute hx:-mt-20" id="tailwind-css-v4"></span> <a href="#tailwind-css-v4" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h4><p><strong>تأثیر</strong>: سایت‌هایی با CSS سفارشی گسترده که کلاس‌های Tailwind Hextra <code>hx-*</code> را هدف قرار می‌دهند</p> <p>در حالی که Hextra مهاجرت Tailwind CSS v4 را به صورت داخلی مدیریت می‌کند، سایت‌هایی با سفارشی‌سازی‌های سنگین ممکن است نیاز به تنظیمات بیشتری داشته باشند.</p> <p><strong>چه چیزی تغییر کرده است:</strong></p> <ul> <li>کامپایل CSS داخلی اکنون از Tailwind CSS v4.x استفاده می‌کند</li> <li>کلاس‌های ابزار اکنون با پیشوند <code>hx:</code> به جای <code>hx-</code> هستند</li> </ul> <h2>مشارکت‌کنندگان<span class="hx:absolute hx:-mt-20" id="مشارکتکنندگان"></span> <a href="#%d9%85%d8%b4%d8%a7%d8%b1%da%a9%d8%aa%da%a9%d9%86%d9%86%d8%af%da%af%d8%a7%d9%86" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h2><p>این انتشار با مشارکت‌های 10 مشارکت‌کننده جدید ممکن شد:</p> <ul> <li><a href="https://github.com/oosquare"target="_blank" rel="noopener">@oosquare<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> - فونت‌های KaTeX، قلاب‌های رندر تصویر، بهبودهای مدیریت پیوند</li> <li><a href="https://github.com/Zabriskije"target="_blank" rel="noopener">@Zabriskije<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> - رفع اسکرول فانتوم</li> <li><a href="https://github.com/miniwater"target="_blank" rel="noopener">@miniwater<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> - مرکزسازی پاورقی سفارشی، بهبودهای متن alt تصویر</li> <li><a href="https://github.com/MattDodsonEnglish"target="_blank" rel="noopener">@MattDodsonEnglish<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> - کنترل‌های نمایه‌سازی گوگل، مستندات OpenGraph</li> <li><a href="https://github.com/KStocky"target="_blank" rel="noopener">@KStocky<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> - ویژگی صفحه‌بندی معکوس</li> <li><a href="https://github.com/PrintN"target="_blank" rel="noopener">@PrintN<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> - اضافه شدن نمایش مستندات</li> <li><a href="https://github.com/hobobandy"target="_blank" rel="noopener">@hobobandy<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> - بهبودهای فاصله عنوان</li> <li><a href="https://github.com/dlwocks31"target="_blank" rel="noopener">@dlwocks31<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> - به‌روزرسانی ترجمه کرهای</li> <li><a href="https://github.com/TwoAnts"target="_blank" rel="noopener">@TwoAnts<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> - رفع تغییر تم Giscus</li> <li><a href="https://github.com/ldez"target="_blank" rel="noopener">@ldez<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> - بهبودهای جستجو و رفع اشکالات</li> </ul> <p>با تشکر ویژه از مشارکت‌کنندگان بازگشتی <a href="https://github.com/deining"target="_blank" rel="noopener">@deining<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> و <a href="https://github.com/yuri1969"target="_blank" rel="noopener">@yuri1969<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a> برای حمایت مستمرشان در مستندات، ترجمه‌ها و بهبودهای فنی.</p> <p><strong>تغییرات کامل</strong>: <a href="https://github.com/imfing/hextra/compare/v0.9.7...v0.10.0"target="_blank" rel="noopener">https://github.com/imfing/hextra/compare/v0.9.7...v0.10.0<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a></p>https://deploy-preview-968--hugo-hextra.netlify.app/fa/blog/markdown/Wed, 01 Jan 2020 00:00:00 +0000https://deploy-preview-968--hugo-hextra.netlify.app/fa/blog/markdown/ <p>این مقاله نمونه‌ای از نحو پایه‌ای Markdown را ارائه می‌دهد که می‌توان در فایل‌های محتوای Hugo استفاده کرد.</p> <h2>نحو پایه<span class="hx:absolute hx:-mt-20" id="نحو-پایه"></span> <a href="#%d9%86%d8%ad%d9%88-%d9%be%d8%a7%db%8c%d9%87" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h2><h3>سرتیترها<span class="hx:absolute hx:-mt-20" id="سرتیترها"></span> <a href="#%d8%b3%d8%b1%d8%aa%db%8c%d8%aa%d8%b1%d9%87%d8%a7" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div><pre><code># سرتیتر 1 ## سرتیتر 2 ### سرتیتر 3 #### سرتیتر 4 ##### سرتیتر 5 ###### سرتیتر 6</code></pre></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-0"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <h2>سرتیتر 2<span class="hx:absolute hx:-mt-20" id="سرتیتر-2"></span> <a href="#%d8%b3%d8%b1%d8%aa%db%8c%d8%aa%d8%b1-2" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h2><h3>سرتیتر 3<span class="hx:absolute hx:-mt-20" id="سرتیتر-3"></span> <a href="#%d8%b3%d8%b1%d8%aa%db%8c%d8%aa%d8%b1-3" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><h4>سرتیتر 4<span class="hx:absolute hx:-mt-20" id="سرتیتر-4"></span> <a href="#%d8%b3%d8%b1%d8%aa%db%8c%d8%aa%d8%b1-4" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h4><h5>سرتیتر 5<span class="hx:absolute hx:-mt-20" id="سرتیتر-5"></span> <a href="#%d8%b3%d8%b1%d8%aa%db%8c%d8%aa%d8%b1-5" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h5><h6>سرتیتر 6<span class="hx:absolute hx:-mt-20" id="سرتیتر-6"></span> <a href="#%d8%b3%d8%b1%d8%aa%db%8c%d8%aa%d8%b1-6" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h6><h3>تأکید<span class="hx:absolute hx:-mt-20" id="تأکید"></span> <a href="#%d8%aa%d8%a3%da%a9%db%8c%d8%af" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">*این متن به صورت ایتالیک نمایش داده می‌شود* </span></span><span class="line"><span class="cl">_این نیز به صورت ایتالیک نمایش داده می‌شود_ </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl">**این متن به صورت پررنگ نمایش داده می‌شود** </span></span><span class="line"><span class="cl">__این نیز به صورت پررنگ نمایش داده می‌شود__ </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl">_شما می‌توانید **آن‌ها را ترکیب** کنید_</span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-0"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <p><em>این متن به صورت ایتالیک نمایش داده می‌شود</em></p> <p><em>این نیز به صورت ایتالیک نمایش داده می‌شود</em></p> <p><strong>این متن به صورت پررنگ نمایش داده می‌شود</strong></p> <p><strong>این نیز به صورت پررنگ نمایش داده می‌شود</strong></p> <p><em>شما می‌توانید <strong>آن‌ها را ترکیب</strong> کنید</em></p> <h3>فهرست‌ها<span class="hx:absolute hx:-mt-20" id="فهرستها"></span> <a href="#%d9%81%d9%87%d8%b1%d8%b3%d8%aa%d9%87%d8%a7" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><h4>بدون ترتیب<span class="hx:absolute hx:-mt-20" id="بدون-ترتیب"></span> <a href="#%d8%a8%d8%af%d9%88%d9%86-%d8%aa%d8%b1%d8%aa%db%8c%d8%a8" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h4><div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div><pre><code>* مورد ۱ * مورد ۲ * مورد ۲الف * مورد ۲ب</code></pre></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-0"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <ul> <li>مورد ۱</li> <li>مورد ۲ <ul> <li>مورد ۲الف</li> <li>مورد ۲ب</li> </ul> </li> </ul> <h4>با ترتیب<span class="hx:absolute hx:-mt-20" id="با-ترتیب"></span> <a href="#%d8%a8%d8%a7-%d8%aa%d8%b1%d8%aa%db%8c%d8%a8" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h4><div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div><pre><code>۱. مورد ۱ ۲. مورد ۲ ۳. مورد ۳ ۱. مورد ۳الف ۲. مورد ۳ب</code></pre></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-0"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <h3>تصاویر<span class="hx:absolute hx:-mt-20" id="تصاویر"></span> <a href="#%d8%aa%d8%b5%d8%a7%d9%88%db%8c%d8%b1" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-markdown" data-lang="markdown"><span class="line"><span class="cl">![<span class="nt">لوگوی GitHub</span>](<span class="na">https://github.githubassets.com/images/modules/logos_page/GitHub-Mark.png</span>)</span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-0"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <p><img src="https://github.githubassets.com/images/modules/logos_page/GitHub-Mark.png" alt="لوگوی GitHub" data-zoomable loading="lazy" /></p> <h3>پیوندها<span class="hx:absolute hx:-mt-20" id="پیوندها"></span> <a href="#%d9%be%db%8c%d9%88%d9%86%d8%af%d9%87%d8%a7" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-markdown" data-lang="markdown"><span class="line"><span class="cl">[<span class="nt">Hugo</span>](<span class="na">https://gohugo.io</span>)</span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-0"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <p><a href="https://gohugo.io"target="_blank" rel="noopener">Hugo<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a></p> <h3>نقل‌قول‌ها<span class="hx:absolute hx:-mt-20" id="نقلقولها"></span> <a href="#%d9%86%d9%82%d9%84%d9%82%d9%88%d9%84%d9%87%d8%a7" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-markdown" data-lang="markdown"><span class="line"><span class="cl">همان‌طور که نیوتن گفت: </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl">&gt; اگر من دورتر را دیده‌ام، به این دلیل است که بر شانه‌های غول‌ها ایستاده‌ام.</span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-0"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <blockquote> <p>اگر من دورتر را دیده‌ام، به این دلیل است که بر شانه‌های غول‌ها ایستاده‌ام.</p> </blockquote> <h3>کد درون‌خطی<span class="hx:absolute hx:-mt-20" id="کد-درونخطی"></span> <a href="#%da%a9%d8%af-%d8%af%d8%b1%d9%88%d9%86%d8%ae%d8%b7%db%8c" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-markdown" data-lang="markdown"><span class="line"><span class="cl">کد <span class="sb">`درون‌خطی`</span> با <span class="sb">`علامت back-tick`</span> احاطه شده است.</span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-0"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <p>کد <code>درون‌خطی</code> با <code>علامت back-tick</code> احاطه شده است.</p> <h3>بلوک‌های کد<span class="hx:absolute hx:-mt-20" id="بلوکهای-کد"></span> <a href="#%d8%a8%d9%84%d9%88%da%a9%d9%87%d8%a7%db%8c-%da%a9%d8%af" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><h4>هایلایت سینتکس<span class="hx:absolute hx:-mt-20" id="هایلایت-سینتکس"></span> <a href="#%d9%87%d8%a7%db%8c%d9%84%d8%a7%db%8c%d8%aa-%d8%b3%db%8c%d9%86%d8%aa%da%a9%d8%b3" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h4><div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-markdown" data-lang="markdown"><span class="line"><span class="cl"><span class="s">```go </span></span></span><span class="line"><span class="cl"><span class="kd">func</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nx">fmt</span><span class="p">.</span><span class="nf">Println</span><span class="p">(</span><span class="s">&#34;Hello World&#34;</span><span class="p">)</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="p">}</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="s">```</span></span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-0"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-go" data-lang="go"><span class="line"><span class="cl"><span class="kd">func</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nx">fmt</span><span class="p">.</span><span class="nf">Println</span><span class="p">(</span><span class="s">&#34;Hello World&#34;</span><span class="p">)</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="p">}</span></span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-0"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <h3>جداول<span class="hx:absolute hx:-mt-20" id="جداول"></span> <a href="#%d8%ac%d8%af%d8%a7%d9%88%d9%84" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h3><div class="hextra-code-block hx:relative hx:mt-6 hx:first:mt-0 hx:group/code"> <div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-markdown" data-lang="markdown"><span class="line"><span class="cl">| سینتکس | توضیحات | </span></span><span class="line"><span class="cl">| --------- | ----------- | </span></span><span class="line"><span class="cl">| هدر | عنوان | </span></span><span class="line"><span class="cl">| پاراگراف | متن |</span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-0"> <button class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50" title="کپی کد" aria-label="کپی کد" data-copied-label="کپی شد!" > <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div> <div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div> </button> </div> </div> <table> <thead> <tr> <th>سینتکس</th> <th>توضیحات</th> </tr> </thead> <tbody> <tr> <td>هدر</td> <td>عنوان</td> </tr> <tr> <td>پاراگراف</td> <td>متن</td> </tr> </tbody> </table> <h2>منابع<span class="hx:absolute hx:-mt-20" id="منابع"></span> <a href="#%d9%85%d9%86%d8%a7%d8%a8%d8%b9" class="subheading-anchor" aria-label="پیوند ثابت به این بخش"></a></h2><ul> <li><a href="https://www.markdownguide.org/basic-syntax/"target="_blank" rel="noopener">نحو Markdown<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a></li> <li><a href="https://gohugo.io/content-management/formats/#markdown"target="_blank" rel="noopener">Markdown در Hugo<svg class="hx:inline hx:rtl:rotate-270 hx:align-baseline" height="1em" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"> <path d="m9.1716 7.7574h7.0711m0 0v7.0711m0-7.0711-8.4853 8.4853" stroke-linecap="round" stroke-linejoin="round"/> </svg></a></li> </ul>