.TH "HXWLS" "1" "10 Jul 2011" "7.x" "HTML-XML-utils"
.de d \" begin display
.sp
.in +4
.nf
.ft CR
.CDS
..
.de e \" end display
.CDE
.in -4
.fi
.ft R
.sp
..
.SH "نام (NAME)"
hxwls \- فهرست کردن پیوندها در یک فایل HTML
.SH "خلاصه دستور (SYNOPSIS)"
.B hxwls
.RB "[\| " \-l " \|]"
.RB "[\| " \-t " \|]"
.RB "[\| " \-r " \|]"
.RB "[\| " \-h " \|]"
.RB "[\| " \-a " \|]"
.RB "[\| " \-b
.IR " base" " \|]"
.RI "[\| " file " \|]"
.SH "توضیحات (DESCRIPTION)"
.LP
دستور
.B hxwls
یک فایل HTML را (به‌طور پیش‌فرض از ورودی استاندارد) می‌خواند و تمام پیوندهایی را که پیدا می‌کند چاپ می‌نماید. خروجی در خروجی استاندارد (stdout) نوشته می‌شود.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های زیر پشتیبانی می‌شوند:
.TP 10
.B \-l
تولید فهرست طولانی. به جای نمایش صرف URI، دستور
.B hxwls
سه ستون چاپ می‌کند: نام عنصر، مقدار ویژگی REL و URI مقصد.
.TP
.B \-t
تولید فهرست چندتایی (تاپل).
.B hxwls
چهار ستون چاپ می‌کند: URI خود سند، نام عنصر، مقدار ویژگی REL و URI مقصد.
.TP
.BI \-r
چاپ نشانی‌های URL نسبی همان‌گونه که هستند، بدون تبدیل آن‌ها به URLهای مطلق.
.TP
.BI \-b " base"
استفاده از
.I base
به عنوان URL پایه اولیه. چنانچه عنصری مانند درون سند وجود داشته باشد، بر گزینه
.B \-b
اولویت خواهد داشت.
.TP
.B \-h
تولید خروجی در قالب HTML. خروجی در قالب عناصر فهرست خواهد شد.
.TP
.B \-a
تبدیل هرگونه شناسه بین‌المللی منابع (IRI) به URIهای صرفاً اسکی (ASCII-only). این کار باعث می‌شود تا هر نویسه غیر ASCII در مسیر URI به صورت بایت‌های دارای گریز % (%-escaped) و نویسه‌های غیر ASCII در نام دامنه به صورت punycode کدگذاری شوند. (کدگذاری Punycode تنها زمانی در دسترس است که
.B hxwls
با پشتیبانی از libidn کامپایل شده باشد.)
.SH "عملوندها (OPERANDS)"
عملوند زیر پشتیبانی می‌شود:
.TP 10
.I file
نام یا URL فایل HTML. در صورت عدم ذکر، ورودی استاندارد به جای آن خوانده می‌شود.
.SH "عیب‌یابی (DIAGNOSTICS)"
مقدارهای خروج زیر بازگردانده می‌شوند:
.TP 10
.B 0
اتمام موفقیت‌آمیز.
.TP
.B > 0
خطایی در تجزیه فایل HTML رخ داده است.
.B hxwls
تلاش خواهد کرد خطا را تصحیح کرده و در هر حال خروجی را تولید کند.
.SH "همچنین ببینید (SEE ALSO)"
.BR asc2xml (1),
.BR hxnormalize (1),
.BR hxnum (1),
.BR xml2asc (1)