نام (NAME)

latexdiff-vc - اسکریپت واسط برای فراخوانی latexdiff جهت مقایسهٔ نسخه‌های مختلف یک فایل تحت مدیریت نسخه (CVS، RCS یا SVN)

خلاصه دستور (SYNOPSIS)

latexdiff-vc [ latexdiff-options ] [ latexdiff-vc-options ] -r [rev1] [-r rev2] file1.tex [ file2.tex ...]

یا

latexdiff-vc [ latexdiff-options ] [ latexdiff-vc-options ][ --postscript | --pdf ] old.tex new.tex

توضیحات (DESCRIPTION)

latexdiff-vc یک اسکریپت واسط است که latexdiff را روی یک فایل یا چندین فایل تحت کنترل نسخه (git، subversion (SVN)، mercurial (hg)، CVS، RCS) اعمال کرده و به‌طور اختیاری توالی دستورهای "latex" و "dvips" یا "pdflatex" لازم برای تولید خروجی pdf یا postscript از فایل(های) tex تفاوت را اجرا می‌کند. همچنین می‌توان آن را بر روی یک جفت فایل برای خودکارسازی تولید فایل تفاوت در قالب postscript یا pdf اعمال کرد.

گزینه‌ها (OPTIONS)

--rcs، --svn، --cvs، --git یا --hg

سیستم کنترل نسخهٔ مورد استفاده را تعیین می‌کند. اگر هیچ سیستم کنترلی مشخص نشود، latexdiff-vc اقدام به حدس زدن آن خواهد کرد.

دستورهای latexdiff-cvs، latexdiff-rcs و غیره نگارش‌هایی از latexdiff-vc هستند که پیش‌فرض آن‌ها سیستم کنترل نسخهٔ مربوطه است. با این حال، می‌توان این پیش‌فرض را با استفاده از گزینه‌های بالا لغو کرد.

توجه داشته باشید که hg باید از گزینهٔ "--root" پشتیبانی کند (نسخهٔ >= 2.9).

-r، -r rev یا --revision، --revision=rev

انتخاب بازبینی (تحت RCS، CVS، SVN، GIT یا HG). یک یا دو گزینهٔ -r را می‌توان مشخص کرد، که رفتارهای متفاوتی در پی دارند:

-d یا --dir -d path یا --dir=path

به‌جای الصاق رشتهٔ "diff" و در صورت تمایل شماره‌های نسخه به فایل خروجی، نام دایرکتوری "diff" را در ابتدای نام فایل اصلی قرار می‌دهد، و در صورتی که دایرکتوری و زیردایرکتوری‌ها از پیش وجود نداشته باشند آن‌ها را ایجاد می‌کند. این قابلیت به‌ویژه برای همسان‌سازی کامل سلسله‌مراتب یک دایرکتوری مفید است. به‌صورت اختیاری، می‌توان یک مسیر path تعیین کرد تا به‌جای "diff" در ابتدا قرار گیرد.

--flatten,--flatten=keep-intermediate

در صورت ترکیب با گزینهٔ "--git"، "--svn" یا "--hg" یا حالت‌های مربوطه، بازبینی‌های مورد مقایسه را در یک دایرکتوری موقت مجزا واکشی (check out) کرده و سپس گزینهٔ "--flatten" را به latexdiff منتقل می‌کند. دایرکتوری‌ای که "latexdiff-vc" در آن فراخوانی می‌شود، زیردرختی را که واکشی خواهد شد مشخص می‌کند. توجه داشته باشید که اگر به فایل‌های اضافه‌ای نیاز است که در فرایند مسطح‌سازی (flatten) گنجانده نشده‌اند (فایل‌های بسته، تصاویر ضمیمه‌شده)، آن‌ها باید در دایرکتوری جاری در دسترس باشند. اگر از bibtex استفاده می‌کنید، توصیه می‌شود فایل ".bbl" را در مدیریت نسخه قرار دهید. از نسخهٔ latexdiff-vc >=1.3.4 تلاشی برای ایجاد فایل ".bbl" از طریق اجرای bibtex در زیردایرکتوری‌های بازیابی‌شده صورت می‌گیرد؛ توجه داشته باشید که bibtex در زیردایرکتوری‌های موقت اجرا می‌شود، بنابراین هرگونه فایل .bib یا .bst باید تحت مدیریت نسخه باشد، یا در مسیرهای جستجوی سراسری bibtex قرار داشته باشد (متغیرهای محیطی پوسته "BIBINPUTS" و "BSTINPUTS").

کاربرد عمومی این قابلیت به‌صورت روبه‌رو است: "latexdiff-vc --flatten -r rev1 [-r rev2] master.tex" که در آن master.tex فایل اصلی پروژه شامل بالاترین سطح ادغام‌ها (includes) و غیره است.

با گزینهٔ "--flatten=keep-intermediate"، نماگرفت‌های میانی بازبینی در دایرکتوری جاری نگه داشته می‌شوند (حالت پیش‌فرض ذخیرهٔ آن‌ها در دایرکتوری موقت و حذف پس از تولید فایل diff است).

--only-changes

خروجی را طوری پس‌پردازش می‌کند که فقط صفحات دارای تغییر نمایش داده شوند. این گزینه نیازمند استفاده از زیرنوع ZLABEL در latexdiff است که به‌صورت خودکار تنظیم خواهد شد، اما هر گزینهٔ -s تنظیم‌شده به‌صورت دستی را نادیده می‌گیرد (همچنین نیاز دارد که بستهٔ zref نصب باشد). این گزینه همچنین پیوندهای داخلی (آن‌طور که توسط بستهٔ hyperref پیاده‌سازی شده) و نشانه‌گذاری‌های گرافیکی را غیرفعال می‌کند. (توجه داشته باشید که این گزینه برای کارایی داشتن باید با --ps یا --pdf ترکیب شود)

--force

رونویسی فایل‌های diff موجود بدون درخواست تأیید. رفتار پیش‌فرض درخواست تأیید پیش از بازنویسی یک فایل تفاوت موجود است.

--run

اجرای دستور latex روی فایل diff پس از تولید آن.

--dvi

اجرای دستورهای latex و dvixxx پس از تولید فایل diff.

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

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

--fast یا --so

به‌ترتیب استفاده از "latexdiff-fast" یا "latexdiff-so" (به‌جای "latexdiff").

--ps یا --postscript

تولید خروجی postscript از فایل تفاوت. این کار توالی "latex; latex; dvips" را روی فایل تفاوت اجرا می‌کند (در موارد نادری که برای ارجاع‌دهی صحیح به سه بار اجرای دستور "latex" نیاز است، در صورت اهمیت داشتن ارجاع‌دهی درست از این گزینه استفاده نکنید). اگر فایل تفاوت حاوی یک برچسب "\bibliography" باشد، توالی "latex; bibtex; latex; latex; dvips" را اجرا خواهد کرد.

--pdf

تولید خروجی pdf از فایل تفاوت با استفاده از "pdflatex". این گزینه توالی "pdflatex; pdflatex" را روی فایل تفاوت، یا "pdflatex; bibtex; pdflatex; pdflatex" را برای فایل‌های نیازمند bibtex اجرا می‌کند. توجه داشته باشید که این گزینه صرفاً یک میان‌بر برای تنظیم متغیر پیکربندی نیست، بلکه رفتارهای خاصی را نیز فعال می‌سازد.

--show-config

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

--help یا -h

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

--version

نمایش شمارهٔ نسخه.

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

همچنین ببینید (SEE ALSO)

latexdiff

سازگاری (PORTABILITY)

latexdiff-vc از دستورهای خارجی استفاده می‌کند و بنابراین به معماری سیستم وابسته است؛ این برنامه عمدتاً بر روی سیستم‌های شبه‌یونیکس آزمایش شده است. همچنین برای بهره‌مندی از تمامی قابلیت‌ها، نیاز است که یک سیستم کنترل نسخه و latex بر روی سیستم نصب باشند. ماژول‌هایی از Perl 5.8 یا بالاتر مورد نیاز هستند.

گزارش باگ‌ها (BUGS)

لطفاً گزارش‌های باگ را با استفاده از سامانهٔ ردیابی مشکلات در صفحهٔ مخزن گیت‌هاب https://github.com/ftilmann/latexdiff.git ارسال کنید، یا آن‌ها را به نشانی tilmann -- AT -- gfz-potsdam.de بفرستید. شماره نسخهٔ latexdiff-vc (گزینهٔ "--version") را نیز ضمیمه کنید.

نویسندگان (AUTHORS)

نسخهٔ 1.3.4 حق نشر (C) 2005-2017 Frederik Tilmann

این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط پروانه عمومی همگانی گنو (GNU GPL) نسخهٔ 3 بازتوزیع کرده یا تغییر دهید. مشارکت‌کنندگان: S Utcke، H Bruyninckx؛ برخی ایده‌ها از اسکریپت بش git-latexdiff الهام گرفته شده‌اند. C. Junghans: پشتیبانی از Mercurial.