Difference between revisions of "Wiimm's Custom Archive/Distribution"

From Custom Mario Kart
Jump to navigation Jump to search
Line 21: Line 21:
  
 
== Parameters of the configuration file ==
 
== Parameters of the configuration file ==
???
+
 
 +
The configuration files if divided into 2 parts:
 +
* Parameters
 +
* Track list
 +
Each parameter line begins »'''@'''«. So it can be distinguished from track lines. The order of the lines is irrelevant on scanning, but the out is well organized into sections by comments.
 +
 
 +
If a parameter is defined multiple times, only the last definition is used. Parameter names are case insensitive. The line length is not limited.
  
 
=== Comments for personal use ===
 
=== Comments for personal use ===
???
 
  
<dl>
+
The first section consists of user comments (@COMMENT1 .. @COMMENT5). So each user can enter any informational lines, that are exported to the next version of the file. These comments will never imported to ct.wiimm.de.
<dt>@COMMENT1 .. @COMMENT5</dt><dd>
 
???
 
</dd>
 
  
 
=== Identify yourself! (private section) ===
 
=== Identify yourself! (private section) ===
???
 
 
<dt>@USER-CT-WIIMM</dt><dd>
 
???
 
</dd>
 
 
<dt>@USER-WIIMMFI</dt><dd>
 
???
 
</dd>
 
 
<dt>@USER-CT-WIIKI</dt><dd>
 
???
 
</dd>
 
 
<dt>@USER-MISC</dt><dd>
 
???
 
</dd>
 
 
<dt>@MAIL</dt><dd>
 
???
 
</dd>
 
  
<dt>@NOTE-FOR-WIMMM</dt><dd>
+
The next section gives yo a chance to identify yourself. It's no problem to leave all parameters empty. But on issues, [[Wiimm]] will use one of theses field to contact you.
???
 
</dd>
 
  
 
=== Distribution parameters ===
 
=== Distribution parameters ===
???
 
 
<dt>@NAME</dt><dd>
 
???
 
</dd>
 
 
<dt>@VERSION</dt><dd>
 
???
 
</dd>
 
 
<dt>@AUTHORS</dt><dd>
 
???
 
</dd>
 
 
<dt>@RELEASE-DATE</dt><dd>
 
???
 
</dd>
 
  
<dt>@KEYWORDS</dt><dd>
+
The distribution parameters are mandatory identify your distributions. @NAME, @VERSION and @AUTHORS are free text field and mandatory. @RELEASE-DATE is mandatory too and contains the release date of the distribution of format yyyy-mm-dd.
???
 
</dd>
 
  
<dt>@WIIMMFI-REGION</dt><dd>
+
All 4 parameters of above are used to create a keyword list for your distribution. @KEYWORDS allows you to add some more keywords. All keywords are used for the distribution search.
???
 
</dd>
 
  
<dt>@INFO-TEXT</dt><dd>
+
With @PREDECESSOR you can identify exact 1 predecessor of this distribution. Predecessor and successors are list at the info page for easier navigation.
???
 
</dd>
 
  
<dt>@INFO-URL</dt><dd>
+
@INFO-TEXT is a free HTML formatted information text and @INFO-URL is a complete link to the main distribution page in the web. Both parameters are optional.
???
 
</dd>
 
  
 
=== Settings for ct.wiimm.de ===
 
=== Settings for ct.wiimm.de ===
 
???
 
???
  
<dt>@DISPLAY-MODE</dt><dd>
 
???
 
</dd>
 
  
<dt>@DATABASE-NAME</dt><dd>
 
???
 
</dd>
 
 
<dt>@VIEW-COMMENT</dt><dd>
 
???
 
</dd>
 
  
 
=== Automatically created parameters ===
 
=== Automatically created parameters ===
 
???
 
???
  
<dt>@UUID</dt><dd>
+
=== User defined parameters ===
???
 
</dd>
 
 
 
<dt>@FILE-VERSION</dt><dd>
 
???
 
</dd>
 
 
 
<dt>@FIRST-CREATION</dt><dd>
 
???
 
</dd>
 
 
 
<dt>@LAST-UPDATE</dt><dd>
 
 
???
 
???
</dd>
 
</dl>
 
  
 
=== Track listing ===
 
=== Track listing ===

Revision as of 21:43, 20 November 2017

Wiimm's Custom Archive is a service (website https://ct.wiimm.de/) by Wiimm. It allows an easy access to custom tracks and arena archive. This article focuses at the distribution support of the website.


Introduction

Wiimm's Custom Archive[1] is a download archive for many thousands of custom track files as WBZ. It supports Custom Track Distributions too.

Features

To support a distribution, the user has to download Wiimms SZS Tools version ≥1.55a (≥1.55b recommended) and to execute the command »wszst DISTRIBUTION« (or the short form »wszst dist«). The command scans the tracks and create (or edit) a custom tack definition file. The user has to edit the file and to upload it [2].

wszst DISTRIBUTION

???

Parameters of the configuration file

The configuration files if divided into 2 parts:

  • Parameters
  • Track list

Each parameter line begins »@«. So it can be distinguished from track lines. The order of the lines is irrelevant on scanning, but the out is well organized into sections by comments.

If a parameter is defined multiple times, only the last definition is used. Parameter names are case insensitive. The line length is not limited.

Comments for personal use

The first section consists of user comments (@COMMENT1 .. @COMMENT5). So each user can enter any informational lines, that are exported to the next version of the file. These comments will never imported to ct.wiimm.de.

Identify yourself! (private section)

The next section gives yo a chance to identify yourself. It's no problem to leave all parameters empty. But on issues, Wiimm will use one of theses field to contact you.

Distribution parameters

The distribution parameters are mandatory identify your distributions. @NAME, @VERSION and @AUTHORS are free text field and mandatory. @RELEASE-DATE is mandatory too and contains the release date of the distribution of format yyyy-mm-dd.

All 4 parameters of above are used to create a keyword list for your distribution. @KEYWORDS allows you to add some more keywords. All keywords are used for the distribution search.

With @PREDECESSOR you can identify exact 1 predecessor of this distribution. Predecessor and successors are list at the info page for easier navigation.

@INFO-TEXT is a free HTML formatted information text and @INFO-URL is a complete link to the main distribution page in the web. Both parameters are optional.

Settings for ct.wiimm.de

???


Automatically created parameters

???

User defined parameters

???

Track listing

???

Tracks unknown by ct.wiimm.de

???