.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "SGMLDIFF" "1" "05 December 2025" "" ""

.SH "نام (NAME)"
sgmldiff \- یافتن تفاوت‌ها در نشانه‌گذاری دو فایل SGML
.SH "خلاصه دستور (SYNOPSIS)"

\fBsgmldiff\fR [ \fBoptions \fR\fI ...\fR ] \fB\fIfile1\fB\fR \fB\fIfile2\fB\fR [ \fB-a\fR | \fB--attributes\fR
    | \fB-c  [ attributes | nesting | textpos ]\fR | \fB--context  [ attributes | nesting | textpos ]\fR
    | \fB-s\fR | \fB--statistics\fR
    | \fB-h\fR | \fB--help\fR
    | \fB-v\fR | \fB--version\fR ]

.SH "توضیحات (DESCRIPTION)"
.PP
این اسکریپت perl امکان تعیین تفاوت‌های ساختاری میان دو فایل SGML را فراهم می‌کند. این ابزار بدون در نظر گرفتن محتوای میان برچسب‌ها، فایل‌ها را مقایسه می‌کند تا تنها بر روی نشانه‌گذاری تمرکز کند. خروجی آن شبیه به \fBdiff\fR(1)\& است.
.PP
کاربرد معمول \fBsgmldiff\fR، مقایسهٔ یک فایل SGML با ترجمهٔ آن به زبانی دیگر است. اگر ترجمه به‌درستی انجام شده باشد، \fBsgmldiff\fR بدون یافتن هیچ تفاوتی در نشانه‌گذاری به پایان می‌رسد.
.PP
نمونه‌ای از فراخوانی معمول sgmldiff:

.nf
      sgmldiff english.sgml italiano.sgml
    
.fi
.PP
اگر تفاوت‌هایی در نشانه‌گذاری میان دو فایل وجود داشته باشد، \fBsgmldiff\fR مجموعه‌ای از گزارش‌های تفاوت را ارائه می‌دهد که در خطوطی به این صورت خلاصه شده‌اند:
.TP
\fB169a164\fR
در خط 169 از فایل نخست، خط 164 از فایل دوم افزوده شده است.
.TP
\fB8a12,15\fR
در خط 8 از فایل نخست، خط‌های 12 تا 15 از فایل دوم افزوده شده‌اند.
.TP
\fB41d28\fR
خط 41 از فایل نخست حذف شده است تا خط 28 از فایل دوم به دست آید.
.TP
\fB63,66d61\fR
خط‌های 63 تا 66 از فایل نخست حذف شده‌اند تا خط 61 از فایل دوم به دست آید.
.TP
\fB52c51\fR
خط 52 از فایل نخست به خط 51 از فایل دوم تغییر یافته است.
.TP
\fB5,7c8,10\fR
خط‌های 5 تا 7 از فایل نخست به خط‌های 8 تا 10 از فایل دوم تغییر یافته‌اند.
علاوه بر این خلاصه‌ها، خط‌های فایل نخست با پیشوند '<' و خط‌های فایل دوم با پیشوند '>' نمایش داده می‌شوند.
.SH "گزینه‌ها (OPTIONS)"
.PP
در اینجا فهرستی از عملیاتی که می‌توان از sgmldiff درخواست کرد آمده است:
.TP
\fB             [ -a | --attributes ]  \fR
گنجاندن مقادیر صفت‌ها در آزمون‌های تفاوت. اگر احتمال دارد صفت‌ها ترجمه شوند، این گزینه را تنظیم نکنید. اگر مقدار صفت‌ها نباید میان دو فایل تغییر کند، این گزینه را مشخص کنید. حالت پیش‌فرض، عدم گنجاندن صفت‌ها در آزمون‌های تفاوت است.
.TP
\fB             [ -c  [ attributes | nesting | textpos ] | --context  [ attributes | nesting | textpos ] ]  \fR
افزودن زمینهٔ بیشتر به تفاوت‌ها. از آنجا که تمام متن میان برچسب‌ها پیش از بررسی تفاوت‌ها حذف می‌شود، احتمال دارد \fBsgmldiff\fR با این تصور نادرست که موقعیت‌ها در هر دو فایل متناظر یکدیگرند، خود را در مکانی اشتباه همگام‌سازی مجدد کند. با افزودن زمینهٔ بیشتر به ناحیهٔ مقایسه‌شده، این خطر کاهش می‌یابد.

مقادیر مجاز برای گزینهٔ \fB--context\fR عبارتند از:
.RS
.TP
\fBattributes\fR
در نظر گرفتن \fBنام‌های\fR صفت‌ها. \fBمقادیر\fR صفت‌ها با گزینهٔ \fBattributes\fR کنترل می‌شوند.
.TP
\fBnesting\fR
در نظر گرفتن سطح تودرتویی همهٔ برچسب‌های مقایسه‌شده.
.TP
\fBtextpos\fR
در نظر گرفتن موقعیت در متن.
.RE
.TP
\fB             [ -s | --statistics ]  \fR
چاپ برخی اطلاعات SGML در پایان.
.TP
\fB             [ -h | --help ]  \fR
چاپ یک پیام راهنمای کوتاه و خروج
.TP
\fB             [ -v | --version ]  \fR
چاپ شناسهٔ نسخه و خروج
.SH "فایل‌ها (FILES)"
.PP
.SH "نویسندگان (AUTHORS)"
.TP
\fB          Frederik Fouvry \fR
توسعه‌دهندهٔ \fBsgmldiff\fR\&.
.SH "همچنین ببینید (SEE ALSO)"
.TP
\fB          jw(1) \fR
تبدیل یک فایل SGML به سایر قالب‌های فایل
.TP
\fB   nsgmls(1) \fR
یک بخش پایه‌ای از موتور DSSSL با نام \fBJade\fR
.TP
\fB   http://sources.redhat.com/docbook-tools <URL:http://sources.redhat.com/docbook-tools> \fR
صفحهٔ خانگی ابزارهای DocBook، مجموعه‌ای از همهٔ ابزارهای لازم برای پردازش فایل‌های DocBook، از جمله DocBook-utils