docs.roxen.comView this page in a printer friendly mode
DocsRoxen2.1Web Site Creator ManualText Tags
Copyright © 2001, Roxen Internet Software
Suggestions, comments & compliments
manuals@roxen.com
 DEMO  DOCS  PIKE
 COMMUNITY  DOWNLOAD
www.roxen.com

   

<ai>
<autoformat>
<case>
<comment>
<?comment ?>
<default>
<doc>
<foldlist>
<obox>
<random>
<replace>
<smallcaps>
<sort>
<strlen>
<tablify>
<trimlines>
<wash-html>

<wash-html></wash-html>

Provided by module: HTML washer

This tag is mostly useful for turning user freetext input from a form into HTML intelligently, by turning sections of the text separated by more than one newline into <p>paragraphs</p>, filtering out or explicitly allowing some HTML tags in the input and creating <a>anchor-links</a> out of potential www-addresses.


Attributes

keep-all

Leave all tags containing info intact. Overrides the value of keep-tags and keep-containers. This attribute is useful together with the attributes unparagraphify and unlink.


<wash-html keep-all=''>
  Some text, <i>italic</i>, <b>bold</b>, <i><b>bold italic</b></i>.

  <hr>A little image:<img src='/internal-roxen-next'>.
</wash-html>
Some text, italic, bold, bold italic.
A little image:.

keep-tags="list"

Comma-separated array of empty element <tags> not to filter. Quote all other empty element tags i.e. transform "<", ">" and "&" to "&lt;", "&gt;" and "&amp;".



<wash-html keep-tags='hr'>
  Some text, <i>italic</i>, <b>bold</b>, <i><b>bold italic</b></i>.

  <hr />A litle image:<img src='/internal-roxen-next'>.
</wash-html>
Some text, <i>italic</i>, <b>bold</b>, <i><b>bold italic</b></i>.
A litle image:<img src='/internal-roxen-next'>.

keep-containers="list"

Comma-separated array of <container>...</> tags not to filter. Quote all other container tags e.i. transform "<", ">" and "&" to "&lt;", "&gt;" and "&amp;".



<wash-html keep-containers='b'>
  Some text, <i>italic</i>, <b>bold</b>, <i><b>bold italic</b></i>.

  <hr>A little image:<img src='/internal-roxen-next'>.
</wash-html>
Some text, <i>italic</i>, bold, <i>bold italic</i>. <hr>A little image:<img src='/internal-roxen-next'>.

linkify

Makes text that looks like it might be useful as a link, e g http://www.roxen.com/, into a link. Text that starts with "http://", "https://", "ftp://", "www." or "http." will be converted to a clickable link with the text as the link label.



<wash-html linkify='' keep-containers='a' keep-tags='br'>
  <a href="http://docs.roxen.com">Roxen docs</a><br />
  http://pike.roxen.com<br />
  www.roxen.com
</wash-html>
Roxen docs
http://pike.roxen.com
http://www.roxen.com


unlinkify

Undo a linkify-conversion. Only the links that has the same label as address will be converted to plain text.



<wash-html unlinkify='' keep-tags='br' keep-containers='a'>
  <a href="http://www.roxen.com">http://www.roxen.com</a><br />
  <a href="http://www.roxen.com">Roxen IS</a>
</wash-html>
http://www.roxen.com
Roxen IS

paragraphify

If more than one newline exists between two text elements, this attribute automatically makes the next text element into a paragraph.



<wash-html paragraphify=''>
A Paragraph

An other paragraph.
And some more text to the same paragraph.
</wash-html>

A Paragraph

An other paragraph. And some more text to the same paragraph.


unparagraphify

Turn paragraph breaks into double newlines instead.



<pre><wash-html unparagraphify=''>
<p>A Paragraph<p>

<p>An other paragraph.
And some more text to the same paragraph.</p>
</wash-html></pre>
A Paragraph

An other paragraph.
And some more text to the same paragraph.

The <pre> is only used in the example for layout-purposes.


close-tags

Terminate all tags with an ending slash, making them XML-compliant.