مقارنة الأكواد البرمجية

كيفية المقارنة بين مقطعين من الشيفرة

1. الصق النسخة القديمة في الشيفرة الأصلية والنسخة الجديدة في الشيفرة المعدّلة.
2. اختر اللغة، أو اتركها على اكتشاف تلقائي: تخمّن الأداة اللغة من الشيفرة وتعرض اللغة المكتشفة بجانب الإحصاءات.
3. اختر العرض: جنبًا إلى جنب أو مدمج (موحّد).
4. اضبط الخيارات التي تحتاجها: تجاهل المسافات والإزاحة، وتجاهل حالة الأحرف، وإبراز الكلمات المتغيرة، وعرض التغييرات فقط (3 أسطر من السياق).
5. انقر قارن. بعد المقارنة الأولى، تتابع النتيجة تعديلاتك أثناء الكتابة.
6. انقر نسخ بصيغة diff موحّدة أو تنزيل ملف .diff لإعادة استخدام التغيير كرقعة (patch).

يبادل زر تبديل الجانبين بين النسختين، فتتحول الإضافات إلى حذوفات والعكس.

قراءة نتيجة المقارنة

الأسطر المحذوفة ملوّنة بالأحمر وتنتمي إلى النسخة الأصلية، والأسطر المضافة ملوّنة بالأخضر وتنتمي إلى النسخة الجديدة. ويحتفظ كل سطر برقمه في ملفه، لتنتقل إليه مباشرةً في محررك.

• جنبًا إلى جنب يضع الملفين في عمودين مرقّمين، ويجاور السطر المعدَّل نسخته الجديدة. ومع إبراز الكلمات المتغيرة تُعلَّم الكلمات التي تغيّرت داخل السطر؛ ومن دونه يحتفظ السطران بألوان الصياغة كاملة.
• مدمج (موحّد) يعرض عمودًا واحدًا كما في مراجعة الشيفرة: لكل كتلة متغيرة تأتي الأسطر المحذوفة (−) أولًا، ثم الأسطر المضافة (+)، مع رقمي السطر القديم والجديد.
• عرض التغييرات فقط (3 أسطر من السياق) يطوي المقاطع الطويلة غير المتغيرة في علامة «⋯ N سطرًا دون تغيير»، ما يسهّل مراجعة الملفات الكبيرة كثيرًا.

ويحصي سطر الإحصاءات الأسطر المضافة والمحذوفة وغير المتغيرة.

تلوين الصياغة

يجري التلوين في متصفحك بمكتبة highlight.js. ولا تُحمَّل إلا قواعد اللغة المختارة، عند أول مقارنة، لتبقى الصفحة خفيفة. تشمل اللغات المدعومة JavaScript وTypeScript وPython وJava وC# وC / C++ وGo وRust وPHP وRuby وCSS وHTML / XML وJSON وYAML وSQL وBash / Shell وMarkdown. يعتمد الاكتشاف التلقائي على قرائن بسيطة (الكلمات المفتاحية، والأقواس، ومحاولة تحليل JSON)؛ فإن أخطأ التخمين، فاختر اللغة بنفسك أو اختر نص عادي.

المسافات والإزاحة ونهايات الأسطر

يقارن خيار تجاهل المسافات والإزاحة الأسطر بعد تشذيب أطرافها ودمج تتابعات المسافات وعلامات الجدولة، فلا يظهر أي فرق في ملف أُعيدت إزاحته من مسافتين إلى 4 مسافات، أو من علامات الجدولة إلى المسافات. وتُوحَّد نهايات الأسطر في Windows (CRLF) وUnix (LF) قبل المقارنة، فيُعدّ الملف الذي لم يتغير فيه سوى نهايات الأسطر مطابقًا. لاحظ أن المسافات قد تكون مهمة في Python وYAML وملفات Makefile: عطّل الخيار عندما تكون للإزاحة دلالة.

صيغة diff الموحّدة

تستخدم الرقعة المصدَّرة الصيغة الموحّدة القياسية التي يقرؤها git apply وpatch وأدوات مراجعة الشيفرة: ترويسة باسمي الملفين، ثم مقاطع (hunks) تبدأ بـ @@ -a,b +c,d @@ مع ثلاثة أسطر من السياق حول كل تغيير. ويُسمّى الملفان original وchanged مع امتداد يوافق اللغة.