.de d \" begin display
.sp
.in +4
.nf
..
.de e \" end display
.in -4
.fi
.sp
..
.TH "HXREMOVE" "1" "10 Jul 2011" "7.x" "HTML-XML-utils"
.SH "نام (NAME)"
hxremove \- حذف عناصر از یک فایل XML با استفاده از انتخابگر CSS
.SH "خلاصه دستور (SYNOPSIS)"
.B hxremove
.RB "[\| " \-i " \|]"
.RB "[\| " \-l
.IR language " \|]"
.I selectors
.SH "توضیحات (DESCRIPTION)"
دستور
.B hxremove
یک سند XML خوش‌ساخت (well-formed) را از ورودی استاندارد می‌خواند و آن را بدون عناصری که با یکی از انتخابگرهای CSS داده‌شده به عنوان آرگومان مطابقت دارند، در خروجی استاندارد می‌نویسد. برای مثال:
.d
hxremove ol li:first-child
.e
نخستین li (آیتم فهرست در XHTML) را از هر ol (فهرست مرتب) حذف می‌کند.
.PP
در صورت وجود چندین انتخابگر، آن‌ها باید با کاما از یکدیگر جدا شوند. برای نمونه:
.d
hxremove p + ul, blockquote ol
.e
تمام عناصر ul را که پس از یک عنصر p آمده‌اند و همچنین تمام عناصر ol را که از نوادگان عنصر blockquote هستند حذف می‌کند.
.PP
دستور
.B hxremove
فرض می‌کند که انتخابگرهای کلاس (".foo") به ویژگی موسوم به "class" اشاره دارند و انتخابگرهای شناسه ("#foo") به ویژگی موسوم به "id" اشاره می‌کنند.
.PP
برای پردازش فایل‌های HTML، ابتدا آن‌ها را به XML خوش‌ساخت تبدیل کنید، برای نمونه با
.BR "hxnormalize -x" .
.PP
این ابزار را با
.BR hxselect
مقایسه کنید که همه چیز را
.I به جز
عناصر انتخاب‌شده حذف می‌کند.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های زیر پشتیبانی می‌شوند:
.TP 10
.B \-i
تطبیق بدون حساسیت به بزرگی و کوچکی حروف. برای HTML و برخی زبان‌های دیگر مبتنی بر SGML کاربرد دارد.
.TP
.BI \-l " language"
تعیین زبان پیش‌فرض، در صورتی که عنصر ریشه فاقد ویژگی xml:lang باشد (پیش‌فرض: هیچ‌کدام). مثال:
.B \-l en
.SH "عملوندها (OPERANDS)"
عملوند زیر پشتیبانی می‌شود:
.TP
.I selectors
یک یا چند انتخابگر جداشده با کاما. بیشتر انتخابگرهای CSS سطح ۳ (CSS level 3) پشتیبانی می‌شوند.
.SH "همچنین ببینید (SEE ALSO)"
.BR asc2xml (1),
.BR xml2asc (1),
.BR hxnormalize (1),
.BR hxselect (1),
.BR UTF-8 " (RFC 2279)"