FrischLuftWege

Outdoor und Navigaton

Logo

Dieses Projekt auf GitHub inslichtruecken/gpx

Über diese Seite — Über mich — Übersichtskarte

How to Add Tracks

Some background

This Site is made using Jekyll and hosted on Github pages. A static site generator creates web pages from raw text files, such as markdown, and as such individual pages are simple markdown files. All set-up, install and preparation is covered in the set-up-instructions. Let’s assume now, that you have your own clone of the repository and your own set of Github Pages.

Where to edit

There are two ways to create new pages for tracks and test your edits:

How to add more Tracks

For each track you will need to create a new file in the Github repository. In the Github repo, all track descriptions are stored within the directory “_tracks”.

A page representing a track needs a layout associated, which ensures that all tracks look nice and consistent. The layout for a track is specified by the following property at the top of your file:

---
layout: track
---

There are further properties, which allow for a full structured description of a track with a lot of detail.

Supported properties:

Below the section specifying those properties you can add further markdown syntax to describe your track. That content will be rendering for you by the layout template as well. You are free to type whatever and as much individual content you want into the file. You can add further images, structure longer contributions with sub-headlines, bullets, etc. Here is a cheatsheet to get you acquianted with Git flavoured Markdown. However it is possible to just write plain text and it will still be served on a page.

A very simple track description can look like this:

---
layout: track
title: Track in the Black Forest
author: Thomas Stober
region: Black Forest
start-location: Baiersbronn
description: My first Track
length: 11 km
duration: 2,5 - 3 h
rise: 1200 m
difficulty: Easy
rating: 3
image: my-nice-photo.jpg
image-text: my nicephoto 
info-links: https://www.frischluftwege.de 
details-link: https://www.frischluftwege.de/thistrack
maplink: https://www.openstreetmap.org
gpx-file: Schoenbuchtrauf.gpx
map-image: Schoenbuchtrauf-Map.png
tags: Train Forest Family

TO DO VALIDATE PROPERTIES WHEN FINALLY DONE

---

## Welcome to my first track

here comes my detailed description 
with all **markdown** syntax you 
might want.

Once the file describing your track is committed on Github, it will represent your track as a unique page in your overall Github pages site and will be visible for everyone in the site navigation.

How to add Blog post

In addition to tracks you can also create blog posts. A Blog post has exactly the same concepts as a track description:

---
layout: post
---

There are further properties, which allow for a full structured description of a bog post.

Supported properties:

There is one special constraint on blog posts: The naming of the markdown post file must have the format yyy-mm-dd-name

Adding other pages to the Site

In addition to the tracks you can add further pages to the site by adding markdown formatted files to the directory structure. A good place to store static pages is the subdirectory “allgemein”. This page is a good example of such an additional page. Use the layout template general-page, which provides the property ‘title’.

---
layout: general-page
---

Supported properties:

Zurück