Template:Pagebanner

From Wikivoyage
Jump to navigation Jump to search
[view] [edit] [history] [purge] Template documentation

This template places a banner and horizontal Table of Contents at the top of travel guide pages. This template is a wrapper around the mw:Extension:WikidataPageBanner extension and should be used instead of invoking the extension directly. For more information about page banner usage on Wikivoyage, see Wikivoyage:Banner Expedition.

Basic usage: {{pagebanner | image name }}. Leave out the File: prefix.

  • To use the default banner, which inserts the page name and TOC on top of generic image, simply type {{pagebanner}}
  • To get the default pagebanner for the region or type of article, use the appropriate keyword instead of the image name.
    • For destination articles, one of: "Europe", "North America", "Middle East"/"ME", "North Africa", "Asia", "South America"/"Africa"/"SA", "Caribbean", "Australia", "Oceania", "New Zealand"/"NZ"
    • For travel topics: "Travel topic"/"Topic"/"TT" or a specific one
      • "Flying"
      • "Dive guide"/"Diving"/"Dive"
      • "Itinerary"
      • "Phrasebook"
    • For disambiguation pages: "Disambiguation page"/"disambg"
  • image name: Enter the name of the image to use in the banner (excluding "File:"). Images should have a width-to-height ratio of 7:1, preferably 2100 x 300 pixels, and be at least 1800 pixels wide.

Customizing the banner: {{pagebanner | image name | caption text | page name | disambiguation | star | DotM | OtBP | Ftt | TOC box }}

Parameters

  • |caption=: Recommended. Enter caption=description to display a description of the picture when a mouse pointer is placed over the banner image.
  • |pgname=: Optional. Enter pgname=name to display in the banner. Only enter a name if you want it to be different than the formal name of the page.
  • |disambig=: Optional. Displays a disambiguation icon in the banner (a question mark) and the disambiguation hatnote after the banner. Enter disambig=yes if the name of the disambiguation page is page name (disambiguation). Enter disambig=disambiguation page name if the disambiguation page name is different from the current page name.
  • |star=: Optional. Enter star=yes if the article is a Star article. This displays the Star article symbol in the top right corner.
  • |dotm=: Optional. Enter dotm=yes if the article is a previous Destination of the month. This displays the DotM symbol in the top right corner and adds a category.
  • |otbp=: Optional. Enter otbp=yes if the article has been featured on Off the beaten path. This displays the OtBP symbol in the top right corner and adds a category.
  • |ftt=: Optional. Enter ftt=yes if the article has been a Featured travel topic. This displays the Ftt symbol in the top right corner and adds a category.
  • |box=: Optional. Enter box=black for the TOC to appear in a translucent black box with white type. Enter box=white for the TOC to appear in a translucent white box with black type. Enter nothing for the default solid grey box with black type.
  • |notoc=: Optional. Enter notoc=true to stop the TOC being included in the banner and for the entire TOC to be shown within the article instead. Mainly to be used on articles with lots of sections.
  • |index=: Optional. Enter index=yes for banners on title/index pages or pages in other main namespace article categories which do not always get banners.
  • |fop=: Optional. Enter fop=yes for freedom-of-panorama banners which are not allowed on Commons, to remove them from applicable maintenance categories
  • |origin=: Optional. Use this parameter to define the focal area of the image. This is used to crop the banner appropriately on small screens. The value of the parameter should consist of an x and a y coordinate separated by a comma. Each coordinate represents the distance from the center of the image as a value from -1 to 1. For example, origin=1,1 is the top right corner and origin=-1,1 is the top left corner. There is a graphic here that shows this information visually.

UNESCO tags

  • |unesco_whs=: Optional. Enter unesco_whs=yes if the article is or describes a site on the UNESCO World Heritage List. Only the lowest level articles in the hierarchy should be tagged (i.e. Sydney/City Centre for the Opera House, not Sydney). This displays the World Heritage symbol in the top right corner and adds a category.
  • |unesco_ich=: Optional. Enter unesco_ich=yes if the article is or describes a UNESCO Intangible Cultural Heritage. Only the lowest level articles in the hierarchy should be tagged. This displays the Intangible Cultural Heritage symbol in the top right corner and adds a category.
  • |unesco_gg=: Optional. Enter unesco_gg=yes if the article is or describes a geopark in the UNESCO Global Geoparks Network. Only the lowest level articles in the hierarchy should be tagged. This displays the Global Geoparks Network symbol in the top right corner and adds a category.
  • |unesco_cc=: Optional. Enter unesco_cc=yes if the article is or describes one of the UNESCO Creative Cities. This displays the Creative Cities symbol in the top right corner and adds a category.
  • |unesco_br=: Optional. Enter unesco_br=yes if the article is or describes a biosphere reserve in the UNESCO World Network of Biosphere Reserves. This displays the Man and the Biosphere Programme symbol in the top right corner and adds a category.

Deprecated

  • |unesco=: Optional. Use the specific UNESCO parameter instead.

TemplateData

This template places a banner and horizontal Table of Contents at the top of travel guide pages, with many other information.

Template parameters[Edit template data]

This template prefers inline formatting of parameters.

ParameterDescriptionTypeStatus
Image link1

Banner illustrating the article

Example
File:Vue panoramique Parlement de Bretagne.jpg
Filesuggested
Caption textcaption

Will display a description of the picture when a mouse pointer is placed over the banner image.

Stringsuggested
Page namepgname

Enter a name to display in the banner, only if it is different than the formal name of the page.

Stringoptional
Disambiguationdisambig

Enter "yes" if the name of the disambiguation page is page name (disambiguation). Enter disambiguation's page name if the disambiguation page name is different from the current page name. It displays a disambiguation icon in the banner (a question mark) and the disambiguation hatnote after the banner.

Stringoptional
Star articlestar

Enter "yes" if the article is a Star article. This displays the Star article symbol in the top right corner.

Booleanoptional
Destination of the monthotbp

Enter "yes" if the article is has been a Off the beaten path. This displays the OtBP symbol in the top right corner.

Booleanoptional
Destination of the monthdotm

Enter "yes" if the article is has been a Destination of the month. This displays the DOtM symbol in the top right corner.

Booleanoptional
Featured travel topicftt

Enter "yes" if the article is has been a Featured travel topic. This displays the FFT symbol in the top right corner.

Booleanoptional
UNESCO element (deprecated)unesco

Use the specific UNESCO parameter instead.

Booleanoptional
UNESCO World Heritage Siteunesco_whs

Enter "yes" if the article is or describes a site on the UNESCO World Heritage List. Only the lowest level articles in the hierarchy should be tagged (i.e. Sydney/City Centre for the Opera House, not Sydney). This displays the World Heritage symbol in the top right corner and adds a category.

Booleanoptional
UNESCO Intangible Cultural Heritageunesco_ich

Enter "yes" if the article is or describes a UNESCO Intangible Cultural Heritage. Only the lowest level guides in the hierarchy should be tagged. This displays the Intangible Cultural Heritage symbol in the top right corner and adds a category.

Booleanoptional
UNESCO Global Geoparkunesco_gg

Enter "yes" if the article is or describes a geopark in the UNESCO Global Geoparks Network. Only the lowest level articles in the hierarchy should be tagged. This displays the Global Geoparks Network symbol in the top right corner and adds a category.

Booleanoptional
UNESCO Creative Citiesunesco_cc

Enter "yes" if the article is or describes one of the UNESCO Creative Cities. This displays the Creative Cities symbol in the top right corner and adds a category.

Booleanoptional
UNESCO Biosphere Reserveunesco_br

Enter "yes" if the article is or describes a biosphere reserve in the UNESCO World Network of Biosphere Reserves. This displays the Man and the Biosphere Programme symbol in the top right corner and adds a category.

Booleanoptional
TOC box colorTOC box

Enter box=black for the TOC to appear in a translucent black box with white type. Enter box=white for the TOC to appear in a translucent white box with black type. Enter nothing for the default solid grey box with black type.

Unknownoptional
No table of contentsnotoc

Enter "true" to stop the TOC being included in the banner and for the entire TOC to be shown within the article instead. Mainly to be used on articles with lots of sections.

Unknownoptional
Index pagesindex

Enter "yes" for banners on title/index pages or pages in other main namespace article categories which do not always get banners.

Unknownoptional
Freedom of panoramafop

Enter "yes" for freedom-of-panorama banners which are not allowed on Commons, to remove them from applicable maintenance categories

Unknownoptional
Focal area of the imageorigin

Use this parameter to define the focal area of the image. This is used to crop the banner appropriately on small screens. The value of the parameter should consist of an x and a y coordinate separated by a comma. Each coordinate represents the distance from the center of the image as a value from -1 to 1. For example, origin=1,1 is the top left corner and origin=-1,1 is the bottom left corner. There is a graphic here that shows this information visually.

Unknownoptional

See also