استيراد وتصدير موقع مستندات
انقل مركز المساعدة الخاص بك من Mintlify أو GitBook أو Zendesk أو Intercom أو غيرها من المنصات إلى موقع مستندات، وراجع التقرير أو تراجع عنه، وقم بتصدير الموقع كملف مضغوط (zip) بتنسيق HTML أو مارك داون.
انقل مركز المساعدة الحالي الخاص بك إلى موقع مستندات Clevera، أو قم بتنزيل كل شيء على الموقع كملف مضغوط (zip). تجلب عمليات الاستيراد الصفحات والصور والهيكل والترجمات والعناوين القديمة؛ بينما تمنحك عمليات التصدير محتواك كملفات HTML أو مارك داون. كلاهما مجاني.
قبل البدء
- افتح موقع المستندات الخاص بك وانتقل إلى الإعدادات → استيراد وتصدير.
- مالك مساحة العمل فقط هو من يمكنه الاستيراد أو التصدير. يمكن للمسؤولين فتح علامة التبويب وإلقاء نظرة، لكن عناصر التحكم تكون معطلة: "مالك مساحة العمل فقط هو من يمكنه استيراد أو تصدير المحتوى."
- لا تكلف عمليات الاستيراد والتصدير أي رصيد، في جميع الخطط.
- لا تكون الصفحات المستوردة مباشرة حتى تقوم بـ النشر، لذا يمكنك مراجعتها أولاً.
استيراد مستنداتك
اختر منصتك
ضمن استيراد المحتوى، انقر فوق المنصة التي توجد عليها مستنداتك. إذا لم تكن مدرجة، فاختر أي موقع مستندات آخر.
اختر المنصة التي تريد الاستيراد منها الاتصال
اختر كيفية الاتصال ضمن كيفية الاتصال، واملأ الحقول وانقر فوق تحقق من الاتصال. راجع المنصات والطرق لمعرفة ما يطلبه كل منها.
المعاينة
تدرج Clevera الأقسام والصفحات التي عثرت عليها. قم بإلغاء تحديد الصفحات التي لا تريدها. قد يستغرق الموقع الكبير دقيقة: "نحن نقوم بإدراج كل قسم وصفحة."
اختر الخيارات
اختر المكان الذي ستذهب إليه الصفحات واللغات التي تريد جلبها. راجع خيارات الاستيراد.
التأكيد والبدء
تحقق من الملخص، على سبيل المثال "سنقوم بنسخ 120 صفحة إلى قسم جديد، "مركز المساعدة"." و الوقت المقدر، ثم انقر فوق بدء الاستيراد.
يمكنك إغلاق النافذة أثناء تشغيل العملية: "يمكنك إغلاق هذه النافذة. سنرسل إليك بريداً إلكترونياً عند انتهاء الاستيراد." يظهر التقدم جاري استيراد الصفحات، و جاري نسخ الصور، و ربط الصفحات، و إضافة عمليات إعادة التوجيه، مع أعداد صفحات و صور و فشل.
عندما تنتهي، ستتلقى بريداً إلكترونياً، "عملية الاستيراد من المنصة جاهزة"، مع خيار عرض التقرير. ثم راجع الصفحات وانشر الموقع.
المنصات والطرق
تعرض كل بطاقة منصة الطرق التي تدعمها: واجهة برمجة التطبيقات (API)، و موقع عام، و مستودع / ملف مضغوط (zip).
| المنصة | الطرق | ما يتم جلبه |
|---|---|---|
| Mintlify | مستودع Git، ملف مضغوط (zip)، موقع عام | الصفحات، المقتطفات، الصور وكل لغة في تنقلك. يحتاج المستودع إلى docs.json أو mint.json. |
| GitBook | رمز API، مستودع Git (مزامنة Git)، ملف مضغوط (zip)، موقع عام | المساحات، الصفحات، المجموعات والصور. |
| Docusaurus | مستودع Git، ملف مضغوط (zip)، موقع عام | المستندات والصور. يمكن أن تصبح المدونة سجل التغييرات الخاص بك. |
| Zendesk | رمز API، موقع عام | مقالات مركز المساعدة، الأقسام والترجمات. |
| Intercom | موقع عام | المجموعات ومقالات مركز المساعدة العام الخاص بك. |
| Help Scout | مفتاح API، موقع عام | المجموعات، الفئات، المقالات وعمليات إعادة التوجيه الخاصة بـ Help Scout. |
| ReadMe | مفتاح API، موقع عام | الأدلة وسجل التغييرات للإصدار الافتراضي الخاص بك. |
| Document360 | مفتاح API، موقع عام | الفئات، المقالات واللغات. |
| Notion | رمز الاتصال | صفحة وكل صفحة تحتها. |
| Confluence | رمز API | مساحة مع صفحاتها ومجلداتها وصورها. |
| أي موقع مستندات آخر | موقع عام، ملف مضغوط (zip) | أي موقع مستندات عام، أو ملف مضغوط (zip) لملفات مارك داون أو HTML. |
الطرق
موقع عام. الصق عنوان مستنداتك العامة (الصفحة الرئيسية أو أي صفحة مستندات)، ضمن عنوان الموقع. تقرأ Clevera الصفحات المدرجة في تنقلك أو خريطة الموقع، بوتيرة هادئة تحترم robots.txt الخاص بك. يتم قراءة الصفحات الموجودة تحت هذا العنوان فقط. المقالات الخاصة والمسودات غير مشمولة.
رمز أو مفتاح API. الصق رمزاً تنشئه في المنصة الأخرى. تحتوي كل بطاقة منصة على الخطوات ورابط للمكان الذي تنشئه فيه. تقرأ Clevera فقط. تُستخدم الرموز أثناء تشغيل الاستيراد ويتم حذفها في غضون 24 ساعة. يمكنك إلغاء الرمز في المنصة الأخرى بمجرد انتهاء الاستيراد.
مستودع Git. الصق عنوان المستودع (GitHub أو GitLab أو Bitbucket). بالنسبة لمستودع GitHub خاص، أضف رمز الوصول مع وصول للقراءة فقط إلى المحتويات. تقوم Clevera بتنزيل الفرع الافتراضي كأرشيف ولا تقوم بتشغيل الكود الخاص به أبداً.
تحميل ملف مضغوط (zip). قم بتحميل .zip لمستنداتك، حتى 200 ميجابايت. تقرأ Clevera ملفات مارك داون و MDX و JSON و YAML والصور وتتجاهل أي شيء آخر. بالنسبة لـ أي موقع مستندات آخر، يمكن للملف المضغوط أن يحتوي على ملفات .md أو .mdx أو .html، ويصبح كل مجلد من المستوى الأعلى قسماً.
ملاحظات المنصة
- Intercom لا يسمح بمشاركة رموز الوصول مع تطبيقات أخرى، لذا تقرأ Clevera مركز المساعدة العام الخاص بك.
- يتطلب وصول API لـ Zendesk مسؤولاً على خطة من Team فما فوق. يقرأ أي وكيل المقالات المنشورة؛ كما يجلب مسؤول الدليل المسودات والمقالات المقيدة.
- يتيح لك Help Scout اختيار المقالات المنشورة فقط أو المقالات المنشورة والمسودات. لا يمكن أن تكون مفاتيح API الخاصة به للقراءة فقط، لذا احذف المفتاح بعد ذلك.
- تظل صفحات مرجع API لـ ReadMe والوصفات والصفحات المخصصة على ReadMe.
- وصول API لـ Document360 متاح في خطط Business و Enterprise ويتطلب مفتاح API أحدث.
- يحتاج Notion إلى مالك مساحة العمل لإنشاء الاتصال، مع "قراءة المحتوى فقط".
- يعمل Confluence مع مواقع Confluence Cloud.
- المستندات ذات الإصدارات المتعددة: يتم استيراد أحدث إصدار فقط.
خيارات الاستيراد
| الخيار | ما يفعله | الافتراضي |
|---|---|---|
| قسم جديد / قسم موجود | المكان الذي تذهب إليه الصفحات. يحصل القسم الجديد على اسم مقترح يمكنك تغييره. | قسم جديد |
| اللغات | أي لغات المصدر التي تريد جلبها. يجب إضافة لغة لا يمتلكها موقعك بعد إلى الموقع أولاً. | كل لغة مصدر يمتلكها موقعك |
| إنشاء عمليات إعادة توجيه من العناوين القديمة | تستمر الروابط القديمة في العمل بمجرد توجيه نطاقك إلى هنا. يحصل كل عنوان قديم على إعادة توجيه دائمة إلى الصفحة الجديدة. | تشغيل، عندما يحتوي المصدر على عناوين ويب |
| تخطي الصفحات الموجودة هنا بالفعل | يتجاهل الصفحات التي يُستخدم عنوانها بالفعل على هذا الموقع. | إيقاف |
بالنسبة لطريقة موقع عام، يمكنك أيضاً تحديد "أنا أمتلك هذا المحتوى أو لدي الحق في نسخه." قبل البدء.
كيف يتم جلب الهيكل
- يتم استيراد الصفحات والصور والأقسام والمجموعات والترجمات وعمليات إعادة التوجيه وإدخالات سجل التغييرات.
- تحتوي مواقع المستندات على أقسام مع مستوى واحد من المجموعات تحتها. يتم نقل المستويات الأعمق مستوى واحداً للأعلى، مع تحذير في التقرير.
- الصفحات المستوردة جاهزة للنشر؛ وتصبح مباشرة عند النشر التالي. تأتي إدخالات سجل التغييرات المستوردة كمسودات.
- يتم نسخ الصور إلى الموقع. الصورة التي لا يمكن نسخها يتم استبعادها مع تحذير، ويبقى نصها البديل.
- يتم توجيه الروابط بين الصفحات المستوردة إلى عناوينها الجديدة. الروابط إلى الصفحات التي لم يتم استيرادها تحتفظ بعناوينها الأصلية.
- الصفحات التي تم العثور عليها في خريطة الموقع فقط، وليس في القائمة، تذهب إلى مجموعة تسمى "المزيد من الصفحات".
الحدود
| الحد | القيمة |
|---|---|
| الصفحات لكل استيراد | 2,000. يستورد المصدر الأكبر أول 2,000 صفحة. |
| عمليات الاستيراد لكل موقع | 5 يومياً (خلال 24 ساعة متتالية). |
| عمليات الاستيراد في وقت واحد | واحدة لكل موقع. |
| تحميل ملف مضغوط (zip) | 200 ميجابايت، حتى 5,000 ملف و 500 ميجابايت عند فك الضغط. |
| الصور | 25 ميجابايت لكل منها. |
| سرعة قراءة الموقع العام | حوالي صفحتين في الثانية؛ يتم تخطي الصفحة التي تستغرق أكثر من 30 ثانية. |
| عمليات إعادة التوجيه التي تم إنشاؤها | تُحتسب ضمن حد إعادة التوجيه الخاص بخطتك. يتم تخطي تلك التي تتجاوز الحد. |
تُظهر البطاقة عدد عمليات الاستيراد المتبقية اليوم وحد الصفحات.
تقرير الاستيراد
انقر فوق عرض التقرير تحت عمليات الاستيراد الأخيرة. يظهر التقرير القسم، والإجماليات لـ تم الاستيراد، و تم التخطي، و فشل، و صور، و إعادة التوجيه. قم بتصفية الصفحات حسب فشل، أو مع تحذيرات، أو تم التخطي، وانقر فوق فتح في المحرر لإصلاح إحداها.
أمثلة على التحذيرات:
- "تم وضع هذه الصفحة في مستوى أعمق مما تسمح به مواقع المستندات، لذا تم نقلها للأعلى."
- "تعذر نسخ صورة، لذا تم استبعادها"
- "صفحة بهذا العنوان موجودة بالفعل هنا، لذا تم تخطيها."
- "تم التخطي: يمنعنا ملف robots.txt أو قواعد عنوان الموقع من قراءة هذه الصفحة."
التراجع عن استيراد أو إلغاؤه
- إلغاء الاستيراد يتوقف بعد الصفحات التي تتم قراءتها الآن. تظل الصفحات التي تم استيرادها بالفعل، ويمكنك التراجع عنها من التقرير.
- تراجع عن الاستيراد يحذف الصفحات والصور وعمليات إعادة التوجيه وإدخالات سجل التغييرات التي أنشأها الاستيراد، وقسمه الجديد إذا كان فارغاً الآن.
تصدير موقع
اختر تنسيقاً
ضمن تصدير بياناتك، اختر تنسيق التصدير: HTML (صفحات تفتحها في متصفح، صور في مجلد خاص بها) أو مارك داون (ملفات
.mdنصية، صور في مجلد خاص بها).
اختر تنسيقاً واطلب التصدير اطلب ذلك
انقر على طلب تصدير. ستظهر لك رسالة "تم طلب التصدير. سنرسل رابط التنزيل إلى بريدك الإلكتروني" الخاص بك، "عادةً في غضون 10 دقائق".
تنزيل الملف المُصدَّر
افتح البريد الإلكتروني الذي يحمل عنوان "تصدير موقعك site جاهز" وانقر على تنزيل الملف المُصدَّر. يجب أن تكون مسجلاً للدخول إلى Clevera. يعمل الرابط لمدة 7 أيام؛ كما يظهر ملف التصدير أيضاً أسفل البطاقة مع خيار تنزيل حتى تنتهي صلاحيته.
يحتوي ملف zip على:
- كل صفحة على الموقع، بما في ذلك المسودات التي تحمل علامة "مسودة"، وبكل اللغات، بالإضافة إلى صفحات الموقع.
- سجل التغييرات، بما في ذلك المسودات.
- الصور، حيث يتم تخزين كل صورة مرة واحدة.
- التنقل، وإعدادات الموقع، وعمليات إعادة التوجيه (
redirects.csv) وقائمة بالفيديوهات (videos.csv)، مع ملفREADME.txtيشرح الملفات.
يمكنك طلب 3 عمليات تصدير لكل موقع في اليوم (خلال 24 ساعة متواصلة). لا يتم احتساب عملية التصدير الفاشلة. الشخص الذي طلب التصدير هو الوحيد الذي يمكنه تنزيله. عندما يقوم المالك بالتصدير، يتلقى المسؤولون إشعاراً بأنه تم إجراء عملية تصدير.
الفيديوهات
الفيديوهات غير موجودة في ملف zip. في الملفات، كل فيديو عبارة عن رابط: "مشاهدة / تصدير هذا الفيديو". تعرض بطاقة الفيديوهات كل فيديو من فيديوهات Clevera الموجودة على صفحات الموقع مع خيار تصدير الفيديو، والذي يفتح الفيديو حتى تتمكن من تصديره بالجودة التي تريدها.
استكشاف الأخطاء وإصلاحها
| ما تراه | ما يجب فعله |
|---|---|
| "لم ينجح هذا الرمز. تأكد من نسخه بالكامل وأنه يمتلك صلاحية القراءة، ثم حاول مرة أخرى." | أنشئ رمزاً جديداً بصلاحية القراءة وألصقه مرة أخرى. |
| "لم نتمكن من الوصول إلى المصدر. تحقق من العنوان وحاول مرة أخرى." | تحقق من أن العنوان يفتح في المتصفح. |
| "حظر الموقع أداة القراءة الخاصة بنا. يمكننا فقط استيراد الصفحات العامة." | استخدم واجهة برمجة التطبيقات (API) أو طريقة zip إذا كانت المنصة توفر ذلك. |
| "يطلب ملف robots.txt الخاص بهذا الموقع من برامج الزحف عدم قراءة هذه الصفحات." | اسمح بالقراءة في robots.txt، أو استخدم طريقة أخرى. |
| "المصدر أكبر مما يمكننا استيراده. قم بتحميل مجلد المستندات فقط." | قم بضغط مجلد المستندات فقط. |
| "يتجاوز حجم ملف zip هذا 200 ميجابايت. قم بالاستيراد من المستودع بدلاً من ذلك." | استخدم طريقة مستودع Git. |
| "يمكنك بدء 5 عمليات استيراد يومياً على هذا الموقع. حاول مرة أخرى غداً." | انتظر حتى مرور 24 ساعة. |
| "هناك عملية استيراد أخرى قيد التشغيل على هذا الموقع. انتظر حتى تنتهي." | عملية استيراد واحدة في كل مرة لكل موقع. |
| "لم يتم استيراد أي من الصفحات. يوضح التقرير السبب." | افتح التقرير لمعرفة سبب كل صفحة. |
| "يمكنك طلب ما يصل إلى 3 عمليات تصدير في اليوم." | توضح الرسالة متى ستكون العملية التالية متاحة. |
| "انتهت صلاحية هذا التصدير. اطلب واحداً جديداً من إعدادات الموقع." | اطلب تصديراً جديداً. |