شروع به کار

شروع سریع با قالب

 imfing/hextra-starter-template

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

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

🌐 نسخه نمایشی ↗

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

دو روش اصلی برای افزودن تم Hextra به پروژه Hugo شما وجود دارد:

1. ماژول‌های Hugo (توصیه شده): ساده‌ترین و توصیه‌شده‌ترین روش. ماژول‌های Hugo به شما امکان می‌دهند تم را مستقیماً از منبع آنلاین آن دریافت کنید. تم به صورت خودکار دانلود شده و توسط Hugo مدیریت می‌شود.

2. زیرماژول Git: به عنوان جایگزین، Hextra را به عنوان یک زیرماژول Git اضافه کنید. تم توسط Git دانلود شده و در پوشه themes پروژه شما ذخیره می‌شود.

راه‌اندازی Hextra به عنوان ماژول Hugo

پیش‌نیازها

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

• Hugo (نسخه extended)
• Git
• Go

مراحل

hugo new site my-site --format=yaml

# راه‌اندازی ماژول Hugo
cd my-site
hugo mod init github.com/username/my-site

# افزودن تم Hextra
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

راه‌اندازی Hextra به عنوان زیرماژول Git

پیش‌نیازها

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

• Hugo (نسخه extended)
• Git

مراحل

hugo new site my-site --format=yaml

cd my-site
git init

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

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

git submodule update --remote

git submodule update --remote themes/hextra

بعدی

برای شروع افزودن محتوای بیشتر، بخش‌های زیر را بررسی کنید: