چگونه یک سایت هوگو بسازیم و میزبانی کنیم

Hugo یک مولد سایت استاتیک است که برای اولین بار در سال 2013 راه اندازی شد. در حالی که بسیاری از مولدهای سایت استاتیک در Node.js ساخته شده اند، Hugo با استفاده از Go ساخته شده است. پروژه منبع باز در طول سال ها مورد توجه زیادی قرار گرفته است و در حال حاضر بیش از 77000 ستاره در Github دارد.

امروز، ما قصد داریم یک سایت هوگو را با استفاده از Orbiter بسازیم و میزبانی کنیم. Orbiter سریعترین و ساده ترین راه برای آنلاین کردن وب سایت های ثابت است.

شروع به کار

از آنجایی که ما قصد داریم یک سایت با استفاده از Hugo بسازیم و آن را با استفاده از Orbiter میزبانی خواهیم کرد، به چند چیز نیاز دارید:

1. یک حساب کاربری رایگان در Orbiter. شما می توانید در اینجا ثبت نام کنید.

2. Hugo را نصب کنید (همچنین ممکن است نیاز به نصب Homebrew بسته به سیستم عامل خود و نحوه نصب Hugo داشته باشید)

3. یک ویرایشگر کد مانند VSCode یا Zed یا واقعاً هر چیز دیگری
4. Git باید نصب شود (این روی اکثر رایانه ها وجود دارد، اما اگر به آن نیاز داشتید در اینجا یک راهنما وجود دارد)

همین! اکنون، می توانیم وارد ساخت سایت Hugo خود شویم. با فرض اینکه شما قبلا Hugo را نصب کرده اید، بیایید برنامه ترمینال را در رایانه خود باز کنیم و به پوشه ای که پروژه های خود را در آن نگهداری می کنیم بروید.

دستور زیر را برای مقداردهی اولیه پروژه Hugo جدید اجرا کنید:

hugo new site hugo-orbiter

شما می توانید سایت خود را هر چه که می خواهید تماس بگیرید. به مال خودم زنگ زدم hugo-orbiter.

اکنون، باید به فهرست پروژه جدید تبدیل شویم. این دستور را اجرا کنید:

cd hugo-orbiter

اکنون باید یک تم Hugo نصب کنیم. همانطور که در راهنمای شروع سریع Hugo توصیه شده است، از زیر ماژول های Git برای انجام این کار استفاده می کنیم. بنابراین، دستور زیر را اجرا کنید:

git init

سپس اجرا کنید:

git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke

اکنون باید به هوگو بگوییم که از آن تم استفاده کند. با این دستور می توانیم این کار را انجام دهیم:

echo "theme="ananke"" >> hugo.toml

برای دیدن سایت خود، باید یک سرور محلی Hugo را اجرا کنیم. با این دستور می توانید این کار را انجام دهید:

hugo server

سایت در مرورگر در دسترس خواهد بود http://localhost:1313. این یک شروع است، اما ما می خواهیم قبل از میزبانی سایت خود، مقداری محتوا اضافه کنیم. برای انجام این کار، می توانید از Hugo برای ایجاد داربست علامت گذاری یک پست وبلاگ مانند این استفاده کنید:

hugo new content content/posts/my-first-post.md

با این کار یک پست علامت گذاری در قسمت ایجاد می شود content پوشه پروژه شما برای مشاهده این، پروژه را در ویرایشگر کد انتخابی خود باز کنید. را باز کنید content پوشه، و شما یک را خواهید دید posts پوشه داخل در داخل آن، فایل علامت گذاری را خواهید دید. در حال حاضر، چیز زیادی در فایل وجود ندارد، اما ما می توانیم آن را تغییر دهیم.

فایل علامت گذاری خود را به شکل زیر به روز کنید:

+++
date = '2025-01-20T15:32:29-06:00'
draft = false
title = 'My First Post'
+++

## Hello, Orbiter!

This is a simple example post that will be part of my Hugo site. It will be hosted on [Orbiter](https://orbiter.host). 

حال باید به هوگو بگوییم که سایت را با فایل های جدید بسازد. اگر سرور Hugo شما هنوز در حال اجرا است، می توانید آن را متوقف کنید crtl + c. سپس این دستور را اجرا کنید:

hugo server -D

اکنون، وقتی در مرورگر از سایت بازدید می کنید، باید پست خود را ببینید و می توانید روی دکمه ادامه مطلب کلیک کنید. باید چیزی شبیه این باشد:

ما اصول یک سایت را داریم. بیایید اکنون میزبانی آن را در Orbiter ببینیم.

میزبانی سایت

میزبانی یک سایت هوگو در Orbiter به سادگی آپلود فایل است. بیایید ابتدا مطمئن شویم که فایل های مناسبی برای آپلود داریم. سرور محلی Hugo را خاموش کنید و این دستور را اجرا کنید:

hugo

با این کار سایت شما ساخته می شود و صفحات استاتیک در پوشه ای به نام خروجی می شود public. این پوشه ای است که برای آپلود در Orbiter استفاده می کنیم.

وارد حساب Orbiter خود شوید و روی دکمه آپلود سایت کلیک کنید. پوشه عمومی خود را به مدال بکشید یا روی دکمه Select Folder کلیک کنید سپس پوشه عمومی خود را انتخاب کنید. به سایت خود یک زیر دامنه بدهید و روی ایجاد کلیک کنید.

در عرض چند ثانیه، سایت شما آنلاین و آماده برای اشتراک گذاری با جهان خواهد شد! اگر ترجیح می دهید در سطح خط فرمان کار کنید، می توانید از Orbiter CLI نیز استفاده کنید. اسناد را می توان در اینجا یافت.

و بس. شما سایت Hugo خود را تنها با چند کلیک در Orbiter میزبانی کرده اید و تنها چند ثانیه برای انجام آن وقت صرف کرده اید. به روز رسانی سایت شما به همین سادگی است. روی نماد چرخ دنده در کنار سایت خود کلیک کنید، به روز رسانی سایت را انتخاب کنید و سپس نسخه جدیدی از سایت را آپلود کنید. public پوشه

نتیجه گیری

هوگو یکی از محبوب ترین مولدهای سایت استاتیک در بازار است. میزبانی سایت های Hugo شما می تواند به سادگی یک آپلود باشد. در عرض چند ثانیه از سایت تولید شده به سایت میزبانی شده بروید. همین امروز شروع کنید!