diff options
| author | jak1 <mike.wollmann@gmail.com> | 2021-03-19 14:42:10 +0100 |
|---|---|---|
| committer | jak1 <mike.wollmann@gmail.com> | 2021-03-19 14:42:10 +0100 |
| commit | 53f95ab9a033079f1f7568f4e3d63355e2bd1037 (patch) | |
| tree | 15078e86f27262dd3c84740b008bdc89712df1db | |
| parent | f9713804951393fb7e1c5e1633532ce033579e20 (diff) | |
| download | docker-windows-builder-53f95ab9a033079f1f7568f4e3d63355e2bd1037.tar.gz docker-windows-builder-53f95ab9a033079f1f7568f4e3d63355e2bd1037.tar.bz2 docker-windows-builder-53f95ab9a033079f1f7568f4e3d63355e2bd1037.tar.xz docker-windows-builder-53f95ab9a033079f1f7568f4e3d63355e2bd1037.zip | |
added documentation for mirrorlist.* (feel free to add missing stuff)
| -rw-r--r-- | docs/mirrorlist.md | 54 |
1 files changed, 54 insertions, 0 deletions
diff --git a/docs/mirrorlist.md b/docs/mirrorlist.md new file mode 100644 index 0000000..0b4c3be --- /dev/null +++ b/docs/mirrorlist.md @@ -0,0 +1,54 @@ +# MirrorLists +[XML](#XML)\ +[YML](#YML)\ +[JSON](#JSON) + +### Description for all lists +the root element is called `versions` and must only include `version` elements. +all `version` elements must have 2 string attributes `file` and `checksum` +this `version` elements require min. 1 self-closing element called `mirror` with a string attribute `url`. + +### XML +#### example: +```xml +<?xml version='1.0' encoding='utf-8'?> +<!-- + Authors: jak1 + Copyright: (C) 2021 TheManaWorld Developers + Generated by: Gitlab deploy (manual changes will get overwritten) +--> +<versions> + <version file="bar-baz.zip" checksum="47ac26e6014b2dea92ed3611161177dadbce50615f34b1e875d0f9e13b6a6d75"> + <mirror url="https://mirrorurl.foo/bar-baz.zip"/> + <mirror url="https://anothermirrorurl.foo/bar-baz.zip"/> + </version> + <!-- ... --> +</versions> +``` +###### (the comment on top of the file is not required but should have always the same format) +### YML +not implemented (nor required) yet + +### JSON +#### example: +attributes gets a `-` before there name that prevents "file" to do weird stuff +```json +{ + "#comment": "Authors: jak1 Copyright: (C) 2021 TheManaWorld Developers Generated by: Gitlab deploy (manual changes will get overwritten)", + "versions": { + "version": { + "-file": "bar-baz.zip", + "-checksum": "47ac26e6014b2dea92ed3611161177dadbce50615f34b1e875d0f9e13b6a6d75", + "mirror": [ + { + "-url": "https://mirrorurl.foo/bar-baz.zip" + }, + { + "-url": "https://anothermirrorurl.foo/bar-baz.zip" + } + ] + } + } +} +``` +###### (the comment on top of the file is not required but should have always the same format)
\ No newline at end of file |