Typos (fr)

This commit is contained in:
Alexandre Aubin 2016-11-30 06:03:20 +00:00 committed by GitHub
parent 9e3c766c01
commit 9205c7fbbb

View file

@ -1,6 +1,6 @@
## Contribuer au coeur de Yunohost ## Contribuer au cœur de YunoHost
Vous souhaitez ajouter une nouvelle fonctionnalité au coeur de Yunohost, mais ne Vous souhaitez ajouter une nouvelle fonctionnalité au cœur de YunoHost, mais ne
savez pas comment procéder ? Ce guide parcours les étapes du développement et du savez pas comment procéder ? Ce guide parcours les étapes du développement et du
processus de contribution. processus de contribution.
@ -16,27 +16,27 @@ XMPP, vous devriez pouvoir vous connecter à l'aide du widget en bas de la page.
- **Utilisez [ynh-dev](https://github.com/YunoHost/ynh-dev)** (voir le README) - **Utilisez [ynh-dev](https://github.com/YunoHost/ynh-dev)** (voir le README)
pour mettre en place un environnement de développement - en local sur une pour mettre en place un environnement de développement - en local sur une
machine virtuel, ou bien sur un VPS. machine virtuel, ou bien sur un VPS.
Ceci installera une instance fonctionelle de Yunohost, en utilisant Ceci installera une instance fonctionelle de YunoHost, en utilisant
directement les dépôts git à l'aide de liens symboliques. De cette facon, il directement les dépôts git à l'aide de liens symboliques. De cette façon, il
vous sera possible de modifier les fichiers, de tester les changements en vous sera possible de modifier les fichiers, de tester les changements en
temps réel, et de commiter et push/pull directement depuis cet environnement. temps réel, et de commiter et push/pull directement depuis cet environnement.
- **Implémentez et testez votre fonctionnalité**. Suivant ce sur quoi vous - **Implémentez et testez votre fonctionnalité**. Suivant ce sur quoi vous
voulez travailler : voulez travailler :
- **Coeur Python/ligne de comande** : allez dans `/vagrant/yunohost/` - **Cœur Python/ligne de comande** : allez dans `/vagrant/yunohost/`
- **Interface d'administration web** : allez dans `/vagrant/yunohost-admin/` - **Interface d'administration web** : allez dans `/vagrant/yunohost-admin/`
- Vous pouvez aussi travailler sur les autres projets liés sur lesquels - Vous pouvez aussi travailler sur les autres projets liés sur lesquels
s'appuie Yunohost (SSOwat, moulinette) de facon similaire. s'appuie YunoHost (SSOwat, moulinette) de façon similaire.
### Travailler sur le coeur Python / ligne de commande ### Travailler sur le cœur Python / ligne de commande
- Allez dans `/vagrant/yunohost/`. - Allez dans `/vagrant/yunohost/`.
- Executez `/vagrant/ynh-dev use-git yunohost`. - Executez `/vagrant/ynh-dev use-git yunohost`.
- Le fichier actionsmap (`data/actionsmap/yunohost.yml`) défini les différentes - Le fichier actionsmap (`data/actionsmap/yunohost.yml`) définit les différentes
catégories, actions et arguments de la ligne de commande Yunohost. Choisissez catégories, actions et arguments de la ligne de commande YunoHost. Choisissez
comment vous voulez que les utilisateurs utilise votre fonctionnalité, et comment vous voulez que les utilisateurs utilisent votre fonctionnalité, et
ajoutez/éditez les catégories, actions et arguments correspondants. Par ajoutez/éditez les catégories, actions et arguments correspondants. Par
exemple, dans `yunohost domain add some.domain.tld`, la catégorie est exemple, dans `yunohost domain add some.domain.tld`, la catégorie est
`domain`, l'action est `add` et `some.domain.tld` est un argument. `domain`, l'action est `add` et `some.domain.tld` est un argument.
@ -57,7 +57,7 @@ XMPP, vous devriez pouvoir vous connecter à l'aide du widget en bas de la page.
Ne modifiez pas de fichiers de locales autres que en.json, la traduction sera Ne modifiez pas de fichiers de locales autres que en.json, la traduction sera
faite avec [weblate](https://translate.yunohost.org/) ! faite avec [weblate](https://translate.yunohost.org/) !
- Yunohost essaye de suivre le style de code [pep8](http://pep8.org/). Des - YunoHost essaye de suivre le style de code [pep8](http://pep8.org/). Des
outils existent pour vérifier automatiquement la conformité du code. outils existent pour vérifier automatiquement la conformité du code.
- Mettre un `_` devant les noms des fonctions "privées". - Mettre un `_` devant les noms des fonctions "privées".
@ -65,34 +65,34 @@ XMPP, vous devriez pouvoir vous connecter à l'aide du widget en bas de la page.
##### N'oubliez pas ##### N'oubliez pas
- (Peut-être plus nécessaire) À chaque fois que vous modifiez l'actionsmap, il - (Peut-être plus nécessaire) À chaque fois que vous modifiez l'actionsmap, il
faut forcer le rafraichissement du cache avec : faut forcer le rafraîchissement du cache avec :
`rm /var/cache/moulinette/actionsmap/yunohost.pkl` `rm /var/cache/moulinette/actionsmap/yunohost.pkl`
### Travailler sur l'interface d'administration web ### Travailler sur l'interface d'administration web
- Allez dans `/vagrant/yunohost-admin/src/`. - Allez dans `/vagrant/yunohost-admin/src/`.
- Executez `/vagrant/ynh-dev use-git yunohost-admin`. Ceci lance gulp, de sorte - Exécutez `/vagrant/ynh-dev use-git yunohost-admin`. Ceci lance gulp, de sorte
à ce que à chaque fois que vous modifiez les sources, il recompilera le code qu'à chaque fois que vous modifiez les sources, il recompilera le code
(js) et vous pourrez voir les changements dans le navigateur web (Ctrl+F5). (js) et vous pourrez voir les changements dans le navigateur web (Ctrl+F5).
Pour stopper la commande, faites simplement Ctrl+C. Pour stopper la commande, faites simplement Ctrl+C.
- L'interface web utilise une API pour communiquer avec Yunohost. Les - L'interface web utilise une API pour communiquer avec YunoHost. Les
commandes/requêtes de l'API sont également définie dans l'actionsmap. Par commandes/requêtes de l'API sont également définies dans l'actionsmap. Par
exemple, accéder à la page ```https://domain.tld/yunohost/api/users``` exemple, accéder à la page ```https://domain.tld/yunohost/api/users```
corresponds à une requete `GET /domains` vers l'API yunohost. Cette requete correspond à une requete `GET /users` vers l'API YunoHost. Cette requête
est mappée sur `user_list()`. Accéder à cette URL devrait afficher le json est mappée sur `user_list()`. Accéder à cette URL devrait afficher le json
retourné par cette fonction. Les requetes `GET' sont typiquement destinés à retourné par cette fonction. Les requêtes `GET' sont typiquement destinées à
demander de l'information au serveur, tandis que les requetes `POST` sont demander de l'information au serveur, tandis que les requêtes `POST` sont
destinées à demander au serveur de modifier/changer des informations ou de destinées à demander au serveur de modifier/changer des informations ou de
réaliser des actions. réaliser des actions.
- `js/yunohost/controllers` contiens les parties javascript, et défini quelles - `js/yunohost/controllers` contiens les parties javascript, et définit quelles
requêtes faire à l'API pendant le chargement d'une page donnée de l'interface, requêtes faire à l'API pendant le chargement d'une page donnée de l'interface,
et comment traîter les données récupérées pour générer la page, en utilisant et comment traîter les données récupérées pour générer la page, en utilisant
des templates. des templates.
- `views` contiens les templates des pages de l'interface. Dans le template, - `views` contient les templates des pages de l'interface. Dans le template,
les données venant du javascript peuvent êtres utilisées avec la syntaxe les données venant du javascript peuvent êtres utilisées avec la syntaxe
`{{some-variable}}`, qui sera remplacée pendant la construction de la page. `{{some-variable}}`, qui sera remplacée pendant la construction de la page.
Il est également possible d'avoir des conditions avec la syntaxe Il est également possible d'avoir des conditions avec la syntaxe
@ -111,14 +111,14 @@ XMPP, vous devriez pouvoir vous connecter à l'aide du widget en bas de la page.
```service yunohost-api restart``` ```service yunohost-api restart```
(Il faudra retaper le mot de passe administrateur dans l'interface web) (Il faudra retaper le mot de passe administrateur dans l'interface web)
- Il faudra peut-être régulièrement forcer le rafraichissement du cache - Il faudra peut-être régulièrement forcer le rafraîchissement du cache
navigateur pour propager correctement le javascript et/ou HTML (à chaque fois navigateur pour propager correctement le javascript et/ou HTML (à chaque fois
que l'on change quelque chose dans `js` ou `views`, donc). que l'on change quelque chose dans `js` ou `views`, donc).
### Votre fonctionnalité est prête et vous souhaitez qu'elle soit intégrée dans Yunohost ### Votre fonctionnalité est prête et vous souhaitez qu'elle soit intégrée dans YunoHost
- Forkez le dépòt correspondant sur Github, et commitez votre changements dans - Forkez le dépòt correspondant sur Github, et commitez vos changements dans
une nouvelle branche, Il est recommandé de nommer la branche avec la une nouvelle branche, Il est recommandé de nommer la branche avec la
convention : convention :
- Pour une nouvelle fonctionnalité ou amélioration : `enh-TICKETREDMINE-description-fonctionnalité` - Pour une nouvelle fonctionnalité ou amélioration : `enh-TICKETREDMINE-description-fonctionnalité`