ورّاق

الرئيسية planfs

كتابة الخطط

صيغة ملف الخطة، وأنواع العمليات، والخطط ذات الخطوتين، وترتيب الأسطر تلقائيًا.

الصيغة الأبسط: 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

حرّر هذه الصفحة