2006-11-19 04:31:48 +00:00
|
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
|
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
|
|
|
|
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
|
|
|
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"><head>
|
|
|
|
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
|
2006-11-20 02:47:00 +00:00
|
|
|
<meta name="description" content="Index to all HTML Purifier documentation." />
|
2006-11-19 04:31:48 +00:00
|
|
|
<link rel="stylesheet" type="text/css" href="./style.css" />
|
|
|
|
|
|
|
|
|
|
<title>Documentation - HTML Purifier</title>
|
|
|
|
|
|
|
|
|
|
</head>
|
|
|
|
|
<body>
|
|
|
|
|
|
|
|
|
|
<h1>Documentation</h1>
|
|
|
|
|
|
2007-01-18 22:38:40 +00:00
|
|
|
<p><strong><a href="http://hp.jpsband.org/">HTML Purifier</a></strong> has documentation for all types of people.
|
2006-11-19 04:31:48 +00:00
|
|
|
Here is an index of all of them.</p>
|
|
|
|
|
|
|
|
|
|
<h2>End-user</h2>
|
|
|
|
|
<p>End-user documentation that contains articles, tutorials and useful
|
|
|
|
|
information for casual developers using HTML Purifier.</p>
|
|
|
|
|
|
2006-11-20 02:47:00 +00:00
|
|
|
<dl>
|
|
|
|
|
|
|
|
|
|
<dt><a href="enduser-id.html">IDs</a></dt>
|
2006-12-20 03:03:03 +00:00
|
|
|
<dd>Explains various methods for allowing IDs in documents safely.</dd>
|
|
|
|
|
|
|
|
|
|
<dt><a href="enduser-youtube.html">Embedding YouTube videos</a></dt>
|
|
|
|
|
<dd>Explains how to safely allow the embedding of flash from trusted sites.</dd>
|
2006-11-20 02:47:00 +00:00
|
|
|
|
2007-01-11 22:28:44 +00:00
|
|
|
<dt><a href="enduser-slow.html">Speeding up HTML Purifier</a></dt>
|
|
|
|
|
<dd>Explains how to speed up HTML Purifier through caching or inbound filtering.</dd>
|
|
|
|
|
|
2007-01-19 03:54:55 +00:00
|
|
|
<dt><a href="enduser-utf8.html">UTF-8</a></dt>
|
|
|
|
|
<dd>Describes the rationale for using UTF-8, the ramifications otherwise, and how to make the switch.</dd>
|
|
|
|
|
|
2006-11-20 02:47:00 +00:00
|
|
|
</dl>
|
|
|
|
|
|
2006-11-19 04:31:48 +00:00
|
|
|
<h2>Development</h2>
|
|
|
|
|
<p>Developer documentation detailing code issues, roadmaps and project
|
|
|
|
|
conventions.</p>
|
|
|
|
|
|
|
|
|
|
<dl>
|
2006-11-19 04:56:50 +00:00
|
|
|
|
2006-11-19 04:31:48 +00:00
|
|
|
<dt><a href="dev-code-quality.html">Code Quality Issues</a></dt>
|
|
|
|
|
<dd>Discusses code quality issues and places that need to be refactored.</dd>
|
2006-11-19 04:56:50 +00:00
|
|
|
|
2006-11-19 04:31:48 +00:00
|
|
|
<dt><a href="dev-progress.html">Implementation Progress</a></dt>
|
|
|
|
|
<dd>Tables detailing HTML element and CSS property implementation coverage.</dd>
|
2006-11-19 04:56:50 +00:00
|
|
|
|
|
|
|
|
<dt><a href="dev-naming.html">Naming Conventions</a></dt>
|
|
|
|
|
<dd>Defines class naming conventions.</dd>
|
|
|
|
|
|
|
|
|
|
<dt><a href="dev-optimization.html">Optimization</a></dt>
|
|
|
|
|
<dd>Discusses possible methods of optimizing HTML Purifier.</dd>
|
|
|
|
|
|
2006-11-19 04:31:48 +00:00
|
|
|
</dl>
|
|
|
|
|
|
|
|
|
|
<h2>Proposals</h2>
|
|
|
|
|
<p>Proposed features, as well as the associated rambling to get a clear
|
|
|
|
|
objective in place before attempted implementation.</p>
|
|
|
|
|
|
|
|
|
|
<dl>
|
|
|
|
|
<dt><a href="proposal-colors.html">Colors</a></dt>
|
|
|
|
|
<dd>Proposal to allow for color constraints.</dd>
|
|
|
|
|
</dl>
|
|
|
|
|
|
|
|
|
|
<h2>Reference</h2>
|
|
|
|
|
<p>Miscellaneous essays, research pieces and other reference type material
|
|
|
|
|
that may not directly discuss HTML Purifier.</p>
|
|
|
|
|
|
|
|
|
|
<dl>
|
|
|
|
|
<dt><a href="ref-devnetwork.html">DevNetwork Credits</a></dt>
|
|
|
|
|
<dd>Credits and links to DevNetwork forum topics.</dd>
|
|
|
|
|
</dl>
|
|
|
|
|
|
2006-11-23 00:45:43 +00:00
|
|
|
<h2>Internal memos</h2>
|
|
|
|
|
|
|
|
|
|
<p>Plaintext documents that are more for use by active developers of
|
|
|
|
|
the code. They may be upgraded to HTML files or stay as TXT scratchpads.</p>
|
|
|
|
|
|
|
|
|
|
<table class="table">
|
|
|
|
|
|
|
|
|
|
<thead><tr>
|
|
|
|
|
<th width="10%">Type</th>
|
|
|
|
|
<th width="20%">Name</th>
|
|
|
|
|
<th>Description</th>
|
|
|
|
|
</tr></thead>
|
|
|
|
|
|
|
|
|
|
<tbody>
|
|
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
<td>End-user</td>
|
|
|
|
|
<td><a href="enduser-overview.txt">Overview</a></td>
|
|
|
|
|
<td>High level overview of the general control flow (mostly obsolete).</td>
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
<td>End-user</td>
|
|
|
|
|
<td><a href="enduser-security.txt">Security</a></td>
|
|
|
|
|
<td>Common security issues that may still arise (half-baked).</td>
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
<td>Proposal</td>
|
|
|
|
|
<td><a href="proposal-filter-levels.txt">Filter levels</a></td>
|
|
|
|
|
<td>Outlines details of projected configurable level of filtering.</td>
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
<td>Proposal</td>
|
|
|
|
|
<td><a href="proposal-language.txt">Language</a></td>
|
|
|
|
|
<td>Specification of I18N for error messages derived from MediaWiki (half-baked).</td>
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
<td>Proposal</td>
|
|
|
|
|
<td><a href="proposal-new-directives.txt">New directives</a></td>
|
|
|
|
|
<td>Assorted configuration options that could be implemented.</td>
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
<td>Reference</td>
|
|
|
|
|
<td><a href="ref-loose-vs-strict.txt">Loose vs.Strict</a></td>
|
|
|
|
|
<td>Differences between HTML Strict and Transitional versions.</td>
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
<td>Reference</td>
|
|
|
|
|
<td><a href="ref-proprietary-tags.txt">Proprietary tags</a></td>
|
|
|
|
|
<td>List of vendor-specific tags we may want to transform to W3C compliant markup.</td>
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
<td>Reference</td>
|
|
|
|
|
<td><a href="ref-strictness.txt">Strictness</a></td>
|
|
|
|
|
<td>Short essay on how loose definition isn't really loose.</td>
|
|
|
|
|
</tr>
|
|
|
|
|
|
2006-11-23 22:33:07 +00:00
|
|
|
<tr>
|
|
|
|
|
<td>Reference</td>
|
|
|
|
|
<td><a href="ref-xhtml-1.1.txt">XHTML 1.1</a></td>
|
|
|
|
|
<td>What we'd have to do to support XHTML 1.1.</td>
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
<td>Reference</td>
|
|
|
|
|
<td><a href="ref-whatwg.txt">WHATWG</a></td>
|
|
|
|
|
<td>How WHATWG plays into what we need to do.</td>
|
|
|
|
|
</tr>
|
|
|
|
|
|
2006-11-23 00:45:43 +00:00
|
|
|
</tbody>
|
|
|
|
|
|
|
|
|
|
</table>
|
|
|
|
|
|
2006-11-19 04:31:48 +00:00
|
|
|
<div id="version">$Id$</div>
|
|
|
|
|
</body>
|
|
|
|
|
</html>
|
