https://example.org/fa/blog/Recent content in وبلاگ on ClaudeMPHugo -- gohugo.iofaSat, 30 Aug 2025 00:00:00 +0000https://example.org/fa/blog/v0.11/Sat, 30 Aug 2025 00:00:00 +0000https://example.org/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="Permalink for this section"></a></h2><p>برای بیشتر سایت‌ها تغییر شکست‌آمیزی وجود ندارد. با استفاده از <a href="https://gohugo.io/hugo-modules/use-modules/"target="_blank" rel="noopener">Hugo Modules</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="کپی کد" > <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="Permalink for this section"></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="Permalink for this section"></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="Permalink for this section"></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="کپی کد" > <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="بنر بالایی" 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="Permalink for this section"></a></h3><p><a href="https://example.org/fa/docs/guide/shortcodes/callout/">Callout</a> برای خوانایی بهتر و تأکید مناسب در تمام تم‌ها بازطراحی شده است.</p> <p><img src="https://github.com/user-attachments/assets/b3154dbb-e582-4c84-a8b8-1ecb02c3464d" alt="بازطراحی Callout" 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="Permalink for this section"></a></h3><p>پیکربندی داخلی برای فراهم‌کنندگان تحلیل‌گر:</p> <ul> <li><a href="https://example.org/fa/docs/guide/configuration/#umami-analytics">Umami</a></li> <li><a href="https://example.org/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="Permalink for this section"></a></h3><p>با استفاده از <a href="https://www.asciinema.org/"target="_blank" rel="noopener">Asciinema</a> و <a href="https://example.org/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">{{<span class="p">&lt;</span> <span class="nt">asciinema</span> <span class="na">id</span><span class="o">=</span><span class="s">&#34;123456&#34;</span> <span class="na">autoplay</span><span class="o">=</span><span class="s">true</span> <span class="na">loop</span><span class="o">=</span><span class="s">true</span> <span class="p">&gt;</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="کپی کد" > <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" 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="Permalink for this section"></a></h3><ul> <li>پشتیبانی از آیکون برای موارد پیوند در نوار ناوبری</li> <li>بهبود موقعیت منو برای هماهنگی با سوییچر زبان و سایر موارد</li> </ul> <p><img src="https://github.com/user-attachments/assets/6c035eee-cd7d-44d8-bcf7-9cbd7f92ab42" alt="نوار ناوبری با مورد آیکون" loading="lazy" /></p> <p>قابل ذکر است، نسخه <a href="https://github.com/imfing/hextra/releases/tag/v0.10.2"target="_blank" rel="noopener">0.10.2</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="Permalink for this section"></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="کپی کد" > <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="Permalink for this section"></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="w"></span><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="w"></span><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="w"></span><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="کپی کد" > <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="Permalink for this section"></a></h3><ul> <li><a href="https://example.org/fa/docs/guide/shortcodes/cards/">کارت‌ها</a>: گزینه‌های جدید <code>tagIcon</code> و <code>tagBorder</code>.</li> <li><a href="https://example.org/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="Permalink for this section"></a></h2><ul> <li>تغییر تم: افزودن گزینه «System» <img src="https://github.com/user-attachments/assets/54a1d315-9243-4814-9154-6e63af9ea2e8" alt="کلید تغییر تم" loading="lazy" /></li> <li>تایپوگرافی: سبک‌های بهتر فهرست کار با چک‌باکس <img src="https://github.com/user-attachments/assets/53722651-63b6-4469-95e7-326849a30306" alt="فهرست کار" 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="Permalink for this section"></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="Permalink for this section"></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</a></p>https://example.org/fa/blog/v0.10/Thu, 14 Aug 2025 00:00:00 +0000https://example.org/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="Permalink for this section"></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="کپی کد" > <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="Permalink for this section"></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="Permalink for this section"></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="کپی کد" > <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="ناوبری منوی کشویی" 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="Permalink for this section"></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</a> برای پیشبرد قابلیت‌های جستجو!</p> <p><img src="https://github.com/user-attachments/assets/f819652a-95d4-4843-b7e2-c7953a8cabe8" alt="نتایج جستجوی بهبودیافته" 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="Permalink for this section"></a></h3><p>Hextra اکنون از فرمت خروجی <a href="https://llmstxt.org/"target="_blank" rel="noopener">llms.txt</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="کپی کد" > <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" 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="Permalink for this section"></a></h3><p>فهرست مطالب اکنون به‌طور خودکار بخش فعلی را هنگام اسکرول صفحه هایلایت می‌کند، که ناوبری را شهودی‌تر می‌سازد.</p> <p><img src="https://github.com/user-attachments/assets/d623fb99-7000-428b-af95-384eb722f0eb" alt="هایلایت اسکرول ToC" 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="Permalink for this section"></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="کپی کد" > <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="Permalink for this section"></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="کپی کد" > <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="صفحه‌بندی وبلاگ" 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="Permalink for this section"></a></h3><p>عبارات ریاضی را با <a href="https://www.mathjax.org/"target="_blank" rel="noopener">MathJax</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="کپی کد" > <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="Permalink for this section"></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="Permalink for this section"></a></h3><ul> <li><strong>مهاجرت به Tailwind CSS v4</strong>: مهاجرت کامل به <a href="https://tailwindcss.com/blog/tailwindcss-v4"target="_blank" rel="noopener">Tailwind CSS v4</a> با پشتیبانی بهبودیافته سفارشی‌سازی.</li> <li><strong>سیستم قالب Hugo</strong>: سازگار با <a href="https://gohugo.io/templates/new-templatesystem-overview/"target="_blank" rel="noopener">سیستم قالب جدید Hugo</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</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="Permalink for this section"></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="Permalink for this section"></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="Permalink for this section"></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="Permalink for this section"></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="Permalink for this section"></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="Permalink for this section"></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="Permalink for this section"></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="Permalink for this section"></a></h2><p>این انتشار با مشارکت‌های 10 مشارکت‌کننده جدید ممکن شد:</p> <ul> <li><a href="https://github.com/oosquare"target="_blank" rel="noopener">@oosquare</a> - فونت‌های KaTeX، قلاب‌های رندر تصویر، بهبودهای مدیریت پیوند</li> <li><a href="https://github.com/Zabriskije"target="_blank" rel="noopener">@Zabriskije</a> - رفع اسکرول فانتوم</li> <li><a href="https://github.com/miniwater"target="_blank" rel="noopener">@miniwater</a> - مرکزسازی پاورقی سفارشی، بهبودهای متن alt تصویر</li> <li><a href="https://github.com/MattDodsonEnglish"target="_blank" rel="noopener">@MattDodsonEnglish</a> - کنترل‌های نمایه‌سازی گوگل، مستندات OpenGraph</li> <li><a href="https://github.com/KStocky"target="_blank" rel="noopener">@KStocky</a> - ویژگی صفحه‌بندی معکوس</li> <li><a href="https://github.com/PrintN"target="_blank" rel="noopener">@PrintN</a> - اضافه شدن نمایش مستندات</li> <li><a href="https://github.com/hobobandy"target="_blank" rel="noopener">@hobobandy</a> - بهبودهای فاصله عنوان</li> <li><a href="https://github.com/dlwocks31"target="_blank" rel="noopener">@dlwocks31</a> - به‌روزرسانی ترجمه کرهای</li> <li><a href="https://github.com/TwoAnts"target="_blank" rel="noopener">@TwoAnts</a> - رفع تغییر تم Giscus</li> <li><a href="https://github.com/ldez"target="_blank" rel="noopener">@ldez</a> - بهبودهای جستجو و رفع اشکالات</li> </ul> <p>با تشکر ویژه از مشارکت‌کنندگان بازگشتی <a href="https://github.com/deining"target="_blank" rel="noopener">@deining</a> و <a href="https://github.com/yuri1969"target="_blank" rel="noopener">@yuri1969</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</a></p>https://example.org/fa/blog/markdown/Wed, 01 Jan 2020 00:00:00 +0000https://example.org/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="Permalink for this section"></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="Permalink for this section"></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="کپی کد" > <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="Permalink for this section"></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="Permalink for this section"></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="Permalink for this section"></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="Permalink for this section"></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="Permalink for this section"></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="Permalink for this section"></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="کپی کد" > <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="Permalink for this section"></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="Permalink for this section"></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="کپی کد" > <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="Permalink for this section"></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="کپی کد" > <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="Permalink for this section"></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="کپی کد" > <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" 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="Permalink for this section"></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="کپی کد" > <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</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="Permalink for this section"></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="کپی کد" > <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="Permalink for this section"></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="کپی کد" > <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="Permalink for this section"></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="Permalink for this section"></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="s"></span><span class="kd">func</span> <span class="nf">main</span><span class="p">()</span> <span class="p">{</span> </span></span><span class="line"><span class="cl"> <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></span><span class="line"><span class="cl"><span class="p">}</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="کپی کد" > <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="nf">main</span><span class="p">()</span> <span class="p">{</span> </span></span><span class="line"><span class="cl"> <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></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="کپی کد" > <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="Permalink for this section"></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="کپی کد" > <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="Permalink for this section"></a></h2><ul> <li><a href="https://www.markdownguide.org/basic-syntax/"target="_blank" rel="noopener">نحو Markdown</a></li> <li><a href="https://gohugo.io/content-management/formats/#markdown"target="_blank" rel="noopener">Markdown در Hugo</a></li> </ul>