latexdiff - آنلاین در ابر

برنامه:

نام

latexdiff - تعیین و نشانه گذاری تفاوت بین دو فایل لاتکس

خلاصه

لاتکس دیف [ OPTIONS ] قدیمی.تکس new.tex > diff.tex

شرح

به طور خلاصه، لاتکس دیف یک برنامه کاربردی برای کمک به مدیریت تجدید نظر در لاتکس است
اسناد. دو فایل لاتکس معتبر را که در اینجا "old.tex" و "new.tex" نامیده می شوند، مقایسه می کند.
تفاوت معنی داری بین آنها (یعنی نادیده گرفتن تعداد فاصله های سفید و
موقعیت خطوط شکسته)، و دستورات ویژه ای را برای برجسته کردن تفاوت ها اضافه می کند. جایی که
برجسته سازی بصری امکان پذیر نیست، به عنوان مثال برای تغییرات در قالب بندی، تفاوت ها
با این وجود در منبع مشخص شده اند.

برنامه با مقدمه متفاوت از سند اصلی رفتار می کند. تفاوت های بین
مقدمه ها با استفاده از تفاوت های مبتنی بر خط (مانند دستور diff یونیکس،
اما با نادیده گرفتن فضاهای سفید). یک نظر، ""%DIF >"" به هر خط اضافه شده اضافه می شود، یعنی a
خط در "new.tex" وجود دارد اما در "old.tex" وجود ندارد. خطوط دور ریخته شده
با اضافه کردن ""%DIF <" غیرفعال می شوند. قبل از بلوک های تغییر یافته، خطوط نظر وجود دارد
ارائه اطلاعات در مورد شماره خطوط در فایل های اصلی. که در آن وجود دارد
تفاوت های ناچیز، فایل حاصل "diff.tex" مشابه "new.tex" خواهد بود. در
پایان مقدمه، تعاریف برای لاتکس دیف دستورات نشانه گذاری درج شده است. که در
تفاوت بخش اصلی متن، لاتکس دیف تلاش می کند تا موارد زیر را برآورده کند
دستورالعمل (به ترتیب اولویت):

1. اگر هر دو "old.tex" و "new.tex" LaTeX معتبر هستند، "diff.tex" حاصل باید
همچنین LateX معتبر باشد. (نکته اگر چند دستور ساده TeX در "old.tex" یا استفاده شود
"new.tex" سپس "diff.tex" تضمینی برای کار کردن نیست اما معمولاً کار می کند).

2. تفاوت های قابل توجهی در سطح کلمات فردی مشخص می شود. همه
تفاوت های قابل توجه، از جمله تفاوت بین نظرات باید به وضوح باشد
در کد منبع حاصل "diff.tex" مشخص شده است.

3. اگر متن تغییر یافته حاوی دستورات تولید متن یا متن باشد، «diff.tex» را اجرا کنید.
از طریق LateX باید خروجی تولید کند که در آن قسمت‌های اضافه شده و حذف شده برجسته می‌شوند.

4. در مواردی که تفاوت‌های ناچیز وجود دارد، به عنوان مثال در موقعیت‌یابی شکستگی‌های خط،
"diff.tex" باید از قالب بندی "new.tex" پیروی کند.

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

\section{\textem{این عنوان بخش تاکید شده است}}

و نه

\section {\textem{این عنوان بخش تاکید شده است}}

or

\section\textem{این عنوان بخش تاکید شده است}

حتی اگر همه انواع مشابه LaTeX هستند (اما ببینید ---فضاها گزینه ای که
تنوع دوم را اجازه می دهد).

برای محیط هایی که محتوای آنها با استاندارد LaTeX یا محیط های گرافیکی مطابقت ندارد
نشانه گذاری معنی ندارد همه دستورات نشانه گذاری را می توان با تنظیم PICTUREENV حذف کرد
متغیر پیکربندی که به طور پیش‌فرض روی محیط‌های «تصویر» و «DIFnomarkup» تنظیم شده است. دیدن
- پیکربندی گزینه). محیط دوم ("DIFnomarkup") می تواند برای محافظت از بخش هایی استفاده شود
فایل لاتکس که در آن نشانه گذاری منجر به نشانه گذاری غیرقانونی می شود. شما باید اطراف را احاطه کنید
متن توهین آمیز در فایل قدیمی و جدید توسط "\begin{DIFnomarkup}" و
"\end{DIFnomarkup}". شما باید محیط را در مقدمه های قدیم و جدید تعریف کنید
اسناد. من ترجیح می دهم آن را به عنوان یک محیط پوچ تعریف کنم،

"\newenvironment{DIFnomarkup}{}{}"

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

همچنین امکان تفکیک فایل هایی که مقدمه ندارند نیز وجود دارد.
در این مورد، فایل در حالت سند اصلی پردازش می شود، اما تعاریف از
دستورات نشانه گذاری درج نمی شوند.

همه دستورات نشانه گذاری درج شده توسط لاتکس دیف با ""\DIF" شروع کنید. بلوک های اضافه شده حاوی
کلمات، دستورات یا نظراتی که در "new.tex" هستند اما در "old.tex" نیستند با علامت گذاری می شوند.
"\DIFaddbegin" و "\DIFaddend". بلوک های دور ریخته شده با "\DIFdelbegin" و علامت گذاری می شوند
"\DIFdelend". در بلوک های اضافه شده، تمام متن با "\DIFadd" مانند این برجسته می شود:
"\DIFadd{Added text block}" دستورات "ایمن" انتخابی را می توان در این بلوک های نوشتاری قرار داد
همچنین (از گزینه هایی برای نمایش و تغییر لیست دستورات امن استفاده کنید، به زیر مراجعه کنید). همه دیگر
دستورات و همچنین بریس های "{" و "}" هرگز در محدوده "\DIFadd" قرار نمی گیرند. اضافه
نظرات با اضافه کردن ""%DIF > "" علامت گذاری می شوند.

متن در بلوک های حذف شده با "\DIFdel" برجسته می شود. نظرات حذف شده با علامت گذاری می شوند
در حال آماده کردن ""%DIF < "". فرمان غیر ایمن و مهاربندهای فرفری درون بلوک های حذف شده هستند
با ""%DIFDELCMD < "نظر داد.

OPTIONS

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

--type=markupstyle or -t سبک نشانه گذاری
برای سبک نشانه گذاری انتخاب شده کد را به مقدمه اضافه کنید. این گزینه "\DIFadd" و را تعریف می کند
دستورات "\DIFdel". سبک های موجود:

خط کشی CTRADITIONAL TRADITIONAL CFONT FONTSTRIKE INVISIBLE CANGEBAR CCHANGEBAR
CULINECHBAR CFONTCBHBAR BOLD"

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

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

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

--floattype=markstyle or -f مارک استایل
برای سبک انتخابی که جایگزین علامت گذاری و نشانه گذاری استاندارد می شود، کد را به مقدمه اضافه کنید
دستورات درون شناورها (به عنوان مثال، اظهارات حاشیه ای باعث ایجاد خطا در شناورها می شود
بنابراین علامت گذاری حاشیه ای را می توان غیرفعال کرد). این گزینه تمام دستورات "\DIF...FL" را تعریف می کند.
سبک های موجود: "FLOATSAFE TRADITIONALSAFE IDENTICAL"

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

--encoding=enc or -e رمز
رمزگذاری old.tex و new.tex را مشخص کنید. رمزگذاری های معمولی عبارتند از "ascii"، "utf8"،
"latin1"، "latin9". لیستی از رمزگذاری های موجود را می توان با اجرا به دست آورد

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

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

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

--بسته ها=pkg1,pkg2,..
به latexdiff بگویید که فایل .tex با بسته های موجود در لیست بارگذاری شده پردازش می شود. این هست
اگر فایل .tex شامل مقدمه باشد، معمولاً لازم نیست، همانطور که مقدمه است
به طور خودکار برای دستورات "\usepackage" اسکن می شود. استفاده از -- بسته ها انتخاب
اسکن خودکار را غیرفعال می کند، بنابراین اگر به هر دلیلی نیاز به تجزیه بسته خاص است
خاموش، استفاده کنید -- بسته = هیچ. بسته های زیر باعث ایجاد رفتار ویژه می شوند:

"امسمت"
متغیر پیکربندی MATHARRREPL روی "align*" تنظیم شده است (پیش فرض: "eqnarray*").
(توجه داشته باشید که بسیاری از محیط‌های آرایه amsmath قبلاً توسط آن شناسایی شده‌اند
پیش فرض به این صورت)

"endfloat"
اطمینان حاصل کنید که "\begin{figure}" و "\end{figure}" همیشه به تنهایی در آن ظاهر می شوند
یک خط

"hyperref"
نام دستورات "\DIFadd" و "\DIFdel" را به "\DIFaddtex" تغییر دهید و
"\DIFdeltex" و دستورات جدید "\DIFadd" و "\DIFdel" را تعریف کنید، که یک
wrapper برای این دستورات، استفاده از آنها برای متن اما نه برای پیوند
تعریف دستور (که در آن هر علامت گذاری باعث خطا می شود).

"آپاسیت"
دستورات شناخته شده به عنوان دستورات نقل قول را دوباره تعریف کنید.

"siunitx"
"\SI" را معادل دستورات استنادی در نظر بگیرید (به عنوان مثال با "\mbox" محافظت کنید
سبک نشانه گذاری از بسته ulem استفاده می کند.

"باهوش"
"\cref,\Cref" و غیره را معادل دستورات استناد تلقی کنید (یعنی محافظت با
اگر سبک نشانه‌گذاری از بسته ulem استفاده کند، "\mbox".

"واژه نامه ها"
بیشتر دستورات واژه نامه ها را ایمن تعریف کنید و با \mbox'es از آنها محافظت کنید
جایی که نیاز است

"mhchem"
"\ce" را به عنوان یک فرمان امن در نظر بگیرید، یعنی برجسته می شود (توجه داشته باشید که "\cee"
در معادلات برجسته نمی شود زیرا منجر به خطاهای پردازش می شود)

"شیمی فرمول" یا "کماکرو"
با "\ch" به عنوان یک دستور امن خارج از معادلات رفتار کنید، یعنی برجسته خواهد شد
(توجه داشته باشید که "\ch" در معادلات برجسته نمی شود زیرا منجر به این می شود
خطاهای پردازش)

[ پیش‌فرض: مقدمه دستورات «\usepackage» را برای تعیین اسکن کنید
بسته های بارگذاری شده ]

--نمایش-مقدمه
دستورات مقدمه تولید شده یا شامل stdout را چاپ کنید.

پیکر بندی
--exclude-safecmd=exclude-file or -A exclude-file or --exclude-safecmd="cmd1,cmd2,..."
--replace-safecmd=replace-file
--append-safecmd=append-file or -a فایل ضمیمه or --append-safecmd="cmd1,cmd2,..."
از لیست تطبیق عبارات منظم (RegEx) حذف، جایگزین یا الحاق شود
دستوراتی که برای استفاده در محدوده فرمان "\DIFadd" یا "\DIFdel" ایمن هستند.
فایل باید حاوی یک Perl-RegEx در هر خط باشد (خطوط نظر که با # یا % شروع می‌شوند
نادیده گرفته شده است). توجه داشته باشید که RegEx باید با کل توکن مطابقت داشته باشد، یعنی /^regex$/
ضمنی است و "\" اولیه دستور شامل نمی شود. در
--exclude-safecmd و --append-safecmd گزینه ها را می توان با
---replace-safecmd گزینه و می تواند مکرراً برای افزودن تجمعی به لیست ها استفاده شود.
--exclude-safecmd و --append-safecmd همچنین می تواند یک لیست جدا شده با کاما را به عنوان ورودی بگیرد.
اگر یک کاما برای یکی از Regex مورد نیاز است، از آن به این ترتیب "\" فرار کنید. در بیشتر موارد آن را
برای محافظت از لیست جدا شده با کاما از پوسته با قرار دادن آن ضروری است
نقل قول ها

--exclude-textcmd=exclude-file or -X exclude-file or --exclude-textcmd="cmd1,cmd2,..."
--replace-textcmd=replace-file
--append-textcmd=append-file or -x فایل ضمیمه or --append-textcmd="cmd1,cmd2,..."
از لیست دستورات منطبق با عبارات منظم حذف، جایگزین یا اضافه شود
که آخرین آرگومان آن متن است. ورودی برای را ببینید --exclude-safecmd مستقیماً در بالا برای
جزئیات بیشتر.

--replace-context1cmd=replace-file
--append-context1cmd=append-file یا = آیتم --append-context1cmd="cmd1,cmd2,..."
به لیستی از دستورات تطبیق regex که آخرین آرگومان آنها متن است، جایگزین یا اضافه کنید
اما برای کار کردن به زمینه خاصی نیاز دارند، مثلاً \caption فقط در a کار می کند
شکل یا جدول این دستورات مانند دستورات متنی عمل می کنند، به جز زمانی که در آن رخ می دهند
یک بخش حذف شده، زمانی که آنها غیرفعال هستند، اما آرگومان آنها حذف شده نشان داده می شود
متن.

--replace-context2cmd=replace-file
--append-context2cmd=append-file یا = آیتم --append-context2cmd="cmd1,cmd2,..."
به عنوان دستورات مربوطه برای context1. تنها تفاوت در دستورات context2 است
در بخش های حذف شده، از جمله آرگومان های آنها، کاملاً غیرفعال هستند.

--exclude-mboxsafecmd=exclude-file or --exclude-mboxsafecmd="cmd1,cmd2,..."
--append-mboxsafecmd=append-file or --append-mboxsafecmd="cmd1,cmd2,..."
دستورات ایمن را تعریف کنید، که علاوه بر این باید با کپسوله کردن در یک محافظت شوند
\\mbox{..}. این گاهی اوقات برای دور زدن ناسازگاری های خارجی مورد نیاز است
بسته ها و بسته ulem که برای برجسته کردن در سبک پیش فرض استفاده می شود
UNDERLINE و همچنین CULINECHBAR CFONTSTRIKE

- پیکربندی var1=val1,var2=val2,... or -c var1=val1،..
-c پیکربندی
تنظیم متغیرهای پیکربندی گزینه را می توان برای تنظیم متغیرهای مختلف تکرار کرد
(به عنوان جایگزینی برای لیست جدا شده با کاما). متغیرهای موجود (برای مشاهده به زیر مراجعه کنید
توضیحات بیشتر):

"ARRENV" (RegEx)

"COUNTERCMD" (RegEx)

"FLOATENV" (RegEx)

"ITEMCMD" (RegEx)

"LISTENV" (RegEx)

"MATHARRENV" (RegEx)

"MATHARREPL" (رشته)

"MATHENV" (RegEx)

"MATHREPL" (رشته)

"MINWORDSBLOCK" (عدد صحیح)

"PICTUREENV" (RegEx)

--show-safecmd
لیستی از تطبیق و حذف دستورات ایمن RegEx را چاپ کنید.

--show-textcmd
لیستی از دستورات تطبیق و حذف RegEx را با آرگومان متنی چاپ کنید.

--show-config
نمایش مقادیر متغیرهای پیکربندی

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

NB برای همه دستورات --show، هیچ فایل "old.tex" یا "new.tex" لازم نیست مشخص شود، و
هیچ تفاوتی رخ نمی دهد

دیگر پیکر بندی گزینه ها:
---فضاها
بین آرگومان های پرانتزی یا پرانتزی برای دستورات فاصله بگذارید. توجه داشته باشید که این گزینه
ممکن است عوارض جانبی نامطلوبی داشته باشد (محدوده نامربوط ممکن است با موارد قبلی یکپارچه شود
دستورات) بنابراین فقط در صورتی باید استفاده شود که پیش فرض نتایج اشتباهی ایجاد کند. (پیش فرض
مستلزم استدلال هایی است که مستقیماً بدون فضاهای مداخله ای از یکدیگر پیروی کنند).

--math-markup=سطح
تعیین دانه بندی نشانه گذاری در محیط های ریاضی نمایش داده شده: مقادیر ممکن برای
سطح عبارتند از (هر دو برچسب عددی و متنی قابل قبول هستند):

"خاموش" یا 0: سرکوب نشانه گذاری برای محیط های ریاضی. معادلات حذف شده ظاهر نمی شوند
در فایل diff اگر همه حالت های دیگر باعث ایجاد کد لاتکس نامعتبر شوند، می توان از این حالت استفاده کرد.

"کل" یا 1: تفاوت در سطح کل معادلات. حتی تغییرات پیش پا افتاده به
معادلات باعث می شوند که کل معادله تغییر یافته علامت گذاری شود. این حالت می تواند مورد استفاده قرار گیرد اگر
پردازش در حالت درشت یا ریز منجر به کد لاتکس نامعتبر می شود.

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

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

- غیرفعال کردن-استناد-نشانه گذاری or - غیرفعال کردن خودکار mbox
سرکوب نشانه‌گذاری استناد و نشانه‌گذاری سایر دستورات آسیب‌پذیر در سبک‌هایی با استفاده از ulem
(UNDERLINE، FONTSTRIKE، CULINECHBAR) (دو گزینه یکسان هستند و به سادگی هستند
نام مستعار)

--enable-citation-markup or -- Enforce-auto-mbox
از دستورات نقل قول و سایر دستورات آسیب پذیر در بخش های تغییر یافته محافظت کنید
دستور "\mbox"، یعنی از رفتار پیش‌فرض برای بسته ulem برای بسته‌های دیگر استفاده کنید (the
دو گزینه یکسان هستند و به سادگی نام مستعار هستند)

متفرقه
-- پرحرف or -V
اطلاعات وضعیت مختلف را در حین پردازش به stderr ارسال کنید. پیش فرض کار کردن است
بی صدا

-- راننده = نوع
درایور را برای بسته تغییر نوار انتخاب کنید (فقط مربوط به سبک های استفاده شده است
تغییر نوار: CCHANGEBAR CFONTCHBAR CULINECHBAR CHANGEBAR). درایورهای احتمالی هستند
فهرست شده در راهنمای تغییر نوار، به عنوان مثال pdftex، dvips، dvitops
[پیش‌فرض: dvips]

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

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

--بدون برچسب
عدم درج نام فایل های قدیمی و جدید به عنوان نظر در فایل خروجی

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

-- مسطح کردن
دستورات "\input" و "\include" در داخل بدنه را با محتوای فایل‌های موجود جایگزین کنید
استدلال آنها اگر «\includeonly» در مقدمه وجود داشته باشد، فقط آن فایل‌ها هستند
در سند گسترش یافته است. با این حال، هیچ بازگشتی انجام نمی شود، یعنی "\input" و
دستورات «\include» در بخش‌های گنجانده شده گسترش نمی‌یابند. فایل های موجود هستند
فرض شده است
به ترتیب در دایرکتوری های اصلی فایل های اصلی قدیمی و جدید قرار گیرند،
سازماندهی فایل ها را در دایرکتوری های قدیمی و جدید ممکن می کند. -- مسطح است
به صورت بازگشتی اعمال می شود، بنابراین فایل های ورودی می توانند حاوی عبارات "\input" بیشتری باشند.

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

--کمک or -h
نمایش متن راهنما

- نسخه
نمایش شماره نسخه

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

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

"سنتی"
متن اضافه شده آبی است و در sans-serif تنظیم شده است و برای هر کدام یک پاورقی قرمز ایجاد می شود
تکه متن دور ریخته شده (به بسته رنگی نیاز دارد)

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

"CFONT" متن اضافه شده آبی است و در sans-serif تنظیم شده است، و متن حذف شده قرمز و بسیار است
اندازه کوچک.

"FONTSTRIKE"
متن اضافه شده در sans-serif تنظیم می‌شود، متن دور انداخته می‌شود و کوچک می‌شود

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

"CFONTCHBAR"
مانند "CFONT" اما با نوارهای تغییر اضافی (به رنگ و نوار تغییر نیاز دارد
بسته ها)

"CULINECHBAR"
مانند "UNDERLINE" اما با نوارهای تغییر اضافی (نیاز به رنگ، ulem و
بسته های تغییر بار).

"CHANGEBAR"
بدون علامت گذاری متن، اما حاشیه ها را با نوارهای تغییر علامت گذاری کنید (نیاز به تغییر نوار
بسته بندی)

"نامرئی"
علامت گذاری قابل مشاهده نیست (اما دستورات نشانه گذاری عمومی همچنان درج خواهند شد.

متن اضافه شده "BOLD" به صورت پررنگ تنظیم شده است، نادیده گرفته شده نشان داده نمی شود.

زیرگروه ها
زیرنوع دستوراتی را که در ابتدا و انتهای افزوده شده یا درج می شوند را تعریف می کند
بلوک های دور ریخته شده، صرف نظر از اینکه این بلوک ها حاوی متن یا دستورات هستند (تعریف شده
دستورات: "\DIFaddbegin، \DIFaddend، \DIFdelbegin، \DIFdelend")

"SAFE" بدون علامت اضافی (انتخاب توصیه شده)

"MARGIN" ابتدا و انتهای بلوک های تغییر یافته را با نمادهایی در حاشیه نزدیک علامت گذاری کنید
(با استفاده از دستور استاندارد "\marginpar" - توجه داشته باشید که گاهی اوقات حرکت می کند
تا حدودی از موقعیت مورد نظر.

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

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

"ZLABEL" را می توان فقط برای برجسته کردن صفحات تغییر یافته استفاده کرد، اما نیاز به پس پردازش دارد. این است
توصیه می شود این گزینه را به صورت دستی فراخوانی نکنید، بلکه از "latexdiff-vc" با آن استفاده کنید
گزینه "--only-changes". متناوبا، از اسکریپت داده شده در مقدمه استفاده کنید
فایل های diff که با استفاده از این سبک ساخته شده اند.

"ONLYCHANGEDPAGE"
همچنین صفحات تغییر یافته را بدون نیاز به پس پردازش برجسته می کند، اما ممکن است
در صورت وجود مواد شناور (شکل ها، جداول) قابل اطمینان کار نمی کند.

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

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

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

"سنتی ایمن"
اضافات را مانند متن اصلی علامت بزنید. محیط های حذف شده هستند
با براکت های زاویه ای \[ و \] مشخص شده و متن حذف شده در اسکریپت تنظیم می شود
اندازه. این نوع شناور همیشه باید با "سنتی" و
نشانه گذاری "CTRADITIONAL" به دلیل اینکه دستور \footnote به درستی در آن کار نمی کند
محیط های شناور

"همسان"
بین متن اصلی و شناور تفاوتی قائل نشوید.

پیکر بندی متغیر
"ARRENV" اگر مطابق با "ARRENV" در یک محیط ریاضی درون خطی در a یافت شود
بلوک حذف یا اضافه شد، سپس ریاضیات خطی شده با "\mbox{"..."} احاطه شده است.
این امر ضروری است زیرا خط کشی در آرایه خطی کار نمی کند
محیط.

[ پیش‌فرض: "ARRENV"="(?:array|[pbvBV]ماتریس)"

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

[ پیش‌فرض: "COUNTERCMD"="(?:footnote|بخش|بخش|فرع" ...

"|فرعی|بند|فرعی)" ]

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

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

دستورات "ITEMCMD" نشان دهنده خط آیتم جدید با محیط های لیست است.

[پیش‌فرض: \"مورد" ]

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

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

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

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

"MATHARRENV"، "MATHARRRREPL"
به عنوان "MATHENV"، "MATHREPL" اما برای آرایه های معادله

[ پیش‌فرض: "MATHARRENV"="eqnarray\*?" , "MATHREPL"="eqnarray" ]

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

[پیش‌فرض: 3]

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

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

مشترک مشکلات و پاسخ به برخی سوالات مهم

نقل‌قول‌ها منجر به کادرهای بیش از حد پر می‌شود
بین بسته "ulem" که "latexdiff" از آن استفاده می کند ناسازگاری وجود دارد
برای خط کشی و برجسته کردن در سبک UNDERLINE، سبک پیش فرض و
روش تولید استناد برای اینکه بتوانید نقل قول ها را علامت گذاری کنید
به درستی، آنها با دستور "\mbox" محصور شده اند. همانطور که mboxes را نمی توان شکست
در سراسر خطوط، این روش اغلب منجر به پر شدن جعبه ها می شود
پنهان کردن محتوا زیرا از حاشیه سمت راست فراتر می رود. همین اتفاق می افتد
برای برخی از بسته های دیگر (به عنوان مثال، siunitx). اگر این یک مشکل است، شما دو نفر دارید
ممکن ها.

1. از نشانه گذاری نوع "CFONT" استفاده کنید (گزینه "-t CFONT"): اگر این نشانه گذاری انتخاب شده است، سپس
نقل قول های تغییر یافته دیگر با خط موج دار (اضافه ها) یا علامت گذاری نمی شوند
حذف شده (حذف شده)، اما همچنان با رنگ مناسب برجسته می شوند، و
متن حذف شده با فونت دیگری نشان داده می شود. سبک های دیگر که از "علم" استفاده نمی کنند
بسته نیز کار خواهد کرد.

2. گزینه "--disable-citation-markup" را انتخاب کنید که علامت گذاری را خاموش می کند
نقل قول ها: نقل قول های حذف شده دیگر نشان داده نمی شوند و نقل قول های اضافه شده نشان داده می شوند
بدون نشانه گذاری (این رفتار پیش‌فرض latexdiff در نسخه‌های 0.6 و
مسن تر)

برای بسته های سفارشی می توانید دستوراتی را تعریف کنید که باید توسط آنها محافظت شود
"\mbox" با گزینه های "--append-mboxsafecmd" و "--excludemboxsafecmd" (ارسال
لیست دستورات شما به عنوان درخواست ویژگی در صفحه github برای تنظیم پیش فرض
رفتار نسخه های آینده، بخش 6 را ببینید)

تغییرات در معادلات پیچیده ریاضی منجر به خطاهای پردازش لاتکس می شود
گزینه های "--math-markup=whole" را امتحان کنید. اگر حتی آن هم ناموفق بود، می توانید علامت را خاموش کنید
برای معادلات با "--math-markup=off".

چگونه می توانم صفحاتی را که در آن تغییرات ایجاد شده است نشان دهم
از گزینه های -"-s ZLABEL" (برخی پس پردازش مورد نیاز) یا "-s" استفاده کنید
ONLYCHANGEDPAGE". "latexdiff-vc --ps|--pdf" با گزینه "--only-changes" طول می کشد
مراقبت از پس پردازش برای شما (نیاز به نصب بسته zref دارد).

از latexdiff آنلاین با استفاده از خدمات onworks.net استفاده کنید