doc/package_list_fr.md

42 lines
3.8 KiB
Markdown
Raw Normal View History

2016-02-14 20:21:41 +01:00
# Fonctionnement de YunoHost
### Les branches de développement de YunoHost
2016-03-30 14:32:52 +02:00
Afin de mettre en place un système automatisé de compilation des paquets Debian, le développement de YunoHost progresse désormais autour de trois branches principales :
- **stable** : il sagit du code des paquets Debian utilisés en live par les utilisateurs de YunoHost.
- **testing** : il sagit du code éligible pour la création dune nouvelle version de YunoHost, il est supposé stable mais manque de test. La branche testing peut notamment servir pour corriger rapidement certains bugs.
- **unstable** : il sagit là des derniers codes ajoutés au dépôt mais qui sont connus pour être instables voir inachevés. Cest à destination de cette branche que vous devez faire vos pull request. Si votre travail est conséquent mais inachevé, il convient denvisager de créer une branche à part, thématique (exemple : backup).
2016-02-14 20:21:41 +01:00
2016-03-02 21:11:01 +01:00
Les numéros de version des paquets stable sont pairs, les numéros de version des paquets testing sont impairs. Ainsi, la version 2.3 de YunoHost est une version de test qui sera transformée en version 2.4 si les tests sont concluants.
2016-02-14 20:21:41 +01:00
2016-03-02 21:11:01 +01:00
### Paquets YunoHost
2016-02-14 20:21:41 +01:00
Avant daller plus loin, il convient de rappeler le rôle des différents paquets YunoHost.
#### Paquet moulinette
La moulinette est un framework qui permet de créer une API web ainsi quune API en ligne de commande à partir dun même code Python et dun schéma en yaml.
La ligne de commande `yunohost` est écrite avec ce framework, La moulinette est donc une dépendance de YunoHost.
La moulinette est un code écrit par les développeurs YunoHost. À lorigine, la moulinette était fusionnée avec le code YunoHost, mais il a été décidé de scinder les deux afin de permettre lutilisation de la moulinette pour dautres projets.
#### Paquet yunohost
Le paquet yunohost est le cœur de YunoHost, ce paquet contient depuis la version 2.3 (testing) le code du programme en ligne de commande `yunohost`. Il contient également des helpers qui peuvent être utilisées par les scripts des apps YunoHost, ainsi que les templates de configuration des dépendances de YunoHost.
2016-03-30 14:32:52 +02:00
Note : à partir de la version 2.3 (testing), le code de la ligne de commande `yunohost` initialement dans le paquet moulinette-yunohost a été rapatrié dans le paquet yunohost. Un système 2.2 contient donc deux paquets au lieu dun seul : yunohost et moulinette-yunohost.
2016-02-14 20:21:41 +01:00
2016-03-02 21:11:01 +01:00
#### Paquet SSOwat
2016-03-30 14:32:52 +02:00
SSOwat est un système de Single Sign On pour Nginx écrit en Lua. Cest ce système qui génère linterface que les utilisateurs YunoHost voient. Il permet de protéger des URLs et dautoriser des utilisateurs à accéder ou non à ces ressources.
2016-03-02 21:11:01 +01:00
SSOwat est comme la moulinette une dépendance de YunoHost, mais peut aussi être utilisée séparément sur dautres projets.
2016-02-14 20:21:41 +01:00
#### Paquet yunohost-admin (optionnel)
Ce paquet contient linterface dadministration web de YunoHost, obligatoire dans la version 2.2, il est optionnel depuis la version 2.3 (testing).
Linterface dadministration nest en réalité quun client qui se connecte à lAPI web généré par la moulinette et le paquet yunohost.
Le service yunohost-api doit donc être start pour utiliser ladministration web.
### Conseils de développement
#### Traduction
2016-03-30 14:32:52 +02:00
Afin déviter des problèmes de fusion, lorsque vous ajoutez ou modifiez une clé de traduction dans les fichiers json situés dans les répertoires locales des dépôts git, il est demandé dajouter les clés uniquement dans le fichier en.json, même si vous savez faire la traduction pour dautres langues.
Les traductions se font ensuite sur <a href='https://translate.yunohost.org/' target='_BLANK'>weblate</a>. Donc si effectivement vous savez traduire dans une autre langue, nhésitez pas à y faire un tour.