لغة Go بالأمثلة

ترجمة عربية مستقلة لموقع Go by Example، وهو مدخل عملي إلى لغة Go يعتمد على برامج نموذجية مشروحة.

Arabic translation of Go by Example. This translation is maintained as a separate website and follows the upstream examples and build toolchain.

عنوان الموقع : https://0xKa.github.io/gobyexample-ar/

حالة المشروع

• اكتملت ترجمة الأمثلة الـ85 ومراجعتها؛ راجع جدول الأمثلة.
• تدعم الواجهة العربية اتجاه RTL مع إبقاء الكود باتجاه LTR.
• تتحقق CI من سلامة الترجمة وتطابق الملفات المولّدة مع مصادرها.
• يُنشر الموقع تلقائيًا من master عبر GitHub Actions بعد تفعيل Pages واختيار GitHub Actions مصدرًا للنشر.

كيفية عمل المشروع

توجد النصوص الأصلية والكود في examples. تستخرج أداة البناء الشروح من ملفات .go و.sh، ثم تدمجها مع القوالب الموجودة في templates وتولد موقعًا ثابتًا داخل public.

المسار	الغرض
examples/	الكود والشروح التي تمثل مصدر المحتوى الأساسي
examples.txt	ترتيب الأمثلة وأسماؤها الأصلية المستخدمة لاشتقاق الروابط الثابتة
examples.ar.txt	العناوين العربية المرتبطة بمعرّفات الأمثلة الثابتة
templates/	قوالب HTML وملفات CSS وJavaScript والأصول المشتركة
tools/	أدوات الاختبار والبناء والتوليد والخدمة المحلية
public/	الموقع الثابت المولّد؛ لا يُحرر يدويًا

البناء والمعاينة محليًا

تحتاج إلى إصدار Go المحدد في go.mod وبيئة Bash. على Windows يمكن استخدام Git Bash أو WSL.

لبناء الموقع وتحديث public:

$ tools/build

للتحقق من أن الملفات المولّدة مطابقة للمصادر:

$ VERBOSE=1 TESTING=1 tools/build

لمعاينة الموقع:

$ tools/serve

ثم افتح http://127.0.0.1:8000/.

المساهمة

نرحب بتصحيح الترجمات، وتوحيد المصطلحات، ومراجعة الدقة التقنية، ومزامنة التغييرات القادمة من المشروع الأصلي.

اقرأ قبل البدء:

• دليل المساهمة
• مسرد المصطلحات
• جدول الأمثلة

يجب تعديل ملفات المصدر ثم تشغيل أداة البناء وإرفاق التغييرات المولّدة في public. لا تُقبل التعديلات التي تغير public وحده.

المزامنة مع المشروع الأصلي

هذا المستودع ترجمة مستقلة وليس بديلًا عن المشروع الأصلي. تُجلب إصلاحات الكود والأمثلة الجديدة من mmcgrana/gobyexample، ثم تُترجم الشروح الجديدة قبل دمجها في فرع النشر.

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

النسب والرخصة

المحتوى الأصلي من إعداد Mark McGranaghan وEli Bendersky، ويتوفر الكود المصدري في المستودع الأصلي.

حقوق العمل الأصلي محفوظة لـ Mark McGranaghan، وهو منشور بموجب رخصة المشاع الإبداعي: النسب 3.0 غير موطنة. تحافظ هذه الترجمة على نسب العمل الأصلي وروابط مصدره ورخصته.

شعار Go Gopher من تصميم Renée French ومتاح بموجب الرخصة نفسها.

الترجمة العربية بإشراف 0xKa.

شكر

استُلهم المشروع الأصلي من Docco الذي أنشأه Jeremy Ashkenas.