Add short explanation of track categories

Author: mastervanleeuwen

docs/categories.md

@@ -0,0 +1,32 @@
+---
+layout: page
+title: Categories
+nav_order: 4
+---
+
+# Categories
+
+{: .no_toc }
+
+<details open markdown="block">
+  <summary>
+    Table of contents
+  </summary>
+  {: .text-delta }
+1. TOC
+{:toc}
+</details>
+
+J!TrackGallery offers the possibility to organise tracks in _Categeries_, which are fully configurable. After installation, the suggesties categories are different activities, such as biking, hiking and driving, but you can completely customise the categories to suit your needs, for using different regions or other track atributes. Each category has an icon attached which is used on the overview map.
+
+If you only need one category, you can switch off the use of categories in the configuration menu. Internally, the tracks are still categorised, but this not explicitly shown in the frontend to reduce complexity for the user. Track icons on the overview map are stil determined by the categories. All new tracks will be assigned to the default category.
+
+
+## Category view
+
+A view showing a map and/or list of tracks in a specific category
+- Overview map
+- Track search/filter box
+- Track list
+Each element can be switched on or off in the configuration menu.
+The selection of columns shown in the track table is similar to that in the main 'Track list' overview page; it can also be configured in the configuration menu.

docs/configuration.md

@@ -1,7 +1,7 @@
 ---
 layout: page
 title: Configuration
-nav_order: 4
+nav_order: 5
 ---
 
 # Configuration settings

docs/index.md

@@ -34,8 +34,8 @@ The main functionality part or base package is a Joomla! *component* (`com_jtg.z
 The J!TrackGallery provides several _views_ which present the tracks in different formats. Most views can also be assigned to menu items in the menu(s) of your pages. The following views are provided:
 - [Overview map](overview): this is the main entry point showing an overview of all tracks that are available on your web site
 - [Track view](frontend): the main view with a map, graph, and details for a specific track - several aspects of this view can be configured to suit your needs. A button to edit the track information appears when authorised users are logged in to the site.
-- _Category list_: a list of all categories
-- _Category overview_: a map and/or list of tracks for a specific category
+- _Category list_: a list of all [categories](categories)
+- [Category overview](categories#Category view): a map and/or list of tracks for a specific category
 - _Track list_: a (sortable) list of all tracks with basic information about each track
 - _User view_: a view for users that are logged in, showing a list of tracks owned, and recent comments (if enabled on the site), as well as summary statistics
 

docs/languages.md

@@ -1,6 +1,6 @@
 ---
 title: Language support
-nav_order: 6
+nav_order: 7
 ---
 ## Language support
 

docs/overview.md

@@ -29,3 +29,7 @@ By default, the range of the map that is shown is automatically adjusted to show
   - *Center on user location* uses geolocation from the user's browser to center the map on the user's current location. This also uses the specified zoom level. If no geolocation information can be obtained, the defaults are used.
 
 There is also a configuration option to specify whether the welcome text should be shown or not.
+
+## Icon location
+
+Each track is shown on the map using the icon that is assigned to the [categorie](categories) that the track is part of. By default, the icon is placed at the start of the track, but there is a configuration option to use the end or the middle of the track. This can be useful if you have multiple tracks that start in the same location.

docs/plugin.md

@@ -1,6 +1,6 @@
 ---
 title: Map plugin
-nav_order: 5
+nav_order: 6
 ---
 ### J!TrackGallery maps plugin