Hextra v0.12

Hextra v0.12.0 مجموعه‌ای غنی از ویژگی‌های جدید شامل منوی زمینه صفحه، زوم تصویر، تب‌های بازطراحی‌شده و موارد بیشتر، به همراه بهبودهای جامع دسترس‌پذیری WCAG 2.2 AA و رفع اشکالات متعدد ارائه می‌دهد.

راهنمای ارتقا

برای بیشتر سایت‌ها تغییر شکست‌آمیزی وجود ندارد. با استفاده از Hugo Modules به‌روزرسانی کنید:

hugo mod get -u github.com/imfing/hextra

نکات برجسته

• منوی زمینه صفحه برای کپی/مشاهده سورس Markdown
• بازطراحی شورت‌کد تب‌ها با نام‌گذاری هر تب و پشتیبانی از آیکون
• زوم با کلیک برای تصاویر Markdown
• پشتیبانی از تحلیل‌گر GoatCounter
• گزینه مخفی‌کردن نوار کناری اصلی در دسکتاپ
• نمایش آخرین نویسنده ویرایش‌کننده از طریق GitInfo
• گزینه غیرفعال‌سازی ناوبری قبلی/بعدی
• صفحه آرشیو داخلی برای فهرست زمانی نوشته‌های وبلاگ
• شورت‌کد و چیدمان واژه‌نامه
• حذف صفحات/بخش‌ها از llms.txt
• ترتیب و برچسب‌های نوار کناری موبایل هم‌راستا با menu.main
• عرض محتوای پایدار با پشتیبانی از بازنویسی متغیر CSS
• بهبودهای جامع دسترس‌پذیری WCAG 2.2 AA

ویژگی‌های جدید

منوی زمینه صفحه

منوی زمینه صفحه دکمه‌ای کشویی فراهم می‌کند که با آن می‌توانید محتوای صفحه را به‌صورت Markdown کپی کنید یا سورس خام Markdown را مشاهده نمایید. با افزایش کاربرانی که مستندات را به ابزارهای هوش مصنوعی مولّد می‌دهند، دسترسی سریع به Markdown تمیز بسیار مفید است. پیوندهای سفارشی با متغیرهای قالب ({url}، {title}، {markdown_url}) به شما امکان می‌دهند میان‌برهای «از AI بپرس» یا سایر یکپارچه‌سازی‌ها را مستقیماً در منو ایجاد کنید.

برای استفاده از قابلیت‌های «مشاهده به‌صورت Markdown» و {markdown_url}، فرمت خروجی Markdown را در پیکربندی سایت فعال کنید:

outputs:
  page: [html, markdown]
  section: [html, rss, markdown]

سپس منوی زمینه را پیکربندی کنید:

params:
  page:
    contextMenu:
      enable: true
      links:
        - name: "Ask AI"
          url: "https://example.com?content={markdown_url}"
          icon: "sparkles"

بازطراحی تب‌ها و پشتیبانی از آیکون

شورت‌کد تب‌ها بازطراحی شده است. اکنون می‌توان نام تب‌ها را مستقیماً روی هر شورت‌کد tab تنظیم کرد و پارامتر اختیاری icon یک آیکون قبل از برچسب تب نمایش می‌دهد. نحو قبلی همچنان پشتیبانی می‌شود.

{{< tabs >}}
  {{< tab name="Photos" icon="photograph" >}}مدیریت و سازماندهی کتابخانه عکس‌های شما.{{< /tab >}}
  {{< tab name="Music" icon="music-note" >}}مرور و پخش آهنگ‌های مورد علاقه شما.{{< /tab >}}
  {{< tab name="Videos" icon="film" >}}تماشا و پخش محتوای ویدیویی.{{< /tab >}}
{{< /tabs >}}

زوم تصویر

با یک گزینه پیکربندی جدید، زوم با کلیک را روی تصاویر Markdown فعال کنید. این قابلیت از medium-zoom استفاده می‌کند.

params:
  imageZoom:
    enable: true

تحلیل‌گر GoatCounter

پشتیبانی داخلی از تحلیل‌گر GoatCounter در کنار یکپارچه‌سازی‌های موجود Google Analytics، Umami و Matomo.

مخفی‌کردن نوار کناری اصلی

یک پارامتر جدید فرانت‌متر امکان مخفی‌کردن نوار کناری اصلی در دسکتاپ را فراهم می‌کند تا صفحات محتوا عرض کامل داشته باشند.

---
title: My Page
sidebar:
  hide: true
---

آخرین نویسنده ویرایش‌کننده

با استفاده از GitInfo هوگو، آخرین نویسنده کامیت را در کنار تاریخ «آخرین به‌روزرسانی» نمایش دهید.

params:
  displayUpdatedAuthor: true

غیرفعال‌سازی ناوبری قبلی/بعدی

دکمه‌های ناوبری قبلی/بعدی را در سطح سایت غیرفعال کنید:

params:
  page:
    displayPagination: false

حذف از LLMs.txt

با تنظیم llms: false در فرانت‌متر، صفحات یا بخش‌های کامل را از خروجی llms.txt حذف کنید.

---
title: "Private Page"
llms: false
---

صفحه آرشیو

چیدمان جدید داخلی archives نوشته‌های وبلاگ را در یک خط زمانی گروه‌بندی‌شده بر اساس سال نمایش می‌دهد و برچسب‌ها به‌صورت درون‌خطی پس از عنوان هر نوشته نشان داده می‌شوند.

---
title: Archives
layout: archives
---

واژه‌نامه

یک واژه‌نامه اصطلاحات سراسری سایت با صفحه فهرست اختصاصی و شورت‌کد term برای تعاریف درون‌خطی.

دسترس‌پذیری

بهبودهای جامع دسترس‌پذیری WCAG 2.2 AA (#924):

• پیوند رفتن به محتوا و نقش‌های نشانه‌ای ARIA در تمام صفحات
• ویژگی‌های ARIA برای تمام ابزارک‌های تعاملی (کلید تغییر تم، تب‌ها، نوار کناری، درخت فایل، منوهای بازشو، جستجو، منوها)
• ناوبری صفحه‌کلیدی برای تب‌ها و کلید تغییر تم (کلیدهای جهتی، Enter، Escape)
• پشتیبانی از prefers-reduced-motion و سبک‌های سراسری focus-visible
• ۱۵ کلید دسترس‌پذیری i18n جدید با ترجمه کامل در تمام ۲۱ محلی‌سازی
• جایگزینی تمام رشته‌های انگلیسی aria-label که به‌صورت هاردکد بودند با جستجوی i18n

بهبودهای کیفیت زندگی

• بهبود سبک‌های خوانایی جدول
• پشتیبانی از ویژگی‌های Markdown برای سرتیترها
• تشخیص بهتر پیوند فعال برای صفحات فرود بخش چندزبانه
• پشتیبانی شورت‌کد کارت از پارامتر اختیاری alt برای تصاویر
• پشتیبانی از تصاویر بسته صفحه در ابرداده OpenGraph
• عرض محتوا اکنون به‌صورت پیش‌فرض ثابت است، با پشتیبانی از بازنویسی متغیر CSS برای چیدمان‌های سفارشی

رفع اشکالات

• جلوگیری از پیشوند پایه دوگانه relref در render-link
• رفع رندر تب‌ها هنگام تودرتوبودن در مراحل
• هم‌راستاسازی ترتیب و برچسب‌های نوار کناری موبایل با menu.main
• رعایت search.enable در نوار کناری
• رعایت پارامتر صفحه toc در منوی بازشو موبایل
• بهبود برجسته‌سازی تطبیق FlexSearch و دستکاری امن DOM
• رفع موقعیت زیرعنوان کارت
• مدیریت اسلش‌های ابتدایی در مسیرهای تصویر OG برای استقرارهای زیرمسیر
• رفع بازگرداندن صفحات نتیجه کمتر از حد انتظار توسط FlexSearch
• تغییر فایل پیش‌فرض Umami analytics به script.js
• رفع جستجوی نویسنده RSS برای Hugo v0.156.0+ (.Site.Params.Author)

مستندات و بومی‌سازی

• افزودن بومی‌سازی ایتالیایی
• پیوند مستندات KaTeX
• به‌روزرسانی مستندات شورت‌کد details به نحو angle bracket

مشارکت‌کنندگان

این انتشار با مشارکت ۱۱ مشارکت‌کننده جدید ممکن شد:

• @ghac101 - رفع Umami analytics، غیرفعال‌سازی ناوبری قبلی/بعدی
• @pmarrapese - پشتیبانی از ویژگی‌های Markdown برای سرتیترها
• @Bubbler-4 - مستندات شورت‌کد details
• @bloovis - رفع تعداد نتایج FlexSearch
• @AntoninPvr - رفع موقعیت زیرعنوان کارت
• @illia-v - رفع TOC موبایل و کلید تغییر جستجو
• @gallochri - بومی‌سازی ایتالیایی
• @MatheusFlausino - حذف از LLMs.txt
• @daniseijo - قابلیت آخرین نویسنده ویرایش‌کننده
• @confusedkernel - صفحه آرشیو
• @Fenyutanchan - رفع سازگاری نویسنده RSS با Hugo v0.156.0

همچنین از مشارکت‌کنندگان بازگشته @KStocky، @ldez، @kowyo، @torbjornbp، @yuri1969 و @PrintN بابت مشارکت‌های مداوم‌شان سپاسگزاریم.

تغییرات کامل: https://github.com/imfing/hextra/compare/v0.11.1...v0.12.0