.de d \" begin display
.sp
.in +4
.nf
..
.de e \" end display
.in -4
.fi
.sp
..
.TH "HXEXTRACT" "1" "10 Jul 2011" "7.x" "HTML-XML-utils"
.SH "نام (NAME)"
hxextract \- استخراج عناصر انتخاب‌شده از یک پروندهٔ HTML یا XML
.SH "خلاصه دستور (SYNOPSIS)"
.B hxextract
.RB "[\| " \-h
.RB "| " \-? " \|]"
.RB "[\| " \-x " \|]"
.RB "[\| " \-s
.IR text " \|]"
.RB "[\| " \-e
.IR text " \|]"
.RB "[\| " \-b
.IR base " \|]"
.I element-or-class
.RB "[\| " \-c
.IR "configfile" " | "
.IR file\-or\-URL " \|]"
.SH "توضیحات (DESCRIPTION)"
دستور
.B hxextract
تمامی عناصری را که دارای نام یا کلاس مشخصی هستند در خروجی می‌نویسد.
.PP
ورودی باید خوش‌ساخت (well-formed) باشد، زیرا هیچ روش ابتکاری (هیوریستیک) برای اصلاح HTML اعمال نمی‌شود.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های زیر پشتیبانی می‌شوند:
.TP 10
.B \-x
استفاده از قواعد قالب XML.
.TP 10
.BI \-s " text"
درج
.I text
در ابتدای خروجی.
.TP 10
.BI \-e " text"
درج
.I text
در انتهای خروجی.
.TP 10
.BI \-b " base"
نشانی پایهٔ URL.
.TP 10
.BI \-c " configfile"
خواندن خطوط @chapter از
.I configfile
(خطوط باید به صورت "@chapter filename" باشند) و استخراج عناصر از هر یک از آن پرونده‌ها.
.TP 10
.BR \-h ", " \-?
نمایش راهنمای نحوهٔ استفاده از دستور.
.SH "عملوندها (OPERANDS)"
عملوندهای زیر پشتیبانی می‌شوند:
.TP 10
.I element-or-class
نام عنصری که باید استخراج شود (مانند "H2")، یا نام کلاسی که با "." شروع می‌شود (مانند ".example") یا ترکیبی از هر دو (مانند "H2.example").
.TP
.I file-or-URL
نام پرونده یا یک URL. برای خواندن از ورودی استاندارد، از "-" استفاده کنید.
.SH "محیط (ENVIRONMENT)"
برای استفاده از پیشکار (پروکسی) جهت دریافت پرونده‌های دوردست، متغیرهای محیطی
.B http_proxy
و
.BR ftp_proxy
را تنظیم کنید.
برای نمونه:
.B http_proxy="http://localhost:8080"
.SH "اشکالات (BUGS)"
.LP
پرونده‌های دوردست (مشخص‌شده با URL) در حال حاضر تنها از طریق HTTP پشتیبانی می‌شوند. پرونده‌های محافظت‌شده با گذرواژه یا وابسته به کوکی‌های HTTP پشتیبانی نمی‌شوند. (می‌توانید از ابزارهایی مانند
.BR curl (1)
یا
.BR wget (1)
برای دریافت چنین پرونده‌هایی استفاده کنید.)
.SH "همچنین ببینید (SEE ALSO)"
.BR hxselect (1)