> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/ar/alsyanh/data-and-backups/exporting-projects.md).

# تصدير المشاريع

في Server Pro وCommunity Edition `5.4.0` قمنا بتضمين برنامج نصي يتيح للمسؤولين تصدير جميع مشاريع المستخدمين (بما في ذلك تلك التي لا تزال مرئية في **المحذوفة** و **المهملة** المجلدات) إلى دليل على القرص.

{% hint style="info" %}
الناتج من تشغيل هذا البرنامج النصي هو نفسه تنزيل ملف Zip لجميع المشاريع يدويًا من لوحة تحكم مشاريع المستخدم. سيقوم البرنامج النصي بتفريغ أي تغييرات معلّقة قبل بدء التنزيل لضمان أن التصدير يحتوي على أحدث إصدار من المشروع.
{% endhint %}

### القيود

لدى برنامج التصدير النصي القيود التالية:

* لا يتم تصدير إعدادات المشروع، مثل اسم صورة TeX Live أو المترجم. يجب تعيين هذه عند رفع المشروع إلى حساب المستخدم.
* المشاريع المصدّرة لا تحتوي على أي سجل إصدارات.
* لا يتم الاحتفاظ بأي معلومات عن المتعاونين. ستحتاج المشاريع إلى إعادة مشاركتها. إذا كان يتم استخدام المشاركة عبر الرابط، فسيتم إعادة إنشاء روابط العرض والتحرير (لن تكون نفسها كما كانت من قبل).
* لن يتم تصدير أي تعليقات أو معلومات تتبّع التغييرات.
* لن يتم تصدير سجل دردشة المشروع.

{% hint style="danger" %}
هذا البرنامج النصي **ليست** مصمم ليحل محل نسخة احتياطية كاملة للنظام. ولضمان قدرتك على استعادة مثيلك في سيناريو استعادة الكوارث، نوصي **بشدة** بأخذ [نسخة احتياطية متسقة](https://docs.overleaf.com/on-premises/maintenance/#performing-a-consistent-backup).
{% endhint %}

### **الخيارات**

| الاسم                  | الوصف                                                                      |
| ---------------------- | -------------------------------------------------------------------------- |
| `--help`               | عرض المساعدة                                                               |
| `--user-id`            | معرّف المستخدم (مطلوب ما لم يكن استخدام `--export-all` أو `--project-id`)  |
| `--project-id`         | تصدير مشروع واحد (**لا يمكن** استخدامه مع `--user-id` أو `--export-all`)   |
| `--list`               | إدراج مشاريع المستخدم (**لا يمكن** استخدامه مع `--output`)                 |
| `--output`             | ملف zip الناتج (لعمليات التصدير الفردية)                                   |
| `--export-all`         | تصدير مشاريع جميع المستخدمين (يتطلب `--output-dir`)                        |
| `--output-dir`         | الدليل لتخزين ملفات تصدير جميع المستخدمين                                  |
| `مستوى السجل المدعوم:` | مستويات السجل المدعومة: `trace`\|`debug`\|`info`\|`warn`\|`error`\|`fatal` |

### **الاستخدام**

استخدم الأمر التالي لتصدير المشاريع لجميع المستخدمين:

{% code overflow="wrap" %}

```bash
# مستخدمو Overleaf Toolkit
$ bin/docker-compose exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/export-user-projects.mjs --export-all --output-dir=/var/lib/overleaf/data/exports"

# مستخدمو docker-compose.yml القديمة
docker exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/export-user-projects.mjs --export-all --output-dir=/var/lib/overleaf/data/exports"
```

{% endcode %}

{% hint style="info" %}
إذا كنت تستخدم Server Pro أو Community Editition <= 3.5.13 فستحتاج إلى تحديث المثال أعلاه لاستخدام **`export-legacy-user-projects.js`** البرنامج النصي.
{% endhint %}

### **الإكمال**

بمجرد اكتمال التصدير، يمكنك الوصول إلى الملفات عبر الدليل الموجود على المضيف والمركّب كربط إلى **/var/lib/overleaf** في ملف **docker-compose.yml** أو `OVERLEAF_DATA_PATH` متغير البيئة في **config/overleaf.rc** الملف إذا كنت تستخدم Toolkit.

{% hint style="info" %}
يسمح Overleaf حاليًا بأسماء مشاريع مكررة. إذا احتوى مشروع المستخدم على اسم مكرر، فستظل هذه المشاريع تُضاف إلى ملف Zip للتصدير الخاص بالمستخدم، ولكن عند استخراجها، ستظهر نسخة واحدة فقط. على Linux، `unzip -B` سيكتب الملفات التي لها الاسم نفسه كملفات نسخ احتياطي بدلًا من الكتابة فوقها.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ayakaleaf-pro.ayaka.space/on-premises/ar/alsyanh/data-and-backups/exporting-projects.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.