> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gorbit.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# BookStack

> الوصول إلى المعرفة من مثيل BookStack الخاص بك

## كيف يعمل

يجلب موصل BookStack جميع الرفوف والكتب والفصول والصفحات من المثيل المتصل عند إعداد الموصل.
من تلك النقطة فصاعدًا، سيقوم الموصل بسحب كل شيء تم تحديثه منذ آخر مزامنة كل **10** دقائق.

## الإعداد

### التفويض

ستحتاج إلى بيانات اعتماد API لمستخدم في مثيل BookStack الخاص بك. للقيام بذلك:

<Steps>
  <Step title="إنشاء/تحديد مستخدم الاتصال">
    ابحث عن أو أنشئ مستخدمًا تريد استخدامه كمستخدم اتصال.

    * تعتمد رؤية محتويات BookStack على أذونات هذا المستخدم.
    * يجب أن يكون لهذا المستخدم دور معين لديه إذن النظام "Access system API".
  </Step>

  <Step title="فتح رموز API">
    قم بتحرير هذا المستخدم باستخدام حساب مسؤول، وابحث على قسم "API Tokens" في أسفل العرض.

    <img className="rounded-image" src="https://mintcdn.com/gorbit/i9pIrvFbh53KkrjR/assets/admins/connectors/bookstack/BookstackApiTokenList.png?fit=max&auto=format&n=i9pIrvFbh53KkrjR&q=85&s=9829c7cc5fad281e0f78532dc7b44782" alt="عرض قائمة رموز API في BookStack" width="1511" height="406" data-path="assets/admins/connectors/bookstack/BookstackApiTokenList.png" />
  </Step>

  <Step title="إنشاء ونسخ الرمز">
    انقر على زر "Create Token"، ثم أدخل اسمًا و(اختياريًا) تاريخ انتهاء صلاحية للرمز. ثم اضغط حفظ.
    انسخ قيم "Token ID" و "Token Secret" المعروضة لقسم "الفهرسة" أدناه.

    <img className="rounded-image" src="https://mintcdn.com/gorbit/i9pIrvFbh53KkrjR/assets/admins/connectors/bookstack/BookstackApiToken.png?fit=max&auto=format&n=i9pIrvFbh53KkrjR&q=85&s=24d0f70e16739d6383c8e6665ecea195" alt="عرض رمز API في BookStack" width="1511" height="1359" data-path="assets/admins/connectors/bookstack/BookstackApiToken.png" />
  </Step>
</Steps>

### الفهرسة

<Steps>
  <Step title="افتح موصل BookStack">
    انتقل إلى لوحة الإدارة وحدد موصل **BookStack**.
  </Step>

  <Step title="أدخل عنوان URL والرموز">
    في **الخطوة 1**، قدم عنوان URL الأساسي لمثيل BookStack الخاص بك،
    مع **Token ID** و **Token Secret** اللذين حصلت عليهما في خطوات "التفويض" أعلاه:

    <img className="rounded-image" src="https://mintcdn.com/gorbit/i9pIrvFbh53KkrjR/assets/admins/connectors/bookstack/BookstackAuth.png?fit=max&auto=format&n=i9pIrvFbh53KkrjR&q=85&s=00a478b7d0e6e1e8c0e50fc3c2c7cb8d" alt="عرض الخطوة 1 لموصل BookStack" width="1324" height="1177" data-path="assets/admins/connectors/bookstack/BookstackAuth.png" />
  </Step>

  <Step title="ابدأ الفهرسة">
    انقر على زر `Connect`! سيتم سحب المحتوى الخاص بك إلى Gorbit كل **10** دقائق.

    <img className="rounded-image" src="https://mintcdn.com/gorbit/i9pIrvFbh53KkrjR/assets/admins/connectors/bookstack/BookstackIndex.png?fit=max&auto=format&n=i9pIrvFbh53KkrjR&q=85&s=fa422cdbf9b5ef7cbde4fa824625cf02" alt="عرض الخطوة 2 لموصل BookStack" width="1324" height="660" data-path="assets/admins/connectors/bookstack/BookstackIndex.png" />
  </Step>
</Steps>