Module:Format link/doc - Revision history

Matt at 22:15, 9 April 2025

2025-04-09T22:15:23Z

← Older revision		Revision as of 17:15, 9 April 2025
Line 1:		Line 1:
	{{wikipedia\|page name}}		{{wikipedia\|page name}}
	<!-- Add categories where indicated at the bottom of this page and interwikis at Wikidata -->		<!-- Add categories where indicated at the bottom of this page and interwikis at Wikidata -->
	~~{{used in system\|in MediaWiki:Perfcachedts}}~~
	{{Lua\|Module:Arguments\|Module:Error\|Module:Yesno}}		{{Lua\|Module:Arguments\|Module:Error\|Module:Yesno}}
	This module, migrated from origins in Module:Hatnote, provides functionality for formatting links for display, including that powering the {{tl\|format link}} template.		This module, migrated from origins in Module:Hatnote, provides functionality for formatting links for display, including that powering the {{tl\|format link}} template.

Matt at 22:25, 8 April 2025

2025-04-08T22:25:37Z

← Older revision		Revision as of 17:25, 8 April 2025
Line 1:		Line 1:
	{{wikipedia\|page name}}		{{wikipedia\|page name}}
	<!-- Add categories where indicated at the bottom of this page and interwikis at Wikidata -->		<!-- Add categories where indicated at the bottom of this page and interwikis at Wikidata -->
	{{used in system\|in [[MediaWiki:Perfcachedts]]}}		{{used in system\|in MediaWiki:Perfcachedts}}
	{{Lua\|Module:Arguments\|Module:Error\|Module:Yesno}}		{{Lua\|Module:Arguments\|Module:Error\|Module:Yesno}}
	This module, migrated from origins in [[Module:Hatnote]], provides functionality for formatting links for display, including that powering the {{tl\|format link}} template.		This module, migrated from origins in Module:Hatnote, provides functionality for formatting links for display, including that powering the {{tl\|format link}} template.

	It can pretty-format section links with the section symbol ("§") and appropriate whitespace, it automatically escapes category and file names with the ~~[[Help:Colon trick\|~~colon trick]], and includes functionality for italicizing the page or section name, and for detecting and categorizing results that produce ~~[[Wikipedia:Red link\|~~red links]].		It can pretty-format section links with the section symbol ("§") and appropriate whitespace, it automatically escapes category and file names with the colon trick, and includes functionality for italicizing the page or section name, and for detecting and categorizing results that produce red links.

	== Use from wikitext ==		== Use from wikitext ==
	The functions in this module cannot be used directly from #invoke, and must be used through templates instead. Please see [[Template:Format link]] for documentation on usage of that template.		The functions in this module cannot be used directly from #invoke, and must be used through templates instead. Please see Template:Format link for documentation on usage of that template.

	== Use from other Lua modules==		== Use from other Lua modules==
Line 31:		Line 31:
	</syntaxhighlight>		</syntaxhighlight>

	Formats <var>link</var> as a wikilink. Categories and files are automatically escaped with the ~~[[Help:Colon trick\|~~colon trick]], and links to sections are automatically formatted as ''page § section'', rather than the MediaWiki default of ''page#section''.		Formats <var>link</var> as a wikilink. Categories and files are automatically escaped with the colon trick, and links to sections are automatically formatted as ''page § section'', rather than the MediaWiki default of ''page#section''.

	Several options modify the output:		Several options modify the output:
Line 55:		Line 55:
	</syntaxhighlight>		</syntaxhighlight>

	This derived function is useful for lists that format many links. It formats an array of pages using the ~~[[#~~_formatLink~~\|_formatLink]]~~ function, and returns the result as an array. Options in the <var>options</var> table are applied, and use the same names as the options for <var>_formatLink</var>.		This derived function is useful for lists that format many links. It formats an array of pages using the _formatLink function, and returns the result as an array. Options in the <var>options</var> table are applied, and use the same names as the options for <var>_formatLink</var>.

	;Example		;Example

Matt at 20:52, 5 March 2025

2025-03-05T20:52:21Z

← Older revision		Revision as of 15:52, 5 March 2025
Line 1:		Line 1:
			{{wikipedia\|page name}}
	<!-- Add categories where indicated at the bottom of this page and interwikis at Wikidata -->		<!-- Add categories where indicated at the bottom of this page and interwikis at Wikidata -->
	{{used in system\|in [[MediaWiki:Perfcachedts]]}}		{{used in system\|in [[MediaWiki:Perfcachedts]]}}

Matt: Protected "Module:Format link/doc": Initial wiki setup ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

2025-03-05T19:27:48Z

Protected "Module:Format link/doc": Initial wiki setup ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

← Older revision	Revision as of 14:27, 5 March 2025
(No difference)

Matt: Created page with " {{used in system|in MediaWiki:Perfcachedts}} {{Lua|Module:Arguments|Module:Error|Module:Yesno}} This module, migrated from origins in Module:Hatnote, provides functionality for formatting links for display, including that powering the {{tl|format link}} template. It can pretty-format section links with the section symbol ("§") and appropriate whitespace, it automatical..."

2025-03-04T18:02:47Z

Created page with " {{used in system|in MediaWiki:Perfcachedts}} {{Lua|Module:Arguments|Module:Error|Module:Yesno}} This module, migrated from origins in Module:Hatnote, provides functionality for formatting links for display, including that powering the {{tl|format link}} template. It can pretty-format section links with the section symbol ("§") and appropriate whitespace, it automatical..."

New page

{{used in system|in [[MediaWiki:Perfcachedts]]}}
{{Lua|Module:Arguments|Module:Error|Module:Yesno}}
This module, migrated from origins in [[Module:Hatnote]], provides functionality for formatting links for display, including that powering the {{tl|format link}} template.

It can pretty-format section links with the section symbol ("§") and appropriate whitespace, it automatically escapes category and file names with the [[Help:Colon trick|colon trick]], and includes functionality for italicizing the page or section name, and for detecting and categorizing results that produce [[Wikipedia:Red link|red links]].

== Use from wikitext ==
The functions in this module cannot be used directly from #invoke, and must be used through templates instead. Please see [[Template:Format link]] for documentation on usage of that template.

== Use from other Lua modules==
To load this module from another Lua module, use the following code:

<syntaxhighlight lang="lua">
local mFormatLink = require('Module:Format link')
</syntaxhighlight>

You can then use the functions as documented below.

=== _formatLink ===
<syntaxhighlight lang="lua">
mFormatLink._formatLink{
link = 'Link',
display = 'Display',
target = 'Target',
italicizePage = true,
italicizeSection = true,
categorizeMissing = 'Pages using formatted red links'
}
</syntaxhighlight>

Formats <var>link</var> as a wikilink. Categories and files are automatically escaped with the [[Help:Colon trick|colon trick]], and links to sections are automatically formatted as ''page § section'', rather than the MediaWiki default of ''page#section''.

Several options modify the output:
* If the <var>display</var> value is present, then it will be used as a display value. Any manual piping (using the <code><nowiki>{{!}}</nowiki></code> magic word or similar) present in <var>link</var> will be overridden by the <var>display</var> value if present.
* If the <var>target</var> value is present, then it will override <var>link</var> as a target, but the result will still be ''displayed'' using either the value from <var>display</var>, or the result of formatting <var>link</var>.
* If <var>italicizePage</var> is true, then the page portion of the link is italicized if present.
* If <var>italicizeSection</var> is true, then the section portion of the link is italicized if present.
* If <var>categorizeMissing</var> is a non-empty string, then that value is used as a category name, and that category will be applied if the resulting target of the link (no matter whether through <var>link</var> or through <var>target</var>) doesn't exist.

;Examples:
: <syntaxhighlight lang="lua" inline>mFormatLink._formatLink{link = 'Foo#Bar'}</syntaxhighlight> → <nowiki>[[:Foo#Bar|Foo §&nbsp;Bar]]</nowiki> → {{format link|Foo#Bar}}
: <syntaxhighlight lang="lua" inline>mFormatLink._formatLink{link = 'Baz', display = 'Qux'}</syntaxhighlight> → <nowiki>[[:Baz|Qux]]</nowiki> → {{format link|Baz|Qux}}
: <syntaxhighlight lang="lua" inline>mFormatLink._formatLink{link = 'Foo|Bar', display = 'Baz'}</syntaxhighlight> → <nowiki>[[:Foo|Baz]]</nowiki> → {{format link|Foo{{!}}Bar|Baz}}
: <syntaxhighlight lang="lua" inline>mFormatLink._formatLink{link = '#Foo', target = 'Example#Foo'}</syntaxhighlight> → <nowiki>[[:Example#Foo|§&nbsp;Foo]]</nowiki> → {{format link|#Foo||Example#Foo}}
: <syntaxhighlight lang="lua" inline>mFormatLink._formatLink{link = 'The Lord of the Rings#Plot', italicizePage = true}</syntaxhighlight> → <nowiki>[[:The Lord of the Rings#Plot|''The Lord of the Rings'' §&nbsp;Plot]]</nowiki> → {{format link|The Lord of the Rings#Plot|italicizepage=true}}
: <syntaxhighlight lang="lua" inline>mFormatLink._formatLink{link = 'Cybercrime Prevention Act of 2012#Disini v. Secretary of Justice', italicizeSection = true}</syntaxhighlight> → <nowiki>[[:Cybercrime Prevention Act of 2012#Disini v. Secretary of Justice|Cybercrime Prevention Act of 2012 §&nbsp;''Disini v. Secretary of Justice'']]</nowiki> → {{format link|Cybercrime Prevention Act of 2012#Disini v. Secretary of Justice|italicizesection=true}}
: <syntaxhighlight lang="lua" inline>mFormatLink._formatLink{link = 'Nonexistent page', categorizeMissing = 'Example'}</syntaxhighlight> → <nowiki>[[:Nonexistent page]][[Category:Example]]</nowiki> → {{format link|Nonexistent page}}
: <syntaxhighlight lang="lua" inline>mFormatLink._formatLink{link = 'Existing', categorizeMissing = 'Example'}</syntaxhighlight> → <nowiki>[[:Existing]]</nowiki> → {{format link|Existing}}

=== formatPages ===
<syntaxhighlight lang="lua">
mFormatLink.formatPages(options, pages)
</syntaxhighlight>

This derived function is useful for lists that format many links. It formats an array of pages using the [[#_formatLink|_formatLink]] function, and returns the result as an array. Options in the <var>options</var> table are applied, and use the same names as the options for <var>_formatLink</var>.

;Example
:{{code|<nowiki>mFormatLink.formatPages({categorizeMissing = 'Example'}, {'Foo#Bar', 'Nonexistent page'})</nowiki>|lua}} → {{code|<nowiki>{'[[:Foo#Bar|Foo § Bar]]', '[[:Nonexistent page]][[Category:Example]]'}</nowiki>|lua}}

== Errors ==

If <var>_formatLink</var> is used and neither a <var>link</var> nor a <var>target</var> argument is provided, then the module will produce an error message instead of its usual output, as it ''cannot'' then produce valid output.

You can solve this error by providing appropriate parameters to <var>_formatLink</var>, or you may want to ensure that a more descriptive error is provided by a downstream template or module when it would otherwise call <var>_formatLink</var> with inadequate arguments.

<includeonly>{{Sandbox other||

[[Category:Link modules]]
}}</includeonly><noinclude>
[[Category:Module documentation pages]]
</noinclude>