sitefaqlet
SiteDocClan
<!--
2003-05-23 [Mr. Muskrat] link to FAQ by id
2003-05-21 [Mr. Muskrat] s/Perl Monks/PerlMonks/
2004-01-21 [jdporter] clarified section on angle brackets, per [castaway].
2004-01-22 [jdporter] removed obsoleted link to [id://119681]
-->
<H2>URLs</H2>
<P>Yes, you can create links in the CB! <br/>
See [id://43037]
<H2>Special Characters</H2>
<dl><dd>
<H3>Escaped HTML</H3>
Escaped HTML such as <code>&</code> or <code>—</code> will print differently depending on whether you are sending a public message or a private message. In public messages, the escaped HTML will be printed "as is". Private messages <i>do</i> accept
escaped HTML though.
<H3>Angle brackets</H3>
<p>The chatterbox attempts to parse things that look like HTML tags, and it generally does a pretty good job. If text surrounded by angle brackets looks like an HTML tag, the chatterbox will either:<ul>
<li> leave it in the text stream, if it is allowed HTML;
<li> remove it, if it is "unallowed"/pseudo HTML; or
<li> replace it with something appropriate. </ul>
If the angle-enclosed text does not look like HTML, then the chatterbox leaves the text as you wrote it, except that the angle brackets themselves are converted to numeric entities, so that they render correctly in people's browsers.
<P>
Cases like these (allowed HTML or clearly not HTML) are rendered as expected:
<ul>
<li><tt><i><a href="http://www.perl.org/">Perl</a></i></tt> prints <tt><i><a href="http://www.perl.org/">Perl</a></i></tt> in the chatterbox
<li><em><tt>if ( $a < $b && $c > $d ) ...</em></tt> - is rendered as shown
</ul>
Cases like these (unallowed/pseudo HTML) are stripped from the text stream:
<ul>
<li><em><tt><hr></em></tt>
<li><em><tt><foo></em></tt>
</ul>
<H3>Square brackets</H3>
<P>Because square brackets are used in the Everything code for easy linking between pages, you cannot use them to enclose anything you don't want linked. They may be used separately
or inside out, however.
<P>Valid cases:
<BR><em><tt>[:) brrr!</em></tt>
<BR><em><tt>who would ever use ][ in the chatterbox?</em></tt>
<BR>Invalid cases:
<BR><em>[login]<tt></em></tt> prints [login]
<p>As a quick work around you can type [[] and
this will fool the chatterbox into creating a link to a
node called [ so $arr[[]0] becomes
$arr[[]0]
<H3>Other Special Characters</H3>
All other special characters may be typed as is. (Unicode??)
</dd></dl>
<H2>Code</H2>
When you type code in the chatterbox, you should normally enclose it in
<c><code></c> tags. This prevents the CB from possibly interpreting and changing your code. For example,
if you want to type the following code:
<blockquote>
<c>$array[$i]</c>
</blockquote>
and you don't put it in <c><code></c> tags, it will come out looking like this:
<blockquote>
$array[$i]
</blockquote>
Even more drastic things can happen if your code contains angle brackets!
<hr/><i>Back to the [PerlMonks FAQ]</i>