شرح قالب .gitignore لـ Jupyter Notebooks

JupyterNotebooks.gitignore قالب قصير في مجلد community بمستودع القوالب، لا يتناول إلا الملفات التي ينشئها Jupyter وIPython بجوار دفاتر الملاحظات. لا يتضمن البيئات الافتراضية ولا __pycache__، لذا يُستخدم مع قالب Python.

نتائج التنفيذ والصور المحفوظة داخل ملف الدفتر (.ipynb) ليست مما يعالجه gitignore. فهي مسألة محتوى الملف لا الملف نفسه، وتُعالج بأدوات منفصلة.

شرح القواعد

النمط	ما الذي يتجاهله ولماذا
.ipynb_checkpoints*/.ipynb_checkpoints/*	نقاط الحفظنسخ ينشئها Jupyter عند الحفظ التلقائي في كل مجلد يحوي دفترًا. السطر الأول يطابق مجلدات نقاط الحفظ على أي عمق، والثاني يلتقط صراحةً محتوى المجلد الذي يقع مستوى واحدًا أدنى.
profile_default/ipython_config.py	إعدادات IPythonمجلد ملف تعريف IPython وملف إعداداته، وقد تدخلهما معلومات شخصية مثل قاعدة بيانات سجل التنفيذ.
.virtual_documents/	JupyterLab LSPمجلد المستندات الافتراضية الذي تنشئه إضافة jupyterlab-lsp لتمرير الدفاتر إلى خادم اللغة.

ملاحظات عملية

• لتجنب إيداع مخرجات الدفاتر ثبّت nbstripout كمرشّح (filter) في git، أو اعتد مسح المخرجات قبل الإيداع.
• لا يحجب هذا القالب ملفات البيانات الكبيرة (data/ و*.csv و*.parquet). أضفها بنفسك عند الحاجة أو استخدم DVC أو Git LFS.
• إن كنت تضع مفاتيح API في .env وتقرؤها من الدفتر، فستحتاج معه إلى قاعدة .env من قالب Python.

القالب الأصلي

# gitignore template for Jupyter Notebooks# website: http://jupyter.org/.ipynb_checkpoints*/.ipynb_checkpoints/*# IPythonprofile_default/ipython_config.py# Jupyter lab virtual documents# https://jupyterlab-lsp.readthedocs.io/en/2.x/Configuring.html#virtual_documents_dir.virtual_documents/# Remove previous ipynb_checkpoints#   git rm -r .ipynb_checkpoints/

قوالب تُستخدم معه