Merge pull request #461 from YunoHost/revue-fr

Revue d'une partie de la documentation française
This commit is contained in:
Laurent Peuch 2017-02-10 20:23:03 +01:00 committed by GitHub
commit 8833883b86
6 changed files with 47 additions and 42 deletions

View file

@ -34,6 +34,8 @@ Once the lines are added, [here you might need to restart the ldap service ?], y
### How to move application folder ### How to move application folder
To change an application folder, only a few commands are needed: move content, create a symlink and set access rights.
Sample with WordPress: Sample with WordPress:
```bash ```bash
# Move wordpress folder to an external hard drive # Move wordpress folder to an external hard drive

View file

@ -1,23 +1,23 @@
# Administration depuis l'API ou une application externe # Administration depuis lAPI ou une application externe
Toutes les actions executables en ligne de commande le sont également via une API. Toutes les actions exécutables en ligne de commande le sont également via une API.
L'API utilise l'adresse https://VOTRESERVEUR/yunohost/api et toutes les actions sont détaillées sur cette page. LAPI utilise ladresse https://VOTRESERVEUR/yunohost/api et toutes les actions sont détaillées sur cette page.
Il faut d'abord récupérer un cookie de login pour ensuite réaliser les actions. Voici un exemple via curl : Il faut dabord récupérer un cookie de connexion pour ensuite réaliser les actions. Voici un exemple via curl :
```bash ```bash
Login (avec mot de passe admin): curl -k -d “password=XXX” dump-header headers https://VOTRESERVEUR/yunohost/api/login Login (avec mot de passe admin): curl -k -d “password=XXX” dump-header headers https://VOTRESERVEUR/yunohost/api/login
GET: curl -k -i -H “Accept: application/json” -H “Content-Type: application/json” -L -b headers -X GET https://VOTRESERVEUR/yunohost/api/ROUTE | grep }| python -mjson.tool GET: curl -k -i -H “Accept: application/json” -H “Content-Type: application/json” -L -b headers -X GET https://VOTRESERVEUR/yunohost/api/ROUTE | grep }| python -mjson.tool
``` ```
Pour simplifier l'administration à distance d'une instance YunoHost dans le cadre d'un projet CHATON, des classes API ont été développées par des utilisateurs. Pour simplifier ladministration à distance dune instance YunoHost dans le cadre dun projet CHATONS, des classes API ont été développées par des utilisateurs.
Par exemple, cette classe PHP vous permettra d'administrer votre instance YunoHost depuis une application PHP (site web, outil de provisioning, …). Par exemple, cette classe PHP vous permettra dadministrer votre instance YunoHost depuis une application PHP (site web, outil de gestion de capacité…).
Voici un exemple de code PHP permettant d'ajouter un utilisateur dans votre instance YunoHost : Voici un exemple de code PHP permettant dajouter un utilisateur dans votre instance YunoHost :
```bash ```bash
require("ynh_api.class.php"); require("ynh_api.class.php");
$ynh = new YNH_API("YunoHost server IP or hostname", "admin password"); $ynh = new YNH_API("adresse IP du serveur YunoHost ou nom dhôte", "mot de passe administrateur");
if ($ynh->login()) { if ($ynh->login()) {
$domains = $ynh->get("/domains"); $domains = $ynh->get("/domains");
@ -26,8 +26,8 @@ if ($ynh->login()) {
$arguments = array( $arguments = array(
'username' => 'test', 'username' => 'test',
'password' => 'yunohost', 'password' => 'yunohost',
'firstname' => 'Firstname', 'firstname' => 'Prénom',
'lastname' => 'Lastname', 'lastname' => 'Nom',
'mail' => 'test@'.$first_domain, 'mail' => 'test@'.$first_domain,
'mailbox_quota' => '500M' 'mailbox_quota' => '500M'
); );

View file

@ -1,21 +1,21 @@
# Linterface dadministration web # Linterface dadministration web
YunoHost est fourni avec une interface web dadministration. Lautre interface est la [moulinette](/moulinette_fr) en ligne de commande. YunoHost est fourni avec une interface graphique dadministration. Lautre méthode est dutiliser la [moulinette](/moulinette_fr) ligne de commande.
**Attention** : linterface dadmininistration donne accès à beaucoup moins de fonctionnalités que la moulinette, car elle est actuellement en développement actif. **Attention** : linterface dadministration donne accès à beaucoup moins de fonctionnalités que la moulinette, car elle est en développement actif.
### Accès ### Accès
Linterface admin est accessible depuis votre instance YunoHost à ladresse https://example.org/yunohost/admin (remplacez example.org par la bonne valeur) Linterface admin est accessible depuis votre instance YunoHost à ladresse https://exemple.org/yunohost/admin (remplacez exemple.org par la bonne valeur)
<div class="text-center" style="max-width:100%;border-radius: 5px;border: 1px solid rgba(0,0,0,0.15);box-shadow: 0 5px 15px rgba(0,0,0,0.35);"> <div class="text-center" style="max-width:100%;border-radius: 5px;border: 1px solid rgba(0,0,0,0.15);box-shadow: 0 5px 15px rgba(0,0,0,0.35);">
<img src="/images/manage.png" style="max-width:100%;"> <img src="/images/manage.png" style="max-width:100%;">
</div> </div>
### Remise à zéro du mot de passe admin ### Réinitialiser le mot de passe administrateur
<div class="text-error">Cette methode ne fonctionnera pas avec Yunohost 2.4 / Debian Jessie</div> <div class="text-error">Cette méthode ne fonctionnera pas avec Yunohost 2.4 / Debian Jessie</div>
Pour faire une remise à zéro du mot de passe admin de YunoHost (un utilisateur root est nécessaire) Pour réinitialiser le mot de passe administrater de YunoHost (lutilisateur root est nécessaire)
Dans le fichier `/etc/slapd/slapd.conf` ajouter la ligne suivante : Dans le fichier `/etc/slapd/slapd.conf` ajouter la ligne suivante :
```bash ```bash
@ -29,14 +29,17 @@ slappasswd -h {SSHA}
# Un mot de passe vous sera demandé, vous retournant un hash comme résultat # Un mot de passe vous sera demandé, vous retournant un hash comme résultat
``` ```
Une fois les lignes ajoutées (il faut probablement rédémarrer le service ldap), vous devriez être en mesure de vous connecter avec le mot de passse admin temporaire. Changer le via linterface. Retirer les lignes ajoutées dans le fichier `slapd.conf`. Une fois les lignes ajoutées (il faut probablement rédémarrer le service LDAP), vous devriez être en mesure de vous connecter avec le mot de passse temporaire. Changer le via linterface. Retirer les lignes ajoutées dans le fichier `slapd.conf`.
### Comment déplacer le dossier dune application
Pour changer le dossier contenant une application, seules quelques commandes sont nécessaires : déplacer le contenu créer un lien symbolique et définir les droits daccès.
### Comment déplacer une application
Exemple avec WordPress : Exemple avec WordPress :
```bash ```bash
# Deplacement du wordpress vers un autre support # Deplacement du wordpress vers un autre support
$ sudo mv /var/www/wordpress /media/disqueexterne $ sudo mv /var/www/wordpress /mon/dossier/cible
# Creation du lien symbolique # Création du lien symbolique
$ sudo ln -s /media/disqueexterne/wordpress /var/www/wordpress $ sudo ln -s /media/disqueexterne/wordpress /var/www/wordpress
# Le répertoire doit appartenir à www-data # Le répertoire doit appartenir à www-data
sudo chown -R www-data:www-data /media/externalharddrive/wordpress sudo chown -R www-data:www-data /media/externalharddrive/wordpress

View file

@ -1,11 +1,11 @@
# Documentation administrateur # Documentation pour les administrateurs YunoHost
* [Lauto-hébergement](/selfhosting_fr) * [Lauto-hébergement](/selfhosting_fr)
* [Matériel compatible](/hardware_fr) * [Matériel compatible](/hardware_fr)
* [Guide dinstallation](/install_fr) * [Guide dinstallation](/install_fr)
* [Sur une carte OLinuXino](/install_on_olinuxino_fr) * [Sur une carte OLinuXino](/install_on_olinuxino_fr)
* [Sur carte ARM](/install_on_arm_board_fr) * [Sur une carte ARM](/install_on_arm_board_fr)
* [Sur Raspberry Pi](/install_on_raspberry_fr) * [Sur un Raspberry Pi](/install_on_raspberry_fr)
* [À partir de lISO](/install_iso_fr) * [À partir de lISO](/install_iso_fr)
* [Sur Debian](/install_on_debian_fr) * [Sur Debian](/install_on_debian_fr)
* [Sur VirtualBox](/install_on_virtualbox_fr) * [Sur VirtualBox](/install_on_virtualbox_fr)
@ -34,12 +34,12 @@
* [Applications souhaitées](apps_wishlist_fr) * [Applications souhaitées](apps_wishlist_fr)
* [Owncloud](app_owncloud_fr) * [Owncloud](app_owncloud_fr)
* [Fournisseurs daccès à Internet](/isp_fr) * [Fournisseurs daccès à Internet](/isp_fr)
* [Configuration générale box](/isp_box_config_fr) * [Configuration générale dune box](/isp_box_config_fr)
* [SFR](/isp_sfr_fr) * [SFR](/isp_sfr_fr)
* [Orange](/isp_orange_fr) * [Orange](/isp_orange_fr)
* [Free](/isp_free_fr) * [Free](/isp_free_fr)
* [Administration web](/admin_fr) * [Administration via linterface en ligne](/admin_fr)
* [Administration via l'API](/admin_api_fr) * [Administration via lAPI](/admin_api_fr)
* [Sécurité](/security_fr) * [Sécurité](/security_fr)
* [Authentification SSH par clé](/security_fr) * [Authentification SSH par clé](/security_fr)
* [Modifier le port SSH](/security_fr) * [Modifier le port SSH](/security_fr)
@ -50,7 +50,7 @@
* [Notes générales](/troubleshooting_guide_fr) * [Notes générales](/troubleshooting_guide_fr)
* [Mise à jour](/troubleshooting_guide_fr) * [Mise à jour](/troubleshooting_guide_fr)
* [Les services](/troubleshooting_guide_fr) * [Les services](/troubleshooting_guide_fr)
* [Logs](/troubleshooting_guide_fr) * [Journaux système](/troubleshooting_guide_fr)
* [Utilisation de la RAM](/troubleshooting_guide_fr) * [Utilisation de la RAM](/troubleshooting_guide_fr)
* [Espace disque](/troubleshooting_guide_fr) * [Espace disque](/troubleshooting_guide_fr)
* [Applications](/troubleshooting_guide_fr) * [Applications](/troubleshooting_guide_fr)
@ -58,14 +58,14 @@
* [Applications Python](/troubleshooting_guide_fr) * [Applications Python](/troubleshooting_guide_fr)
* [Applications Node.js](/troubleshooting_guide_fr) * [Applications Node.js](/troubleshooting_guide_fr)
* [Autres (Go, Java…)](/troubleshooting_guide_fr) * [Autres (Go, Java…)](/troubleshooting_guide_fr)
* [Administration en ligne de commande avec la Moulinette](/moulinette_fr) * [Ladministration en ligne de commande avec la Moulinette](/moulinette_fr)
* [Changer le mot de passe dadministration](/change_admin_password_fr) * [Changer le mot de passe dadministration](/change_admin_password_fr)
* [Courier électronique](email_fr) * [Courrier électronique](email_fr)
* [Formulaires pour enlever son IP des listes noires](blacklist_forms_fr) * [Formulaires pour enlever son IP des listes noires](blacklist_forms_fr)
* [DKIM](dkim_fr) * [La signature du serveur via DKIM](dkim_fr)
* [Gestion du certificat](/certificate_fr) * [Gestion des certificats](/certificate_fr)
* [Régénérer un certificat](/regenerate_certificate_fr) * [Régénérer un certificat](/regenerate_certificate_fr)
* [YunoHost service caché Tor](/torhiddenservice_fr) * [YunoHost avec un service caché Tor](/torhiddenservice_fr)
* [Débloquer une IP avec Fail2ban](/fail2ban_fr) * [Débloquer une IP avec Fail2ban](/fail2ban_fr)
* [Les sauvegardes](/backup_fr) * [Les sauvegardes](/backup_fr)
* [Les mises à jour](/update_fr) * [Les mises à jour](/update_fr)

View file

@ -1,15 +1,15 @@
# Documentation contributeur # Documentation contributeur YunoHost
* [Guide du contributeur](/contribute_fr) * [Guide du contributeur](/contribute_fr)
* [Qu'est-ce que YunoHost](/whatsyunohost_fr) * [Quest-ce que YunoHost ?](/whatsyunohost_fr)
* Développement * Développement
* <a href='https://dev.yunohost.org/projects/yunohost/roadmap' target='_BLANK'>Feuille de route du projet</a> * <a href='https://dev.yunohost.org/projects/yunohost/roadmap' target='_BLANK'>Feuille de route du projet</a>
* [Liste des applications disponibles](/apps_fr) * [Liste des applications disponibles](/apps_fr)
* [Packager une application](/packaging_apps_fr) * [Préparer/empaqueter une nouvelle application](/packaging_apps_fr)
* [Développer avec Docker](/docker_fr) * [Développer avec Docker](/docker_fr)
* [Builder OpenResty (serveur Web) pour Raspberry Pi](/build_openresty_fr) * [Fabriquer OpenResty (serveur Web) pour Raspberry Pi](/build_openresty_fr)
* [Présentation du fonctionnement de YunoHost](/package_list_fr) * [Présentation du fonctionnement de YunoHost](/package_list_fr)
* [Se créer un environnement de développement](/ynh_dev_fr) * [Se créer un environnement de développement](/ynh_dev_fr)
* Documentation * Documentation
* [Création dun compte pour lédition de la documentation](/accounting_fr) * [Création dun compte pour modifier la documentation](/accounting_fr)
* [Écrire de la documentation](/write_documentation_fr) * [Écrire de la documentation](/write_documentation_fr)

View file

@ -1,9 +1,9 @@
# Documentation utilisateur # Documentation pour les utilisateurs YunoHost
* [Interface utilisateur](user_interface) * [Linterface utilisateur](user_interface)
* [La messagerie électronique (email)](/email_fr) * [La messagerie électronique (email)](/email_fr)
* [Messagerie instantanée et réseaux sociaux XMPP](/XMPP_fr) * [La messagerie instantanée et les réseaux sociaux XMPP](/XMPP_fr)
* [Applications officielles](/apps_fr) * [Les applications officielles](/apps_fr)
* [Firefox Sync](/app_ffsync_fr) * [Firefox Sync](/app_ffsync_fr)
* [Jappix](/app_jappix_fr) * [Jappix](/app_jappix_fr)
* [Tiny Tiny RSS](/app_ttrss_fr) * [Tiny Tiny RSS](/app_ttrss_fr)