d57698351214f9f65921cce1f8cdb1901c0cdaea
[WebKit-https.git] / WebKitSite / projects / xslt / index.html
1 <?php
2     $title = "XSLT";
3     include("../../header.inc");
4 ?>
5
6 <h2>XSLT</h2>
7
8 <h3>Overview</h3>
9
10 <p>Welcome to the project page for WebKit's XSLT implementation.  <a href="http://www.w3.org/Style/XSL/">XSLT</a> is a W3C standard for defining how to transform source XML
11 into a result document that can be examined using the DOM or displayed as a Web document.  Here is a <a href="http://www.mozilla.org/projects/xslt/test.xml">test file</a> that
12 demonstrates client-side XSLT in action.</p>
13
14 <p>WebKit uses the excellent <a href="http://xmlsoft.org/XSLT/">libxslt</a> library to do XSL
15 transformations.  Bugs in WebKit's XSLT support fall into two categories: either they are bugs in libxslt itself, or they are bugs in WebKit's glue
16 code that interacts with libxslt.  The following <a href="http://xmlsoft.org/XSLT/bugs.html">page at xmlsoft.org</a> has a list of helpful resources and
17 explains the process of bug reporting and getting help for bugs in libxslt.  Even if the bug is in libxslt, file a tracking bug in WebKit's XSLT component and paste in a link
18 to the corresponding libxslt bug.  That way we can track the issue and know that an update to the version of libxslt on the system may be necessary.</p>
19
20 <p>WebKit's implementation of XSLT can be found in the <tt>WebCore</tt> framework in the <tt>khtml/xsl</tt> subdirectory.  There are two classes of interest, 
21 <tt>XSLStyleSheetImpl</tt> and <tt>XSLTProcessorImpl</tt>.  The style sheet class shares a common base with CSS style sheets, and exists as an object-oriented expression
22 of the stylesheets that WebKit encounters when it parses the source XML file.  The processor wraps the code that actually performs the transformation.  It takes the stylesheets
23 and source XML and produces result text that is then fed back into WebKit for parsing as HTML, XML or plain text.</p>
24
25 <h3>Get Involved!</h3>
26
27 <p><a href="https://bugs.webkit.org/buglist.cgi?product=WebKit&amp;component=XSLT&amp;resolution=---">
28 View bugs in the XSLT component in Bugzilla.</a>
29 </p>
30
31 <p>Below is a sampling of interesting open issues with WebKit's XSLT support.  If you wish to sign up for any of these tasks, send mail
32 to <a href="http://lists.webkit.org/mailman/listinfo/webkit-dev">webkit-dev@lists.webkit.org</a> or comment in the appropriate bug.</p>
33
34 <dl>
35 <dt><a href="https://bugs.webkit.org/show_bug.cgi?id=3273">XSL transformations block the user interface</a>
36 <dd>The XSLTProcessor that performs the transformation using libxslt does so on the UI thread.  Therefore a transformation that takes a long time
37 to complete will block the UI of a WebKit application.  The code should be restructured so that both synchronous and asynchronous transformations are
38 allowed, since until JavaScript can be suspended/resumed a synchronous transformation mode must be possible in order for a JS API for XSL transformations to work.
39 </dl>
40
41 <?php
42     include("../../footer.inc");
43 ?>