/[suikacvs]/markup/html/whatpm/readme.en.html
Suika

Diff of /markup/html/whatpm/readme.en.html

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.30 by wakaba, Mon Oct 13 06:18:30 2008 UTC revision 1.31 by wakaba, Tue Oct 21 06:10:09 2008 UTC
# Line 6  Technologies (beta)</title> Line 6  Technologies (beta)</title>
6  <link rel="stylesheet" href="http://suika.fam.cx/www/style/html/xhtml">  <link rel="stylesheet" href="http://suika.fam.cx/www/style/html/xhtml">
7  <link rel="license" href="#license">  <link rel="license" href="#license">
8  <link rel="author" href="#author">  <link rel="author" href="#author">
9    <link rel=feed href="whatpm-commit" type="application/atom+xml"
10        title="ChangeLog diffs">
11  </head>  </head>
12  <body>  <body>
13  <h1>Whatpm &mdash; Perl modules for Web hypertext application technologies  <h1>Whatpm &mdash; Perl modules for Web hypertext application technologies
# Line 27  href="#modules-html">HTML, XHTML</a>, <a Line 29  href="#modules-html">HTML, XHTML</a>, <a
29  <a href="#modules-url">URL</a>.  <a href="#modules-url">URL</a>.
30  </div>  </div>
31    
32    <div class=section id=news>
33    <h2>What's new?</h2>
34    
35    <p><a href="whatpm-commit" rel=feed type="application/atom+xml">An
36    Atom feed for ChangeLog diffs</a> is available.
37    
38    <ul>
39    
40    <li><time>2008-10-21</time>: <a href="#module-whatpm-xml-parser">An
41    XML parser with non-draconian error handling</a> released.
42    (Documentation is not available yet.)
43    
44    </ul>
45    
46    </div>
47    
48  <div class=section id=modules>  <div class=section id=modules>
49  <h2>Modules</h2>  <h2>Modules</h2>
50    
# Line 55  href="#modules-html">HTML, XHTML</a>, <a Line 73  href="#modules-html">HTML, XHTML</a>, <a
73    element node.  (See also <a href="#demo-html-table">demo</a>.)</dd>    element node.  (See also <a href="#demo-html-table">demo</a>.)</dd>
74  </dl>  </dl>
75    
76  <p id=modules-xml>The module for <i>tentative</i> XML support is as follow:  <p id=modules-xml>Modules for the XML support is as follow:
77    
78  <dl>  <dl>
79    
80    <dt id=module-whatpm-xml-parser><a
81    href="Whatpm/XML/Parser.html"><code>Whatpm::XML::Parser</code></a>
82    
83    <dd><p>An XML parser with non-draconian error handling.  It can
84    construct a DOM tree from XML 1.0/1.1 documents that does <em>not</em>
85    rely on external entities (including the external subset entity) and
86    that does <em>not</em> contain general entity reference that
87    references an entity whose replacement text contains character
88    <code>&</code> or <code>&lt;</code>.  It also supports XML namespaces.
89    
90    <p>It does not stop the process to construct a DOM tree even if it
91    detects a well-formedness or a namespace well-formedness error.  It
92    recovers from errors in a manner similar to HTML5's tokenization
93    algorithm.  It is expected that the combination of this module and a
94    future extension to the <code>Whatpm::ContentChecker</code> framework
95    will provide a mean to detect all well-formedness and validity errors,
96    if desired.
97    
98    <p>(See also <a href="#demo-html-parser-manakai">demo</a>.)
99    
100  <dt><a href="Whatpm/XMLSerializer.html"><code>Whatpm::XMLSerializer</code></a></dt>  <dt><a href="Whatpm/XMLSerializer.html"><code>Whatpm::XMLSerializer</code></a></dt>
   <dd>A simple XML serializer.</dd>  
 </dl>  
101    
102  <p><i>Real</i> XML parser and serializer are currently not available yet.  <dd>A simple XML serializer.  It does namespace prefix fixups and
103    suitable for the serialization of a carefully build XML DOM tree.  It
104    does not assure that the output is well-formed.
105    
106    </dl>
107    
108  <p id=modules-cc>The module for conformance checking of a DOM tree (i.e.  <p id=modules-cc>The module for conformance checking of a DOM tree (i.e.
109  a in-memory representation of an HTML or XML document) is as follows:  a in-memory representation of an HTML or XML document) is as follows:
# Line 127  are supported at the moment. Line 169  are supported at the moment.
169  tree, modules in the <a  tree, modules in the <a
170  href="http://suika.fam.cx/www/manakai-core/doc/web/">manakai-core</a>  href="http://suika.fam.cx/www/manakai-core/doc/web/">manakai-core</a>
171  package are used.  Those modules also provide the serializer for the  package are used.  Those modules also provide the serializer for the
172  CSSOM tree, in the form of the standard <code>css_text</code> CSSOM  CSSOM tree, in the form of <a href="#howtouse">the standard
173  attribute.  <code>css_text</code> CSSOM attribute</a>.
174    
175  </div>  </div>
176    
# Line 197  yet available. Line 239  yet available.
239    
240  <!-- Whatpm::ContentChecker::*, Whatpm::H2H, Whatpm::NanoDOM, and  <!-- Whatpm::ContentChecker::*, Whatpm::H2H, Whatpm::NanoDOM, and
241       Whatpm::XMLParser are intentionally omitted from the list. -->       Whatpm::XMLParser are intentionally omitted from the list. -->
242    
243    <div class=section id=howtouse>
244    <h3>How to use modules</h3>
245    
246    <p><a href="#modules">Modules</a> listed above, which are included in
247    the Whatpm package, can be used by directly <code>use</code>ing or
248    <code>require</code>ing these modules and then invoking their native
249    interface.  For more information on those native interfaces, see the
250    document of those modules and the source code of them.
251    
252    <p>In addition, some of functionality provided by those modules can be
253    accessed via standardized DOM interfaces implemented by modules
254    included in the <a
255    href="http://suika.fam.cx/www/manakai-core/doc/web/">manakai-core</a>
256    package.  See the document of the module <a
257    href="http://suika.fam.cx/www/manakai-core/lib/Message/DOM/DOMImplementation.html"><code>Message::DOM::DOMImplementation</code></a>
258    for the way to access to the DOM interfaces.
259    
260    <p>The table below summarizes the relationship between Whatpm modules
261    and DOM methods/attributes implemented by manakai-core modules:
262    
263    <table>
264    <thead>
265    <tr><th scope=col>Whatpm module
266    <th scope=col>DOM methods/attributes
267    
268    <tbody>
269    
270    <tr><td><code>Whatpm::CSS::Cascade</code>
271    <td><code>get_computed_style</code> (<code>ViewCSS</code>),
272    <code>current_style</code> (<code>ElementCSS</code>)
273    
274    <tr><td><code>Whatpm::CSS::Parser</code>
275    <td rowspan=2><code>CSSStyleDeclaration</code>'s attributes and methods,
276    <code>css_text</code> (CSSOM interfaces)
277    
278    <tr><td><code>Whatpm::CSS::Serializer</code>
279    
280    <tr><td rowspan=2><code>Whatpm::CSS::SelectorsParser</code>
281    <td><code>query_selector</code>, <code>query_selector_all</code>
282    (<code>DocumentSelector</code>, <code>ElementSelector</code>)
283    <tr><td rowspan=2><code>selector_text</code> (<code>CSSStyleRule</code>)
284    
285    <tr><td><code>Whatpm::CSS::SelectorsSerializer</code>
286    
287    <tr><td><code>Whatpm::HTML</code>
288    <td rowspan=4><code>inner_html</code> (<code>HTMLDocument</code>,
289    <code>Element</code>)
290    
291    <tr><td><code>Whatpm::HTML::Serializer</code>
292    
293    <tr><td><code>Whatpm::XML::Parser</code>
294    
295    <tr><td><code>Whatpm::XMLSerializer</code>
296    
297    </table>
298    
299    </div>
300    
301  </div>  </div>
302    
303  <div class=section id=documents>  <div class=section id=documents>
# Line 250  Specification</a></dt> Line 351  Specification</a></dt>
351  CSS extensions</a>  CSS extensions</a>
352    <dd>The specification for <code>-manakai-<var>*</var></code> properties    <dd>The specification for <code>-manakai-<var>*</var></code> properties
353    and property values implemented by CSS-related modules.    and property values implemented by CSS-related modules.
354  <dt id=spec-manakai-selectors"><a href="http://suika.fam.cx/gate/2005/sw/manakai/Selectors%20Extensions">manakai's  <dt id=spec-manakai-selectors><a href="http://suika.fam.cx/gate/2005/sw/manakai/Selectors%20Extensions">manakai's
355  Selectors extensions</a>  Selectors extensions</a>
356    <dd>The specification for <code>:-manakai-<var>*</var></code>    <dd>The specification for <code>:-manakai-<var>*</var></code>
357    pseudo-classes implemented by Selectors-related modules.</dd>    pseudo-classes implemented by Selectors-related modules.</dd>
# Line 397  tarball. Line 498  tarball.
498    <li>Validation for media queries (level 3), IRIs (against URI schemes),    <li>Validation for media queries (level 3), IRIs (against URI schemes),
499      and so on.</li>      and so on.</li>
500    <li>Documentations are missing for some features.</li>    <li>Documentations are missing for some features.</li>
   <li>XML parser<!-- with application cache selection algorithm hook-->.</li>  
501    <li>In addition, each module has its own TO DO items.    <li>In addition, each module has its own TO DO items.
502      (Search for <q>## TODO</q> and <q>## ISSUE</q> in each module.)</li>      (Search for <q>## TODO</q> and <q>## ISSUE</q> in each module.)</li>
503  </ul>  </ul>
Legend:
Removed from v.1.30  
changed lines
  Added in v.1.31
admin@suikawiki.org
 ViewVC Help
Powered by ViewVC 1.1.24