Help:Contents: Difference between revisions

From TEHCC Wiki
Jump to navigation Jump to search
m (→‎Welcome: minor edit)
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
== Welcome ==
== Welcome ==
Welcome to our online repository for everything trail related within a reasonable distance from our club's center in Kingsport TN. The goal is to provide an easy way to find useful information about trails in our area so you can figure out where you want to go, how you'll get there, what to look for, and then provide a place to come back and update what you experienced for everyone's benefit.
Welcome to our online repository for everything trail related within a reasonable distance from our club's center in Kingsport TN. The goal is to provide an easy way to find useful information about trails in our area so you can figure out where you want to go, how you'll get there, what to look for, and then provide a place to come back and update what you experienced for everyone's benefit.
 
Over time the scope has increased to include the parks that you use to access the trails. There is a particular focus on lodging options at the park and other activities and amenities the park provides.


Please contact us at [mailto:webmaster@tehcc.org webmaster@tehcc.org] if you would like to share information or if you have questions on how to help or use the site.
Please contact us at [mailto:webmaster@tehcc.org webmaster@tehcc.org] if you would like to share information or if you have questions on how to help or use the site.


== New to the site? ==
== Here just to use the site? ==
*What is this?
Great! Dive right in. We have many ways you can find trails to your liking.
: It's our trail wiki
*Use the search box - search for parks or trails that you may have heard about
*I know what a trail is, what's a wiki?
*Use the [[ClubWiki:Trails_List|trails list]]. The page is a little out of date with the format overhaul, but still a good resource. At some point this page will be fully automated to list the trails and parks automatically on the site.
: Well I could write a bunch here, but it's best just to go to the best wiki of them all: Wikipedia, [http://en.wikipedia.org/wiki/Wiki here's their definition]. Essentially it's a site made for the easy contributing and editing by anyone on the internet as well as easy cross referencing across the site.
*Use the [[Template:Map AreaTrails|Map of all trails]]. While the wiki has expanded to track more than just trails, this map (for now...) will show a map balloon for every documented trail with a trailhead GPS coordinate. Click on the balloon title to take you to that trail.
*Woah, any one can edit? Aren't you worried someone will delete something, or mess things up?
*Coming eventually - Searching based on criteria. With the page conversion to more searchable trail and park properties, you will soon be able to search for trails and parks based on the attributes you desire (trail distance, features, park with campground, parks with lots of miles of trails, etc.)
: Um no.
 
*Really, you're not worried?
== What's going on with this "conversion"? ==
: No, most people are out there to help not hurt. Plus you can't get big rewards if you don't take risks. Lastly all changes on the site are monitored and every creation, revision, and deletion is saved, so old versions can always be reverted back if someone messes something up really bad.
A few times already I have mentioned this "conversion." Originally this site was a very "flat" or "static" system. Meaning Each page existed on its own from the rest. There was some shared "templates" or portions of a page, like a trail list. But the pages and templates had to be manually changed with every impacting addition. Meaning, if you added a trail, you also had to update the park page's trail list, the site trail list, and the park's trail count and trail tally. Now the pages can be tagged with properties and those properties searched and compiled by pages and templates through special queries. With that same example above, just creating the trail page and appropriately assigning location, features, and length, the rest of the site automatically updates to include it.
*Ha! You're going to collect all of this information, do all of this work, and someone is just going to steal it all, put it on a heavily ad riddled site or publish it in a book
 
:First of all, information here is Copyright TEHCC so legally you can't steal it. Again we're back to risk vs. reward. Trail information that we can edit and control is worth the risk. But seriously please don't steal it, we worked hard to get this.
== General site layout or strategy ==
*Why are there missing pages for some trails?
[[File:Trail Wiki Layout.png|thumb|right|Site hierarchy]]
: This project was started in Spring 2011, so it is being built as folks gather the information. If you know something about a trail, then create or update the page. Remember it's a wiki, so will be filled out by multiple contributors, including '''you'''.
The main focus of the site are the trails. But the trails will fall under several types of categorization. For us it is the following (all optionally assigned), the park, the land owner, and the trail system. There are a few more, but I'm trying to keep it simple.
*Park is (usually) very easy. If it's completely within it's boundaries or the main trailhead is within the park, it's part of that park. [[Warriors' Path State Park|Warriors' Path]] and [[Sinking Waters]] are an example of a trail/park pairing.
*Land Owner - Not often assigned, but it can help define allowed uses especially if the trail is not assigned to a park. Trails and Parks that are under the management of [[Special:Browse/:Cherokee-20National-20Forest|Cherokee National Forest]] is an example.
*Trail Systems - This can be for a logical separate group of trails at a park, prime example is [[Special:Browse/:Warriors%27-20Path-20State-20Park-20Mountain-20Bike-20Trails|Warriors' Bike Trails]]. Also could be for a trail system that is larger than any one trail or park. [[TEHCC_AT|Appalachian Trail]], [[Overmountain_Victory_National_Historic_Trail|Overmountain Victory Trail]], and [[Mountains-to-Sea_Trail|Mountains-to-Sea trails]] are all prime examples. Last would be the "Challenge" sets, namely [[Special:Browse/:SB6k|South Beyond 6,000]].
These are all assigned from within the park and trail forms (by using "Edit with form" when available).


== New to wikis ==
Map markers exist as subobjects on trail pages (and park pages). This makes it possible for other pages to retrieve them to include in their maps. These are most easily created by using the park and trail forms. [[Warriors' Path State Park|Warriors' Path]] and [[Sinking Waters]] are examples of extensive use of map markers.
*What does it mean if the trail name is in red?
:Red means it's linking to a non-existing page. The nice thing about wikis is that we can make references to future pages. Sort of like a leaving a note, that at some point we would like to make a page that is eventually on the other side of that link.
*I looked at the "Edit" for of a page, it doesn't look too bad, but what's with the special characters?
: That's the wiki markup, here's some [[Help:Editing|information on editing]].
*Do you have any more information for those thinking about helping to contribute?
: Yeah, read the section below "Helping to contribute"


== Finding trails ==
Last are Trail Stubs. Like Map markers, they exist as subobjects, but in this case only on parks. It was created for both quickly adding a simple record of all trails that are part of a park and a permanent place for trails that don't merit a dedicated page like a short 0.5 mi connector. Again, these are most easily created using the park form. [[Big Ridge State Park]] is an example of trail stubs (and trail pages). Trail Stubs are identifiable as they will have a red link on the Park's trail table and a blue "information' icon appears to the right to explain them. Clicking the link will take you to the trail page creation form and carryover any assignments already given like associated park, length, difficulty, marking, and highlight.
*Alright, I'm trying to find trails to hike, but it's taking forever going through each page.
: You've got lots of options here. You can search the map, we have our [[ClubWiki:Trails_List|trails list]] which can be sorted alphabetically or by driving distance, by trail use, by category, or if you want to roll the dice, hit "Random page" on the left.  Or try our recommendations at [[ClubWIKI:TopsList]]. Different paths for different interests.


== Helping to contribute ==
== Helping to contribute ==
*Well it's a great idea and all, but I hate coding. Oh well, wished I could help.
You have many ways to help ranging from an email to heavy coding. In increasing order...
: Hey! Not so fast. It's not really coding, yeah you have to do some markup, but it's nothing like writing a program or making a web page in HTML. If you follow other more complete pages, it should be fairly easy to follow along. It's mostly just writing.
=== Email us with information ===
*Yeah, well I hate writing too, regardless I don't want to spend my time writing web pages, I've got trails to hike during the day, and trips to plan at night.
*If you see something wrong or missing - [mailto:webmaster@tehcc.org email me]!
: Well then you're actually the kind of person we need most, gathering information. The hardest part very well could be collecting all of the trail information, how to get there, what to look for, pictures, GPS tracks, etc...
**Missing could range from a park or trail, maybe a route log file from a hike of yours, or just some missing attributes like there is geocaching along the trail and the park has a restaurant
*Alright, you convinced me, how do I get this information to you?
 
: Send it to me at [mailto:webmaster@tehcc.org webmaster@tehcc.org]
=== Simple corrections or additions ===
*I changed my mind, how do I make changes to the site myself?
If you're willing to delve deeper, just hit the "Edit with form" and look for the information to change.
: Well first I would suggest making a login by going to the upper right of the site and following the links
*If it's information in the information box on the right, most of that information should be found on the "Info Box" tab of the form. Simple fields with descriptions should make identifying what's needed fairly simple.  
*Okay, I'm back and logged in. Hey I can edit without logging in, why did I just do that, are you going to spam me?
*If it's in the page text that's available on the next tab "Page Text." At the top of that tab there is a layout of the general desired heading structure on the left and typical templates to use on the right. General editing commands help can be found on our [[Help:Editing|Help Page]]. Or my favorite technique, find something similar to what I want to do and figure out how it was done.  
: No, your email address is only for password recovery. Nothing else. Logging in helps identify who's doing what changes, so if needed we can discuss with you about your changes if we want to, plus you get logged for all of your changes and we can see how big of a help you are.
*The last tab "Map Markers" is to define the map balloons that show up on the trail map.
*Alright, let's get started!
*If you have an updated KML, use the Upload KML or Upload new version depending on if they already have one (once converted to the new format). There are some particular layouts of the KML that are preferred, and updating the length, low/high, and gain/loss data using [[TEHCC_Wiki:Trail_Elevations|GPS Visualizer]] that should be done. That will be documented in detail later.
: OK, either you'll be creating new pages or adding to or editing existing pages. Adding to existing pages should be easy, just hit edit and find where you want the changes and do it. Here's some [[Help:Editing|information on editing]]. If you're unsure, hit "show preview" before hitting "save page" to see how it would look. Again don't worry too much about messing up, we can always revert back to earlier revisions.
 
*It's a new trail I want to add
=== Adding new parks and trails ===
: That's going to be a bit more work. But not too bad, We've got templates to make it easy on you and steps to follow. Best to follow [[ClubWiki:Creating_a_Trail]] for all of the steps needed. It's fairly easy, I promise.
If you want to add parks and trails, I'll work on documenting that better but as always, just give it a try! You can't mess it up! (Permanently). People get notifications when pages are changed, so it's likely a problem edit won't go unnoticed for long and they will help you tweak your contribution as needed.  
*Well I'm confused, that's still too hard.
*For Parks use the [[Form:Park|Park Form]] and for trails use the [[Form:Trail|Trail Form]]
: No problem, email me at [mailto:webmaster@tehcc.org webmaster@tehcc.org] and let me know which trail and I'll add all of the needed pages and references so you can just add to the newly created page.
View [[ClubWiki:Creating a Trail|Creating a Trail]] for a more detailed instruction on new trail page creation.
*Anything else?
 
: Yeah, here's a page of links I often use for editing the site: [[ClubWiki:Admin|Useful links to those administrating or heavily editing the site]]
=== Trail conversion to the new format ===
If you want to do something now that is known to be needed. It's converting the old format trails (and sometimes parks, i.e. a collection of trails) from this [[:Category:Trail|Trail Category]] to the [[:Category:Trails|'''Trails''' Category]]. It's a multi-step process.
*Modify all photo pages to have the template that will associate it to the trail - see photos on a completed trail like [[Sinking Waters]] and hit "Edit" (not "Edit with form") to see the [[Template:Image|Image template]] that needs to be added.
*Hit Edit on the targeted trail to upgrade and delete (or copy to notepad for temporary reference) all of the lines at the top of the page of the old layout including the 'Infobox Trail' and 'Trail page needs' templates, all of the way down to the page text, usually "Trail Overview."
*From a current formatted trail, again like [[Sinking Waters]], hit "Edit" (not "Edit with form") and copy all of the text of the Trail template and Trail Map template all of the way down to "Trail Overview." Paste that into the targeted trail page to upgrade at the top.
*Scroll down to the bottom of the targeted trail page to upgrade and usually delete everything (or copy to notepad for now for easy reference) from "Maps" all of the way down including the photo gallery and Category assignments
*Hit save and the page is now semi converted, it's the new format but lots of information is missing.
*Hit "Edit with form" (if it doesn't appear right away, refresh and try again), then populate the Info Box and Map Markers based on the old page information
**Trail lengths and elevation gain/loss is now calculated as described [[TEHCC Wiki:Trail Elevations|here]]
*On the Page Text tab, copy the Gallery section and paste it to the bottom of the page text. This provides the automatic inclusion of any trail tagged pages and provides a link for easy addition of more images.
*Hit Save, check it out and if it looks good, you're done! (Phew!) Otherwise hit Edit or Edit with form and keep trying .


Please contact us at [mailto:webmaster@tehcc.org webmaster@tehcc.org] if you would like to share or if you have questions on how to help or use the site.
Please contact us at [mailto:webmaster@tehcc.org webmaster@tehcc.org] if you would like to share or if you have questions on how to help or use the site.

Latest revision as of 09:07, 13 December 2019

Welcome[edit]

Welcome to our online repository for everything trail related within a reasonable distance from our club's center in Kingsport TN. The goal is to provide an easy way to find useful information about trails in our area so you can figure out where you want to go, how you'll get there, what to look for, and then provide a place to come back and update what you experienced for everyone's benefit.

Over time the scope has increased to include the parks that you use to access the trails. There is a particular focus on lodging options at the park and other activities and amenities the park provides.

Please contact us at webmaster@tehcc.org if you would like to share information or if you have questions on how to help or use the site.

Here just to use the site?[edit]

Great! Dive right in. We have many ways you can find trails to your liking.

  • Use the search box - search for parks or trails that you may have heard about
  • Use the trails list. The page is a little out of date with the format overhaul, but still a good resource. At some point this page will be fully automated to list the trails and parks automatically on the site.
  • Use the Map of all trails. While the wiki has expanded to track more than just trails, this map (for now...) will show a map balloon for every documented trail with a trailhead GPS coordinate. Click on the balloon title to take you to that trail.
  • Coming eventually - Searching based on criteria. With the page conversion to more searchable trail and park properties, you will soon be able to search for trails and parks based on the attributes you desire (trail distance, features, park with campground, parks with lots of miles of trails, etc.)

What's going on with this "conversion"?[edit]

A few times already I have mentioned this "conversion." Originally this site was a very "flat" or "static" system. Meaning Each page existed on its own from the rest. There was some shared "templates" or portions of a page, like a trail list. But the pages and templates had to be manually changed with every impacting addition. Meaning, if you added a trail, you also had to update the park page's trail list, the site trail list, and the park's trail count and trail tally. Now the pages can be tagged with properties and those properties searched and compiled by pages and templates through special queries. With that same example above, just creating the trail page and appropriately assigning location, features, and length, the rest of the site automatically updates to include it.

General site layout or strategy[edit]

Site hierarchy

The main focus of the site are the trails. But the trails will fall under several types of categorization. For us it is the following (all optionally assigned), the park, the land owner, and the trail system. There are a few more, but I'm trying to keep it simple.

These are all assigned from within the park and trail forms (by using "Edit with form" when available).

Map markers exist as subobjects on trail pages (and park pages). This makes it possible for other pages to retrieve them to include in their maps. These are most easily created by using the park and trail forms. Warriors' Path and Sinking Waters are examples of extensive use of map markers.

Last are Trail Stubs. Like Map markers, they exist as subobjects, but in this case only on parks. It was created for both quickly adding a simple record of all trails that are part of a park and a permanent place for trails that don't merit a dedicated page like a short 0.5 mi connector. Again, these are most easily created using the park form. Big Ridge State Park is an example of trail stubs (and trail pages). Trail Stubs are identifiable as they will have a red link on the Park's trail table and a blue "information' icon appears to the right to explain them. Clicking the link will take you to the trail page creation form and carryover any assignments already given like associated park, length, difficulty, marking, and highlight.

Helping to contribute[edit]

You have many ways to help ranging from an email to heavy coding. In increasing order...

Email us with information[edit]

  • If you see something wrong or missing - email me!
    • Missing could range from a park or trail, maybe a route log file from a hike of yours, or just some missing attributes like there is geocaching along the trail and the park has a restaurant

Simple corrections or additions[edit]

If you're willing to delve deeper, just hit the "Edit with form" and look for the information to change.

  • If it's information in the information box on the right, most of that information should be found on the "Info Box" tab of the form. Simple fields with descriptions should make identifying what's needed fairly simple.
  • If it's in the page text that's available on the next tab "Page Text." At the top of that tab there is a layout of the general desired heading structure on the left and typical templates to use on the right. General editing commands help can be found on our Help Page. Or my favorite technique, find something similar to what I want to do and figure out how it was done.
  • The last tab "Map Markers" is to define the map balloons that show up on the trail map.
  • If you have an updated KML, use the Upload KML or Upload new version depending on if they already have one (once converted to the new format). There are some particular layouts of the KML that are preferred, and updating the length, low/high, and gain/loss data using GPS Visualizer that should be done. That will be documented in detail later.

Adding new parks and trails[edit]

If you want to add parks and trails, I'll work on documenting that better but as always, just give it a try! You can't mess it up! (Permanently). People get notifications when pages are changed, so it's likely a problem edit won't go unnoticed for long and they will help you tweak your contribution as needed.

View Creating a Trail for a more detailed instruction on new trail page creation.

Trail conversion to the new format[edit]

If you want to do something now that is known to be needed. It's converting the old format trails (and sometimes parks, i.e. a collection of trails) from this Trail Category to the Trails Category. It's a multi-step process.

  • Modify all photo pages to have the template that will associate it to the trail - see photos on a completed trail like Sinking Waters and hit "Edit" (not "Edit with form") to see the Image template that needs to be added.
  • Hit Edit on the targeted trail to upgrade and delete (or copy to notepad for temporary reference) all of the lines at the top of the page of the old layout including the 'Infobox Trail' and 'Trail page needs' templates, all of the way down to the page text, usually "Trail Overview."
  • From a current formatted trail, again like Sinking Waters, hit "Edit" (not "Edit with form") and copy all of the text of the Trail template and Trail Map template all of the way down to "Trail Overview." Paste that into the targeted trail page to upgrade at the top.
  • Scroll down to the bottom of the targeted trail page to upgrade and usually delete everything (or copy to notepad for now for easy reference) from "Maps" all of the way down including the photo gallery and Category assignments
  • Hit save and the page is now semi converted, it's the new format but lots of information is missing.
  • Hit "Edit with form" (if it doesn't appear right away, refresh and try again), then populate the Info Box and Map Markers based on the old page information
    • Trail lengths and elevation gain/loss is now calculated as described here
  • On the Page Text tab, copy the Gallery section and paste it to the bottom of the page text. This provides the automatic inclusion of any trail tagged pages and provides a link for easy addition of more images.
  • Hit Save, check it out and if it looks good, you're done! (Phew!) Otherwise hit Edit or Edit with form and keep trying .

Please contact us at webmaster@tehcc.org if you would like to share or if you have questions on how to help or use the site.