Tracking Cumulative Travels
Contents
🔗 How to create a user list file
🔗 First steps with email submission
username.list
, replacing username
with the username you chose.
For example, if you choose the name highwayguy
, name your file highwayguy.list
.
.list
file with the following format:
Region Route Waypoint1 Waypoint2
For example, if you traveled in the United States on Interstate 70 in Illinois between Exit 52 and the Missouri border, you would put the following line in your file:
IL I-70 52 MO/IL
.list name:
in the Highway Browser.52
of your travel segment on the table
to center the map at this point.52
.MO/IL
or click the waypoint on the map
to open the info window and copy the label name MO/IL
.MO I-70 MO/IL 249
MO I-70
link under Intersecting/Concurrent Routes:
on the info window to open
the Missouri continuation of Interstate 70 within the Highway Browser..list name:
for your second line in your
.list
file..list
extension. Word processor files (Microsoft Word,
Open Office Write, etc.) and rich-text formats will not work. If you use a word processor to create your file,
be sure to select "Save As..." and save the file in a plain text format..list
file by email to travmap@teresco.org
destination.
Mention in the subject line that your username is a new one.
You have now finished your part! Your file will be included in the next site update, which typically occurs nightly between 9 and 11 PM US/Eastern..list
file to reflect the new highways on which you
have traveled. To submit your updated file, just email it again, and it will be processed in the subsequent site update.🔗 Solutions to common problems
.list
by default and/or including an extra, hidden .txt
extension, a .list.txt
extension is also accepted (e.g., highwayguy80.list.txt
). However, users are asked to avoid the
double extension so that files do not need to be renamed after being submitted.
🔗 More examples of how to break down your travels
🔗 Advanced features
.list
file line.
.list
file. All text on a given line after a #
is treated
as a comment, and is ignored by the site update process. You can
comment out entire lines, or use them to include an annotatation at
the end of the line.
#My first travel section
IL I-70 52 MO/IL #This is the section in Illinois
MO I-70 MO/IL 249 #This is the section in Missouri
.list
file
Many users break up list files into chunks by region or highway
type to make it easier to read or manage.
You can also use blank lines as desired to enhance readability.
.list
file, it is placed under source
code control using GitHub.
Instead of emailing updates, some users fork our GitHub repository at
https://github.com/TravelMapping/UserData and submit a pull request.
Using GitHub directly is by no means required. Unless you are an
experienced Git/GitHub user, it's usually best to submit at least
your initial file by email to
ensure it ends up in the correct location and does not have any
problems that would cause problems with the system.
🔗
Initial setup to use GitHub directly:
Fork
at top of the page.Commit directly to the master branch
on the bottom of the page.Commit changes
.Pull request
.Create pull request
.Create pull request
again.Close pull request
.
.list
file by running the site update to
create the user log file before submitting the Github pull request. You can use the
data verification tool.
🔗 How to become a highway data manager