ترجمة عربية مستقلة لموقع 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.