Template:CodeBox

From Gentoo Wiki
Jump to:navigation Jump to:search
[edit

Documentation

Note
This page is a template. It contains some standardized, often used text, which can be transcluded inside other pages. As this template is widely used in our wiki, it may be protected in which case only staff members can change it. Use the discussion page to propose enhancements or fixes, or to voice your opinion.

Displays a block element containing code, optionally providing syntax highlighting. A list of recognized languages for syntax highlighting can be found here.

Important
File contents may contain the special characters | or = which are incompatible with MediaWiki's templating system. Substitute | with {{!}} and = with {{=}} for arguments to the 1= parameter for correct template usage. If substitution is ignored, then formatting will not work correctly with this template.

Parameters

Displays a block element containing code, optionally providing syntax highlighting

Template parameters

ParameterDescriptionTypeStatus
Code1

no description

Contentrequired
Titletitle

Additional title to display in the box header

Contentsuggested
Languagelang

Language of the contents, used for syntax highlighting

Default
text
Example
bash
Stringsuggested

Usage

See the template's testcases:

No parameter
Wiki code {{CodeBox}}

Main version
CODE
{{{1}}}
Sandbox version
CODE
{{{1}}}
</nowiki>

}} </noinclude>

Parameters: 1=Some code.
Wiki code {{CodeBox|1=Some code.}}

Main version
CODE
Some code.
Sandbox version
CODE
Some code.
</nowiki>

}} </noinclude>

Parameters: title=CodeBox example with title, 1=And with some code.
Wiki code {{CodeBox|title=CodeBox example with title|1=And with some code.}}

Main version
CODE CodeBox example with title
And with some code.
Sandbox version
CODE CodeBox example with title
And with some code.
</nowiki>

}} </noinclude>

Parameters: title=CodeBox example with title, lang=bash, 1=#!/bin/bash echo "Hello, world!"
Wiki code {{CodeBox|title=CodeBox example with title|lang=bash|1=#!/bin/bash echo "Hello, world!" }}

Main version
CODE CodeBox example with title
#!/bin/bash
echo "Hello, world!"
Sandbox version
CODE CodeBox example with title
#!/bin/bash
echo "Hello, world!"
</nowiki>

}} </noinclude>

See also

Note
The above documentation is transcluded from Template:CodeBox/doc. (edit | history)
Editors can experiment in this template's sandbox (edit) and testcases (edit) pages.
Please add categories and interwikis to the /doc subpage. (See the subpages of this template.)