TIDY(1)                             5.7.45                             TIDY(1)



نام (NAME)
       tidy - بررسی، اصلاح و زیباسازی فایل‌های HTML(5)

خلاصه دستور (SYNOPSIS)
       tidy [options] [file ...] [options] [file ...] ...

توضیحات (DESCRIPTION)
       دستور Tidy فایل‌های HTML،‏ XHTML و XML را خوانده و نشانه‌گذاری پاک‌سازی‌شده
       را در خروجی می‌نویسد.  برای انواع مختلف HTML، این ابزار بسیاری از خطاهای
       رایج کدنویسی را شناسایی، گزارش و اصلاح کرده و تلاش می‌کند نشانه‌گذاریِ از
       نظر بصری یکسانی تولید کند که هم با مشخصات استانداردهای HTML سازگار باشد
       و هم در اکثر مرورگرها به‌درستی کار کند.

       یکی از کاربردهای رایج Tidy، تبدیل HTML ساده به XHTML است.  برای فایل‌های
       عمومی XML، عملکرد Tidy به اصلاح خطاهای ابتدایی ساختاریافتگی (well-
       formedness) و زیباسازی متن (pretty printing) محدود می‌شود.

       اگر هیچ فایل ورودی مشخص نشود، Tidy از ورودی استاندارد می‌خواند.  اگر هیچ
       فایل خروجی مشخص نشود، Tidy نشانه‌گذاری تمیزشده را در خروجی استاندارد
       می‌نویسد. اگر فایل خطایی مشخص نشود، Tidy پیام‌ها را در خطای استاندارد
       می‌نویسد.

گزینه‌ها (OPTIONS)
       دستور Tidy از دو نوع مختلف از گزینه‌ها پشتیبانی می‌کند.  گزینه‌های صرفاً خط
       فرمانی، که با یک خط تیره منفرد '-' آغاز می‌شوند، فقط در خط فرمان قابل
       استفاده هستند، نه در فایل‌های پیکربندی.  این گزینه‌ها در بخش اول این قسمت
       فهرست شده‌اند.  از سوی دیگر، گزینه‌های پیکربندی را می‌توان هم در خط فرمان
       با دو خط تیره -- وارد کرد و هم در فایل پیکربندی با استفاده از نام گزینه
       و به دنبال آن دونقطه : به همراه مقدار آن، بدون خط تیره‌های ابتدایی، مشخص
       نمود. آن‌ها به همراه یک نمونه فایل پیکربندی در بخش دوم این قسمت فهرست
       شده‌اند.

       برای گزینه‌های خط فرمانی که انتظار یک آرگومان عددی دارند، در صورتی که
       مقدار معناداری یافت نشود، یک مقدار پیش‌فرض در نظر گرفته می‌شود.  از سوی
       دیگر، گزینه‌های پیکربندی بدون مقدار قابل استفاده نیستند؛ یک گزینه
       پیکربندی بدون مقدار به‌سادگی نادیده گرفته شده و به‌عنوان خطا گزارش می‌شود.

       استفاده از یک گزینه خط فرمانی گاهی معادل تنظیم مقدار یک گزینه پیکربندی
       است.  گزینه و مقدار معادل، به همان صورتی که در فایل پیکربندی ظاهر
       می‌شوند، درون پرانتز در فهرست زیر نشان داده شده‌اند. برای نمونه، -quiet,
       -q (quiet: yes) بدین معناست که استفاده از گزینه خط فرمانی -quiet یا -q
       معادل تنظیم گزینه پیکربندی quiet بر روی yes است.

       گزینه‌های تک‌حرفی خط فرمانیِ بدون مقدار متناظر را می‌توان با یکدیگر ترکیب
       کرد؛ برای مثال، '-i'،‏ '-m' و '-u' را می‌توان به‌صورت '-imu' ترکیب نمود.

   دستکاری فایل (File manipulation)
       -output <file>, -o <file> (output-file: <file>)
              نوشتن خروجی در <file> مشخص‌شده

       -config <file>
              تنظیم گزینه‌های پیکربندی از <file> مشخص‌شده

       -file <file>, -f <file> (error-file: <file>)
              نوشتن خطاها و هشدارها در <file> مشخص‌شده

       -modify, -m (write-back: yes)
              اصلاح فایل‌های ورودی اصلی

   دستورالعمل‌های پردازش (Processing directives)
       -indent, -i (indent: auto)
              دندانه‌گذاری محتوای عناصر

       -wrap <column>, -w <column> (wrap: <column>)
              شکستن خطوط متن در <column> مشخص‌شده. در صورت مشخص نشدن <column>،
              مقدار 0 در نظر گرفته می‌شود. هنگامی که این گزینه قید نشود، مقدار
              پیش‌فرض گزینه پیکربندی 'wrap' اعمال می‌گردد.

       -upper, -u (uppercase-tags: yes)
              اجبار تگ‌ها به استفاده از حروف بزرگ

       -clean, -c (clean: yes)
              جایگزینی تگ‌های FONT،‏ NOBR و CENTER با CSS

       -bare, -b (bare: yes)
              حذف علامت‌های نقل‌قول هوشمند (smart quotes)، خط‌های تیره کشیده (em
              dashes) و غیره

       -gdoc, -g (gdoc: yes)
              تولید نسخه پاکیزه از HTML برون‌ریزی‌شده توسط Google Docs

       -numeric, -n (numeric-entities: yes)
              خروجی دادن نهادها به‌صورت عددی به‌جای نهادهای نام‌دار

       -errors, -e (markup: no)
              تنها نمایش خطاها و هشدارها

       -quiet, -q (quiet: yes)
              جلوگیری از چاپ خروجی‌های غیرضروری

       -omit (omit-optional-tags: yes)
              حذف تگ‌های شروع و تگ‌های پایانی اختیاری

       -xml (input-xml: yes)
              مشخص ساختن اینکه ورودی یک XML خوش‌ساخت (well formed) است

       -asxml, -asxhtml (output-xhtml: yes)
              تبدیل HTML به XHTML خوش‌ساخت (well formed)

       -ashtml (output-html: yes)
              اجبار XHTML به HTML خوش‌ساخت (well formed)

       -access <level> (accessibility-check: <level>)
              انجام بررسی‌های دسترسی‌پذیری اضافی (<level> = 0, 1, 2, 3). در صورت
              مشخص نشدن <level>، مقدار 0 در نظر گرفته می‌شود.

   کدگذاری‌های نویسه (Character encodings)
       -raw   خروجی دادن مقادیر بالاتر از 127 بدون تبدیل به نهادها (entities)

       -ascii استفاده از ISO-8859-1 برای ورودی و US-ASCII برای خروجی

       -latin0
              استفاده از ISO-8859-15 برای ورودی و US-ASCII برای خروجی

       -latin1
              استفاده از ISO-8859-1 برای هر دو ورودی و خروجی

       -iso2022
              استفاده از ISO-2022 برای هر دو ورودی و خروجی

       -utf8  استفاده از UTF-8 برای هر دو ورودی و خروجی

       -mac   استفاده از MacRoman برای ورودی و US-ASCII برای خروجی

       -win1252
              استفاده از Windows-1252 برای ورودی و US-ASCII برای خروجی

       -ibm858
              استفاده از IBM-858 (CP850+Euro) برای ورودی و US-ASCII برای خروجی

       -utf16le
              استفاده از UTF-16LE برای هر دو ورودی و خروجی

       -utf16be
              استفاده از UTF-16BE برای هر دو ورودی و خروجی

       -utf16 استفاده از UTF-16 برای هر دو ورودی و خروجی

       -big5  استفاده از Big5 برای هر دو ورودی و خروجی

       -shiftjis
              استفاده از Shift_JIS برای هر دو ورودی و خروجی.SS متفرقه
              (Miscellaneous)


       -version, -v
              نمایش نسخهٔ Tidy

       -help, -h, -?
              فهرست کردن گزینه‌های خط فرمان

       -help-config
              فهرست کردن تمام گزینه‌های پیکربندی

       -help-env
              نمایش اطلاعات دربارهٔ محیط و پیکربندی زمان اجرا

       -show-config
              فهرست کردن تنظیمات پیکربندی فعلی

       -export-config
              فهرست کردن تنظیمات پیکربندی فعلی، مناسب برای یک فایل پیکربندی

       -export-default-config
              فهرست کردن تنظیمات پیکربندی پیش‌فرض، مناسب برای یک فایل پیکربندی

       -help-option <option>
              نمایش توضیحات <option>

       -language <lang> (language: <lang>)
              تنظیم زبان خروجی Tidy به <lang>. برای راهنمایی بیشتر ‎'-language
              help'‎ را مشخص کنید. برای اطمینان از اعمال زبان، قبل از
              آرگومان‌های تولیدکنندهٔ خروجی استفاده شود، مانند `tidy -lang es
              -lang help`.

   XML
       -xml-help
              فهرست کردن گزینه‌های خط فرمان در قالب XML

       -xml-config
              فهرست کردن تمام گزینه‌های پیکربندی در قالب XML

       -xml-strings
              خروجی دادن تمام رشته‌های Tidy در قالب XML

       -xml-error-strings
              خروجی دادن ثابت‌ها و رشته‌های خطا در قالب XML

       -xml-options-strings
              خروجی دادن توضیحات گزینه‌ها در قالب XML

       گزینه‌های پیکربندی را می‌توان با قرار دادن -- قبل از هر گزینه در خط فرمان
       به همراه مقدار مورد نظر آن، یا با قرار دادن گزینه‌ها و مقادیر در یک فایل
       پیکربندی و هدایت tidy به خواندن آن فایل با استفاده از گزینهٔ -config
       مشخص کرد:

          tidy --option1 value1 --option2 value2 ...
          tidy -config config-file  ...

       گزینه‌های پیکربندی را می‌توان به‌راحتی در یک فایل پیکربندی واحد گروه‌بندی
       کرد.  یک فایل پیکربندی Tidy صرفاً یک فایل متنی ساده است که در آن هر
       گزینه در یک خط جداگانه به این شکل فهرست می‌شود:

          option1: value1
          option2: value2
          و غیره

       مقادیر مجاز برای هر گزینه به نوع (Type) آن گزینه بستگی دارد.  پنج نوع
       وجود دارد: Boolean، AutoBool، DocType، Enum و String.  نوع‌های Boolean
       هر یک از مقادیر yes/no, y/n, true/false, t/f, 1/0 را می‌پذیرند.  نوع‌های
       AutoBool علاوه بر مقادیر مجاز برای Boolean، مقدار auto را نیز می‌پذیرند.
       نوع‌های Integer اعداد صحیح غیرمنفی دریافت می‌کنند.  نوع‌های String عموماً
       مقدار پیش‌فرضی ندارند و باید آن‌ها را بدون علامت نقل‌قول وارد کنید (مگر
       اینکه بخواهید خروجی عیناً حاوی نقل‌قول باشد).

       نوع‌های Enum، Encoding و DocType مجموعه موارد ثابتی دارند که در بخش‌های
       Supported values (مقادیر پشتیبانی‌شده) در ادامه فهرست شده‌اند.

       تنها کافی است گزینه‌ها و مقادیری را وارد کنید که مایل به بازنویسی و
       تغییر پیش‌فرض آن‌ها هستید؛ اگرچه ممکن است بخواهید برخی از گزینه‌ها و
       مقادیر پیش‌فرض را نیز به منظور مستندسازی و صراحت بیشتر در فایل بگنجانید.

       در اینجا یک نمونه فایل پیکربندی آورده شده است که دست‌کم یک مثال از هر یک
       از پنج نوع دارد:

           // sample Tidy configuration options
           output-xhtml: yes
           add-xml-decl: no
           doctype: strict
           char-encoding: ascii
           indent: auto
           wrap: 76
           repeated-attributes: keep-last
           error-file: errs.txt

       در ادامه خلاصه‌ای و توضیح کوتاهی از هر یک از گزینه‌ها آمده است.  آن‌ها در
       هر دسته‌بندی به ترتیب حروف الفبا فهرست شده‌اند.

   گزینه‌های نمایش سند (Document Display options)
       --gnu-emacs Boolean (در صورت تنظیم نشدن no)
              این گزینه مشخص می‌کند که Tidy باید قالب گزارش خطاها و هشدارها را
              به قالبی تغییر دهد که تجزیهٔ آن توسط GNU Emacs یا برنامه‌های دیگر
              آسان‌تر باشد. این گزینه قالب پیش‌فرض:

               line <line number> column <column number> - (Error|Warning):
              <message>

              را به قالبی که شامل نام فایل ورودی است تغییر می‌دهد:

               <filename>:<line number>:<column number>: (Error|Warning):
              <message>

              همچنین ببینید: --show-filename

       --markup Boolean (در صورت تنظیم نشدن yes)
              این گزینه مشخص می‌کند که آیا Tidy باید یک نسخهٔ بازآرایی‌شده و مرتب
              (pretty printed) از نشانه‌گذاری تولید کند یا خیر. توجه داشته
              باشید در صورتی که Tidy خطاهای قابل‌توجهی پیدا کند، نسخهٔ
              بازآرایی‌شده‌ای تولید نخواهد کرد (ببینید: force-output).

       --mute String
              از این گزینه برای جلوگیری از نمایش انواع خاصی از گزارش‌های خروجی
              Tidy، به عنوان مثال برای شرایطی که مایل به نادیده گرفتن آن‌ها
              هستید، استفاده کنید.

              این گزینه فهرستی از یک یا چند کلید را می‌گیرد که نوع پیام برای
              ساکت‌سازی را مشخص می‌کنند. می‌توانید این کلیدهای پیام را با استفاده
              از گزینهٔ پیکربندی mute-id و بررسی خروجی Tidy کشف کنید.

              همچنین ببینید: --mute-id

       --mute-id Boolean (در صورت تنظیم نشدن no)
              این گزینه مشخص می‌کند که آیا Tidy باید شناسهٔ پیام‌ها (ID) را به
              همراه هر یک از گزارش‌های خطای خود نمایش دهد یا خیر. این گزینه در
              صورتی مفید است که بخواهید از گزینهٔ پیکربندی mute برای فیلتر کردن
              پیام‌های گزارش خاصی استفاده کنید.

              همچنین ببینید: --mute

       --quiet Boolean (در صورت تنظیم نشدن no)
              در صورت فعال بودن، این گزینه خروجی‌های غیرسندیِ Tidy را محدود
              می‌کند تا فقط هشدارها و خطاهای سند گزارش شوند.

       --show-body-only Enum (در صورت تنظیم نشدن no)
              مقادیر پشتیبانی‌شده: no, yes, auto

              این گزینه مشخص می‌کند که آیا Tidy باید تنها محتویات برچسب body را
              به عنوان یک قطعه‌کد HTML چاپ کند یا خیر.

              در صورت تنظیم روی auto، این عمل تنها در صورتی انجام می‌شود که
              برچسب body استنباط شده باشد.

              برای ادغام صفحات کامل موجود به عنوان بخشی از یک صفحهٔ دیگر مفید
              است.

              در صورتی که خروجی XML درخواست شده باشد، این گزینه تأثیری ندارد.

       --show-errors Integer (در صورت تنظیم نشدن 6)
              این گزینه عددی را مشخص می‌کند که Tidy از آن برای تعیین اینکه آیا
              خطاهای بیشتری نمایش داده شوند یا خیر استفاده می‌کند. اگر روی 0
              تنظیم شود، هیچ خطایی نمایش داده نخواهد شد.

       --show-filename Boolean (در صورت تنظیم نشدن no)
              این گزینه مشخص می‌کند که آیا Tidy باید نام فایل را در پیام‌ها نشان
              دهد یا خیر. برای مثال:

               tidy -q -e --show-filename yes index.html

               index.html: line 43 column 3 - Warning: replacing invalid UTF-8
              bytes (char. code U+00A9)

              همچنین ببینید: --gnu-emacs

       --show-info Boolean (در صورت تنظیم نشدن yes)
              این گزینه مشخص می‌کند که آیا Tidy باید پیام‌های سطح اطلاعاتی
              (info-level) را نمایش دهد یا خیر.

       --show-warnings Boolean (در صورت تنظیم نشدن yes)
              این گزینه مشخص می‌کند که آیا Tidy باید از نمایش هشدارها صرف‌نظر
              کند یا خیر. این کار زمانی که تعداد اندکی خطا در انبوهی از
              هشدارها پنهان شده‌اند می‌تواند بسیار مفید باشد..SS گزینه‌های ورودی
              و خروجی سند (Document In and Out options)


       --add-meta-charset Boolean (در صورت عدم تنظیم no)
              این گزینه در صورت فعال بودن، یک عنصر <meta> اضافه کرده و مشخصهٔ
              charset را روی کدگذاری سند تنظیم می‌کند. برای فعال‌سازی، مقدار این
              گزینه را yes قرار دهید.

       --add-xml-decl Boolean (در صورت عدم تنظیم no)
              این گزینه مشخص می‌کند که آیا Tidy هنگام خروجی دادن XML یا XHTML
              باید اعلان XML را اضافه کند یا خیر.

              توجه داشته باشید که اگر ورودی از قبل شامل یک اعلان <?xml ... ?>
              باشد، این گزینه نادیده گرفته خواهد شد.

              اگر کدگذاری خروجی با ascii، یکی از کدگذاری‌های utf* یا raw متفاوت
              باشد، مطابق با الزامات استاندارد XML، اعلان همیشه اضافه می‌شود.

              همچنین ببینید: --char-encoding، --output-encoding

       --add-xml-space Boolean (در صورت عدم تنظیم no)
              این گزینه مشخص می‌کند که آیا Tidy هنگام تولید XML باید
              xml:space="preserve" را به عناصری مانند <pre>، <style> و
              <script> اضافه کند یا خیر.

              این کار در صورتی لازم است که قرار باشد فاصله‌های خالی در این
              عناصر بدون دسترسی به DTD به‌طور مناسب تجزیه شوند.

       --doctype String (در صورت عدم تنظیم auto)
              این گزینه اعلان DOCTYPE تولیدشده توسط Tidy را مشخص می‌کند.

              اگر روی omit تنظیم شود، خروجی شامل اعلان DOCTYPE نخواهد بود.
              توجه داشته باشید که این مقدار همچنین به این معناست که numeric-
              entities روی yes تنظیم شده است.

              اگر روی html5 تنظیم شود، DOCTYPE روی <!DOCTYPE html> قرار
              می‌گیرد.

              اگر روی auto (پیش‌فرض) تنظیم شود، Tidy بر اساس محتوای سند حدسی
              سنجیده خواهد زد. توجه داشته باشید که انتخاب این گزینه، DOCTYPE
              سند فعلی را در خروجی تغییر نخواهد داد.

              اگر روی strict تنظیم شود، Tidy اعلان DOCTYPE را روی DTD دقیق
              (strict) مربوط به HTML4 یا XHTML1 قرار می‌دهد.

              اگر روی loose تنظیم شود، DOCTYPE روی DTD آسان‌گیر یا انتقالی
              (loose/transitional) مربوط به HTML4 یا XHTML1 قرار می‌گیرد.

              به‌عنوان جایگزین، می‌توانید یک رشته برای شناسهٔ عمومی رسمی (FPI)
              مشخص کنید.

              برای مثال:

              doctype: "-//ACME//DTD HTML 3.14159//EN"

              اگر FPI را برای یک سند XHTML مشخص کنید، Tidy شناسهٔ سیستم را روی
              یک رشتهٔ خالی تنظیم می‌کند. برای یک سند HTML، Tidy تنها در صورتی
              شناسهٔ سیستم را اضافه می‌کند که از قبل وجود داشته باشد تا حالت
              پردازش برخی مرورگرها حفظ شود. Tidy مقدار DOCTYPE را برای اسناد
              عمومی XML بدون تغییر باقی می‌گذارد.

              این گزینه اعتبارسنجی انطباق سند را ارائه نمی‌دهد.

       --input-xml Boolean (در صورت عدم تنظیم no)
              این گزینه مشخص می‌کند که آیا Tidy باید به جای تجزیه‌کنندهٔ HTML
              تصحیح‌کنندهٔ خطا، از تجزیه‌کنندهٔ XML استفاده کند یا خیر.

       --output-html Boolean (در صورت عدم تنظیم no)
              این گزینه مشخص می‌کند که آیا Tidy باید خروجی را به‌صورت آراسته
              (pretty printed) تولید کرده و آن را به شکل HTML بنویسد یا خیر.

       --output-xhtml Boolean (در صورت عدم تنظیم no)
              این گزینه مشخص می‌کند که آیا Tidy باید خروجی را به‌صورت آراسته
              (pretty printed) تولید کرده و آن را به شکل HTML گسترش‌پذیر بنویسد
              یا خیر.

              این گزینه باعث می‌شود Tidy مقدار DOCTYPE و فضای نام (namespace)
              پیش‌فرض را متناسب با XHTML تنظیم کند، و صرف‌نظر از منابع دیگر، از
              مقدار تصحیح‌شده در خروجی استفاده خواهد کرد.

              برای XHTML، موجودیت‌ها می‌توانند با توجه به تنظیمات numeric-
              entities به‌صورت نام‌گذاری‌شده یا عددی نوشته شوند.

              بزرگی و کوچکی حروف اصلی تگ‌ها و مشخصه‌ها، صرف‌نظر از گزینه‌های دیگر
              حفظ خواهد شد.

       --output-xml Boolean (در صورت عدم تنظیم no)
              این گزینه مشخص می‌کند که آیا Tidy باید خروجی را به‌صورت آراسته
              (pretty print) تولید کرده و آن را به‌شکل XML خوش‌ساخت (well-
              formed) بنویسد یا خیر.

              هر موجودیتی که در XML 1.0 تعریف نشده باشد، به‌صورت موجودیت عددی
              نوشته خواهد شد تا امکان تجزیهٔ آن توسط یک تجزیه‌کنندهٔ XML فراهم
              شود.

              بزرگی و کوچکی حروف اصلی تگ‌ها و مشخصه‌ها، صرف‌نظر از گزینه‌های دیگر
              حفظ خواهد شد.

   گزینه‌های ورودی-خروجی فایل (File Input-Output options)
       --error-file String
              این گزینه فایل خطایی را مشخص می‌کند که Tidy برای خطاها و هشدارها
              استفاده می‌کند. در حالت عادی، خطاها و هشدارها در stderr نوشته
              می‌شوند.

              همچنین ببینید: --output-file

       --keep-time Boolean (در صورت عدم تنظیم no)
              این گزینه مشخص می‌کند که آیا Tidy باید زمان ویرایش اولیهٔ فایل‌هایی
              را که مستقیماً درجا ویرایش می‌کند، حفظ کند یا خیر.

              تنظیم این گزینه روی yes به شما اجازه می‌دهد فایل‌ها را بدون تغییر
              دادن تاریخ ویرایش فایل مرتب‌سازی کنید؛ این کار ممکن است برای
              ابزارهای خاصی که از تاریخ ویرایش برای مواردی مانند استقرار
              خودکار روی سرور استفاده می‌کنند، مفید باشد.

              توجه داشته باشید که این ویژگی در برخی پلتفرم‌ها پشتیبانی نمی‌شود.

       --output-file String
              این گزینه فایل خروجی را مشخص می‌کند که Tidy برای نشانه‌گذاری
              (markup) استفاده می‌کند. در حالت عادی، نشانه‌گذاری در stdout نوشته
              می‌شود.

              همچنین ببینید: --error-file

       --write-back Boolean (در صورت عدم تنظیم no)
              این گزینه مشخص می‌کند که آیا Tidy باید نشانه‌گذاری مرتب‌شده را
              مجدداً روی همان فایلی که از آن خوانده بود بنویسد یا خیر.

              توصیه می‌شود قبل از مرتب‌سازی فایل‌های مهم، از آن‌ها نسخهٔ پشتیبان
              تهیه کنید، چرا که در مواقع نادر ممکن است نتیجه آن چیزی نباشد که
              انتظار دارید.

   گزینه‌های خطایابی و عیب‌یابی (Diagnostics options)
       --accessibility-check Enum (در صورت عدم تنظیم 0 (Tidy Classic))
              مقادیر پشتیبانی‌شده: 0 (Tidy Classic), 1 (Priority 1 Checks), 2
              (Priority 2 Checks), 3 (Priority 3 Checks)

              این گزینه سطح بررسی دسترسی‌پذیری که Tidy باید انجام دهد (در صورت
              وجود) را مشخص می‌کند.

              سطح 0 (Tidy Classic) معادل بررسی دسترسی‌پذیری نسخهٔ Tidy Classic
              است.

              برای کسب اطلاعات بیشتر دربارهٔ بررسی دسترسی‌پذیری Tidy، صفحهٔ
              دسترسی‌پذیری Tidy را در نشانی http://www.html-
              tidy.org/accessibility ببینید.

       --force-output Boolean (در صورت عدم تنظیم no)
              این گزینه مشخص می‌کند که آیا Tidy حتی در صورت مواجهه با خطاها
              باید خروجی تولید کند یا خیر.

              از این گزینه با احتیاط استفاده کنید؛ اگر Tidy خطایی گزارش دهد،
              بدین معناست که نتوانسته است (یا مطمئن نیست چگونه) خطا را رفع
              کند، بنابراین خروجی حاصل ممکن است با آنچه مد نظر شما بوده
              همخوانی نداشته باشد.

       --show-meta-change Boolean (در صورت عدم تنظیم no)
              این گزینه پیامی را فعال می‌کند که هر زمان Tidy مشخصهٔ content در
              یک اعلان meta charset را برای مطابقت با کدگذاری سند تغییر داد،
              نمایش داده شود. برای فعال‌سازی، مقدار این گزینه را yes قرار دهید.

       --warn-proprietary-attributes Boolean (در صورت عدم تنظیم yes)
              این گزینه مشخص می‌کند که آیا Tidy باید در مورد مشخصه‌های اختصاصی
              (proprietary) هشدار دهد یا خیر..SS "گزینه‌های کدگذاری (Encoding
              options)"


       --char-encoding Encoding (utf8 در صورت تنظیم‌نشدن)
              مقادیر پشتیبانی‌شده: raw, ascii, latin0, latin1, utf8, iso2022,
              mac, win1252, ibm858, utf16le, utf16be, utf16, big5, shiftjis

              این گزینه کدگذاری نویسه‌ای را که Tidy برای ورودی استفاده می‌کند
              مشخص کرده و هنگامی که تنظیم شود، به‌طور خودکار یک کدگذاری نویسهٔ
              مناسب را برای استفاده در خروجی انتخاب می‌کند. کدگذاری خروجی که
              Tidy انتخاب می‌کند ممکن است با کدگذاری ورودی متفاوت باشد.

              برای کدگذاری‌های ورودی ascii، latin0، ibm858، mac و win1252،
              گزینهٔ output-encoding به‌طور خودکار روی ascii تنظیم می‌شود.
              می‌توانید output-encoding را به‌صورت دستی تنظیم کنید تا این مقدار
              بازنویسی شود.

              برای سایر کدگذاری‌های ورودی، گزینهٔ output-encoding به‌طور خودکار
              روی همان مقدار تنظیم خواهد شد.

              صرف‌نظر از مقدار از پیش تعیین‌شده، می‌توانید output-encoding را
              به‌صورت دستی برای بازنویسی آن تنظیم کنید.

              برنامهٔ Tidy یک مبدل کدگذاری نیست. اگرچه کدگذاری‌های Latin و UTF
              را می‌توان آزادانه با یکدیگر ترکیب کرد، اما تبدیل کدگذاری‌های
              آسیایی به کدگذاری‌های Latin با Tidy امکان‌پذیر نیست.

              همچنین ببینید: --input-encoding، --output-encoding

       --input-encoding Encoding (utf8 در صورت تنظیم‌نشدن)
              مقادیر پشتیبانی‌شده: raw, ascii, latin0, latin1, utf8, iso2022,
              mac, win1252, ibm858, utf16le, utf16be, utf16, big5, shiftjis

              این گزینه کدگذاری نویسه‌ای را که Tidy برای ورودی استفاده می‌کند
              مشخص می‌کند. Tidy فرضیات خاصی را دربارهٔ برخی از کدگذاری‌های ورودی
              در نظر می‌گیرد.

              برای ascii، برنامهٔ Tidy مقادیر نویسهٔ Latin-1 (ISO-8859-1) را
              می‌پذیرد و در صورت نیاز آن‌ها را به نهادها (entities) تبدیل می‌کند.

              برای raw، برنامهٔ Tidy هیچ فرضی دربارهٔ مقادیر نویسه‌ها نخواهد داشت
              و آن‌ها را بدون تغییر به خروجی منتقل می‌کند.

              برای mac و win1252، مقادیر نویسه‌های خاص عرضه‌کننده پذیرفته شده و
              در صورت لزوم به نهادها تبدیل می‌شوند.

              کدگذاری‌های آسیایی مانند iso2022 با فرض این‌که output-encoding
              متناظر نیز مشخص شده باشد، به‌درستی پردازش خواهند شد.

              برنامهٔ Tidy یک مبدل کدگذاری نیست. اگرچه کدگذاری‌های Latin و UTF
              را می‌توان آزادانه با یکدیگر ترکیب کرد، اما تبدیل کدگذاری‌های
              آسیایی به کدگذاری‌های Latin با Tidy امکان‌پذیر نیست.

              همچنین ببینید: --char-encoding

       --newline Enum (LF در صورت تنظیم‌نشدن)
              مقادیر پشتیبانی‌شده: LF, CRLF, CR

              مقدار پیش‌فرض متناسب با پلتفرم فعلی است.

              عموماً CRLF در PC-DOS، Windows و OS/2؛ CR در Classic Mac OS؛ و LF
              در هر جای دیگر (Linux، macOS و Unix).

       --output-bom Enum (auto در صورت تنظیم‌نشدن)
              مقادیر پشتیبانی‌شده: no, yes, auto

              این گزینه مشخص می‌کند که آیا Tidy باید نویسهٔ نشانگر ترتیب بایت
              یونیکد (BOM؛ همچنین شناخته‌شده با عنوان Zero Width No-Break
              Space؛ با مقدار U+FEFF) را در ابتدای خروجی بنویسد یا خیر، و فقط
              برای کدگذاری‌های خروجی UTF-8 و UTF-16 اعمال می‌شود.

              در صورت تنظیم روی auto، این گزینه باعث می‌شود Tidy تنها در صورتی
              یک BOM در خروجی بنویسد که در ابتدای ورودی نیز BOM وجود داشته
              باشد.

              برای خروجی XML/XHTML که از کدگذاری‌های خروجی UTF-16 استفاده
              می‌کند، همیشه یک BOM نوشته می‌شود.

       --output-encoding Encoding (utf8 در صورت تنظیم‌نشدن)
              مقادیر پشتیبانی‌شده: raw, ascii, latin0, latin1, utf8, iso2022,
              mac, win1252, ibm858, utf16le, utf16be, utf16, big5, shiftjis

              این گزینه کدگذاری نویسه‌ای را که Tidy برای خروجی استفاده می‌کند
              مشخص می‌کند. برخی از کدگذاری‌های خروجی بر این‌که آیا برخی نویسه‌ها
              به نهادها تبدیل شوند یا خیر تأثیر می‌گذارند، اگرچه در همهٔ موارد،
              برخی از نهادها بر اساس سایر گزینه‌های پیکربندی Tidy نوشته خواهند
              شد.

              برای کدگذاری‌های خروجی ascii، mac و win1252، برای همهٔ نویسه‌هایی
              با مقدار بالاتر از 127 از نهادها استفاده خواهد شد.

              برای خروجی raw، برنامهٔ Tidy مقادیر بالاتر از 127 را بدون تبدیل
              آن‌ها به نهادها می‌نویسد.

              خروجی با استفاده از latin1 باعث می‌شود Tidy مقادیر نویسه‌های
              بالاتر از 255 را به‌صورت نهاد بنویسد.

              خانوادهٔ UTF مانند utf8 خروجی را با کدگذاری مربوطهٔ UTF می‌نویسد.

              کدگذاری‌های خروجی آسیایی مانند iso2022 خروجی را با کدگذاری
              مشخص‌شده می‌نویسند، به شرطی که input-encoding متناظر تعیین شده
              باشد.

              برنامهٔ Tidy یک مبدل کدگذاری نیست. اگرچه کدگذاری‌های Latin و UTF
              را می‌توان آزادانه با یکدیگر ترکیب کرد، اما تبدیل کدگذاری‌های
              آسیایی به کدگذاری‌های Latin با Tidy امکان‌پذیر نیست.

              همچنین ببینید: --char-encoding

   گزینه‌های پاک‌سازی (Cleanup options)
       --bare Boolean (no در صورت تنظیم‌نشدن)
              این گزینه مشخص می‌کند که آیا Tidy باید نقل‌قول‌های هوشمند (smart
              quotes) و خط‌های تیره کشیده (em dashes) را با ASCII جایگزین کند و
              در جاهایی که فاصله‌های نشکن (non-breaking spaces) در ورودی وجود
              دارند، به‌جای آن‌ها فاصلهٔ معمولی خروجی دهد یا خیر.

       --clean Boolean (no در صورت تنظیم‌نشدن)
              این گزینه مشخص می‌کند که آیا Tidy باید پاک‌سازی برخی از برچسب‌های
              نمایشی قدیمی (در حال حاضر <i>، <b>، <center> در صورت قرار گرفتن
              درون برچسب‌های درون‌خطی مناسب، و <font>) را انجام دهد یا خیر. در
              صورت تنظیم روی yes، برچسب‌های قدیمی با برچسب‌های CSS <style> و
              نشانه‌گذاری ساختاری مناسب جایگزین خواهند شد.

       --drop-empty-elements Boolean (yes در صورت تنظیم‌نشدن)
              این گزینه مشخص می‌کند که آیا Tidy باید عناصر خالی را حذف کند یا
              خیر.

       --drop-empty-paras Boolean (yes در صورت تنظیم‌نشدن)
              این گزینه مشخص می‌کند که آیا Tidy باید پاراگراف‌های خالی را حذف
              کند یا خیر.

       --drop-proprietary-attributes Boolean (no در صورت تنظیم‌نشدن)
              این گزینه مشخص می‌کند که آیا Tidy باید ویژگی‌های انحصاری، مانند
              ویژگی‌های پیوند دادهٔ (data binding) مایکروسافت را حذف کند یا خیر.
              علاوه بر این، ویژگی‌هایی که در نسخهٔ خروجی HTML مجاز نیستند، در
              صورت استفاده همراه با strict-tags-attributes حذف خواهند شد.

       --gdoc Boolean (no در صورت تنظیم‌نشدن)
              این گزینه مشخص می‌کند که آیا Tidy رفتار ویژه‌ای را برای پاک‌سازی
              HTML صادرشده از Google Docs فعال کند یا خیر.

       --logical-emphasis Boolean (no در صورت تنظیم‌نشدن)
              این گزینه مشخص می‌کند که آیا Tidy باید هر رخداد <i> را با <em> و
              هر رخداد <b> را با <strong> جایگزین کند یا خیر. تمام ویژگی‌ها
              بدون تغییر حفظ خواهند شد.

              این گزینه می‌تواند مستقل از گزینهٔ clean تنظیم شود.

       --merge-divs Enum (auto در صورت تنظیم‌نشدن)
              مقادیر پشتیبانی‌شده: no, yes, auto

              از این گزینه می‌توان برای تغییر رفتار clean در زمانی که روی yes
              تنظیم شده است استفاده کرد.

              این گزینه مشخص می‌کند که آیا Tidy باید <div>های تودرتو مانند
              <div><div>...</div></div> را ادغام کند یا خیر.

              در صورت تنظیم روی auto، ویژگی‌های <div> درونی به بیرونی منتقل
              می‌شوند. <div>های تودرتویی که دارای ویژگی id هستند ادغام نمی‌شوند.

              در صورت تنظیم روی yes، ویژگی‌های <div> درونی به‌جز class و style
              دور ریخته می‌شوند.

              همچنین ببینید: --clean، --merge-spans

       --merge-spans Enum (auto در صورت تنظیم‌نشدن)
              مقادیر پشتیبانی‌شده: no, yes, auto

              از این گزینه می‌توان برای تغییر رفتار clean در زمانی که روی yes
              تنظیم شده است استفاده کرد.

              این گزینه مشخص می‌کند که آیا Tidy باید <span>های تودرتو مانند
              <span><span>...</span></span> را ادغام کند یا خیر.

              الگوریتم آن همانند الگوریتم مورد استفاده در merge-divs است.

              همچنین ببینید: --clean، --merge-divs

       --word-2000 Boolean (no در صورت تنظیم‌نشدن)
              این گزینه مشخص می‌کند که آیا Tidy باید تلاش زیادی به خرج دهد تا
              تمام موارد اضافی را که Microsoft Word 2000 هنگام ذخیرهٔ اسناد
              Word به‌عنوان «صفحات وب» درج می‌کند، پاک‌سازی کند یا خیر. این گزینه
              تصاویر جاسازی‌شده یا VML را مدیریت نمی‌کند.

              شما باید ذخیره کردن با استفاده از Save As... در نرم‌افزار Word و
              انتخاب Web Page, Filtered را مد نظر قرار دهید..SS گزینه‌های
              موجودیت‌ها (Entities options)


       --ascii-chars Boolean (در صورت تنظیم نشدن no)
              می‌تواند برای تغییر رفتار گزینهٔ clean در هنگام تنظیم روی yes
              استفاده شود.

              اگر در هنگام استفاده از clean روی yes تنظیم شود، &emdash;،
              &rdquo; و دیگر موجودیت‌های نویسه‌ای نام‌دار به نزدیک‌ترین معادل‌های
              ASCII خود تقلیل می‌یابند.

              همچنین ببینید: --clean

       --ncr Boolean (در صورت تنظیم نشدن yes)
              این گزینه مشخص می‌کند که آیا Tidy باید ارجاعات نویسه‌ای عددی را
              مجاز بداند یا خیر.

       --numeric-entities Boolean (در صورت تنظیم نشدن no)
              این گزینه مشخص می‌کند که آیا Tidy باید موجودیت‌هایی غیر از
              موجودیت‌های توکار HTML (&amp;، &lt;، &gt; و &quot;) را به جای
              قالب موجودیت‌های نام‌دار، به شکل عددی در خروجی قرار دهد یا خیر.

              تنها از موجودیت‌هایی استفاده می‌شود که با اعلان DOCTYPE تولیدشده
              سازگار باشند.

              موجودیت‌هایی که در کدگذاری خروجی قابل نمایش باشند، به شکل متناظر
              ترجمه می‌شوند.

              همچنین ببینید: --doctype، --preserve-entities

       --preserve-entities Boolean (در صورت تنظیم نشدن no)
              این گزینه مشخص می‌کند که آیا Tidy باید موجودیت‌های خوش‌ساخت (well-
              formed) را همان‌گونه که در ورودی آمده‌اند حفظ کند یا خیر.

       --quote-ampersand Boolean (در صورت تنظیم نشدن yes)
              این گزینه مشخص می‌کند که آیا Tidy باید نویسه‌های & ساده را فقط در
              doctypeهای قدیمی به‌صورت &amp; خروجی دهد یا خیر.

       --quote-marks Boolean (در صورت تنظیم نشدن no)
              این گزینه مشخص می‌کند که آیا Tidy باید نویسه‌های " را مطابق با
              ترجیح برخی از محیط‌های ویرایشی، به‌صورت &quot; خروجی دهد یا خیر.

              نویسهٔ آپوستروف ' به‌صورت &#39; نوشته می‌شود؛ چرا که هنوز بسیاری از
              مرورگرهای وب از &apos; پشتیبانی نمی‌کنند.

       --quote-nbsp Boolean (در صورت تنظیم نشدن yes)
              این گزینه مشخص می‌کند که آیا Tidy باید نویسه‌های فاصلهٔ نشکن (non-
              breaking space) را به جای مقدار نویسه‌ای یونیکد ۱۶۰ (ده‌دهی)،
              به‌صورت موجودیت خروجی دهد یا خیر.

   گزینه‌های ترمیم (Repair options)
       --alt-text String
              این گزینه متن پیش‌فرض alt= را مشخص می‌کند که Tidy در هنگام نبود
              ویژگی alt= برای ویژگی‌های <img> استفاده می‌کند.

              با احتیاط استفاده کنید، زیرا دسترسی‌پذیر کردن سندها برای افرادی
              که قادر به دیدن تصاویر نیستند، بر عهدهٔ شماست.

       --anchor-as-name Boolean (در صورت تنظیم نشدن yes)
              این گزینه حذف یا اضافه شدن ویژگی name را در عناصری که می‌توانند
              به عنوان لنگر (anchor) عمل کنند کنترل می‌کند.

              اگر روی yes تنظیم شود، در صورتی که ویژگی name از قبل وجود نداشته
              باشد و DTD اجازه دهد، این ویژگی در کنار ویژگی موجود id اضافه
              می‌شود.

              اگر روی no تنظیم شود، در صورت وجود داشتن یا اضافه شدن ویژگی id،
              هرگونه ویژگی name موجود حذف خواهد شد.

       --assume-xml-procins Boolean (در صورت تنظیم نشدن no)
              این گزینه مشخص می‌کند که آیا Tidy باید تجزیهٔ دستورالعمل‌های
              پردازشی (processing instructions) را به‌گونه‌ای تغییر دهد که به
              جای >، به ?> به عنوان پایان‌بخش نیاز داشته باشد یا خیر.

              اگر ورودی در قالب XML باشد، این گزینه به صورت خودکار تنظیم
              می‌شود.

       --coerce-endtags Boolean (در صورت تنظیم نشدن yes)
              این گزینه مشخص می‌کند که آیا Tidy در مواردی که به نظر می‌رسد
              احتمالاً یک برچسب پایانی مد نظر بوده است، باید برچسب آغازین را به
              برچسب پایانی تبدیل کند یا خیر؛ به عنوان مثال، با داشتن

              <span>foo <b>bar<b> baz</span>

              خروجی Tidy به این صورت خواهد بود:

              <span>foo <b>bar</b> baz</span>

       --css-prefix String (در صورت تنظیم نشدن c)
              این گزینه پیشوندی را که Tidy برای قواعد شیوه‌نامه (style rules)
              به کار می‌برد مشخص می‌کند.

              به طور پیش‌فرض، c استفاده خواهد شد.

       --custom-tags Enum (در صورت تنظیم نشدن no)
              مقادیر پشتیبانی‌شده: no, blocklevel, empty, inline, pre

              این گزینه امکان استفاده از برچسب‌ها را برای عناصر سفارشی مستقل
              (autonomous custom elements)، مانند <flag-icon> در Tidy فعال
              می‌کند. اگر این مقدار no باشد، برچسب‌های سفارشی غیرفعال هستند.
              سایر تنظیمات شامل blocklevel، empty، inline و pre با تمام
              برچسب‌های سفارشی شناسایی‌شده متناسب با همان مقدار رفتار خواهند
              کرد.

              استفاده از new-blocklevel-tags، new-empty-tags، new-inline-tags
              یا new-pre-tags نحوهٔ برخورد با برچسب‌های سفارشی را توسط این گزینهٔ
              پیکربندی لغو می‌کند. در صورتی که انواع مختلفی از برچسب‌های سفارشی
              داشته باشید، این ویژگی می‌تواند مفید باشد.

              در صورت فعال بودن، این برچسب‌ها در حین پردازش سند با استفاده از
              برچسب‌های بازشونده تعیین می‌شوند؛ برچسب‌های بسته‌شوندهٔ منطبق متناسب
              با آن‌ها شناسایی شده و برچسب‌های بسته‌شوندهٔ ناشناخته دور انداخته
              می‌شوند.

              همچنین ببینید: --new-blocklevel-tags، --new-empty-tags، --new-
              inline-tags، --new-pre-tags

       --enclose-block-text Boolean (در صورت تنظیم نشدن no)
              این گزینه مشخص می‌کند که آیا Tidy باید عنصری از نوع <p> را برای
              در بر گرفتن هر متنی که در عنصری مجاز برای محتوای مختلط در HTML
              transitional (و نه HTML strict) می‌یابد، درج کند یا خیر.

       --enclose-text Boolean (در صورت تنظیم نشدن no)
              این گزینه مشخص می‌کند که آیا Tidy باید هر متنی را که در عنصر body
              می‌یابد، درون یک عنصر <p> محصور کند یا خیر.

              این ویژگی زمانی مفید است که می‌خواهید HTML موجود را دریافت کرده و
              با یک شیوه‌نامه (style sheet) استفاده نمایید.

       --escape-scripts Boolean (در صورت تنظیم نشدن yes)
              این گزینه باعث می‌شود مواردی که مانند برچسب‌های بسته‌شونده به نظر
              می‌رسند، مثل </g، به <\/g گریز داده شوند. اگر چنین چیزی را
              نمی‌خواهید، این گزینه را روی no تنظیم کنید.

       --fix-backslash Boolean (در صورت تنظیم نشدن yes)
              این گزینه مشخص می‌کند که آیا Tidy باید نویسه‌های بک‌اسلش \ را در
              URLها با اسلش رو به جلو / جایگزین کند یا خیر.

       --fix-bad-comments Enum (در صورت تنظیم نشدن auto)
              مقادیر پشتیبانی‌شده: no, yes, auto

              این گزینه مشخص می‌کند که آیا Tidy باید در هنگام مواجهه با
              خط‌تیره‌های متوالی، خط‌تیره‌های غیرمنتظره را با نویسه‌های = جایگزین
              کند یا خیر.

              پیش‌فرض auto است که برای انواع سندهای HTML5 به صورت no و برای همهٔ
              انواع سند دیگر به صورت yes عمل خواهد کرد.

              HTML نحو کامنت‌گذاری SGML را کنار گذاشته است و خط‌تیره‌های مجاور را
              برای همهٔ نسخه‌های HTML مجاز می‌داند، اگرچه XML و XHTML اجازه
              نمی‌دهند. اگر قصد دارید مرورگرهای قدیمی‌تری را که نیازمند نحو
              کامنت SGML هستند پشتیبانی کنید، تنظیم این مقدار را روی yes مد
              نظر قرار دهید.

       --fix-style-tags Boolean (در صورت تنظیم نشدن yes)
              این گزینه مشخص می‌کند که آیا Tidy باید تمام برچسب‌های style را به
              بخش head سند منتقل کند یا خیر.

       --fix-uri Boolean (در صورت تنظیم نشدن yes)
              این گزینه مشخص می‌کند که آیا Tidy باید مقادیر ویژگی‌های حاوی URI
              را از نظر نویسه‌های غیرمجاز بررسی کند و در صورت یافتن چنین
              مواردی، آن‌ها را طبق توصیهٔ HTML4 گریز دهد یا خیر.

       --literal-attributes Boolean (در صورت تنظیم نشدن no)
              این گزینه نحوهٔ برخورد Tidy با نویسه‌های فاصلهٔ سفید در مقادیر
              ویژگی‌ها را مشخص می‌کند.

              اگر مقدار no باشد، Tidy مقادیر ویژگی‌ها را با جایگزینی هر خط جدید
              یا تب با یک تک‌فاصله، و فراتر از آن با جایگزینی هر فضای سفید
              متوالی با یک تک‌فاصله، عادی‌سازی می‌کند.

              برای وادار کردن Tidy به حفظ مقادیر اصلی و لفظی (literal) همهٔ
              ویژگی‌ها و اطمینان از اینکه فاصله‌های سفید درون مقادیر ویژگی‌ها
              بدون تغییر عبور می‌کنند، این گزینه را روی yes تنظیم کنید.

       --lower-literals Boolean (در صورت تنظیم نشدن yes)
              این گزینه مشخص می‌کند که آیا Tidy باید مقدار ویژگی‌ای را که فهرستی
              از مقادیر از پیش تعریف‌شده می‌پذیرد، به حروف کوچک تبدیل کند یا
              خیر.

              این امر برای سندهای XHTML الزامی است.

       --repeated-attributes Enum (در صورت تنظیم نشدن keep-last)
              مقادیر پشتیبانی‌شده: keep-first, keep-last

              این گزینه مشخص می‌کند که در صورت تکرار یک ویژگی، به عنوان مثال
              وجود دو ویژگی align، آیا Tidy باید اولین ویژگی را حفظ کند یا
              آخرین ویژگی را.

              همچنین ببینید: --join-classes، --join-styles

       --skip-nested Boolean (در صورت تنظیم نشدن yes)
              این گزینه مشخص می‌کند که Tidy در هنگام تجزیهٔ داده‌های script و
              style، برچسب‌های تو در تو را نادیده بگیرد.

       --strict-tags-attributes Boolean (در صورت تنظیم نشدن no)
              این گزینه اطمینان حاصل می‌کند که برچسب‌ها و ویژگی‌ها برای نسخهٔ
              HTMLای که Tidy خروجی می‌دهد قابل اعمال باشند. هنگامی که روی yes
              تنظیم شود و نوع سند خروجی یک doctype سخت‌گیرانه (strict) باشد،
              Tidy خطاها را گزارش خواهد کرد. اگر نوع سند خروجی یک doctype آزاد
              یا بینابینی (transitional) باشد، Tidy هشدارها را گزارش می‌دهد.

              علاوه بر این، اگر drop-proprietary-attributes فعال باشد،
              ویژگی‌های غیرقابل اعمال نیز حذف خواهند شد.

              در صورت تنظیم روی no، این بررسی‌ها انجام نمی‌شوند.

       --uppercase-attributes Enum (در صورت تنظیم نشدن no)
              مقادیر پشتیبانی‌شده: no, yes, preserve

              این گزینه مشخص می‌کند که آیا Tidy باید نام‌های ویژگی‌ها را با حروف
              بزرگ در خروجی بنویسد یا خیر.

              در صورت تنظیم روی no، نام‌های ویژگی‌ها با حروف کوچک نوشته خواهند
              شد. تعیین yes نام‌های ویژگی‌ها را با حروف بزرگ خروجی می‌دهد، و
              می‌توان از preserve برای دست‌نخورده باقی گذاشتن حالت نویسه‌ها در
              نام ویژگی‌ها استفاده کرد.

              در صورت استفاده از ورودی XML، بزرگی و کوچکی اصلی نویسه‌ها همیشه
              حفظ می‌شود.

       --uppercase-tags Boolean (در صورت تنظیم نشدن no)
              این گزینه مشخص می‌کند که آیا Tidy باید نام‌های برچسب را با حروف
              بزرگ در خروجی بنویسد یا خیر.

              پیش‌فرض no است که منجر به نام‌های برچسب با حروف کوچک می‌شود، به جز
              در ورودی XML که در آن بزرگی و کوچکی نویسه‌ها به حالت اولیه حفظ
              می‌شود..SS "گزینه‌های تبدیل (Transformation options)"


       --decorate-inferred-ul Boolean (در صورت عدم تنظیم no)
              این گزینه مشخص می‌کند که آیا Tidy باید عناصر استنتاج‌شدهٔ <ul> را
              با برخی نشانه‌گذاری‌های CSS تزیین کند تا از تورفتگی به سمت راست
              جلوگیری شود یا خیر.

       --escape-cdata Boolean (در صورت عدم تنظیم no)
              این گزینه مشخص می‌کند که آیا Tidy باید بخش‌های <![CDATA[]]> را به
              متن عادی تبدیل کند یا خیر.

       --hide-comments Boolean (در صورت عدم تنظیم no)
              این گزینه مشخص می‌کند که آیا Tidy باید از چاپ توضیحات (کامنت‌ها)
              خودداری کند یا خیر.

       --join-classes Boolean (در صورت عدم تنظیم no)
              این گزینه مشخص می‌کند در صورتی که چندین انتساب کلاس روی یک عنصر
              شناسایی شود، آیا Tidy باید نام‌های کلاس را برای ایجاد یک نام کلاس
              تکی و جدید با یکدیگر ترکیب کند یا خیر.

       --join-styles Boolean (در صورت عدم تنظیم yes)
              این گزینه مشخص می‌کند در صورتی که چندین مقدار استایل روی یک عنصر
              شناسایی شود، آیا Tidy باید استایل‌ها را برای ایجاد یک استایل تکی
              و جدید با یکدیگر ترکیب کند یا خیر.

       --merge-emphasis Boolean (در صورت عدم تنظیم yes)
              این گزینه مشخص می‌کند که آیا Tidy باید عناصر تودرتوی <b> و <i> را
              ادغام کند یا خیر؛ برای مثال، در مورد

              <b class="rtop-2">foo <b class="r2-2">bar</b> baz</b>،

              برنامهٔ Tidy خروجی <b class="rtop-2">foo bar baz</b> را تولید
              خواهد کرد.

       --replace-color Boolean (در صورت عدم تنظیم no)
              این گزینه مشخص می‌کند که آیا Tidy باید در صورت تعریف شدن نام
              رنگ‌های HTML/XHTML، مقادیر عددی را در مشخصه‌های رنگ با این نام‌ها
              جایگزین کند یا خیر؛ برای مثال جایگزینی #ffffff با white.

   گزینه‌های آموزش Tidy (Teaching Tidy options)
       --new-blocklevel-tags Tag Names
              مقادیر پشتیبانی‌شده: tagX, tagY, ...

              این گزینه تگ‌های سطح بلوک (block-level) جدید را مشخص می‌کند. این
              گزینه فهرستی از نام‌های تگ را که با فاصله یا ویرگول از هم جدا
              شده‌اند، دریافت می‌کند.

              مگر اینکه تگ‌های جدید را اعلان کنید، در غیر این صورت اگر ورودی
              شامل تگ‌های ناشناخته از قبل باشد، Tidy از تولید فایل مرتب‌شده
              خودداری خواهد کرد.

              توجه داشته باشید که نمی‌توانید مدل محتوا را برای عناصری مانند
              <table>، <ul>، <ol> و <dl> تغییر دهید.

              این گزینه در حالت XML نادیده گرفته می‌شود.

              همچنین ببینید: --new-empty-tags، --new-inline-tags، --new-pre-
              tags، --custom-tags

       --new-empty-tags Tag Names
              مقادیر پشتیبانی‌شده: tagX, tagY, ...

              این گزینه تگ‌های درون‌خطی (inline) خالی جدید را مشخص می‌کند. این
              گزینه فهرستی از نام‌های تگ را که با فاصله یا ویرگول از هم جدا
              شده‌اند، دریافت می‌کند.

              مگر اینکه تگ‌های جدید را اعلان کنید، در غیر این صورت اگر ورودی
              شامل تگ‌های ناشناخته از قبل باشد، Tidy از تولید فایل مرتب‌شده
              خودداری خواهد کرد.

              به یاد داشته باشید که تگ‌های خالی را نیز باید به عنوان inline یا
              blocklevel اعلان کنید.

              این گزینه در حالت XML نادیده گرفته می‌شود.

              همچنین ببینید: --new-blocklevel-tags، --new-inline-tags، --new-
              pre-tags، --custom-tags

       --new-inline-tags Tag Names
              مقادیر پشتیبانی‌شده: tagX, tagY, ...

              این گزینه تگ‌های درون‌خطی (inline) غیرخالی جدید را مشخص می‌کند. این
              گزینه فهرستی از نام‌های تگ را که با فاصله یا ویرگول از هم جدا
              شده‌اند، دریافت می‌کند.

              مگر اینکه تگ‌های جدید را اعلان کنید، در غیر این صورت اگر ورودی
              شامل تگ‌های ناشناخته از قبل باشد، Tidy از تولید فایل مرتب‌شده
              خودداری خواهد کرد.

              این گزینه در حالت XML نادیده گرفته می‌شود.

              همچنین ببینید: --new-blocklevel-tags، --new-empty-tags، --new-
              pre-tags، --custom-tags

       --new-pre-tags Tag Names
              مقادیر پشتیبانی‌شده: tagX, tagY, ...

              این گزینه تگ‌های جدیدی را مشخص می‌کند که باید دقیقاً به همان روش
              عنصر <pre> در HTML پردازش شوند. این گزینه فهرستی از نام‌های تگ را
              که با فاصله یا ویرگول از هم جدا شده‌اند، دریافت می‌کند.

              مگر اینکه تگ‌های جدید را اعلان کنید، در غیر این صورت اگر ورودی
              شامل تگ‌های ناشناخته از قبل باشد، Tidy از تولید فایل مرتب‌شده
              خودداری خواهد کرد.

              توجه داشته باشید که هنوز نمی‌توانید عناصر CDATA جدید اضافه کنید.

              این گزینه در حالت XML نادیده گرفته می‌شود.

              همچنین ببینید: --new-blocklevel-tags، --new-empty-tags، --new-
              inline-tags، --custom-tags

   گزینه‌های زیباسازی خروجی (Pretty Print options)
       --break-before-br Boolean (در صورت عدم تنظیم no)
              این گزینه مشخص می‌کند که آیا Tidy باید قبل از هر عنصر <br> یک
              شکست خط در خروجی درج کند یا خیر.

       --indent Enum (در صورت عدم تنظیم no)
              مقادیر پشتیبانی‌شده: no, yes, auto

              این گزینه مشخص می‌کند که آیا Tidy باید تگ‌های سطح بلوک را
              دندانه‌دار (indent) کند یا خیر.

              اگر روی auto تنظیم شود، Tidy بر اساس اینکه آیا محتوا شامل یک
              عنصر سطح بلوک است یا خیر، تصمیم می‌گیرد که محتوای تگ‌هایی مانند
              <title>، <h1>-<h6>، <li>، <td> یا <p> را دندانه‌دار کند یا نه.

              تنظیم indent روی yes می‌تواند باگ‌های چیدمان را در برخی مرورگرها
              آشکار کند.

              برای کنترل تعداد فاصله‌ها یا تب‌های خروجی در هر سطح از تورفتگی، از
              گزینهٔ indent-spaces و برای مشخص کردن اینکه از فاصله استفاده شود
              یا تب، از indent-with-tabs استفاده کنید.

              همچنین ببینید: --indent-spaces

       --indent-attributes Boolean (در صورت عدم تنظیم no)
              این گزینه مشخص می‌کند که آیا Tidy باید هر مشخصه (attribute) را در
              یک خط جدید آغاز کند یا خیر.

       --indent-cdata Boolean (در صورت عدم تنظیم no)
              این گزینه مشخص می‌کند که آیا Tidy باید بخش‌های <![CDATA[]]> را
              دندانه‌دار کند یا خیر.

       --indent-spaces Integer (در صورت عدم تنظیم 2)
              این گزینه تعداد فاصله‌ها یا تب‌هایی را مشخص می‌کند که Tidy در هنگام
              فعال بودن indent برای دندانه‌دار کردن محتوا استفاده می‌کند.

              توجه داشته باشید که مقدار پیش‌فرض این گزینه به مقدار indent-with-
              tabs بستگی دارد (همچنین ببینید).

              همچنین ببینید: --indent

       --indent-with-tabs Boolean (در صورت عدم تنظیم no)
              این گزینه مشخص می‌کند که آیا Tidy (با فرض اینکه indent برابر yes
              باشد) باید به جای فاصله‌ها با تب دندانه‌گذاری کند یا خیر.

              آن را روی yes تنظیم کنید تا به جای فاصله‌های پیش‌فرض، با استفاده
              از تب‌ها دندانه‌گذاری انجام شود.

              برای کنترل تعداد تب‌های خروجی در هر سطح از تورفتگی از گزینهٔ
              indent-spaces استفاده کنید. توجه داشته باشید هنگامی که indent-
              with-tabs فعال باشد، مقدار پیش‌فرض indent-spaces به 1 بازنشانی
              می‌شود.

              توجه کنید که tab-size تبدیل تب‌های ورودی به فاصله را کنترل می‌کند.
              آن را برابر با صفر قرار دهید تا تب‌های ورودی حفظ شوند.

       --keep-tabs Boolean (در صورت عدم تنظیم no)
              با مقدار پیش‌فرض no، برنامهٔ Tidy تمام تب‌های مبدأ را با فاصله
              جایگزین می‌کند که با گزینهٔ tab-size و آفست خط فعلی کنترل می‌شود.
              البته به‌جز در بلوک‌ها/عناصر خاصی که در زیر شمرده شده‌اند، این مورد
              بعداً به فقط یک فاصله کاهش می‌یابد.

              در صورت تنظیم روی yes، این گزینه مشخص می‌کند که Tidy باید تب‌های
              خاصی را که در مبدأ یافت می‌شوند حفظ کند، اما فقط در بلوک‌های از
              پیش قالب‌بندی‌شده مانند <pre> و سایر عناصر CDATA مانند <script>،
              <style> و شبه‌عناصر دیگر مانند <?php ... ?>. همانند همیشه، تمامی
              تب‌های دیگر یا دنباله‌ای از تب‌ها در مبدأ با یک فاصله جایگزین
              خواهند شد.

       --omit-optional-tags Boolean (در صورت عدم تنظیم no)
              این گزینه مشخص می‌کند که آیا Tidy باید هنگام تولید خروجی، تگ‌های
              شروع و پایان اختیاری را حذف کند یا خیر.

              تنظیم این گزینه باعث می‌شود که تمامی تگ‌های مربوط به عناصر <html>،
              <head> و <body> از خروجی حذف شوند، و همچنین تگ‌های پایانی نظیر
              </p>، </li>، </dt>، </dd>، </option>، </tr>، </td> و </th>.

              این گزینه برای خروجی XML نادیده گرفته می‌شود.

       --priority-attributes Attributes Names
              مقادیر پشتیبانی‌شده: attributeX, attributeY, ...

              این گزینه امکان اولویت‌بندی نوشتن مشخصه‌ها را در اسناد مرتب‌شده
              فراهم می‌کند و اجازه می‌دهد آن‌ها قبل از سایر مشخصه‌های یک عنصر
              نوشته شوند. برای مثال، می‌توانید مشخص کنید که id و name قبل از هر
              مشخصهٔ دیگری نوشته شوند.

              این گزینه فهرستی از نام‌های مشخصه‌ها را که با فاصله یا ویرگول از
              هم جدا شده‌اند، دریافت می‌کند.

       --punctuation-wrap Boolean (در صورت عدم تنظیم no)
              این گزینه مشخص می‌کند که آیا Tidy باید پس از برخی از نویسه‌های
              نشانه‌گذاری یونیکد یا چینی خط را بشکند یا خیر.

       --sort-attributes Enum (در صورت عدم تنظیم none)
              مقادیر پشتیبانی‌شده: none, alpha

              این گزینه مشخص می‌کند که Tidy باید مشخصه‌ها را در یک عنصر با
              استفاده از الگوریتم مرتب‌سازی مشخص‌شده مرتب کند. اگر روی alpha
              تنظیم شود، الگوریتم به صورت مرتب‌سازی الفبایی صعودی خواهد بود.

              هنگام استفاده در کنار مرتب‌سازی با priority-attributes، هرگونه
              مرتب‌سازی مشخصه‌ها پس از درج مشخصه‌های دارای اولویت در خروجی انجام
              خواهد شد.

              همچنین ببینید: --priority-attributes

       --tab-size Integer (در صورت عدم تنظیم 8)
              این گزینه تعداد ستون‌هایی را مشخص می‌کند که Tidy بین فاصله‌های
              متوالی کلید تب (tab stops) استفاده می‌کند. از این مقدار برای
              نگاشت تب‌ها به فاصله‌ها هنگام خواندن ورودی استفاده می‌شود.

       --tidy-mark Boolean (در صورت عدم تنظیم yes)
              این گزینه مشخص می‌کند که آیا Tidy باید یک عنصر meta به بخش head
              سند اضافه کند تا نشان دهد سند مرتب‌سازی شده است یا خیر.

              اگر عنصر meta از قبل موجود باشد، Tidy عنصر دیگری اضافه نخواهد
              کرد.

       --vertical-space Enum (در صورت عدم تنظیم no)
              مقادیر پشتیبانی‌شده: no, yes, auto

              این گزینه مشخص می‌کند که آیا Tidy برای خوانایی بهتر باید چند خط
              خالی اضافی درج کند یا خیر.

              پیش‌فرض no است.

              اگر روی auto تنظیم شود، Tidy تقریباً تمام نویسه‌های خط جدید
              (newline) را حذف خواهد کرد.

       --wrap Integer (در صورت عدم تنظیم 68)
              این گزینه حاشیهٔ راستی را مشخص می‌کند که Tidy برای شکستن خطوط از
              آن استفاده می‌کند.

              برنامهٔ Tidy تلاش می‌کند خطوط را به گونه‌ای بشکند که از این طول
              تجاوز نکنند.

              اگر می‌خواهید شکستن خودکار خطوط را غیرفعال کنید، مقدار wrap را
              روی 0 (صفر) تنظیم نمایید..TP --wrap-asp Boolean (در صورت عدم
              تنظیم yes)
              این گزینه مشخص می‌کند که آیا Tidy باید متن درون شبه‌عنصرهای ASP
              را، که شبیه <% ... %> هستند، سطربندی کند یا خیر.

       --wrap-attributes Boolean (در صورت عدم تنظیم no)
              این گزینه مشخص می‌کند که آیا Tidy باید مقادیر صفت‌ها را سطربندی
              کند یا خیر؛ به این معنی که اگر مقدار یک صفت باعث شود طول خط از
              عرض مشخص‌شده با wrap فراتر رود، Tidy یک یا چند شکست خط به مقدار
              اضافه می‌کند تا در چندین سطر شکسته شود.

              توجه داشته باشید که این گزینه می‌تواند مستقل از wrap-script-
              literals تنظیم شود. به‌طور پیش‌فرض، Tidy هر نویسه خط جدید یا تب
              (tab) را با یک فاصله جایگزین کرده و هر توالی از فاصله‌های خالی را
              به یک فاصله تکی تبدیل می‌کند.

              برای وادار کردن Tidy به حفظ مقادیر اصلی و صریح (literal) تمام
              صفت‌ها و اطمینان از اینکه نویسه‌های فاصله خالی درون مقادیر صفت‌ها
              بدون تغییر عبور داده می‌شوند، literal-attributes را روی yes تنظیم
              کنید.

              همچنین ببینید: --wrap-script-literals، --literal-attributes

       --wrap-jste Boolean (در صورت عدم تنظیم yes)
              این گزینه مشخص می‌کند که آیا Tidy باید متن درون شبه‌عنصرهای JSTE
              را، که شبیه <# ... #> هستند، سطربندی کند یا خیر.

       --wrap-php Boolean (در صورت عدم تنظیم no)
              این گزینه مشخص می‌کند که آیا Tidy باید پس از شبه‌عنصرهای PHP، که
              شبیه <?php ... ?> هستند، یک خط جدید اضافه کند یا خیر.

       --wrap-script-literals Boolean (در صورت عدم تنظیم no)
              این گزینه مشخص می‌کند که آیا Tidy باید لیترال‌های رشته‌ای را که در
              صفت‌های اسکریپت ظاهر می‌شوند سطربندی کند یا خیر.

              برنامه Tidy لیترال‌های رشته‌ای طولانی اسکریپت را با درج یک نویسه
              بک‌اسلش پیش از شکست خط سطربندی می‌کند.

              همچنین ببینید: --wrap-attributes

       --wrap-sections Boolean (در صورت عدم تنظیم yes)
              این گزینه مشخص می‌کند که آیا Tidy باید متن درون برچسب‌های بخش <![
              ... ]> را سطربندی کند یا خیر.

محیط (ENVIRONMENT)
       HTML_TIDY
              نام فایل پیکربندی پیش‌فرض. این باید یک مسیر مطلق باشد، زیرا
              احتمالاً tidy را از دایرکتوری‌های مختلفی فراخوانی خواهید کرد.
              مقدار HTML_TIDY پس از پیش‌فرض تعبیه‌شده در زمان کامپایل (تعریف‌شده
              با -DTIDY_CONFIG_FILE)، اما پیش از هر فایلی که با استفاده از
              -config مشخص شده باشد، پردازش خواهد شد.


       RUNTIME CONFIGURATION FILES
              شما همچنین می‌توانید فایل‌های پیکربندی زمان اجرا را مشخص کنید که
              tidy تلاش خواهد کرد پیکربندی را به‌طور خودکار از آن‌ها بارگذاری
              کند.

              فایل پیکربندی زمان اجرای سیستم (/etc/tidy.conf)، در صورت وجود،
              ابتدا بارگذاری و اعمال خواهد شد و پس از آن فایل پیکربندی زمان
              اجرای کاربر (~/.tidyrc) اعمال می‌شود. استفاده‌های بعدی از یک گزینه
              مشخص، هرگونه استفاده قبلی را بازنویسی خواهد کرد.

              توجه داشته باشید که اگر از متغیر محیطی HTML_TIDY استفاده کنید،
              فایل پیکربندی زمان اجرای کاربر استفاده نخواهد شد. این یک قابلیت
              است، نه یک اشکال (باگ).


وضعیت خروج (EXIT STATUS)
       0      تمام فایل‌های ورودی با موفقیت پردازش شدند.

       1      هشدارهایی وجود داشت.

       2      خطاهایی رخ داد.


همچنین ببینید (SEE ALSO)
       برای اطلاعات بیشتر درباره HTML Tidy:

           http://www.html-tidy.org

       برای اطلاعات بیشتر درباره HTML:

           HTML: Edition for Web Authors (جدیدترین مشخصات HTML)
           http://dev.w3.org/html5/spec-author-view

           HTML: The Markup Language (مرجع زبان HTML)
           http://dev.w3.org/html5/markup

       برای گزارش باگ‌ها و نظرات:

           https://github.com/htacg/tidy-html5/issues

       یا پرسش‌ها و نظرات خود را به public-htacg@w3.org ارسال کنید.

       اسناد HTML خود را با استفاده از W3C Nu Markup Validator اعتبارسنجی
       کنید:

           http://validator.w3.org/nu

نویسندگان (AUTHORS)
       Tidy توسط Dave Raggett <dsr@w3.org> نوشته شده است، و متعاقباً توسط تیمی
       در http://tidy.sourceforge.net نگهداری شد، و اکنون توسط HTACG
       (http://www.htacg.org) نگهداری می‌شود.

       کدهای منبع HTML Tidy تحت مجوز MIT در https://github.com/htacg/tidy-
       html5 در دسترس است.

HTML Tidy                           5.7.45                             TIDY(1)