sitefaqlet
SiteDocClan
<h2><a name="display"></a>Display Settings</h2>
<p>
Use [id://450961] to control how pages appear generally.
This covers not only HTML styling (CSS), but also various
PerlMonks-specific options, such as how <c><code></c>,
<c><readmore></c>, and <c><spoiler></c> tags are handled.
</p>
<h4><a name="tagopts"></a>Special Tag Options</h4>
<p>
<b>Override <c><readmore></c> tags:</b> users are requested
to insert a <c><readmore></c> tag in a post that
contains a long code section. In order to keep page lengths
short in certain areas of the site, the remainder of the post
will be replaced by a link to the full content of the post.
Check this box if you would rather ignore the
<c><readmore></c> tags and see the full text everywhere.
</p>
<p>
<i>render spoiler tags as</i>
</p>
<p>
<b>Customize CPAN link options:</b>
This modifies the effect of the <c>[cpan://...]</c> [id://43037|shortcut] style.
If this variable is unset (empty), <c>[cpan://Foo]</c> will render as the link
<tt>http://search.cpan.org/search?query=Foo&<b>mode=module</b></tt><br/>
If this variable is set, <tt><b>mode=module</b></tt> will be replaced with the
contents of this variable.
Possibilities for <c>mode</c> are: <c>qw( all module dist author )</c>.
Additionally, you can ask to get [cpan://] search results in XML form by
including
<c>format=xml</c> in this setting. (Note, however, that this feature is
[http://search.cpan.org/faq.html#Can_I_get_the_results_to_be_output_in_XML_format?|not supported].)
<br/>
Remember, <i>this setting affects how cpan:// links work for <b>you</b>.</i>
<p>
<h4><a name="html"></a>HTML Related Options</h4>
<p>
As you know, PerlMonks allows only a restricted subset of HTML
to be used in posts. (See [id://29281] for the list or [id://674668]
for illustrations of usage and rendering.) This is enforced each time
a node is rendered, not when the content is submitted by the poster.
When a node is rendered, it is filtered through a process which escapes
all the invalid markup — whether invalid tags, or invalid attributes on
valid tags — thus rendering the markup visible as plain text.
As an additional nicety, the same filter can —
if you ask it to — close unclosed tags as necessary to ensure
balanced tags.
</p><p>
If you're curious about the operation of this filter on the nodes
you view, you can enable "reporting" to various degrees of verbosity.
That's what the following settings do.
</p>
<ul>
<li><b>Enforce proper nesting of HTML</b> -
If set, PerlMonks adds explicit closing tags in cases where an element was
<i>implicitly</i> closed due to the ending of an outer element.
</li><br/>
<li><b>HTML error reporting level</b> -
This controls how much you are told about what PerlMonks had to do
to a node's content to make it compliant with [id://29281].
By default, these little notes will be shown in a medium gray font.
This can be customized with CSS:<ul>
<li>Markup which has been added will be in <c><font class="htmlinserted"></c></li>
<li>Tags which have been escaped will be in <c><font class="htmlignored"></c></li>
<li>Attributes which have been escaped will be in <c><font class="htmlattrib"></c></li>
</ul>
Here's what the different levels mean:
<ol start=0>
<li>No reporting. All HTML filtering is completely "silent".</li>
<li>Show when markup had to be added.</li>
<li>Show when attributes had to be escaped.</li>
<li>Show when tags had to be escaped.</li>
<li>Show when tags had to be escaped, and also when there are unclosed <c><p></c> tags.</li>
</ol>
The levels are cumulative: level 3 implies level 2, etc.<br/>
Note that level 4 is not an option for viewing nodes in general, since unclosed
<c><p></c> tags is an extremely minor sin which pretty much always be overlooked.
<!--
"level 3 and above will likely eventually be disabled except for one's own nodes,"
saith [tye] in cb on 2007-05-14
-->
<br/><br/>
<i>A word from your [gods|sysadmins]:</i> Harrassing other users for
the perceived low quality of their postings markup will not be tolerated.
</li><br/>
<li><b>HTML error reporting during Preview</b> -
This setting is the same as above, but only pertains to the
Preview stage of the node posting process.
Note that you can't select any level lower than 3.
This is because we want you to post good, clean nodes!
</li>
</ul>
<h4><a name="titles"></a>Custom Node Title Definition</h4>
<p>
You may customize the text that appears in your browser's title
bar here. Use the tokens %T, %N, %D and %S to insert the current
node's title, node id, date, or section name. The section name
will only actually appear for base nodes.
</p>
<h4><a name="code"></a>Code Listing Settings</h4>
<ul>
<li><b>Code Wrapping Off:</b> by default, the site will
wrap all content that appears between <c><code></c> tags at
70 columns. you can turn that off if you wish, but it can
be difficult to read the site as unwrapped code will be
rendered at the full width. This can mean a lot of
horizontal scrolling to see the right hand side of the
page.</li><br/>
<li><b>Code Wrap Length:</b> you may set the column at
which code will be wrapped.</li><br/>
<li><b>Auto Code Wrapping:</b> allows your browser to
perform code wrapping. If this is set, the value in
<b>Code Wrap Length</b> can be used to insert soft hyphens
in long runs of non-space characters.</li><br/>
<a name="code_prefix"></a>
<li><b>Code Prefix:</b> whatever you enter here will be
used as a prefix for lines inside <c><code></c> blocks.
If you specify something that matches <c>/&\d+;/</c>,
then those digits will be incremented for each line of code.
Typically you would specify <c>&001;: </c> to have all code
lines numbered starting from 001. <i>Note - This is <u>not</u>
an HTML entity, although it was meant to look like one.
It is specially interpreted by the perlmonks engine.</i></li><br/>
<li><b>Large Code Font:</b> This setting increases
the font size of everything posted within <c><code></code></c> tags (or
<code><c></c></code> tags).
</p><p>
Normally, when text in a fixed-pitch font (such as Courier) is shown
next to text in a variable-pitch font (such as Times) <i>in the same
size</i>, (e.g. 12 point), the fixed-width text appears noticeably larger.
To compensate for this and achieve a more equal-looking text size,
PerlMonks normally decreases the size of code text by one point, by
enclosing it in <tt><font size="-1"></tt> tags.
If you wish to disable this feature, you should check this setting checkbox.
You would do this, for example, if you are handling your own font sizing
in CSS. Block-level code blocks are wrapped in
<tt><tt class="codetext"></tt>
and in-line code blocks are wrapped in
<tt><tt class="inlinecode"></tt>.
In CSS, you'd define styles using <tt>tt.codetext</tt> and
<tt>tt.inlinecode</tt> respectively.
However, you may simply wish to set all <c><tt></c> segments
to one point size smaller, via <code>
tt { font-size: smaller; }
</code>
in your custom CSS.
</li><br/>
</ul>
<h4><a name="theme"></a>Theme Configuration</h4>
<p>
The appearance of the PerlMonks site can be changed by
choosing from one of several themes. You can stay with the
default or pick a specialized theme. The dark theme
exists for the people who prefer light text on dark
backgrounds. Choosing a theme other than the default makes
it easy to remember if you are logged in or not. "Monk
pictures off" turns off the random monk picture in the top
right corner of every page, while "Monk quips off" turns off
the pithy quotes on the top left.
</p>
<h4><a name="styles"></a>[href://?node_id=450961#Stylesheet-Settings|Stylesheet Settings]</h4>
<p>
In addition to the themes above, you can alter the
appearance of the PerlMonks site with your own custom
CSS stylesheets.
</p>
<ul>
<li><i>Link to external CSS stylesheet:</i> You can link
to a stylesheet you maintain on another webserver by
entering the stylesheet's URL here. This stylesheet will be loaded
after any stylesheets specified for your selected theme.
<li><i>On-Site CSS Markup:</i> Any CSS code you enter here
will be inserted into all pages you view.
<li><i>Link to CSS stylesheet for print display type:</i>
At the top of each page just under the title are two
links labeled "print" and "xml". The print link causes
the current page to be redisplayed in a format suitable
for printing. You can alter this format by specifying a
stylesheet to use for print display type.
</ul>
<hr/>
<p>
<i>Back to the [PerlMonks FAQ]</i>.
</p>