نام (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)