'\" t
.\"     Title: git-latexdiff
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 07/23/2025
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "GIT\-LATEXDIFF" "1" "07/23/2025" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
git-latexdiff \- اجرای latexdiff روی دو بازبینی Git از یک فایل
.SH "گزینه‌ها (OPTIONS)"
.sp
.if n \{\
.RS 4
.\}
.nf
کاربرد: 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\&.
                            در صورت مشخص نشدن، جستجو برای تنها فایلی که
                            شامل \*(Aqdocumentclass\*(Aq است انجام خواهد شد\&.
                            برای فایل‌های غیر 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 ارسال می‌شوند\&.
.fi
.if n \{\
.RE
.\}
.SH "مثال‌ها (EXAMPLES)"
.sp
مقایسه بازبینی پیشین با آخرین کامیت:
.sp
.if n \{\
.RS 4
.\}
.nf
git latexdiff HEAD^
.fi
.if n \{\
.RE
.\}
.sp
مقایسه آخرین کامیت با درخت کاری:
.sp
.if n \{\
.RS 4
.\}
.nf
git latexdiff HEAD \-\-
.fi
.if n \{\
.RE
.\}
.sp
مقایسه آخرین کامیت با شاخه master:
.sp
.if n \{\
.RS 4
.\}
.nf
git latexdiff master HEAD
.fi
.if n \{\
.RE
.\}
.sp
ارسال \-\-type=CHANGEBAR به latexdiff برای ایجاد خطوط تغییر (changebars) در حاشیه به‌جای تفاضل خط‌خورده قرمز/زیرخط آبی:
.sp
.if n \{\
.RS 4
.\}
.nf
git latexdiff \-\-type=CHANGEBAR HEAD^
.fi
.if n \{\
.RE
.\}
.sp
استفاده از یک فایل پیکربندی مشخص latexdiff:
.sp
.if n \{\
.RS 4
.\}
.nf
git latexdiff \-\-config /path/to/file HEAD^
.fi
.if n \{\
.RE
.\}
.sp
افزودن دستور \emakeatletter برای رفع احتمالی برخی از خطاهای کامپایل LaTeX مربوط به دستورات حاوی نویسه @:
.sp
.if n \{\
.RS 4
.\}
.nf
git latexdiff \-\-latexpand \-\-makeatletter HEAD^
.fi
.if n \{\
.RE
.\}