العربية | English
ترجمة عربية مستقلة لموقع Go by Example، وهو مدخل عملي إلى لغة Go يعتمد على برامج نموذجية مشروحة.
تُدار هذه الترجمة كموقع مستقل وتتبع أمثلة المشروع الأصلي وسلسلة أدوات بنائه.
عنوان الموقع: https://0xKa.github.io/gobyexample-ar/
- اكتملت ترجمة الأمثلة الـ85 ومراجعتها؛ راجع جدول الأمثلة.
- تدعم الواجهة العربية اتجاه RTL مع إبقاء الكود باتجاه LTR.
- تتحقق CI من سلامة الترجمة وتطابق الملفات المولّدة مع مصادرها.
- يُنشر الموقع تلقائيًا من
masterعبر GitHub Actions بعد تفعيل Pages واختيار GitHub Actions مصدرًا للنشر.
توجد النصوص الأصلية والكود في examples. تستخرج أداة البناء الشروح من ملفات .go و.sh، ثم تدمجها مع القوالب الموجودة في templates وتولد موقعًا ثابتًا داخل public.
| Path | Purpose |
|---|---|
examples/ |
Code and commentary representing the primary source content |
examples.txt |
Ordering of examples and original English names used to derive permalinks |
examples.ar.txt |
Arabic titles corresponding to constant example IDs |
templates/ |
HTML templates, CSS styles, JavaScript, and shared assets |
tools/ |
Scripts for testing, building, generating, and running a local development server |
public/ |
The generated static website; never edit manually |
تحتاج إلى إصدار 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.