This repository currently maintains all the data necessary to create the XCSoar File Manager application's repository manifest file as well as enable some XCSoar website functionality.
This data consists of:
-
content: The content itself, like:- Waypoints
- Airspaces
-
remote: URLs to external content, like:- Waypoints hosted on https://soaringweb.org, etc.
-
source: Configuration parameters specifying how to generate content, like:- Map bounding box coordinates
Within the above three parent directories, the child directories specify the XCSoar data type
(E.g. type=map in repository ).
This is fully specified by the directory name (e.g. map, waypoint, airspace, etc.)
The directory level below this, specifies the geographic area of the data, and is simply used to enforce various
validity checks.
For example, files in any country directories, must have a filename stem (filename sans extension) that is an
ISO3166.alpha2 country code (e.g. AR, DE, ZA, etc.).
This is used as the repository area field.
Additionally, for files in region subdirectories, the repository area
field will be best-effort extracted from the filename prefix (underscore separated).
E.g. ca_quebec.* implies Canada.
An optional description field can contain a string of text describing the
file in more detail. This field is displayed as the second row in the
FileManager.
The repository's update field is generated from the git commit date.
The following manifest files are built by, with, and from, this repo (required by ...):
- https://download.xcsoar.org/repository (XCSoar)
- https://download.xcsoar.org/waypoints/waypoints.js (website)
- https://download.xcsoar.org/waypoints/waypoints_compact.js (website)
- https://download.xcsoar.org/maps/maps.config.js (website &
mapgen) - https://download.xcsoar.org/waypoints/xcsoar_waypoints.cup (
mapgen)
Please feel free to add missing data and correct errors by submitting a pull request!
When doing so, please write in the comments the source of the new data, so that it is easy to verify.
Contributions here have to pass:
- A review by another contributer
- A parsing check by aerofiles
- Validity check depending on file type. E.g. remote URLs must exist, file extensions must be correct, etc.
Please look in and run script/check/check.bash to verify validity.
They are then merged, built, and deployed to https://download.xcsoar.org .