13 |
<div class="section" id="introduction"> |
<div class="section" id="introduction"> |
14 |
<h2>Introduction</h2> |
<h2>Introduction</h2> |
15 |
|
|
16 |
<p><dfn>Whatpm</dfn>, a subproject of |
<p><dfn>Whatpm</dfn> is a <em>work-in-progress</em> set of Perl modules for |
17 |
<a href="http://suika.fam.cx/www/2006/manakai/" rel=up>manakai</a>, |
Web hypertext application technologies. It is part |
18 |
is a <em>work-in-progress</em> set of Perl modules for |
of the <a href="http://suika.fam.cx/www/2006/manakai/" rel=up>manakai</a> |
19 |
Web hypertext application technologies.</p> |
project.</p> |
20 |
|
|
21 |
<dl> |
<dl> |
22 |
|
<dt>Modules</dt> |
23 |
|
<dd><dl> |
24 |
<dt><a href="Whatpm/ContentChecker.html"><code>Whatpm::ContentChecker</code></a></dt> |
<dt><a href="Whatpm/ContentChecker.html"><code>Whatpm::ContentChecker</code></a></dt> |
25 |
<dd>A DOM5 HTML (in-memory representation of a document) conformance |
<dd>A DOM5 HTML (in-memory representation of a document) conformance |
26 |
checker.</dd> |
checker with a partial support for Atom 1.0. (See also |
27 |
|
<a href="#demo-html-parser">demo</a>.)</dd> |
28 |
<dt><a href="Whatpm/ContentType.html"><code>Whatpm::ContentType</code></a></dt> |
<dt><a href="Whatpm/ContentType.html"><code>Whatpm::ContentType</code></a></dt> |
29 |
<dd>An implementation of HTML5 Content Type sniffing algorithm.</dd> |
<dd>An implementation of HTML5 Content Type sniffing algorithm.</dd> |
30 |
|
<dt><a href="Whatpm/CSS/SelectorsParser.html"><code>Whatpm::CSS::SelectorsParser</code></a></dt> |
31 |
|
<dd>A <a href="http://www.w3.org/TR/css3-selectors/#grouping">group of |
32 |
|
selectors</a> parser. (See also <a href="#demo-css-parser">demo</a>.)</dd> |
33 |
|
<dt><a href="Whatpm/CSS/SelectorsSerializer.html"><code>Whatpm::CSS::SelectorsSerializer</code></a></dt> |
34 |
|
<dd>A <a href="http://www.w3.org/TR/css3-selectors/#grouping">group of |
35 |
|
selectors</a> serializer. (See also <a href="#spec-ssft">specification</a> |
36 |
|
and <a href="#demo-css-parser">demo</a>.)</dd> |
37 |
|
<dt><a href="Whatpm/CSS/Tokenizer.html"><code>Whatpm::CSS::Tokenizer</code></a></dt> |
38 |
|
<dd>A CSS tokenizer. (See also <a href="#demo-css-parser">demo</a>.)</dd> |
39 |
<dt><a href="Whatpm/HTML.html"><code>Whatpm::HTML</code></a></dt> |
<dt><a href="Whatpm/HTML.html"><code>Whatpm::HTML</code></a></dt> |
40 |
<dd>An implementation of HTML5 parsing algorithm and |
<dd>An implementation of HTML5 parsing algorithm, fragment |
41 |
<code>innerHTML</code> serialization.</dd> |
parsing, and fragment serialization algorithms. It can be used |
42 |
|
to convert a string into DOM, or <i lang="">vice versa</i>. |
43 |
|
(See also <a href="#demo-html-parser">demo</a>.)</dd> |
44 |
<dt><a href="Whatpm/HTMLTable.html"><code>Whatpm::HTMLTable</code></a></dt> |
<dt><a href="Whatpm/HTMLTable.html"><code>Whatpm::HTMLTable</code></a></dt> |
45 |
<dd>An implementation of the HTML5 table algorithm.</dd> |
<dd>An implementation of the HTML5 table algorithm. It can be |
46 |
|
used to extract a table structure from a DOM <code>table</code> |
47 |
|
element node. (See also <a href="#demo-html-table">demo</a>.)</dd> |
48 |
<dt><a href="Whatpm/IMTChecker.html"><code>Whatpm::IMTChecker</code></a></dt> |
<dt><a href="Whatpm/IMTChecker.html"><code>Whatpm::IMTChecker</code></a></dt> |
49 |
<dd>An Internet Media Type (<abbr>aka</abbr> MIME type) label |
<dd>An Internet Media Type (<abbr>aka</abbr> MIME type) label |
50 |
conformance checker.</dd> |
conformance checker.</dd> |
52 |
<dd>An IRI reference conformance checker.</dd> |
<dd>An IRI reference conformance checker.</dd> |
53 |
<dt><a href="Whatpm/XMLSerializer.html"><code>Whatpm::XMLSerializer</code></a></dt> |
<dt><a href="Whatpm/XMLSerializer.html"><code>Whatpm::XMLSerializer</code></a></dt> |
54 |
<dd>A simple XML serializer.</dd> |
<dd>A simple XML serializer.</dd> |
55 |
|
</dl> |
56 |
|
|
57 |
|
<p>Note that all of these modules are <em>work in progress</em> |
58 |
|
and have <a href="#todo">a number of unresolved problems</a>.</p> |
59 |
|
|
60 |
|
<p>Note also that some modules have no documentation for now.</p> |
61 |
|
</dd> |
62 |
|
<dt id=spec>Specification</dt> |
63 |
|
<dd><dl> |
64 |
|
<dt id=spec-ssft><a href="http://suika.fam.cx/www/markup/selectors/ssft/ssft"><abbr title="Selectors Serialization Format for Testing">SSFT</abbr> |
65 |
|
Specification</a></dt> |
66 |
|
<dd>The specification for the serialization format used for |
67 |
|
testing Selectors-related modules.</dd> |
68 |
|
<dt id=spec-manakai-selectors"><a href="http://suika.fam.cx/gate/2005/sw/manakai/Selectors%20Extensions">manakai's |
69 |
|
Selectors Extensions</a></dt> |
70 |
|
<dd>The specification for <code>:-manakai-<var>*</var></code> |
71 |
|
pseudo-classes implemented by Selectors-related modules.</dd> |
72 |
|
</dl></dd> |
73 |
|
<dt>Documentations</dt> |
74 |
|
<dd><dl> |
75 |
<dt><a href="http://suika.fam.cx/gate/2005/sw/Whatpm%20Error%20Types">List of error types</a></dt> |
<dt><a href="http://suika.fam.cx/gate/2005/sw/Whatpm%20Error%20Types">List of error types</a></dt> |
76 |
|
<dd>Description of errors to be notified to callback functions by Whatpm |
77 |
|
modules.</dd> |
78 |
|
</dd> |
79 |
|
<dt><a href="Whatpm/CSS/selectors-object">Selectors object</a></dt> |
80 |
|
<dd>Description of data structure of Selectors object as used by |
81 |
|
<a href="Whatpm/CSS/SelectorsParser.html"><code>Whatpm::CSS::SelectorsParser</code></a> |
82 |
|
(as output), and |
83 |
|
<a href="Whatpm/CSS/SelectorsSerializer.html"><code>Whatpm::CSS::SelectorsSerializer</code></a> |
84 |
|
(as input)<!--, and |
85 |
|
<a href="http://suika.fam.cx/www/manakai-core/lib/Message/DOM/SelectorsAPI.html"><code>Message::DOM::SelectorsAPI</code></a>-->.</dd> |
86 |
|
</dl> |
87 |
|
</dd> |
88 |
</dl> |
</dl> |
|
|
|
|
<p>Note that all of these modules are <em>work in progress</em> |
|
|
and have <a href="#todo">a number of unresolved problems</a>.</p> |
|
89 |
</div> |
</div> |
90 |
|
|
91 |
<div class="section" id="demo"> |
<div class="section" id="demo"> |
92 |
<h2>Demo</h2> |
<h2>Demo</h2> |
93 |
|
|
94 |
<ul> |
<ul> |
95 |
<li><a href="http://suika.fam.cx/gate/2007/html/parser-interface">HTML5 parser |
<li id=demo-html-parser-nanodom><a href="http://suika.fam.cx/gate/2007/html/parser-interface">HTML5 parser |
96 |
and checker demo</a></li> |
and checker demo</a> |
97 |
<li><a href="http://suika.fam.cx/gate/2007/html/table-interface">HTML5 table |
(<a href="http://suika.fam.cx/gate/cvs/*checkout*/webroot/gate/2007/html/parser.cgi">source</a>, |
98 |
structure visualization demo</a></li> |
with <a href="Whatpm/NanoDOM.html">a lightweight non-conforming |
99 |
|
DOM implementation</a>)</li> |
100 |
|
<li id=demo-html-parser-manakai><a href="http://suika.fam.cx/gate/2007/html/parser-manakai-interface">HTML5 |
101 |
|
parser and checker demo, with manakai's DOM implementation</a> |
102 |
|
(<a href="http://suika.fam.cx/gate/cvs/*checkout*/webroot/gate/2007/html/parser-manakai.cgi">source</a>)</li> |
103 |
|
<li id=demo-html-table><a href="http://suika.fam.cx/gate/2007/html/table-interface">HTML5 table |
104 |
|
structure visualization demo</a> |
105 |
|
(<a href="http://suika.fam.cx/gate/cvs/*checkout*/webroot/gate/2007/html/table.cgi">source</a>)</li> |
106 |
|
<li id=demo-css-parser><a href="http://suika.fam.cx/gate/2007/css/parser-interface">CSS tokenizer |
107 |
|
demo</a> |
108 |
|
(<a href="http://suika.fam.cx/gate/cvs/*checkout*/webroot/gate/2007/css/parser.cgi">source</a>)</li> |
109 |
</ul> |
</ul> |
110 |
</div> |
</div> |
111 |
|
|
137 |
in <a href="http://suika.fam.cx/www/2006/manakai/">manakai</a>. |
in <a href="http://suika.fam.cx/www/2006/manakai/">manakai</a>. |
138 |
They are not required in practice.</dd> |
They are not required in practice.</dd> |
139 |
<dt><a href="http://search.cpan.org/~makamaka/JSON-1.14/"><code>JSON</code></a></dt> |
<dt><a href="http://search.cpan.org/~makamaka/JSON-1.14/"><code>JSON</code></a></dt> |
140 |
<dd><em>Testing</em> for <code>Whatpm::HTML</code> |
<dd><em>Testing</em> for <code>Whatpm::HTML</code> and |
141 |
|
<code>Whatpm::CSS::Tokenizer</code> |
142 |
depends on <a href="http://search.cpan.org/~makamaka/JSON-1.14/"><code>JSON</code> and related modules</a>. |
depends on <a href="http://search.cpan.org/~makamaka/JSON-1.14/"><code>JSON</code> and related modules</a>. |
143 |
They are not required in practice.</dd> |
They are not required in practice.</dd> |
144 |
</dl> |
</dl> |
167 |
<li>Validation for media queries, IRIs (against URI schemes), language tags, |
<li>Validation for media queries, IRIs (against URI schemes), language tags, |
168 |
and so on.</li> |
and so on.</li> |
169 |
<li>Documentations are missing for some features.</li> |
<li>Documentations are missing for some features.</li> |
170 |
<li><q>Whatpm</q> is a code name in fact. Please let me know |
<li>XML parser<!-- with application cache selection algorithm hook-->.</li> |
|
if you have a better name.</li> |
|
171 |
<li>In addition, each module has its own TO DO items. |
<li>In addition, each module has its own TO DO items. |
172 |
(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> |
173 |
</ul> |
</ul> |
174 |
</div> |
</div> |
175 |
|
|
176 |
|
<div class=section id=acknowledgments> |
177 |
|
<h2>Acknowledgments</h2> |
178 |
|
|
179 |
|
<p>Thanks to the <a href="http://code.google.com/p/html5lib/">html5lib</a> |
180 |
|
team for <a href="http://html5lib.googlecode.com/svn/trunk/testdata/">HTML5 |
181 |
|
parser test data</a>.</p> |
182 |
|
</div> |
183 |
|
|
184 |
<div class="section" id="author"> |
<div class="section" id="author"> |
185 |
<h2>Author</h2> |
<h2>Author</h2> |
186 |
|
|