/tehjug.github.io

Official website of TehJUG.org

Primary LanguageHTMLMIT LicenseMIT

درباره‌ی این مخزن

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

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

اگر شما یکی از اعضای تهران‌لاگ هستید، خوشحال می‌شویم در توسعه‌ی این سایت به ما کمک کنید.

راه‌های کمک در توسعه‌ی سایت :

  • گزارش باگ
  • مشارکت در توسعه
  • مشارکت در گرافیک
  • ارائه‌ی پیشنهاد برای گسترش سایت
  • تهییه‌ی مستندات برای بخش‌های مختلف سایت

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

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

Goudarz Amin


فهرست مطالب

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

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

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

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

  1. وارد حساب کاربری خود در github.com شوید، یا ثبت نام کنید.
  2. از این پروژه با عمل Fork یک نسخه در حساب کاربری خودتان ایجاد کنید.
  3. با استفاده از دستور زیر یک نسخه از پروژه را به همراه ساب ماژول‌های به کار رفته در آن، در کامپیوتر شخصی خود ذخیره کنید. دقت داشته باشید که در دستور زیر به جای عبارت USERNAME، نام‌کاربری خودتان که در گیت‌هاب ساختید را قرار دهید.
git clone --recursive git@github.com:USERNAME/TehJUG.github.io.git
  1. آخرین نسخه از هیوگو (hugo) را از طریق این آموزش نصب کنید. برای اطمینان از اینکه hugo را نصب کردید و دسترسی در ترمینال دارید، در خط فرمان وارد کنید:
hugo version

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

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

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

  1. برای اجرا کردن به صورت محلی دستور زیر را وارد کنید:
hugo server -D

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

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

git submodule add https://github.com/shirazlug/hugo-refresh-rtl.git
  1. هر گونه تغییرات که مد نظرتان هست به سایت اضافه یا تغییر دهید. «در صورتی که با هیوگو آشنای کمتری دارید از طریق این مستندات می‌توانید، با هیوگو کار کنید.»
  2. تغییرات خود را با دستور git add و git commit به مخزن محلی خود اضافه کنید. سپس با ‍‍git push به مخزن شخصی خودتان در گیت‌هاب ارسال کنید.
  3. از Fork خودتان یک درخواست ادغام یا pull 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