Template:Sister project links/doc

The {{Sister project links}} template provides one box with links to corresponding pages on various Wikimedia sister projects. The following pages are sought, in order:

  • An explicit page chosen by an editor (if provided)
  • A sitelink in Wikidata (if exists)
  • A search page on the sister project

Sending a reader to a search page can be an unpleasant experience, if there is no corresponding page for that subject. Editors have a choice between two methods to prevent this negative experience:

  • Manually check each project for a relevant page, if missing, then set argument to "no" (e.g., |wikt=n)
  • Use "automatic mode", which only displays a sister project by default if sitelink exists (e.g., |auto=yes)

Note that {{Sister project auto}} is equivalent to {{Sister project links|auto=yes}}.

Usage

edit
{{Sister project links
<!-- Configuration parameters. -->
 |1= |display= |auto= |collapsible= |position= |style=

<!-- Note: The order of the projects is as they appear in the navbox. -->
<!-- First part: Projects that default to "yes" when auto=no -->
 |wikt= |c= |n= |q= |s= |b= |v=

<!-- Second part: Projects that default to "no" when auto=no -->
 |voy= |species= |species_author= |iw= |d= |m= |mw= |f=

<!-- The following parameters specifying search options for pages above. -->
 |commonscat= <!-- (relevant for c) force link to commons category -->
 |author= <!-- (relevant for s) force search for author name in wikisource -->
 |cookbook= <!-- (relevant for b) force link to cookbook at wikibooks -->
}}

Example with all parameters and all projects displayed (see right):

{{Sister project links
 |1= |display= |auto= |collapsible= |position= |style=
 |wikt= |c= |n= |q= |s= |b= |v=
 |voy=yes |species=yes |species_author=John |iw=en |d=yes |m=yes |mw=yes |f=yes
 |commonscat= |author= |cookbook=
}}

Default display

edit

For any project parameter, there are four acceptable values:

  • "yes" means find a reasonable link for the sister project (Wikidata, or default back to search)
  • "no" means exclude this sister project: no link
  • a string means link to the page with whose title is that string
  • blank or missing means use the default
    • If |auto=yes, default is either use Wikidata (if present), or drop the link
    • If |auto=no, if project is in the "yes" list above, either use Wikidata or search. Otherwise drop the link.

Location

edit
If using a large, graphical template produces odd layout problems, like the excessive white space shown on the right of this screenshot, then switch to a different sister template.

Generally:

☒N Do not place this template in a section all by itself.
☒N Do not place this template in a section containing columns.

Specifically:

  • In resources, this template should normally be placed at the top of the External links section, if it exists. Otherwise, place this template at the top of the last section in the resource.
  • In disambiguation pages, this template should be listed above other text, but below any cleanup templates, images, infoboxes or navboxes.
edit

The |iw= parameter is for use in resources about languages themselves. It is designed to be used instead of the {{InterWiki}} template: it links to the Main Page of Wikiversity that corresponds to the language code. See Template:InterWiki/doc for more information. Up to three sister Wikipedias can be linked, using |iw=, |iw1=, and |iw2=.

TemplateData

edit
This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools.

TemplateData for Sister project links

Displays a terminal window with a set of commands. If the titles in the individual sister projects differ, use the following parameters, which are taken from [[Help:Interwiki linking]]. The value "Yes" means that the page will be found automatically.

Template parameters

ParameterDescriptionTypeStatus
Search term1

Use if the ''search term'' differs from the pagename. E.g. to change the capitalization for Wiktionary links

Default
{{PAGENAME}}
Stringoptional
Display namedisplay

Use if the ''display name'' is different from the search term. For example, the bear resource would be 'Bears'.

Default
{{PAGENAME}}
Stringoptional
Use wikidata to fill defaultsauto

If auto="yes", then sister projects with wikidata sitelinks are filled-in, others are off by default. Each project can be overridden with its own parameter.

Default
No
Stringoptional
Collapsible?collapsible

Set to "yes" to make the template collapsible. Set to "collapsed" to make the template collapsible and initially collapsed.

Default
No
Stringoptional
Positionposition

Specifies whether the box floats to the left or right. The only acceptable value is "left" which causes the box to float to the left. Any other value (not specifying this parameter) activates the default. (Float to the right.)

Default
right
Stringoptional
CSS stylestyle

Optional CSS style specifications. Use with caution. (And don't use for evil!)

Stringoptional
Wiktionary linkwikt

Wiktionary link to show. Acceptable values are a page name, "yes", and "no".

Default
Yes
Stringoptional
Commons linkc commons

Commons link to show. Acceptable values are a page name, "yes" and "no".

Default
Yes
Stringoptional
Commons category?commonscat

Specifies whether a link to a category on Wikimedia Commons is shown. Can be "yes" or "no".

Default
No
Stringoptional
Wikinews linkn

Wikinews link to show. Acceptable values are a page name, "yes" and "no".

Default
Yes
Stringoptional
Wikiquote linkq

Wikiquote link to show. Acceptable values are a page name, "yes" and "no".

Default
Yes
Stringoptional
Wikisource links

Wikisource link to show. Acceptable values are a page name, "yes" and "no".

Default
Yes
Stringoptional
Wikisource author?author

Use for resources about authors to force the Wikisource links to include the "Author:" prefix. Can be set to "yes" or "no".

Default
No
Stringoptional
Wikibooks linkb

Wikibooks link to show. Acceptable values are a page name, "yes" and "no".

Default
Yes
Stringoptional
Cookbookcookbook

If yes, link to Cookbook at wikibooks. If string, use that string as resource title in Cookbooks.

Default
No
Stringoptional
Wikiversity linkv

Wikiversity link to show. Acceptable values are a page name, "yes", and "no".

Default
Yes
Stringoptional
Wikivoyage linkvoy

Wikivoyage link to show. Acceptable values are a page name, "yes" and "no".

Default
No
Stringoptional
Wikispecies taxon linkspecies

Wikispecies link to show. Acceptable values are a page name, "yes" and "no".

Default
No
Stringoptional
Wikispecies author linkspecies_author

Wikispecies author link to show. Acceptable values are a page name, "yes" and "no". Even if "yes" it will be only displayed when species ≠ "yes"

Default
No
Stringoptional
Interwiki linkiw

Link to other language edition. Acceptable values are a Wikiversity language code (e.g., "de"), "yes" and "no".

Default
No
Stringoptional
Wikidata linkd

Wikidata link to show. Acceptable values are a QID, "yes" and "no".

Default
No
Stringoptional
Meta linkm

Meta link to show. Acceptable values are a page name, "yes" and "no".

Default
No
Stringoptional
MediaWiki linkmw

MediaWiki link to show. Acceptable values are a page name, "yes" and "no".

Default
No
Stringoptional
Wikifunctions linkf

Wikifunctions link to show. Acceptable values are a page name, "yes" and "no".

Default
No
Stringoptional

Images used

edit

This template potentially displays the following images:

Wiktionary logo wikt
Wikimedia Commons logo c or commons
Wikinews logo n
Wikiquote logo q
Wikisource logo s
Wikibooks logo b
Wikivoyage logo voy
Wikiversity logo v
Wikispecies logo species or species_author
Wikipedia logo iw
Wikidata logo d
Meta-Wiki logo m
MediaWiki logo mw
Wikifunctions logo f

Tracking categories

edit

See also

edit