Template:Infobox trail/doc

This template is 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

{{{name}}}
[[File:{{{photo}}}|{{{photo_size}}}|alt={{{photo_alt}}}]] {{{caption}}}
{{{title}}}
Length	{{{length}}}
Location	{{{location}}}
Established	{{{established}}}
Designation	{{{designation}}}
Trailheads	{{{trailheads}}}
Use	{{{use}}}
Elevation gain/loss	{{{elev_gain_and_loss}}}
Elevation change	{{{elev_change}}}
Highest point	{{{highest_name}}}, , {{{highest}}}
Lowest point	{{{lowest_name}}}, , {{{lowest}}}
Grade	{{{grade}}}
Difficulty	{{{difficulty}}}
Season	{{{season}}}
Months	{{{months}}}
Waymark	{{{waymark}}}
Sights	{{{sights}}}
Hazards	{{{hazards}}}
Surface	{{{surface}}}
Right of way	{{{ROW}}}
Maintained by	{{{maintainer}}}
Website	{{{website}}}
{{{map_name}}}
[[File:{{{map}}}|{{{map_size}}}|alt={{{map_alt}}}]] {{{map_caption}}}

{{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 =
| maintainer =
| website =
| map =
| map_name =
| map_caption =
| map_size =
| map_alt =
| route =
| route_state =
}}

Parameter descriptions

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	Alternate text for the displayed photo
designation	Any designation which the trail has received e.g. UK National Trail or U.S. National Scenic Trail.
established	Establishment date
elev_gain_and_loss	The elevation gain and/or loss e.g. "{{convert|300|m|ft|-1}} gain" or "{{convert|300|m|ft|-1}} gain in; {{convert|100|m|ft|-1}} gain out". Please express the gain or loss in meters or feet, not kilometers or miles.
elev_change	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	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	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 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
maintainer	The organisation responsible for maintaining the route
website	Website of the organization that maintains the trail
waymark	The waymark (sign or symbol) used to mark or signpost the route
map	Map of the trail, if an image
map_name	Map name. Default is "Trail map".
map_size	Size of map (either in px or %)
map_alt	Alt text for map
map_caption	Caption for map
route	Map of the trail, if a route diagram template
route_state	Collapsed state of route map

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 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 [[]] and external links [].
Example:

{| 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}}
...
  }}
}}
|}

Note the <div> 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.

{| style="float:right; clear:right; border:0; margin:-0.5em 0 0 0;"
|-
|(parent Infobox)
|}

Parameters

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

Example

Wonderland Trail
Mt Rainier from the Cowlitz Divide along the Wonderland Trail
Length	93 miles (150 km)
Location	Mount Rainier National Park, Washington, United States
Trailheads	Longmire Lodge Mowich Lake Ipsut Creek Camp Ground Sunrise parking area White River Camp Ground Fryingpan Creek Trailhead Box Canyon Reflection Lakes Cougar Rock
Use	Hiking
Elevation gain/loss	22,000 feet (6,700 m) gain approximately
Highest point	Panhandle Gap 6,750 feet (2,060 m)
Lowest point	Ipsut Creek Campground 2,320 feet (710 m)
Season	Summer to early Fall
Months	Mid-July through late September
Website	nps.gov/mora/planyourvisit/the-wonderland-trail.htm

{{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]
}}