MHTML_Bookmark

حفظ/تحميل ملحق MHTML Chrome

هذا هو امتداد Chrome الذي يسمح للمستخدمين بحفظ صفحة الويب الحالية كملف MHTML أو تحميلها على خادم API.
يضيف الملحق خيارين إلى قائمة السياق: "حفظ باسم MHTML" و"تحميل باسم MHTML".

سمات

• حفظ باسم MHTML : يتيح هذا الخيار للمستخدمين حفظ صفحة الويب الحالية كملف MHTML. يتم تنزيل الملف إلى النظام المحلي للمستخدم.
• تحميل كملف MHTML : يتيح هذا الخيار للمستخدمين تحميل صفحة الويب الحالية كملف MHTML إلى خادم API.

الاستخدام

1. انقر بزر الماوس الأيمن على صفحة الويب التي تريد حفظها أو تحميلها.
2. حدد إما "حفظ باسم MHTML" أو "تحميل باسم MHTML" من قائمة السياق.

الأذونات

يتطلب الامتداد الأذونات التالية:

• activeTab : للوصول إلى علامة التبويب الحالية.
• contextMenus : لإضافة عناصر إلى قائمة السياق.
• downloads : لتنزيل ملف MHTML.
• pageCapture : لالتقاط صفحة الويب الحالية بتنسيق MHTML.
• notifications : لعرض الإخطارات.

تثبيت

لتثبيت الامتداد، اتبع الإجراء القياسي لتثبيت ملحقات Chrome.

1. انسخ المستودع أو قم بتنزيل ملف ZIP.
2. افتح Chrome وانتقل إلى chrome://extensions/ .
3. قم بتمكين "وضع المطور" في الزاوية اليمنى العليا.
4. انقر فوق "تحميل غير مضغوط" وحدد دليل الامتداد.

يرجى ملاحظة أن ميزة "التحميل كـ MHTML" تتطلب واجهة برمجة تطبيقات من جانب الخادم لتلقي طلب POST.
تم تعيين عنوان URL لواجهة برمجة التطبيقات حاليًا على "http://localhost:3001/api/upload" ويجب تحديثه إلى عنوان URL الفعلي لواجهة برمجة التطبيقات.

هيكل الكود

يتكون الامتداد من ثلاثة ملفات JavaScript رئيسية:

• background.js : يحتوي هذا الملف على المنطق الرئيسي لإنشاء قائمة السياق ومعالجة اختيار المستخدم. ويحتوي أيضًا على وظائف حفظ صفحة الويب بتنسيق MHTML وتحميلها إلى واجهة برمجة التطبيقات.

• content.js : يحتوي هذا الملف على مستمع رسائل لتجزئة مسار URL وعنوان صفحة الويب.

• manifest.json : يحتوي هذا الملف على البيانات التعريفية للامتداد، بما في ذلك اسمه وإصداره ووصفه وأذوناته والمسارات المؤدية إلى ملفات JavaScript وملفات الأيقونات.

---

المهام

• أضف دعمًا لعناوين URL المخصصة لواجهة برمجة التطبيقات (API) التي حددها المستخدم.
• إضافة دعم لمفاتيح اختصار المتصفح. (على سبيل المثال، Ctrl + S للحفظ بتنسيق MHTML، وCtrl + U للتحميل بتنسيق MHTML)
• إضافة دعم لمفاتيح الاختصار التي يحددها المستخدم.
• إضافة الكشف عن عنوان url MHTML الموجود في خدمة الإشارات المرجعية.
• حفظ في التخزين السحابي ودعم واجهة برمجة التطبيقات الخارجية. (على سبيل المثال فيرسل)

اقتراحات للتحسين

• معالجة الأخطاء: تحسين معالجة الأخطاء في الامتداد الخاص بك. على سبيل المثال، يمكنك إضافة المزيد من التفاصيل
  رسائل خطأ لمساعدة المستخدمين على استكشاف المشكلات وإصلاحها. وفكر أيضًا في آليات إعادة المحاولة لطلبات الشبكة.
• مؤشر التقدم: عندما يختار المستخدم تحميل ملف MHTML، فقد يستغرق الأمر بعض الوقت
  العملية لإكمال. سيؤدي عرض مؤشر التقدم إلى تحسين تجربة المستخدم.
• أيقونة الامتداد: استخدم أيقونة الامتداد لإظهار حالة العملية الأخيرة (نجاح، فشل، قيد التقدم).

المساهمة

المساهمات هي موضع ترحيب. الرجاء فتح مشكلة أو إرسال طلب سحب على GitHub.