OriginalSeite Ekke / HTML Tidy in Deutsch / Schnell Referenz


Schnell Referenz

HTML Tidy Konfigurations-Optionen

HTML, XHTML, XML
Diagnose
Formatierung
Zeichen-Codierung
Verschiedenes
Neues / Unbekanntes

HTML, XHTML, XML OptionenNach oben
Option Typ Standard

add-xml-decl

Boolean

no

add-xml-pi

Boolean

no

add-xml-space

Boolean

no

alt-text

Text

 

assume-xml-procins

Boolean

no

bare

Boolean

no

break-before-br

Boolean

no

clean

Boolean

no

doctype

DocType

auto

drop-empty-paras

Boolean

yes

drop-font-tags

Boolean

no

drop-proprietary-attributes

Boolean

no

enclose-block-text

Boolean

no

enclose-text

Boolean

no

escape-cdata

Boolean

no

fix-bad-comments

Boolean

yes

fix-uri

Boolean

yes

hide-comments

Boolean

no

hide-endtags

Boolean

no

indent-cdata

Boolean

no

input-xml

Boolean

no

join-classes

Boolean

no

join-styles

Boolean

yes

logical-emphasis

Boolean

no

lower-literals

Boolean

yes

ncr

Boolean

yes

new-blocklevel-tags

Tag Namen

 

new-empty-tags

Tag Namen

 

new-inline-tags

Tag Namen

 

new-pre-tags

Tag Namen

 

numeric-entities

Boolean

no

output-html

Boolean

yes

output-xhtml

Boolean

no

output-xml

Boolean

no

quote-ampersand

Boolean

yes

quote-marks

Boolean

no

quote-nbsp

Boolean

yes

repeated-attributes

-

keep-last

replace-color

Boolean

no

show-body-only

Boolean

no

slide-style

Name

 

split

Boolean

no

uppercase-attributes

Boolean

no

uppercase-tags

Boolean

no

word-2000

Boolean

no

 
Diagnose OptionenNach oben
Option Typ Standard

show-errors

Ganzzahl

6

show-warnings

Boolean

yes

 
Formatierungs OptionenNach oben
Option Typ Standard

indent

AutoBool

no

indent-attributes

Boolean

no

indent-spaces

Ganzzahl

2

literal-attributes

Boolean

no

markup

Boolean

yes

tab-size

Ganzzahl

8

wrap

Ganzzahl

68

wrap-asp

Boolean

yes

wrap-attributes

Boolean

no

wrap-jste

Boolean

yes

wrap-php

Boolean

yes

wrap-script-literals

Boolean

no

wrap-sections

Boolean

yes

 
Zeichen-Codierungs-OptionenNach oben
Option Typ Standard

ascii-chars

Boolean

yes

char-encoding

Codierung

ascii

input-encoding

Codierung

latin1

language

Language

 

output-bom

AutoBool

auto

output-encoding

Codierung

ascii

newline

enum

hängt vom Betriebssystem ab

 
VerschiedenesNach oben
Option Typ Standard

fix-backslash

Boolean

yes

output-file

Text

 

error-file

Text

 

force-output

Boolean

no

gnu-emacs

Boolean

no

quiet

Boolean

no

keep-time

Boolean

yes

write-back

Boolean

no

tidy-mark

Boolean

yes

 
Neues / UnbekanntesNach oben
Option Typ Standard

gnu-emacs-file

Text

 

css-prefix

Name

"c"

accessibility-check

Ganzzahl

0

vertical-space

Boolean

no

punctuation-wrap

Boolean

no

 

 
 

HTML, XHTML, XML Optionen
 
add-xml-decl

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

 

Es wird die XML-Deklaration ergänzt, wenn die Ausgabe nach XML oder XHTML erfolgt. Beachte, daß diese Option ignoriert wird, wenn die Eingabe bereits eine <?xml ... ?> -Deklaration enthält.
Nur bis zur Version "1st January 2003", dannach muß add-xml-pi verwendet werden!

 
add-xml-pi

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

 

Es wird die XML-Deklaration ergänzt, wenn die Ausgabe nach XML oder XHTML erfolgt. Beachte, daß diese Option ignoriert wird, wenn die Eingabe bereits eine <?xml ... ?> -Deklaration enthält.
Ab Version "1st February 2003" ist diese Option, statt der Option add-xml-decl zu verwenden!
(Sie war aber schon mal bis Version "1st July 2002" enthalten.)

 
add-xml-space

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

 

Ergänzt xml:space="preserve" zu Elementen wie <PRE>, <STYLE> und <SCRIPT> wenn XML erzeugt wird. Dies ist für die korrekte Darstellung der Freiräume in diesen Elementen nötig, wenn kein DTD-Zugriff möglich ist.

 
alt-text

Typ: Text
Standard: -nichts-

 

Legt den Srandard-Text für das "alt=" -Attribut bei <IMG>-Tag's fest. Diese Option birgt die Gefahr, daß überall ein nichts-sagender Alternativ-Text steht, zumal damit die Warungen, daß das "alt=" -Attribut fehlt, ausbleiben. Sie verantworten das Erscheinungsbild Ihrer Seite bei Leuten, die die Bilder nicht sehen können!

 
assume-xml-procins

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

 

Weist den Analyseprozeß an den Terminator ?> vor dem > zu verlangen. Diese Option ist automatisch gesetzt, wenn die Eingabe XML ist.

 
bare

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Eine Microsoft spezifische HTML aus einem Word 2000 Dokument soll 'entrümpelt' werden. In der Ausgabe erscheinen dann Leerzeichen-ohne-Umbruch (non-breaking spaces) als 'normales' Leerzeichen, soweit diese in der Eingabe enthalten sind. Mit dieser Option werden sie in "normale" Leerzeichen (bei ihnen ist auch ein Zeilenumbruch erlaubt) umgewandelt.

Ersetzt drucktechnisch korrekte (=typographisch) Anführungs-Zeichen, Gedankenstriche usw.

Zeichen Beschreibung Name in HTML Unicode in HTML
drucktechnisch korrekte Anführungs-Zeichen
einfaches Anführungszeichen links &lsquo; &#8216;
einfaches Anführungszeichen rechts &rsquo; &#8217;
doppeltes Anführungszeichen links &ldquo; &#8220;
doppeltes Anführungszeichen rechts &rdquo; &#8221;
drucktechnisch nicht korrekte Anführungs-Zeichen
" doppeltes Anführungszeichen oben &quot; &#34;
' einfaches Anführungszeichen oben &apos; (NUR in XML) &#39;
Gedankenstriche
Gedankenstrich Breite n &ndash; &#8211;
Gedankenstrich Breite m &mdash; &#8212;
"Leeres"
leer &empty; &#8709;
Leerzeichen Breite n &ensp; &#8194;
Leerzeichen Breite m &emsp &#8195;

Siehe dazu auch: Tidy und FrontPageVersuch von einem Word-Dokument zu einem "sauberen" HTML/XHTML-Dokument
HTML Tidy: Word HTML-Dateien bändigen und kostenloser MS HTML-Filter 2.1 für Office 2000.
break-before-br

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

In der Ausgabe wird vor jedem <BR> ein Zeilenumbruch eingefügt, wenn noch nicht vorhanden.

clean

Typ : Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

enclose-text
css-prefix
ascii-chars
output-bom
quote-nbsp
bare

Ersetzt physische Tag's (<font>,<nobr>und <center>) und Attribute durch ihre CSS-Entsprechung bzw. strukturelle TAG's. Ist besonders wirkungsvoll bei HTML, was mit Microsoft Office Produkten (MS-Office '97 bzw 2000) erzeugt wurde. Setze auch
drop-font-tags = yes (für <font> und <center>),
logical-emphasis = yes (für <i> -zu-> <em>, <b> -zu-> <strong>) dieses setzt clean=yes,
word-2000 = yes ,
drop-proprietary-attributes = yes .

 

doctype

Typ: DocType
Standard: auto
Beispiel: auto, omit, strict, loose, transitional, formale Zeichenkette (Text)

Legt fest, wie Tidy mit der DOCTYPE Deklaration umgehen soll.
"omit"   - läßt sie so wie sie ist, soweit eine vorhanden ist. Sonst wird auch keine hinzu gesetzt.
              Setzt automatisch numeric-entities = yes !
"auto"   - Setzt eine Deklaration, die vom Inhalt des Dokumentes abgeleitet(vermutet) wird.
"strict"  - Setzt eine Deklaration genau nach DTD.
"loose"  - Setzt eine Deklaration nicht ganz genau nach DTD (transitional=übergangsweise, vorübergehend).
Alternativ kann eine formale Zeichenkette eingegeben werden (formal public identifier = FPI).
Entspricht der Kommandozeile: tidy.exe --doctype auto

Zum Beispiel:

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

Wenn Sie eine formale Zeichenkette (formal public identifier = FPI) für ein XHTML Dokument angeben, setzt Tidy die Systemidentifikation auf diese eingegeben Zeichenkette. Tidy läßt den DOCTYPE bei der Generierung des XML-Dokumentes unverändert.

drop-empty-paras

Typ: Boolean
Standard: yes
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Entfernt leere <p> </p> (also leere Paragraphen). Wenn dies auf "no" gesetzt ist, werden diese durch <br><br> Elemente ersetzt, da HTML 4 leere Paragraphen nicht zuläßt.

drop-font-tags

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Ersetzt (entfernt) die Tag's <font> und <center> durch ihre CSS-Entsprechungen. Wirkt nur wenn clean = yes gesetzt ist.
Entspricht der Kommandozeile: tidy.exe --drop-font-tags yes

drop-proprietary-attributes

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Entfernt urheberrechtlich geschützte (=propritäre) Attribute, wie z.B."MS date binding"-Attribute.

enclose-block-text

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Text in beliebigen Elementen immer mit <P> umschließen. Ohne <P>-Umschließung ist zwar in "HTML transitional" zulässig, aber kein striktes(sauberes) HTML.

enclose-text

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Text zwischen <body>...</body>-Element immer mit <p>...</p> umschließen. Sinnvoll, wenn CSS verwendet werden soll.

escape-cdata

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Konvertiert <![CDATA[]]>-Abschnitte in normalen Text. (CDATA steht für Character Data.)

fix-bad-comments

Typ: Boolean
Standard: yes
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Ersetzt zu viele Bindestriche in Kommentaren durch das "="-Zeichen, korregiert damit "falsche" Kommentare. Standard ist yes. Ist für "Cold Fusion"-Benutzer gedacht, wo die Kommentar-Syntax
<!--- ---> (3 statt je 2 Bindestriche) ist.

fix-uri

Typ: Boolean
Standard: yes
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Wenn unzulässige Zeichen in URI's von Attribut-Werten enthalten sind, werden sie nach der HTML 4 Empfehlung umgeformt. Damit werden falsche Adressformate korregiert.

hide-comments

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Läßt Kommentare weg (entfernt sie).
Vorsicht!!: In Phase 5 geht dann die Include-Technik nicht mehr!

hide-endtags

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Läßt die optionalen Ende-Tags bei der Generierung weg (entfernt sie). Dies wird ignoriert, wenn die Ausgabe auf XML eingestellt ist.

indent-cdata

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

<![CDATA[]]>-Abschnitte werden eingerückt.

input-xml

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Kennzeichnet das Eingabedokument als XML. Damit wird die XML-Syntaxanalyse vor der HTML-Syntax-Fehler-Korrektur durchgeführt.
Entspricht der Kommandozeile: tidy.exe --input-xml yes

join-classes

Typ : Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

join-styles
repeated-attributes

Wenn mehrfach einem Element "class"-en zugewiesen wurden, werden diese zu einer einzigen neuen "class" zusammengefaßt.

 

join-styles

Typ: Boolean
Standard: yes
Beispiel: y/n, yes/no, t/f, true/false, 1/0

join-classes
repeated-attributes

Wenn mehrfach einem Element "style"-Werte zugewiesen wurden, werden diese zu einem einzigen neuen "style"-Wert zusammengefaßt.

logical-emphasis

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Die physischen Tag's <i> und <b> werden durch die logischen Tags <em> beziehungsweise <strong> ersetzt. Deren Attribute bleiben aber erhalten. Wenn diese Option auf yes gesetzt wird, wird clean und drop-font-tags ebenfalls auf yes gesetzt.
Entspricht der Kommandozeile: tidy.exe --logical-emphasis yes

Phyisische Tag's haben Bedeutungen wie "fett" oder "kursiv", stellen also direkte Angaben zur gewünschten Schriftformatierung dar. Bei physischen Tag's sollte der Web-Browser eine Möglichkeit finden, den so ausgezeichneten Text entsprechend darzustellen. (siehe SELFHTML8.0/html/text/physisch.htm#elemente)

Bei logischen Tag's entscheidet der Web-Browser, wie ein solcher Text hervorgehoben wird (z.B. fett, kursiv oder andersfarbig). (siehe SELFHTML8.0/html/text/logisch.htm#elemente)

lower-literals

Typ: Boolean
Standard: yes
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Konvertiert vordefinierte Attribut-Werte in Kleinbuchstaben. Dies ist bei XHTML-Dokumenten notwendig.

 

ncr

Typ : Boolean
Standard: yes
Beispiel: y/n, yes/no, t/f, true/false, 1/0

numeric-entities

Nummerische Zeichen-Referenzen werden zugelassen.
Also alles was mit '#' beginnt. Selbst wenn ncr = no ist,
werden nummerische Zeichen-Referenzen bei big5 und shiftjis akzeptiert.

ncr = numeric character references

 

new-blocklevel-tags

Typ: Tag Namen
Standard: -nichts-
Beispiel: tagX, tagY, ...

Eine Komma- oder Leerzeichen-getrennte Liste von neuen Blocklevel-Tag's. Es wird keine bereinigte Ausgabe erzeugt, wenn in der Eingabe unbekannte Tag's existieren. Beachte, daß für solche Elemente wie <TABLE>, <UL>, <OL> und <DL> das Inhalts-Modell nicht geändert werden kann.

new-empty-tags

Typ: Tag Namen
Standard: -nichts-
Beispiel: tagX, tagY, ...

new-blocklevel-tags
new-inline-tags

Eine Komma- oder Leerzeichen-getrennte Liste von neuen leeren Inline-Tag's. Es wird keine bereinigte Ausgabe erzeugt, wenn in der Eingabe unbekannte Tag's existieren. Leere Tags können nur als Inline- oder Blocklevel-Tag's vereinbart werden.

new-inline-tags

Typ: Tag Namen
Standard: -nichts-
Beispiel: tagX, tagY, ...

Eine Komma- oder Leerzeichen-getrennte Liste von neuen nicht-leerer Inline-Tag's. Es wird keine bereinigte Ausgabe erzeugt, wenn in der Eingabe unbekannte Tag's existieren.

new-pre-tags

Typ: Tag Namen
Standard: -nichts-
Beispiel: tagX, tagY, ...

Eine Komma- oder Leerzeichen-getrennte Liste von neuen <PRE>-Tag's. Mit "<PRE>-Tag's" sind Tag's gemeint, die sich genauso wie das HTML-Element <PRE> verhalten. Es wird keine bereinigte Ausgabe erzeugt, wenn in der Eingabe unbekannte Tag's existieren. Es können nicht, wie bisher, neue CDATA-Elemente (ähnlich dem <SCRIPT>) hinzugefügt werden.

 

numeric-entities

Typ : Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

ncr

Statt der vordefinierten benannten Zeichen (&amp; , &lt; , &gt; , &quot; usw.) die nummerischen Zeichen verwenden.

 

output-html

Typ : Boolean
Standard: yes
Beispiel: y/n, yes/no, t/f, true/false, 1/0

 

Ausgabe in reinem HTML, vorbereitet als Eingabe zu XHTML.
=yes bedeutet, daß es ausdrücklich gesetzt wurde.
Bei =yes werden output-xhtml=no und output-xml=no gesetzt.
Bei =no werden uppercase-attributes=no und uppercase-tags=no gesetzt.

Entspricht der Kommandozeile: tidy.exe --output-html yes

 

output-xhtml

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Ausgabe in XHTML (=extensible HTML= erweitertes HTML). Dies bewirkt, daß der DOCTYPE und Standard Namensraum (=namespace) für XHTML entsprechend gesetzt wird. Sind DOCTYPE oder Standard Namensraum vorgegeben, dann wird auf dessen Entsprechung geprüft. Entspricht es dem nicht, so wird der korrekte Wert angezeigt. In XHTML können die Zeichen als benannten oder nummerische Zeichen eingetragen werden, dies wird eben mit der Option "numeric-entities" festgelegt. Die Groß/Kleinschreibung der Tags und Attribute bleiben erhalten, ungeachtet anderer Optionen.
Entspricht der Kommandozeile: tidy.exe --output-xhtml yes

output-xml

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Ausgabe in XML. (=extensible HTML= erweitertes HTML). Alle Zeichen die nicht in XML 1.0 definiert sind werden in nummerische Zeichen umgeformt. Die Groß/Kleinschreibung der Tags und Attribute bleiben erhalten, ungeachtet anderer Optionen.
Entspricht der Kommandozeile: tidy.exe --output-xml yes

quote-ampersand

Typ: Boolean
Standard: yes
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Unmaskiertes & -Zeichen wird maskiert mit benanntem Zeichen &amp;.

quote-marks

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Unmaskierte Doppelhochkommata (=Anführungszeichen,Gänsefüsschen) werden maskiert mit benanntem Zeichen &quot;. Unmaskierte Einfachhochkomma (Apostroph) werden maskiert mit nummerischen Zeichen &#39;. Korrekt wäre &apos; , da aber viele Browser dies nicht unterstützen, wird hier das nummerische Zeichen &#39; verwendet.

quote-nbsp

Typ: Boolean
Standard: yes
Beispiel: y/n, yes/no, t/f, true/false, 1/0

nbsp = non-breaking space = geschützes Leerzeichen
&nbsp; wird durch Unicode-160 ( &#160; ) ersetzt.

repeated-attributes

Typ: -
Standard: keep-last
Beispiel: keep-first, keep-last

join-classes
join-styles

Hält fest das erste oder letzte Attribut, wenn ein Attribut sich wiederholt, z.B. zwei align-Attribute.

replace-color

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Bei =yes werden nummerische Farb-Werte durch ihre Farb-Namen ersetzt.
z.B.: "#ffffff" wird ersetzt durch "white"
Von =yes ist aber abzuraten, da nicht alle Farb-Namen von allen Browsern "verstanden" werden.

show-body-only

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Ausgabe nur des BODY-Tag-Inhaltes als HTML-Fragment. Sinnvoll wenn man mehrere vereinzelte HTML-Seiten zu einer "großen" Seite zusammenfassen möchte.

slide-style

Typ: Name
Standard: -nichts-

split

Derzeit noch nicht verwendet! Stil der "Dia-Show".

split

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Erzeugt eine Folge von "Dia's" (oder "Präsentations-Folien-Folge" wie in MS PowerPoint) von der Eingabe. Immer wenn <H2> gefunden wird, wird eine neue "slide???.html" erzeugt. Die "Dia's" sind dann zu finden in "slide001.html", "slide002.html" usw. .
Für größßere HTML-Dokumente die zwecks Präsentation in einzelne Folien(Dia's) gebracht werden sollen. Auf jeder Folie befinden sich dann Links zur vorigen, ersten und nächten Folie.
Entspricht der Kommandozeile: tidy.exe -slides

uppercase-attributes

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Attribut-Namen in GROSSBUCHSTABEN umformen. Standard ist "no", wo die Attribut-Namen in kleinbuchstaben umgeformt werden, Ausnahme bei XML-Eingabe, dort bleibt die Groß/Kleinschreibung erhalten.

uppercase-tags

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Tag-Namen in GROSSBUCHSTABEN umformen. Standard ist "no", wo die Tag-Namen in kleinbuchstaben umgeformt werden, Ausnahme bei XML-Eingabe, dort bleibt die Groß/Kleinschreibung erhalten.
Entspricht der Kommandozeile: tidy.exe -upper

word-2000

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Entfernt die Microsoft-Word-2000-eigenen Auszeichnungen von "als Webseite" gespeicherten Dokumenten. Verarbeitet aber keine eingebeteten Bilder oder VML.

VML = "Vector Markup Language" ist als eine Erweiterung von XML zu verstehen und definiert ein Format zur Kodierung von Vektor-Informationen im Internet.

Microsoft-Word-97/2000-Webseiten enthalten Tag's, die sogar eigene Namensräume belegen und nicht mit dem HTML-Standard vereinbar sind. Durch deren Entfernung wird die Darstellung des Dokumentes nicht schädlich beeinflusst. Mit dem kostenlosen MS HTML-Filter 2.1 für Office 2000 sollten auch Webseiten mit "schlankem" gültigem HTML erzeugt werden können.

Siehe dazu auch: Tidy und FrontPageVersuch von einem Word-Dokument zu einem "sauberen" HTML/XHTML-Dokument
HTML Tidy: Word HTML-Dateien bändigen .

Entspricht der Kommandozeile: tidy.exe --word-2000 yes

 
 

Diagnose Optionen
show-errors

Typ: Ganzzahl
Standard: 6
Beispiel: 0, 1, 2, ...

Fehlerempfindlichkeit. Bei 0 werden gar kein Fehler angezeigt.

show-warnings

Typ: Boolean
Standard: yes
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Bei =no werden die Warungen unterdrückt. Damit kann man vereinzelte Fehler zwischen vielen Warungen besser finden.

 
 

Formatierungs Optionen

indent

Typ: AutoBool
Standard: no
Beispiel: auto, y/n, yes/no, t/f, true/false, 1/0

indent-spaces

Blocklevel Tag's einrücken. Bei "auto" erfolgt eine Einrückung der Tag's, wie TITLE, H1-H6, LI, TD und P, abhängig davon, ob diese ein Blocklevel Tag beinhalten. Es ist von "yes" abzuraten, da einige Browser Bugs in der Darstellung produzieren. Tabellen-Elemente (bis auf TD) werden nicht eingerückt.
Entspricht der Kommandozeile: tidy.exe -indent

indent-attributes

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Jedes Attribut beginnt in einer neuen Zeile (und eingerückt).

indent-spaces

Typ: Ganzzahl
Standard: 2
Beispiel: 0, 1, 2, ...

indent

Anzahl der Leerzeichen, die bei Einrückungen verwendet werden soll.
= Einrück-Abstand = Einzug

literal-attributes

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Leerraumzeichen (Leerzeichen, Tabulatoren) bleiben in den Attribut-Werten unverändert.

markup

Typ: Boolean
Standard: yes
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Generierte eine gut formatierte Version der Quelltextauszeichnung. Die "gut formatierte Version" wird nicht generiert, wenn gravierende Fehler gefunden werden. Zum erzwingen "gut formatierte Version" siehe force-output .

tab-size

Typ: Ganzzahl
Standard: 8
Beispiel: 0, 1, 2, ...

Wieviel Spalten zwischen den Tabulatoren verwendet werden sollen. Dies wird bereits beim Lesen der Eingabe verwendet. Es werden niemals Tabulatoren ausgegeben.

wrap

Typ: Ganzzahl
Standard: 68
Beispiel: 0 (keinen Zeilenumbruch), 1, 2, ...

Maximale Zeilenlänge. Wird diese überschritten, so wird versucht die Zeile umzubrechen, so daß diese Länge nicht überschritten wird. Setze den Wert auf 0, wenn der Zeilenumbruch nicht erfolgen soll.

wrap-asp

Typ: Boolean
Standard: yes
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Auch Zeilenumbruch in Text mit ASP pseudo Elementen wie: <% ... %>.
ASP = Active Server Pages = Microsoft's Konzept für dynamische Web-Seiten, deren Inhalte serverseitig generiert werden.

wrap-attributes

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

wrap-script-literals

Zeilenumbruch bei Attribut-Werten für einfacheres Bearbeiten. Bei =yes wird auch wrap-script-literals=yes gesetzt.

wrap-jste

Typ: Boolean
Standard: yes
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Auch Zeilenumbruch in Text mit JSTE pseudo Elementen wie: <# ... #>.
JSTE = ??

wrap-php

Typ: Boolean
Standard: yes
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Auch Zeilenumbruch in Text mit PHP pseudo Elementen wie: <?php ... ?>.
PHP = Professionell HomePages =oder= Hypertext Preprocessor =oder= Personal Homepage Tools =oder= Professional Homepage = Ist eine kostenlose, serverseitige, in HTML-Code eingebettete Scriptsprache für Internet-Server, um dynamische Websites zu erzeugen.

wrap-script-literals

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

wrap-attributes

Auch Zeilenumbruch in Zeichenketten von Script-Attributen. Vor dem Umbruch wird jeweils ein \ (Backslash) eingefügt.

wrap-sections

Typ: Boolean
Standard: yes
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Auch Zeilenumbruch in Text mit <![ ... ]> Abschnitts-Tag's.

 
 

Zeichen-Codierungs-Optionen

ascii-chars

Typ: Boolean
Standard: yes
Beispiel: y/n, yes/no, t/f, true/false, 1/0

char-encoding

Modifiziert das Verhalten der clean (-c --clean yes) Option. Standardmäßig ist es auf "yes" gesetzt, wenn -c verwendet wird. Setze es auf "no" um die Konvertierung von "Benannte Zeichen für Interpunktion" wie >mdash; (=Gedankenstrich Breite m) und &rdquo;(=doppeltes Anführungszeichen rechts) in ihre ASCII-Entsprechung zu verhindern.

char-encoding

Typ: Codierung
Standard: ascii
Beispiel: ascii, latin1, raw, utf8, iso2022, mac, win1252, utf16, utf16le, utf16be, big5, shiftjis

input-encoding
output-encoding

Angabe welche Zeichencodierung bei der Ein- und Ausgabe verwendet wird. Bei "ascii" sind Latin-1 (ISO-8859-1) Zeichen zulässig, allerdings für Zeichen, die größer als 127 sind, werden die entsprechenden benannten/nummerischen Zeichen verwendet. Bei "raw", werden die Zeichen größer 127 nicht in ihre entsprechenden benannten/nummerischen Zeichen übersetzt. Bei "latin1" werden die Zeichen größer 255 in ihre entsprechenden benannten/nummerischen Zeichen umgeschrieben. Bei "utf8, utf16, utf16le, utf16be" wird angenommen, daß Ein- und Ausgabe in UTF-8, UTF-16 codiert sind. Für Dateien, die mit einer der ISO-2022 Familie (z.B. ISO-2022-JP) codiert sind, kann "iso2022" verwendet werden. Bei "mac" und "win1252" sind herstellerspezifische Zeichen zulässig, jedoch auch hier werden für alle Zeichen größer 127 ihre entsprechenden benannten/nummerischen Zeichen verwendet.

UTF = universal text format = Unicode Transformation Format
UTF-8 = internationaler Zeichensatz auf Basis der ISO/IEC-10646-Norm (Unicode) mit 8 Bit Zeichenbreite, d.h. ein Byte in der Datei entspricht einem Zeichen; nach RFC 2044 (UTF-8, a transformation format of Unicode and ISO 10646) können es auch spezielle Code's mit bis zu 6 Byte sein.
UTF-16 = internationaler Zeichensatz auf Basis der ISO/IEC-10646-Norm (Unicode) mit 16 Bit Zeichenbreite, d.h. zwei Byte in der Datei entsprechen einem Zeichen

Entspricht der Kommandozeile: tidy.exe --char-encoding ascii

input-encoding

Typ: Codierung
Standard: latin1
Beispiel: ascii, latin1, raw, utf8, utf16, utf16le, utf16be, iso2022, mac, win1252, big5, shiftjis

char-encoding

Angabe welche Zeichencodierung bei der Eingabe verwendet wird. Weitere Informationen sind unter char-encoding zu finden.

language

Typ: Language
Standard: -nichts-
Beispiel: de, en, fr, ja, zh

Entspricht der Kommandozeile: tidy.exe --language zh
Entspricht der Kommandozeile: tidy.exe --lang zh
Bei ja = japanisch und zh = chinesisch erfolgt ein anderer Zeilenumbruch,
wenn wrap gesetzt ist.

Derzeit (Version vom 01.11.2003) nicht unterstützt!
Zum Setzen des 2-Buchstaben-Sprach-Codes <lang>.
Angabe, welche Sprache (auch bei den Meldungen) verwendet wird.
de = deutsch; en = englisch; fr = französich; ja = japanisch; zh = chinesisch

output-bom

Typ: AutoBool
Standard: auto
Beispiel: auto, y/n, yes/no, t/f, true/false, 1/0

NUR bei UTF-8 bzw. UTF-16 Ausgabe-Codierung wird ein Unicode Byte-Orientierungs-Marke (=BOM; auch "Zero Width No-Break Space"; mit dem Wert U+FEFF) am Anfang der Ausgabe geschrieben. Bei "auto" wird die BOM nur geschrieben, wenn auch die Eingabe eine BOM enthielt. Bei einer XML/XHTML-Ausgabe in UTF-16 wird eine BOM immer geschrieben.
BOM = Byte Order Mark = Byte-Orientierungs-Marke
ZWN BSP = Zero Width No-Break Space = Null-Breite nicht-umbruch-Raum
Siehe dazu "Arabic Presentation Forms-B" www.unicode.org/charts/PDF/UFE70.pdf Seite 6 unten

output-encoding

Typ: Codierung
Standard: ascii
Beispiel: ascii, latin1, raw, utf8, iso2022, mac, win1252, utf16, utf16le, utf16be, big5, shiftjis

char-encoding

Angabe welche Zeichencodierung bei der Ausgabe verwendet wird. Weitere Informationen sind unter char-encoding zu finden. Nur bei einer Latin-Eingabe-Codierung (also input-encoding gleich eines von "ascii, latin1, mac, win1252") darf hier ein anderer Wert gesetzt werden!

newline

Typ: Enum
Standard: Betriebssystem-abhängig
Beispiel: LF, CRLF, CR

Der Standardwert hängt vom aktuellen Betriebssystem ab:
CRLF  bei Windows und OS/2,
CR     bei dem Mac und
    LF  bei allen anderen (wie z.B. Unix und Linux).

 

 
 

Verschiedenes
fix-backslash

Typ: Boolean
Standard: yes
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Ersetzt \ (=Backslash) Zeichen durch / (=forward slash) in URL's.

output-file

Typ: Text
Standard: -nichts-

error-file

Weist Tidy eine bestimmte Ausgabe-Datei zu. Normalerweise wird nach "stdout" geschrieben (=die Standard-Ausgabe).

error-file

Typ: Text
Standard: -nichts-

Angabe der Fehler-Datei, in die die Fehler- und Warn-Meldungen ausgegeben werden. Normalerweise werden sie zu "stderr" ausgegeben.

force-output

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Erzeugt eine Ausgabe-Datei, auch wenn Fehler gefunden wurden. Dies ist mit Vorsicht zu verwenden, denn wenn die automatische Fehlerkorrektur mißlang oder unsicher war, kann die Ausgabe von der Eingabe wesentlich abweichen.

gnu-emacs

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Ausgabe der Fehler und Warnungen in einem Format, was im GNU Emacs gut lesbar ist.
"Normales" Ausgabe-Format: "Zeile ZZ Spalte SS - ERLÄUTERUNG"
"Emacs" Ausgabe-Format: "EmacsDateiName:ZZ:SS: ERLÄUTERUNG"

GNU Emacs = Ist ein freier UNIX/LINUX-Editor, auch :
DECMACS = GNU Emacs für DOS
WINEMACS = GNU Emacs für Windows
oder "Xemacs"

quiet

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Unterdrückt unwichtige Meldungen, wie Gesamtanzahl der Fehler und Warungen sowie Begrüßungs- und Informations-Meldungen.

keep-time

Typ: Boolean
Standard: yes
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Behält das letzte-änderungs-Datum der originalen Eingabe-Datei bei, wenn sie durch die Ausgabe direkt modifiziert(=überschrieben) wird. Die meisten Upload-Tool's wie z.B. "SiteCopy" laden dadurch die Datei nicht erneut auf den Web-Server hoch. Diese Option funktioniert aber nicht auf allen Plattformen.

write-back

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Schreibt die gesäuberte Version(=Ausgabe) in die gleiche Datei der Eingabe (überschreibt sie also). Es sollte zuvor immer erst eine Sicherungskopie von der zu säubernden Datei erstellt werden, für den seltenen Fall, daß die gesäuberte Version, nicht dem Gewünschten entspricht.

tidy-mark

Typ: Boolean
Standard: yes
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Tidy Meta-Tag hinzufügen. Es wird keins hinzugefügt, wenn bereits ein Meta-Tag vorhanden ist.

 
 

Neues / Unbekanntes
gnu-emacs-file

Typ: Text
Standard: -nichts-
Beispiel: -

Wenn gnu-emacs=yes ist, kann hier die "gnu-emacs"-Ausgabedatei angegeben werden.

css-prefix

Typ: Name
Standard: "c"
Beispiel: CSS1 Selector

Bei der Option clean = yes werden CSS-Definitionen standardmäßig nach dem Muster c1, c2, c3, ... erzeugt.
Hier haben Sie die Möglichkeit für dieses "c" eine andere Zeichenkette einzugeben.
Diese wird aber mit einem Bindstrich ("-") ergänzt und dann "hochgezählt".
z.B. ="MyCss" würde dann ergeben MyCss-1, MyCss-2, MyCss-3, ...
maximal sind 255 Zeichen incl.Bindestrich und Nummern-Zeichen zulässig
Diese Option ist noch in der Entwicklung/Austestung siehe Näheres dazu bei
[ #508936 ] Parse CSS Selector prefix in config file

vertical-space

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Bei =yes ergänzt Tidy einige Leerzeilen, für eine bessere Lesbarkeit der "gut formatierten Quelltextauszeichnung".

So vor <hr> , <pre> , <textarea> und vor allen reinen html-Tag's.

punctuation-wrap

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0

Wenn die Ausgabe-Codierung in utf8, utf16, utf16le, utf16be oder big5 (=Chinesisch) erfolgt,
dann wird ein Zeilenumbruch bei Interpunktionszeichen,
wie Gedanken-, Trenn-Strich, Punkt, Anführungszeichen usw. , ergänzt.

accessibility-check

Typ: Ganzzahl
Standard: 0
Beispiel: 0, 1, 2, 3

Führt einen Zugänglichkeits-Check durch für z.B. binde oder taube Menschen.

0 = keinen Zugänglichkeits-Check durchführen (=Standard)
1 = prüft:
    - <img>, <applet>, <object>, <frame>, <area>, serverseitige verweis-sensitive Grafik
      auf "alt", "longdesc" Text und D-Link
    - korrekte Beschreibung zu Verweisen mit Ton/Musik-Dateien
    - <script> auf <noscript>-Abschnitt
    - korrekte Beschreibung bei farblichen Informationen
    - ob Tabellen <th>, "headers", "scope", <colgroups>, <thead> haben
    - ob <frame>-Quelle OK ist
    - usw.
    -
2 = prüft 1 und :
    - usw.
    -
3 = prüft 1, 2 und :
    - usw.
    -

Einzelheiten zu den drei Prioritäten sind unter HTML Tidy's Zugänglichkeits-Werkzeug zu finden!

Der Autor distanziert sich ausdrücklich vom Inhalt aller externen Links und Verweise.
Er übernimmt keine Gewähr oder Haftung für
Vollständigkeit, Richtigkeit, Aktualität oder etwaige Schäden.