كتابة الخطط
صيغة ملف الخطة، وأنواع العمليات، والخطط ذات الخطوتين، وترتيب الأسطر تلقائيًا.
الصيغة الأبسط: TSV#
سطر لكل تغيير، والأعمدة مفصولة بمسافة جدولة (TAB): المسار القديم، ثم الجديد، ثم السبب (اختياري). المسارات نسبية إلى
المجلد الهدف، والسطر الذي يبدأ بـ # تعليق:
#planfs target ./المكتبة
الفقه/المغني ج1.pdf الفقه/المغني - ابن قدامة/01 - المغني - ابن قدامة.pdf توحيد التسمية
الفقه/المغني ج2.pdf الفقه/المغني - ابن قدامة/02 - المغني - ابن قدامة.pdf توحيد التسمية
كل سطر في هذه الصيغة عملية نقل. والمجلدات الناقصة تُنشأ تلقائيًا، والمجلدات التي تفرغ بعد النقل تُحذف وتُسجَّل (ويعيدها التراجع).
عمليات أخرى: سطر عناوين#
إن احتجت إلى الحذف أو إنشاء مجلد أو إزالة مجلد فارغ، فابدأ الملف بسطر يسمّي الأعمدة:
action from to reason
move وارد/تاريخ بغداد.pdf التاريخ/تاريخ بغداد.pdf نسخة أفضل
delete وارد/تاريخ بغداد (1).pdf نسخة مطابقة بايتًا ببايت
mkdir التراجم
rmdir مجلد قديم فارغ
الحذف لا يكون بخانة فارغة
السطر الذي خانة «إلى» فيه فارغة خطأ، ولا يُفهم حذفًا أبدًا؛ لأن الخانة الفارغة كثيرًا ما تكون نتيجة بحث فشل.
الحذف يُكتب صراحةً بكلمة delete، ويذهب الملف افتراضيًا إلى مجلد عزل (.planfs-trash) يعيده منه التراجع.
JSON وYAML#
{"name": "fix", "target": "./lib",
"ops": [{"op": "move", "from": "a.pdf", "to": "b.pdf", "reason": "خطأ مطبعي"},
{"op": "delete", "from": "c.pdf"}]}
تصلح هذه الصيغة للأسماء التي فيها مسافة جدولة أو سطر جديد، وللأدوات التي تولّد الخطط.
الخطط ذات الخطوتين#
استبدال نسخة بأخرى أفضل يحتاج إلى خطوتين في خطة واحدة: إبعاد القديمة عن اسمها، ثم نقل الجديدة إلى الاسم الذي تحرّر. يفحص planfs كل سطر على الحال التي يتركها ما قبله، فتظهر المعاينة صحيحة كما سيجري التنفيذ تمامًا:
الكتب/تاريخ.pdf مستبعد/تاريخ (300dpi).pdf مسح أضعف
وارد/تاريخ 600dpi.pdf الكتب/تاريخ.pdf مسح أفضل
إذا كانت الأسطر بغير ترتيبها#
إذا وضعت سطر «الملء» قبل سطر «الإخلاء»، أو كتبت تبديلًا بين اسمين (أ ← ب وب ← أ)، فالمعاينة تحجب السطر وتقترح
الحل. والخيار --reorder يرتّب الأسطر ترتيبًا يصلح، ويمرّر أحد طرفي التبديل باسم مؤقت:
planfs swap.tsv --reorder -o swap-ordered.tsv