Ozarkapedia:How to add a new river

From Ozarkapedia
Jump to navigation Jump to search

Intro[edit source]

This page can help you add a new river to Ozarkapedia. It's meant for technical folks who don't mind dealing with code. If that's not you, just drop a message to User:Rootwad and he can get it set up pretty quick. It's a lot easier to add stuff to an existing river by following one of the related guides.

Steps[edit source]

  1. Create a GeoJSON page to hold the map data for the river path
    1. Cruise over to OpenStreetmap.org, and use the search feature to get it to show the entire river from the source
      1. There may be multiple results. Click through them until it looks like it's showing the entire river.
      2. OSMSearch.jpg
      3. OSMRiverSelected.jpg
    2. Copy the 'Relation ID'
      1. OSMRelationID.jpg
    3. Open a new browser tab to https://overpass-turbo.eu/
    4. Modify the following query to contain the relevant Relation ID that you copied in the previous step.
      1. [out:json][timeout:60]; relation(6113750); way(r); (._; >;); out geom;
    5. Click Export at the top, then under Data, look for GeoJSON and click the Copy button on that line
    6. Open a new tab to www.ozarkapedia.org/wiki/GeoJSON:<RiverName> where <RiverName> is replaced with the river you want to create.
      1. Example: https://www.ozarkapedia.org/wiki/GeoJSON:Big_River
      2. https://www.ozarkapedia.org/wiki/GeoJSON:Gasconade
    7. Click "Create from GeoJSON Source"
    8. On the new page, delete all the existing text
    9. Paste in the GeoJSON we copied in the previous step
    10. Click "Show Preview", and if everything looks good, "Save Page" at the bottom of the screen
    11. Clean up the GeoJson by hand, reduce it to a single Feature.
      1. Use a GeoJSON tool to examine the current file.
      2. Using the ID attached to each feature, identify the proper order for the features, starting at the river source and ending at its terminus
      3. Concatenate the multiple features into a single feature with no duplicated coordinates.
      4. Save the new file in Ozarkapedia.
      5. Try ctrl-f to search for "node"; OSM likes to tag river ford crossings as a point and we don't need those cluttering up the map.
  2. Create the page for the river itself by opening the URL and clicking "Create from Source"
    1. Example: https://www.ozarkapedia.org/wiki/Big_River
    2. At the top of the page, say one sentence about the river,
    3. then one the last two lines, add the Template functions. Modify them to include the correct river name.
      1. {{Template:River|River=Big River}}
      2. {{Template:Big River Distances}}
        1. This is a chart that can be used to calculate the distance between two ramps. We'll talk about this in a separate article.
    4. Save the page.
    5. We've created the river, but the map won't draw until we add some points of interest. We do this by creating a page for the point of interest.
      1. The following types of page are added to the map for the river. Follow the link for instructions on adding each type of page.
        1. Category:Outfitter
        2. Category:River Access
        3. Category:Bluffs
        4. Category:Caves
        5. Category:Springs
        6. Category:Rapids and Hazards
  3. Create pages for all of the ramps.
  4. Add gauge data and ramp photos to the ramp pages
  5. Divide the river into sections of about 10-20 miles between ramps, and create a page for each section
  6. Update the Distance Chart