From cf974d20bfea5eed41da0a9822e99e9db5616fe4 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Tue, 26 Jan 2016 18:22:32 +0100 Subject: [PATCH] Update packaging_apps_manifest_fr.md --- packaging_apps_manifest_fr.md | 24 +++++++++++++++--------- 1 file changed, 15 insertions(+), 9 deletions(-) diff --git a/packaging_apps_manifest_fr.md b/packaging_apps_manifest_fr.md index 283fe005..8dc887f0 100644 --- a/packaging_apps_manifest_fr.md +++ b/packaging_apps_manifest_fr.md @@ -46,21 +46,27 @@ Le fichier `manifest.json` définit les constantes de l’application, un ensemb } ``` -* **name** : le nom de l’application. Son unicité n’est pas nécessaire. Il est tout de même conseillé étant donné que c’est le nom qui apparaît dans la liste des applications pour les administrateurs de serveurs YunoHost. +* **name** : nom de l’application. Son unicité n’est pas nécessaire. Il est tout de même conseillé étant donné que c’est le nom qui apparaît dans la liste des applications pour les administrateurs de serveurs YunoHost. -* **id** : l’identifiant unique de l’application. Vous devez vous assurer de son unicité. +* **id** : identifiant de l’application. Vous devez vous assurer de son unicité. -* **description** : la description complète de l’application. Vous pouvez la détailler comme bon vous semble. Uniquement le champs `en` (English) est requis, mais vous pouvez tout de même ajouter la traduction en français :) +* **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 :) * **url**: site de l’application. -* **license** : type de licence avec laquelle le logiciel est distribué : `free`, `non-free`. Attention à ne pas confondre avec la licence du paquet qui doit être mise dans le fichier `LICENSE`. +* **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`. -* **maintainer** : informations à propos du mainteneur du paquet de l’application. +* **maintainer** : informations à propos du mainteneur du paquet de l’application pour pouvoir le contacter. -* **multi_instance** : définit la possibilité de votre package à être installée plusieurs fois. Quand YunoHost essaie d’installer une seconde fois votre application, il remplaçera l’`id` dans votre script par `id__2`. Cela signifie que si voulez être `multi_instance`, vous devez mettre toutes les valeurs identifiantes dans les scripts. -

**Par exemple** : dans le script roundcube, il faut nommer la base de donnée `roundcube`, le dossier d’installation `roundcube` et la configuration Nginx `roundcube`. De cette manière, la seconde installation de roundcube ne rentrera pas en conflit avec la première, et sera installée dans la base de donnée `roundcube__2`, dans le répertoire `roundcube__2`, et avec la configuration Nginx `roundcube__2`. +* **multi_instance** : définit la possibilité du paquet à être installé plusieurs fois. Quand YunoHost essaie d’installer une seconde fois l’application, il remplaçera l’`id` dans votre script par `id__2`. Cela signifie que si voulez que l’application soit `multi_instance`, vous devez mettre toutes les valeurs identifiantes dans les scripts. +

**Par exemple** : dans le script roundcube, il faut nommer la base de donnée `roundcube`, le dossier d’installation `roundcube` et la configuration Nginx `roundcube`. De cette manière, la seconde installation de roundcube ne rentrera pas en conflit avec la première, et sera installée dans la base de donnée `roundcube__2`, dans le répertoire `roundcube__2`, et avec la configuration Nginx `roundcube__2`. -* **services**: services nécessaires au fonctionnement de l’application. `nginx`, `php5-fpm`, `mysql`, `uwsgi`, `metronome`… +* **services** : liste des services nécessaires au fonctionnement de l’application. `nginx`, `php5-fpm`, `mysql`, `uwsgi`, `metronome`… -* **arguments** : les paramètres à demander aux administrateurs du serveur lors de l’installation. `name` est l’identifiant du paramètre, et `ask` la question à poser (au minimum en Anglais -- `en`) que vous pouvez traduire de la même manière que la description ci-dessus. Vous pouvez aussi proposer une valeur par défaut (`default`) et un exemple (`example`) pour aider l’administrateur à remplir le formulaire d’installation. \ No newline at end of file +* **arguments** : + * **install** : paramètres à demander à l’administrateur lors de l’installation. + * **name** : identifiant du paramètre + * **type** : type de paramètre parmis `domain`, `path` et `password`. Le champ sera caché dans le cas d’un mot de passe. + * **ask** : question posée (au minimum en anglais – `en`) que vous pouvez traduire dans plusieurs langues. + * **example** : valeur d’exemple pour aider l’administrateur à remplir le formulaire d’installation. + * **default** : valeur par défaut. \ No newline at end of file