npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@arabi/core

v1.0.0

Published

It is just a trial to prove that we can.

Downloads

15

Readme

تعريب الجافاسكربت

شريط أيقوني - جافاسكريب بالعربي

لقد تصدرت اللغة الإنجليزية في كل مجالات الحياة بعدما كانت لغة كتاب الله هي اللؤلؤة المتألقة والمبتغى لكل طالب علم، فقد انعكست القاعدة وتبدلت الأوضاع. وأظن أن ما نشر تلك اللغة هي الحروب والغزو الذي قامت به بريطانيا أو الممكلة المتحدة.

فقد وجب علينا نحن المسلمين عموما (والعرب خصوصا) أن نعيد منارة العلم على بحر اللغة العربية وأهمها العلوم التقنية.

كيف نعيد تشغيل منارة العلم

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

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

  • وأيضا من أحدى الاقتراحات أن يتم تقديم منح لطلاب العلم من الناطقين باللغات الأجنبية ليدرسوا في بلادنا وتحفيزهم وحتى إن وصل الأمر أن يُدفع للنابغين منهم مبالغ مالية ليقدروا على تحمل نفقة العيش.

ضوء خافت ينبثق

إنني حينما أبتدأت هذا المشروع، لم تكن المحاولة الأولى، إنما ذلك الشغل الشاغل لمحبي لغتهم والمعتزين بها، التي كانت لغة العلم وستعود بإذن الله. فقد وجدت بعضهم بدأ يوطئ للعلم حتى يسلك طريقه لمكانه الطبيعي.

  • الرياضيات: التي كنت أدرسها ،في الأرض التي ولدت بها مصر، خلال فترة التعليم الأساسي، حيث كانت مميزة عن الفيزياء والكيمياء، محببة للقلب مع محبتنا للأخريين؛ فقلوبنا تهفوا للرموز العربية في المعادلات والحسابات الرياضيات.

  • لغة خوارزم: حيث قام أحد الأخوة بعمل لغة برمجة عربية والتي تختلف في أنها لا تترجم للغة عالية (high-level)، الصفحة الرئيسية.

  • خط.سين: حيث قام "غسان السقاف" بعمله الرائع وتنفيذ الفكرة التي راودتني ففضفضت بها لصديق لي، ثم ببحث على جوجل ظهر لي موقعه (خط). يممكنا القول أنه عرَّب بعضا من latex.

طريق وعر

تنويه: هذه المشكلات تم رصدها في شهر صفر 1442

  • من المشكلات التى تواجهك الآن أن ملف "اقرأني" الذي تقوم جيتهاب بعرضه تجعله بشكل أساسي مكتوبا بالاتجاه من اليسار لليمين، ومما هو مطلوب أن نقوم بتقديم طلب لهم أن يحلوا هذه المشكلة، وبطريقة غير مباشرة أن ننشر إضافة للمتصفحات (مثلا جوجل كروم) بحيث تقوم بتعديل اتجاه الكتاب إذا بدأ السطر بحرف من اللغة العربية.

    والحل الذي انتقيته الآن هو وضع كل سطور (markdown) داخل قسم لغة الوسوم التشعبية، لوت (HTML)، ووضع خاصيته dir=rtl.

  • وأيضا نجد نفس المشكلة في الكود وخصوصا إن أردت الكتابة في "VSCode" وهو ما يمكن حله أيضا بعمل إضافات له لكي يدعم الكتابة من اليمين لليسار، إلى أن يقوموا هم باتاحة الكتابة من اليمين لليسار.

  • ومن العقبات أن الكون يصعب قرآءته لأنه لا يحصل له تلوين "Syntax Hightlighting" كما في باقي اللغات والأكواد البرمجية ولذا يجب أن نقوم بعمل إضافة لمحررات الأكواد.

  • ومشكلة أخرى تتعلق بطبيعة كتابة اللغة العربية، فما وجدته أن اللغات اللاتينية وما يكتب بحروفها تكتب بحروف مقطعة عند التعبير عن الكلمات، على عكس اللغة العربية. وما المشكلة؟ إنها تكمن في أن كافة فروع العلم وحتى المجالات غير العلمية والجوانب المختلفة من الحياة تعتمد على الكلمات المختصرة أو ما يدعى في الإنجليزية بـ "acronym". وحل هذا بسيط جدا وذلك بكتابة الحروف العربية منفصلة أيضا، أبهرتك أليس كذلك؟! لكن يمكننا أن نفعل هذا عند الكتابة بالقلم ولا يمكننا أن نقوم بهذا على الحاسوب أو الهاتف الذكي إلا بوضع مسافات أو أي حرف من غير محارف اللغة مثل النقطة ".". وأنا أقترح أن نجعل مفتاح"CAPS" هو ما يجعل الحروف مقطعة حين الكتابة والضغط عليه متزامنين، وهذا يتطلب إلغاء الوظيفة المعتادة له في اللغات اللاتينية وتوظيفه كما نريد في اللغة العربية.

الحل الجزري

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

بعض الأمثلة

يمكنك الوصول للأمثلة من خلال المسار الفرعي "./أمثلة"، حيث يمكنك النظر فيها مباشرة واستكشاف كيف تم التعريب بناءا على معرفتك بالجافاسكريبت.

استعراض المثال الثاني

لوحة لغة الوسوم التشعبية (لوت)

المثال الرابع "./أمثلة/4.لوحة-لغة-الوسوم-التشعبية/"

هذه مجموعة من وحدات الإكما (ECMAscript 6)، المتصلة معا والتي يتم ترجمتها من خلال المكتبة هذه، ثم يتم تجميعها من خلال مُحَزِّم الويب_باك. كما قمنا بالاستعانة بمحمل البابل لمعالجة الكود وتحويله.


عند تنفيذ سطري الأوامر أدناه، سيفتح لك المتصفح الافتراضي على الخادم المحلي (localhost).

❯ npm i
❯ npm start

استعراض

الخطوات القادمة

  • النهوض بما تم التعليق به داخل الكود، قم بالبحث عن TODO.
  • انتاج "خرائط المصدر" (sourcemaps).
  • إكمال محمل وإضافة ويب_باك.
  • إضافات لمحررات الأكواد للتلوين النحوي (syntax hightling)، وإظهار التوقع الذكي (auto-prediction).
  • واجهة سطر الأمر، و.س.أ، CLI، على هذا المستودع.
  • العمل على التعريب نفسه بخرائط الترجمة، على هذا المستودع.

الترخيص

MIT