نام (NAME)

hugo-server - راه‌اندازی وب‌سرور توکار

خلاصه دستور (SYNOPSIS)

hugo server [command] [flags]

توضیحات (DESCRIPTION)

ابزار Hugo وب‌سرور اختصاصی خود را ارائه می‌دهد که پروژه را می‌سازد و سرویس‌دهی می‌کند. اگرچه hugo server عملکرد بسیار بالایی دارد، اما یک وب‌سرور با گزینه‌های محدود است.

دستور hugo server به طور پیش‌فرض فایل‌ها را روی دیسک می‌نویسد و از آنجا سرویس‌دهی می‌کند، اما می‌توانید با استفاده از فلگ --renderToMemory محتوا را در حافظه رندر کنید. این کار در برخی موارد ممکن است سریع‌تر باشد، اما حافظه بیشتری مصرف خواهد کرد.

همچنین به طور پیش‌فرض، Hugo تغییرات فایل‌های شما را زیر نظر می‌گیرد و به صورت خودکار پروژه را مجدداً می‌سازد. سپس صفحات باز مرورگر را به صورت زنده بازنشانی (live reload) کرده و آخرین محتوا را به آن‌ها ارسال می‌کند. از آنجا که ساخت بیشتر پروژه‌های Hugo در کسری از ثانیه انجام می‌شود، شما قادر خواهید بود بلافاصله پس از ذخیره فایل‌ها تغییرات خود را مشاهده کنید.

گزینه‌ها (OPTIONS)

--appendPort[=true] افزودن پورت به baseURL

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

--bind="127.0.0.1" رابط شبکه‌ای که سرور به آن متصل می‌شود

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

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

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

--cacheDir="" مسیر سیستم‌فایل به دایرکتوری حافظه موقت (کش)

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

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

--disableBrowserError[=false] عدم نمایش خطاهای ساخت در مرورگر

--disableFastRender[=false] فعال‌سازی رندر کامل مجدد هنگام بروز تغییرات

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

--disableLiveReload[=false] نظارت بر تغییرات بدون فعال‌سازی بارگذاری مجدد زنده مرورگر پس از ساخت مجدد

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

--forceSyncStatic[=false] کپی کردن تمام فایل‌ها هنگام تغییر فایل‌های ایستا

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

-h, --help[=false] راهنما برای server

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

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

--liveReloadPort=-1 پورت بارگذاری مجدد زنده (مثلاً 443 در سناریوهای پروکسی HTTPS)

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

-N, --navigateToChanged[=false] هدایت مرورگر به فایل محتوای تغییریافته هنگام بارگذاری مجدد زنده

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

--noHTTPCache[=false] غیرفعال کردن کش مرورگر برای صفحات سرویس‌دهی‌شده توسط وب‌سرور توکار

--noTimes[=false] عدم همگام‌سازی زمان اصلاح فایل‌ها

-O, --openBrowser[=false] باز کردن پروژه در مرورگر پس از راه‌اندازی سرور

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

--poll="" تنظیم بازه زمانی نظارت دوره‌ای، مانند --poll 700ms، برای استفاده از روش مبتنی بر نظارت دوره‌ای جهت تشخیص تغییرات سیستم‌فایل

-p, --port=1313 پورتی که سرور به آن گوش می‌دهد

--pprof[=false] فعال‌سازی سرور پروفایلینگ pprof (پورت 8080)

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

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

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

--printUnusedTemplates[=false] چاپ هشدار درباره الگوهای استفاده‌نشده

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

--renderStaticToDisk[=false] سرویس‌دهی فایل‌های ایستا از دیسک و فایل‌های پویا از حافظه

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

--templateMetricsHints[=false] محاسبه پیشنهادهای بهبود در ترکیب با گزینه --templateMetrics

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

--tlsAuto[=false] تولید و استفاده از گواهی‌های معتبر محلی

--tlsCertFile="" مسیر فایل گواهی TLS

--tlsKeyFile="" مسیر فایل کلید TLS

--trace="" نوشتن ردگیری (trace) در فایل (به طور کلی کاربرد چندانی ندارد)

-w, --watch[=true] نظارت بر سیستم‌فایل برای تغییرات و بازسازی در صورت نیاز

گزینه‌های به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)

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

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

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

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

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

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

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

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

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

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

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

--themesDir="" مسیر سیستم‌فایل به دایرکتوری پوسته‌ها (themes)

همچنین ببینید (SEE ALSO)

hugo(1), hugo-server-trust(1)