نام (NAME)

hxname2id - انتقال برخی ویژگی‌های NAME و ID از تگ A به عنصر والد آن

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

hxname2id [ -x ] [ file ]

توضیحات (DESCRIPTION)

دستور hxname2id یک فایل HTML را خوانده و به دنبال عناصری می‌گردد که دارای یک عنصر A به عنوان اولین فرزند باشند، بدون اینکه متنی به‌جز فاصله‌های خالی بین آن‌ها قرار داشته باشد. اگر آن عنصر A دارای ویژگی ID یا NAME باشد، آن ویژگی به عنصر والد منتقل شده و از عنصر A حذف می‌شود.

از آنجا که Netscape 4 ویژگی‌های ID را تشخیص نمی‌داد، مرسوم بود که به جای <H2 ID="sect7"> از <H2><A NAME="sect7">...</A></H2> استفاده شود. از این برنامه می‌توان برای تبدیل چنین فایل‌های HTML قدیمی به شیوهٔ نگارش جدید استفاده کرد.

برنامه‌های دیگر در این مجموعه، مانند hxmultitoc(1)، به جای عناصر A با ویژگی‌های NAME، به شناسه‌های ID روی عنوان‌ها نیاز دارند. از این رو اجرای hxname2id پیش از اجرای hxmultitoc و برنامه‌های مشابه سودمند است. hxname2id می‌تواند در یک لوله (pipe) به کار گرفته شود.

گزینه‌ها (OPTIONS)

گزینه‌های زیر پشتیبانی می‌شوند:

-x

استفاده از قراردادهای XML: عناصر خالی با یک اسلش در انتها نوشته می‌شوند: <IMG />

عملوندها (OPERANDS)

عملوند زیر پشتیبانی می‌شود:

file

نام یک فایل HTML. در صورت عدم تعیین، ورودی استاندارد خوانده می‌شود.

خطاها (DIAGNOSTICS)

کدهای خروج زیر بازگردانده می‌شوند:

0

پایان موفقیت‌آمیز.

> 0

خطایی در تجزیهٔ فایل HTML رخ داده است. hxname2id تلاش خواهد کرد خطا را تصحیح کرده و در هر صورت خروجی را تولید کند.

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

asc2xml(1), hxmultitoc(1), hxnormalize(1), hxnum(1), hxtoc(1), xml2asc(1)

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

سازوکار بازیابی خطا برای کدهای HTML نادرست بسیار ابتدایی است.