[enh] packaging_apps_helpers: hide deprecated helpers and update information about new helpers.

- hide deprecated helpers from YunoHost 2.2.
- update information about new helpers from YunoHost 2.4:
 - Add example
 - Link the example app
 - Update link to the helpers repository
This commit is contained in:
Moul 2016-05-20 12:08:06 +02:00
parent 55a864367b
commit 7897c95750
2 changed files with 20 additions and 15 deletions

View file

@ -1,16 +1,20 @@
<a class="btn btn-lg btn-default" href="packaging_apps_en">Application packaging</a> <a class="btn btn-lg btn-default" href="packaging_apps_en">Application packaging</a>
### Helpers ## Shell helpers
It's recommended to use helpers.
#### Shell Since YunoHost 2.4 release, **new shell helpers** are available to ease packaging, in particular for common tasks like password generation, MySQL database creation…
From YunoHost 2.4, [shell helpers](https://dev.yunohost.org/projects/yunohost/repository/yunohost/revisions/unstable/show/data/helpers.d) are available.
Examples are available in the [example application](https://github.com/YunoHost/example_ynh/blob/master/scripts/install). We advise to use them.
You can find them on this [repository](https://github.com/YunoHost/yunohost/blob/unstable/data/helpers.d).
To use them, you need to add following lines in the shell scripts: To use them, you need to add following lines in the shell scripts:
```bash ```bash
# Source app helpers # Source app helpers
. /usr/share/yunohost/helpers . /usr/share/yunohost/helpers
``` ```
<!--
<br /> <br />
#### Moulinette #### Moulinette
@ -79,3 +83,4 @@ sudo yunohost app ssowatconf
<blockquote> <blockquote>
This helper reloads the SSO configuration. You have to call it at the end of the script when you are packaging a web app. This helper reloads the SSO configuration. You have to call it at the end of the script when you are packaging a web app.
</blockquote> </blockquote>
-->

View file

@ -1,16 +1,15 @@
<a class="btn btn-lg btn-default" href="packaging_apps_fr">Packaging dapplication</a> <a class="btn btn-lg btn-default" href="packaging_apps_fr">Packaging dapplication</a>
## Commandes pratiques
Il est conseillé dutiliser les commandes pratiques.
#### Shell ## Commandes pratiques en Shell
À partir de YunoHost 2.4, des [helpers en shell](https://dev.yunohost.org/projects/yunohost/repository/yunohost/revisions/unstable/show/data/helpers.d) sont disponible.
Pour pouvoir les utiliser il faut ajouter les lignes suivantes : À partir de YunoHost 2.4, de **nouvelles commandes pratiques *(helpers)* en shell** sont disponible pour faciliter le *packaging*, particulièrement pour des tâches répétitives comme la génération de mot de passe, la création de base de donnés MySQL…
```bash
# Source app helpers Des exemples sont disponibles dans l[application dexemple](https://github.com/YunoHost/example_ynh/blob/master/scripts/install). Il est conseillé dutiliser les commandes pratiques.
. /usr/share/yunohost/helpers
``` Vous pourrez les retrouver dans ce [dépôt](https://github.com/YunoHost/yunohost/blob/unstable/data/helpers.d).
<!--
<br /> <br />
#### Moulinette #### Moulinette
@ -88,3 +87,4 @@ sudo yunohost app ssowatconf
<blockquote> <blockquote>
Cette commande régénère la configuration du SSO. Vous devez lappeler à la fin des scripts lorsque vous packagez une application Web. Cette commande régénère la configuration du SSO. Vous devez lappeler à la fin des scripts lorsque vous packagez une application Web.
</blockquote> </blockquote>
-->