الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

بحث SWIFT SELECT

ملاحظة: التنمية على استراحة غير محددة (آسف!)

  • يرجى استخدام صفحة المشكلات فقط للإبلاغ عن الأخطاء الإشكالية التي قد تجدها.
  • هذا المشروع لا يقبل طلبات السحب.
  • أنا أشجعك على العمل على نسختك الخاصة من SSS ونشره كملحق محسّن. حتى بالنسبة للمتصفحات الأخرى!

يمكنك قراءة المزيد عن هذا هنا.

وصف

Swift Selection Search (SSS) هو إضافة Firefox للبحث بسرعة عن بعض النصوص في صفحة باستخدام محركات البحث المفضلة لديك.

حدد نصًا على صفحة وسيظهر مربع منبثقة صغيرة مع محركات البحث فوق المؤشر. اضغط على واحدة وستبحث تلقائيًا عن النص المحدد باستخدام هذا المحرك!

SSS قابلة للتكوين. يمكنك تحديد محركات البحث التي تظهر على المنبثقة ، ومظهر الرموز ، وماذا يحدث عند النقر فوقها ، حيث يظهر المنبثقة ، وما إذا كنت ستخفيه عند التمرير أو لا تريد أن ترغب في نسخ النص التلقائي عند التحديد ، والعديد من الخيارات الأخرى.

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

يتوفر SSS في موقع Mozilla إضافات ، هنا:

https://addons.mozilla.org/firefox/addon/swift-selection-search

كيفية البناء

أولاً ، نظرًا لأن WebExtensions مصنوعة في JavaScript ، نحتاج إلى أن نكون قادرين على تحويل TypeScript إلى JavaScript ، ويفضل أن يكون ذلك تلقائيًا قدر الإمكان.

  1. تثبيت NPM . قم بتنزيل node.js من https://nodejs.org وستحصل على NPM بجانبها.

  2. في مجلد المشروع ، قم بتشغيل هذا في سطر الأوامر:

    تثبيت NPM

    سيؤدي ذلك إلى تثبيت تبعيات TypeScript للمشروع محليًا في Node_Modules Node_Modules .

  3. لنقل كل البرامج النصية.

    "node_modules/.bin/tsc.cmd" -مشاهدة -P tsconfig.json

    سيبقى الأمر على قيد الحياة ويعيد إعادة النقل تلقائيًا بعد أي تغييرات على ملفات .TS ، وهو أمر مفيد أثناء التطوير.

الآن لديك ملفات .js ، حتى تتمكن من استخدام SSS كمواقع WebExtension. ياي!

  • للتطور القصير أو مجرد الفضول ، فإن الطريقة الأكثر بساطة لتجربة SSS هي حول: تصحيح التصحيح#addons في Firefox. اضغط على زر "تحميل الإضافات المؤقتة" ، حدد ملفًا في دليل SWIFT Selection Search "SRC" (على سبيل المثال Meantest.json ) ، وسيقوم بتحميل الوظيفة الإضافية حتى يتم إغلاق المتصفح. تتطلب التغييرات على معظم التعليمات البرمجية إعادة تحميل الوظيفة الإضافية مرة أخرى.

  • للحصول على مزيد من التطوير المطول و/أو التغليف ، مثل إعادة التحميل التلقائي بعد كل تغيير ، يرجى اتباع تعليمات Mozilla هنا لتثبيت الأداة ويب ويب .

كيفية المساهمة في الكود في SSS

تحضير

  1. مفترق المستودع على github واستنساخه على جهاز الكمبيوتر الخاص بك.

  2. اتبع التعليمات أعلاه لكيفية البناء .

    في النهاية ، يجب أن يكون لديك برنامج نصي ينقل الكود تلقائيًا من TypeScript إلى JavaScript ، ويجب أن يعرف كيفية تشغيل إصدار SSS على Firefox.

  3. تعلم أن SSS لديها 3 فروع رئيسية:

    • ماجستير - الإصدارات النهائية التي يتم نشرها إلى إضافات موزيلا. عادةً ما يشير "Master" إلى الالتزام الذي يتغير فيه إصدار SSS ، نظرًا لأن تلك هي المنشورة (عادةً ، هناك التزام بتحديث الإصدار).
    • تطوير - حيث يحدث التطوير وأين سيتم دمج ميزات جديدة. أقل استقرارًا ، ولكن لا ينبغي أن يكون لها ميزات غير مكتملة.
    • يمكن تجاهل Addon -SDK - لأنه رمز SSS قبل أن يكون Webextension. أساسا أرشيف.

  4. اقرأ إرشادات الرمز أدناه.

إرشادات رمز

  • علامات التبويب للمسافة البادئة ، من فضلك! ؛) (يمكن استخدام المساحات لمحاذاة الأشياء.)
  • لا مساحة بيضاء في نهاية الخطوط. تساعد الإعدادات مثل VSCODE's "files.trimtrailingwhitespace" في هذا.
  • حاول اتباع النمط الذي تراه في الكود الحالي. إذا كنت تعتقد أن الأمر غير متناسق في بعض الأماكن ، فلا تتردد في فعل شيء خاص بك. سيتم مراجعته على أي حال. ؛)
  • تدعم SSS حاليًا Firefox 63 فصاعدًا ، مما يعني أنه يجب عليك العناية إضافية عند استخدام واجهة برمجة تطبيقات Webextensions. تأكد من وجوده في Firefox 63 ، أو على الأقل أن الكود لا يعمل ويتعطل على الإصدارات القديمة. من الناحية المثالية ، قم بتثبيت Firefox 63 بشكل منفصل على جهاز الكمبيوتر الخاص بك (مع وجود ملف تعريف مختلف Firefox لذلك يساعد بشكل كبير) وتعطيل تحديثاته التلقائية.

تعاون

  1. ابحث عن مشكلة تود حلها في قائمة المشكلات.

  2. اسأل عما إذا كان أي شخص يعمل عليه بالفعل. بالإضافة إلى ذلك ، إذا كان الأمر مفقودًا تفاصيل حول كيفية التنفيذ أو إذا كنت تريد معرفة الأساليب المحتملة ، فلا تتردد في السؤال!

  3. قم بإنشاء فرع GIT جديد للميزة الجديدة أو إصلاح الأخطاء التي تحاول تنفيذها. قم بإنشاء هذا الفرع من "تطوير" ، لتبسيط الدمج لاحقًا (نظرًا لأن "Master" قد لا يكون له كل التغييرات الحالية).

  4. تنفيذ وارتكاب/دفع التغييرات إلى الفرع ، ربما في ارتباطات متعددة.

  5. أخيرًا ، قم بإنشاء طلب سحب لدمج التغييرات الخاصة بك على المستودع الأصلي. سيخضع لمراجعة التعليمات البرمجية والمناقشة وربما التغييرات إذا لزم الأمر.

    شكرًا!

اعتبارات النماذج والتحذيرات

تم نقل SSS في مرحلة ما من JavaScript إلى TypeScript للحصول على فوائد التعليقات التوضيحية النوع ، حيث يمكن اكتشاف العديد من الأخطاء بواسطة Checker Type. ومع ذلك ، تجدر الإشارة إلى أن تفاعل Webextensions مع TypeScript أمر صعب في أحسن الأحوال ، لأن TypeScript يفترض أن البرامج النصية يمكنها استيراد الكود/البيانات من البرامج النصية الأخرى ، في حين أن بيئة WebExtensions لديها في الواقع صناديق الرمل ونادراً ما تسمح بذلك.

لا ترى برامج النصوص المحتوى رمزًا من البرنامج النصي للخلفية ، أو العكس ، والطريقة الوحيدة التي يمكن أن ترى بها برامج النصوص المتعددة للمحتوى هي رمز بعضها البعض إذا تم حقنها جميعًا على نفس الصفحة بواسطة البرنامج النصي للخلفية ، على غرار كيفية تضمينها في صفحة HTML مثل البرامج النصية. ليس لدى TypeScript أي فكرة أن هذه هي الطريقة التي تعمل بها WebExtensions ، لذلك لمجرد أن شيئًا ما ينقل إلى JavaScript بشكل صحيح ، فهذا لا يعني أن Webextension ستعمل.

مثال على ذلك هو أنه يمكننا إعلان الأنواع/الفئات في البرنامج النصي للخلفية والرجوع إليها في البرامج النصية الأخرى ، حيث إن مدقق النوع يهتم بها. نحصل على فحص النوع وهو جيد.

ومع ذلك ، إذا حاولنا الإضافة إلى هذه الفئات ، فلن ترى بعض الطرق المتغيرة ، وما إلى ذلك ، ثم البرامج النصية للمحتوى أو خيارات البرامج النصية لصفحات الخيارات. عند الانتقال إلى JavaScript ، سيتم تركها كمرجع إلى الكود في برنامج نصي آخر ، والذي لا يمكن الرجوع إليه في وقت التشغيل بسبب Webextensions Sandboxing. وينطبق هذا أيضًا على التعدادات (التي لها قيم ملموسة ، لذلك "بيانات") ما لم نعلن عنها كـ const enum ، في هذه الحالة ، يقوم TypeScript بنسخ قيمها إلى حيث يتم استخدامها بدلاً من إنشاء كائنات JavaScript.

لذلك ، إذا رأيت فئة معلنة بالكامل أو جزئيًا في أكثر من برنامج نصي واحد في هذا المشروع (على سبيل المثال في كل من البرنامج النصي للخلفية ونصي الصفحة) ، فإن ما سبق هو السبب.

شيء آخر قد يفشل هو استخدام instanceof للتحقق مما إذا كان كائن من فئة معينة. لا تفعل ذلك لفئات تم إنشاؤها المخصصة لأنه قد يفشل بسبب صندوق الرمل.

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل