مولّد ملف تجاهل Git

طريقة الاستخدام

1. ضع علامة على اللغات والأطر والمحررات وأنظمة التشغيل التي يستخدمها مشروعك. واستخدم مسح الكل للبدء من جديد.
2. اقرأ ملف .gitignore الخاص بك. لكل قالب عنوانه، والسطر الذي تسرده قوالب سابقة يظهر مرة واحدة فقط.
3. اضغط نسخ أو تنزيل، واحفظ النص في ملف باسم .gitignore في المجلد الأعلى من مشروعك.

كيف تُدمج القوالب

يصبح كل قالب تختاره قسماً واحداً يبدأ بسطر عنوان مثل # ==== Node ====. تتبع الأقسام ترتيب القوائم في الصفحة، لذلك يعطي الاختيار نفسه الملف نفسه دائماً.

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

الأسطر المكررة وعلامة !

يقرأ Git أنماط ملف .gitignore بالترتيب، والنمط اللاحق يغلب السابق. والنمط الذي يبدأ بـ ! يعيد تضمين ملف استبعده نمط سابق (gitignore(5)). لذلك لا يُحذف النمط المكرر إلا إذا كانت الأسطر بين نسختيه من نوعه: إن كان النمط يستبعد، فلا يجوز أن يبدأ أي سطر بينهما بـ !، وإن كان يبدأ بـ !، فلا يجوز أن يستبعد أي سطر بينهما. وإلا بقي التكرار، لأنه يغيّر النتيجة.

مصادر القوالب

القوالب الواحد والخمسون نسخ من ملفات github/gitignore، وهي مجموعة القوالب التي يقدمها GitHub للمستودعات الجديدة. ترخّص المجموعة بموجب CC0 1.0 Universal، فتضع القوالب في الملكية العامة. تبقى أسطر كل قالب كما هي باستثناء الدمج، وعناوين الأقسام تستخدم أسماء المشاريع دون ترجمة.

ما الذي لا يغطيه الملف

• لا يعرف الملف الملفات التي تنشئها أدواتك. أضف أسطرها بنفسك، مثل مجلد للرفع أو ملف إعدادات محلي.
• يؤثر النمط في الملفات التي لا يتتبعها git بعد. والملف الذي يتتبعه git أصلاً يبقى متتبعاً حتى تشغّل git rm --cached عليه.
• غالباً ما تنتمي ملفات المحرر والنظام إلى ملف تجاهل عام (core.excludesFile)، فتتجاهلها كل مشاريع حاسوبك دون سطر في ملف المشروع.

الأسئلة الشائعة