شروع کنید

شروع سریع از طریق Template

 imfing/hextra-starter-template

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

ما یک گردش کاری GitHub Actions ارائه کرده‌ایم که می‌تواند به ساخت و به‌کاراندازی خودکار سایت شما در گیت‌هاب Pages، برای میزبانی رایگان کمک کند. برای گزینه‌های بیشتر، به‌کاراندازی سایت را بررسی کنید.

🌐 نسخه‌ي نمایشی ↖

شروع به عنوان پروژه جدید

دو راه اصلی برای اضافه کردن تم هگزترا به پروژه Hugo وجود دارد:

1. ماژول‌های Hugo (توصیه می‌شود): ساده‌ترین و توصیه شده‌ترین. ماژول‌های Hugo به شما امکان می‌دهند تم را مستقیما از منبع آنلاین آن وارد کنید. تم به صورت خودکار دانلود و توسط Hugo مدیریت می‌شود.
2. ساب‌ماژول گیت: در عوض، هگزترا را به عنوان یک ساب‌ماژول گیت اضافه کنید. تم توسط گیت دانلود شده و در پوشه themes پروژه شما ذخیره می‌شود.

هگزترا را به عنوان ماژول Hugo راه‌اندازی کنید

پیش‌نیازها

قبل از شروع، باید این نرم‌افزارها را نصب کنید:

• Hugo (extended version)
• Git
• Go

مراحل

hugo new site my-site --format=yaml

# مقداردهی اولیه ماژول هیوگو
cd my-site
hugo mod init github.com/username/my-site

# افزودن تم هگزترا
hugo mod get github.com/imfing/hextra

module:
  imports:
    - path: github.com/imfing/hextra

hugo new content/_index.md
hugo new content/docs/_index.md

hugo server --buildDrafts --disableFastRender

hugo mod get -u

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

هگزترا را به عنوان ساب‌ماژول Git راه‌اندازی کنید

پیش‌نیازها

قبل از شروع، باید این نرم‌افزارها را نصب کنید:

• Hugo (extended version)
• Git

مراحل

hugo new site my-site --format=yaml

git submodule add https://github.com/imfing/hextra.git themes/hextra

theme: hextra

hugo new content/_index.md
hugo new content/docs/_index.md

hugo server --buildDrafts --disableFastRender

هنگام استفاده از CI/CD برای به‌کاراندازی وب‌سایت Hugo، از اجرای دستور زیر قبل از اجرای دستور hugo مطمئن شوید و ضروری است.

git submodule update --init

اجرا نشدن این دستور باعث می‌شود که پوشه تم با پرونده‌های تم هگزترا پر نشود و منجر به خرابی ساخت شود.

git submodule update --remote

git submodule update --remote themes/hextra

بعدی

برای شروع اضافه کردن مطالب بیشتر، بخش‌های زیر را کاوش کنید: