Template:Infobox trail/doc

Wonderland Trail
Mt Rainier from the Cowlitz Divide along the Wonderland Trail
Length	93 miles (491,000 ft)
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}} 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.

Usage

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.
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. "300 metres (980 ft) gain" or "300 metres (980 ft) gain in; 100 metres (330 ft) gain out". Please express the gain or loss in meters or feet, not kilometers or miles. You may use the {{convert}} template to automatically convert values to alternative units.
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
website	Website of the organization that maintains the trail

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

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

Blank template

{{Infobox hiking trail
 | name = 
 | embed = 
 | cellstyle = 
 | title =  
 | photo = 
 | photo_size =
 | caption = 
 | location = 
 | designation = 
 | established =
 | length = 
 | 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 = 
 | sights = 
 | hazards = 
 | surface = 
 | ROW = 
 | website = 
}}