Template:Pre: Difference between revisions
| [checked revision] | [checked revision] |
Content deleted Content added
Caleb Cooper (talk | contribs) Created page with "<pre<includeonly></includeonly> style="white-space: {{{space|pre-wrap}}}; {{#ifeq:{{{border|}}}|no|border:none !important;}} {{#if:{{{width|}}}|width: {{{width}}};}}"><!-- -->..." |
Caleb Cooper (talk | contribs) No edit summary |
||
| Line 20: | Line 20: | ||
-->{{#if:{{{19|}}}|{{!}}{{{19}}}|}}<!-- |
-->{{#if:{{{19|}}}|{{!}}{{{19}}}|}}<!-- |
||
-->{{#if:{{{20|}}}|{{!}}{{{20}}}|}}<!-- |
-->{{#if:{{{20|}}}|{{!}}{{{20}}}|}}<!-- |
||
--></pre> |
--></pre><noinclude> |
||
This template implements a version of the functionality provided by the [[HTML]] {{tag|pre|o}} tag. |
|||
===Usage=== |
|||
This template supports two parameters |
|||
{{para|width}} The width of the pre "box" <br> |
|||
{{para|space}} The way white space is handled in the pre "box" |
|||
{{markup |
|||
|<nowiki>{{Pre| |
|||
This Pre-format |
|||
can look |
|||
like this. |
|||
}}</nowiki> |
|||
|{{Pre| |
|||
This Pre-format |
|||
can look |
|||
like this. |
|||
}} |
|||
}} |
|||
Main differences include: |
|||
* It wraps text that overflows the page. |
|||
* It allows mid-line-breaks (but not always consistently). |
|||
Main limitations include: |
|||
* If the text is a single long word, it won't be wrapped and will still break out to the right hand of the page. |
|||
* HTML and wikimarkup aren't disabled as in {{tag|pre}} and are rendered as usual (thus if a parameter contains any wikimarkup, enclose it in {{tag|nowiki}}); however, multiple spaces are preserved. |
|||
As with {{tag|pre|o}} and {{tag|code|o}}, {{tl|pre}} displays text in the font specified as the monospace font in the user's browser options, or specified in the user's CSS pages. |
|||
===Example=== |
|||
'''Markup''' |
|||
<pre> |
|||
{{Pre| |
|||
'''First line, markup working:''' and HTML comment <!--HIDDEN--> hidden. |
|||
'''Second line, long text wrapping:''' all work and no play make jack a dull boy all work and no play make jack a dull boy all work and no play make jack a dull boy all work and no play make jack a dull boy all work and no play make jack a dull boy. |
|||
'''Third line with raw | pipe is handled''', but the space before the pipe is lost. Up to raw 20 pipes are handled, else use <nowiki><nowiki></nowiki>{{!}}<nowiki></nowiki></nowiki> and {{!}} it's {{!}} OK. |
|||
'''Fourth line, multiple spaces preserved''' unlike in HTML and wikitext. |
|||
'''Fifth line, following the previous one'''. |
|||
'''Last line''' preceded by two blank lines in markup and in display. |
|||
}} |
|||
</pre> |
|||
; Result |
|||
{{Pre| |
|||
'''First line, markup working:''' and HTML comment <!--HIDDEN--> hidden. |
|||
'''Second line, long text wrapping:''' all work and no play make jack a dull boy all work and no play make jack a dull boy all work and no play make jack a dull boy all work and no play make jack a dull boy all work and no play make jack a dull boy. |
|||
'''Third line with raw | pipe is handled''', but the space before the pipe is lost. Up to raw 20 pipes are handled, else use <nowiki><nowiki></nowiki>{{!}}<nowiki></nowiki></nowiki> and {{!}} it's {{!}} OK. |
|||
'''Fourth line, multiple spaces preserved''' unlike in HTML and wikitext. |
|||
'''Fifth line, following the previous one'''. |
|||
'''Last line''' preceded by two blank lines in markup and in display. |
|||
}} |
|||
</noinclude> |
|||
Revision as of 11:43, 13 July 2020
Sample text
This template implements a version of the functionality provided by the HTML <pre> tag.
Usage
This template supports two parameters
|width= The width of the pre "box"
|space= The way white space is handled in the pre "box"
| Markup | Renders as |
|---|---|
{{Pre|
This Pre-format
can look
like this.
}}
|
This Pre-format can look like this. |
Main differences include:
- It wraps text that overflows the page.
- It allows mid-line-breaks (but not always consistently).
Main limitations include:
- If the text is a single long word, it won't be wrapped and will still break out to the right hand of the page.
- HTML and wikimarkup aren't disabled as in
<pre>...</pre>and are rendered as usual (thus if a parameter contains any wikimarkup, enclose it in<nowiki>...</nowiki>); however, multiple spaces are preserved.
As with <pre> and <code>, {{pre}} displays text in the font specified as the monospace font in the user's browser options, or specified in the user's CSS pages.
Example
Markup
{{Pre|
'''First line, markup working:''' and HTML comment <!--HIDDEN--> hidden.
'''Second line, long text wrapping:''' all work and no play make jack a dull boy all work and no play make jack a dull boy all work and no play make jack a dull boy all work and no play make jack a dull boy all work and no play make jack a dull boy.
'''Third line with raw | pipe is handled''', but the space before the pipe is lost. Up to raw 20 pipes are handled, else use <nowiki>{{!}}</nowiki> and {{!}} it's {{!}} OK.
'''Fourth line, multiple spaces preserved''' unlike in HTML and wikitext.
'''Fifth line, following the previous one'''.
'''Last line''' preceded by two blank lines in markup and in display.
}}
- Result
First line, markup working: and HTML comment hidden. Second line, long text wrapping: all work and no play make jack a dull boy all work and no play make jack a dull boy all work and no play make jack a dull boy all work and no play make jack a dull boy all work and no play make jack a dull boy. Third line with raw| pipe is handled, but the space before the pipe is lost. Up to raw 20 pipes are handled, else use <nowiki>|</nowiki> and | it's | OK. Fourth line, multiple spaces preserved unlike in HTML and wikitext. Fifth line, following the previous one. Last line preceded by two blank lines in markup and in display.