.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "LATEXDIFF-VC 1" .TH LATEXDIFF-VC 1 2024-11-17 "perl v5.38.2" " " .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" latexdiff\-vc \- اسکریپت واسط برای فراخوانی latexdiff جهت مقایسهٔ نسخه‌های مختلف یک فایل تحت مدیریت نسخه (CVS، RCS یا SVN) .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBlatexdiff-vc\fR [ \fIlatexdiff-options\fR ] [ \fIlatexdiff-vc-options\fR ] \fB\-r\fR [\fIrev1\fR] [\fB\-r\fR \fIrev2\fR] \fIfile1.tex\fR [ \fIfile2.tex\fR ...] .PP .Vb 1 \& یا .Ve .PP \&\fBlatexdiff-vc\fR [ \fIlatexdiff-options\fR ] [ \fIlatexdiff-vc-options\fR ][ \fB\-\-postscript\fR | \fB\-\-pdf\fR ] \fIold.tex\fR \fInew.tex\fR .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" \&\fIlatexdiff-vc\fR یک اسکریپت واسط است که \fIlatexdiff\fR را روی یک فایل یا چندین فایل تحت کنترل نسخه (git، subversion (SVN)، mercurial (hg)، CVS، RCS) اعمال کرده و به‌طور اختیاری توالی دستورهای \f(CW\*(C`latex\*(C'\fR و \f(CW\*(C`dvips\*(C'\fR یا \f(CW\*(C`pdflatex\*(C'\fR لازم برای تولید خروجی pdf یا postscript از فایل(های) tex تفاوت را اجرا می‌کند. همچنین می‌توان آن را بر روی یک جفت فایل برای خودکارسازی تولید فایل تفاوت در قالب postscript یا pdf اعمال کرد. .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .IP "\fB\-\-rcs\fR، \fB\-\-svn\fR، \fB\-\-cvs\fR، \fB\-\-git\fR یا \fB\-\-hg\fR" 4 .IX Item "--rcs, --svn, --cvs, --git or --hg" سیستم کنترل نسخهٔ مورد استفاده را تعیین می‌کند. اگر هیچ سیستم کنترلی مشخص نشود، latexdiff-vc اقدام به حدس زدن آن خواهد کرد. .Sp دستورهای latexdiff-cvs، latexdiff-rcs و غیره نگارش‌هایی از latexdiff-vc هستند که پیش‌فرض آن‌ها سیستم کنترل نسخهٔ مربوطه است. با این حال، می‌توان این پیش‌فرض را با استفاده از گزینه‌های بالا لغو کرد. .Sp توجه داشته باشید که hg باید از گزینهٔ \f(CW\*(C`\-\-root\*(C'\fR پشتیبانی کند (نسخهٔ >= 2.9). .IP "\fB\-r\fR، \fB\-r\fR \fIrev\fR یا \fB\-\-revision\fR، \fB\-\-revision=\fR\fIrev\fR" 4 .IX Item "-r, -r rev or --revision, --revision=rev" انتخاب بازبینی (تحت RCS، CVS، SVN، GIT یا HG). یک یا دو گزینهٔ \fB\-r\fR را می‌توان مشخص کرد، که رفتارهای متفاوتی در پی دارند: .RS 4 .IP "\fBlatexdiff-vc\fR \-r \fIfile.tex\fR ..." 4 .IX Item "latexdiff-vc -r file.tex ..." فایل \fIfile.tex\fR را با جدیدترین نسخهٔ ثبت‌شده (checked-in) مقایسه می‌کند. .IP "\fBlatexdiff-vc\fR \-r \fIrev1\fR \fIfile.tex\fR ..." 4 .IX Item "latexdiff-vc -r rev1 file.tex ..." فایل \fIfile.tex\fR را با بازبینی \fIrev1\fR مقایسه می‌کند. .IP "\fBlatexdiff-vc\fR \-r \fIrev1\fR \-r \fIrev2\fR \fIfile.tex\fR ..." 4 .IX Item "latexdiff-vc -r rev1 -r rev2 file.tex ..." بازبینی‌های \fIrev1\fR و \fIrev2\fR از فایل \fIfile.tex\fR را مقایسه می‌کند. .Sp برای تمام گزینه‌های بالا می‌توان چندین فایل مشخص کرد. با این حال، تمام فایل‌ها باید دارای پسوند \f(CW\*(C`.tex\*(C'\fR، \f(CW\*(C`.bbl\*(C'\fR یا \f(CW\*(C`.flt\*(C'\fR باشند. .IP "\fBlatexdiff-vc\fR \fIold.tex\fR \fInew.tex\fR" 4 .IX Item "latexdiff-vc old.tex new.tex" دو فایل را با یکدیگر مقایسه می‌کند. .RE .RS 4 .Sp نام فایل تفاوت به‌صورت خودکار تولید شده و در stdout گزارش می‌شود. .RE .IP "\fB\-d\fR یا \fB\-\-dir\fR \fB\-d\fR \fIpath\fR یا \fB\-\-dir=\fR\fIpath\fR" 4 .IX Item "-d or --dir -d path or --dir=path" به‌جای الصاق رشتهٔ \f(CW\*(C`diff\*(C'\fR و در صورت تمایل شماره‌های نسخه به فایل خروجی، نام دایرکتوری \f(CW\*(C`diff\*(C'\fR را در ابتدای نام فایل اصلی قرار می‌دهد، و در صورتی که دایرکتوری و زیردایرکتوری‌ها از پیش وجود نداشته باشند آن‌ها را ایجاد می‌کند. این قابلیت به‌ویژه برای همسان‌سازی کامل سلسله‌مراتب یک دایرکتوری مفید است. به‌صورت اختیاری، می‌توان یک مسیر \fIpath\fR تعیین کرد تا به‌جای \f(CW\*(C`diff\*(C'\fR در ابتدا قرار گیرد. .IP \fB\-\-flatten,\-\-flatten=keep\-intermediate\fR 4 .IX Item "--flatten,--flatten=keep-intermediate" در صورت ترکیب با گزینهٔ \f(CW\*(C`\-\-git\*(C'\fR، \f(CW\*(C`\-\-svn\*(C'\fR یا \f(CW\*(C`\-\-hg\*(C'\fR یا حالت‌های مربوطه، بازبینی‌های مورد مقایسه را در یک دایرکتوری موقت مجزا واکشی (check out) کرده و سپس گزینهٔ \f(CW\*(C`\-\-flatten\*(C'\fR را به latexdiff منتقل می‌کند. دایرکتوری‌ای که \f(CW\*(C`latexdiff\-vc\*(C'\fR در آن فراخوانی می‌شود، زیردرختی را که واکشی خواهد شد مشخص می‌کند. توجه داشته باشید که اگر به فایل‌های اضافه‌ای نیاز است که در فرایند مسطح‌سازی (flatten) گنجانده نشده‌اند (فایل‌های بسته، تصاویر ضمیمه‌شده)، آن‌ها باید در دایرکتوری جاری در دسترس باشند. اگر از bibtex استفاده می‌کنید، توصیه می‌شود فایل \f(CW\*(C`.bbl\*(C'\fR را در مدیریت نسخه قرار دهید. از نسخهٔ latexdiff-vc >=1.3.4 تلاشی برای ایجاد فایل \f(CW\*(C`.bbl\*(C'\fR از طریق اجرای bibtex در زیردایرکتوری‌های بازیابی‌شده صورت می‌گیرد؛ توجه داشته باشید که bibtex در زیردایرکتوری‌های موقت اجرا می‌شود، بنابراین هرگونه فایل .bib یا .bst باید تحت مدیریت نسخه باشد، یا در مسیرهای جستجوی سراسری bibtex قرار داشته باشد (متغیرهای محیطی پوسته \f(CW\*(C`BIBINPUTS\*(C'\fR و \f(CW\*(C`BSTINPUTS\*(C'\fR). .Sp کاربرد عمومی این قابلیت به‌صورت روبه‌رو است: \f(CW\*(C`latexdiff\-vc \-\-flatten \-r rev1 [\-r rev2] master.tex\*(C'\fR که در آن master.tex فایل اصلی پروژه شامل بالاترین سطح ادغام‌ها (includes) و غیره است. .Sp با گزینهٔ \f(CW\*(C`\-\-flatten=keep\-intermediate\*(C'\fR، نماگرفت‌های میانی بازبینی در دایرکتوری جاری نگه داشته می‌شوند (حالت پیش‌فرض ذخیرهٔ آن‌ها در دایرکتوری موقت و حذف پس از تولید فایل diff است). .IP \fB\-\-only\-changes\fR 4 .IX Item "--only-changes" خروجی را طوری پس‌پردازش می‌کند که فقط صفحات دارای تغییر نمایش داده شوند. این گزینه نیازمند استفاده از زیرنوع ZLABEL در latexdiff است که به‌صورت خودکار تنظیم خواهد شد، اما هر گزینهٔ \-s تنظیم‌شده به‌صورت دستی را نادیده می‌گیرد (همچنین نیاز دارد که بستهٔ zref نصب باشد). این گزینه همچنین پیوندهای داخلی (آن‌طور که توسط بستهٔ hyperref پیاده‌سازی شده) و نشانه‌گذاری‌های گرافیکی را غیرفعال می‌کند. (توجه داشته باشید که این گزینه برای کارایی داشتن باید با \-\-ps یا \-\-pdf ترکیب شود) .IP \fB\-\-force\fR 4 .IX Item "--force" رونویسی فایل‌های diff موجود بدون درخواست تأیید. رفتار پیش‌فرض درخواست تأیید پیش از بازنویسی یک فایل تفاوت موجود است. .IP \fB\-\-run\fR 4 .IX Item "--run" اجرای دستور latex روی فایل diff پس از تولید آن. .IP \fB\-\-dvi\fR 4 .IX Item "--dvi" اجرای دستورهای latex و dvixxx پس از تولید فایل diff. .IP "\fB\-c configfile\fR =item \fB\-\-config var1=val1,var2=val2,...\fR یا \fB\-c var1=val1,..\fR" 4 .IX Item "-c configfile =item --config var1=val1,var2=val2,... or -c var1=val1,.." تنظیم متغیرهای پیکربندی برای latexdiff و latexdiff-vc. این گزینه را می‌توان برای تنظیم متغیرهای مختلف تکرار کرد (به‌عنوان جایگزینی برای فهرست جداشده با کاما). متغیرهای دردسترس برای latexdiff-vc: .RS 4 .ie n .IP """LATEXDIFF"" دستور latexdiff (مانند latexdiff-fast، latexdiff-so). این دستور باید از گزینه‌های ""\-draftmode"" و ""\-interaction=batchmode"" پشتیبانی کند" 8 .el .IP "\f(CWLATEXDIFF\fR دستور latexdiff (مانند latexdiff-fast، latexdiff-so). این دستور باید از گزینه‌های \f(CW\-draftmode\fR و \f(CW\-interaction=batchmode\fR پشتیبانی کند" 8 .IX Item "LATEXDIFF latexdiff command (e.g. latexdiff-fast, latexdiff-so). This command should support the options -draftmode and -interaction=batchmode" .PD 0 .ie n .IP """LATEX"" دستور latex (مانند pdflatex، lualatex)" 8 .el .IP "\f(CWLATEX\fR دستور latex (مانند pdflatex، lualatex)" 8 .IX Item "LATEX latex command (e.g. pdflatex, lualatex)" .ie n .IP """DVI2"" دستور برای تبدیل فایل dvi (مانند dvips، dvipdf)" 8 .el .IP "\f(CWDVI2\fR دستور برای تبدیل فایل dvi (مانند dvips، dvipdf)" 8 .IX Item "DVI2 Command for conversion of dvi file (e.g. dvips, dvipdf)" .ie n .IP """BIBTEX"" دستور جایگزین bibtex" 8 .el .IP "\f(CWBIBTEX\fR دستور جایگزین bibtex" 8 .IX Item "BIBTEX Command replacing bibtex" .RE .RS 4 .PD .Sp همهٔ متغیرهای پیکربندی دیگر به latexdiff ارسال می‌شوند. تغییرات پیکربندی که به‌طور صریح تنظیم شده‌اند، همواره تغییرات ضمنی حاصل از گزینه‌های میان‌بر \fB\-\-fast\fR، \fB\-\-so\fR، \fB\-\-ps\fR و \fB\-\-pdf\fR را لغو (override) می‌کنند. .RE .IP "\fB\-\-fast\fR یا \fB\-\-so\fR" 4 .IX Item "--fast or --so" به‌ترتیب استفاده از \f(CW\*(C`latexdiff\-fast\*(C'\fR یا \f(CW\*(C`latexdiff\-so\*(C'\fR (به‌جای \f(CW\*(C`latexdiff\*(C'\fR). .IP "\fB\-\-ps\fR یا \fB\-\-postscript\fR" 4 .IX Item "--ps or --postscript" تولید خروجی postscript از فایل تفاوت. این کار توالی \f(CW\*(C`latex; latex; dvips\*(C'\fR را روی فایل تفاوت اجرا می‌کند (در موارد نادری که برای ارجاع‌دهی صحیح به سه بار اجرای دستور \f(CW\*(C`latex\*(C'\fR نیاز است، در صورت اهمیت داشتن ارجاع‌دهی درست از این گزینه استفاده نکنید). اگر فایل تفاوت حاوی یک برچسب \f(CW\*(C`\ebibliography\*(C'\fR باشد، توالی \f(CW\*(C`latex; bibtex; latex; latex; dvips\*(C'\fR را اجرا خواهد کرد. .IP \fB\-\-pdf\fR 4 .IX Item "--pdf" تولید خروجی pdf از فایل تفاوت با استفاده از \f(CW\*(C`pdflatex\*(C'\fR. این گزینه توالی \f(CW\*(C`pdflatex; pdflatex\*(C'\fR را روی فایل تفاوت، یا \f(CW\*(C`pdflatex; bibtex; pdflatex; pdflatex\*(C'\fR را برای فایل‌های نیازمند bibtex اجرا می‌کند. توجه داشته باشید که این گزینه صرفاً یک میان‌بر برای تنظیم متغیر پیکربندی نیست، بلکه رفتارهای خاصی را نیز فعال می‌سازد. .IP \fB\-\-show\-config\fR 4 .IX Item "--show-config" نمایش مقادیر متغیرهای پیکربندی. .IP "\fB\-\-help\fR یا \fB\-h\fR" 4 .IX Item "--help or -h" نمایش متن راهنما. .IP \fB\-\-version\fR 4 .IX Item "--version" نمایش شمارهٔ نسخه. .PP تمام گزینه‌های دیگر به \f(CW\*(C`latexdiff\*(C'\fR منتقل می‌شوند. توجه داشته باشید که در صورت استفاده از گزینه‌های کوتاه‌شکل (تک‌حرفی)، تخصیص صحیح آرگومان‌ها به گزینه‌ها همیشه برای latexdiff ساده نیست؛ بنابراین توصیه می‌شود از گزینه‌های بلندشکل استفاده کنید. .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" latexdiff .SH "سازگاری (PORTABILITY)" .IX Header "PORTABILITY" \&\fIlatexdiff-vc\fR از دستورهای خارجی استفاده می‌کند و بنابراین به معماری سیستم وابسته است؛ این برنامه عمدتاً بر روی سیستم‌های شبه‌یونیکس آزمایش شده است. همچنین برای بهره‌مندی از تمامی قابلیت‌ها، نیاز است که یک سیستم کنترل نسخه و latex بر روی سیستم نصب باشند. ماژول‌هایی از Perl 5.8 یا بالاتر مورد نیاز هستند. .SH "گزارش باگ‌ها (BUGS)" .IX Header "BUG REPORTING" لطفاً گزارش‌های باگ را با استفاده از سامانهٔ ردیابی مشکلات در صفحهٔ مخزن گیت‌هاب ارسال کنید، یا آن‌ها را به نشانی \fItilmann \-\- AT \-\- gfz\-potsdam.de\fR بفرستید. شماره نسخهٔ \fIlatexdiff-vc\fR (گزینهٔ \f(CW\*(C`\-\-version\*(C'\fR) را نیز ضمیمه کنید. .SH "نویسندگان (AUTHORS)" .IX Header "AUTHOR" نسخهٔ 1.3.4 حق نشر (C) 2005\-2017 Frederik Tilmann .PP این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط پروانه عمومی همگانی گنو (GNU GPL) نسخهٔ 3 بازتوزیع کرده یا تغییر دهید. مشارکت‌کنندگان: S Utcke، H Bruyninckx؛ برخی ایده‌ها از اسکریپت بش git-latexdiff الهام گرفته شده‌اند. C. Junghans: پشتیبانی از Mercurial.