mirror of
https://github.com/YunoHost/doc.git
synced 2024-09-03 20:06:26 +02:00
Removing references to the community list
This commit is contained in:
parent
24dae66774
commit
523771c4c4
8 changed files with 12 additions and 21 deletions
|
@ -12,11 +12,7 @@ Application lists
|
||||||
|
|
||||||
From the technical point of view, applications are public code repository (such as [this one](https://github.com/YunoHost-Apps/wordpress_ynh)). Existing applications are indexed using "application lists". Those lists can be managed in Applications > Install > Manage applications lists or with commands such as `yunohost app fetchlist`.
|
From the technical point of view, applications are public code repository (such as [this one](https://github.com/YunoHost-Apps/wordpress_ynh)). Existing applications are indexed using "application lists". Those lists can be managed in Applications > Install > Manage applications lists or with commands such as `yunohost app fetchlist`.
|
||||||
|
|
||||||
By default, YunoHost only knows about the official application list. Those are applications which have been carefully packaged, integrated, reviewed and shall be maintained by the YunoHost team.
|
The full list of application can be browsed at [this page](/apps).
|
||||||
|
|
||||||
Nevertheless, you might want to have access to the larger catalog of the community list. It can easily be added through the 'Manage applications lists' view of the webadmin, or with the command `yunohost app fetchlist -n community -u https://app.yunohost.org/community.json`. Just be aware that apps in this list offer less guarantees than the official apps and the YunoHost team is not responsible for them !
|
|
||||||
|
|
||||||
The full list of application (official and community) can be browsed at [this page](/apps).
|
|
||||||
|
|
||||||
Integration and quality levels
|
Integration and quality levels
|
||||||
------------------------------
|
------------------------------
|
||||||
|
|
|
@ -12,11 +12,7 @@ Listes d'applications
|
||||||
|
|
||||||
Du point de vue technique, les applications sont des dépôts de code public (comme [celui-ci](https://github.com/YunoHost-Apps/wordpress_ynh)). Les applications existantes sont indexées à l'aide de "listes d'applications". Ces listes peuvent être gérées dans Applications > Installer > Gérer les listes d'applications, ou avec des commandes telles que `yunohost app fetchlist`.
|
Du point de vue technique, les applications sont des dépôts de code public (comme [celui-ci](https://github.com/YunoHost-Apps/wordpress_ynh)). Les applications existantes sont indexées à l'aide de "listes d'applications". Ces listes peuvent être gérées dans Applications > Installer > Gérer les listes d'applications, ou avec des commandes telles que `yunohost app fetchlist`.
|
||||||
|
|
||||||
Par défaut, YunoHost ne connaît que la liste officielle des applications. Il s'agit d'applications qui ont été soigneusement packagées, intégrées, revues et doivent être maintenues par l'équipe YunoHost.
|
La liste des applications existantes peut être consultée sur [cette page](/apps).
|
||||||
|
|
||||||
Néanmoins, vous souhaiterez peut-être avoir accès au catalogue plus fourni de la liste communautaire. Cette liste peut facilement être ajouté via la vue 'Gérer les listes d'applications' de l'administrateur web, ou avec la commande `yunohost app fetchlist -n community -u https://app.yunohost.org/community.json`. Sachez simplement que les applications de cette liste offrent moins de garanties que les applications officielles et que l'équipe YunoHost n'en est pas responsable !
|
|
||||||
|
|
||||||
La liste des applications existantes (officielles et communautaires) peut être consultée sur [cette page](/apps).
|
|
||||||
|
|
||||||
Niveaux d'intégration et de qualité
|
Niveaux d'intégration et de qualité
|
||||||
------------------------------
|
------------------------------
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
# Apps wishlist
|
# Apps wishlist
|
||||||
|
|
||||||
<div class="alert alert-info">Before to add an app in wishlist please check your app is not already in official or community list: see the <a href="/apps">apps list</a></div>
|
<div class="alert alert-info">Before to add an app in wishlist please check your app is not already in apps list: see the <a href="/apps">apps list</a></div>
|
||||||
|
|
||||||
The following list is a compiled wishlist of applications that would be nice-to-have.
|
The following list is a compiled wishlist of applications that would be nice-to-have.
|
||||||
|
|
||||||
|
|
|
@ -16,7 +16,7 @@
|
||||||
* [Multi-instance](packaging_apps_multiinstance)
|
* [Multi-instance](packaging_apps_multiinstance)
|
||||||
* [Helpers](packaging_apps_helpers)
|
* [Helpers](packaging_apps_helpers)
|
||||||
* [Trap usage](/packaging_apps_trap)
|
* [Trap usage](/packaging_apps_trap)
|
||||||
* [Adding your app to the community list](https://github.com/YunoHost/Apps/#contributing)
|
* [Adding your app to the apps list](https://github.com/YunoHost/Apps/#contributing)
|
||||||
* Quality tests
|
* Quality tests
|
||||||
* [Package linter](https://github.com/YunoHost/package_linter)
|
* [Package linter](https://github.com/YunoHost/package_linter)
|
||||||
* [Package check](https://github.com/YunoHost/package_check)
|
* [Package check](https://github.com/YunoHost/package_check)
|
||||||
|
|
|
@ -16,7 +16,7 @@
|
||||||
* [Multi-instance](/packaging_apps_multiinstance)
|
* [Multi-instance](/packaging_apps_multiinstance)
|
||||||
* [Fonctions utiles](/packaging_apps_helpers)
|
* [Fonctions utiles](/packaging_apps_helpers)
|
||||||
* [Utilisation de 'trap'](/packaging_apps_trap)
|
* [Utilisation de 'trap'](/packaging_apps_trap)
|
||||||
* [Ajouter son application à la liste community](https://github.com/YunoHost/Apps/#contributing)
|
* [Ajouter son application à la liste des apps](https://github.com/YunoHost/Apps/#contributing)
|
||||||
* Tests de qualité
|
* Tests de qualité
|
||||||
* [Package linter](https://github.com/YunoHost/package_linter)
|
* [Package linter](https://github.com/YunoHost/package_linter)
|
||||||
* [Package check](https://github.com/YunoHost/package_check)
|
* [Package check](https://github.com/YunoHost/package_check)
|
||||||
|
|
|
@ -62,8 +62,7 @@ Groups are structured as a result of the fact that YunoHost counts many sub-proj
|
||||||
- [yunopaste](http://paste.yunohost.org/)
|
- [yunopaste](http://paste.yunohost.org/)
|
||||||
|
|
||||||
- ##### Apps Group
|
- ##### Apps Group
|
||||||
- Official apps
|
- apps.json list
|
||||||
- Community-based apps
|
|
||||||
- App development tools (package_checker, package linter)
|
- App development tools (package_checker, package linter)
|
||||||
|
|
||||||
- ##### Communication Group
|
- ##### Communication Group
|
||||||
|
|
|
@ -119,9 +119,9 @@ For the `apps.json` list maintained by the project team, registration is on [the
|
||||||
##### Indicate the license associated with the package | draft | AUTO | WORKING |
|
##### Indicate the license associated with the package | draft | AUTO | WORKING |
|
||||||
The license of the packet must be specified in a `LICENSE` file at the root of the packet. Be careful not to confuse with the license of the application that will be installed whose acronym is to be entered in the `license` field of the manifest.
|
The license of the packet must be specified in a `LICENSE` file at the root of the packet. Be careful not to confuse with the license of the application that will be installed whose acronym is to be entered in the `license` field of the manifest.
|
||||||
|
|
||||||
The application lists official.json and community.json only accept packages with a free license, as well as the license for the contained application. Some free applications require non-free dependencies (example: mp3, drivers, etc.). In this case, you should add `&dep-non-free` to the acronym and if possible give details in the README.md of the package, in this case the integration will be accepted on a case-by-case basis.
|
The application list apps.json only accept packages with a free license, as well as the license for the contained application. Some free applications require non-free dependencies (example: mp3, drivers, etc.). In this case, you should add `&dep-non-free` to the acronym and if possible give details in the README.md of the package, in this case the integration will be accepted on a case-by-case basis.
|
||||||
|
|
||||||
**NB:** Apps not included in offical lists may still be installed: either manually with the URL to the app, or in a more practical way using non-official lists (which can be created and maintained by the community).
|
**NB:** Apps not included in apps.json lists may still be installed: either manually with the URL to the app, or in a more practical way using non-official lists (which can be created and maintained by the community).
|
||||||
|
|
||||||
In the future, YunoHost will probably display details about the license of the application. To achieve this, the acronym must be the one from this [list of licenses listed in the SPDX](https://spdx.org/licenses/) (if there are 2 acronyms, the one containing the version number). For consistency, the case must be respected.
|
In the future, YunoHost will probably display details about the license of the application. To achieve this, the acronym must be the one from this [list of licenses listed in the SPDX](https://spdx.org/licenses/) (if there are 2 acronyms, the one containing the version number). For consistency, the case must be respected.
|
||||||
|
|
||||||
|
|
|
@ -89,7 +89,7 @@ La YEP 1 est une meta YEP, elle explique ce qu'il faut faire pour échanger avec
|
||||||
##### Nommer son app et son dépôt | validé | manuel | NOTWORKING |
|
##### Nommer son app et son dépôt | validé | manuel | NOTWORKING |
|
||||||
Chaque application YunoHost possède un id inscrit dans le manifeste de l'application.
|
Chaque application YunoHost possède un id inscrit dans le manifeste de l'application.
|
||||||
Cet identifiant doit être unique entre chaque paquet d'application.
|
Cet identifiant doit être unique entre chaque paquet d'application.
|
||||||
Il est donc recommandé de vérifier sa disponibilité en consultant la liste des applications référencées dans les dépôts d'applications connus (official, community, internetcube).
|
Il est donc recommandé de vérifier sa disponibilité en consultant la liste des applications référencées dans les dépôts d'applications connus (apps, internetcube).
|
||||||
|
|
||||||
De plus l'identifiant doit respecter l'expression régulière suivante `^[a-z1-9]((_|-)?[a-z1-9])+$`. Autrement dit, il doit respecter les règles suivantes :
|
De plus l'identifiant doit respecter l'expression régulière suivante `^[a-z1-9]((_|-)?[a-z1-9])+$`. Autrement dit, il doit respecter les règles suivantes :
|
||||||
* être en minuscule
|
* être en minuscule
|
||||||
|
@ -114,15 +114,15 @@ Ces dépôts ont plusieurs fonctions :
|
||||||
* indiquer l'état de fonctionnement du paquet ;
|
* indiquer l'état de fonctionnement du paquet ;
|
||||||
* indiquer des informations sur le support d'un paquet.
|
* indiquer des informations sur le support d'un paquet.
|
||||||
|
|
||||||
Pour les listes `official.json` et `community.json` maintenues par l'équipe du projet Yunohost, l'inscription se fait sur [le dépôt git "apps"](https://github.com/YunoHost/apps). D'autres listes non-officielles (notamment celles incluant des applications non-libres) peuvent exister, se réferer au [Forum](https://forum.yunohost.org) de la communauté.
|
Pour la liste `apps.json` maintenue par l'équipe du projet Yunohost, l'inscription se fait sur [le dépôt git "apps"](https://github.com/YunoHost/apps). D'autres listes non-officielles (notamment celles incluant des applications non-libres) peuvent exister, se réferer au [Forum](https://forum.yunohost.org) de la communauté.
|
||||||
|
|
||||||
#### YEP 1.3
|
#### YEP 1.3
|
||||||
##### Indiquer la licence associée au paquet | brouillon | AUTO | WORKING |
|
##### Indiquer la licence associée au paquet | brouillon | AUTO | WORKING |
|
||||||
La licence du paquet est à indiquer dans un fichier `LICENSE` à la racine du paquet. Attention à ne pas confondre avec la licence de l'application qui va être installée dont l'acronyme est à renseigner dans le champ `license` du manifeste.
|
La licence du paquet est à indiquer dans un fichier `LICENSE` à la racine du paquet. Attention à ne pas confondre avec la licence de l'application qui va être installée dont l'acronyme est à renseigner dans le champ `license` du manifeste.
|
||||||
|
|
||||||
Les listes d'applications official.json et community.json n'acceptent que les paquets dont la licence est libre, de même pour la licence de l'application contenue. Certaines applications libres nécessitent des dépendances non-libres (exemple: mp3, drivers, etc.). Dans ce cas, il faut ajouter `&dep-non-free` à l'acronyme et si possible donner des précisions dans le README.md du paquet, l'intégration sera dans ce cas acceptée au cas par cas.
|
La liste d'application apps.json n'acceptent que les paquets dont la licence est libre, de même pour la licence de l'application contenue. Certaines applications libres nécessitent des dépendances non-libres (exemple: mp3, drivers, etc.). Dans ce cas, il faut ajouter `&dep-non-free` à l'acronyme et si possible donner des précisions dans le README.md du paquet, l'intégration sera dans ce cas acceptée au cas par cas.
|
||||||
|
|
||||||
**NB :** Les applications non-présentes dans les listes maintenues par le projet peuvent tout de même être installées : soit manuellement via le lien de l'application, soit de manière plus intégrée via des listes non-officielles (qui peuvent être créées et maintenues par la communauté).
|
**NB :** Les applications non-présentes dans la liste maintenue par le projet peuvent tout de même être installées : soit manuellement via le lien de l'application, soit de manière plus intégrée via des listes non-officielles (qui peuvent être créées et maintenues par la communauté).
|
||||||
|
|
||||||
Dans le futur, YunoHost affichera sans doute des détails sur la licence de l'application. Pour y parvenir, l'acronyme doit être celui issu de cette [liste de licences répertoriées du SPDX](https://spdx.org/licenses/) (si il y a 2 acronymes, il faut prendre celui contenant le numéro de version). Pour plus de cohérence, la casse doit être respectée.
|
Dans le futur, YunoHost affichera sans doute des détails sur la licence de l'application. Pour y parvenir, l'acronyme doit être celui issu de cette [liste de licences répertoriées du SPDX](https://spdx.org/licenses/) (si il y a 2 acronymes, il faut prendre celui contenant le numéro de version). Pour plus de cohérence, la casse doit être respectée.
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue