اعضای جامعه ی کاربری شیرازلاگ تصمیم گرفتند تا توسعه سایت را به فراماگیت و سرویس صفحات آن منتقل کنند.
برخی از این نیاز‌ها عبارت‌اند از:
- آسانی در مشارکت همگانی
- انعطاف پذیری و کنترل بالا در توسعه
- مزایای استفاده از یک سیستم مدیریت نسخه مانند گیت(git)
این پروژه به لطف همهٔ کسانی توسعه داده شده است که به صورت داوطلبانه و بدون دریافت هیچگونه هزینه‌ای، به اشتراک دانش و خلاقیت خود پرداخته‌اند. شما هم می‌توانید به توسعه این سایت کمک کنید و در فهرست توسعه دهندگان قرار بگیرید.
فهرست مطالب
برای کار کردن بر روی این پروژه از طریق کامپیوتر شخصی، کافی است مراحل زیر را دنبال کنید:
- وارد حساب کاربری خود در github.com شوید، یا ثبت نام کنید.
- از این پروژه با عمل
Forkیک نسخه در حساب کاربری خودتان ایجاد کنید. - با استفاده از دستور زیر یک نسخه از پروژه را به همراه ساب ماژول‌های به کار رفته در آن، در کامپیوتر شخصی خود ذخیره کنید. دقت داشته باشید که در دستور زیر به جای عبارت
USERNAME، نام‌کاربری خودتان که در فراماگیت ساختید را قرار دهید.
git clone --recursive git@github.com:USERNAME/shirazlug.github.io.git
- آخرین نسخه از هیوگو (hugo) را از طریق این آموزش نصب کنید. برای اطمینان از اینکه hugo را نصب کردید و دسترسی در ترمینال دارید، در خط فرمان وارد کنید:
hugo version
باید در خروجی شبیه به این به شما نشان دهد:
hugo v0.120.1+extended linux/amd64 BuildDate=unknown
- برای اجرا کردن به صورت محلی دستور زیر را وارد کنید:
hugo server -D
بعد از اجرای دستور بالا، برای باز کردن وب‌سایت به صورت محلی در مرورگر خود آدرس http://localhost:1313 را باز کنید.
در صورتی که در حین اجرا خطای ساب‌ماژول یا پوسته را داد در دایرکتوری themes برید و این را اجرا کنید که پوسته مد نظر را دریافت کند و بعد دوباره مرحله ۵ را تکرار کنید:
git submodule add https://github.com/shirazlug/hugo-refresh-rtl.git
- هر گونه تغییرات که مد نظرتان هست به سایت اضافه یا تغییر دهید. «در صورتی که با هیوگو آشنای کمتری دارید از طریق این مستندات می‌توانید، با هیوگو کار کنید.»
- تغییرات خود را با دستور
git addوgit commitبه مخزن محلی خود اضافه کنید. سپس با git pushبه مخزن شخصی خودتان در framagit.org ارسال کنید. - از Fork خودتان یک درخواست ادغام یا merge request به پروژهٔ اصلی شیرازلاگ بفرستید. اگر راهبران شیرازلاگ تغییرات شما را بپذیرند، در مخزن اصلی اعمال خواهند کرد.
صفحات ایستای این پروژه با استفاده از
گیت لب سی آی
تولید شده اند. مراحل اجرایی تعریف شده در فایل
.gitlab-ci.yml
را در ادامه مشاهده می کنید.
image: monachus/hugo
variables:
GIT_SUBMODULE_STRATEGY: recursive
test:
script:
- hugo
except:
- master
pages:
script:
- hugo
artifacts:
paths:
- public
only:
- master