تحرير ملفات Markdown في مكانها
قد تكون بعض ملفات Markdown خارج مكتبتك: ملف README في مستودع Git، أو ملف في iCloud Drive، أو ملاحظات أرسلها زميل. يستطيع Varlig تعديل هذه الملفات في مواقعها دون نسخها إلى مكتبتك.
فتح ملف
اختر File › Open Markdown File… (⌥⌘O)، أو افتح الملف من Finder باستخدام Open With ▸ Varlig، أو شغّل open -a Varlig notes.md في Terminal. يفتح Varlig ملفات .md و.markdown و.txt وغيرها من ملفات النص العادي المشابهة، حتى حجم 32 MB.
تستخدم نافذة الملف المحرّر الذي تعرفه، وتعرض في أعلاها شارة FILE واسم الملف ومجلده وحالة حفظه. ويُظهر زر المجلد الملف في Finder.
فتح مجلد
اختر File › Open Folder… (⌃⌘O)، أو اسحب مجلدًا وأفلته على أيقونة Varlig في Dock، أو شغّل open -a Varlig ~/Projects/handbook في Terminal. تعرض نافذة المجلد ملفات Markdown والملفات النصية في شريط جانبي، مجمّعة بحسب المجلدات الفرعية. ويمكنك تعديل الملف الذي تختاره بالمحرّر نفسه المستخدم في نافذة الملف. يُفتح ملف README أولًا إن وُجد، وعند العودة يُفتح آخر ملف قرأته.
تتابع القائمة تغيّرات المجلد: تظهر الملفات أو تختفي تلقائيًا عندما يضيفها تطبيق آخر أو أمر git checkout أو يحذفها أو يعيد تسميتها. تُستبعد المجلدات المخفية مثل .git وكذلك node_modules. يرشّح Filter files القائمة بالاسم أو المسار، وينشئ + ملفًا فارغًا باسم Untitled.md بجوار الملف الذي تقرؤه. يؤدي اختيار ملف آخر إلى حفظ الملف الحالي، ويفتح الرابط النسبي إلى ملف في المجلد نفسه داخل النافذة نفسها.
لا يكتب Varlig في المجلد سوى ملفاتك، فلا ينشئ قاعدة بيانات أو إعدادات مخفية. لذلك يظل المجلد سهل النقل كما كان.
الحفظ
تُحفَظ تعديلاتك تلقائيًا بعد نحو ثانية من توقّفك عن الكتابة، ويمكنك حفظها فورًا باستخدام File › Save (⌘S). تعرض المنطقة العلوية الحالة Saved أو Edited أو Save failed مع سبب الفشل.
يحفظ Varlig الملف بالصيغة التي وجده عليها: نهايات الأسطر نفسها، وعلامة ترتيب البايتات نفسها، وسطر جديد في نهاية الملف فقط إذا كان موجودًا أصلًا. تتم الكتابة ذريًا مع الحفاظ على صلاحيات الملف، فتقتصر الفروق التي يعرضها Git على التغييرات الضرورية بوضوح.
يحفظ File › Save As… نسخة في موقع آخر، ثم يواصل تحرير تلك النسخة.
الصور والروابط بجانب الملف
تُفسَّر المراجع النسبية انطلاقًا من مجلد الملف نفسه، لذا يفتح  و[the plan](plan.md) الملفات المتوقّعة، حتى ثلاثة مستويات من المجلدات فوق الملف. وتُحفَظ الصور التي تلصقها أو تسحبها إلى المحرّر بجوار الملف، داخل مجلد مشتق اسمه من اسم الملف، مثل notes.assets/.
تظهر الوسوم و[[note links]] كنص عادي في نافذة الملف؛ فهذه ميزات خاصة بالمكتبة، ولا يوفّر الملف على القرص مكانًا لحفظ بياناتها.
عندما يتغير الملف على القرص
إذا قام شيء آخر بتغيير الملف أثناء إجراء تعديلات غير محفوظة - git pull، عميل مزامنة، محرر آخر - يحتفظ Varlig بكلا الإصدارين ويقول ذلك:
- يُظهر Compare… الاثنين جنبًا إلى جنب، مع تحديد ما هو موجود فقط على القرص وما هو موجود فقط في نافذتك.
- Keep Mine يحفظ الإصدار الخاص بك ويحتفظ بإصدار القرص كنسخة مؤرخة بجانب الملف.
- يعرض Use Disk Version نسخة القرص ويحتفظ بنسختك المؤرخة بجانب الملف.
لا تُستبدَل أيٌّ من النسختين في الحالتين، وتُسمّى النسخ بحيث يمكنك التمييز بينها، مثل notes (disk version 2026-09-22 1415).md.
إذا تم حذف الملف أو نقله أثناء التحرير، يخبرك Varlig ويعرض عليك Save As…، لذلك لن يضيع نصك أبدًا.
حفظ تنسيقات النتائج مع الملف
يُحفَظ تنسيق نتيجة السطر، مثل عدد المنازل العشرية والفواصل وطريقة كتابة الأعداد، وإعداد Subtotal أو Time Point الخاص به في البيانات الوصفية للملف، ضمن سمة موسّعة، بدلًا من كتابته في نص Markdown. يبقى النص كما كتبته تمامًا، وعند فتح الملف مجددًا، سواء في نافذة ملف أو نافذة مجلد، يظهر كل سطر كما تركته. تحتفظ الأسطر التي تعدّلها أو تدرجها أو تنقلها بإعداداتها، وإذا حُذف نص سطر تُحذف إعداداته بدلًا من انتقالها إلى سطر آخر.
لا تحتفظ بعض الأدوات بالسمات الموسّعة، ومنها Git ومعظم أدوات ZIP وبعض خدمات المزامنة والأقراص المهيّأة لنظام Windows. عندئذ تعود التنسيقات إلى إعداداتك الافتراضية، دون التأثير في النص. ولمنع Varlig من استخدام البيانات الوصفية للملف تمامًا، عطّل Remember answer formats in Markdown files في Settings › Editor. هذا الخيار مفعّل افتراضيًا.
ما الذي يختلف في نافذة الملف
- لا يوجد سجل إصدار ولا كلمة مرور ملاحظة ولا نسخ احتياطية: الملف الموجود على القرص هو النسخة الوحيدة.
- تعمل كتل الحساب كالمعتاد. يتم الاحتفاظ بتنسيق الإجابة أو إعداد السطر الذي تختاره لسطر واحد مع الملف، كما هو موضح أعلاه، وليس في نصه.
- تنقلك روابط
varlig://إلى ملاحظة، ولا تشغّل أي إجراءات أتمتة من ملف.