.\" صفحه راهنمای tidy برای HTML Tidy
.TH TIDY 1 "5.7.45" "HTML Tidy" "5.7.45"
.\" غیرفعال کردن اتصال با خط تیره (hyphenation)
.nh
.\" غیرفعال کردن تراز متن (تنظیم متن تنها از حاشیه چپ)
.ad l
.SH "نام (NAME)"
\fBtidy\fR \- بررسی، اصلاح و زیباسازی فایلهای HTML(5)
.SH "خلاصه دستور (SYNOPSIS)"
\fBtidy\fR [\fIoptions\fR] [\fIfile\fR ...] [\fIoptions\fR] [\fIfile\fR ...] ...
.SH "توضیحات (DESCRIPTION)"
دستور Tidy فایلهای HTML، XHTML و XML را خوانده و نشانهگذاری پاکسازیشده را در خروجی مینویسد.
برای انواع مختلف HTML، این ابزار بسیاری از خطاهای رایج کدنویسی را شناسایی، گزارش و اصلاح کرده و تلاش میکند نشانهگذاریِ از نظر بصری یکسانی تولید کند که هم با مشخصات استانداردهای HTML سازگار باشد و هم در اکثر مرورگرها بهدرستی کار کند.
.LP
یکی از کاربردهای رایج Tidy، تبدیل HTML ساده به XHTML است.
برای فایلهای عمومی XML، عملکرد Tidy به اصلاح خطاهای ابتدایی ساختاریافتگی (well-formedness) و زیباسازی متن (pretty printing) محدود میشود.
.LP
اگر هیچ فایل ورودی مشخص نشود، Tidy از ورودی استاندارد میخواند.
اگر هیچ فایل خروجی مشخص نشود، Tidy نشانهگذاری تمیزشده را در خروجی استاندارد مینویسد. اگر فایل خطایی مشخص نشود، Tidy پیامها را در خطای استاندارد مینویسد.
.SH "گزینهها (OPTIONS)"
دستور Tidy از دو نوع مختلف از گزینهها پشتیبانی میکند.
گزینههای صرفاً \fIخط فرمانی\fR، که با یک خط تیره منفرد '\fB-\fR' آغاز میشوند، فقط در خط فرمان قابل استفاده هستند، نه در فایلهای پیکربندی.
این گزینهها در بخش اول این قسمت فهرست شدهاند.
از سوی دیگر، گزینههای \fIپیکربندی\fR را میتوان هم در خط فرمان با دو خط تیره \fB--\fR وارد کرد و هم در فایل پیکربندی با استفاده از نام گزینه و به دنبال آن دونقطه \fB:\fR به همراه مقدار آن، بدون خط تیرههای ابتدایی، مشخص نمود. آنها به همراه یک نمونه فایل پیکربندی در بخش دوم این قسمت فهرست شدهاند.
.LP
برای گزینههای \fIخط فرمانی\fR که انتظار یک آرگومان عددی دارند، در صورتی که مقدار معناداری یافت نشود، یک مقدار پیشفرض در نظر گرفته میشود.
از سوی دیگر، گزینههای \fIپیکربندی\fR بدون مقدار قابل استفاده نیستند؛ یک گزینه \fIپیکربندی\fR بدون مقدار بهسادگی نادیده گرفته شده و بهعنوان خطا گزارش میشود.
.LP
استفاده از یک گزینه \fIخط فرمانی\fR گاهی معادل تنظیم مقدار یک گزینه \fIپیکربندی\fR است.
گزینه و مقدار معادل، به همان صورتی که در فایل پیکربندی ظاهر میشوند، درون پرانتز در فهرست زیر نشان داده شدهاند. برای نمونه،
\fB-quiet, -q\fR (\fIquiet: yes\fR) بدین معناست که استفاده از گزینه \fIخط فرمانی\fR \fB-quiet\fR یا \fB-q\fR معادل تنظیم گزینه \fIپیکربندی\fR \fIquiet\fR بر روی \fIyes\fR است.
.LP
گزینههای تکحرفی \fIخط فرمانی\fRِ بدون مقدار متناظر را میتوان با یکدیگر ترکیب کرد؛ برای مثال، '\fB-i\fR'، '\fB-m\fR' و '\fB-u\fR' را میتوان بهصورت '\fB-imu\fR' ترکیب نمود.
.SS "دستکاری فایل (File manipulation)"
.TP
\fB-output \fR, \fB-o \fR (\fIoutput-file: \fR)
نوشتن خروجی در مشخصشده
.TP
\fB-config \fR
تنظیم گزینههای پیکربندی از مشخصشده
.TP
\fB-file \fR, \fB-f \fR (\fIerror-file: \fR)
نوشتن خطاها و هشدارها در مشخصشده
.TP
\fB-modify\fR, \fB-m\fR (\fIwrite-back: yes\fR)
اصلاح فایلهای ورودی اصلی
.SS "دستورالعملهای پردازش (Processing directives)"
.TP
\fB-indent\fR, \fB-i\fR (\fIindent: auto\fR)
دندانهگذاری محتوای عناصر
.TP
\fB-wrap \fR, \fB-w \fR (\fIwrap: \fR)
شکستن خطوط متن در مشخصشده. در صورت مشخص نشدن ، مقدار 0 در نظر گرفته میشود. هنگامی که این گزینه قید نشود، مقدار پیشفرض گزینه پیکربندی 'wrap' اعمال میگردد.
.TP
\fB-upper\fR, \fB-u\fR (\fIuppercase-tags: yes\fR)
اجبار تگها به استفاده از حروف بزرگ
.TP
\fB-clean\fR, \fB-c\fR (\fIclean: yes\fR)
جایگزینی تگهای FONT، NOBR و CENTER با CSS
.TP
\fB-bare\fR, \fB-b\fR (\fIbare: yes\fR)
حذف علامتهای نقلقول هوشمند (smart quotes)، خطهای تیره کشیده (em dashes) و غیره
.TP
\fB-gdoc\fR, \fB-g\fR (\fIgdoc: yes\fR)
تولید نسخه پاکیزه از HTML برونریزیشده توسط Google Docs
.TP
\fB-numeric\fR, \fB-n\fR (\fInumeric-entities: yes\fR)
خروجی دادن نهادها بهصورت عددی بهجای نهادهای نامدار
.TP
\fB-errors\fR, \fB-e\fR (\fImarkup: no\fR)
تنها نمایش خطاها و هشدارها
.TP
\fB-quiet\fR, \fB-q\fR (\fIquiet: yes\fR)
جلوگیری از چاپ خروجیهای غیرضروری
.TP
\fB-omit\fR (\fIomit-optional-tags: yes\fR)
حذف تگهای شروع و تگهای پایانی اختیاری
.TP
\fB-xml\fR (\fIinput-xml: yes\fR)
مشخص ساختن اینکه ورودی یک XML خوشساخت (well formed) است
.TP
\fB-asxml\fR, \fB-asxhtml\fR (\fIoutput-xhtml: yes\fR)
تبدیل HTML به XHTML خوشساخت (well formed)
.TP
\fB-ashtml\fR (\fIoutput-html: yes\fR)
اجبار XHTML به HTML خوشساخت (well formed)
.TP
\fB-access \fR (\fIaccessibility-check: \fR)
انجام بررسیهای دسترسیپذیری اضافی ( = 0, 1, 2, 3). در صورت مشخص نشدن ، مقدار 0 در نظر گرفته میشود.
.SS "کدگذاریهای نویسه (Character encodings)"
.TP
\fB-raw\fR
خروجی دادن مقادیر بالاتر از 127 بدون تبدیل به نهادها (entities)
.TP
\fB-ascii\fR
استفاده از ISO-8859-1 برای ورودی و US-ASCII برای خروجی
.TP
\fB-latin0\fR
استفاده از ISO-8859-15 برای ورودی و US-ASCII برای خروجی
.TP
\fB-latin1\fR
استفاده از ISO-8859-1 برای هر دو ورودی و خروجی
.TP
\fB-iso2022\fR
استفاده از ISO-2022 برای هر دو ورودی و خروجی
.TP
\fB-utf8\fR
استفاده از UTF-8 برای هر دو ورودی و خروجی
.TP
\fB-mac\fR
استفاده از MacRoman برای ورودی و US-ASCII برای خروجی
.TP
\fB-win1252\fR
استفاده از Windows-1252 برای ورودی و US-ASCII برای خروجی
.TP
\fB-ibm858\fR
استفاده از IBM-858 (CP850+Euro) برای ورودی و US-ASCII برای خروجی
.TP
\fB-utf16le\fR
استفاده از UTF-16LE برای هر دو ورودی و خروجی
.TP
\fB-utf16be\fR
استفاده از UTF-16BE برای هر دو ورودی و خروجی
.TP
\fB-utf16\fR
استفاده از UTF-16 برای هر دو ورودی و خروجی
.TP
\fB-big5\fR
استفاده از Big5 برای هر دو ورودی و خروجی
.TP
\fB-shiftjis\fR
استفاده از Shift_JIS برای هر دو ورودی و خروجی.SS متفرقه (Miscellaneous)
.TP
\fB-version\fR, \fB-v\fR
نمایش نسخهٔ Tidy
.TP
\fB-help\fR, \fB-h\fR, \fB-?\fR
فهرست کردن گزینههای خط فرمان
.TP
\fB-help-config\fR
فهرست کردن تمام گزینههای پیکربندی
.TP
\fB-help-env\fR
نمایش اطلاعات دربارهٔ محیط و پیکربندی زمان اجرا
.TP
\fB-show-config\fR
فهرست کردن تنظیمات پیکربندی فعلی
.TP
\fB-export-config\fR
فهرست کردن تنظیمات پیکربندی فعلی، مناسب برای یک فایل پیکربندی
.TP
\fB-export-default-config\fR
فهرست کردن تنظیمات پیکربندی پیشفرض، مناسب برای یک فایل پیکربندی
.TP
\fB-help-option