Module:GetShortDescription/doc: Difference between revisions

Revision as of 07:23, 30 January 2023

Latest revision as of 11:29, 29 August 2024

(10 intermediate revisions by 3 users not shown)

Line 1:

{{distinguish|Module:Get rating|betashort description}}

{{Lua|Module:Lang rating|protected}}

{{High-use}}

{{info|This module is required by [[Module:AnnotatedLink]].}}

{{Lua|Module:Arguments|Module:Lang}}

{{info|This module is required by [[Module:AnnotatedLinkAnnotated link]].}}

{{info|This module may, by design, output alarming informational messages under certain circumstances; if these messages are displayed on any page invoking this module directly or via any other module or template using it, the page will be added to [[:Category:Pages displaying alarming messages about Module:GetShortDescription]].}}

Line 11 ⟶ 13:

If the result is a wikidata description, and it is declared (at the source) as being of a foreign language (i.e. not ''en''), the result will be appropriately formatted by [[Module:Lang]] (the module powering {{tlx|lang}}), in accordance with [[MOS:OTHERLANG]]; see [[#Foreign language wikidata descriptions]] (below).

:'''Markup:''' <code><nowiki>{{#invoke:GetShortDescription|main |name=Example Wikipedia}}</nowiki></code>

:'''Result:''' {{#invoke:GetShortDescription|main|name=ExampleWikipedia}}

This is equivalent to stating {{para|prefer|explicit}}; see [[#prefer]] (below).

Line 19 ⟶ 21:

==== explicit ====

:'''Markup:''' <code><nowiki>{{#invoke:GetShortDescription|main |name=ExampleWikipedia |only=explicit }}</nowiki></code>

:'''Result:''' {{#invoke:GetShortDescription|main|name=ExampleWikipedia|only=explicit}}

==== wikidata ====

:'''Markup:''' <code><nowiki>{{#invoke:GetShortDescription|main |name=ExampleWikipedia |only=wikidata }}</nowiki></code>

:'''Result:''' {{#invoke:GetShortDescription|main|name=ExampleWikipedia|only=wikidata}}

=== prefer ===

Line 30 ⟶ 32:

==== explicit or wikidata ====

:'''Markup:''' <code><nowiki>{{#invoke:GetShortDescription|main |name=ExampleWikipedia |prefer=explicit }}</nowiki></code>

:'''Result:''' {{#invoke:GetShortDescription|main|name=ExampleWikipedia |prefer=explicit}}

==== wikidata or explicit ====

:'''Markup:''' <code><nowiki>{{#invoke:GetShortDescription|main |name=ExampleWikipedia |prefer=wikidata }}</nowiki></code>

:'''Result:''' {{#invoke:GetShortDescription|main|name=ExampleWikipedia |prefer=wikidata}}

=== fallback ===

Line 51 ⟶ 53:

Should a wikidata description be retrieved, which is declared (at the source) as being of a foreign language (i.e. not ''en''), per [[MOS:OTHERLANG]], the return will be formatted as appropriate by Module:Lang by default. This may be disabled with {{para|lang_no|yes}} or adjusted via the parameters for {{tlc|lang}}: {{para|lang_italic}}, {{para|lang_nocat}}, {{para|lang_size}}, {{para|lang_cat}} and {{para|lang_rtl}}; see [[Template:Lang/doc|lang's documentation]] for details.

== Requiring this module ==

<includeonly>{{Sandbox other||

=== Instances when a table is returned ===

<!-- Categories below this line; interwikis at Wikidata -->

Providing a value for {{para|objectify_alarm}} will cause alarming messages (red informational messages) to be returned as [[mw:Extension:Scribunto/Lua reference manual#table|tables]].

Providing a value for {{para|report_redlinks}} will cause the return of a report instead of nothing in the event that the page named is nonexistent (i.e. a [[WP:REDLINK]]) and a search for a {{tlc|short description}} template is processed.

[[Category:Modules using data from Wikidata]]

[[Category:WikiProject Short descriptions]]

A table will also be returned in the event that the module is instructed to {{para|prefer|explicit}} (its default), and returns a Wikidata description. If the reason for there being no explicit short description is because it was set to ''[[WP:SDNONE|none]]''; the table will include a value for <code>table.none</code>

See below for examples of these behaviors:

<syntaxhighlight lang="lua">local getShortDescription = require( 'Module:GetShortDescription' ).main

local short_description = getShortDescription( {

-- required

name = 'page name',

-- optional

prefer = 'explicit' or 'wikidata',

only = 'explicit' or 'wikidata',

fallback = 'fallback',

objectify_alarm = true,

report_redlinks = true,

lang_no = 'yes',

-- {{lang}} options

lang_italic = <yes, no, unset, invert, default>,

lang_nocat = <yes, y, true, t, on, 1>,

lang_size = <CSS font-size e.g. '1.5em'>,

lang_cat = <no, n, false, f, off, 0>,

lang_rtl = <no (default), yes>

} )

-- If we've requested to report_redlinks or to objectify_alarm then

if type( short_description ) == 'table' then

if short_description.alarm then

-- An alarming message has been returned

local alarming_message = short_description.alarm

elseif short_description.redlink then

-- Do something about that

elseif short_description.wikidata then

-- A Wikidata description was returned without being explicitly requested

local wikidata_description = short_description.wikidata

if short_description.none then

-- Because the explicit short desc was 'none'

end

end

end</syntaxhighlight>

<includeonly>{{Sandbox other||

[[Category:Modules using data from Wikidata]]

[[Category:Short description related modules]]

}}</includeonly>

<noinclude>

[[Category:Module documentation pages]]

</noinclude>