.nh
.TH "HUGO-BUILD" "1" "Aug 2026" "Hugo 0.165.0" "Hugo Manual"

.SH "نام (NAME)"
hugo-build \- ساخت پروژه شما


.SH "خلاصه دستور (SYNOPSIS)"
\fBhugo build [flags]\fP


.SH "توضیحات (DESCRIPTION)"
دستور build دستور اصلی است که برای ساخت پروژه Hugo شما استفاده می‌شود.

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

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


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

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

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

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

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

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

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

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

.PP
\fB--configDir\fP="config"
	دایرکتوری پیکربندی

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

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

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

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

.PP
\fB-e\fP, \fB--environment\fP=""
	محیط ساخت

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

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

.PP
\fB-h\fP, \fB--help\fP[=false]
	راهنمای دستور build

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

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

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

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

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

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

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

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

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

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

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

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

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

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

.PP
\fB--quiet\fP[=false]
	ساخت در حالت بی‌صدا

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

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

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

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

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

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

.PP
\fB--themesDir\fP=""
	مسیر سامانه فایل برای دایرکتوری تم‌ها

.PP
\fB--trace\fP=""
	نوشتن اطلاعات ردگیری (trace) در \fBfile\fR (به‌طور کلی کاربرد عمومی ندارد)

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


.SH "همچنین ببینید (SEE ALSO)"
\fBhugo(1)\fP