43

إضافة توثيق jQuery إلى موسوعة حسوب

أكملنا اليوم في موسوعة حسوب العمل على توثيق مكتبة jQuery.

jQuery هي مكتبة من مكتبات JavaScript السريعة والخفيفة والمليئة بالميزات، والتي تسهل تعديل مستندات HTML، والتعامل مع الأحداث، وإنشاء الحركات، واستعمال Ajax، وذلك بتوفير واجهة برمجية موحدة تعمل على جميع المتصفحات.

https://wiki.hsoub.com/jQuery

هذا يعني أصبح لدينا في مجال تطوير واجهات المواقع توثيقٌ كامل لتقنيات HTML و CSS و JavaScript و Bootstrap و Sass و jQuery:

https://wiki.hsoub.com/HTML https://wiki.hsoub.com/CSS https://wiki.hsoub.com/Java... https://wiki.hsoub.com/Boot... https://wiki.hsoub.com/Sass

إضافةً إلى ما عملنا عليه من توثيقٍ للغة PHP و Python و Kotlin و SQL في السابق:

https://wiki.hsoub.com/PHP https://wiki.hsoub.com/Python https://wiki.hsoub.com/Kotlin https://wiki.hsoub.com/SQL

والعمل جارٍ على غيره من توثيق اللغات والتقنيات.

أذكِّركم أنَّ باب المساهمة مفتوحٌ لجميع المتطوعين الراغبين بإثراء المحتوى التقني التخصصي باللغة العربية، سواءً بكتابة أو ترجمة صفحات التوثيق، أو بالمساعدة في التحرير وإضافة الأمثلة.

https://wiki.hsoub.com

موسوعة_حسوب:دليل_المساهمين

يرجى الدخول لحسابك أو تسجيل حساب لتستطيع إضافة تعليق
حساب جديد دخول

التعليقات

10

لمن كان جديدًا على jQuery ويرغب بالبدء بتعلمها، فأنصحه بالاطلاع على كتابي الذي نشرته السنة الماضية بعنوان «تعلم jQuery»:

أتمنى لكم مزيدًا من التقدم والإزدهار، حسوب حقًا باتت في مهمة لتطوير العالم العربي ^^

مجهول
  • حذف بواسطة المستخدم
مجهول أضف ردا

لست صاحب الموضوع لكني ارى ان ترجمة الكلمات التقنية امر غير مهم (او بالاحرى غير مفيد) , برأي عندما تريد تعريف كلمة method مثلًا من الافضل ان تضع الكلمة (مع التعريف) ثم بين قوسين ترجمة الكلمة , و عندما تذكر المصطلح (بين الدروس) اذكره باللغة الانكليزية , اساسًا انت عندما تصبح بمستوى متقدم و عندما تنتقل للمحتوى الانكليزي ستتعامل مع المصطلحات باللغة الانكليزية و ليس العربية .

مجهول
  • حذف بواسطة المستخدم
مجهول أضف ردا

العربية ستندثر

لا ادري لماذا كل هذه النظرة التشائمية عن اللغة رغم انها لم و لن تندثر طالما ما زال هناك من يكتبون بها .

كلما سأكتب مقالة عليَّ تعريف جميع المصطلحات التقنيّة فيه؟ مَنْ قد يفعل هذا الهراء؟

لا لا , اقصد لنفترض مثلًا انت تكتب سلسلة مقالات/دروس عن برمجة كائنية في سي++ مثلًا , و عندما تريد تعريف الـــ class مثلًا ضع الكلمة و بين قوسين ترجمة الكلمة ثم التعريف ... إلخ

انت بالطبع لن تشرح كل حرف ....

سيصبح عندها لدي "سلطة لغات" وليس مقالة.

هههه

كلامك، مع الاحترام لك، مجمله عاطفي وليس مبنيّاً على شيء واقعي. هناك سوق تقني فرنسي، وآخر ألماني، > فلِماذا لم يتبِع هؤلاء نهجك وتوقفوا عن الترجمة؟ ولِماذا لا يحدث المثل مع العربيّة (بالرغم من قوّتها مقارنةً مع > غيرها)؟

انا لا ادعو لقتل للغة , انت تتحدث عن ترجمة المصطلحات التقنية و انا اخبرتك انه امر لا يستحق كل هذا الاهتمام لان QUORA و stack overflow محتواها بالانكليزية يعني اذا جعلت المتعلم يحفظ المصطلحات بالعربية ثم يتعمق بالمعلومات عن طريق المحتوى الانكليزي هكذا قد تجعله يضيّع اكثر ما يتعلم .....

مجهول
  • حذف بواسطة المستخدم
مجهول أضف ردا

ربما ما سأتكلم عنه لا علاقة له بالموضوع ولكن ما سأسرده يعبر عن مشكلة ترجمة المصطلحات .

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

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

لنقل أن ترجة المصطلحات سيسبب الكثير من المشاكل في الفترة الأولى ولن ينجح على الأغلب

*مثلما كان الأوربيون يحفظون أسماء النجوم مثلا و بعض المصطلحات الأخرى باللغة العربية

سنضطر نحن أيضا لتعلم تلك المصطلحات التي اختروعوها باللغة الأجنبية أيضا

حسنا يبدو أنني كتبت بطريقة غبية قليلا ولكن أتمنى أن تكون فهمت المبتغى

مجهول
  • حذف بواسطة المستخدم

لا يوجد تعريب مثالي اختر التعريب الشائع وضع الكلمة الأعجمية بين القوسين ولا تضيع وقتك باصلاح ما يعمل، ما يهم القارئ هو المعلومة النهائية..

مجهول
  • حذف بواسطة المستخدم

التعريب الشائع ليس بالضرورة أن يكون صحيحاً، إضافةً إلى أنَّه أحياناً لا يكون هناك تعريب أصلاً! فأخبرني، لِمَ علينا التكاسُل وعدم إيجاد حلول أفضل؟

المشكلة الرئيسية هي عدم تقبل المجتمع للترجمات الجديدة الصحيحة، وأحيانًا يعتاد الناس على المصطلحات الأجنبية دون التفكّر بمعناها.

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

أصبح المصطلح السابق شائعًا بين الناس في عصر الحاسوب، ولم يقف أحدٌ عند معناه لينظر من أين أتى، وإذا ترجمنا المصطلح إلى «لف الصفحة إلى الأعلى» أو «اللف نحو الأسفل» فسيقولون لك: «من أين تأتي بهذه المصطلحات العجيبة؟!».

الأمر مماثل لكثيرٍ من المصطلحات الأخرى، سواءً كانت في المجال التقني أو في مجالات أخرى (كالمصطلحات التي درسناها في الهندسة المدنية).

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

مجهول
  • حذف بواسطة المستخدم

التعريب الشائع ليس بالضرورة أن يكون صحيحاً، إضافةً إلى أنَّه أحياناً لا يكون هناك تعريب أصلاً! فأخبرني، لِمَ علينا التكاسُل وعدم إيجاد حلول أفضل؟

التوحد على مصطلح واحد أفضل بكثير من التشتت إلى أكثر من مصطلح حتى ولو أصح.

لربما هذا أكثر شيء يكرهه المُترجِم. حان الوقت لننتهي من مسألة وضع المصطلح الأجنبي بين قوسين. (أظن أنَّ الأخ عبد اللطيف يفهمني بهذه النقطة تحديداً).

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

مجهول
  • حذف بواسطة المستخدم

وبك أيضًا، وأرجو أن نعمل سويةً على تطوير الموسوعة.

هل لديكم قاموس معياري تستخدمونه في الترجمة؟ أم مثلاً تستخدمون قاموس مُعين (ككقاموس عربايز)؟

نعتمد على قاموس عربآيز في الغالب، مع تغيير بعض المصطلحات التي قد لا تناسب الموسوعة.

هل ناقشتم موضوع كتابة اسماء العلم (اسماء التقنيات واللغات) واخترتم طريقة معياريّة؟

نعتمد على ما هو شائع ومتداول عربيًا، فليس من المنطقي أن نقول «جيكويري» أو «بي إتش بي» وإنما «jQuery» و «PHP»، بينما كلمة بايثون شائعة جدًا بالعربية، ولا حرج في استخدامها.

هل تلك المواضيع مازلت تٌناقَش أثناء تطويركم للتوثيقات؟

نعم، عند أول تعامل بيني وبين أحد المساهمين في الموسوعة، أطلب منه أن يضع أول عدّة صفحات من عمله على Google Docs ويشارك معي الملف، وذلك لكي نتناقش في موضوع المصطلحات، وبنية الصفحة، وأسلوب الكتابة؛ إذ نحرص حرصًا بالغًا على أن تكون الصفحات متناسقةً ومتناغمةً فيما بينها، فلا نريد لصفحةٍ أن تختلف عن صفحةٍ أخرى.

أي أن عملية ضبط الأسلوب والبنية والمصطلحات هي عملية فردية نجريها مع كل شخص على حدة.

فهل طرحتم معيار مُشابه (أو تبنيتم واحداً) لكي أطّلع عليه واستفيد منه، أم مازلتم تعملون على واحد؟

طرحنا فكرة إنشاء قاموس أو ما يشبه الموجود في موزيلا، لكن الأولوية في الفترة الحالية للتوسع بإضافة التوثيقات، بدل الانشغال بإنشاء القاموس:

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

مجهول
  • حذف بواسطة المستخدم

خطوات جميلة لدعم المحتوى العربي بالنسبة لي كمطور قديم ما زلت متعود على المصادر الانجليزية وعندما تحدث لي اي مشكلة ابحث مباشرة باللغة الانجليزية، هل يوجد احد تحول من البحث من اللغة الانجليزية الى اللغة العربية مثلي؟

لا اعلم لماذا كتبت كلمة مثلي فانا لم اتحول من البحث باللغة الانجليزية الى العربية.

ماذا لو تم اختراق الموقع أو حذفت الملفات بشكل أو بآخر؟

هل ستذهب جهود العاملين سدى؟

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

هل من الممكن مستقبلا ان نرى امثلة على كل شفرة برمجية كما يفعل موقع w3school ؟

نعم، بدأنا الإعداد للأمر، وسيكون شاملًا لجميع اللغات التي نوثّقها إن شاء الله.