gitignore

مجموعة من قوالب .gitignore

هذه هي مجموعة Github لقوالب ملفات .gitignore . نستخدم هذه القائمة لملء مختارات القالب .gitignore المتوفرة في واجهة GitHub.com عند إنشاء مستودعات وملفات جديدة.

لمزيد من المعلومات حول كيفية عمل ملفات .gitignore ، وكيفية استخدامها ، فإن الموارد التالية هي مكان رائع للبدء:

• فصل ملفات تجاهل كتاب Pro Git.
• مقالة ملفات تجاهل على موقع مساعدة GitHub.
• الصفحة اليدوية Gitignore (5).

هيكل المجلد

نحن ندعم مجموعة من القوالب ، منظمة بهذه الطريقة:

• يحتوي المجلد الجذر على قوالب شائعة الاستخدام ، لمساعدة الأشخاص على البدء في لغات البرمجة والتقنيات الشهيرة. تحدد هذه مجموعة من القواعد ذات معنى للمساعدة في البدء ، والتأكد من أنك لا ترتكب ملفات غير مهمة في مستودعك.
• يحتوي Global على قوالب لمختلف المحررين والأدوات وأنظمة التشغيل التي يمكن استخدامها في مواقف مختلفة. يوصى بإضفاء إضافة هذه إلى القالب العالمي أو دمج هذه القواعد في قوالب خاصة بالمشروع إذا كنت ترغب في استخدامها بشكل دائم.
• يحتوي community على قوالب متخصصة للغات والأدوات والمشروع الشهيرة الأخرى ، والتي لا تنتمي حاليًا إلى القوالب الرئيسية. يجب إضافة هذه إلى القوالب الخاصة بالمشروع عندما تقرر تبني الإطار أو الأداة.

ما الذي يجعل قالب جيد؟

يجب أن يحتوي القالب على مجموعة من القواعد لمساعدة مستودعات GIT على العمل مع لغة برمجة أو إطار أو أداة أو بيئة محددة.

إذا لم يكن من الممكن تنظيم مجموعة صغيرة من القواعد المفيدة لهذا الموقف ، فإن القالب ليس مناسبًا لهذه المجموعة.

إذا كان القالب في الغالب قائمة بالملفات المثبتة بواسطة إصدار معين من بعض البرامج (مثل إطار عمل PHP) ، فقد يعيش تحت دليل community . راجع قوالب الإصدار لمزيد من التفاصيل.

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

قم بتضمين التفاصيل عند فتح طلب السحب إذا كان القالب مهمًا ومرئيًا. قد لا نقبله على الفور ، ولكن يمكننا الترويج له إلى الجذر في تاريخ لاحق بناءً على الفائدة.

يرجى أيضًا فهم أننا لا نستطيع سرد كل أداة موجودة على الإطلاق. هدفنا هو تنظيم مجموعة من القوالب الأكثر شيوعًا والمفيدة ، وليس للتأكد من تغطية كل مشروع ممكن. إذا اخترنا عدم تضمين لغتك أو أداة أو مشروعك ، فهذا ليس لأنه ليس رائعًا.

الإرشادات المساهمة

نود أن تساعدنا في تحسين هذا المشروع. لمساعدتنا في الحفاظ على هذه المجموعة عالية الجودة ، نطلب أن تلتزم المساهمات بالإرشادات التالية.

• قدم رابطًا للتطبيق أو الصفحة الرئيسية للمشروع . ما لم تكن شائعة للغاية ، فهناك فرصة لا يعرف المشروعون أو يستخدمون اللغة أو الإطار أو المحرر أو التطبيق أو المشروع الذي ينطبق عليه تغييرك.

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

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

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

• يرجى فقط تعديل قالب واحد لكل طلب سحب . يساعد هذا في الحفاظ على طلبات السحب والتعليقات التي تركز على مشروع أو تقنية محددة.

بشكل عام ، كلما يمكنك القيام به لمساعدتنا على فهم التغيير الذي تقوم به ، كلما زاد احتمال قبول مساهمتك بسرعة.

قوالب ذات إصدار

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

• يجب أن يكون القالب في الجذر هو الإصدار المدعوم الحالي
• يجب ألا يحتوي القالب الموجود في الجذر على نسخة في اسم الملف (أي "دائمة الخضرة")
• يجب أن تعيش الإصدارات السابقة من القوالب تحت community/
• يجب أن تضمن الإصدارات السابقة من القالب الإصدار في اسم الملف ، لقابلية القراءة

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

قوالب متخصصة

إذا كان لديك قالب ترغب في المساهمة ، لكنه ليس سائدًا تمامًا ، فيرجى التفكير في إضافة هذا إلى دليل community تحت مجلد أفضل دعوى حيث ينتمي.

يجب أن تكون القواعد الموجودة في القالب المتخصص خاصًا بالإطار أو الأداة ، ويجب ذكر أي قوالب إضافية في تعليق في رأس القالب.

على سبيل المثال ، قد يعيش هذا القالب في community/DotNet/InforCRM.gitignore :

 # gitignore template for InforCRM (formerly SalesLogix)
# website: https://www.infor.com/product-summary/cx/infor-crm/
#
# Recommended: VisualStudio.gitignore

# Ignore model files that are auto-generated
ModelIndex.xml
ExportedFiles.xml

# Ignore deployment files
[Mm]odel/[Dd]eployment

# Force include portal SupportFiles
!Model/Portal/*/SupportFiles/[Bb]in/
!Model/Portal/PortalTemplates/*/SupportFiles/[Bb]in

سير العمل المساهمة

إليك كيف نقترح عليك اقتراح تغيير في هذا المشروع:

1. مفترق هذا المشروع إلى حسابك.
2. إنشاء فرع للتغيير الذي تنوي إجراءه.
3. قم بإجراء تغييراتك على شوكة
4. أرسل طلب سحب من فرع شوكة إلى فرعنا main .

يعد استخدام الواجهة المستندة إلى الويب لإجراء تغييرات أمرًا جيدًا أيضًا ، وسيساعدك عن طريق التغلب تلقائيًا على المشروع ودعوى إرسال طلب سحب أيضًا.

رخصة

CC0-1.0.