دستکاری فایل (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 باید متن درون برچسب‌های بخش <![ ... ]> را سطربندی کند یا خیر.