LATEXREVISE(1)                                                  LATEXREVISE(1)


نام (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) نسخه ۳ بازتوزیع کرده یا تغییر
       دهید.

perl v5.38.2                      2024-11-17                    LATEXREVISE(1)