.TH "HXNAME2ID" "1" "10 Jul 2011" "7.x" "HTML-XML-utils"
.SH "نام (NAME)"
hxname2id \- انتقال برخی ویژگی‌های NAME و ID از تگ A به عنصر والد آن
.SH "خلاصه دستور (SYNOPSIS)"
.B hxname2id
.RB "[\| " \-x " \|]"
.RI "[\| " file " \|]"
.SH "توضیحات (DESCRIPTION)"
.LP
دستور
.B hxname2id
یک فایل HTML را خوانده و به دنبال عناصری می‌گردد که دارای یک عنصر A به عنوان اولین فرزند باشند، بدون اینکه متنی به‌جز فاصله‌های خالی بین آن‌ها قرار داشته باشد. اگر آن عنصر A دارای ویژگی ID یا NAME باشد، آن ویژگی به عنصر والد منتقل شده و از عنصر A حذف می‌شود.
.LP
از آنجا که Netscape 4 ویژگی‌های ID را تشخیص نمی‌داد، مرسوم بود که به جای <H2 ID="sect7"> از <H2><A NAME="sect7">...</A></H2> استفاده شود. از این برنامه می‌توان برای تبدیل چنین فایل‌های HTML قدیمی به شیوهٔ نگارش جدید استفاده کرد.
.LP
برنامه‌های دیگر در این مجموعه، مانند
.BR hxmultitoc (1)،
به جای عناصر A با ویژگی‌های NAME، به شناسه‌های ID روی عنوان‌ها نیاز دارند. از این رو اجرای
.B hxname2id
پیش از اجرای
.B hxmultitoc
و برنامه‌های مشابه سودمند است.
.B hxname2id
می‌تواند در یک لوله (pipe) به کار گرفته شود.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های زیر پشتیبانی می‌شوند:
.TP 10
.B \-x
استفاده از قراردادهای XML: عناصر خالی با یک اسلش در انتها نوشته می‌شوند: <IMG\ />
.SH "عملوندها (OPERANDS)"
عملوند زیر پشتیبانی می‌شود:
.TP 10
.I file
نام یک فایل HTML. در صورت عدم تعیین، ورودی استاندارد خوانده می‌شود.
.SH "خطاها (DIAGNOSTICS)"
کدهای خروج زیر بازگردانده می‌شوند:
.TP 10
.B 0
پایان موفقیت‌آمیز.
.TP
.B > 0
خطایی در تجزیهٔ فایل HTML رخ داده است.
.B hxname2id
تلاش خواهد کرد خطا را تصحیح کرده و در هر صورت خروجی را تولید کند.
.SH "همچنین ببینید (SEE ALSO)"
.BR asc2xml (1),
.BR hxmultitoc (1),
.BR hxnormalize (1),
.BR hxnum (1),
.BR hxtoc (1),
.BR xml2asc (1)
.SH "گزارش باگ‌ها (BUGS)"
.LP
سازوکار بازیابی خطا برای کدهای HTML نادرست بسیار ابتدایی است.