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.
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 .