ec007d73c0
* docs(blog): prepare for v0.10 release post * Update v0.10.md * Update v0.10.md to refine upgrade instructions and enhance blog features. Added synchronized tab switching and pagination controls, while improving the search experience and table of contents navigation. * Enhance v0.10 release documentation with detailed upgrade instructions and migration guide. Added Tailwind theme variable customization section and clarified breaking changes. Improved clarity on CSS class prefix changes for better user experience. * Update v0.10.md to enhance upgrade instructions, clarify breaking changes, and improve overall readability. Adjusted formatting for consistency and added details on asset management and user experience improvements. * Add notable new features to v0.10.md, including dropdown menu support, enhanced search experience, and blog list pagination. Updated FlexSearch upgrade details for clarity and improved migration guide by removing redundant breaking change notes. * chore: update zh-cn translation * chore: update ja translation * chore: update fa and ja translations * chore: prepare release
6.8 KiB
title, weight, tags, next, prev
| title | weight | tags | next | prev | ||
|---|---|---|---|---|---|---|
| شروع به کار | 1 |
|
/docs/guide | /docs |
شروع سریع با قالب
{{< icon "github" >}} imfing/hextra-starter-template
می‌توانید با استفاده از مخزن قالب فوق به سرعت شروع به کار کنید.
ما یک گردش کار GitHub Actions ارائه کرده‌ایم که می‌تواند به صورت خودکار سایت شما را ساخته و در GitHub Pages مستقر کند و به صورت رایگان میزبانی کند. برای گزینه‌های بیشتر، استقرار سایت را بررسی کنید.
شروع به عنوان پروژه جدید
دو روش اصلی برای افزودن تم Hextra به پروژه Hugo شما وجود دارد:
-
ماژول‌های Hugo (توصیه شده): ساده‌ترین و توصیه‌شده‌ترین روش. ماژول‌های Hugo به شما امکان می‌دهند تم را مستقیماً از منبع آنلاین آن دریافت کنید. تم به صورت خودکار دانلود شده و توسط Hugo مدیریت می‌شود.
-
زیرماژول Git: به عنوان جایگزین، Hextra را به عنوان یک زیرماژول Git اضافه کنید. تم توسط Git دانلود شده و در پوشه
themesپروژه شما ذخیره می‌شود.
راه‌اندازی Hextra به عنوان ماژول Hugo
پیش‌نیازها
قبل از شروع، باید نرم‌افزارهای زیر را نصب کرده باشید:
مراحل
{{% steps %}}
راه‌اندازی یک سایت جدید Hugo
hugo new site my-site --format=yaml
پیکربندی تم Hextra از طریق ماژول
# راه‌اندازی ماژول Hugo
cd my-site
hugo mod init github.com/username/my-site
# افزودن تم Hextra
hugo mod get github.com/imfing/hextra
فایل hugo.yaml را برای استفاده از تم Hextra با افزودن موارد زیر پیکربندی کنید:
module:
imports:
- path: github.com/imfing/hextra
ایجاد اولین صفحات محتوای شما
صفحه محتوای جدید برای صفحه اصلی و صفحه مستندات ایجاد کنید:
hugo new content/_index.md
hugo new content/docs/_index.md
پیش‌نمایش سایت به صورت محلی
hugo server --buildDrafts --disableFastRender
تبریک می‌گوییم، پیش‌نمایش سایت جدید شما در http://localhost:1313/ در دسترس است.
{{% /steps %}}
{{% details title="چگونه تم را به‌روزرسانی کنیم؟" %}}
برای به‌روزرسانی تمام ماژول‌های Hugo در پروژه خود به آخرین نسخه‌ها، دستور زیر را اجرا کنید:
hugo mod get -u
برای به‌روزرسانی Hextra به آخرین نسخه منتشر شده، دستور زیر را اجرا کنید:
hugo mod get -u github.com/imfing/hextra
برای جزئیات بیشتر، ماژول‌های Hugo را ببینید.
{{% /details %}}
راه‌اندازی Hextra به عنوان زیرماژول Git
پیش‌نیازها
قبل از شروع، باید نرم‌افزارهای زیر را نصب کرده باشید:
مراحل
{{% steps %}}
راه‌اندازی یک سایت جدید Hugo
hugo new site my-site --format=yaml
افزودن تم Hextra به عنوان زیرماژول Git
به دایرکتوری سایت بروید و یک مخزن Git جدید راه‌اندازی کنید:
cd my-site
git init
سپس، تم Hextra را به عنوان زیرماژول Git اضافه کنید:
git submodule add https://github.com/imfing/hextra.git themes/hextra
فایل hugo.yaml را برای استفاده از تم Hextra با افزودن موارد زیر پیکربندی کنید:
theme: hextra
ایجاد اولین صفحات محتوای شما
صفحه محتوای جدید برای صفحه اصلی و صفحه مستندات ایجاد کنید:
hugo new content/_index.md
hugo new content/docs/_index.md
پیش‌نمایش سایت به صورت محلی
hugo server --buildDrafts --disableFastRender
پیش‌نمایش سایت جدید شما در http://localhost:1313/ در دسترس است.
{{% /steps %}}
هنگام استفاده از CI/CD برای استقرار سایت Hugo، ضروری است که قبل از اجرای دستور hugo، دستور زیر اجرا شود.
git submodule update --init
عدم اجرای این دستور منجر به پر نشدن پوشه تم با فایل‌های تم Hextra شده و باعث شکست ساخت می‌شود.
{{% details title="چگونه تم را به‌روزرسانی کنیم؟" %}}
برای به‌روزرسانی تمام زیرماژول‌های مخزن شما به آخرین کامیت‌ها، دستور زیر را اجرا کنید:
git submodule update --remote
برای به‌روزرسانی Hextra به آخرین کامیت، دستور زیر را اجرا کنید:
git submodule update --remote themes/hextra
برای جزئیات بیشتر، زیرماژول‌های Git را ببینید.
{{% /details %}}
بعدی
برای شروع افزودن محتوای بیشتر، بخش‌های زیر را بررسی کنید:
{{< cards >}} {{< card link="../guide/organize-files" title="سازماندهی فایل‌ها" icon="document-duplicate" >}} {{< card link="../guide/configuration" title="پیکربندی" icon="adjustments" >}} {{< card link="../guide/markdown" title="Markdown" icon="markdown" >}} {{< /cards >}}