این ابزار درست کار نمی‌کند؟

دربارهٔ ابزار «تفاوت متنی آنلاین»

این ابزار دو قطعه متن را مقایسه می‌کند و تفاوت‌های بین آنها را برجسته می‌کند: خطوطی که اضافه، حذف یا تغییر یافته‌اند. تجسم باعث می‌شود به راحتی متوجه شوید چه چیزی بین دو نسخه تغییر کرده است، حتی در اسناد طولانی.

برای مقایسه نسخه‌های پیش‌نویس یک مقاله، بررسی تغییرات یک فایل پیکربندی یا قرارداد، تشخیص تفاوت در داده‌های کپی شده، اشکال‌زدایی عدم تطابق خروجی در کد، یا مقایسه یک سند ترجمه شده با اصل آن مفید است.

ابزار از تفاوت‌های خط به خط و سطح کاراکتر پشتیبانی می‌کند. سطح خط برای تغییرات بزرگ سریع‌تر و آسان‌تر اسکن می‌شود؛ سطح کاراکتر ویرایش‌های دقیق هر حرف را در یک خط نشان می‌دهد.

چطور از این ابزار استفاده کنم؟

چطور دو متن را خط به خط مقایسه کنم؟

  1. هر دو نسخه را بچسبانید

    نسخهٔ قدیمی را در «Left» و نسخهٔ جدید را در «Right» قرار دهید. ابزار خط به خط مقایسه می‌کند — تفاوت‌های within-line word-level برجسته نمی‌شوند؛ آن الگوریتم متفاوت (و گران‌تر) است.

  2. «اجرا» را بزنید

    خروجی آرایه‌ای از entry‌های `diff` با `op` (`equal`، `added`، `removed`) و `text` برمی‌گرداند. ترتیب توالی merged را منعکس می‌کند — ابتدا equal، سپس هر insertion/deletion run به ترتیب source.

  3. خواندن خروجی

    خطوط مارک‌شده `added` فقط در Right موجودند، `removed` فقط در Left. UI‌های editor معمولاً added را سبز و removed را قرمز رندر می‌کنند؛ ساختار داده یکسان است. تفاوت‌های trailing newline ممکن است به‌صورت یک خط `added`/`removed` ظاهر شوند.

  4. وقتی line-level خیلی coarse است

    پاراگراف‌های بلند بدون تغییر با یک کلمه ویرایش‌شده مانند یک جفت removed + added دیده می‌شوند، نه به‌عنوان word-level diff. برای review prose از کتابخانهٔ word-diff یا character-diff اختصاصی استفاده کنید؛ line-diff برای code بهتر است.