Skip to content

Latest commit

 

History

History
192 lines (126 loc) · 18.4 KB

README_ar.md

File metadata and controls

192 lines (126 loc) · 18.4 KB

Contributor Covenant

مشروع PHP واللغة العربية (ar-php.org)

لغة PHP تتحدث العربية - كن مستعدا!

حقوق النشر © 2006-2023 خالد الشمعة.

DOI

English

المهمة والرؤيا

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

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

يقدم هذا المشروع مجموعة من الأدوات التي تمكن مطوري المواقع العربية من تقديم بحث وعرض ومعالجة احترافية للمحتوى العربي بلغة PHP.

تنصيب سهل

لائحة بأهم الوظائف

سجل التعديلات

التوثيق

الانتقال من الإصدار 4.0

الترتيبات اللوجستية للمساهمين

كيف تساهم؟

دعم احترافي

الاقتباس

إذا رغبت في الإشارة إلى مكتبة PHP واللغة العربية في عمل أكاديمي، يمكنك استخدام الاقتباس التالي:

K. Al-Shamaa, Ar-PHP, PHP library for website developers to process Arabic content, 
https://github.com/khaled-alshamaa/ar-php, 2023

أو باستخدام صيغة bibtex

@misc{ar-php,
  title={Ar-PHP, PHP library for website developers to process Arabic content},
  author={Al-Shamaa, Khaled},
  url={https://github.com/khaled-alshamaa/ar-php},
  version = {6.3.4},
  year={2023}
}

أين تم استخدامه؟

برنامج Akeneo: برمجية حرّة مفتوحة المصدر سهلة ومرنة لتنظيم وإثراء كتالوج منتجاتك. حزمة لارافل للتجارة الإلكترونية. [تحقق من ذلك هنا]

برنامج Bagisto: حزمة لارافل للتجارة الإلكترونية. [تحقق من ذلك هنا]

برنامج LimeSurvey: برمجية استبيان مفتوحة المصدر. [تحقق من ذلك هنا و هنا]

برنامج عرب كيبورد: طريقة سهلة للتحويل ما بين لوحة المفاتيح العربية والإنجليزية، والعديد من الأدوات المفيدة للغة العربية. [تحقق من ذلك هنا]

اللغة العربية

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

[اللغة العربية، تقرير]

PHP

PHP هي لغة نصية واسعة الاستخدام وعامة الأغراض، وهي ملائمة بشكل خاص لعمليات تطوير مواقع الويب حيث يمكن تضمينها داخل شيفرة HTML. تستخدم لغة PHP في تشغيل أكثر من 79% من أعلى 10 ملايين موقع على مستوى العالم منها الفيسبوك والويكيبيديا.

[لغة PHP، تقرير]

LGPL

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

[ترخيص LGPL، أسئلة GPL الشائعة]

لمحة تاريخية

محاضرة افتتاحية عن تجربة بناء ادوات لدعم اللغة العربية و المشاريع مفتوحة المصدر - خالد الشمعة

Top

مدخل سريع

التثبيت باستخدام Composer

للتثبيت باستخدام Composer، قم بطلب الإصدار الأحدث من هذه الحزمة.

composer require khaled.alshamaa/ar-php

تأكد من أن ملف التحميل الآلي الخاص بأداة Composer يتم تحميله. لن تحتاج إلى أمر كهذا إن كنت تستخدم composer autoloading كا هو معمول في إطار عمل لارافل.

// somewhere early in your project's loading, require the Composer autoloader
// see: http://getcomposer.org/doc/00-intro.md
require 'vendor/autoload.php';

التنزيل والتثبيت اليدوي

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

require_once 'ar-php/src/Arabic.php';

الوظائف الرئيسية

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

Top

كيف تساهم؟

نحن نرحب دوما بالمساهمين الجدد - خصوصا المبرمجين منهم. لكن بغض النظر عن مهاراتك واهتماماتك، هنالك دوما مجال لمساهمتك في تطوير مشروع Ar-PHP:

  • برمجة: فيما يلي بعض الأفكار للمساهمة: مراجعة قائمة المهام، إضافة ميزة جديدة، المساهمة في الوحدة المركزية، بناء إضافة، تصحيح الأخطاء.
  • ضبط الجودة: يعتبر ضبط الجودة أحد أهم مقومات نجاح أي مشروع برمجي. كما أن الاشتراك بهذا النشاط في متناول أي شخص. إن أردت المساعدة في تنقيح أخطاء Ar-PHP، ولم تكن مبرمجا، فلا يزال باستطاعتك المساعدة من خلال الإنضمام إلى فريق ضبط الجودة.
  • الكتابة: إحدى أفضل الأساليب للمساهمة في مشروع Ar-PHP هو كتابة الدروس التعليمية أو أدلة الاستخدام أو خطوات التطبيق أو الأسئلة الشائعة. فيما يلي بعض الأفكار للمساهمة: أسئلة المستخدمين المتكررة، الدروس التعليمية وخطوات التطبيق، دليل المستخدم، دليل المطور، نشر تدوينات، أو مقالة لمجلة.
  • التسويق: يمكنك دوما المساعدة في إشهار ونشر استخدام Ar-PHP، فيما يلي بعض الطرق للمساعدة في ذلك: انضم إلى فريق التسويق، توزيع Ar-PHP، نشرة حول مشروع Ar-PHP.
  • الفن والرسوميات: هل لديك أي مهارات فنية؟ إذن باستطاعتك مساعدتنا من خلال تصميم الأيقونات والشعارات والأشرطة الدعائية وخلفيات الشاشة إضافة إلى شاشات التوقف وغيرها الكثير! إن مثل هذه المساهمات ستكون ظاهرة للعيان بشكل يومي ومستخدمة في المشروع ومنتجاته.
  • مساعدة المستخدمين: هنالك طريقتين باستطاعتك مساعدة غيرك من المستخدمين من خلالهما هما قوائم البريد الإلكتروني للمستخدمين والمنتديات.
  • احتفل معنا! مهمتك هي أخذ صورة لك وأنت تدعم مشروع PHP واللغة العربية. يمكنك الذهاب إلى موقع شهير، أو مكانك المفضل في الجوار، أو أي مكان تعتقد أنه موقع مناسب لصورة ناجحة. قمنا بإنشاء بعض الملصقات الإعلانية من أجلك لتستخدمها في صورك. قم بطباعة إحدى هذه التصاميم أو قم باستخدام التصميم الخاص بك. نحن نرغب في رؤيتك أنت وموقعك بشكل واضح في الصورة، لذا لا تدع أي من هذين العنصرين يطغى على الصورة. كما يجب أن نرى أيضا الملصق الإعلاني للمشروع. حالما تكون صورك جاهزة، أرسلهم لنا بالبريد الإلكتروني. رجاء أرسل صورك بتنسيق jpg أو png وبحجم 1200 x 800 بيكسل على الأقل.

Top

الدعم الاحترافي

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

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

Top