OriginalSeite bei-ekke / HTML Tidy in Deutsch / Schnell Referenz

Schnell Referenz

Automatisch erstellt mit HTML Tidy vom 18.06.2008.

HTML Tidy Konfigurations-Optionen

HTML, XHTML, XML
Diagnose
Formatierung
Zeichen-Codierung
Verschiedenes
in alten Versionen

HTML, XHTML, XML Optionen		Nach oben
Option	Typ	Standard
add-xml-decl	Boolean	no
add-xml-space	Boolean	no
alt-text	Text
anchor-as-name	Boolean	yes
assume-xml-procins	Boolean	no
bare	Boolean	no
clean	Boolean	no
css-prefix	Name	"c"
decorate-inferred-ul	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-backslash	Boolean	yes
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
literal-attributes	Boolean	no
logical-emphasis	Boolean	no
lower-literals	Boolean	yes
merge-divs	AutoBool	auto
merge-spans	AutoBool	auto
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
preserve-entities	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	AutoBool	no
uppercase-attributes	Boolean	no
uppercase-tags	Boolean	no
word-2000	Boolean	no

Diagnose Optionen		Nach oben
Option	Typ	Standard
accessibility-check	Ganzzahl	0
show-errors	Ganzzahl	6
show-warnings	Boolean	yes

Formatierungs Optionen		Nach oben
Option	Typ	Standard
break-before-br	Boolean	no
indent	AutoBool	no
indent-attributes	Boolean	no
indent-spaces	Ganzzahl	2
markup	Boolean	yes
punctuation-wrap	Boolean	no
sort-attributes	-	none
split	Boolean	no
tab-size	Ganzzahl	8
vertical-space	Boolean	no
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-Optionen		Nach oben
Option	Typ	Standard
ascii-chars	Boolean	yes
char-encoding	Codierung	ascii
input-encoding	Codierung	latin1
language	Language
newline	Ganzzahl	Betriebssystem abhängig
output-bom	AutoBool	auto
output-encoding	Codierung	ascii

Verschiedenes		Nach oben
Option	Typ	Standard
error-file	Text
force-output	Boolean	no
gnu-emacs	Boolean	no
gnu-emacs-file	Text
keep-time	Boolean	yes
output-file	Text
quiet	Boolean	no
slide-style	Name
tidy-mark	Boolean	yes
write-back	Boolean	no

in alten Versionen		Nach oben
Option	Typ	Standard
add-xml-pi	Boolean	no

HTML, XHTML, XML Optionen

add-xml-decl Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

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!

anchor-as-name

Nach oben

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

Löscht oder ergänzt das "name"-Attribut in Elementen, die als Anker (=anchor) dienen können z.B. im Anker-Tag <a>.
Bei "yes", wird das "name"-Attribut entsprechend dem "id"-Attribut ergänzt, wenn es noch nicht vorhanden ist und es nach der DTD zulässig ist.
Bei "no", wird jedes vorhandene "name"-Attribut entfernt, wenn ein "id"-Attribut vorhanden ist bzw. ergänzt wurde.

assume-xml-procins Nach oben

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 Nach oben

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	‘	‘
’	einfaches Anführungszeichen rechts	’	’
“	doppeltes Anführungszeichen links	“	“
”	doppeltes Anführungszeichen rechts	”	”
drucktechnisch nicht korrekte Anführungs-Zeichen
"	doppeltes Anführungszeichen oben	"	"
'	einfaches Anführungszeichen oben	' (NUR in XML)	'
Gedankenstriche
–	Gedankenstrich Breite n	–	–
—	Gedankenstrich Breite m	—	—
"Leeres"
∅	leer	∅	∅
	Leerzeichen Breite n	&ensp;
	Leerzeichen Breite m	&emsp

Siehe dazu auch: Tidy und FrontPage, Versuch 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 Nach oben

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 Nach oben

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 merge-divs merge-spans
( drop-font-tags logical-emphasis word-2000
drop-proprietary-attributes )

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 Nach oben

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 Nach oben

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 Nach oben

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

Ersetzt (entfernt) die Tag's <font> und <center> durch ihre CSS-Entsprechungen. Diese Einstellung ist unabhängig von clean .
Entspricht der Kommandozeile: tidy.exe --drop-font-tags yes

drop-proprietary-attributes Nach oben

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

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

enclose-block-text Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

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

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

input-xml Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

Typ: Boolean
Standard: no
Beispiel: y/n, yes/no, t/f, true/false, 1/0 clean
drop-font-tags

Die physischen Tag's <i> und <b> werden durch die logischen Tags <em> beziehungsweise <strong> ersetzt. Deren Attribute bleiben aber erhalten. Diese Einstellung kann unabhängig von clean und drop-font-tags gesetzt werden.
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 Nach oben

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.

merge-divs Nach oben

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

Zur Beeinflussung der Einstellung -c (--clean yes).
Faßt mehrfach verschachtelte <div> wie "<div><div>...</div></div>" zusammen.

Bei "auto" werden die Attribute des inneren <div> auf das äußere <div> übertragen.
Verschachtelte <div> mit einem ID-Attribut werden nicht zusammengefaßt.

Bei "yes" werden die Attribute des inneren <div> auf das äußere <div> mit der Erweiterung "class" und/oder "style" übertragen.

merge-spans Nach oben

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

Zur Beeinflussung der Einstellung -c (--clean yes).
Faßt mehrfach verschachtelte <span> wie "<span><span>...</span></span>" zusammen.

Bei "auto" werden die Attribute des inneren <span> auf das äußere <span> übertragen.
Verschachtelte <span> mit einem ID-Attribut werden nicht zusammengefaßt.

Bei "yes" werden die Attribute des inneren <span> auf das äußere <span> mit der Erweiterung "class" und/oder "style" übertragen.

ncr Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

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

Statt der vordefinierten benannten Zeichen (& , < , > , " usw.) die nummerischen Zeichen verwenden.

output-html Nach oben

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 Nach oben

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 Nach oben

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

preserve-entities Nach oben

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

Diese Einstellung weist Tidy an, die wohl-geformten maskierten Zeichen (=entitites wie numeric-entities, quote-ampersand, quote-marks, quote-nbsp, Umlaute &?uml;) der Eingabe-Datei beizubehalten.

quote-ampersand Nach oben

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

Unmaskiertes & -Zeichen wird maskiert mit benanntem Zeichen &.

quote-marks Nach oben

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 ". Unmaskierte Einfachhochkomma (Apostroph) werden maskiert mit nummerischen Zeichen '. Korrekt wäre ' , da aber viele Browser dies nicht unterstützen, wird hier das nummerische Zeichen ' verwendet.

quote-nbsp Nach oben

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

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

repeated-attributes Nach oben

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 Nach oben

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 Nach oben

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

Ausgabe nur des BODY-Tag-Inhaltes als HTML-Fragment. Bei "auto" wird es nur dann ausgeführt, wenn ein BODY-Tag in der Eingabe-Datei vorhanden ist. Sinnvoll wenn mehrere vereinzelte HTML-Seiten zu einer "großen" Seite zusammengefaßt werden sollen. Dies Einstellung hat keinen Effekt bei geforderter XML-Ausgabe.

slide-style Nach oben

Typ: Name
Standard: -nichts- split

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

split Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

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

Entfernt die Microsoft-Word-2000-eigenen Auszeichnungen von "als Webseite" gespeicherten Dokumenten. Verarbeitet aber keine eingebeteten Bilder oder VML. Es sollte besser Word's "als Webseite, gefiltert" verwendet werden.

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 FrontPage, Versuch 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 Nach oben

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

Fehlerempfindlichkeit. Bei 0 werden gar kein Fehler angezeigt.

show-warnings Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

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 ”(=doppeltes Anführungszeichen rechts) in ihre ASCII-Entsprechung zu verhindern.

char-encoding Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

Typ: Text
Standard: -nichts- error-file

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

error-file Nach oben

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 Nach oben

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 Nach oben

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"

gnu-emacs-file Nach oben

Typ: Text
Standard: -nichts-
Beispiel: -

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

quiet Nach oben

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 Nach oben

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 Nach oben

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 Nach oben

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.

css-prefix Nach oben

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
Siehe Näheres dazu bei
[ #508936 ] Usability: CSS class naming too simple | Parse CSS Selector prefix in config file | CSS class naming for -clean option
bzw. in http://tidy.sourceforge.net/test/tidy_test.tgz = Testdateien cfg_508936.txt & in_508936.html

decorate-inferred-ul Nach oben

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

This option specifies if Tidy should decorate inferred UL elements with some CSS markup to avoid indentation to the right.

vertical-space Nach oben

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 Nach oben

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.

sort-attributes Nach oben

Typ : -
Standard: none
Beispiel: none, alpha

Es werden die Attribute innerhalb eines Elementes (=Tag's) entsprechend der Angabe sortiert.
Bei "alpha" werden die Attribute aufsteigend alphabetisch sortiert.

accessibility-check Nach oben

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

Führt einen Zugänglichkeits-Check durch für z.B. blinde 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.