Jump to content

Template:Signpost series/doc

From Wikipedia, the free encyclopedia

Background

[edit]
The following was written in 2015.

Signpost series are suites of articles published in different editions of the news outlet that cover a single topic, and can be structured together for reference by readers seeking to learn more about that topic. In the past, series were assembled manually via the now-deprecated Wikipedia:Wikipedia Signpost/Templates/Series template (a few very early series precluded this template, too, and used custom formatting that was generated on an ad-hoc basis: see for instance our series for the 2007 board elections).

NB: They're all formatted properly now! Ohh yeah! jp×g 07:58, 28 January 2023 (UTC)

This master template was introduced in March 2015 by ResMar to greatly increase the efficiency with which series may be generated and used within Signpost articles. The core of this template is Wikipedia:Wikipedia Signpost/Templates/Article list maker, a Lua-and-Python-enabled template that uses Module:Signpost and an off-wiki Pythonic web scraper to classify Signpost articles according to their topicality via "tags". This core functionality is written and maintained by Mr. Stradivarius ♪ talk ♪, and is described in more detail at Wikipedia:Wikipedia Signpost/Index. The list of valid tags is currently available at Module:Signpost/index. Efforts are underway, but not yet completed, to build a comprehensive tag browser at Wikipedia:Wikipedia Signpost/Index.

The code on this page itself actually only consists of a switch between one of few different templates. The first is the full sidebar box, {{Wikipedia:Wikipedia Signpost/Templates/Tag series}}, used to provide article linking capacity to previous stories related to the current one. The second is {{Wikipedia:Wikipedia Signpost/Templates/Tag series inline}}, used as an inline footer to Signpost stories wherever a full sidebar space is not available: see for instance here. Use-case documentation for when either of these templates is or isn't appropriate is provided in the Signpost style guidelines.

A number of more general sub-templates have been created an implemented as well, create a handful of differently visually styled template archival links for general use by the Wikipedia community, and from there, for general use by the Wikimedia community at large.

Note 1: There's a coded capacity for multiple tags to be displayed at once; however we've chosen not to code this feature into our templates, to save on the resulting conflation of tagging patterns. To use two different tag series, use two templates instead.

Note 2: Currently, inline versions of these templates invoke tags in a sandbox page. In the future, once the research index is complete (NB: This was written in 2015), these will be replaced with links to the tag's listing in the research index, which will provide necessary meta-data about what users are looking at before they invoke series functionality.


After 2015, it doesn't seem like a whole lot happened on this front. Well, maybe I can change that... jp×g 08:50, 8 January 2023 (UTC)

Options

[edit]

Inline and inline plain

[edit]

Inline templates are meant to be used either by Signpost editors in Signpost articles. They can also be used on other pages, like Wikiproject interests in a specific topic.

If you want to create an inline template, the parameters are:

{{Signpost series
 |type         = inline
 |tag          = 
 |tag_name     = 
 |tag_pretext  = 
 |image        = 
}}
  • |type= – This standard parameter for all {{Signpost series}} sub-templates allows you to select which sub-template you want: in this case, inline (or inline plain for an image-less version).
  • |tag= – The name of the tag itself as used by the Lua script. Valid tags are documented at Module:Signpost/index and, in the future, will be documented at our research index.
  • |tag_name= – The name of the tag as you want it to appear visually in the template. If left empty, the parameter entered into "tag" will be used.
  • |tag_pretext= – A grammatical parameter for use when a tag_name is better prefixed by a "the". For instance, "on the gender gap" versus "on semi-protection", as opposed to "on gender gap" versus "on the semi-protection".
  • |image= – The image placed before the text. To remove the image entirely see inline plain. The default image is File:WikipediaSignpostIcon.svg, the Signpost masthead.

Some example use-cases:

Using {{Signpost series |type=inline |tag=gendergap |tag_name=gender gap |tag_pretext=the}}
Gives For Signpost coverage on the gender gap see the gender gap series.

Using {{Signpost series |type=inline |tag=semi-protection}}
Gives For Signpost coverage on semi-protection see the semi-protection series.

Using {{Signpost series |type=inline plain |tag=semi-protection}}
Gives For Signpost coverage on semi-protection see the semi-protection series.

Note the use of tag_pretext in the first example.

When hosted inside the Wikipedia:Wikipedia Signpost base pagename, this template will modify its wording to reflect that:

For more Signpost coverage on semi-protection see our semi-protection series.

[edit]

The simplest option of all—merely provides a link to the desired series invocation. It can be used for implementation in other templates or for cursory citation within discussions.

{{Signpost series
 |type         = link
 |tag          = 
 |link_title   = 
}}
Using Anon, see the ''Signpost's'' {{Signpost series |type=link |tag=gendergap |link_title=gender gap}} article series.
Gives Anon, see the Signpost's gender gap article series.

See more

[edit]

Creates a {{sidebox}} instance that can be inserted into the end matter of on-wiki policy pages, linking to the relevant tag in question.

{{Signpost series
 |type         = see more
 |tag          = gendergap
 |tag_name     = 
 |tag_pretext  = 
}}
  • |type= – A standard parameter for all {{Signpost series}} sub-templates; it allows you to select which sub-template you want: in this case, see more.
  • |tag= – The name of the tag itself as used by the Lua script. Valid tags are documented at Module:Signpost/index and, in the future, at our research index.
  • |tag_name= – The name of the tag as you want it to appear visually in the template. If left empty, the parameter entered into "tag" will be used.
  • |tag_pretext= – A grammatical parameter for use when a tag_name is better prefixed by a "the". For instance, "on the gender gap" versus "on semi-protection", as opposed to "on gender gap" versus "on the semi-protection".

A use-case example:

Using {{Signpost series |type=see more |tag=semi-protection |tag_name=semi-protection}}
Gives
[edit]

Sidebar templates are meant to be used exclusively by Signpost staff within our own articles.

The parameters are:

{{Signpost series
 |type         = sidebar-v2
 |fullwidth    = 
 |tag          = 
 |seriestitle  = 
 |limit        = 
 |sortdir      = 
 |image        = 
 |toggle_title = 
}}
  • |fullwidth=yes brings a full width style, no has two-column style. By default this is set to no.
  • |type= – This standard parameter for all {{Signpost series}} sub-templates allows you to select which sub-template you want: In this case sidebar-v2. sidebar2 is deprecated, so don't use it.
  • |tag= – The name of the tag used by this series. For further information about tags see the Signpost research index.
  • |seriestitle= – A succinct title of the series. Equivalent to the tag_name inline sub-template parameter. If left empty, the parameter entered into "tag" will be used.
  • |limit= – The number of articles to include in the sidebar. By default, this is set to 5.
  • |sortdir=ascending to present articles from oldest to most recent, descending to present articles from most recent to oldest. By default, this is set to descending.
  • |image= – Changes the image displayed in the top-right corner. Not recommended when used in the Signpost.
  • |toggle_title= – If multiple sidebars for the same tag is present on the same page, clicking on 'more articles' will open all sidebars at once. While this shouldn't happen in Signpost articles, it can happen when discussing series or this template. Set the first sidebar to use |toggle_title=tag1, the second one use |toggle_title=tag2, and so on (|toggle_title= must be unspaced.)

Some example use-cases:

Using Gives
{{Signpost series
 |type         = sidebar
 |tag          = gendergap
 |seriestitle  = 
}}
Related articles
Gender gap

Images on Wikipedia "amplify gender bias"
2 March 2024

Scribing, searching, soliciting, spying, and systemic bias
31 October 2022

Measuring gender diversity in Wikipedia articles
29 May 2022

Cherchez une femme
28 June 2020

Female scholars underrepresented; whitepaper on Wikidata and libraries; undo patterns reveal editor hierarchy
30 April 2019


More articles

The gaps in our knowledge of our gaps
30 April 2019

It's time we look past Women in Red to counter systemic bias
26 April 2018

Revenge of "I can’t believe we didn’t have an article on ..."
9 March 2016

Wikipedian is break-out star of International Women's Day; dinosaur art; Wikipedia's new iOS app and its fight for market share
9 March 2016

The new alchemy: turning online harassment into Wikipedia articles on women scientists
9 March 2016

Wikipedia and paid labour; Swedish gender gap; how verifiable is "verifiable"?
2 March 2016

Shit I cannot believe we had to fucking write this month
17 February 2016

Teaching Wikipedia, Does advertising the gender gap help or hurt Wikipedia?
6 January 2016

Women in Red—using teamwork and partnerships to elevate online and offline collaborations
16 December 2015

"Wikipedia's hostility to women"
21 October 2015

Women and Wikipedia: the world is watching
21 October 2015

No men beyond this point: the proposal to create a no-men space on Wikipedia
4 February 2015

Study tour controversy; class tackles the gender gap
31 December 2014

Gender gap and skills gap; academic citations on the rise; European food cultures
26 November 2014

Banning Policy, Gender Gap, and Waldorf education
24 September 2014

IEG funding for women's stories—a new approach to the gender gap
4 June 2014

Women's history, what we're missing, and why it matters
12 March 2012

Gender gap and conflict aversion; collaboration on breaking news; effects of leadership on participation; legacy of Public Policy Initiative
27 February 2012

Bell Pottinger investigation, Gardner on gender gap, and another plagiarist caught red-handed
12 December 2011

Article promotion by collaboration; deleted revisions; Wikipedia's use of open access; readers unimpressed by FAs; swine flu anxiety
29 August 2011

Wikipedia a "sausage fest", Chicago Wikipedians ("the people you've probably plagiarized"), and other silly season stories
15 August 2011

Israeli news focuses on Wikimania; worldwide coverage of contributor decline and gender gap; brief news
8 August 2011

Gender gap and sexual images; India consultant; brief news
21 February 2011

Foundation report; gender statistics; DMCA takedowns; brief news
14 February 2011

Widespread discussions about the low participation of women in Wikipedia
7 February 2011

Facebook hack; gender gap; What is the Wikipedia "community"?; brief news
31 January 2011

{{Signpost series
 |type         = sidebar
 |tag          = openaccess
 |seriestitle  = Open access
 |limit        = 3
 |sortdir      = ascending
}}