View source for Template:Signpost/item/doc

{{Documentation subpage}}
{{High-use}}
<!-- Categories and interwikis go at the bottom of this page. -->
:<span class="plainlinks">''The guts of this are at [[Template:Signpost/item/core]] ([https://en.wikipedia.org/w/index.php?title=Template:Signpost/item/core&action=history h] · [https://en.wikipedia.org/w/index.php?title=Template:Signpost/item/core&action=edit e]).''</span>
Gets called with something like this: <syntaxhighlight lang="wikitext">
{{Signpost/item
 |{{{1}}}
 |2
 |2025-06-24
 |In the media
 |Playing professor pong with prosecutorial discretion
 |0.4&nbsp;MB
 |sub           = Pardon our alliteration!
 |by            = [[User:Bri|Bri]], [[User:Smallbones|Smallbones]], [[User:SashiRolls|SashiRolls]], and [[User:Jayen466|Andreas Kolbe]]
 |piccyfilename = File:Allan Alcorn in 2012 with first Pong ad.jpg
 |piccy-credits = Digital Game Museum
 |piccy-license = cc-by-2.0
 |piccy-scaling = 700
 |piccy-xoffset = 150
 |piccy-yoffset =
}}</syntaxhighlight>

== Usage ==
This is used to link or display a Signpost section (e.g. [[Wikipedia:Wikipedia Signpost/2010-08-23/Technology report]]) in various different formats.
*<syntaxhighlight lang="wikitext" inline>{{{1}}}</syntaxhighlight> = display format. Possible values: 
:*"1" = Nothing but a linked section name. This is what it does in the bottom of a Signpost article (through [[Wikipedia:Wikipedia Signpost/Templates/Signpost-article-comments-end]]).
:*"2" = Invokes {{tl|Signpost/snippet}}.
:* "3" = two-column format of anchor links. Used for TOC in [[Wikipedia:Signpost/Single]].
:* "4" = full transclusion, with anchor. Used in [[Wikipedia:Signpost/Single]].
:* Default: When <syntaxhighlight lang="wikitext" inline>{{{1}}}</syntaxhighlight> isn't parsed, it will give the normal format. Plain list of bullet + section name + <syntaxhighlight lang="wikitext" inline>[[story link|headline]]</syntaxhighlight> + {{small|''subhed''}}. Used in issue content page (example: [[Wikipedia:Wikipedia Signpost/2010-08-23]]) and via this in [[Template:Signpost-subscription]], [[User:EdwardsBot/Spam]], [[Template:User Signpost-subscription]] (via [[Template:Signpost-textonly]]), some others. This is the most commonly used format, probably...
*<syntaxhighlight lang="wikitext" inline>{{{2}}}</syntaxhighlight> = running number of the section in the issue, between 0 and 18
*<syntaxhighlight lang="wikitext" inline>{{{3}}}</syntaxhighlight> = date of the Signpost issue, e.g. "2010-08-23". Forms part of the URL (page name in the wiki)
*<syntaxhighlight lang="wikitext" inline>{{{4}}}</syntaxhighlight> = page name (short, generic), e.g. "Technology report". Forms part of the URL (page name in the wiki). Must be consistent with previous issues for linking between consecutive reports.
*<syntaxhighlight lang="wikitext" inline>{{{5}}}</syntaxhighlight> = section headline (longer, generic or descriptive), e.g. "Bugs, Repairs, and Internal Operational News" or ([[Wikipedia:Wikipedia Signpost/2010-08-23/News and notes|here]]:) "Pending changes poll, Public policy classes, Payment schemes debate, and more"

=== Esoterics ===
*<syntaxhighlight lang="wikitext" inline>{{{6}}}</syntaxhighlight> = This is not used anywhere in the template, but for some reason, the individual issue pages (i.e. [[Wikipedia:Wikipedia Signpost/2023-08-15]]) call this template with a useless sixth parameter, which is the pagesize of the article. Like this:
::<syntaxhighlight lang="wikitext" inline>{{Wikipedia:Signpost/Template:Cover-item|{{{1}}}|11|2023-08-15|Traffic report|'Cause today it just goes with the fashion|0.3&nbsp;MB}}</syntaxhighlight>
:Why on Earth does it do this? We don't know.
::Note: it [https://en.wikipedia.org/w/index.php?sort=create_timestamp_desc&search=intitle%3A%2FSignpost%5C%2F%5B0-9%5D%7B4%7D-%5B0-9%5D%7B2%7D-%5B0-9%5D%7B2%7D%2F+insource%3A%2F%26nbsp%3BMB%2F&prefix=WP%3A&title=Special:Search&profile=advanced&fulltext=1&ns0=1&ns1=1&ns2=1&ns3=1&ns4=1&ns5=1&ns6=1&ns7=1&ns8=1&ns9=1&ns10=1&ns11=1&ns12=1&ns13=1&ns14=1&ns15=1&ns100=1&ns101=1&ns118=1&ns119=1&ns710=1&ns711=1&ns828=1&ns829=1&ns2300=1&ns2301=1&ns2302=1&ns2303=1 started] in [[Wikipedia:Wikipedia Signpost/2019-04-30]]. 
*<syntaxhighlight lang="wikitext" inline>{{{sub}}}</syntaxhighlight> = Subheading, at least as called from the individual Signpost archive pages (e.g. [[Wikipedia:Wikipedia Signpost/2025-05-14]]). <!--Currently unused. My plan (as of 22:57, 2 December 2023 (UTC)) is to backfill all the individual issue pages with the subheadings of the articles, which currently ''don't exist anywhere'' except the revision history of [[Wikipedia:Wikipedia Signpost]] (?) so it will be quite hard to do this. But perhaps good. Who knows. <b style="font-family: monospace; color:#E35BD8">[[User:JPxG|<b style="color:#029D74">jp</b>]]×[[Special:Contributions/JPxG|<b style="color: #029D74">g</b>]][[User talk:JPxG|🗯️]]</b>--> This won't always be present (because Signpost articles didn't always have subheds) but I backfilled a very large amount of them.

== Additional formats ==

As mentioned elsewhere earlier, I would like to use the flexibility of this system to add the following display formats (i.e. new values for {{{1}}}}). They would save a considerable amount of time in the weekly publication process and reduce the risk of errors. Mostly they are for generating ready-for-copypaste-text.


;"5" for blog (RSS) announcements ([http://www.wikipediasignpost.com/blog/?p=219 example]):

Required code:
:<nowiki> | 6 = {{{4}}}: <a href="http://en.wikipedia.org/wiki/Wikipedia:Wikipedia Signpost/{{{3}}}/{{{4}}}" title="Wikipedia:Wikipedia Signpost/{{{3}}}/{{{4}}}">{{{5}}}</a><nowiki><br></nowiki></nowiki>
will give e.g.
:In the news: <a href="http://en.wikipedia.org/wiki/Wikipedia:Wikipedia_Signpost/2010-09-06/In_the_news" title="Wikipedia:Wikipedia Signpost/2010-09-06/In the news">WikiLeaks and Wikipedia; Google–WP collaboration to translate health information</a><nowiki><br></nowiki>

;"6" for Foundation-l mailing list announcements ([http://lists.wikimedia.org/pipermail/foundation-l/2010-September/060855.html example]):

Required code:
:<nowiki> | 7 = {{{4}}}: {{{5}}}<br/>http://en.wikipedia.org/wiki/Wikipedia:Wikipedia_Signpost/{{{3}}}/{{{4}}}<br/></nowiki>

will give e.g.
:In the news: WikiLeaks and Wikipedia; Google–WP collaboration to translate health information
:http://en.wikipedia.org/wiki/Wikipedia:Wikipedia_Signpost/2010-09-06/In_the_news
:

;"7" for announcements via Global message delivery ([http://meta.wikimedia.org/w/index.php?title=Global_message_delivery/Spam&oldid=2135764 example])

Required code:
:<nowiki> | 8 = * {{{4}}}: [[w:en:Wikipedia:Wikipedia Signpost/{{{3}}}/{{{4}}}|{{{5}}}<nowiki>]]</nowiki></nowiki><nowiki><br/></nowiki>

will give e.g.
:* News and notes: [[w:en:Wikipedia:Wikipedia Signpost/2010-09-27/News and notes|French million, controversial content, Citizendium charter, Pending changes, and more<nowiki>]]</nowiki>

Please review and correct, I may have messed up one or two nowikis or line breaks.

If I understand the structure correctly, the four code lines above (for 4,5,7,8) will need to be inserted in the current version after " | 4 = " and before " | * {{{4}}}: ".

== Examples ==
Listed by display format, with the following parameters.
<syntaxhighlight lang="wikitext" inline>
{{Signpost/item
 |(varies by example number)
 |2
 |2025-06-24
 |In the media
 |Playing professor pong with prosecutorial discretion
 |0.4&nbsp;MB
 |sub           = Pardon our alliteration!
 |by            = [[User:Bri|Bri]], [[User:Smallbones|Smallbones]], [[User:SashiRolls|SashiRolls]], and [[User:Jayen466|Andreas Kolbe]]
 |piccyfilename = File:Allan Alcorn in 2012 with first Pong ad.jpg
 |piccy-credits = Digital Game Museum
 |piccy-license = cc-by-2.0
 |piccy-scaling = 700
 |piccy-xoffset = 150
 |piccy-yoffset =
}}</syntaxhighlight>
{{-}}

;{{code|1}} (plain list)
{{Signpost/item
 |1
 |2
 |2025-06-24
 |In the media
 |Playing professor pong with prosecutorial discretion
 |0.4&nbsp;MB
 |sub           = Pardon our alliteration!
 |by            = [[User:Bri|Bri]], [[User:Smallbones|Smallbones]], [[User:SashiRolls|SashiRolls]], and [[User:Jayen466|Andreas Kolbe]]
 |piccyfilename = File:Allan Alcorn in 2012 with first Pong ad.jpg
 |piccy-credits = Digital Game Museum
 |piccy-license = cc-by-2.0
 |piccy-scaling = 700
 |piccy-xoffset = 150
 |piccy-yoffset =
}}{{-}}
;{{code|2}} (two-column format)
{{Signpost/item
 |2
 |2
 |2025-06-24
 |In the media
 |Playing professor pong with prosecutorial discretion
 |0.4&nbsp;MB
 |sub           = Pardon our alliteration!
 |by            = [[User:Bri|Bri]], [[User:Smallbones|Smallbones]], [[User:SashiRolls|SashiRolls]], and [[User:Jayen466|Andreas Kolbe]]
 |piccyfilename = File:Allan Alcorn in 2012 with first Pong ad.jpg
 |piccy-credits = Digital Game Museum
 |piccy-license = cc-by-2.0
 |piccy-scaling = 700
 |piccy-xoffset = 150
 |piccy-yoffset =
}}{{-}}
;{{code|3}} (two-column format of anchor links)
{{Signpost/item
 |3
 |2
 |2025-06-24
 |In the media
 |Playing professor pong with prosecutorial discretion
 |0.4&nbsp;MB
 |sub           = Pardon our alliteration!
 |by            = [[User:Bri|Bri]], [[User:Smallbones|Smallbones]], [[User:SashiRolls|SashiRolls]], and [[User:Jayen466|Andreas Kolbe]]
 |piccyfilename = File:Allan Alcorn in 2012 with first Pong ad.jpg
 |piccy-credits = Digital Game Museum
 |piccy-license = cc-by-2.0
 |piccy-scaling = 700
 |piccy-xoffset = 150
 |piccy-yoffset =
}}{{-}}
;{{code|4}} (full transclusion)
{{cot}}
{{Signpost/item
 |4
 |2
 |2025-06-24
 |In the media
 |Playing professor pong with prosecutorial discretion
 |0.4&nbsp;MB
 |sub           = Pardon our alliteration!
 |by            = [[User:Bri|Bri]], [[User:Smallbones|Smallbones]], [[User:SashiRolls|SashiRolls]], and [[User:Jayen466|Andreas Kolbe]]
 |piccyfilename = File:Allan Alcorn in 2012 with first Pong ad.jpg
 |piccy-credits = Digital Game Museum
 |piccy-license = cc-by-2.0
 |piccy-scaling = 700
 |piccy-xoffset = 150
 |piccy-yoffset =
}}{{-}}
{{cob}}
;{{code|5}} (for blog announcements)
{{Signpost/item
 |5
 |2
 |2025-06-24
 |In the media
 |Playing professor pong with prosecutorial discretion
 |0.4&nbsp;MB
 |sub           = Pardon our alliteration!
 |by            = [[User:Bri|Bri]], [[User:Smallbones|Smallbones]], [[User:SashiRolls|SashiRolls]], and [[User:Jayen466|Andreas Kolbe]]
 |piccyfilename = File:Allan Alcorn in 2012 with first Pong ad.jpg
 |piccy-credits = Digital Game Museum
 |piccy-license = cc-by-2.0
 |piccy-scaling = 700
 |piccy-xoffset = 150
 |piccy-yoffset =
}}{{-}}
;{{code|6}} (mailing list announcements)
{{Signpost/item
 |6
 |2
 |2025-06-24
 |In the media
 |Playing professor pong with prosecutorial discretion
 |0.4&nbsp;MB
 |sub           = Pardon our alliteration!
 |by            = [[User:Bri|Bri]], [[User:Smallbones|Smallbones]], [[User:SashiRolls|SashiRolls]], and [[User:Jayen466|Andreas Kolbe]]
 |piccyfilename = File:Allan Alcorn in 2012 with first Pong ad.jpg
 |piccy-credits = Digital Game Museum
 |piccy-license = cc-by-2.0
 |piccy-scaling = 700
 |piccy-xoffset = 150
 |piccy-yoffset =
}}{{-}}
;{{code|7}} (global message delivery announcements)
{{Signpost/item
 |7
 |2
 |2025-06-24
 |In the media
 |Playing professor pong with prosecutorial discretion
 |0.4&nbsp;MB
 |sub           = Pardon our alliteration!
 |by            = [[User:Bri|Bri]], [[User:Smallbones|Smallbones]], [[User:SashiRolls|SashiRolls]], and [[User:Jayen466|Andreas Kolbe]]
 |piccyfilename = File:Allan Alcorn in 2012 with first Pong ad.jpg
 |piccy-credits = Digital Game Museum
 |piccy-license = cc-by-2.0
 |piccy-scaling = 700
 |piccy-xoffset = 150
 |piccy-yoffset =
}}{{-}}
;{{code|default}} (most-used view)
{{Signpost/item
 |you can just put whatever here
 |2
 |2025-06-24
 |In the media
 |Playing professor pong with prosecutorial discretion
 |0.4&nbsp;MB
 |sub           = Pardon our alliteration!
 |by            = [[User:Bri|Bri]], [[User:Smallbones|Smallbones]], [[User:SashiRolls|SashiRolls]], and [[User:Jayen466|Andreas Kolbe]]
 |piccyfilename = File:Allan Alcorn in 2012 with first Pong ad.jpg
 |piccy-credits = Digital Game Museum
 |piccy-license = cc-by-2.0
 |piccy-scaling = 700
 |piccy-xoffset = 150
 |piccy-yoffset =
}}{{-}}

<includeonly>{{Sandbox other||
{{pp-template}}
<!-- Categories and interwikis go here: -->

[[Category:Internal link templates]]
[[Category:Wikipedia Signpost templates|{{SUBPAGENAME}}]]
}}</includeonly>