Original-URLs

&cr;"> ]> StyleCheck Dieses Stylesheet enthält interne Templates und Funktionen, um XSLT-Dateien auf gängige Probleme zu testen. Eine Spezialität dieses Stylesheets sind die intern:solved-Attribute. Sie können Token enthalten, die Stylesheet-Elemente von Tests ausschließen. Verwendung Für den Stylesheet-Test wird die zu testende XSLT-Datei mit dem Template intern:internals.Stylecheck transformiert. Anders formuliert: das Eingabedokument der Transformation ist die zu testende XSLT-Datei und das Stylesheet ein Test-XSLT, das das Template intern:internals.Stylecheck aufruft. Anwendungsbeispiele finden sich in den Test-Stylesheet der XSLT-SB wie z.B. strings_tests.xsl. Die Verwendung von Stylecheck ist dem Einsatz der Testumgebung ähnlich und erfolgt innerhalb der XSLT-SB meist gemeinsam, so dass bei Fragen ggfs. auch ein Blick dorthin lohnt. Autor: Stefan Krause Homepage: http://www.expedimentum.org/ Lizenz (duale Lizenzierung): Dieses Stylesheet und die dazugehörige Dokumentation sind unter einer Creative Commons-Lizenz (CC-BY 3.0) lizenziert. Die Weiternutzung ist bei Namensnennung erlaubt. Dieses Stylesheet und die dazugehörige Dokumentation sind unter der sogenannten Expat License (einer GPL-kompatiblen MIT License) lizensiert. Es darf – als Ganzes oder auszugweise – unter Beibehaltung der Copyright-Notiz kopiert, verändert, veröffentlicht und verbreitet werden. Die Copyright-Notiz steht im Quelltext des Stylesheets und auf der Startseite der Dokumentation. Original-URLs Stylesheet: &XSL-Base-Directory;/internals.stylecheck.xsl Dokumentation: &doc-Base-Directory;/internals.stylecheck.html Test-Stylesheet: &XSL-Base-Directory;/internals.stylecheck.xsl Test-Dokumentation: &doc-Base-Directory;/internals.stylecheck.html XSLT-SB: &XSL-Base-Directory;/ Google Code: http://code.google.com/p/xslt-sb/ 0.2.27 2011-05-30 Stf Status: beta intern:internals.Stylecheck.CheckMisplacedIntern hinzugefügt 0.2.0 2011-05-14 Stf erste veröffentlichte Version 0.139 2011-04-24 Stf Justierung der Fehlerlevel 0.129 2011-02-27 Stf Erweiterung der Lizenz auf Expath/MIT license 0.114 2010-07-18 Stf Dokumentation ausgebaut 0.93 2010-05-30 Stf Einbindung von internals.meta.xsl und Verwendung von intern:function-name(), Tests der arity bei intern:internals.Stylecheck.MissingTests 0.85 2010-04-10 Stf Einbindung von externen Test-Stylesheets 0.63 2009-11-22 Stf initiale Version Dieses Template ist der zentrale Einstieg zur Realisierung der Style-Checks. Es wird auf die zu untersuchende XSL-Datei und eventuelle Test-Stylesheets angewendet. Test-Stylesheets beinhalten nur die Tests zu einem Stylesheet. Sie haben den selben Dateinamen wie das zu testende Stylesheet, ergänzt um _tests (Beispiel: "files.xsl" und "files_tests.xsl"). Es sind drei Fälle vorgesehen: Stylesheet und Tests in der selben Datei, Anwendung auf diese Datei. Stylesheet und Tests in getrennten Dateien, Anwendung auf Stylesheet-Datei Stylesheet und Tests in getrennten Dateien, Anwendung auf Test-Datei Schwerwiegende Fehler werden mit Level »WARN« ausgegeben, Hinweise mit Level »INFO« 0.85 2010-04-10 Stf Status: beta Einbindung von externen Test-Stylesheets 0.63 2009-11-22 Stf Status: beta initiale Version

ALL

intern:internals.Stylecheck

ERROR

Fehler bei Ermittlung der Stylesheet-URI aus der Test-Stylesheet-URI. Test-Stylesheet: "", ermitteltes Stylesheet: ""

TRACE

intern:internals.Stylecheck

XSL-Dokument-Knoten, auf den die Tests angewendet werden. Dieses Template überprüft die Syntax von Funktionstests mit xsl:call-template name="xsb:internals.test.Function". Konkret getestet wird, ob der Inhalt der Parameter caller und actual-value übereinstimmt (weil sonst falsche, verwirrende Fehlermeldungen angezeigt werden.) solved-Token: "CallTemplateTestFunction" 0.63 2009-11-22 Stf Status: beta initiale Version

internals.Stylecheck.CallTemplateTestFunction

Inkonsistenz zwischen caller und actual-value: //[() and ()]

WARN

XSL-Dokument-Knoten, auf den die Tests angewendet werden. Dieses Template testet den Aufruf von Funktionstests mit xsb:internals.test.function.withTestItem.BooleanResult", xsb:internals.test.function.withTestItem.StringResult" usw.. solved-Token: "CallTemplateTestFunction" 0.63 2009-11-22 Stf Status: beta initiale Version

internals.Stylecheck.CallTemplateTestFunctionWithTestItem

Inkonsistenz zwischen function-name und actual-value: //[() and ()]

WARN

XSL-Dokument-Knoten, auf den die Tests angewendet werden. Dieses Template testet, ob alle Variablen, Parameter und Funktionen getypt sind. solved-Token: "MissingTypes" 0.2.8 2011-05-14 Stf Status: beta Typung von Funktionen hinzugefügt 0.63 2009-11-22 Stf Status: beta initiale Version

internals.Stylecheck.MissingTypes

Ungetypte Variable, ungetypter Parameter oder ungetypte Funktion:

INFO

XSL-Dokument-Knoten, auf den die Tests angewendet werden. Dieses Template testet, ob Funktionen oder Templates eine empty sequence als Resultat liefern dürfen. Hintergrund: Funktionen und Templates sollten einen definierten Rückgabewert haben, also z.B. "0" oder den Leerstring ("") statt einer Leersequenz. Damit werden Typ-Fehler im aufrufenden Code reduziert. solved-Token: "EmptySequenceAllowed" 0.63 2009-11-22 Stf Status: beta initiale Version

internals.Stylecheck.EmptySequenceAllowed

Funktion oder Template erlaubt die Rückgabe einer empty sequence: //

INFO

XSL-Dokument-Knoten, auf den die Tests angewendet werden. Dieses Template testet, ob alle Funktionen mit Test versehen sind. solved-Token: "MissingTests" 0.70 2009-13-08 Stf Status: beta initiale Version

internals.Stylecheck.MissingTests

Funktion ohne Test: //[count(xsl:param) = ]

WARN

internals.Stylecheck.MissingTests

Weniger als 3 Tests für: //[count(xsl:param) = ]

WARN

XSL-Dokument-Knoten, auf den die Tests angewendet werden. Dieses Template testet, ob bei Template-Parametern das required-Attribute gesetzt ist. solved-Token: "RequiredParameter" 0.63 2009-11-22 Stf Status: beta initiale Version

internals.Stylecheck.RequiredParameter

Template-Parameter ohne required-Attribut:

INFO

XSL-Dokument-Knoten, auf den die Tests angewendet werden. Dieses Template testet verschiedene Aspekte der Qualität der Dokumentation. Die Dokumentation mit XSLStyle™ und DocBook wird in standard.html erläutert. solved-Token: "DocTest" 0.2.27 2011-05-30 Stf Status: beta Solved-Token "DocTest" hinzugefügt 0.2.11 2011-05-15 Stf Status: beta Test auf @xml:id hinzugefügt 0.111 2010-07-11 Stf Status: beta initiale Version