مقدمه (Preamble)

گزینه‌های زیر سبک نشانه‌گذاری بصری را با افزودن تعاریف دستورات مناسب به مقدمه (preamble) مشخص می‌کنند. برای شرح سبک‌های موجود، انتهای این بخش را ببینید.

--type=markupstyle یا -t markupstyle

کد مربوط به سبک نشانه‌گذاری انتخاب‌شده را به مقدمه اضافه می‌کند. این گزینه دستورات "\DIFadd" و "\DIFdel" را تعریف می‌کند. سبک‌های موجود:

"UNDERLINE CTRADITIONAL TRADITIONAL CFONT FONTSTRIKE INVISIBLE CHANGEBAR CCHANGEBAR CULINECHBAR CFONTCHBAR BOLD PDFCOMMENT LUAUNDERLINE"

[ پیش‌فرض: "UNDERLINE" ]

--subtype=markstyle یا -s markstyle

کد مربوط به سبک انتخاب‌شده برای دستورات علامت‌گذاری پیرامونی (به‌عنوان مثال، برای علامت‌گذاری تغییرات در حاشیه) را به مقدمه اضافه می‌کند. این گزینه دستورات "\DIFaddbegin"، "\DIFaddend"، "\DIFdelbegin" و "\DIFdelend" را تعریف می‌کند. سبک‌های موجود: "SAFE MARGIN COLOR DVIPSCOL ZLABEL ONLYCHANGEDPAGE (LABEL)*"

[ پیش‌فرض: "SAFE" ] * زیرنوع "LABEL" منسوخ شده است

--floattype=markstyle یا -f markstyle

کد مربوط به سبک انتخاب‌شده را به مقدمه اضافه می‌کند تا جایگزین دستورات نشانه‌گذاری و علامت‌گذاری استاندارد درون اشیاء شناور (floats) شود (به‌عنوان مثال، یادداشت‌های حاشیه‌ای درون شناورها باعث ایجاد خطا می‌شوند، بنابراین نشانه‌گذاری حاشیه‌ای را می‌توان به این صورت غیرفعال کرد). این گزینه تمام دستورات "\DIF...FL" را تعریف می‌کند. سبک‌های موجود: "FLOATSAFE TRADITIONALSAFE IDENTICAL"

[ پیش‌فرض: "FLOATSAFE" ]

--encoding=enc یا -e enc

کدگذاری old.tex و new.tex را مشخص می‌کند. کدگذاری‌های متداول عبارت‌اند از: "ascii"، "utf8"، "latin1"، "latin9". فهرستی از کدگذاری‌های موجود را می‌توان با اجرای دستور زیر به دست آورد:

"perl -MEncode -e 'print join ("\n",Encode-"encodings( ":all" )) ;' >

اگر از این گزینه استفاده شود، old.tex و new.tex فقط یک‌بار باز می‌شوند. [کدگذاری پیش‌فرض utf8 است، مگر این‌که در چند خط اول مقدمه فراخوانی "\usepackage[..]{inputenc}" وجود داشته باشد که در این صورت کدگذاری انتخاب‌شده توسط این دستور فرض می‌شود. توجه داشته باشید که ASCII (لاتک استاندارد) زیرمجموعه‌ای از utf8 است]

--preamble=file یا -p file

به جای تولید مقدمه، فایل را در انتهای مقدمه درج می‌کند. مقدمه باید دستورات زیر را تعریف کند: "\DIFaddbegin, \DIFaddend, \DIFadd{..}, \DIFdelbegin,\DIFdelend,\DIFdel{..}," و همچنین گونه‌های آن‌ها را برای استفاده درون شناورها: "\DIFaddbeginFL, \DIFaddendFL, \DIFaddFL{..}, \DIFdelbeginFL, \DIFdelendFL, \DIFdelFL{..}" (در صورت تنظیم این گزینه، گزینه‌های -t، -s و -f نادیده گرفته می‌شوند.)

--packages=pkg1,pkg2,..

به latexdiff اعلام می‌کند که فایل .tex با بسته‌های بارگذاری‌شده در این فهرست پردازش می‌شود. اگر فایل .tex شامل مقدمه باشد این امر معمولاً لازم نیست، زیرا مقدمه به‌طور خودکار برای یافتن دستورات "\usepackage" پویش می‌شود. استفاده از گزینهٔ --packages پویش خودکار را غیرفعال می‌کند، بنابراین اگر به هر دلیلی نیاز به غیرفعال کردن تجزیهٔ مختص به بسته‌ها باشد، از --packages=none استفاده کنید. بسته‌های زیر رفتارهای خاصی را فعال می‌کنند:

پیکربندی (Configuration)

--exclude-safecmd=exclude-file یا -A exclude-file یا --exclude-safecmd="cmd1,cmd2,..."

--replace-safecmd=replace-file

--append-safecmd=append-file یا -a append-file یا --append-safecmd="cmd1,cmd2,..."

حذف، جایگزینی یا افزودن به فهرست عبارت‌های منظم (RegEx) منطبق با دستوراتی که استفاده از آن‌ها در دامنهٔ دستور "\DIFadd" یا "\DIFdel" امن است. فایل باید در هر خط شامل یک Perl-RegEx باشد (خطوط توضیحات که با # یا % آغاز می‌شوند نادیده گرفته می‌شوند). توجه داشته باشید که عبارت منظم باید با کل نشانک تطبیق یابد، یعنی /^regex$/ به‌طور پیش‌فرض در نظر گرفته می‌شود و «\» ابتدای دستور در آن گنجانده نمی‌شود. گزینه‌های --exclude-safecmd و --append-safecmd می‌توانند با گزینهٔ --replace-safecmd ترکیب شوند و می‌توان از آن‌ها به طور مکرر برای افزودن تجمعی به فهرست‌ها استفاده کرد. --exclude-safecmd و --append-safecmd همچنین می‌توانند فهرستی جداشده با کاما را به عنوان ورودی دریافت کنند. اگر برای یکی از عبارت‌های منظم نیاز به کاما باشد، آن را با «\,» مشخص کنید. در اکثر موارد لازم است فهرست جداشده با کاما با قرار گرفتن درون علامت نقل‌قول از دستکاری پوسته (shell) محافظت شود.

--exclude-textcmd=exclude-file یا -X exclude-file یا --exclude-textcmd="cmd1,cmd2,..."

--replace-textcmd=replace-file

--append-textcmd=append-file یا -x append-file یا --append-textcmd="cmd1,cmd2,..."

حذف، جایگزینی یا افزودن به فهرست عبارت‌های منظم منطبق با دستوراتی که آخرین آرگومان آن‌ها متن است. برای جزئیات بیشتر ورودی مربوط به --exclude-safecmd را دقیقاً در بالا ببینید.

--replace-context1cmd=replace-file

--append-context1cmd=append-file یا

--append-context1cmd="cmd1,cmd2,..."

جایگزینی یا افزودن به فهرست عبارات منظم منطبق با دستوراتی که آخرین آرگومان آن‌ها متن است اما برای کارکرد به بافت خاصی نیاز دارند، به عنوان مثال "\caption" تنها درون شکل (figure) یا جدول کار خواهد کرد. این دستورات مانند دستورات متنی رفتار می‌کنند، مگر زمانی که در یک بخش حذف‌شده ظاهر شوند؛ در این صورت غیرفعال می‌شوند اما آرگومان آن‌ها به صورت متن حذف‌شده نمایش داده می‌شود.

--replace-context2cmd=replace-file

--append-context2cmd=append-file یا

--append-context2cmd="cmd1,cmd2,..."

همانند دستورات متناظر برای context1. تنها تفاوت این است که دستورات context2 در بخش‌های حذف‌شده به‌طور کامل غیرفعال می‌شوند، از جمله آرگومان‌های آن‌ها.

دستورات context2 همچنین تنها دستوراتی در مقدمه هستند که آرگومان آن‌ها در حالت کلمه‌به‌کلمه پردازش خواهد شد (که فقط در صورتی کار می‌کند که بیش از یک‌بار در مقدمه ظاهر نشوند). این الگوریتم در حال حاضر نمی‌تواند با دستورات تکراری context2 در مقدمه سازگار شود، مانند آنچه برای نمونه برای آرگومان "\author" در برخی از سبک‌های ژورنال‌ها رخ می‌دهد (البته در سبک‌های استاندارد رخ نمی‌دهد). اگر چنین تکراری شناسایی شود، کل مقدمه در حالت خط‌به‌خط پردازش خواهد شد. در چنین حالتی، از گزینهٔ "--replace-context2cmd" استفاده کنید تا فقط دستوراتی انتخاب شوند که باید پردازش گردند و در مقدمه مکرراً استفاده نشده‌اند.

--exclude-mboxsafecmd=exclude-file یا --exclude-mboxsafecmd="cmd1,cmd2,..."

--append-mboxsafecmd=append-file یا --append-mboxsafecmd="cmd1,cmd2,..."

تعریف دستورات امن، که علاوه بر این نیاز دارند تا با کپسوله‌سازی در یک "\mbox{..}" محافظت شوند. این امر گاهی برای دور زدن ناسازگاری‌های بین بسته‌های خارجی و بستهٔ ulem لازم است؛ بسته‌ای که برای برجسته‌سازی در سبک پیش‌فرض UNDERLINE و همچنین CULINECHBAR و CFONTSTRIKE استفاده می‌شود.

--config var1=val1,var2=val2,... یا -c var1=val1,..

-c configfile

تنظیم متغیرهای پیکربندی. این گزینه می‌تواند برای تنظیم متغیرهای مختلف تکرار شود (به عنوان جایگزینی برای فهرست جداشده با کاما). متغیرهای موجود (برای توضیحات بیشتر به بخش زیر مراجعه کنید):

"ARRENV" (RegEx)

"COUNTERCMD" (RegEx)

"CUSTODIFCMD" (RegEx)

"FLOATENV" (RegEx)

"ITEMCMD" (RegEx)

"LISTENV" (RegEx)

"MATHARRENV" (RegEx)

"MATHENV" (RegEx)

"MATHREPL" (String)

"MAXCHANGESLETTER" (Integer)

"MINWORDSBLOCK" (Integer)

"PICTUREENV" (RegEx)

"SCALEDELGRAPHICS" (Float).IP "--add-to-config varenv1=pattern1,varenv2=pattern2,..." 4 برای متغیرهای پیکربندی که یک عبارت باقاعده (regular expression) هستند (اساساً آن‌هایی که به ENV، COUNTERCMD و CUSTOMDIFCMD ختم می‌شوند، فهرست بالا را ببینید)، این گزینه روشی جایگزین برای تغییر متغیرهای پیکربندی فراهم می‌کند. به جای تعیین الگوی کامل، با این گزینه می‌توان یک الگوی جایگزین اضافه کرد. "varenv" باید یکی از متغیرهای فهرست‌شده در بالا باشد که عبارت باقاعده را به عنوان آرگومان می‌پذیرد، و pattern هر عبارت باقاعده‌ای است (که ممکن است نیاز باشد با نقل‌قول در برابر پوسته محافظت شود). با استفاده از نقطه‌ویرگول (;) می‌توان چندین الگو را به طور همزمان اضافه کرد، مانند: "--add-to-config "LISTENV=myitemize;myenumerate,COUNTERCMD=endnote""

--show-preamble

چاپ دستورهای دیباچه (preamble) تولیدشده یا گنجانده‌شده.

--show-safecmd

چاپ فهرست RegEx برای تطابق و استثنا کردن دستورهای امن (safe commands).

--show-textcmd

چاپ فهرست RegEx برای تطابق و استثنا کردن دستورها با آرگومان متنی.

--show-config

نمایش مقدارهای متغیرهای پیکربندی.

--show-all

ترکیب کردن همهٔ دستورهای --show.

توجه: برای همهٔ دستورهای --show، رفتار برنامه بسته به اینکه آیا فایل‌های "old.tex" یا "new.tex" مشخص شده باشند متفاوت است. اگر مشخص نشده باشند، پیکربندی اولیه نمایش داده می‌شود. اگر مشخص شده باشند، پیکربندی کامل نشان داده می‌شود که شامل برخی افزوده‌های دستورهای داخلی و تغییرات بر اساس بسته‌های موجود در سیستم یا استفاده‌شده در فایل‌های .tex است. در هر دو حالت، هیچ تفاضل‌گیری (differencing) انجام نمی‌شود.

سایر گزینه‌های پیکربندی (Other configuration options):

--allow-spaces

مجاز دانستن فاصله (space) میان آرگومان‌های درون قلاب یا آکولاد دستورها. توجه داشته باشید که این گزینه ممکن است اثرات جانبی نامطلوبی داشته باشد (محدودهٔ نامرتبط ممکن است با دستورهای پیشین یکی شود)، بنابراین تنها در صورتی باید استفاده شود که حالت پیش‌فرض نتایج نادرستی ایجاد کند. (در حالت پیش‌فرض لازم است آرگومان‌ها مستقیماً و بدون فواصل میانی به دنبال یکدیگر بیایند).

--math-markup=level

تعیین میزان دانه‌بندی (granularity) نشانه‌گذاری در محیط‌های ریاضیاتی نمایش‌یافته: مقدارهای ممکن برای level عبارتند از (هر دو برچسب عددی و متنی پذیرفته می‌شوند):

"off" یا 0: غیرفعال کردن نشانه‌گذاری برای محیط‌های ریاضی. معادلات حذف‌شده در فایل diff نمایش داده نخواهند شد. این حالت زمانی کاربرد دارد که تمامی حالت‌های دیگر منجر به کد نامعتبر latex شوند.

"whole" یا 1: تفاضل‌گیری در سطح کل معادلات. حتی تغییرات جزئی در معادلات باعث می‌شود کل معادله به عنوان تغییریافته علامت‌گذاری شود. این حالت را می‌توان زمانی استفاده کرد که پردازش در حالت coarse یا fine به کد نامعتبر latex بیانجامد.

"coarse" یا 2: تشخیص تغییرات درون معادلات با دانه‌بندی درشت؛ تغییرات در نوع معادله (مانند displaymath به equation) به عنوان تغییر در کل معادله ظاهر می‌شود. این حالت برای شرایطی توصیه می‌شود که محتوا و ترتیب برخی معادلات همچنان در حال تغییر است. [پیش‌فرض]

"fine" یا 3: تشخیص تغییرات کوچک در معادلات و نشانه‌گذاری با دانه‌بندی ریز. این حالت زمانی مناسب‌تر است که تنها تغییرات جزئی در معادلات مورد انتظار باشد، مانند اصلاح غلط‌های تایپی.

--graphics-markup=level

تغییر سبک برجسته‌سازی برای تصاویر و گرافیک‌های جای‌گذاری‌شده با دستورهای C<\includegraphics>.

مقدارهای ممکن برای level:

"none"، "off" یا 0: بدون برجسته‌سازی برای شکل‌ها

"new-only" یا 1: احاطه کردن شکل‌های تازه اضافه‌شده یا تغییریافته با یک کادر آبی [پیش‌فرض در صورت بارگذاری بستهٔ graphicx]

"both" یا 2: برجسته‌سازی شکل‌های جدید با کادر آبی و نمایش شکل‌های حذف‌شده با مقیاس کوچک‌تر و خط‌خورده با یک ضربدر مورب قرمز. برای تنظیم اندازهٔ شکل‌های حذف‌شده از متغیر پیکربندی SCALEDELGRAPHICS استفاده کنید.

توجه داشته باشید که تغییر در پارامترهای اختیاری باعث می‌شود شکل برای latexdiff به عنوان تغییریافته شناخته شود و در نتیجه برجسته خواهد شد.

در برخی شرایط، در صورت وجود انواع خاصی از تغییرات در جدول‌ها، ممکن است خطای "Misplaced \noalign" رخ دهد. در این حالت لطفاً از "--graphics-markup=none" به عنوان راهکار موقت استفاده کنید.

--no-del

حذف متن پاک‌شده از خروجی diff. این گزینه از نظر اثرگذاری مشابه سبک BOLD است، اما متن حذف‌شده فقط در خروجی نامرئی نمی‌شود، بلکه در فایل متنی diff نیز گنجانده نمی‌شود. این کار می‌تواند مطمئن‌تر از نامرئی کردن صرف آن باشد.

--disable-citation-markup یا --disable-auto-mbox

غیرفعال کردن نشانه‌گذاری ارجاع‌ها (citation) و نشانه‌گذاری سایر دستورهای آسیب‌پذیر در سبک‌هایی که از ulem استفاده می‌کنند (UNDERLINE، FONTSTRIKE، CULINECHBAR) (این دو گزینه یکسان بوده و صرفاً نام مستعار یکدیگر هستند)

--enable-citation-markup یا --enforce-auto-mbox

محافظت از دستورهای ارجاع و سایر دستورهای آسیب‌پذیر در بخش‌های تغییریافته با استفاده از دستور "\mbox"، یعنی استفاده از رفتار پیش‌فرض بستهٔ ulem برای سایر بسته‌ها (این دو گزینه یکسان بوده و صرفاً نام مستعار یکدیگر هستند)

متفرقه (Miscellaneous)

--verbose یا -V

ارسال اطلاعات وضعیت گوناگون به stderr هنگام پردازش. حالت پیش‌فرض، اجرای بی‌صدا است.

--driver=type

انتخاب درایور برای بستهٔ changebar (تنها برای سبک‌هایی که از changebar استفاده می‌کنند مرتبط است: CCHANGEBAR ،CFONTCHBAR ،CULINECHBAR ،CHANGEBAR). درایورهای ممکن در راهنمای changebar فهرست شده‌اند، مانند pdftex، dvips، dvitops [پیش‌فرض: pdftex]

--ignore-warnings

نادیده گرفتن هشدارهای مربوط به ناهمخوانی طول بین رشته‌های ورودی و تجزیه‌شده و نویسه‌های مفقود. این پیام‌های هشدار اغلب مربوط به کدهای غیراستاندارد latex یا ساختارهای ترکیبی با نحو ناشناخته برای "latexdiff" هستند، اما تفاوت نهایی حاصل در هر صورت اغلب کاملاً کاربردی است، به ویژه اگر کدهای غیراستاندارد latex تنها در بخش‌هایی از متن رخ داده باشند که تغییر نکرده‌اند.

--label=label یا -L label

تنظیم برچسب‌های مورد استفاده برای توصیف فایل‌های قدیمی و جدید. اولین استفاده از این گزینه، برچسب توصیف‌کنندهٔ فایل قدیمی و دومین استفاده، برچسب فایل جدید را تنظیم می‌کند؛ یعنی هر دو برچسب را به این صورت تعیین کنید: "-L labelold -L labelnew";. [پیش‌فرض: استفاده از نام فایل و تاریخ ویرایش برای برچسب]

--no-label

جلوگیری از درج نام فایل‌های قدیمی و جدید به عنوان یادداشت (کامنت) در فایل خروجی.

--visible-label

گنجاندن نام فایل‌های قدیمی و جدید (یا برچسب‌های تنظیم‌شده با گزینهٔ "--label") به عنوان خروجی قابل رؤیت.

--flatten

جایگزین کردن دستورهای "\input" و "\include" درون بدنه با محتوای فایل‌های مشخص‌شده در آرگومان آن‌ها. اگر "\includeonly" در دیباچه (preamble) وجود داشته باشد، تنها آن فایل‌ها در سند بسط داده می‌شوند. با این حال، بازگشت (recursion) انجام نمی‌شود؛ یعنی دستورهای "\input" و "\include" درون بخش‌های گنجانده‌شده بسط نمی‌یابند. فرض بر این است که فایل‌های گنجانده‌شده به ترتیب در همان دایرکتوری‌های فایل‌های اصلی قدیمی و جدید قرار دارند و امکان سازماندهی فایل‌ها در دایرکتوری‌های قدیمی و جدید را فراهم می‌سازند. گزینهٔ --flatten به صورت بازگشتی اعمال می‌شود، بنابراین فایل‌های واردشده می‌توانند حاوی دستورهای "\input" بیشتری باشند. همچنین فایل‌های گنجانده‌شده با بستهٔ import ("\import" و "\subimport") و دستور "\subfile" را نیز مدیریت می‌کند.

استفاده از این گزینه ممکن است باعث افزایش چشمگیر زمان پردازش برای اسناد بزرگ‌تر شود، و سند تفاوت حاصل دیگر ساختار اسناد ورودی را بازتاب نخواهد داد.

--filter-script=filterscript

عبور دادن فایل‌ها از این اسکریپت پالایه (filterscript - مسیر کامل ترجیح داده می‌شود) پیش از پردازش. اسکریپت پالایه باید ورودی را از STDIN دریافت کرده و خروجی را به STDOUT ارسال کند. هنگامی که با --flatten ترکیب شود، هر فایل به محض فراخوانی از پالایه عبور داده خواهد شد.

--ignore-filter-stderr

هنگام اجرا با --filter-script، ممکن است پیام‌های STDERR از طرف اسکریپت باعث کاهش خوانایی شوند. این پرچم را فعال کنید تا از STDERR اسکریپت پالایه چشم‌پوشی شود.

--help یا -h

نمایش متن راهنما

--version

نمایش شمارهٔ نسخه.SS "گزینه‌های داخلی (Internal options)" این گزینه‌ها عمدتاً برای استفادهٔ خودکار توسط latexdiff-vc هستند. می‌توان آن‌ها را مستقیماً نیز به کار برد، اما رابط برنامه‌نویسی (API) آن‌ها نسبت به سایر گزینه‌ها ناپایدارتر تلقی می‌شود.

--no-links

جلوگیری از ایجاد پیوندهای ارجاعی (hyperreference)، مورد استفاده برای تفاضل‌های کمینه (گزینهٔ --only-changes در latexdiff-vc).

سبک‌های از پیش‌تعریف‌شده (Predefined styles)

انواع اصلی (Major types)

نوع اصلی، نشانه‌گذاری متن ساده و برخی از دستورهای لاتک برگزیده در خارج از شناورها را با تعریف دستورهای نشانه‌گذاری "\DIFadd{...}" و "\DIFdel{...}" تعیین می‌کند.

"UNDERLINE"

متن افزوده‌شده با خط موج‌دار زیرخط‌دار و آبی‌رنگ می‌شود، متن حذف‌شده خط‌خورده و قرمز خواهد بود (نیازمند بسته‌های color و ulem). خط زدن روی متن (Overstriking) در معادلات ریاضی نمایشی (displayed math) کار نمی‌کند، به‌گونه‌ای که بخش‌های حذف‌شدهٔ معادله به‌جای خط خوردن، زیرخط‌دار می‌شوند (این یک نقص ذاتی در بستهٔ ulem است).

"LUAUNDERLINE"

متن افزوده‌شده زیرخط‌دار و آبی‌رنگ، و متن حذف‌شده خط‌خورده و قرمز خواهد بود (نیازمند بستهٔ lua-ul به‌همراه LuaLaTeX).

"CTRADITIONAL"

متن افزوده‌شده آبی‌رنگ و با قلم بدون‌سریف (sans-serif) است، و برای هر بخش از متن حذف‌شده یک پاورقی قرمز ایجاد می‌شود (نیازمند بستهٔ color).

"TRADITIONAL"

مانند "CTRADITIONAL" اما بدون استفاده از رنگ.

"CFONT"

متن افزوده‌شده آبی‌رنگ و با قلم بدون‌سریف بوده، و متن حذف‌شده قرمز و با اندازه‌ای بسیار کوچک است.

"FONTSTRIKE"

متن افزوده‌شده با قلم بدون‌سریف است، و متن حذف‌شده کوچک و خط‌خورده خواهد بود.

"CCHANGEBAR"

متن افزوده‌شده آبی‌رنگ، و متن حذف‌شده قرمز است. علاوه بر این، متن تغییریافته با یک خط در حاشیه مشخص می‌شود (نیازمند بسته‌های color و changebar).

"CFONTCHBAR"

مانند "CFONT" اما همراه با خطوط حاشیهٔ اضافی (نیازمند بسته‌های color و changebar).

"CULINECHBAR"

مانند "UNDERLINE" اما همراه با خطوط حاشیهٔ اضافی (نیازمند بسته‌های color، ulem و changebar).

"CHANGEBAR"

هیچ نشانه‌گذاری روی متن اعمال نمی‌شود، اما حاشیه‌ها با خطوط تغییر نشانه‌گذاری می‌شوند (نیازمند بستهٔ changebar).

"INVISIBLE"

بدون نشانه‌گذاری دیداری (اما دستورهای نشانه‌گذاری عمومی همچنان درج خواهند شد).

"BOLD"

متن افزوده‌شده با قلم پررنگ (bold) مشخص می‌شود، و متن حذف‌شده نمایش داده نمی‌شود (همچنین برای امکانی دیگر جهت پنهان‌سازی متن حذف‌شده، گزینهٔ --no-del را ببینید).

"PDFCOMMENT"

از بستهٔ pdfcomment برای زیرخط‌دار کردن متن جدید و مشخص کردن حذفیات با یک یادداشت (comment) در PDF استفاده می‌شود. توجه داشته باشید که این نشانه‌گذاری ممکن است بسته به نمایشگر PDF مورد استفاده، متفاوت دیده شده یا اصلاً نمایش داده نشود. نمایشگری که بهترین پشتیبانی را از نشانه‌گذاری‌های PDF دارد احتمالاً acroread است. این سبک تنها در صورتی توصیه می‌شود که تعداد تفاوت‌ها اندک باشد.

زیرنوع‌ها (Subtypes)

زیرنوع دستورهایی را تعریف می‌کند که در آغاز و پایان بلوک‌های افزوده‌شده یا حذف‌شده درج می‌شوند، فارغ از اینکه این بلوک‌ها حاوی متن باشند یا دستور (دستورهای تعریف‌شده: "\DIFaddbegin, \DIFaddend, \DIFdelbegin, \DIFdelend").

"SAFE"

بدون نشانه‌گذاری اضافی (انتخاب توصیه‌شده).

"MARGIN"

نشانه‌گذاری آغاز و پایان بلوک‌های تغییریافته با نمادهایی در حاشیهٔ مجاور (با استفاده از دستور استاندارد "\marginpar" - توجه داشته باشید که این دستور گاهی کمی از موقعیت اصلی خود جابه‌جا می‌شود).

"COLOR"

روشی جایگزین برای نشانه‌گذاری بخش‌های افزوده به رنگ آبی و بخش‌های حذفی به رنگ قرمز (توصیه می‌شود به‌جای این، از انواع اصلی برای اعمال نشانه‌گذاری رنگی استفاده شود، هرچند در برخی موارد رنگ‌آمیزی با dvipscol می‌تواند کامل‌تر باشد، مثلاً برای دستورهای ارجاع).

"DVIPSCOL"

روشی جایگزین برای نشانه‌گذاری بخش‌های افزوده به رنگ آبی و بخش‌های حذفی به رنگ قرمز. توجه داشته باشید که "DVIPSCOL" تنها با مبدل dvips کار می‌کند و مثلاً با pdflatex کار نخواهد کرد (توصیه می‌شود به‌جای این از انواع اصلی برای نشانه‌گذاری رنگی استفاده شود، اگرچه در مواردی رنگ‌آمیزی با dvipscol می‌تواند کامل‌تر باشد).

"ZLABEL"

می‌تواند برای برجسته‌سازی تنها صفحه‌های تغییریافته به کار رود، اما نیازمند پس‌پردازش است. توصیه می‌شود این گزینه را دستی فراخوانی نکنید، بلکه از "latexdiff-vc" به همراه گزینهٔ "--only-changes" استفاده کنید. در غیر این صورت، از اسکریپت موجود در دیباچهٔ (preamble) فایل‌های diff ساخته‌شده با این سبک استفاده نمایید.

"ONLYCHANGEDPAGE"

صفحات تغییریافته را بدون نیاز به پس‌پردازش برجسته می‌کند، اما اگر عناصر شناور (شکل‌ها، جدول‌ها) وجود داشته باشند ممکن است عملکرد قابل اعتمادی نداشته باشد.

"LABEL"

مشابه "ZLABEL" است، اما به بستهٔ zref نیاز ندارد و قابلیت اطمینان آن کمتر است (منسوخ‌شده).

انواع شناور (Float Types)

برخی از نشانه‌گذاری‌های استفاده‌شده در متن اصلی ممکن است در صورت استفاده در محیط‌های شناور (مانند شکل‌ها یا جدول‌ها) مشکل ایجاد کنند. به همین دلیل نسخه‌های جایگزینی از تمامی دستورهای نشانه‌گذاری در محیط‌های شناور استفاده می‌شود. نوع شناور این دستورهای جایگزین را تعریف می‌کند.

"FLOATSAFE"

از همان نشانه‌گذاری متن در بدنهٔ اصلی استفاده می‌کند، اما تمامی دستورهای مشخص‌کنندهٔ آغاز و پایان بلوک‌های تغییریافته را روی دستورهای تهی تنظیم می‌کند. اگر زیرنوع شما "MARGIN" باشد باید این نوع شناور را انتخاب کنید، زیرا "\marginpar" در محیط‌های شناور به‌درستی کار نمی‌کند.

"TRADITIONALSAFE"

موارد افزوده را به همان شیوهٔ متن اصلی نشانه‌گذاری می‌کند. محیط‌های حذف‌شده با قلاب‌های شکسته \[ و \] مشخص شده و متن حذف‌شده در اندازهٔ scriptscript قرار می‌گیرد. این نوع شناور همیشه باید همراه با انواع نشانه‌گذاری "TRADITIONAL" و "CTRADITIONAL" به کار رود، زیرا دستور \footnote در محیط‌های شناور به‌درستی کار نمی‌کند.

"IDENTICAL"

هیچ تفاوتی میان متن اصلی و محیط‌های شناور قائل نمی‌شود..SS "متغیرهای پیکربندی (Configuration Variables)"

"ARRENV"

اگر تطابقی با "ARRENV" درون یک محیط ریاضی درون‌خطی در یک بلوک حذف‌شده یا اضافه‌شده یافت شود، آن‌گاه عبارت ریاضی درون‌خطی در میان "\mbox{"..."}" قرار می‌گیرد. این امر از آنجا ضروری است که خط کشیدن زیر متن (underlining) در محیط‌های آرایه‌ایِ درون‌خطی کار نمی‌کند.

[ پیش‌فرض: "ARRENV"="(?:array|[pbvBV]matrix)" 

"COUNTERCMD"

اگر دستوری در یک بلوک حذف‌شده که در فهرست textcmd نیز وجود دارد با "COUNTERCMD" مطابقت داشته باشد، آن‌گاه دستور اضافی "\addtocounter{"cntcmd"}{-1}"، که در آن cntcmd دستور منطبق است، به فایل diff الحاق می‌شود تا شماره‌گذاری در فایل diff با شماره‌گذاری در فایل جدید همگام باقی بماند.

[ پیش‌فرض: "COUNTERCMD"="(?:footnote|part|section|subsection" ...

"|subsubsection|paragraph|subparagraph)" ]

"CUSTOMDIFCMD"

این گزینه برای کاربران پیشرفته است و امکان تعریف نسخه‌های ویژه‌ای از دستورها را فراهم می‌آورد که به عنوان دستورهای امن کار نمی‌کنند.

دستورهای موجود در "CUSTOMDIFCMD" که در بلوک‌های اضافه‌شده یا حذف‌شده رخ می‌دهند، یک پیشوند ADD یا DEL دریافت خواهند کرد. نسخه‌های پیشونددارِ دستور باید در دیباچه تعریف شوند، خواه با قرار دادن آن‌ها در دیباچه دست‌کم فایل جدید، یا با ایجاد یک فایل دیباچه سفارشی (گزینه --preamble). برای نمونه، دستور "\blindtext" (از بسته blindtext) به خوبی با زیرخط‌کشی سازگار نیست، به گونه‌ای که برای نوع نشانه‌گذاری استاندارد، تعریف آن به عنوان یک دستور امن رضایت‌بخش نیست. در عوض، می‌توان نسخه‌های سفارشی‌شده بدون خط‌کشی را در دیباچه تعریف کرد:

"\newcommand{\DELblindtext}{{\color{red}\blindtext}}"

"\newcommand{\ADDblindtext}{{\color{blue}\blindtext}}"

و سپس latexdiff باید با گزینه "-c CUSTOMDIFCMD=blindtext"; فراخوانی شود.

[ پیش‌فرض: none ]

"FLOATENV"

محیط‌هایی که نام آن‌ها با عبارت باقاعده موجود در "FLOATENV" مطابقت داشته باشد، شناور در نظر گرفته می‌شوند. در این محیط‌ها، دستورهای نشانه‌گذاری latexdiff با انواع FL آن‌ها جایگزین می‌شوند.

[ پیش‌فرض: "(?:figure|table|plate)[\w\d*@]*" ]

"ITEMCMD"

دستورهایی که نشان‌دهنده سطر آیتم جدید در محیط‌های فهرست هستند.

[ پیش‌فرض: \"item" ]

"LISTENV"

محیط‌هایی که نام آن‌ها با عبارت باقاعده موجود در "LISTENV" تطابق دارد، محیط‌های فهرست هستند.

[ پیش‌فرض: "(?:itemize|enumerate|description)" ]

"MATHENV","MATHREPL"

اگر هر دو دستور \begin و \end برای یک محیط ریاضی (نام محیط منطبق با "MATHENV" یا \[ و \]) در همان بلوک حذف‌شده یکسان قرار داشته باشند، به‌جای اینکه کامنت شوند، با دستورهای \begin و \end برای "MATHREPL" جایگزین می‌شوند.

[ پیش‌فرض: "MATHENV"="(?:displaymath|equation)" , "MATHREPL"="displaymath" ]

"MAXCHANGESLETTER" هنگامی که latexdiff جایگزینی یک تک‌کلمه را تشخیص می‌دهد، تلاش می‌کند تا تغییرات را در سطح حرف شناسایی کند. اگر تغییرات زیادی وجود داشته باشد، این احتمال هست که کلمه به طور کامل جایگزین شده باشد، و تغییرات در سطح حرف به جای مفید بودن گیج‌کننده خواهد بود. در این حالت، latexdiff به نمایش جایگزینی در سطح کلمه بازمی‌گردد. رویکردِ تشخیص این دو حالت صرفاً شمارش تعداد افزودن‌ها و حذف‌های متمایز است (نه تعداد حروف تغییریافته!)، و تنها در صورتی که این تعداد کمتر یا مساوی با MAXCHANGESLETTER باشد، نشانه‌گذاری در سطح حرف به کار می‌رود. مقادیر معقول 0، 1 یا 2 هستند. مقدار 0 نشانه‌گذاری در سطح حرف را به طور کامل غیرفعال می‌کند. مقدار 1 تنها یک افزودن یا حذف منفرد را مجاز می‌داند، برای نمونه برای تصحیح یک غلط املایی یا تغییر مفرد/جمع یک فعل، اما نه یک جایگزینی. مقدار 2 یک جایگزینی (یا دو افزودن یا حذف) را مجاز می‌داند---این امر گاهی سبب می‌شود کلمات متفاوتی در سطح حرف نشانه‌گذاری شوند، مثلاً they-> there حرف "y" حذف‌شده و "re" اضافه‌شده را نمایش می‌دهد، که اغلب نامطلوب است.

[ پیش‌فرض: 1 ]

"MINWORDSBLOCK"

حداقل تعداد توکن‌های لازم برای تشکیل یک بلوک مستقل. این مقدار در الگوریتم تشخیص تغییرات بلوک‌های کامل، با ادغام بخش‌های متنیِ یکسانِ کمتر از "MINWORDSBLOCK" با بخش‌های اضافه‌شده و کنارگذاشته‌شده قبلی استفاده می‌شود.

[ پیش‌فرض: 3 ]

"PICTUREENV"

درون محیط‌هایی که نام آن‌ها با عبارت باقاعده موجود در "PICTUREENV" مطابقت دارد، تمام نشانه‌گذاری‌های latexdiff حذف می‌شوند (در موارد حاد و نامتعارف ممکن است این امر به نشانه‌گذاری ناسازگار منجر شود اما این وضعیت باید نادر باشد).

[ پیش‌فرض: "(?:picture|DIFnomarkup)[\w\d*@]*" ]

"SCALEDELGRAPHICS"

اگر "--graphics-markup=both" انتخاب شود، "SCALEDELGRAPHICS" ضریبی است که تصاویر حذف‌شده با آن مقیاس‌بندی می‌شوند (یعنی 0.5 به این معنی است که آن‌ها در نصف اندازه خطی نمایش داده می‌شوند).

[ پیش‌فرض: 0.5 ]

"VERBATIMENV"

عبارت باقاعده‌ای (RegEx) که محیط‌هایی مانند verbatim را توصیف می‌کند که محتوای آن‌ها باید عیناً در نظر گرفته شود. محتوای این محیط‌ها به هیچ وجه پردازش نخواهد شد: محتوای حذف‌شده کامنت می‌شود، محتوای جدید نشانه‌گذاری نمی‌شود

[ پیش‌فرض: "comment"  ]

"VERBATIMLINEENV"

عبارت باقاعده‌ای (RegEx) که محیط‌هایی مانند verbatim را توصیف می‌کند که محتوای آن‌ها باید عیناً در نظر گرفته شود. محتوای محیط‌های توصیف‌شده با VERBATIMLINEENV در حالت خطی مقایسه می‌شوند و تغییرات با استفاده از بسته listings نشانه‌گذاری می‌شوند. سبک نشانه‌گذاری بر اساس نوع نشانه‌گذاری اصلی انتخاب‌شده (گزینه -t)، یا بر پایه تحلیل دیباچه تعیین می‌شود. توجه داشته باشید که "listings.sty" باید نصب باشد. اگر این فایل یافت نشود، راه‌حل جایگزین (fallback) این است که با محیط‌های VERBATIMLINEENV دقیقاً مانند محیط‌های VERBATIMENV رفتار شود.

[ پیش‌فرض: "(?:verbatim[*]?|lstlisting"  ]