# ابدأ باستخدام التعاون المباشر

أضف خادم التعاون الخاص بمجموعتك، وسجّل الدخول، وافتح مشروعًا شاركه معك أحدهم، وأدر خوادمك وأجهزتك.

:::note[التعاون المباشر ميزة في مرحلة تجريبية]
تحتاج إلى Oleafly 0.4.7-rc. نزّله من [صفحة الإصدارات](https://github.com/Oleafly/Oleafly/releases/tag/v0.4.7-rc)، لأن صفحة التنزيل لا تزال تعرض 0.4.6.
:::

للانضمام إلى مشروع مشترك، تحتاج إلى شيئين من الشخص الذي يشغّل خادم مجموعتك: عنوان الخادم، وطريقة للدخول. يضيفك ذلك الشخص بعنوان بريدك الإلكتروني أو باسم تسجيل الدخول أو بنطاق مؤسستك. ويمكن أيضًا لمالك المشروع دعوتك كضيف. وإذا كان مؤلفوك المشاركون يستخدمون خادم Oleafly، `collab.oleafly.com`، فستجد له زرًا في **Add server**.

إذا وصلك بريد إلكتروني من الخادم، فسيحتوي على رابط **Add to Oleafly**. حدده وسيضيف Oleafly الخادم نيابةً عنك. وإلا، فأضفه يدويًا.

## إضافة الخادم

1. افتح **Settings → Collaboration** وحدد **Add server**.
2. أدخل **Server address** الذي حصلت عليه، مثل `collab.example.edu`، وحدد **Continue**. يتحقق Oleafly من الخادم قبل تسجيل دخولك. تحتاج خوادم التعاون إلى عنوان يستخدم https.
3. اختر طريقة تسجيل الدخول. تعتمد الخيارات على ما أعدّه مسؤول الخادم.

لإضافة خادم Oleafly، حدد **Oleafly** في أعلى مربع الحوار، فوق حقل العنوان. يملأ Oleafly العنوان `https://collab.oleafly.com`، ويتحقق منه، ثم ينتقل إلى تسجيل الدخول. يختفي الزر بمجرد أن يصبح ذلك الخادم في قائمتك، ويعود إذا أزلته.

يقدّم مربع الحوار **Share** الاختصار نفسه. فإذا لم تكن قد أضفت أي خادم، فسيحتوي على **Add the Oleafly server**.

## تسجيل الدخول

### عبر مؤسستك أو GitHub

حدد **Continue with** ثم الخيار الذي تريده، مثل **Continue with GitHub** أو تسجيل الدخول الخاص بجامعتك. يفتح متصفحك. سجّل الدخول هناك، ثم عُد إلى Oleafly. لا يرى Oleafly كلمة مرورك أبدًا.

### عبر رابط بريد إلكتروني

إذا كان الخادم يوفر هذه الطريقة، فحدد **Continue with Email**. تُفتح في متصفحك صفحة من الخادم.

1. أدخل عنوان بريدك الإلكتروني وحدد **Email me a link**.
2. افتح رسالة البريد الإلكتروني على الحاسوب نفسه وحدد زر **Sign in** فيها.
3. في الصفحة التي تُفتح، حدد **Sign in**. يتابع Oleafly من تلقاء نفسه.

يعمل الرابط مرة واحدة، ولمدة 15 دقيقة. إذا كنت قد سجّلت الدخول إلى هذا الخادم بطريقة أخرى بالعنوان المتحقق نفسه، فسيسجّل لك الرابط الدخول إلى الحساب نفسه.

### عبر رمز

لا تستطيع بعض الحواسيب إعادة المتصفح إلى Oleafly بعد تسجيل الدخول، مثل حاسوب مختبر مقيّد الإعدادات. استخدم **Sign in with a code** هناك. ويقترحه Oleafly أيضًا عندما يستغرق تسجيل الدخول عبر المتصفح أكثر من 20 ثانية.

1. يعرض Oleafly عنوانًا على خادمك ورمزًا مكوّنًا من ثمانية أحرف.
2. على أي هاتف أو حاسوب، افتح ذلك العنوان، واكتب الرمز، ثم حدد **Continue**.
3. تذكر الصفحة اسم الحاسوب الذي طلب تسجيل الدخول. تحقق من الاسم، ثم سجّل الدخول بأي خيار يوفره الخادم. يُكمل Oleafly تسجيل الدخول من تلقاء نفسه.

يعمل الرمز مرة واحدة ويتوقف عن العمل بعد 10 دقائق. إذا لم تكن أنت من بدأ تسجيل الدخول، فحدد **Stop, this wasn't me**.

### عند الانتهاء

يعرض Oleafly **Connected to** واسم الخادم. حدد **Done**. يظهر الخادم الآن في **Settings → Collaboration** بحالة **Signed in**.

إذا أجاب الخادم «You're not on this server's list yet»، فاطلب من مسؤوله إضافتك. ويغطي [استكشاف الأخطاء وإصلاحها](/docs/collaboration/troubleshooting/#sign-in-problems) رسائل تسجيل الدخول الأخرى.

## فتح مشروع تمت مشاركته معك

تظهر المشاريع المشتركة معك في المكتبة ضمن **Shared with you**، أعلى مشاريعك الخاصة. يذكر كل صف المالك والخادم ودورك. حدد **Open**. ينسخ Oleafly المشروع إلى مكتبتك ويفتحه.

من ذلك الحين، يبقى المشروع في مكتبتك مثل أي مشروع آخر، مع علامة **Shared**. ملفاته ملفات حقيقية في مجلد مشاريعك. مستنده الرئيسي ومحرك تجميعه محددان للمشروع كله، لذا فهما متطابقان لدى الجميع.

### فتح مشروع من رابط

يمكن للناس أيضًا إرسال رابط مشروع إليك.

- **من رسالة بريد إلكتروني**، يفتح الرابط Oleafly مباشرة.
- **من أي مكان آخر**، افتح **Import** في المكتبة، واختر **Open shared project link…**، وألصق الرابط، ثم حدد **Open**.

قبل أن تنضم، يسألك Oleafly «Join this shared project?» ويعرض المشروع ومالكه والخادم ودورك. يؤدي الانضمام إلى نسخ ملفات المشروع إلى هذا الحاسوب. لا تحدد **Join** إلا إذا كنت تعرف من أرسل إليك الرابط.

إذا كان الرابط يعود إلى خادم لم تضفه بعد، فأضف الخادم أولًا، ثم افتح الرابط مرة أخرى.

## ابدأ التحرير

اكتب كما تكتب في أي مشروع. تصل تغييراتك إلى الآخرين أثناء الكتابة، وتصل تغييراتهم إليك. يشرح [العمل معًا](/docs/collaboration/working-together/) ما تراه على الشاشة.

إذا كنت مراجعًا، فإن ما تكتبه يصبح اقتراحًا. وإذا كنت معلّقًا، فالمحرر للقراءة فقط، لكن يمكنك تحديد النص والتعليق عليه. وإذا كنت مشاهدًا، فالمحرر للقراءة فقط، وتظل قادرًا على القراءة والتجميع والتصدير. تسرد [الأدوار](/docs/collaboration/sharing/#roles) ما يستطيع كل دور فعله.

إذا كان الخادم يتيح الوصول عبر المتصفح، فيمكنك أيضًا فتح المشروع في متصفح ويب، دون Oleafly. اقرأ [العمل في متصفح](/docs/collaboration/browser/).

## اختيار ما يراه الآخرون

ضمن **What others see** في **Settings → Collaboration**، اختر واحدًا مما يلي:

- **Show my cursor**: يرى الآخرون مؤشرك وتحديدك والملف الذي تعمل فيه.
- **Show only which file I'm in**: يرى الآخرون الملف، لكن دون موضعك فيه.
- **Hide me**: لا يرى الآخرون مؤشرك ولا الملف الذي تعمل فيه.

اضبط ذلك على كل حاسوب على حدة.

## أكثر من خادم واحد

يمكنك إضافة عدة خوادم، مثلًا خادم لمختبرك وآخر لمشروع مع جامعة أخرى. يعيش كل مشروع مشترك على خادم واحد. تسرد **Shared with you** المشاريع من كل خادم سجّلت الدخول إليه.

## أجهزتك

سجّل الدخول على كل حاسوب تستخدمه. تسرد بطاقة الخادم في **Settings → Collaboration** قسم **Your devices**، مع تاريخ إضافة كل جهاز فيه وتاريخ آخر ظهور له. حدد **Sign out** بجانب أي حاسوب لم تعد تستخدمه. يتوقف ذلك الحاسوب عن المزامنة حتى يسجّل شخص ما الدخول عليه مرة أخرى.

كل متصفح ويب سجّلت منه الدخول إلى الخادم موجود في القائمة أيضًا. ويُنهي **Sign out** بجانب متصفح جلسته فيه.

عندما يسجّل حسابك الدخول على حاسوب جديد، يرسل إليك الخادم بريدًا إلكترونيًا يذكر اسم الجهاز ونظامه والوقت، إذا كان الخادم يرسل بريدًا إلكترونيًا. إذا لم تكن أنت من فعل ذلك، فسجّل خروج ذلك الجهاز.

على الحاسوب المشترك، يحتاج كل شخص إلى حساب مستخدم خاص به. إذا كان شخص آخر قد سجّل الدخول إلى الخادم بالفعل من حساب المستخدم نفسه، فلن يسجّل Oleafly دخول شخص ثانٍ.

## البريد الإلكتروني من الخادم

عندما يضيفك أحدهم إلى مشروع، يمكن للخادم أن يرسل إليك بريدًا إلكترونيًا يذكر عنوان المشروع ومن شاركه ودورك ورابطًا يفتحه. لإيقاف هذه الرسائل، أوقف تشغيل **Email me when someone shares a project** في بطاقة الخادم. ستظل المشاريع المشتركة معك تظهر ضمن **Shared with you**.

عندما يذكرك أحدهم في تعليق، يرسل إليك الخادم بريدًا إلكترونيًا بذلك. اقرأ [ذكر شخص ما](/docs/collaboration/comments/#mention-someone).

إذا كان الخادم لا يرسل بريدًا إلكترونيًا، فلن تصلك هذه الرسائل. وكل ما عدا ذلك يعمل بالطريقة نفسها.

## تسجيل الخروج

حدد **Sign out** في بطاقة الخادم. يحاول Oleafly أولًا، لبضع ثوانٍ، إرسال أي تغييرات لا يمتلكها الخادم بعد.

إذا ظلت بعض التغييرات غير مرسَلة، يسألك Oleafly عمّا تريد فعله بها:

- يُبقي **Keep a local copy** كل مشروع من تلك المشاريع على هذا الحاسوب كمشروع عادي غير مشترك باسم «*المشروع* (local copy)»، ويحتفظ بتغييراتك. ثم يسجّل خروجك.
- يُبقيك **Stay signed in** في حالة تسجيل الدخول، بحيث يمكنك المحاولة مرة أخرى عندما تعود إلى الاتصال.

يسجّل **Remove** في بطاقة الخادم خروجك وينسى الخادم. ويسألك السؤال نفسه عن التغييرات غير المرسَلة. أما المشاريع الموجودة بالفعل على هذا الحاسوب فتبقى في مواضعها.
