GIT-LATEXDIFF(1)   GIT-LATEXDIFF(1)

git-latexdiff - اجرای latexdiff روی دو بازبینی Git از یک فایل

کاربرد: 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 ارسال می‌شوند.

مقایسه بازبینی پیشین با آخرین کامیت:

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