HUGO-BUILD(1) Hugo Manual HUGO-BUILD(1)

hugo-build - ساخت پروژه شما

hugo build [flags]

دستور build دستور اصلی است که برای ساخت پروژه Hugo شما استفاده می‌شود.

هیوگو (Hugo) یک سازنده وب‌سایت ایستا بسیار سریع و منعطف است که با عشق توسط spf13 و دوستان در Go ساخته شده است.

مستندات کامل در https://gohugo.io در دسترس است.

-b, --baseURL="" نام میزبان (و مسیر) به ریشه، مثلاً https://spf13.com

-D, --buildDrafts[=false] شامل کردن محتواهای علامت‌گذاری‌شده به عنوان پیش‌نویس (draft)

-E, --buildExpired[=false] شامل کردن محتواهای منقضی‌شده

-F, --buildFuture[=false] شامل کردن محتواهایی با تاریخ انتشار (publishdate) در آینده

--cacheDir="" مسیر سامانه فایل برای دایرکتوری کَش (cache)

--cleanDestinationDir[=false] حذف فایل‌هایی از مقصد که در دایرکتوری‌های ایستا (static) یافت نمی‌شوند

--clock="" تنظیم ساعت مورد استفاده توسط Hugo، مثلاً ‎--clock 2021-11-06T22:30:00.00+09:00

--config="" فایل پیکربندی (پیش‌فرض hugo.yaml|json|toml است)

--configDir="config" دایرکتوری پیکربندی

-c, --contentDir="" مسیر سامانه فایل برای دایرکتوری محتوا

-d, --destination="" مسیر سامانه فایل برای نوشتن فایل‌ها در آن

--disableKinds=[] غیرفعال کردن انواع مختلف صفحات (home، RSS و غیره)

--enableGitInfo[=false] افزودن اطلاعات بازبینی Git، تاریخ، نویسنده و CODEOWNERS به صفحات

-e, --environment="" محیط ساخت

--forceSyncStatic[=false] کپی تمام فایل‌ها در صورت تغییر محتوای static.

--gc[=false] فعال‌سازی اجرای برخی وظایف پاک‌سازی (حذف فایل‌های کَش استفاده‌نشده) پس از ساخت

-h, --help[=false] راهنمای دستور build

--ignoreCache[=false] نادیده گرفتن کَش‌های فایل پیکربندی‌شده

--ignoreVendorPaths="" نادیده گرفتن هرگونه _vendor برای مسیرهای ماژول منطبق با الگوی Glob داده‌شده

-l, --layoutDir="" مسیر سامانه فایل برای دایرکتوری چیدمان (layout)

--logLevel="" سطح ثبت گزارش (debug|info|warn|error)

--minify[=false] کوچک‌سازی و فشرده‌سازی (minify) تمام قالب‌های خروجی پشتیبانی‌شده (HTML، XML و غیره)

--noBuildLock[=false] عدم ایجاد فایل .hugo_build.lock

--noChmod[=false] عدم همگام‌سازی حالت دسترسی‌ها و مجوزهای (chmod) فایل‌ها

--noTimes[=false] عدم همگام‌سازی زمان آخرین تغییرات فایل‌ها

--panicOnWarning[=false] توقف اضطراری (panic) با ثبت اولین گزارش WARNING

--poll="" تنظیم این گزینه روی یک بازه بررسی متناوب (poll)، مثلاً ‎--poll 700ms، برای استفاده از روش مبتنی بر poll جهت پایش تغییرات سامانه فایل

--printI18nWarnings[=false] چاپ هشدارهای مربوط به ترجمه‌های مفقود

--printMemoryUsage[=false] چاپ دوره‌ای میزان مصرف حافظه در خروجی

--printPathWarnings[=false] چاپ هشدارها در صورت وجود مسیرهای مقصد تکراری و غیره

--printUnusedTemplates[=false] چاپ هشدارها برای قالب‌های (templates) استفاده‌نشده.

--quiet[=false] ساخت در حالت بی‌صدا

--renderSegments=[] قطعه‌های نام‌گذاری‌شده برای رندر (پیکربندی‌شده در بخش segments)

-M, --renderToMemory[=false] رندر در حافظه (بیشتر هنگام اجرای سرور مفید است)

-s, --source="" مسیر سامانه فایل برای خواندن نسبی فایل‌ها از آن

--templateMetrics[=false] نمایش معیارهای آماری درباره اجرای قالب‌ها

--templateMetricsHints[=false] محاسبه نکاتی برای بهینه‌سازی در صورت استفاده همزمان با --templateMetrics

-t, --theme=[] تم‌های مورد استفاده (واقع در /themes/THEMENAME/)

--themesDir="" مسیر سامانه فایل برای دایرکتوری تم‌ها

--trace="" نوشتن اطلاعات ردگیری (trace) در file (به‌طور کلی کاربرد عمومی ندارد)

-w, --watch[=false] پایش سامانه فایل برای تغییرات و بازسازی پروژه در صورت نیاز

hugo(1)

Aug 2026 Hugo 0.165.0