Module:UtilsMarkup

This module is for producing wikitext. See also Module:UtilsLayout.

This module exports the following functions.

Formatting

bold

bold(text)

Parameters

• text

  The text to bold.

Returns

• The bolded text.

Examples

Input	Output	Result	Status
bold("Fooloo Limpah")	"<b>Fooloo Limpah</b>"	Fooloo Limpah

caption

caption(text)

Returns

• Text in caption font, which is slightly smaller.

Examples

Input	Output	Result	Status
caption("Fooloo Limpah")	'<span class="caption">Fooloo Limpah</span>'	Fooloo Limpah

class

class(class, text)

Returns

• Text wrapped in a span tag with the given class string.

Examples

Input	Output	Result	Status
class("term error", "Fooloo Limpah")	'<span class="term error">Fooloo Limpah</span>'

code

code(text)

Parameters

• text

  The text to render monospaced.

Returns

• The formatted text.

Examples

Input	Output	Result	Status
code("code stuff")	"<code>code stuff</code>"	code stuff

heading

heading(level, text)

Parameters

• level

  The heading level.

• text

  The heading text.

Returns

• string of text for the heading

Examples

Input	Output	Status
heading(2, "Section")	"\n==Section==\n"
heading(3, "Sub-section")	"\n===Sub-section===\n"

italic

italic(text)

Parameters

• text

  The text to italicize.

Returns

• The italicized text.

Examples

Input	Output	Result	Status
italic("Fooloo Limpah")	"<i>Fooloo Limpah</i>"	Fooloo Limpah

inline

inline(text, [options])

Parameters

• text

• [options]

  Formatting options are applied in the reverse order in which they are listed below. In other words, nowiki is always the outermost tag and i is always the innermost.

  [nowiki]

  [caption]

  [code]

  [class]

  [tooltip]

  [bold]

  [italic]

Returns

• The formatted text.

Examples

Input	Output	Result	Status
inline( "Fooloo Limpah", { bold = true, italic = true, class = "error", tooltip = "Don't steal them!", } )	"<span class=\"error\"><span title=\"Don't steal them!\" class=\"explain\"><b><i>Fooloo Limpah</i></b></span></span>"
inline( "{{Foo}}", { bold = true, nowiki = true, code = true, } )	"<b><code>&#123;&#123;Foo&#125;&#125;</code></b>"	{{Foo}}

lua

lua(text, [options])

Parameters

• text

  A string of text to format as Lua code.

• [options]

  [wrapLines=true]

  If set to false, prevents lines from wrapping by setting white-space to pre.

Returns

• A block of pre-formatted, syntax-highlighted Lua code

Examples

Input	Result
lua("function(foo) \n\treturn foo\nend")	function(foo) return foo end

pre

pre(text, [options])

Parameters

• text

  Text to render as preformatted.

• [options]

  [wrapLines=true]

  If set to false, prevents lines from wrapping by setting white-space to pre.

Returns

• A block of pre-formatted text.

Examples

Input	Result
pre("{{List\n |foo\n |bar\n |baz\n}}")	{{List |foo |bar |baz }}

tooltip

tooltip(baseText, tooltipText, [type])

Parameters

• baseText

  The text to receive a tooltip.

• tooltipText

  The text to display on hover.

• [type]

  If "highlight", colors the base text to make the presence of tooltip text more evident.

Returns

• Text with a tooltip.

Examples

Input	Output	Result	Status
tooltip("hover over me", "hello world!")	'<span title="hello world!" class="explain">hover over me</span>'	hover over me
tooltip("foo", "bar", "highlight")	'<span title="bar" class="explain" style="color:yellow">foo</span>'	foo

Links

link

link(page, [display], [noBacklink])

Parameters

• page

  The link target. Can be the name of a page on the wiki or an external URL.

• [display=page]

  The text to display for the link.

• [noBacklink]

  When true, renders an internal link such that it does not register on the Special:WhatLinksHere of the target page.

  Use only when certain that the page exists. This method cannot render red-links (i.e. distinguish non-existent pages).

Returns

• A string of wikitext that evaluates to a link. Will display a red link if the target is an internal link to a page that doesn't exist.

Examples

Input	Output	Result	Status
Internal link
link("Princess Zelda")	"[[Princess Zelda]]"	Princess Zelda
Link to page that doesn't exist
link("Flippityfloppityfloo")	"[[Flippityfloppityfloo]]"	Flippityfloppityfloo
Piped link
link("Princess Zelda", "Zelda")	"[[Princess Zelda|Zelda]]"	Zelda
Category link
link("Category:Items")	"[[:Category:Items]]"	Category:Items
Category link without prefix
link("Category:Items", "")	"[[:Category:Items|Items]]"	Items
Category link with display text
link( "Category:Items in Breath of the Wild", "Items in ''Breath of the Wild''" )	"[[:Category:Items in Breath of the Wild|Items in ''Breath of the Wild'']]"	Items in Breath of the Wild
File link (to file description)
link("File:MM Deku Butler Artwork.png")	"[[:File:MM Deku Butler Artwork.png]]"	File:MM Deku Butler Artwork.png
External link
link("https://www.mariowiki.com/Thwomp", "Thwomp")	"[https://www.mariowiki.com/Thwomp Thwomp]"	Thwomp
Looks like an internal link, but it's actually an external link. This is to avoid Special:WhatLinksHere
link("Princess Zelda", "Zelda", true)	'<span class="plainlinks">[https://zelda.fandom.com/Princess_Zelda Zelda]</span>'	Zelda
When noBacklink is set to true, red links are not rendered for pages which do not exist, for performance reasons.
link("Flippityfloppityfloo", nil, true)	'<span class="plainlinks">[https://zelda.fandom.com/Flippityfloppityfloo Flippityfloppityfloo]</span>'	Flippityfloppityfloo

sectionLink

sectionLink(page, [section], [display])

Parameters

• page

  The name of a wiki page to target.

• [section]

  The name of the page section to target.

• [display=page]

  The text to display for the link.

Returns

• A string of wikitext rendering a section link.

Examples

Input	Output	Result	Status
sectionLink("Link", "Ocarina of Time", "Hero of Time")	"[[Link#Ocarina of Time|Hero of Time]]"	Hero of Time
sectionLink("Link", nil, "Hero of Time")	"[[Link|Hero of Time]]"	Hero of Time
sectionLink("Link", "")	"[[Link#]]"	Link#

file

file(name, [options])

Parameters

• name

  A file name, with or without the File: prefix.

• [options]

  [size]

  Image size in pixels.

  [link]

  Name of a page on the wiki or an external URL for the image thumbnail to link to.

  [caption]

  Alt text for the image.

  [noBacklink]

  When true, the link property is rendered such that it does not register on the Special:WhatLinksHere of the target page. It also does not register on Special:WantedPages if the page doesn't exist.

Returns

• A string of wikitext that renders a thumbnail for the file.

Examples

Input	Output	Result	Status
file("File:ALttP Ganon Sprite.png")	"[[File:ALttP Ganon Sprite.png]]"
file( "ALttP Ganon Sprite.png", { caption = "Ganon", link = "", } )	"[[File:ALttP Ganon Sprite.png|link=|Ganon]]"
file( "File:TWW Great Fairy Figurine Model.png", { size = "100px", link = "Great Fairy", } )	"[[File:TWW Great Fairy Figurine Model.png|100px|link=Great Fairy]]"
file( "File:TWW Great Fairy Figurine Model.png", { noBacklink = true, size = "100px", link = "Great Fairy", } )	"[[File:TWW Great Fairy Figurine Model.png|100px|link=https://zelda.fandom.com/wiki/Great_Fairy]]"

category

category(name, [sortKey])

Parameters

• name

  The name of the category to link to (with or without namespace prefix).

• [sortKey]

  A custom sort key for the category entry.

Returns

• A category link—the kind that adds a category to a page. For the other kind that links to the actual category page, use link.

Examples

Input	Output	Status
Category link from category name
category("Items")	"[[Category:Items]]"
Category link from category name with namespace prefix
category("Category:Items")	"[[Category:Items]]"
Category link with sort key
category("Items", "*")	"[[Category:Items|*]]"

categories

categories(names)

Parameters

• names

  An array of category names, with or without the namespace prefix.

Returns

• A concatenated string of category links.

Examples

Input	Output	Status
categories({"Link", "Category:Zelda", "Category:Ganon"})	"[[Category:Link]][[Category:Zelda]][[Category:Ganon]]"
categories({})	""

containsLink

containsLink(wikitext)

Returns

• Given a string of wikitext, returns true if it contains an internal or interwiki link, false otherwise.

Examples

Input	Output	Status
containsLink("There is a [[Link]]")	true
containsLink("[Link] is not a link but rather an indication of replaced words in a quote.")	false

killBacklinks

killBacklinks(wikitext)

Parameters

• wikitext

  A string of wiki markup.

Returns

• The same wikitext but with all the internal links formatted as external links, to avoid additions to Special:WhatLinksHere.

Examples

Input	Output	Result	Status
Escapes basic article links - unfortunately non-existent pages are not rendered as red links for performance reasons
killBacklinks("[[Link]], [[Princess Zelda|Zelda]], and [[Jean-Guy Rubber Boots]]")	'<span class="plainlinks">[https://zelda.fandom.com/Link Link]</span>, <span class="plainlinks">[https://zelda.fandom.com/Princess_Zelda Zelda]</span>, and <span class="plainlinks">[https://zelda.fandom.com/Jean-Guy_Rubber_Boots Jean-Guy Rubber Boots]</span>'	Link, Zelda, and Jean-Guy Rubber Boots
Does not escape file links or category links
killBacklinks("[[Category:Link]] and [[File:SS Blessed Butterfly Icon.png]]")	"[[Category:Link]] and [[File:SS Blessed Butterfly Icon.png]]"	and
Escapes visible file and category links
killBacklinks("[[:Category:Link]], [[:Category:Princess Zelda|Zelda]], and [[:File:SS Blessed Butterfly Icon.png]]")	'<span class="plainlinks">[https://zelda.fandom.com/Category:Link Category:Link]</span>, <span class="plainlinks">[https://zelda.fandom.com/Category:Princess_Zelda Zelda]</span>, and <span class="plainlinks">[https://zelda.fandom.com/File:SS_Blessed_Butterfly_Icon.png File:SS Blessed Butterfly Icon.png]</span>'	Category:Link, Zelda, and File:SS Blessed Butterfly Icon.png
Does not affect interwiki links
killBacklinks("[[metroidwiki:Chozo|Chozo]]")	"[[metroidwiki:Chozo|Chozo]]"	Chozo

stripCategories

stripCategories(wikitext)

Parameters

• wikitext

  A string of wiki markup.

Returns

• The string of wiki markup with all the category links removed (not including visual links to category description pages).
• A table array of direct links to the removed categories.

Examples

Input	Output	Status
Basic use case
stripCategories("<[[Category:Link]][[Category:Princess Zelda]][[Category:Link]]>")	"<>"
	{ "[[:Category:Link]]", "[[:Category:Princess Zelda]]", }
Does not affect visual links to category description pages
stripCategories("[[:Category:Link]] and [[:Category:Princess Zelda]]")	"[[:Category:Link]] and [[:Category:Princess Zelda]]"
	{}

Lists

list

list(items)

Parameters

• items

  An array of strings (list items).

Returns

• An unordered list with the plainlist class.

Examples

Input	Output	Result	Status
list({})	""
list({"single item"})	'<ul class="plainlist"><li>single item</li></ul>'	single item
list({"multiple", "items", ""})	'<ul class="plainlist"><li>multiple</li><li>items</li><li></li></ul>'	multiple items

bulletList

bulletList(items)

Parameters

• items

  An array of strings (list items).

Returns

• A string representation of an unordered list using HTML syntax.

Examples

Input	Output	Result	Status
bulletList({})	""
bulletList({"single item"})	"<ul><li>single item</li></ul>"	single item
bulletList({"multiple", "items", ""})	"<ul><li>multiple</li><li>items</li><li></li></ul>"	multiple items
bulletList({ "list", { "with", {"nested", "items"}, "inside", }, })	"<ul><li>list</li><ul><li>with</li><ul><li>nested</li><li>items</li></ul><li>inside</li></ul></ul>"	list with nested items inside

numberList

numberList(items)

Parameters

• items

  An array of strings (list items).

Returns

• A string representation of an ordered list using HTML syntax.

Examples

Input	Output	Result	Status
numberList({})	""
numberList({"single item"})	"<ol><li>single item</li></ol>"	single item
numberList({"multiple", "items", ""})	"<ol><li>multiple</li><li>items</li><li></li></ol>"	multiple items
numberList({ "list", { "with", {"nested", "items"}, "inside", }, })	"<ol><li>list</li><ol><li>with</li><ol><li>nested</li><li>items</li></ol><li>inside</li></ol></ol>"	list with nested items inside
numberList({"Eight", "Nine", "Ten", start = 8})	'<ol start="8"><li>Eight</li><li>Nine</li><li>Ten</li></ol>'	Eight Nine Ten

definitionList

definitionList(pairs)

Parameters

• pairs

  Array of table of pairs where the first pair item is a term and the value is a definition.

Returns

• A string representation of a definition list using HTML syntax.

Examples

Input	Result	Status
definitionList({})
definitionList({ {"key1", "value1"}, })	key1 value1
definitionList({ {"key1", "value1"}, {"key2", "value2"}, })	key1 value1 key2 value2
definitionList({ {"", "value1"}, {[2] = "value2" }, {"key3", ""}, {"key4"}, })	value1 value2 key3 key4
definitionList({ { "key 1", { { "key 1.1", { {"key 1.1.1", "value 1.1.1"}, }, }, {"key 1.2", "value 1.2"}, }, }, {"key2", "value2"}, })	key 1 key 1.1 key 1.1.1 value 1.1.1 key 1.2 value 1.2 key2 value2
definitionList({ { "key 1", "value 1.1", { {"key 1.1", "value 1.2"}, {"key 1.2", "value 1.2"}, }, }, })	key 1 value 1.1 key 1.1 value 1.2 key 1.2 value 1.2

---

local utilsPackage = require("Module:UtilsPackage")

return utilsPackage.submodules({
	"Module:UtilsMarkup/Format",
	"Module:UtilsMarkup/Link",
	"Module:UtilsMarkup/List",
}, {
	"Formatting", 
	"Links",
	"Lists",
})