نگاهی بر سایت‌ساز Hugo

Hugo یک سایت‌ساز استاتیک است. برخلاف سیستم‌های دیگه که به صورت داینامیک با هر بازدید کاربر یک صفحه ایجاد می‌کنند, هوگو صفحه را وقتی شما محتوا را تولید می‌کنید ایجاد می‌کند. سایت‌هایی که توسط هوگو ساخته می‌شوند سریع‌تر و بسیار امن‌تر هستند. سایت‌های ساخته‌شده با هوگو می‌توانند در هر جایی میزبانی شوند, مانند صفحات گیت هاب, هروکو و…
سایت‌های ایجاد شده توسط هوگو بدون هیچ وابستگی به یک اجراگر مانند Ruby, Python و یا PHP و بدون وابستگی به یک پایگاه‌داده اجرا می‌شوند.

نصب هوگو

برای نصب هوگو کافی است به صفحه انتشار آن در گیت‌هاب رفته و نسخه باینری مرتبط با سیستم عامل خود را دانلود و نصب کنید.

برای نصب هوگو از طریق سورس کد شما به Git و Go ورژن 1.5 به بالا نیاز دارید. بعد از نصب این پیش‌نیازها کافی است این دستور را اجرا کنید:

استفاده از هوگو

بعد از نصب هوگو, برای ایجاد یک وب‌سایت جدید دستور زیر را اجرا کنید:

به جای SiteName نام سایتی که می‌خواهید ایجاد کنید را بنویسید. بعد از ایجاد سایت توسط هوگو به داخل پوشه‌ای که ایجاد شده بروید.
حال وقت آن است که یک مطلب جدید به سایت اضافه کنیم, برای اینکار دستور زیر را اجرا کنید:

در اینجا هم به حای post-name نام مطلبی که می‌خواهید بنویسید را وارد کنید. توجه داشته باشید حتما بعد نام, فرمت .md نوشته شده باشد.
این دستور در پوشه content یک پوشه به نام post ایجاد میکند و فایل مطلب را در آن ایجاد می‌کند.

داخل فایل دستوراتی مانند این می‌بینید:

این دستورات مشخصات مطلب شما هستند. date تاریخ ایجاد مطلب, draft نشان‌دهنده پیش‌نویس بودن مطلب و title هم عنوان مطلب هست.
برای نوشتن مطلب کافی است زیر +++ دوم شروع به نوشتن کنید.
هوگو از فرمت Markdown استفاده می‌کند. برای آشنایی با این فرمت می‌توانید از این وبسایت استفاده کنید.

نمایش محتوا

بعد از ایجاد سایت و نوشتن یک مطلب, نوبت نمایش محتوا می‌رسد. برای اینکار دستور زیر را اجرا کنید:

با اجرای این دستور, نتیجه‌ای مانند زیر می‌بینید:

با توجه به نتیجه, می‌بینید که وب سایت بر روی پورت 1313 می‌باشد. به آدرس http://localhost:1313 بروید تا نتیجه را ببینید.
چیز خاصی نمایش داده نمی‌شود. دو دلیل وجود دارد:

1- مطلبی که ایجاد کردیم به صورت پیش‌نویس بوده است. برای اینکه مطالب نشان داده شوند باید موقع اجرا دستور فلگ buildDrafts را به دستور بدهیم.

2- هیچ تمی برای وب سایت تایین نکرده‌ایم.

برای گزینه اول دستور را به این حالت اجرا کنید:

حال می‌بینید که در نتیجه داده شده 1 صفحه ایجاد شده است.

افزودن تم

برای پیدا کردن تم‌های اوپن سورس هوگو می‌توانید به این صفحه بروید.

بعد از انتخاب تم مورد نظر, به داخل پوشه themes در جایی که سایت خود را ایجاد کرده اید بروید. (نکته: در صورت عدم وجود این پوشه آن را ایجاد کنید)

بعد از رفتن به این پوشه, تم مورد نظر را با استفاده از git کلون کنید. برای مثال برای اضافه کردن تم robust این دستور را بزنید:

حال به پوشه اصلی سایت برگردید و دستور hugo server را به شیوه زیر اجرا کنید:

تنظیمات سایت

با اجرا دستور قبلی خواهید دید که سایت با یک سری اطلاعات پیش‌فرض نمایش داده می‌شود. برای تغییر این مشخصات فایل SiteName/config.toml را باز کنید و مشخصات دلخواه خود را وارد کنید.
برای مثال محتوای فایل تنظیمات به این شکل می‌باشد:

نمایش پست‌ها

تا این لحظه پست‌های ما به صورت پیش‌نویس بوده‌اند, برای این که یک پست را از حالت پیش‌نویس خارج کنید باید دستور زیر را اجرا کنید:

در اینجا نیز باید post-name را به نام مطلب تغییر دهید.

خروجی‌گرفتن از سایت

برای خروجی گرفتن از سایت کافی است دستور زیر را اجرا کنید:

توجه داشته باشید که اگر از تم دیگری استفاده می‌کنید باید در دستور تغییر ایجاد کرده و نام تم خود را وارد کنید.
با اجرای این دستور در پوشه SiteName/public فایل‌ها ساخته خواهند شد. کافی است این فایل‌ها را به سرویس میزبانی مورد نظر خود انتقال دهید.

میزبانی در صفحات گیت‌هاب(دلخواه)

برای میزبانی سایت خود در صفحات گیت‌هاب کافی است baseURL سایت را به آدرس صفحه گیت‌هابی خود تغییر دهید. برای تغییر آن به فایل تنظیمات (SiteName/config.toml) بروید.

حال دستورات زیر را اجرا کنید تا سایت خود را بتوانید با گیت کنترل کنید:

بعد از اجرای این دستورات به داخل پوشه public رفته و دستورات زیر را اجرا کنید:

حال فایل ها را کامیت کرده و به مخزن گیت‌هابی که ایجاد کرده‌اید پوش کنید:

حال با رفتن به آدرس صفحه گیت‌هاب, می‌توانید سایت خود را مشاهده کنید.

 

منبع: +

عرفان بشارت

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

همچنین ممکن است دوست داشته باشید ...

۲ واکنش

  1. mahm0ud گفت:

    خیلی عالی بود عرفان جان، داکیومنت فارسی برای استاتیک جنریتور ها کمه که امیدوارم با همکاری دوستان بیشتر بشه

  2. یاشار گفت:

    سلام. خیلی عالی بود. اگر ممکنه در مطلبی کمی بیشتر درباره امکانات Hugo توضیح بدین. و اینکه برای افراد عادی چطور می تونه کمک کنه.

پاسخ دهید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *