Дидани манбаъи Шаблон:Infobox hiking trail/doc

{{Documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->

{{Template other|{{Notice|Please note this documentation is also included in [[Wikipedia:WikiProject Hiking Trails]].}}|}}

{{template other
| This template is
| {{tl|Infobox hiking trail}} is the primary template to be used
}} in articles about specific [[hiking]] trails. The example on the right shows a good example of how a trail template is properly used.

=== Blank template ===
{{Parameter names example
|_template=Infobox hiking trail
| embed
| cellstyle
| name
| photo
| photo_size
| photo_alt
| caption
| title
| established
| length
| length_km
| length_mi
| location
| designation
| trailheads
| use
| elev_gain_and_loss
| elev_change
| elev_change_m
| elev_change_ft
| highest_name
| highest_m
| highest_ft
| highest
| lowest_name
| lowest_m
| lowest_ft
| lowest
| grade
| difficulty
| season
| months
| waymark
| sights
| hazards
| surface
| ROW
| website
}}
<pre><nowiki>
{{Infobox hiking trail
| name =
| embed =
| cellstyle =
| photo =
| photo_size =
| photo_alt =
| caption =
| title =
| established =
| length =
| location =
| designation =
| trailheads =
| use = Hiking
| elev_gain_and_loss =
| elev_change = <!-- Use elev_gain_and_loss if the gain and/or loss is known.
                     Use this field when only the change is known. -->
| highest =
| lowest =
| grade =
| difficulty =
| season =
| months =
| waymark =
| sights =
| hazards =
| surface =
| ROW =
| website =
}}
</nowiki></pre>
{{clear}}

=== Parameter descriptions ===
{| class=wikitable
|-
!Parameter !! Description
|-
!name
|Name of the trail
|-
!length_km
|Length of the trail in kilometers, as a single number. Will convert to miles automatically
|-
!length_mi
|Length of the trail in miles, as a single number. Will convert to kilometers automatically. Please only use for trails in the United States
|-
!length
|Length of trail, no auto-conversion. Use if you want to add more words or citation to length.
|-
!location
|Location of the trail including park, state, county or region where appropriate and country.
|-
!trailheads
|where trail begins and ends
|-
!use
|always include at least hiking
|-
!photo
|Photo of the area around the trail. Specify as filename.jpg, no need for "File:". Please use a high-resolution original (at least 300 pixels wide).
|-
!photo_size
|Width of displayed photo, in pixels. Defaults to 250.
|-
!photo_alt
|[[WP:ALT|Alternate text]] for the displayed photo

|-
!designation
|Any designation which the trail has received e.g. [[National Trails (United Kingdom)|UK National Trail]] or [[National Scenic Trail|U.S. National Scenic Trail]].
|-
!established
|Establishment date
|-
!elev_gain_and_loss
|The elevation gain and/or loss e.g. "<nowiki>{{convert|300|m|ft|-1}}</nowiki> gain" or "<nowiki>{{convert|300|m|ft|-1}}</nowiki> gain in; <nowiki>{{convert|100|m|ft|-1}}</nowiki> gain out". Please express the gain or loss in meters or feet, not kilometers or miles.
|-
!elev_change
|rowspan=3|The sum of the altitude climbed or descended through the trail. Auto-converts units if _ft or _m suffix is used.
|-
!elev_change_ft
|-
!elev_change_m
|-
!highest_m
|rowspan=2|Elevation of highest point on trail, in either meters or feet (will autoconvert). Please use _ft only for trails in the United States
|-
!highest_ft
|-
!highest_name
|Name of highest point in trail (for use with '''highest_ft''' or '''highest_m''')
|-
!highest
|Free field for highest point in trail, use when citations is needed
|-
!lowest_m
|rowspan=4|Similar to '''highest_''' etc., except describing the lowest point of the trail
|-
!lowest_ft
|-
!lowest_name
|-
!lowest
|-
!grade
|The grade in percent, typical with former railroad right-of-ways
|-
!difficulty
|The difficulty of the trail for a typical healthy person based on a [[Wikipedia:Reliable sources|reliable source]]
|-
!season
|The season(s) that the trail may be hiked, or is easily accessible
|-
!months
|The months that the trail may be hiked, or is easily accessible
|-
!sights
|Significant sights along the way
|-
!hazards
|Major hazards that a hiker may encounter, as documented by a reliable source
|-
!surface
|The trail surface: natural, gravel, ballast, asphalt, etc.
|-
!ROW
|The current or former Right of way, e.g. railroads or railways
|-
!website
|Website of the organization that maintains the trail
|-
!waymark
|The waymark (sign or symbol) used to mark or signpost the route
|}

=== Embed inside another Infobox ===
The hiking trail Infobox can be embedded inside another Infobox for seamless display of info. For example, a hiking trail that is also a protected area, such as the [[Kal-Haven Trail]]. See the [[Template:Infobox hiking trail/testcases|testcases]] for more examples.

==== Inserting the hiking Infobox inside the parent Infobox ====
The hiking Infobox can only be inserted after certain field values of the parent template. Specifically, only after fields whose values are not passed to another template by the parent templates source code. In other words, the parent templates source code for the field has to output the fields' value without passing it to a template. This may require examining the parent templates source code. It is ok to insert after field values that contain internal <code>[[]]</code> and external links <code>[]</code>.<br />
Example:<br />
<pre><nowiki>
{| style="float:right; clear:right; border:0; margin:-0.5em 0 0 0;"
|-
|{{Infobox Protected area
| name = Kal-Haven Trail
...
| governing_body = <div>[[Michigan Department of Natural Resources]]</div>
{{Infobox hiking trail
  | embed = yes
  | cellstyle = padding:0.1em 0.3em;
  | name = Kal-Haven Trail
  | length = {{convert|34.5|mi|km|1}}
...
  }}
}}
|}
</nowiki></pre>
Note the &amp;lt;div&amp;gt; tag surrounding the governing_body wiki link. It is needed to reduce the vertical spacing between the governing_body field and the first hiking trail field, in this case, length.

==== Parent Infobox encapsulation ====
The parent Infobox needs to be encapsulated in a table as in the above example.
<pre><nowiki>
{| style="float:right; clear:right; border:0; margin:-0.5em 0 0 0;"
|-
|(parent Infobox)
|}
</nowiki></pre>

==== Parameters ====
{| class="wikitable"
! style="width: 14%" | Field name || Description
|-
|<code>embed</code> || Set to <code>embed = yes</code> when embedding inside another Infobox.
|-
|<code>cellstyle</code> || Set to a class/style that matches the outer Infoboxes cell class/style so that the columns line up properly. Example for using with {{tl|Infobox protected area}}:<br /><code>cellstyle = padding:0.1em 0.3em;</code>
|-
|<code>title</code> || A first colored header before the main infobox, used when embedded, to show the trail name
|}

=== Example ===
{{Infobox hiking trail
 | name = Wonderland Trail
 | photo = CowlitzDivide.JPG
 | caption = Mt Rainier from the Cowlitz Divide along the Wonderland Trail
 | location = [[Mount Rainier National Park]], [[Washington (state)|Washington]], [[United States]]
 | length = {{convert|93|mi|km|0}}<ref name="Filley">
     {{cite book
     | author = Filley, Bette
     | year = 2002
     | title = Discovering the Wonders of the Wonderland Trail: Encircling Mount Rainier (5th edition)
     | publisher = Dunamis House
     | isbn = 1-880405-09-1
     }}</ref>
 | trailheads = [[Longmire, Washington|Longmire Lodge]] <br/> [[Mowich Lake]] <br/> Ipsut Creek Camp Ground <br/> [[Sunrise (Mount Rainier)|Sunrise parking area]] <br/> White River Camp Ground <br/> Fryingpan Creek Trailhead <br/> Box Canyon <br/> Reflection Lakes <br/> Cougar Rock
 | use = [[Hiking]]
 | elev_gain_and_loss = {{convert|22000|ft|m|-2}} gain approximately<ref name="Filley"/>
 | highest = Panhandle Gap {{convert|6750|ft|m|-1}}<ref name="SpringManningMRNP">
     {{cite book
     | author = Spring, Ira
     | authorlink = Ira Spring
     | authorlink2 = Harvey Manning
     | author2=Manning, Harvey
     | year = 1999
     | title = 50 Hikes in Mount Rainier National Park
     | publisher = The Mountaineers
     | isbn = 0-89886-572-7
     }}</ref>
 | lowest = Ipsut Creek Campground {{convert|2320|ft|m|-1}}<ref name="Filley"/>
 | season = Summer to early [[Autumn|Fall]]
 | months = Mid-July through late September
 | website = [http://www.nps.gov/mora/planyourvisit/the-wonderland-trail.htm nps.gov/mora/planyourvisit/the-wonderland-trail.htm]
}}
<pre style="overflow:auto;"><nowiki>
{{Infobox hiking trail
 | name = Wonderland Trail
 | photo = CowlitzDivide.JPG
 | caption = Mt Rainier from the Cowlitz Divide along the Wonderland Trail
 | location = [[Mount Rainier National Park]], [[Washington (state)|Washington]], [[United States]]
 | length = {{convert|93|mi|km|0}}<ref name="Filley">
     {{cite book
     | author = Filley, Bette
     | year = 2002
     | title = Discovering the Wonders of the Wonderland Trail: Encircling Mount Rainier (5th edition)
     | publisher = Dunamis House
     | isbn = 1-880405-09-1
     }}</ref>
 | trailheads = [[Longmire, Washington|Longmire Lodge]] <br/> [[Mowich Lake]] <br/> Ipsut Creek Camp Ground <br/> [[Sunrise (Mount Rainier)|Sunrise parking area]] <br/> White River Camp Ground <br/> Fryingpan Creek Trailhead <br/> Box Canyon <br/> Reflection Lakes <br/> Cougar Rock
 | use = [[Hiking]]
 | elev_gain_and_loss = {{convert|22000|ft|m|-2}} gain approximately<ref name="Filley"/>
 | highest = Panhandle Gap {{convert|6750|ft|m|-1}}<ref name="SpringManningMRNP">
     {{cite book
     | author = Spring, Ira
     | authorlink = Ira Spring
     | authorlink2 = Harvey Manning
     | author2=Manning, Harvey
     | year = 1999
     | title = 50 Hikes in Mount Rainier National Park
     | publisher = The Mountaineers
     | isbn = 0-89886-572-7
     }}</ref>
 | lowest = Ipsut Creek Campground {{convert|2320|ft|m|-1}}<ref name="Filley"/>
 | season = Summer to early [[Autumn|Fall]]
 | months = Mid-July through late September
 | website = [http://www.nps.gov/mora/planyourvisit/the-wonderland-trail.htm nps.gov/mora/planyourvisit/the-wonderland-trail.htm]
}}
</nowiki></pre>

<div style="display: none"><references /></div>

<includeonly>
{{#ifeq:{{{nocat|}}}|true||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Гурӯҳ:Geography and place infobox templates|Hiking Trail]]
[[Гурӯҳ:Embeddable templates|Hiking Trail]]
}}</includeonly>