أدوات المطور · مقارنة النص
كيفية قراءة الفرق الموحد: الرؤوس الكبيرة وخطوط السياق وعلامات +/-
· خلفية
فرق النص بقع سير عمل المطور
يقوم بفك تشفير تنسيق الفرق الموحد سطرًا تلو الآخر، بدءًا من رؤوس الملفات ونطاقات @@ الكبيرة وحتى خطوط السياق وتغيير العلامات، بحيث تكون التصحيحات من أي أداة منطقية.
جدار من الإيجابيات والسلبيات والرموز @@ - يتم فتحه مع أول لقاء مع تصحيح في بريد إلكتروني أو طلب سحب
يبدأ `changes.patch` الذي تم تنزيله بعلامات الترقيم التي تشبه مخرجات الفرق المألوفة، ولكن هيكلها الدقيق مهم. ToolAcre يكتب تسميتين ثم كل صف مقارنة بعلامة مكونة من حرف واحد. تعد قراءة ما هو موجود أكثر أمانًا من تزويد الحقول عقليًا من تنسيق تصحيح آخر.
افتح الملف في محرر نص عادي. يحدد السطران الأولان التسميات اليسرى واليمنى التي توفرها واجهة المستخدم مثل `original` و`changed`. تعيد الأسطر اللاحقة بناء النصوص المقارنة من خلال علامات السياق والإزالة والإضافة.
أسطر رأس الملف - تشرح الأسطر --- و+++ والمسارات والأدوات التي تضيفها البادئات a/ وb/
الرأس هو `--- original` متبوعًا بـ `+++ changed`. في أدوات أخرى، قد توجد هذه البادئات ضمن قواعد نحوية أكثر ثراءً، لكن هذا المُصدِّر لا يضيف أي طوابع زمنية أو مسارات أو بيانات تعريف. تصف التسميات الجوانب، وليس الملفات المثبتة على القرص.
هذا التمييز مهم لأن Text diff يقبل السلاسل الملصقة بدلاً من كائنات الملفات. يقوم التنزيل بإنشاء تقرير نصي محلي بعد المقارنة. إن التعامل مع التسميات كمسارات مستودع أو معرفات مراجعة من شأنه أن يعزو المصدر الذي لم تجمعه واجهة المستخدم مطلقًا.
شرح الرؤوس الكبيرة - فك التشفير @@ -12,7 +12,8 @@ كخط البداية وعدد الأسطر لكل جانب
لا توجد أسطر تبدأ بـ `@@` في `toUnifiedText`. يتم تعيين الوظيفة مباشرة على كافة الصفوف بعد التسميتين. وبالتالي، لا يحتوي هذا الإخراج على نطاقات كبيرة لفك تشفيرها ولا يوجد أزواج سطر بداية /count مضمنة في النص الذي تم تنزيله.
تظل أرقام الأسطر متاحة في عرض المتصفح المعروض، حيث تحمل الصفوف المواضع اليسرى واليمنى. يختار التصدير تمثيلاً أبسط. إذا كان البرنامج النهائي يتطلب كتلًا موحدة مكتملة للمعايير، فتحقق من التوافق بدلاً من افتراض أن الامتداد `.patch` يوفر بناء جملة مفقودًا.
ToolAcre لا يُصدر @@ رؤوسًا كبيرة، لذا لا يوجد شيء لفك تشفيره
تشير المسافة البادئة إلى صف لم يتغير، ويشير ناقص إلى الإزالة اليسرى، ويشير علامة الزائد إلى الإضافة اليمنى. يمكن لواجهة المستخدم طي عمليات التشغيل المتساوية الطويلة بشكل مرئي، ولكن `lastDiff` يحتفظ بالنتيجة الكاملة ويقوم التنزيل بإجراء تسلسل لجميع الصفوف. لا توجد علامة تخطي تدخل سلسلة التصحيح.
ذكر المخطط التفصيلي ثلاثة أسطر سياقية كإعداد افتراضي. يتم استخدام الرقم ثلاثة بواسطة استدعاء الانهيار المرئي، وليس بواسطة التصدير. سيؤدي الخلط بين هذه المسارات إلى تقليل المحتوى الذي تم تنزيله. يتشارك العرض التقديمي والتسلسل في الصفوف ولكن يتم تطبيق تحويلات مختلفة.
يقوم التنزيل بوضع علامة على كل صف ولا يستخدم سياقًا افتراضيًا مكونًا من ثلاثة أسطر
قارن بين اليسار `a b` واليمين `a c`. السطران المُصدَّران هما التسميتان، ثم مسافة-a، وناقص-b، وعلامة الجمع-c. تشير القراءة من الأعلى إلى الأسفل إلى أن `a` باقية، و`b` تترك النص الأصلي و`c` تدخل الجانب الذي تم تغييره.
لذلك يتم تمثيل التعديل على أنه إزالة وإضافة مجاورة عندما تضعهما المحاذاة معًا. التنسيق لا يسميه "معدلاً". إذا كانت الخطوط المتكررة تسمح بمحاذاة أخرى، فقد يبدو التسلسل مختلفًا مع الاستمرار في حساب كل صف إدخال.
مثال عملي: اقرأ الدفق الكامل على شكل تصحيح والذي يصدره ToolAcre بالفعل
تحتوي تنسيقات الفرق الموحدة العادية والسياقية والكاملة على مواصفاتها وتاريخها الخاص بها، ولكن لم يتم تنفيذها أو توثيقها بواسطة مجموعة المصدر المستخدمة هنا. لا توضح هذه المقالة سبب شهرة أحد التنسيقات أو عدم ظهور حقول القائمة ToolAcre.
استخدم أمر التحكم في الإصدار عندما يتعين على أداة أخرى تطبيق التصحيح. يعد تنزيل ToolAcre مفيدًا باعتباره أداة مراجعة محمولة، ومع ذلك لا يحتوي المستودع على محلل تصحيح أو وظيفة تطبيق تثبت أنه يمكنه الذهاب ذهابًا وإيابًا عبر مستهلكي التصحيح التعسفيين.
تتطلب مقارنات التنسيق الموحدة والسياق والعادية الكاملة مصادر خارجية
التصحيحات الثنائية وإعادة تسمية الرؤوس وتغييرات الوضع والتطبيق تقع خارج هذا المسار. لا يحتوي النص على معرفات كائنات أو سلف مشترك. لا يمكن أن تمثل عملية مستودع لمجرد أن علاماتها تبدو مألوفة.
يعكس المصدر أيضًا خيارات المقارنة النشطة. الصف الذي يعتبر متساويًا بعد تسوية الحالة أو المسافة البيضاء يحمل النص الأصلي الأيسر فقط، وبالتالي فإن المستند على شكل التصحيح ليس إعادة بناء بايت مقابل بايت لكلا المدخلات في ظل مطابقة فضفاضة.
الوجبات الجاهزة: الفرق عبارة عن قصة مضغوطة - تلخص ترتيب القراءة وتلاحظ كيف تعرض مقارنة نص ToolAcre نفس أنواع التغييرات مثل الأسطر المميزة للمراجعة السريعة
اقرأ التصنيفين أولاً، ثم قم بتفسير كل صف مسبوق بالترتيب. إذا كنت بحاجة إلى أرقام الأسطر المعروضة، فارجع إلى عرض المتصفح. إذا كنت بحاجة إلى كتل كاملة المعايير، فقم بإنشائها باستخدام أداة توثق هذا العقد.
يوفر ToolAcre طريقة مدمجة لإجراء المقارنة خارج الصفحة دون المطالبة بتنفيذ كل ميزات التصحيح. هذا الاسم الأضيق - الناتج على شكل رقعة - يحافظ على توافق التوقعات مع الوظيفة الدقيقة ويتجنب الوعد الكاذب بتوافق التطبيقات.