Template:Deprecated/doc

From OpenStreetMap Wiki
Jump to navigation Jump to search

Describes deprecated tag values.

Usage

{{Deprecated
| oldkey   = 
| oldvalue = 
| newtext  = 
}}

For example, this:

{{Deprecated
| oldkey   = shop
| oldvalue = fish
| newtext  = tag:shop=seafood
}}

does the same thing as this:

{{ValueDescription
| key           = shop
| value         = fish
| image         = File:Commons-emblem-hand.svg
| description   = Using this tag is discouraged, use tag:shop=seafood instead.
| osmcarto-rendering      = File:Shop-other-16.svg
| osmcarto-rendering-size = 28px
| group         = shops
| onNode        = no
| onWay         = no
| onArea        = no
| onRelation    = no
| combination   = 
| implies       = 
| seeAlso       = 
| status        = deprecated
| statuslink    = 
| languagelinks = no
}}
{{Deprecated feature
| {{tag|shop|seafood}}
}}

However, there are some issuses with the first way, see talk page.

Parameters

  • oldkey= (mandatory) Deprecated key name
  • oldvalue= (optional) Deprecated value
  • newtext= (mandatory) Replacement text to link to
  • group= (optional) Group name of deprecated key
  • statuslink= (optional) Link to resource that lead to deprecated status

Additional parameter

  • status=deprecated (optional) It is suggested by at least one user to keep or add the parameter status=deprecated as this is important information that might be relevant to retain in the page content. For now, it is not known that it makes a difference. But in the future it may provide the possibility to read this information from the page, e.g. fetched by taginfo. (See also Template talk:Deprecated.)

Translation

The template content is and can be translated in separate Template:DeprecatedLang.

See also


This template is dedicated for deprecated tags. It provides a description box suitable for key/value pairs.

Template parameters

ParameterDescriptionTypeStatus
Deprecated keyoldkey

Deprecated key name

Example
natural
Linerequired
Deprecated valueoldvalue

Deprecated tag value

Example
lake
Lineoptional
Replacement taggingnewtext

Text with suggested replacement tag(s)

Example
{{tag|natural|water}} + {{tag|water|lake}}
Contentrequired
An image showing a suggested rendering on a maposmcarto-rendering

An image showing a suggested rendering on a map; alternatively a page name/anchor to link to more detailed description

Fileoptional
osmcarto-rendering-sizeosmcarto-rendering-size

The size of the image set in osmcarto-rendering

Example
28px
Stringoptional
osmcarto-rendering-nodeosmcarto-rendering-node

an image showing a suggested rendering on a map for a node object; alternatively a page name/anchor to link to more detailed

Fileoptional
osmcarto-rendering-node-sizeosmcarto-rendering-node-size

The size of the image set in osmcarto-rendering-node

Example
28px
Stringoptional
osmcarto-rendering-wayosmcarto-rendering-way

an image showing a suggested rendering on a map for a node object; alternatively a page name/anchor to link to more detailed

Fileoptional
osmcarto-rendering-way-sizeosmcarto-rendering-way-size

The size of the image set in osmcarto-rendering-way

Example
28px
Stringoptional
osmcarto-rendering-areaosmcarto-rendering-area

an image showing a suggested rendering on a map for a node object; alternatively a page name/anchor to link to more detailed

Fileoptional
osmcarto-rendering-area-sizeosmcarto-rendering-area-size

The size of the image set in osmcarto-rendering-area

Example
28px
Stringoptional
Group of deprecated keygroup

Group name of deprecated key

Example
Water
Lineoptional
Requires tagrequires

A list of tag(s) which are necessary (often higher/lower in hierarchy) for this tag and must be set to give its actual meaning

Contentoptional
impliesimplies

A list of tag(s) that the feature implies in its defention.

Contentoptional
combinationcombination

A bulleted-list of example tag(s) that can be used in combination with this feature.

Contentoptional
seeAlsoseeAlso

a list of similar tags

Contentoptional
statusstatus

The approval status of this feature

Suggested values
deprecated
Example
deprecated
Unknownsuggested
statuslinkstatuslink

The name of the deprecation proposal page, for linking.

Page namesuggested
debugdebug

no description

Unknownoptional