Дидани манбаъи Шаблон:Endurance/doc

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
This template is designed to provide easier-to-read unit conversions for endurance figures, which are often given as ''distance'' @ ''speed'', by using [[Template:Convert]] for the unit conversions.

=== Usage ===
* <code><nowiki>{{endurance|distance|from_unit1|to_unit1|speed|from_unit2|to_unit2|[optional note]}}</nowiki></code>
where:
* <code>distance</code> and <code>speed</code> are unformatted numbers (no commas)
* <code>from_unit</code>s and <code>to_unit</code>s are unit abbreviations that are used by [[Template:Convert]]. (See [[Template:Convert/list of units/length]] and [[Template:Convert/list of units/speed]] for units and abbreviations.)
* <code>optional note</code> is a notation (like ''submerged'' or ''surfaced'') to appear in the conversion

==== Optional parameters ====
There are optional parameters that control the appearance of the output:
* <code>abbr</code>: when <code>abbr</code> is set to "on", the input units are abbreviated, which can be useful within infoboxes; the output units are already abbreviated
* <code>sp</code>: when <code>sp</code> is set to "us", the American spelling of metric units, i.e. ''meter'' vs. ''metre''
(Both of these parameters behave the same as they do in [[Template:Convert]]
* <code>sep</code>: a value in the parameter <code>sep</code> overrides the default <code>@</code> symbol

==== Units supported ====
The template currently supports the following units (in any combination or conversion direction):
{{col-begin}}
{{col-break}}
'''Distance''':
* nmi: nautical miles
* m: metres
* km: kilometres
{{col-break}}
'''Speed''':
* knots: knots
* km/h: kilometres per hour
{{col-end}}

Please add requests for additional units to the [[Template talk:Endurance#Unit requests|talk page]]

=== Examples ===
* <code><nowiki>{{endurance|450|nmi|km|5|knots|km/h}}</nowiki></code> → {{endurance|450|nmi|km|5|knots|km/h}}
* <code><nowiki>{{endurance|100|km|nmi|35|km/h|knots}}</nowiki></code> → {{endurance|100|km|nmi|35|km/h|knots}}

;Optional note:
* <code><nowiki>{{endurance|450|nmi|km|5|knots|km/h|submerged}}</nowiki></code> → {{endurance|450|nmi|km|5|knots|km/h|submerged}}

;Abbreviated output:
* <code><nowiki>{{endurance|450|nmi|km|5|knots|km/h|abbr=on}}</nowiki></code> → {{endurance|450|nmi|km|5|knots|km/h|abbr=on}}

;US spelling of metric units:
* <code><nowiki>{{endurance|100|km|nmi|35|km/h|knots|sp=us}}</nowiki></code> → {{endurance|100|km|nmi|35|km/h|knots|sp=us}}

;Optional separator:
* <code><nowiki>{{endurance|2100|nmi|km|16|knots|km/h|sep=at}}</nowiki></code> → {{endurance|2100|nmi|km|16|knots|km/h|sep=at}}

=== See also ===
* [[Template:Convert]]

<includeonly>{{template other|{{#ifeq:{{SUBPAGENAME}}|sandbox||
[[Гурӯҳ:Шаблонҳои табдилдиҳӣ]]
[[Гурӯҳ:Ship templates]]
[[Гурӯҳ:Convert-like templates|{{SUBPAGENAME}}]]
}}}}