الصفحة الرئيسية>موارد بناء الموقع>بيانات الموقع
تنزيل

Haxe Code Cookbook

مصادر لموقع كتاب طبخ Haxe ، موقع موارد مدفوعة بالمجتمع لتعلم Haxe في الممارسة العملية.

يحتوي المستودع على مولد موقع ويب ثابت ، يحول مقالات Markdown إلى موقع ويب. يتم تطوير المشروع هنا على Github ، لا تتردد في المساهمة بمقتطفات الرمز والبرامج التعليمية المتعلقة بـ Haxe.

بناء

  • المقالات الفعلية في الأصول/المحتوى/كتاب الطبخ ، منظم لكل مجلد.
  • ملفات قالب HTML في الأصول/المحتوى/.
  • ملفات الملفات الثابتة (CSS ، JS ، الصور) موجودة في الأصول/تتضمن/.
  • ملفات مصدر Haxe للمولد موجودة في SRC/.
  • سيتم إخراج المحتوى الذي تم إنشاؤه بواسطة موقع الويب في output/ (مستبعد من GIT).

المساهمة

التغييرات المساهمة

للمساهمة في التغيير ، عليك تقديم طلب سحب. يمكن القيام بذلك باستخدام موقع GitHub أو عن طريق الشوكة/استنساخ المشروع.

المساهمة في استخدام Github كمحرر عبر الإنترنت

هذه هي أسهل طريقة لإجراء تغييرات صغيرة:

  • انتقل إلى مقال على https://code.haxe.org واضغط على زر التحرير في أي صفحة: صورة
  • يتم إعادة توجيهك إلى جيثب. بمجرد أن يكون لديك حساب وتسجيل الدخول ، يمكنك إجراء التغيير في المحرر عبر الإنترنت.
  • اضبط الوصف / ما قمت بتغييره واضغط على زر تغيير الطلب : صورة
  • سيتم إنشاء طلب سحب. Github يجعل شوكة لك تلقائيا.
المساهمة باستخدام شوكة

هذا من شأنه أن يسمح أيضًا باختبار/رؤية التغييرات قبل إرسالها والتي تكون مفيدة أيضًا عندما تريد إضافة صفحات جديدة.

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

إنشاء مقالات

يرجى إضافة/تحرير المقالات (ملفات Markdown) في مجلد الأصول والقيام بطلب سحب. يتضمن نطاق كتاب الطبخ اللغة الأساسية والمكتبة القياسية وأيضًا أي مكتبات تحتفظ بها مؤسسة Haxe.

التنسيق

سيكون من الرائع إذا احتفظت بتنسيق الكود بنفس النمط المستخدم بالفعل:

  • الأقواس على نفس الخط.
  • المسافة البادئة ثنائية الفضاء.
  • لا توجد تلميحات نوع للمتغيرات المحلية وإرجاع الوظيفة ما لم تكن مفيدة.
  • نوع تلميحات للحقول.
  • اكتب تلميحات لوسيطات الوظيفة ما لم تكن واضحة للغاية.
  • الاستخدام الحكيم لخطوط الخطوط الإضافية لتجنب الفواصل التلقائية القبيحة (تحقق من الإخراج).

ملاحظات أخرى

  • يتم استخدام العنوان الأول في الملاحة. الحفاظ على هذا العنوان قصيرة.
  • يتم استخدام الفقرة الأولى كوصف. صف ما يدور حوله محتوى المقالة.
  • استخدم > Author: [Name](https://github.com/username) لتمييز نفسك كمؤلف للمقال. يتم استنتاج المساهمين الآخرين من الالتزامات git.
  • ضع علامة على المقالة باستخدام [tags]: / "tag1,tag2" (بدون مسافات). حاول استخدام علامة موجودة.
  • اذكر المؤلف / المصادر في أسفل الصفحة.
  • إذا كنت ترغب في تضمين مقتطفات Code Try.haxe.org ، فاستخدم [tryhaxe](https://try.haxe.org/embed/76f24) .
  • إذا كنت ترغب في تضمين فيديو على YouTube ، استخدم [youtube](https://www.youtube.com/watch?v=dQw4w9WgXcQ) .
  • إذا كان ذلك ممكنًا ، ارتباط بالصفحات ذات الصلة في وثائق Haxe Manual / API.
  • إذا كنت ترغب في استخدام الصور أو غيرها ، قم بإنشاء مجلد يسمى Assets في نفس الدليل مثل المقالة والربط بذلك.

سيكون هذا قالبًا نموذجيًا للاستخدام. استخدم ```haxe لتمييز بناء الجملة:

 [علامات]: / "الفصل ، صفيف ، JSON ، حقول البناء"

# عنوان الصفحة

الوصف وشرح الكود.

## تطبيق
`` `haxe
الفئة الرئيسية {
  // الكود هنا
}
`` `

## الاستخدام

وصف كيفية استخدام/اختبار الرمز.

`` `haxe
اختبار الفئة {
  // الكود هنا
}
`` `

> المزيد حول هذا الموضوع: 
> 
> * [حقل الفئة في دليل Haxe] (https://haxe.org/manual/class-field.html)
> 
> المؤلف: [الاسم] (https://github.com/username)

تشغيل نسخة محلية

لتشغيل المشروع ، يمكنك استخدام Neko:

استدعاء neko CodeCookBook.n لإعادة توصيل ملفات الإخراج.

المساهمة في المولد

تحتاج إلى Haxe 3.4.2+ مثبت.

يعتمد مصدر مولد الموقع الثابت على Hxtemplo و Haxe-Markdown.

قم بتثبيت المكتبات باستخدام Haxelib ، قم بتشغيل الأمر التالي في جذر المشروع: 

 haxelib install all

يتم ضغط ملفات CSS باستخدام أقل. التثبيت من NPM: 

 npm install -g less
npm install -g less-plugin-clean-css
يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل