.de d \" begin display
.sp
.in +4
.nf
..
.de e \" end display
.in -4
.fi
.sp
..
.TH "HXUNPIPE" "1" "10 Jul 2011" "7.x" "HTML-XML-utils"
.SH "نام (NAME)"
hxunpipe \- تبدیل خروجی hxpipe به قالب XML
.SH "خلاصه دستور (SYNOPSIS)"
.B hxunpipe
.RB "[\| " \-b " \|]"
.RI "[\| " file-or-URL " \|]"
.SH "توضیحات (DESCRIPTION)"
.B hxunpipe
خروجی
.BR hxpipe (1)
(یا
.BR onsgmls (1))
را دریافت کرده و آن را دوباره به نشانه‌گذاری XML/SGML تبدیل می‌کند.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های زیر پشتیبانی می‌شوند:
.TP 10
.B \-b
به‌طور معمول،
.B hxunpipe
فرض می‌کند که ورودی توسط hxpipe ایجاد شده است؛ بدین معنی که ورودی ممکن است شامل موجودیت‌های نویسه‌ای (character entities) باشد، اما هرگز حاوی جداکننده‌های SGML/XML (<>&"') که نیاز به گریزدهی (escape) دارند نخواهد بود. با این حال، هنگامی که ورودی توسط (o)nsgmls تولید شده باشد، موجودیت‌ها باز (expanded) شده‌اند و ورودی ممکن است حاوی جداکننده‌های SGML/XML باشد. گزینهٔ
.B \-b
باعث می‌شود که
.B hxunpipe
به دنبال این جداکننده‌ها بگردد و آن‌ها را گریزدهی کند: "<" به‌صورت "&lt;"، ">" به‌صورت "&gt;"، "&" به‌صورت "&amp;"، """ به‌صورت "&quot;" و "'" به‌صورت "&apos;".
.SH "عملوندها (OPERANDS)"
عملوند زیر پشتیبانی می‌شود:
.TP 10
.I file-or-URL
نام یا نشانی اینترنتی (URL) یک فایل HTML. در صورت عدم تعیین، ورودی استاندارد خوانده می‌شود.
.SH "وضعیت خروج (EXIT STATUS)"
مقدارهای خروج زیر بازگردانده می‌شوند:
.TP 10
.B 0
پایان موفقیت‌آمیز.
.TP
.B > 0
خطایی در ورودی رخ داده است.
.SH "محیط (ENVIRONMENT)"
برای استفاده از پیشکار (proxy) جهت دریافت فایل‌های دوردست، متغیرهای محیطی
.B http_proxy
و
.B ftp_proxy
را مقداردهی کنید؛ مانند:
.B http_proxy="http://localhost:8080"
.SH "گزارش باگ‌ها (BUGS)"
.LP
تمام خطاهای نحوی ورودی شناسایی نمی‌شوند.
.LP
دستور
.B hxunpipe
در حال حاضر تنها می‌تواند فایل‌های دوردست را از طریق HTTP دریافت کند. این ابزار از فایل‌های محافظت‌شده با گذرواژه یا فایل‌هایی که محتوای آن‌ها به «کوکی‌های» HTTP وابسته است، پشتیبانی نمی‌کند.
.SH "همچنین ببینید (SEE ALSO)"
.BR hxpipe (1),
.BR onsgmls (1).