From 2e3d49e1fe53bc189140c104fcf4e1709b822b3e Mon Sep 17 00:00:00 2001 From: M5oul Date: Wed, 1 Nov 2017 00:19:51 +0100 Subject: [PATCH] [enh] packaging_apps_manifest: add 'version' field. (#464) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * [enh] packaging_apps_manifest: add 'version' field. * [enh] Version number convention * [enh] Convention pour les numéros de versions * [fix] packaging_apps_manifest_fr: typo. * Update packaging_apps_manifest.md --- packaging_apps_manifest.md | 3 +++ packaging_apps_manifest_fr.md | 11 +++++++---- 2 files changed, 10 insertions(+), 4 deletions(-) diff --git a/packaging_apps_manifest.md b/packaging_apps_manifest.md index 62376fea..97b92b07 100644 --- a/packaging_apps_manifest.md +++ b/packaging_apps_manifest.md @@ -12,6 +12,7 @@ The `manifest.json` file defines the app's constants, a bunch of values that Yun "fr": "Webmail Open Source" }, "url": "http://roundcube.net/", + "version": "1.0-1", "license": "free", "maintainer": { "name": "kload", @@ -62,6 +63,8 @@ The `manifest.json` file defines the app's constants, a bunch of values that Yun * **url**: software website. +* **version**: version of the package builded from the upstream version number and an incremental number for each change in the package without upstream change. Example "1.0.0-7". Must be a string. + * **license**: application license: `free` or `non-free`. Be careful to not confuse with package license which must be put in `LICENSE` file. * **maintainer**: informations about the app maintainer for contact. diff --git a/packaging_apps_manifest_fr.md b/packaging_apps_manifest_fr.md index 98b07abf..d1a4a8e0 100644 --- a/packaging_apps_manifest_fr.md +++ b/packaging_apps_manifest_fr.md @@ -12,6 +12,7 @@ Le fichier `manifest.json` définit les constantes de l’application, un ensemb "fr": "Webmail Open Source" }, "url": "http://roundcube.net/", + "version": "1.0-1", "license": "free", "maintainer": { "name": "kload", @@ -58,9 +59,11 @@ Le fichier `manifest.json` définit les constantes de l’application, un ensemb - **packaging_format** : version de packaging du paquet. La version **1** est la version actuelle. Cette clé a été mise en place afin de faire évoluer les versions de packaging de manière décorrélée des versions de YunoHost. -* **description** : description complète de l’application. Vous pouvez la détailler comme bon vous semble. Uniquement le champs `en` (english) est requis, vous pouvez également ajouter la traduction en français :) +* **description** : description complète de l’application. Vous pouvez la détailler comme bon vous semble. Uniquement le champ `en` (english) est requis, vous pouvez également ajouter la traduction en français :) -* **url**: site de l’application. +* **url** : site web de l’application. + +* **version** : version du package construit à partir du numéro de version de l’application qui est installée et d'un incrément pour chaque changement du paquet sans changement de version de l'application. "Exemple: 1.0.0-7". Le champ doit être une chaîne de caractères. * **license** : licence avec laquelle l’application est distribuée : `free`, `non-free`. Attention à ne pas confondre avec la licence du paquet qui doit être mise dans le fichier `LICENSE`. @@ -68,7 +71,7 @@ Le fichier `manifest.json` définit les constantes de l’application, un ensemb - **requirements** : dépendance du paquet de l’application à la version d’un paquet Debian de YunoHost. Par exemple : "yunohost": ">> 2.3.12", le paquet `yunohost` doit être de version supérieur à `2.3.12`. -* [**multi_instance**](packaging_apps_multiinstance_fr) : capacité d’une application d’être installée plusieurs fois. +* [**multi_instance**](packaging_apps_multiinstance_fr) : capacité d’une application d’être installée plusieurs fois. * **services** : liste des services nécessaires au fonctionnement de l’application. `nginx`, `php5-fpm`, `mysql`, `uwsgi`, `metronome`, `postfix`, `dovecot`… @@ -77,7 +80,7 @@ Le fichier `manifest.json` définit les constantes de l’application, un ensemb * **name** : identifiant du paramètre * **type** : (optionnel) type de paramètre parmis `domain`, `path`, `user`, `app`, `boolean` et `password`. Le champ sera caché dans le cas d’un mot de passe. * **choices** : (optionnel) restreint les réponses possibles à plusieurs choix. - * **optional** : (optionnel) champs qui indique si ce paramètre est optionnel. Il peux avoir les valeurs `true` ou `false`. + * **optional** : (optionnel) champs qui indique si ce paramètre est optionnel. Il peut avoir les valeurs `true` ou `false`. * **ask** : question posée (au minimum en anglais – `en`) que vous pouvez traduire dans plusieurs langues. * **example** : (optionnel) valeur d’exemple pour aider l’administrateur à remplir le formulaire d’installation. * **default** : (optionnel) valeur par défaut.