XML2ASC(1)                      HTML-XML-utils                      XML2ASC(1)




نام (NAME)
       xml2asc - تبدیل نویسه‌های UTF-8 به نهادهای عددی &#nnn;

خلاصه دستور (SYNOPSIS)
       xml2asc

توضیحات (DESCRIPTION)
       متنی با کدگذاری UTF-8 را از ورودی استاندارد می‌خواند و آن را در خروجی
       استاندارد می‌نویسد، و تمام نویسه‌های غیر ASCII را به نهادهای &#nnn; تبدیل
       می‌کند تا نتیجه حاصل دارای کدگذاری ASCII شود.

       یک نمونه از کاربردهای این دستور، تبدیل ISO-8859-1 به ASCII همراه با
       نهادهای &#nnn; است؛ بدین ترتیب که ابتدا با اجرای دستور asc2xml کدگذاری
       ISO-8859-1 به UTF-8 تبدیل شده و سپس خروجی آن به دستور xml2asc پایپ
       (هدایت) می‌شود تا به کدگذاری ASCII همراه با نهادهای &#nnn; برای تمامی
       نویسه‌های اعراب‌دار تبدیل گردد.

       برای بررسی اینکه آیا یک پرونده ساختار UTF-8 صحیحی دارد یا خیر، خروجی را
       نادیده بگیرید و کد خروج را بررسی کنید، برای نمونه در Bash:

           xml2asc <myfile >/dev/null && echo "OK" || echo "Fail"


عیب‌یابی (DIAGNOSTICS)
       اگر ورودی با کدگذاری UTF-8 نباشد، دستور xml2asc یک کد خروج غیرصفر
       بازمی‌گرداند.

همچنین ببینید (SEE ALSO)
       asc2xml(1), UTF-8 (RFC 2279)

اشکالات (BUGS)
       این دستور نشانه‌گذاری‌ها (Markup) را از محتوا تفکیک نمی‌کند؛ بنابراین اگر
       در ورودی، در نام عنصرهای XML از نویسه‌های غیر ASCII استفاده شده باشد،
       آن‌ها در خروجی همراه با نهادهای عددی درج می‌شوند که این مورد در استاندارد
       XML مجاز نیست.

7.x                               10 Jul 2011                       XML2ASC(1)