نام (NAME)

latexrevise - حذف گزینشی نشانه‌گذاری و متن از خروجی latexdiff

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

latexrevise [ OPTIONS ] [ diff.tex ] > revised.tex

توضیحات (DESCRIPTION)

دستور latexrevise یک فایل به نام "diff.tex" (خروجی latexdiff) را می‌خواند و دستورهای نشانه‌گذاری آن را حذف می‌کند. اگر نام فایلی مشخص نشود، ورودی از ورودی استاندارد (standard input) خوانده می‌شود. این دستور را می‌توان در حالت‌های ACCEPT، DECLINE یا SIMPLIFY اجرا کرد، یا برای حذف دستورهای لاتک تعریف‌شده توسط کاربر از ورودی استفاده نمود (گزینه‌های -c، -e، -m و -n را در زیر ببینید). در حالت ACCEPT، تمام قطعه‌متن‌های الحاق‌شده (یا خطوط preamble) نگه داشته می‌شوند و تمام قطعه‌متن‌های دور ریخته‌شده (یا خطوط preamble) حذف می‌گردند. در حالت DECLINE، تمام قطعه‌متن‌های دور ریخته‌شده نگه داشته شده و تمام قطعه‌متن‌های الحاق‌شده حذف می‌شوند. اگر مایلید برخی از تغییرات را حفظ کنید، فایل diff.tex را از قبل ویرایش کرده و نشانه‌هایی (tokens) را که در غیر این صورت حذف می‌شدند، به‌صورت دستی بردارید. توجه داشته باشید که latexrevise فقط به نشانه‌های "\DIFaddbegin"، "\DIFaddend"، "\DIFdelbegin" و "\DIFdelend" و انواع متناظر FL آن‌ها توجه می‌کند. تمام دستورهای "\DIFadd" و "\DIFdel" (نه محتوای آن‌ها) به‌سادگی حذف می‌شوند. همچنین دستورهایی که توسط latexdiff به بخش preamble افزوده شده‌اند نیز حذف می‌گردند. در حالت SIMPLIFY، نشانه‌های "\DIFaddbegin, \DIFaddend, \DIFdelbegin, \DIFdelend" و انواع متناظر "FL" آن‌ها حفظ می‌شوند اما سایر نشانه‌گذاری‌ها (مانند "DIFadd" و <\DIFdel>) حذف می‌شوند. خروجی حاصل به‌طور کلی یک کد معتبر لاتک نخواهد بود، اما خواندن و ویرایش آن جهت آماده‌سازی برای اجرای بعدی در حالت ACCEPT یا DECLINE آسان‌تر خواهد بود. در حالت SIMPLIFY بخش preamble دست‌نخورده باقی می‌ماند.

گزینه‌ها (OPTIONS)

-a یا --accept

اجرا در حالت ACCEPT (حذف تمام بلوک‌های نشانه‌گذاری‌شده با "\DIFdelbegin" و "\DIFdelend").

-d یا --decline

اجرا در حالت DECLINE (حذف تمام بلوک‌های نشانه‌گذاری‌شده با "\DIFaddbegin" و "\DIFaddend").

-s یا --simplify

اجرا در حالت SIMPLIFY (نگه‌داشتن تمام نشانه‌های "\DIFaddbegin"، "\DIFaddend"، "\DIFdelbegin" و "\DIFdelend"، اما حذف سایر نشانه‌گذاری‌های latexdiff از بدنه).

توجه داشته باشید که این سه گزینه حالت مانعة‌الجمع هستند. اگر هیچ گزینه حالتی تعیین نشود، latexrevise صرفاً یادداشت‌ها و نشانه‌گذاری‌های کاربر را بر اساس چهار گزینه زیر حذف می‌کند. این قابلیت‌ها در خارج از چارچوب latexdiff نیز می‌توانند بسیار مفید باشند.

-c cmd یا --comment=cmd

حذف توالی‌های "\cmd{...}". شناسه "cmd" قرار است یادداشت‌های صریحی را مشخص کند که باید پیش از انتشار نهایی، از فایل حذف شوند.

-e envir یا --comment-environment=envir

حذف محیط‌های یادداشت صریح از متن، یعنی حذف بلوک‌های:

\begin{envir}
...
\end{envir}

از متن فایل.

-m cmd یا --markup=cmd

حذف دستور نشانه‌گذاری "\cmd" در عین باقی گذاشتن آرگومان آن؛ یعنی تبدیل "\cmd{abc}" به "abc".

-n envir یا --markup-environment=envir

به طور مشابه، حذف دستورهای "\begin{envir}" و "\end{envir}" در عین باقی گذاشتن محتوای آن محیط در متن.

-r cmd یا --replace=cmd

برای ساختارهای "\\cmd{..}{..}"، دستور را حذف می‌کند، محتوای اولین آرگومان را نگه می‌دارد و آرگومان دوم را پاک می‌کند؛ یعنی تبدیل "\cmd{abc}{def}" به "abc".

-V یا --verbose

خروجی پرگو با جزئیات کامل

-q یا --no-warnings

هشدار ندادن به کاربران درباره عبارات "\DIDadd{..}" یا "\DIFdel{..}" که باید تا الان حذف شده باشند.

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

نسخه فعلی یک نسخه بتا است که هنوز به‌طور گسترده آزمایش نشده است. این برنامه به‌صورت فعال نگهداری نشده است، بنابراین ممکن است خروجی نسخه‌های جدیدتر latexdiff را کاملاً درست پردازش نکند. لطفاً گزارش‌های باگ را با استفاده از سامانه پیگیری اشکالات (issue tracker) در صفحه مخزن گیت‌هاب https://github.com/ftilmann/latexdiff.git ارسال کنید یا آن‌ها را به tilmann -- AT -- gfz-potsdam.de بفرستید. شماره سریال latexrevise (گزینه --version) را نیز لحاظ نمایید. اگر با خروجی‌ای از latexdiff مواجه شدید که به‌درستی توسط latexrevise پردازش نمی‌شود، لطفاً فایل مشکل‌دار و همچنین فایل‌های قدیمی و جدیدی را که این فایل بر اساس آن‌ها ساخته شده است ضمیمه کنید؛ ترجیحاً طوری ویرایش شوند که تا جای ممکن فقط شامل بخش دارای اشکال باشند به شرطی که همچنان مشکل را بازتولید کنند.

توجه داشته باشید که عبارات کامنت‌شدهٔ "\begin{document}" یا "\end{document}" ممکن است باعث سردرگمی latexrevise شوند.

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

latexdiff

سازگاری (PORTABILITY)

دستور latexrevise از هیچ دستور خارجی استفاده نمی‌کند و بنابراین باید روی هر پلتفرمی که از PERL نسخه ۵ یا بالاتر پشتیبانی می‌کند اجرا شود.

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

کپی‌رایت (C) 2004 Frederik Tilmann

این برنامه نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License) نسخه ۳ بازتوزیع کرده یا تغییر دهید.