نام (NAME)

aha — تبدیل دنباله‌های فرار ANSI به HTML

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

aha [-bhlnprsvwx] [-c file] [-f file] [-i X] [-L LANG] [-t TITLE] [-y STYLE]

توضیحات (DESCRIPTION)

aha متن‌های رنگی بر پایه SGR در استاندارد ECMA-48 را از ورودی استاندارد می‌خواند، آن‌ها را به HTML رنگی تبدیل کرده و در خروجی استاندارد می‌نویسد. گزینه‌ها به شرح زیر هستند:

-b, --black: استایل‌دهی به خروجی HTML برای استفاده از پس‌زمینه مشکی با متن سفید.
-c file, --css file: فایل CSS مشخص‌شده با file را به خروجی می‌افزاید. در واقع صرفاً عبارت <link rel="stylesheet" href=" file " /> را به سرایند (header) اضافه می‌کند.
-f file: خواندن از file به‌جای ورودی استاندارد.
-h, --help, -?: چاپ راهنمای aha در خروجی استاندارد.
-i X, --iso X: استفاده از کدگذاری نویسه ISO-8859-X به‌جای UTF-8 برای خروجی، که در آن X عددی از 1 تا 16 است.
-l, --line-fix: استفاده از یک اصلاح برای ورودی‌هایی که از دنباله‌های کنترلی برای تغییر موقعیت مکان‌نما استفاده می‌کنند. این یک وصله اضطراری (hot fix) است، بنابراین ممکن است با همه برنامه‌ها کار نکند.
-L LANG, --lang LANG: استفاده از کد ISO-639-1 LANG برای زبان.
-n, --no-header: قرار ندادن خروجی HTML درون تگ‌های <html>, <head> و <body>.
-p, --pink: استایل‌دهی به خروجی HTML برای استفاده از پس‌زمینه صورتی.
-r, --ignore-cr: نادیده گرفتن تمام نویسه‌های بازگشت به ابتدای سطر (کد اسکی ۱۳، \r) که ممکن است منجر به خطوط خالی دوتایی در HTML شود.
-s, --stylesheet: استفاده از یک شیوه‌نامه (stylesheet) به‌جای استایل‌های درون‌خطی (inline).
-t TITLE, --title TITLE: تنظیم عنوان سند HTML به TITLE به‌جای "stdin" یا نام فایل.
-v, --version: چاپ شماره نسخه aha در خروجی استاندارد و خروج.
-w, --word-wrap: شکستن خطوط طولانی در خروجی HTML. با مرورگرهای پشتیبانی‌کننده از CSS3 و بسیاری از مرورگرهای قدیمی‌تر کار می‌کند.
-x, --no-xml: استفاده نکردن از doctype نوع XML و استفاده از HTML (ممکن است برای مرورگرهای قدیمی مانند IE مفید باشد).
-y STYLE, --style STYLE: تنظیم استایل مورد استفاده در عنصر <body> به STYLE پس از اعمال استایل‌های تنظیم‌شده توسط سایر پارامترها.

مثال‌ها (EXAMPLES)

ایجاد یک فایل HTML با پس‌زمینه مشکی، عنوان سفارشی و اندازه قلم بزرگ‌تر با استفاده از راهنمای aha:

$ aha -h | aha -b -t 'the awesome aha
  help' -y 'font-size:1.875em' > aha-help.html

ایجاد یک فایل HTML با پس‌زمینه سفید با استفاده از خروجی diff(1):

$ diff -u --color=always oldfile.c
  newfile.c | aha > diff.html

ایجاد یک فایل HTML با پس‌زمینه مشکی از خروجی htop(1). به دلیل دستورات خط جدید دیگری که htop استفاده می‌کند، باید از گزینه -l استفاده کنید:

$ echo q | htop | aha -b -l >
  htop.html

ایجاد یک فایل HTML از خروجی همین صفحه راهنما. دستور man(1) از قالب‌بندی پررنگ (bold) و زیرخط (underline) ناشی از nroff(1) استفاده می‌کند که ul(1) آن‌ها را به SGR تبدیل می‌نماید:

$ MAN_KEEP_FORMATTING=1 COLUMNS=80
  man aha | ul | aha > man-aha.html

همچنین ببینید (SEE ALSO)

console_codes(4) Control Functions for Coded Character Sets, Ecma, ECMA-48, 61, 1991.

نویسندگان (AUTHORS)

ابزار aha توسط Alexander Matthes ‘Ziz’ <ziz@mailbox.org> نگهداری می‌شود.

باگ‌ها (BUGS)

متن چشمک‌زن با استفاده از تگ HTML <blink> و ویژگی CSS text-decoration:blink در مرورگرهای امروزی منسوخ شده‌اند؛ بنابراین استفاده از گزینه -s و بازتعریف کلاس CSS .blink الزامی است.