داستان ما

اعضای جامعه ی کاربری شیرازلاگ تصمیم گرفتند تا توسعه سایت را به فراماگیت و سرویس صفحات آن منتقل کنند.

برخی از این نیاز‌ها عبارت‌اند از:

• آسانی در مشارکت همگانی
• انعطاف پذیری و کنترل بالا در توسعه
• مزایای استفاده از یک سیستم مدیریت نسخه مانند گیت(git)

---

توسعه‌دهندگان سایت

این پروژه به لطف همهٔ کسانی توسعه داده شده است که به صورت داوطلبانه و بدون دریافت هیچگونه هزینه‌ای، به اشتراک دانش و خلاقیت خود پرداخته‌اند. شما هم می‌توانید به توسعه این سایت کمک کنید و در فهرست توسعه دهندگان قرار بگیرید.

---

<!-- START doctoc generated TOC please keep comment here to allow auto update --> <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->

فهرست مطالب

1. چگونه می‌توانید کمک کنید؟
2. سرویس گیت‌لب سی‌آی

<!-- END doctoc generated TOC please keep comment here to allow auto update -->

۱- چگونه می‌توانید کمک کنید؟

نحوه کار با پروژه بر روی کامپیوتر شخصی

برای کار کردن بر روی این پروژه از طریق کامپیوتر شخصی، کافی است مراحل زیر را دنبال کنید:

1. وارد حساب کاربری خود در github.com شوید، یا ثبت نام کنید.
2. از این پروژه با عمل Fork یک نسخه در حساب کاربری خودتان ایجاد کنید.
3. با استفاده از دستور زیر یک نسخه از پروژه را به همراه ساب ماژول‌های به کار رفته در آن، در کامپیوتر شخصی خود ذخیره کنید. دقت داشته باشید که در دستور زیر به جای عبارت USERNAME، نام‌کاربری خودتان که در فراماگیت ساختید را قرار دهید.

git clone --recursive git@github.com:USERNAME/shirazlug.github.io.git

4. آخرین نسخه از هیوگو (hugo) را از طریق این آموزش نصب کنید. برای اطمینان از اینکه hugo را نصب کردید و دسترسی در ترمینال دارید، در خط فرمان وارد کنید:

hugo version

باید در خروجی شبیه به این به شما نشان دهد:

hugo v0.120.1+extended linux/amd64 BuildDate=unknown

پیش‌نمایش وب‌سایت

5. برای اجرا کردن به صورت محلی دستور زیر را وارد کنید:

hugo server -D

بعد از اجرای دستور بالا، برای باز کردن وب‌سایت به صورت محلی در مرورگر خود آدرس http://localhost:1313 را باز کنید.

در صورتی که در حین اجرا خطای ساب‌ماژول یا پوسته را داد در دایرکتوری themes برید و این را اجرا کنید که پوسته مد نظر را دریافت کند و بعد دوباره مرحله ۵ را تکرار کنید:

git submodule add https://github.com/shirazlug/hugo-refresh-rtl.git

6. هر گونه تغییرات که مد نظرتان هست به سایت اضافه یا تغییر دهید. «در صورتی که با هیوگو آشنای کمتری دارید از طریق این مستندات می‌توانید، با هیوگو کار کنید.»
7. تغییرات خود را با دستور git add و git commit به مخزن محلی خود اضافه کنید. سپس با ‍‍git push به مخزن شخصی خودتان در framagit.org ارسال کنید.
8. از 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