| GIT-LATEXDIFF(1) | GIT-LATEXDIFF(1) |
نام (NAME)
git-latexdiff - اجرای latexdiff روی دو بازبینی Git از یک فایل
گزینهها (OPTIONS)
کاربرد: git latexdiff [options] OLD [NEW]
git latexdiff [options] OLD --
git latexdiff [options] -- OLD
اجرای latexdiff روی دو بازبینی Git از یک فایل.
OLD و NEW شناسههای بازبینی Git هستند. مقدار پیشفرض NEW برابر HEAD است.
اگر برای NEW از «--» استفاده شود، مقایسه با دایرکتوری کاری انجام میشود.
گزینهها:
--help نمایش این پیام راهنما
--help-examples نمایش مثالهایی از کاربرد
--main <file> نام فایل اصلی LaTeX، R Sweave،
یا Emacs Org mode.
در صورت مشخص نشدن، جستجو برای تنها فایلی که
شامل 'documentclass' است انجام خواهد شد.
برای فایلهای غیر LaTeX، یک دستور `prepare` مناسب
استفاده خواهد شد مگر آنکه صراحتاً مشخص شده باشد
--no-view عدم نمایش فایل PDF حاصل
--latex اجرای latex بهجای pdflatex
--xelatex اجرای xelatex بهجای pdflatex
--lualatex اجرای lualatex بهجای pdflatex
--tectonic اجرای tectonic بهجای pdflatex
--bibtex, --bbl نمایش تغییرات در کتابنامه
(اجرای bibtex برای تولید فایلهای *.bbl و
گنجاندن آنها در فایل مبدأ با استفاده از
latexpand --expand-bbl پیش از محاسبه diff)
--biber مشابه --bibtex، اما بهجای آن biber را اجرا میکند.
--run-bibtex, -b اجرای bibtex و همچنین latex برای تولید فایل PDF
(pdflatex,bibtex,pdflatex,pdflatex)
نکته: معمولاً --bibtex بهتر کار میکند
--run-biber اجرای BibLaTex-Biber و همچنین latex برای تولید فایل PDF
(pdflatex,biber,pdflatex,pdflatex)
نکته: معمولاً --biber بهتر کار میکند
--view مشاهده فایل PDF حاصل
(در صورت عدم استفاده از -o پیشفرض است)
--pdf-viewer <cmd> استفاده از <cmd> برای مشاهده فایل PDF (پیشفرض: $PDFVIEWER)
--no-cleanup عدم پاکسازی دایرکتوری موقت پس از اجرا
--no-flatten عدم فراخوانی latexpand برای مسطحسازی سند
--cleanup MODE پاکسازی فایلهای موقت بر اساس MODE:
- keeppdf (پیشفرض): تنها فایل PDF
تولیدشده را نگه میدارد
- none: تمام فایلهای موقت را نگه میدارد
(ممکن است فضای دیسک شما را مصرف کند)
- all: تمام فایلهای تولیدشده را پاک میکند.
در صورت استفاده از --view مشکلساز خواهد بود وقتی
نمایشدهنده مثلاً evince باشد و حذف فایلی
که در حال نمایش است را نپذیرد.
--latexmk استفاده از latexmk
--build-dir استفاده از pdfها از یک دایرکتوری ساخت مشخص
--latexopt ارسال گزینههای اضافی به latex (مانند -shell-escape)
-o <file>, --output <file>
رونوشت از PDF حاصل در <file> (معمولاً با پسوند .pdf)
مستلزم «--cleanup all» است
--tmpdirprefix محل ایجاد دایرکتوری موقت (پیشفرض: /tmp).
مسیر نسبی از ریشه مخزن بهعنوان مبنا استفاده خواهد کرد
--verbose, -v ارائه خروجی با جزئیات بیشتر
--quiet هدایت خروجی از زیرپردازهها به فایلهای لاگ
--prepare <cmd> اجرای <cmd> پیش از latexdiff (مثلاً اجرای make برای تولید
فایلهای گنجاندهشده)
--filter <cmd> اجرای <cmd> پس از latexdiff و پیش از کامپایل
(مثلاً برای اصلاح خروجی latexdiff)
--ln-untracked ایجاد پیوند نمادین (symlink) برای فایلهای کامیتنشده از دایرکتوری کاری
--ln-untracked-dir <dir>
ایجاد پیوند نمادین برای زیردایرکتوری از فایلهای کامیتنشده (نسبت به فایل اصلی .tex)
--version نمایش نسخه git-latexdiff.
--subtree استخراج (checkout) درخت در مسیر فایل اصلی و زیر آن
(بهطور پیشفرض فعال است، غیرفعالسازی با --whole-tree)
--whole-tree استخراج کل درخت (در مقایسه با --subtree)
--ignore-latex-errors ادامه فرایند حتی در صورت بروز خطاهای latex، تا زمانی که
یک فایل PDF تولید شود
--ignore-makefile نادیدهگرفتن Makefile، ساخت به گونهای که گویی وجود ندارد
-* سایر گزینهها مستقیماً به latexdiff ارسال میشوند
--latexpand OPT ارسال گزینه OPT به latexpand. برای ارسال چند گزینه به دفعات
مانند --latexpand OPT1 --latexpand OPT2 استفاده کنید.
--latexdiff-flatten استفاده از --flatten از latexdiff بهجای latexpand
--early-exit-if-equal در صورتی که دو فایل یکسان باشند، latexdiff فراخوانی نخواهد شد و git-latexdiff با موفقیت خارج میشود.
این گزینه تنها در صورت استفاده از latexpand کار میکند
گزینههای ناشناخته بدون تغییر به latexdiff ارسال میشوند.
مثالها (EXAMPLES)
مقایسه بازبینی پیشین با آخرین کامیت:
git latexdiff HEAD^
مقایسه آخرین کامیت با درخت کاری:
git latexdiff HEAD --
مقایسه آخرین کامیت با شاخه master:
git latexdiff master HEAD
ارسال --type=CHANGEBAR به latexdiff برای ایجاد خطوط تغییر (changebars) در حاشیه بهجای تفاضل خطخورده قرمز/زیرخط آبی:
git latexdiff --type=CHANGEBAR HEAD^
استفاده از یک فایل پیکربندی مشخص latexdiff:
git latexdiff --config /path/to/file HEAD^
افزودن دستور \makeatletter برای رفع احتمالی برخی از خطاهای کامپایل LaTeX مربوط به دستورات حاوی نویسه @:
git latexdiff --latexpand --makeatletter HEAD^
| 07/23/2025 |