.TH "XML2ASC" "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)"
xml2asc \- تبدیل نویسه‌های UTF-8 به نهادهای عددی &#nnn;
.SH "خلاصه دستور (SYNOPSIS)"
.B xml2asc
.SH "توضیحات (DESCRIPTION)"
.LP
متنی با کدگذاری
.B UTF-8
را از ورودی استاندارد می‌خواند و آن را در خروجی استاندارد می‌نویسد، و تمام نویسه‌های غیر
.B ASCII
را به نهادهای
.B &#nnn;
تبدیل می‌کند تا نتیجه حاصل دارای کدگذاری
.B ASCII
شود.
.LP
یک نمونه از کاربردهای این دستور، تبدیل
.B ISO-8859-1
به
.B ASCII
همراه با نهادهای
.B &#nnn;
است؛ بدین ترتیب که ابتدا با اجرای دستور
.B asc2xml
کدگذاری
.B ISO-8859-1
به
.B UTF-8
تبدیل شده و سپس خروجی آن به دستور
.B xml2asc
پایپ (هدایت) می‌شود تا به کدگذاری
.B ASCII
همراه با نهادهای
.B &#nnn;
برای تمامی نویسه‌های اعراب‌دار تبدیل گردد.
.LP
برای بررسی اینکه آیا یک پرونده ساختار
.B UTF-8
صحیحی دارد یا خیر، خروجی را نادیده بگیرید و کد خروج را بررسی کنید، برای نمونه در Bash:
.d
xml2asc <myfile >/dev/null && echo "OK" || echo "Fail"
.e
.SH "عیب‌یابی (DIAGNOSTICS)"
اگر ورودی با کدگذاری
.B UTF-8
نباشد، دستور
.B xml2asc
یک کد خروج غیرصفر بازمی‌گرداند.
.SH "همچنین ببینید (SEE ALSO)"
.BR asc2xml (1),
.BR UTF-8 " (RFC 2279)"
.SH "اشکالات (BUGS)"
.LP
این دستور نشانه‌گذاری‌ها (Markup) را از محتوا تفکیک نمی‌کند؛ بنابراین اگر در ورودی، در نام عنصرهای
.B XML
از نویسه‌های غیر
.B ASCII
استفاده شده باشد، آن‌ها در خروجی همراه با نهادهای عددی درج می‌شوند که این مورد در استاندارد
.B XML
مجاز نیست.