HXWLS(1)                        HTML-XML-utils                        HXWLS(1)




نام (NAME)
       hxwls - فهرست کردن پیوندها در یک فایل HTML

خلاصه دستور (SYNOPSIS)
       hxwls [ -l ] [ -t ] [ -r ] [ -h ] [ -a ] [ -b  base ] [ file ]

توضیحات (DESCRIPTION)
       دستور hxwls یک فایل HTML را (به‌طور پیش‌فرض از ورودی استاندارد) می‌خواند و
       تمام پیوندهایی را که پیدا می‌کند چاپ می‌نماید. خروجی در خروجی استاندارد
       (stdout) نوشته می‌شود.

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

       -l        تولید فهرست طولانی. به جای نمایش صرف URI، دستور hxwls سه ستون
                 چاپ می‌کند: نام عنصر، مقدار ویژگی REL و URI مقصد.

       -t        تولید فهرست چندتایی (تاپل).  hxwls چهار ستون چاپ می‌کند: URI
                 خود سند، نام عنصر، مقدار ویژگی REL و URI مقصد.

       -r        چاپ نشانی‌های URL نسبی همان‌گونه که هستند، بدون تبدیل آن‌ها به
                 URLهای مطلق.

       -b base   استفاده از base به عنوان URL پایه اولیه. چنانچه عنصری مانند
                 <base> درون سند وجود داشته باشد، بر گزینه -b اولویت خواهد
                 داشت.

       -h        تولید خروجی در قالب HTML. خروجی در قالب عناصر <a> فهرست خواهد
                 شد.

       -a        تبدیل هرگونه شناسه بین‌المللی منابع (IRI) به URIهای صرفاً اسکی
                 (ASCII-only). این کار باعث می‌شود تا هر نویسه غیر ASCII در
                 مسیر URI به صورت بایت‌های دارای گریز % (%-escaped) و نویسه‌های
                 غیر ASCII در نام دامنه به صورت punycode کدگذاری شوند.
                 (کدگذاری Punycode تنها زمانی در دسترس است که hxwls با
                 پشتیبانی از libidn کامپایل شده باشد.)

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

       file      نام یا URL فایل HTML. در صورت عدم ذکر، ورودی استاندارد به جای
                 آن خوانده می‌شود.

عیب‌یابی (DIAGNOSTICS)
       مقدارهای خروج زیر بازگردانده می‌شوند:

       0         اتمام موفقیت‌آمیز.

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

همچنین ببینید (SEE ALSO)
       asc2xml(1), hxnormalize(1), hxnum(1), xml2asc(1)

7.x                               10 Jul 2011                         HXWLS(1)