شروع سریع

پس از نصب

پس از نصب و اجرای گیتی‌یار، این مراحل را برای شروع سریع دنبال کنید.

مرحله ۱: دسترسی به گیتی‌یار

مرورگر خود را باز کنید و به آدرس زیر بروید:

http://localhost:3000

یا دامنه پیکربندی‌شده شما.

مرحله ۲: ایجاد حساب ادمین

اگر این یک نصب جدید است:

1. Wizard نصب ظاهر می‌شود
2. جزئیات حساب ادمین را پر کنید:
   • نام کاربری
   • ایمیل
   • رمز عبور
3. راه‌اندازی را تکمیل کنید

مرحله ۳: پیکربندی تنظیمات پایه

تنظیمات برنامه

به پنل ادمین → تنظیمات برنامه بروید:

• نام سایت: نام نمونه گیتی‌یار شما
• مسیر ریشه مخزن: جایی که مخازن ذخیره می‌شوند
• کاربر اجرا: کاربر سیستم که گیتی‌یار را اجرا می‌کند
• دامنه: نام دامنه شما
• URL خارجی: URL عمومی برای نمونه شما

پیکربندی ایمیل (اختیاری)

اعلان‌های ایمیل را فعال کنید:

[mailer]
ENABLED = true
HOST = smtp.example.com:587
FROM = gityar@example.com
USER = gityar@example.com
PASSWD = password

مرحله ۴: ایجاد اولین مخزن

1. روی "+" → "مخزن جدید" کلیک کنید
2. پر کنید:
   • نام مخزن: my-first-project
   • توضیحات: "اولین مخزن گیتی‌یار من"
   • قابلیت مشاهده: عمومی یا خصوصی
3. روی "ایجاد مخزن" کلیک کنید

مرحله ۵: Clone و Push کد

Clone مخزن

git clone http://localhost:3000/username/my-first-project.git
cd my-first-project

افزودن کد شما

# ایجاد فایل‌ها
echo "# پروژه من" > README.md
echo "print('Hello World')" > main.py

# Stage و commit
git add .
git commit -m "commit اولیه"

# Push به گیتی‌یار
git push origin main

مرحله ۶: کاوش ویژگی‌ها

مسائل

اولین مسئله خود را ایجاد کنید:

1. به تب مسائل بروید
2. روی "مسئله جدید" کلیک کنید
3. عنوان: "تنظیم ساختار پروژه"
4. توضیحات: جزئیات را اضافه کنید
5. ارسال

ویکی

مستندات پروژه را اضافه کنید:

1. به تب ویکی بروید
2. روی "ایجاد صفحه اول" کلیک کنید
3. مستندات خود را در Markdown بنویسید
4. ذخیره

وب‌هوک‌ها

گردش کار را خودکار کنید:

1. به تنظیمات → وب‌هوک‌ها بروید
2. روی "افزودن وب‌هوک" کلیک کنید
3. URL و رویدادها را پیکربندی کنید
4. ذخیره

مرحله ۷: دعوت از همکاران

افزودن همکاران

1. به تنظیمات → همکاری بروید
2. کاربران را جستجو کنید
3. سطح دسترسی را تنظیم کنید
4. اضافه کنید

ایجاد سازمان

برای پروژه‌های تیمی:

1. روی "+" → "سازمان جدید" کلیک کنید
2. جزئیات سازمان را پر کنید
3. اعضای تیم را دعوت کنید
4. تیم‌ها با دسترسی‌های مختلف ایجاد کنید

بهترین شیوه‌ها

• ✅ از نام‌های مخزن توصیفی استفاده کنید
• ✅ همیشه فایل README را شامل کنید
• ✅ .gitignore مناسب اضافه کنید
• ✅ برای پروژه‌های متن‌باز لایسنس انتخاب کنید
• ✅ محافظت branch را برای branch های اصلی فعال کنید
• ✅ از مسائل برای ردیابی کار استفاده کنید
• ✅ از درخواست‌های تغییر برای بررسی کد استفاده کنید

مراحل بعدی

• درباره مبانی گیت بیاموزید
• سازمان‌ها را درک کنید
• همکاری تیمی را کاوش کنید
• درباره وب‌هوک‌ها بخوانید