.Dd August 4, 2020
.Dt AHA 1
.Os
.Sh "نام (NAME)"
.Nm aha
.Nd تبدیل دنباله‌های فرار ANSI به HTML
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm
.Op Fl bhlnprsvwx
.Op Fl c Ar file
.Op Fl f Ar file
.Op Fl i Ar X
.Op Fl L Ar LANG
.Op Fl t Ar TITLE
.Op Fl y Ar STYLE
.Sh "توضیحات (DESCRIPTION)"
.Nm
متن‌های رنگی بر پایه SGR در استاندارد ECMA-48 را از ورودی استاندارد می‌خواند، آن‌ها را به HTML رنگی تبدیل کرده و در خروجی استاندارد می‌نویسد.
گزینه‌ها به شرح زیر هستند:
.Bl -tag -width Ds
.It Fl b , Fl Fl black
استایل‌دهی به خروجی HTML برای استفاده از پس‌زمینه مشکی با متن سفید.
.It Fl c Ar file , Fl Fl css Ar file
فایل CSS مشخص‌شده با
.Ar file
را به خروجی می‌افزاید. در واقع صرفاً عبارت را به سرایند (header) اضافه می‌کند.
.It Fl f Ar file
خواندن از
.Ar file
به‌جای ورودی استاندارد.
.It Fl h , Fl Fl help , Fl \&?
چاپ راهنمای
.Nm
در خروجی استاندارد.
.It Fl i Ar X , Fl Fl iso Ar X
استفاده از کدگذاری نویسه
.Va ISO-8859- Ns Ar X
به‌جای UTF-8 برای خروجی، که در آن
.Ar X
عددی از 1 تا 16 است.
.It Fl l , Fl Fl line-fix
استفاده از یک اصلاح برای ورودی‌هایی که از دنباله‌های کنترلی برای تغییر موقعیت مکان‌نما استفاده می‌کنند.
این یک وصله اضطراری (hot fix) است، بنابراین ممکن است با همه برنامه‌ها کار نکند.
.It Fl L Ar LANG , Fl Fl lang Ar LANG
استفاده از کد
.Va ISO-639-1
.Ar LANG
برای زبان.
.It Fl n , Fl Fl no-header
قرار ندادن خروجی HTML درون تگ‌های
.Va ,
و
.Va .
.It Fl p , Fl Fl pink
استایل‌دهی به خروجی HTML برای استفاده از پس‌زمینه صورتی.
.It Fl r , Fl Fl ignore-cr
نادیده گرفتن تمام نویسه‌های بازگشت به ابتدای سطر (کد اسکی ۱۳، \\r) که ممکن است منجر به خطوط خالی دوتایی در HTML شود.
.It Fl s , Fl Fl stylesheet
استفاده از یک شیوه‌نامه (stylesheet) به‌جای استایل‌های درون‌خطی (inline).
.It Fl t Ar TITLE , Fl Fl title Ar TITLE
تنظیم عنوان سند HTML به
.Ar TITLE
به‌جای
.Qq stdin
یا نام فایل.
.It Fl v , Fl Fl version
چاپ شماره نسخه
.Nm
در خروجی استاندارد و خروج.
.It Fl w , Fl Fl word-wrap
شکستن خطوط طولانی در خروجی HTML.
با مرورگرهای پشتیبانی‌کننده از CSS3 و بسیاری از مرورگرهای قدیمی‌تر کار می‌کند.
.It Fl x , Fl Fl no-xml
استفاده نکردن از doctype نوع XML و استفاده از HTML (ممکن است برای مرورگرهای قدیمی مانند IE مفید باشد).
.It Fl y Ar STYLE , Fl Fl style Ar STYLE
تنظیم استایل مورد استفاده در عنصر
.Va
به
.Ar STYLE
پس از اعمال استایل‌های تنظیم‌شده توسط سایر پارامترها.
.El
.Sh "مثال‌ها (EXAMPLES)"
ایجاد یک فایل HTML با پس‌زمینه مشکی، عنوان سفارشی و اندازه قلم بزرگ‌تر با استفاده از راهنمای
.Nm :
.Pp
.Dl $ aha -h | aha -b -t 'the awesome aha help' -y 'font-size:1.875em' > aha-help.html
.Pp
ایجاد یک فایل HTML با پس‌زمینه سفید با استفاده از خروجی
.Xr diff 1 :
.Pp
.Dl $ diff -u --color=always oldfile.c newfile.c | aha > diff.html
.Pp
ایجاد یک فایل HTML با پس‌زمینه مشکی از خروجی
.Xr htop 1 .
به دلیل دستورات خط جدید دیگری که htop استفاده می‌کند، باید از گزینه
.Fl l
استفاده کنید:
.Pp
.Dl $ echo q | htop | aha -b -l > htop.html
.Pp
ایجاد یک فایل HTML از خروجی همین صفحه راهنما. دستور
.Xr man 1
از قالب‌بندی پررنگ (bold) و زیرخط (underline) ناشی از
.Xr nroff 1
استفاده می‌کند که
.Xr ul 1
آن‌ها را به SGR تبدیل می‌نماید:
.Pp
.Dl $ MAN_KEEP_FORMATTING=1 COLUMNS=80 man aha | ul | aha > man-aha.html
.Sh "همچنین ببینید (SEE ALSO)"
.Xr console_codes 4
.Rs
.%I Ecma
.%D 1991
.%R ECMA-48
.%T Control Functions for Coded Character Sets
.%P 61
.Re
.Sh "نویسندگان (AUTHORS)"
ابزار
.Nm
توسط
.An Alexander Matthes So Ziz Sc Aq Mt ziz@mailbox.org
نگهداری می‌شود.
.Sh "باگ‌ها (BUGS)"
متن چشمک‌زن با استفاده از تگ HTML
.Va