Devil Killer Is Here MiNi Shell
MiNi SheLL

Current Path : /proc/thread-self/root/usr/local/man/man3/
Linux boscustweb5001.eigbox.net 5.4.91 #1 SMP Wed Jan 20 18:10:28 EST 2021 x86_64
Current File : //proc/thread-self/root/usr/local/man/man3/XML::Schematron::LibXSLT.3
.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  | will give a
.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
.\" expand to `' in nroff, nothing in troff, for use with C<>.
.tr \(*W-|\(bv\*(Tr
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "XML::Schematron::LibXSLT 3"
.TH XML::Schematron::LibXSLT 3 "2002-02-15" "perl v5.8.8" "User Contributed Perl Documentation"
.SH "NAME"
XML::Schematron::LibXSLT \- Perl extension for validating XML with XPath/XSLT expressions.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 3
\&  use XML::Schematron::LibXSLT;
\&  my $pseudotron = XML::Schematron::LibXSLT->new(schema => 'my_schema.xml');
\&  my $messages = $pseudotron->verify('my_doc.xml');
.Ve
.PP
.Vb 4
\&  if ($messages) {
\&      # we got warnings or errors during validation...
\&      ...
\&  }
.Ve
.PP
.Vb 1
\&  OR, in an array context:
.Ve
.PP
.Vb 2
\&  my $pseudotron = XML::Schematron::LibXSLT->new(schema => 'my_schema.xml');
\&  my @messages = $pseudotron->verify('my_doc.xml');
.Ve
.PP
.Vb 1
\&  OR, just get the generated xsl:
.Ve
.PP
.Vb 2
\&  my $pseudotron = XML::Schematron::LibXSLT->new(schema => 'my_schema.xml');
\&  my $xsl = $pseudotron->dump_xsl; # returns the internal XSLT stylesheet.
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
XML::Schematron::LibXSLT serves as a simple validator for \s-1XML\s0 based on Rick \s-1JELLIFFE\s0's Schematron \s-1XSLT\s0 script. A Schematron
schema defines a set of rules in the XPath language that are used to examine the contents of an \s-1XML\s0 document tree.
.PP
A simplified example: 
.PP
.Vb 9
\& <schema>
\&  <pattern>
\&   <rule context="page">
\&    <assert test="count(*)=count(title|body)">The page element may only contain title or body elements.</assert> 
\&    <assert test="@name">A page element must contain a name attribute.</assert> 
\&    <report test="string-length(@name) &lt; 5">A page element name attribute must be at least 5 characters long.</report> 
\&   </rule>
\&  </pattern>
\& </schema>
.Ve
.PP
Note that an 'assert' rule will return if the result of the test expression is \fInot\fR true, while a 'report' rule will return
only if the test expression evalutes to true.
.SH "METHODS"
.IX Header "METHODS"
.IP "\fInew()\fR" 4
.IX Item "new()"
The 'new' constructor accepts the following \*(L"named\*(R" arguments:
.RS 4
.IP "* schema" 4
.IX Item "schema"
The filename of the schema to use for generating tests.
.IP "* tests" 4
.IX Item "tests"
The tests argument is an \fBalternative\fR to the use of a schema as a means for defining the test stack. It should be a 
reference to a list of lists where the format of the sub-lists must conform to the following order:
.Sp
.Vb 1
\&  [$xpath_exp, $context, $message, $test_type, $pattern]
.Ve
.RE
.RS 4
.RE
.IP "\fIschema()\fR" 4
.IX Item "schema()"
When called with a single scalar as its argument, this method sets/updates the schema file to be used for generatng
tests. Otherwise, it simply returns the name of the schema file (if any).
.IP "\fItests()\fR" 4
.IX Item "tests()"
When called with a reference to a list of lists as its argument (see the format in the description of the 'tests' argument to 
the \fInew()\fR method for details), this method sets the current test stack. Otherwise, it returns an arrayref to the current test 
stack (if any).
.IP "add_test(%args);" 4
.IX Item "add_test(%args);"
The \fIadd_test()\fR method allows you push additional tests on to the stack before validation using the typical \*(L"hash of named
parameters\*(R" style.
.Sp
Arguments for this method:
.RS 4
.IP "* expr (required)" 4
.IX Item "expr (required)"
The XPath expression to evaluate.
.IP "* context (required)" 4
.IX Item "context (required)"
An element name or XPath location to use as the context of the test expression.
.IP "* type (required)" 4
.IX Item "type (required)"
The \fBtype\fR argument must be set to either 'assert' or 'report'. Assert tests will return the associated message only if the
the corresponding test expression is \fBnot\fR true, while 'report' tests will return only if their associated test expression
\&\fBare\fR true.
.IP "* message (required)" 4
.IX Item "message (required)"
The text message to display when the test condition is met.
.IP "* pattern (optional)" 4
.IX Item "pattern (optional)"
Optional descriptive text for the returned message that allows a logical grouping of tests.
.Sp
Example:
.Sp
.Vb 5
\&  $obj->add_test(expr => 'count(@*) > 0',
\&                 context => '/pattern',
\&                 message => 'Pattern should have at least one attribute',
\&                 type => 'assert',
\&                 pattern => 'Basic tests');
.Ve
.Sp
Note that \fIadd_test()\fR pushes a new test on to the existing test list, while \fItests()\fR redefines the entire list.
.RE
.RS 4
.RE
.ie n .IP "verify('my_xml_file.xml' or $some_xml_string)" 4
.el .IP "verify('my_xml_file.xml' or \f(CW$some_xml_string\fR)" 4
.IX Item "verify('my_xml_file.xml' or $some_xml_string)"
The \fIverify()\fR method takes the path to the \s-1XML\s0 document that you wish to validate, or a scalar containing the entire document  
as a string, as its sole argument. It returns the messages  that are returned during validation. When called in an array
context, this method returns an array of the messages generated during validation. When called in a scalar context, this
method returns a concatenated string of all output.
.IP "dump_xsl;" 4
.IX Item "dump_xsl;"
The dump_xsl method will return the internal \s-1XSLT\s0 script created from your schema.
.SH "CONFORMANCE"
.IX Header "CONFORMANCE"
Internally, XML::Schematron::LibXSLT uses the Gnome Project's \s-1XSLT\s0 proccessor via XML::LibXSLT and, while this proccessor is
not 100% compliant with the \s-1XSLT\s0 spec at the time of this writing, it is the best \s-1XSLT\s0 libraray available to the Perl World at
the moment. It is therefore possible that you might use a completely valid \s-1XSLT\s0 expression within one of your schema's tests 
that will cause this module to die unexpectedly. 
.PP
For those platforms on which libxslt is not available, please see the documentation for XML::Scmeatron::Sablotron and
XML::Schematron::XPath (also in this distribution) for alternatives. 
.SH "AUTHOR"
.IX Header "AUTHOR"
Kip Hampton, khampton@totalcinema.com
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright (c) 2000 Kip Hampton. All rights reserved. This program is free software; you can redistribute it and/or modify it  
under the same terms as Perl itself.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
For information about Schematron, sample schemas, and tutorials to help you write your own schmemas, please visit the
Schematron homepage at: http://www.ascc.net/xml/resource/schematron/
.PP
For information about how to install libxslt and the necessary XML::LibXSLT Perl module, please see http://xmlsoft.org/XSLT/
and \s-1CPAN\s0, repectively. 
.PP
For detailed information about the XPath syntax, please see the W3C XPath Specification at: http://www.w3.org/TR/xpath.html
Creat By MiNi SheLL
Email: devilkiller@gmail.com