Merge branch 'master' of https://github.com/YunoHost/doc into revue-fr

This commit is contained in:
Jibec 2017-02-10 12:22:20 +01:00
commit 9ec75476ab
25 changed files with 153 additions and 21 deletions

View file

@ -68,6 +68,7 @@ The following list is a compiled wishlist of applications that would be nice-to-
- [Joomla!](https://www.joomla.org)
- [JS Bin](http://jsbin.com/help/2-second-setup)
- [Kaiwa](http://getkaiwa.com)
- [Kin calendar](https://github.com/KinToday)
- [Kinto](https://github.com/Kinto/formbuilder)
- [Known](https://withknown.com)
- [Koel](http://koel.phanan.net)

View file

@ -1,5 +1,6 @@
# Conférences
- [FOSDEM 2017 YunoHost/Internet Cube Bram/kload](https://video.fosdem.org/2017/AW1.125/)
- [Capitole du libre 2016 1 an et ½ de Brique Internet Bram](http://videos2016.capitoledulibre.org/communaute-du-libre/bram-1-an-et-demi-de-brique-internet.mp4)
* [PSES 2015 - La Brique Internet](http://www.youtube.com/watch?v=NCRn0yRfkIE)
* [THSF 2015 beudbeud](https://vimeo.com/128055751)

2
dns.md
View file

@ -25,7 +25,7 @@ You have several choices here. Note that you can mix and match solutions if you
1. You can use YunoHost's DNS service, which will automatically configure your DNS for you. You must choose a domain that ends with `.nohost.me` or `noho.st` for this, which may be inconvenient for you (you would then only be able to use an email address like `john@my-server.noho.st`).
**This is the recommended option if you are just starting out with self-hosting.**
2. You can use the DNS service offered by your **registrar** (Gandi, NameCheap, BookMyName or others) to configure your domain name. Here is the [standard DNS configuration](/dns_config). The DNS service of your router can also be used, more info on [how to setup a local domain](yunohost.org/dns_local_network).
2. You can use the DNS service offered by your **registrar** (Gandi, NameCheap, BookMyName or others) to configure your domain name. Here is the [standard DNS configuration](/dns_config). The DNS service of your router can also be used, more info on [how to setup a local domain](dns_local_network).
You can also check out these pages for specific [registrar](/registrar_en) documentation: [OVH](https://www.ovh.co.uk/index.xml), [Gandi](http://gandi.net), [NameCheap](http://namecheap.com) or [BookMyName](http://bookmyname.com).
**Warning**: If you choose this option, you will have more configuration possibilities, but nothing will be done for you. For example, if you want to use `webmail.my-server.org`, you must add it manually to the DNS records with your registrar.

View file

@ -23,4 +23,18 @@ The automatic detection tool of Thunderbird does not work with YunoHost. You wil
* [Manage alias mails](https://support.mozilla.org/en-US/kb/configuring-email-aliases)
#### For Android
[K-9 Mail](https://en.wikipedia.org/wiki/K-9_Mail) application works.
[K-9 Mail](https://en.wikipedia.org/wiki/K-9_Mail) application works.
#### For Firefox OS
Tested with Firefox OS 2.6.
On the home screen, enter the user name and the email address. Then use manual configuration:
<a href="/images/ffos_email_config_home_screen_empty.png"><img src="/images/ffos_email_config_home_screen_empty.png" width=200/></a> <a href="/images/ffos_email_config_home_screen_fill.png"><img src="/images/ffos_email_config_home_screen_fill.png" width=200/></a>
Configure manually the form as shown on following screenshots:
<a href="/images/ffos_email_config_manual_conf_empty.png"><img src="/images/ffos_email_config_manual_conf_empty.png" width=200/></a> <a href="/images/ffos_email_config_manual_conf_fill.png"><img src="/images/ffos_email_config_manual_conf_fill.png" width=200/></a>
<a href="/images/ffos_email_config_manual_conf_2_empty.png"><img src="/images/ffos_email_config_manual_conf_2_empty.png" width=200/></a> <a href="/images/ffos_email_config_manual_conf_2_fill.png"><img src="/images/ffos_email_config_manual_conf_2_fill.png" width=200/></a>

View file

@ -22,4 +22,19 @@ Lutilitaire de détection automatique de Thunderbird ne fonctionne pas avec l
* [Gestion des alias mails](https://support.mozilla.org/en-US/kb/configuring-email-aliases)
#### Pour Android
Lapplication [K-9 Mail](https://github.com/k9mail) fonctionne.
Lapplication [K-9 Mail](https://github.com/k9mail) fonctionne.
#### Pour Firefox OS
Testé avec Firefox OS 2.6.
Sur la page daccueil, entrez votre nom dutilisateur et ladresse email, puis allez dans la configuration manuelle :
<a href="/images/ffos_email_config_home_screen_empty.png"><img src="/images/ffos_email_config_home_screen_empty.png" width=200/></a> <a href="/images/ffos_email_config_home_screen_fill.png"><img src="/images/ffos_email_config_home_screen_fill.png" width=200/></a>
Configurer manuellement le formulaire comme indiqué sur les captures décran suivantes :
<a href="/images/ffos_email_config_manual_conf_empty.png"><img src="/images/ffos_email_config_manual_conf_empty.png" width=200/></a> <a href="/images/ffos_email_config_manual_conf_fill.png"><img src="/images/ffos_email_config_manual_conf_fill.png" width=200/></a>
<a href="/images/ffos_email_config_manual_conf_2_empty.png"><img src="/images/ffos_email_config_manual_conf_2_empty.png" width=200/></a> <a href="/images/ffos_email_config_manual_conf_2_fill.png"><img src="/images/ffos_email_config_manual_conf_2_fill.png" width=200/></a>

Binary file not shown.

After

Width:  |  Height:  |  Size: 44 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 48 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 34 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 32 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 41 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 44 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 17 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 55 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 74 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 75 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 119 KiB

View file

@ -6,7 +6,7 @@ The purpose of this document is to teach you how to package an application for Y
To package an application, here are the requirements:
* An account on a git server (e.g. [GitHub](https://github.com/)) to publish the application;
* Basic knowledge of `git`, bash shell and other programming stuff;
* A testing [virtual machine or a distant server](/install_en), or a [development environement](https://github.com/yunohost/ynh-dev) to package and test the package.
* A testing [virtual machine or a distant server](/install_en), or a development environement, [ynh-dev](https://github.com/yunohost/ynh-dev) or [VirtualBox](/packaging_apps_virtualbox_fr), to package and test the package.
### Content
A YunoHost package is composed of:

View file

@ -6,7 +6,8 @@ Ce document a pour but de vous apprendre à packager une application pour YunoHo
Pour packager une application, voici les prérequis :
* Un compte sur un serveur git comme [GitHub](https://github.com/) pour pouvoir ensuite publier lapplication;
* Maîtriser un minimum `git`, le Shell et dautres notions de programmation;
* Une [machine virtuelle ou sur un serveur distant](/install_fr) ou un [environnement de développement](https://github.com/yunohost/ynh-dev) pour packager et tester son paquet.
* Une [machine virtuelle ou sur un serveur distant](/install_fr) ou un environnement de développement, [ynh-dev](https://github.com/yunohost/ynh-dev) ou [VirtualBox](/packaging_apps_virtualbox_fr), pour packager et tester son paquet.
Si vous ne comprenez pas ces prérequis, ou si vous ne savez pas comment écrire du code, consulter d'abord l'[introduction au packaging](/packaging_apps_start_fr).

View file

@ -0,0 +1,92 @@
# Créer un environnement de développement avec VirtualBox
Ce page de documentation va vous expliquer comment mettre en place un serveur YunoHost virtuel, avec VirtualBox, pour travailler sur le packaging d'application.
## Pourquoi utiliser VirtualBox plutôt quun serveur YunoHost de production pour packager une application ?
Il y a principalement deux raisons pour préférer l'usage d'un serveur virtuel plutôt que votre propre serveur :
- Vous pouvez torturez à loisir un serveur virtuel sans courir le risque de le casser, puisque vous pourrez toujours restaurer un état précédent. Alors qu'il serait dommage de casser son propre serveur !
- Un serveur virtuel sera restauré avant de travailler dessus, pour garder en permanence un système sans résidus d'une précédente installation. Cela permet de se rapprocher au plus près d'une première installation par un utilisateur.
Nous parlerons ici de VirtualBox, pour son approche graphique facile à utiliser. Si vous préférez une interface en ligne de commande pour la gestion de la machine virtuelle, tournez-vous de préférence vers [ynh-dev](/dev_fr).
## Installer VirtualBox
Depuis un système GNU Linux, installer simplement le paquet `virtualbox-qt`.
Depuis un système Windows ou macOS, il faudra se référer à la page de [téléchargement de VirtualBox](https://www.virtualbox.org/wiki/Downloads) pour récupérer le fichier d'installation adéquat.
Quel que soit votre système, il ne devrait pas être nécessaire d'installer l'extension pack ou les additions invités.
## Installer YunoHost sur VirtualBox
Suivez simplement la documentation idoine pour l'[installation sur VirtualBox](/install_on_virtualbox_fr) puis la documentation sur la [post-installation](/postinstall_fr).
Lors de la post-installation, il est inutile d'utiliser un nom de domaine en `.nohost.me` ou `.noho.st`, votre serveur virtuel ne sera pas accessible depuis l'extérieur de votre réseau local.
Nous préférerons l'usage d'un faux nom de domaine qui restera cantonné au réseau local. Par exemple, `yunohost.packaging`.
Ce nom de domaine n'étant enregistré dans aucun serveur DNS, on l'enregistrera dans le fichier `hosts` de l'ordinateur qui y accédera. Voir la documentation sur le [DNS local](/dns_local_network_fr).
Votre serveur virtuel est à présent installé. Avant de commencer à l'utiliser, nous allons voir comment créer un premier instantané et comment les utiliser.
## Utiliser les instantanés
VirtualBox prend tout son intérêt avec l'usage des instantanés, qui permettent d'enregistrer l'état de la machine à un moment donné et d'y revenir rapidement.
Nous verrons également par la suite comment utiliser plusieurs branches d'instantanés pour travailler sur des apps différentes sur une même machine.
#### Tout d'abord, créons un premier instantané
Avant de commencer à jouer avec la machine virtuelle, il convient de faire un premier instantané, pour ne pas avoir à recommencer le processus d'installation à chaque fois.
Arrêtez la machine virtuelle avant tout.
La gestion des instantanés se fait dans l'onglet "Instantanés"
<img src="/images/virtualbox_packaging1.jpg" width=80%>
Et on créer un premier instantané
<img src="/images/virtualbox_packaging2.jpg" width=30%>
À présent on peut commencer à travailler sur la machine virtuelle et créer autant d'instantanés que souhaité pour jalonner le travail.
<img src="/images/virtualbox_packaging3.jpg" width=80%>
Dans cet exemple, on pourra facilement revenir en arrière, après avoir testé la suppression du package par exemple et restaurer la machine virtuelle dans l'état précédent avec le package encore installé avec succès.
Et lorsque le package sera pleinement fonctionnel, il suffira de supprimer les instantanés liés à ce package pour revenir à l'état initial de la machine virtuelle.
Nous disposerons ainsi d'un serveur YunoHost vierge de toute installation d'application pour notre prochain test.
#### Utiliser plusieurs branches d'instantanés
En plus de l'usage d'instantanés successifs, il est également possible de dériver un nouvel état actuel et de nouveaux instantanés depuis un instantané plus ancien que le dernier.
<img src="/images/virtualbox_packaging4.jpg" width=80%>
Dans cet exemple, j'ai dérivé deux branches depuis mon installation réussie du package, pour tester indépendamment la suppression simple de l'application, l'upgrade et le backup/restore.
Finalement je suis reparti de la base de la machine virtuelle pour démarrer un nouveau test sur un autre package, sans pour autant abandonner le précédent test.
À tout moment, il est possible de revenir sur un instantané précédent en le restaurant.
La machine démarrera toujours sur l'"État actuel".
<img src="/images/virtualbox_packaging5.jpg" width=80%>
> Il est toujours possible de créer un nouvel instantané, que la machine soit à l'arrêt ou non.
Mais pour restaurer un instantané, la machine ne doit pas être en cours d'exécution.
## Comment se connecter à la machine virtuelle ?
On se connecte à la machine virtuelle comme à n'importe quel serveur YunoHost, en utilisant ssh.
```bash
ssh admin@mon.domain
```
Ou, si le domaine n'a pas été ajouté dans le hosts, en utilisant son ip.
```bash
ssh admin@11.22.33.44
```
À présent, on peut travailler sur la machine virtuelle en CLI.
Pour copier facilement les fichiers du package ou utiliser un éditeur de texte graphique, on peut également se connecter en sftp avec un explorateur de fichier.
Il suffit de se connecter à l'adresse `sftp://admin@mon.domain/` avec l'explorateur.
<img src="/images/virtualbox_packaging6.jpg" width=80%>
> Sur Windows ou macOS, l'explorateur de fichier ne supporte pas nativement le protocole sftp…

View file

@ -28,9 +28,9 @@ This is the first domain name linked to your YunoHost server, but also the one w
* If you do not have a domain name, or if you want to use the YunoHost's DynDNS service, choose a sub-domain of **.nohost.me** or **.noho.st** (i.e. `homersimpson.nohost.me`). The domain will be configured automatically and you won't need any further configuration step.
* If you do know what **DNS** is, you probably want to configure your own domain name here. In this case, please refer to the [yunohost.org/dns](/dns) page for more informations.
* If you do know what **DNS** is, you probably want to configure your own domain name here. In this case, please refer to the [DNS page](/dns) page for more informations.
* If you don't own a domain name and don't want a **.nohost.me** or **.noho.st**, you can use a local domain. The idea is to configure your router to redirect a local domain name to your server. For example you could create the yunohost.local domain redirecting to your server in your router, and now every device on the network will be redirected to your server when accessing yunohost.local. More information on how to setup a local domain can be found [here](yunohost.org/dns_local_network).
* If you don't own a domain name and don't want a **.nohost.me** or **.noho.st**, you can use a local domain. The idea is to configure your router to redirect a local domain name to your server. For example you could create the yunohost.local domain redirecting to your server in your router, and now every device on the network will be redirected to your server when accessing yunohost.local. More information on how to setup a local domain can be found [here](dns_local_network).
### Administration password

View file

@ -23,13 +23,16 @@ If you use the [email system](email_en) and your server becomes unavailable, ema
<img src="/images/networks.png" width=500>
#### Others Self-hosting projects
* [ArkOS](http://arkos.io/)
* [Cozy](http://cozy.io/)
* [UBOS](http://ubos.net/)
* [Host@home](http://yeuxdelibad.net/Programmation/Hostathome.html)
* [Sovereign](https://github.com/al3x/sovereign)
* [Sandstorm](https://sandstorm.io/)
* [FreedomBox](https://fr.wikipedia.org/wiki/FreedomBox)
- [ArkOS](https://arkos.io)
- [Cloudron](https://cloudron.io)
- [Cozy](https://cozy.io)
- [FreedomBox](https://wiki.debian.org/FreedomBox)
- [Host@home](http://yeuxdelibad.net/Programmation/Hostathome.html)
- [Libre.sh](https://github.com/indiehosters/libre.sh)
- [Puffin](http://puffin.rocks)
- [Sandstorm](https://sandstorm.io/)
- [Sovereign](https://github.com/al3x/sovereign)
- [UBOS](http://ubos.net)
#### Learn more
* [Decentralized Web Summit](http://www.decentralizedweb.net/)

View file

@ -25,13 +25,16 @@ Si vous vous servez du système de [courrier électronique](/email_fr), et que v
<img src="/images/networks.png" width=500>
#### Autres projets dauto-hébergement
* [ArkOS](http://arkos.io/)
* [Cozy](http://cozy.io/)
* [UBOS](http://ubos.net/)
* [Host@home](http://yeuxdelibad.net/Programmation/Hostathome.html)
* [Sovereign](https://github.com/al3x/sovereign)
* [Sandstorm](https://sandstorm.io/)
* [FreedomBox](https://fr.wikipedia.org/wiki/FreedomBox)
- [ArkOS](https://arkos.io)
- [Cloudron](https://cloudron.io)
- [Cozy](https://cozy.io)
- [FreedomBox](https://wiki.debian.org/FreedomBox)
- [Host@home](http://yeuxdelibad.net/Programmation/Hostathome.html)
- [Libre.sh](https://github.com/indiehosters/libre.sh)
- [Puffin](http://puffin.rocks)
- [Sandstorm](https://sandstorm.io/)
- [Sovereign](https://github.com/al3x/sovereign)
- [UBOS](http://ubos.net)
#### Pour aller plus loin
* [Auto-hebergement.fr](http://www.auto-hebergement.fr/)

View file

@ -83,6 +83,7 @@
* Developement
* Applications
* [Package new application](/packaging_apps)
* [VirtualBox for apps' packaging](packaging_apps_virtualbox_fr)
* [Manifest](packaging_apps_manifest_en)
* [Scripts](packaging_apps_scripts_en)
* [Arguments management](packaging_apps_arguments_management_en)

View file

@ -95,6 +95,7 @@
* [Présentation du fonctionnement de YunoHost](/package_list_fr)
* Applications :
* [Packager des applications](/packaging_apps_fr)
* [VirtualBox pour le packaging](packaging_apps_virtualbox_fr)
* [Introduction](packaging_apps_start_fr.md)
* [Manifeste](packaging_apps_manifest_fr)
* [Scripts](packaging_apps_scripts_fr)