Template:Selected picture/doc

This is a documentation subpage for Template:Selected picture.
It may contain usage information, categories and other content that is not part of the original template page.

This template employs intricate features of template syntax.

You are encouraged to familiarise yourself with its setup and parser functions before editing the template. If your edit causes unexpected problems, please undo it quickly, as this template may appear on a large number of pages.
You can conduct experiments, and should test all major changes, in either , the general template sandbox, or your user space before changing anything here.

This template is used to configure the articles found in the Selected picture section found on most Wikipedia Portal main pages. Used it on the article pages that are linked to the Selected picture sub-page, e.g. Portal:Foo/Selected picture/1. For the quickest and easiest way to create the Portal:Foo/Selected bar sub-page and related article links, use one of the {{Numbered subpages}} templates.

For an analogous template, which uses Wikipedia:Picture of the day as source, see {{Portal POTD}} and {{Portal POTD/Featured picture}}.

Usage

Simple usage

{{Selected picture
| image   = 
| credit  = 
| caption = 
| link    = 
| text    = 
}}

Full usage

{{Selected picture
| image    = 
| size     = 
| credit   = 
| caption  = 
| link     = 
| text     = 
| location = 
| page     = 
| type     = 
| archive  = 
}}

Parameters

It is unnecessary to include braces, quotation marks or other wiki-markup in the template. The |text= and |source= fields do allow the use of wiki-markup at the contributor's discretion.

|image=: Filename of the image.
|size=: Sets the image size, if left out or left blank it will default to 250px.
|caption=, |link=: Used to create a big text caption under the image. |link= must be a valid article, |caption= is free-style text. Note that |caption= will not be shown if |link= is specified; instead, |caption= will become the for the image.
|location=: Location of gallery on Wikipedia, optional.
|credit=: Use this to credit the source or photographer that created the image
|text=: A brief summary of the subject, positioned below the image.
|page=: Set an auxiliary page for the More selected foo if the sub page is at another location such as Selected image.
|archive=: Using this field with a value of no will remove the More selected pictures link in the lower left corner. Use this field if you are using the |footer= parameter in the {{random box-header subpage}} template on the main portal page.

Examples

{{Selected picture
| image    = Orange juice 1 edit1.jpg
| size     = 250px
| caption  = A glass of orange juice
| text     = '''[[Orange juice]]''' being poured into a nearly-full condensation-covered glass
| credit   = [[United States Department of Agriculture]]
| link     = Orange juice
}}

Will produce:

Orange juice

Credit: United States Department of Agriculture

Orange juice being poured into a nearly-full condensation-covered glass

More selected pictures

Location option

{{Selected picture
| image    = Panthera tigris sumatran subspecies.jpg
| caption  = A sunlit Sumatran tiger lying in short grass by a wall, head up, facing camera
| text     = The '''[[Sumatran tiger]]''' (''Panthera tigris sumatrae'') is found only on the [[Indonesia]]n island of [[Sumatra]].
| location = Wikipedia:WikiProject Cats/Gallery
| credit   = [[User:Dixi|Monika Betley]]. [[commons:Template:Potd/2004-12#5|A Featured picture of the day.]]
| link     = Sumatran tiger
}}

Will produce (note the link Gallery on the right):

Sumatran tiger

Credit: Monika Betley. A Featured picture of the day.

The Sumatran tiger (Panthera tigris sumatrae) is found only on the Indonesian island of Sumatra.

Gallery
More selected pictures

To display "selected content" on the portal main page
- {{Transclude list item excerpts as random slideshow}}—transcludes excerpts from recognized content lists, which are populated by a bot.
- {{Transclude random subpage}}—transcludes random portal subpage.
- {{Random portal component}}—transcludes random portal subpage.
- {{Random subpage}}—transcludes random portal subpages.
- {{Portal pictures}}—transcludes a slideshow of pictures, utilizing a single-page gallery.
To organize "selected content" on subpages
- {{Numbered subpages}}—outputs an automatic index, transcluding numbered subpages.
- {{Portal subpage}}—outputs a box linking to and transcluding a single subpage.
- {{Portal subpage inline}}—outputs an unordered list item linking to and transcluding a single subpage.

Main portal page formatting templates

Templates that configure links

Selected page templates, used on subpages of older portals

Related templates

{{Project template list}}

v t e Portal templates
Visual overview of template usage
Layout and formatting	{{Box portal skeleton}} {{Box-header}} color palettes plain round square watch {{Box-header colour}}¹ {{Box-footer}} {{Flex columns}} {{Plain navboxes}}
Content transclusion	{{Transclude lead excerpt}}² {{Transclude linked excerpt}}² {{Transclude list item excerpt}}² {{Transclude random excerpt}}² {{Transclude selected excerpt}}² {{Excerpt}} {{Transclude DYK}}⁹ {{Transclude selected current events}}³ {{Transclude selected recent additions}}⁴
Content slideshows	{{Random slideshow}}⁵ {{Transclude files as random slideshow}}⁵ {{Transclude excerpts as random slideshow}}⁶ {{Transclude linked excerpts as random slideshow}}⁶ {{Transclude list item excerpts as random slideshow}}⁶
Content randomisation	{{Random portal component}}⁷ {{Random quotation}} {{Random subpage}}
General	{{Portals}} {{Portals browsebar}} {{Portal description}} {{Portal information sidebar}} {{Portal navbar no header2}} {{Purge link portals}} {{Wikimedia for portals}}
Linking templates	{{Portal}} {{Portal bar}} {{Portal-inline}}¹¹ {{Pbox}} {{Related portals2}}
Talk pages / Maintenance	{{Portal talk}} {{Portal maintenance status}}⁸ {{Portal suggestions}} {{Portal toolbox}} {{WikiProject Portals}}⁸
Images	{{Portal dynamic image}} {{Portal image banner}}¹⁰ {{Portal pictures}}¹² {{Portal POTD}}
Modules	¹ Module:Box-header ² Module:Excerpt/portals ³ Module:Selected current events ⁴ Module:Selected recent additions ⁵ Module:Random slideshow ⁶ Module:Excerpt slideshow ⁷ Module:Random portal component ⁸ Module:Portal maintenance status ⁹ Module:Transclude DYK ¹⁰ Module:Portal image banner ¹¹ Module:Portal-inline ¹² Module:Portal pictures
Usage	Wikipedia:Portal Wikipedia:WikiProject Portals
For more information, see: Category:Template-Class Portal pages and Category:Wikipedia Portal templates

Usage

Parameters

Examples

Location option

See also