بداية سريعة

تأخذك هذه الصفحة من الصفر إلى مشروع محفوظ على حاسوبك ومنشور على Zaryn. لا تحتاج إلى معرفة git أو أي أداة أخرى للتحكم في الإصدارات. كل خطوة تشرح ما يفعله الأمر ولماذا. > **ما التحكم في الإصدارات؟** أداة تتذكر كل نسخة محفوظة من مشروعك. يمكنك أن ترى ما الذي تغيّر، وأن تعود إلى نسخة أقدم، وأن تجرّب أفكارًا جانبية دون أن تفسد شيئًا، وأن تعمل مع آخرين على الملفات نفسها. zev هو أداة التحكم في الإصدارات، وZaryn هو الموقع الذي تعيش فيه مشاريعك على الإنترنت. ## 1. ثبّت zev على **لينكس أو macOS**، افتح الطرفية وشغّل: ```bash curl -fsSL https://zaryn.xyz/install.sh | sh ``` على **ويندوز**، افتح PowerShell وشغّل: ```powershell irm https://zaryn.xyz/install.ps1 | iex ``` تحقّق من نجاح التثبيت: ```bash zev --version ``` يجب أن ترى شيئًا مثل `zev 0.3.0 (x86_64-linux)`. طرق أخرى مثل apt وdnf وpacman موجودة في صفحة [التثبيت](/docs/ar/installation). ## 2. أنشئ مشروعًا اذهب إلى مجلد مشروعك (أو أنشئ مجلدًا جديدًا) وحوّله إلى مستودع zev: ```bash mkdir my-project cd my-project zev init ``` ينشئ `zev init` مجلدًا مخفيًا اسمه `.zev`، وفيه يحفظ zev السجل. ملفاتك تبقى كما هي تمامًا. أخبر zev من أنت. يظهر اسمك على كل إيداع (commit) تنشئه: ```bash zev config set user.name "اسمك" zev config set user.email "you@example.com" ``` ## 3. احفظ نسختك الأولى أنشئ ملفًا، أو استخدم ملفاتك الموجودة: ```bash echo "# مشروعي" > README.md ``` حفظ نسخة يتم على خطوتين: ```bash zev add . zev commit -m "النسخة الأولى" ``` - `zev add .` يختار **ما الذي** يدخل في الحفظ التالي. النقطة تعني «كل شيء في هذا المجلد». يُسمّى هذا *التجهيز* (staging). - `zev commit -m "..."` **يحفظ** ما جهّزته، مع رسالة قصيرة عمّا فعلت. كل حفظ يُسمّى *إيداعًا* (commit). لماذا خطوتان؟ لأنك كثيرًا ما تغيّر ملفات عدة لكنك تريد حفظ بعضها فقط معًا. `zev add` يتيح لك الاختيار. ## 4. غيّر شيئًا وانظر إلى الفرق عدّل `README.md`، ثم اسأل zev عمّا تغيّر: ```bash zev status ``` يعرض `zev status` الملفات التي غيّرتها، والملفات التي جهّزتها، والملفات الجديدة التي لا يتتبعها zev بعد. وكل قسم من مخرجاته يخبرك بالأمر التالي. لرؤية الأسطر التي تغيّرت بالضبط: ```bash zev diff ``` الأسطر التي تبدأ بـ `+` أُضيفت، والتي تبدأ بـ `-` حُذفت. عندما تكون راضيًا، احفظ مرة أخرى: ```bash zev add README.md zev commit -m "وصف المشروع" ``` جميع ما حفظته حتى الآن: ```bash zev log --oneline ``` ## 5. شاركه على Zaryn أنشئ حسابك من الطرفية. يرسل لك zev رمزًا من 6 أرقام لتأكيد بريدك: ```bash zev login zaryn.xyz --register your-username --email you@example.com ``` اكتب الرمز عندما يطلبه zev. تسجيل الدخول مرة واحدة لكل حاسوب، وكل المشاريع عليه تستخدمه. أنشأت حسابًا على موقع [zaryn.xyz](https://zaryn.xyz) من قبل؟ إذن سجّل الدخول عبر متصفحك: ```bash zev login zaryn.xyz --device ``` يعرض zev رابطًا ورمزًا قصيرًا. افتح الرابط، وتأكد من تطابق الرمز، ووافق. الآن أنشئ المشروع على Zaryn وأرسل إيداعاتك إليه: ```bash zev new zev push ``` يسألك `zev new` عن الاسم، ونوع المشروع، وهل هو عام أم خاص، والترخيص. ينشئ المستودع على Zaryn ويتذكره باسم `origin`، أي المكان الافتراضي للإرسال. و`zev push` يرسل إيداعاتك. افتح `https://zaryn.xyz/your-username/the-name` لتراها. ## الدورة اليومية في معظم الأيام تحتاج إلى هذه الأوامر الخمسة فقط: ```bash zev status # ما الذي تغيّر؟ zev diff # كيف بالضبط؟ zev add . # اختر ما ستحفظه zev commit -m "ما فعلته" # احفظه zev push # شاركه ``` عندما تعمل مع آخرين، شغّل `zev pull` أولًا لتحصل على آخر تغييراتهم. ## إلى أين بعد ذلك - [مستودعك الأول خطوة بخطوة](/docs/ar/first-repository): الأفكار نفسها بتفصيل أكبر، بما في ذلك التراجع عن الأخطاء. - [كيف أفعل…؟](/docs/ar/how-do-i): إجابات قصيرة للمهام الشائعة («التراجع عن تغيير»، «حذف ملف»، «العمل على فرع»). - [كل الأوامر](/docs/ar/commands): كل أوامر zev، والأوامر اليومية أولًا. - عالق؟ راجع [عندما لا يعمل شيء](/docs/ar/troubleshooting)، أو اضغط `/` في أي صفحة من التوثيق للبحث.