Template:CodeBox/doc

From HPC Wiki
Revision as of 10:53, 16 December 2016 by Bgo (talk | contribs) (Protected "Template:CodeBox/doc" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite)))
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to:navigation Jump to:search
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
Your contents may contain special characters (| or =) that break the MediaWiki templating system. You have these options to put the contents (in order from preferred to rather-not-use) if you need to escape these characters:
  1. {{CodeBox|1=contents}}
  2. {{CodeBox|<nowiki>contents</nowiki>}}
  3. {{CodeBox|<pre>contents</pre>}} (Syntax highlighting is broken using this invocation!)

Parameters

Parameter name Required? Default value Description
Anonymous parameter 1 Yes (n/a) Code
title No (n/a) Additional title to display in the box header
lang No text Language of the contents, used for syntax highlighting

Usage

See the template's testcases:

No parameter
Wiki code {{CodeBox}}

Main version Template:XYZ
Sandbox version Template:XYZ/sandbox
Parameters: 1=Some code.
Wiki code {{CodeBox|1=Some code.}}

Main version
CODE
Some code.
Sandbox version
CODE
Some code.
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 tile
And with some code.
Sandbox version
CODE CodeBox example with title
Some code.
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!"

See also