-
Notifications
You must be signed in to change notification settings - Fork 4
مشارکت
برای ساخت وب سایت از Hugo که یک static site generator است استفاده شده، و محتوای مطالب آن در فایل های markdown نگه داری می‌شود.
همچنین برای ایجاد فرمول های ریاضی از Latex استفاده شده.
لطفا بعد از خواندن این ویکی در صورت وجود هر شبه ای یا مشکلی برای انجام تغییرات و یا ارسال تغییرات آن را با ما در میان بگذارید.
برای هماهنگی بین مشارکت کنندگان و ارتباط بهتر لطفا به آدرس ایمیل زیر درخواست عضویت به گروه اسلک مشارکت کنندگان را بفرستید:
mehrdad.mohammadian.contact@gmail.com
در حال حاضر الویت های مشارکت موارد زیر هستند، لطفا بر اساس الویت کار ها مشارکت کنید:
- ترجمه قسمت شروع به کار
- ترجمه راهنمای کاربر
- بهبود ظاهری وب سایت
- ساخت مطالب آموزشی
در قدم اول برای مشارکت باید اقدام به راه اندازی وب سایت بر روی سیستم شخصی خود کنید، لطفا مراحل زیر را انجام دهید:
- نصب Hugo برای سیستم عامل مورد نظر خود:
https://gohugo.io/getting-started/installing
- ایجاد یک fork از این ریپو، و سپس clone کردن آن.
- اجرای وب سایت:
دستور زیر را در پوشه اصلی پروژه اجرا کنید.
hugo serve
سپس برای مشاهده وب سایت در سیستم خودتان در مرورگر به آدرس زیر بروید:
http://localhost:1313
احیانا اگر بعد از انجام تغییرات، تغییر خود را در آدرس http://localhost:1313 مشاهده نکردید یک بار اجرای وب سایت را متوقف و دوباره آن را اجرا کنید، و یا از دستور زیر برای اجرا کردن وب سایت استفاده کنید:
hugo serve --disableFastRender
بعد از راه اندازی به ویرایش مطالب می‌پردازیم:
تمامی مطالب وب سایت که در فایل های md. قرار دارند
در پوشه content هستند،
بسته به اینکه قصد ویرایش کدام مطلب را دارید پوشه مورد نظر را در آن انتخاب کنید و سپس فایل مورد نظر را برای ویرایش باز کنید.
اگر فایل مورد نظر شما از قبل وجود دارد شروع به نوشتن و ویرایش کردن در فایل کنید، و نیازی به تغییر قسمت بالایی فایل که شامل عنوان و زمان ساخت فایل و غیره است نیست.
ولی اگر فایل شما موحود نمی‌باشد به صورت زیر عمل کنید:
دستور زیر را در پوشه اصلی در ترمینال اجرا کنید،
قسمت purpose_directory اسم پوشه مورد نظر شما است که می‌خواهید فایل جدید درآن جا باشد،
و name_of_file نیز اسم فایل است.
نکته:
اگر در حال ساخت یک پوشه کاملا جدید هستید، یعنی بخش جدیدی به وب سایت اضافه می‌کنید، باید در آن پوشه جدید ابتدا با استفاده از دستور زیر فایلی به اسم index.fa.mdـ بسازید،
و شبیه به بقیه پوشه ها آن را ویرایش کنید.
hugo new purpose_directory/name_of_file.md
مثلا:
hugo new week1/what-is-ml.md
hugo new new/_index.fa.md
نکته: اگر بعد از مشاهده سایر مطالب از قبل ایجاد شده و مثال ها هنوز در ویرایش مطالب مشکلی دارید لطفا از طریق راه های ارتباطی بپرسید.
بعد از انجام ویرایش مطالب شروع به فرستادن تغییرات کنید:
برای ارسال تغییرات بعد از commit کردن ویرایش های خود در ریپو ای که fork کردید، نیاز به ساخت یک pull request دارید. به این قسمت بروید و درخواست خود را با یک عنوان مناسب و توضیحات مربوطه ایحاد کنید.
بعد از بررسی تغییرات شما اعمال خواهد شد.
ممنون!